From 91d23558acf4a017718c6c982140e33c49da20a4 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Fri, 12 Jun 2026 16:46:13 -0500
Subject: [PATCH 01/81] Add support for importing filament profiles from
 HueForge spool CSV exports

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 CHANGELOG.md                      |  1 +
 src/components/AutoPaintTab.tsx   |  2 +-
 src/docs/settings-and-controls.md | 27 +++++++++++++-
 src/hooks/useProfileManager.ts    |  8 +++-
 src/lib/profileManager.ts         | 57 +++++++++++++++++++++++++++++
 tests/profileManager.test.ts      | 61 +++++++++++++++++++++++++++++++
 6 files changed, 152 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3cc2a76..b438243 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,6 +9,7 @@ All notable changes to Kromacut are documented in this file.
 - **Orthographic camera toggle** - Added a camera toggle button to the 3D preview toolbar that switches between perspective and orthographic projection. The button shows the current mode and preserves the camera position and depth range when toggling.
 - **Flat Paint mode (experimental)** - Added a Flat Paint option to Auto-paint that builds a uniform, face-down slab: each pixel column's layer order is reversed so the artwork sits flat against the build plate (pre-mirrored for face-down printing) under a transparent carrier layer, the back is filled with the foundation filament so every layer has the full footprint, and 3MF export merges the parts into one object per physical filament for AMS/toolchanger printers. Includes flat-mode print instructions, a performance warning for tall stacks, mutual exclusion with Smooth Meshing, and regression tests covering the layout, meshing, STL compaction, and 3MF grouping.
 - **Desktop update settings** - Added desktop-only settings to manually check for updates and control whether update notices run on startup.
+- **HueForge spool CSV import** - Auto-paint filament profiles can now be imported from a HueForge spool library CSV export. Each spool is imported as a filament entry with its HueForge UUID preserved as the filament ID, named `<Brand>-<Color Name>-<Hex>` (e.g. `Inland Basic-Light Brown-#bf9c81`). Column order in the CSV is flexible.
 
 ### Changed
 
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index ed7350d..669d7fa 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -353,7 +353,7 @@ export default function AutoPaintTab({
                         <input
                             ref={importInputRef}
                             type="file"
-                            accept=".kfil,.kapp,.json"
+                            accept=".kfil,.kapp,.json,.csv"
                             data-testid="autopaint-profile-import-input"
                             className="hidden"
                             onChange={handleImportFile}
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index f6a235a..7ea5780 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -61,9 +61,32 @@ Use custom palettes when you want the reduced image to match a known filament se
 
 ## Filament Profile Files
 
-Auto-paint filament profiles use `.kfil`. Older `.kapp` profile files can still be imported. Profile files contain filament colors, names, TD values, and calibration data when available.
+Auto-paint filament profiles are named sets of filaments that can be saved, loaded, imported, and exported. They store filament colors, names, TD values, and any calibration data you have measured.
 
-Use profile import and export to move calibrated filaments between browsers or share them with another Kromacut user.
+Use the **upload icon** in the Auto-paint profile toolbar to import a file. Use the **download icon** to export the current filament set. Exported files default to `.kfil`.
+
+### Supported import formats
+
+| Format | Extension | Notes |
+| ------ | --------- | ----- |
+| Kromacut profile | `.kfil` | Native format. Supports single profiles and arrays of profiles in one file. |
+| Legacy Kromacut profile | `.kapp` | Older native format, still fully supported on import. |
+| Raw JSON | `.json` | Accepted if the file contains a profile object or an array of profile objects. |
+| HueForge spool CSV | `.csv` | See below. |
+
+### Duplicate handling
+
+When importing, Kromacut checks each incoming profile against what you already have:
+
+- **Same ID** — overwrites the existing profile with the incoming one.
+- **Same filaments, different ID** — skipped as a duplicate.
+- **Same name, different content** — imported with a numeric suffix added to the name (e.g. `My Spools 2`).
+
+A short summary of how many profiles were imported, overwritten, skipped, or renamed is shown after each import.
+
+### Importing from HueForge
+
+HueForge spool library exports (`.csv`) can be imported directly. Use **Export Spools** in HueForge to save a CSV, then click the upload icon in the Auto-paint filament profile toolbar and select the file. Each spool becomes a filament entry named `<Brand>-<Color Name>-<Hex>`, for example `Inland Basic-Light Brown-#bf9c81`. HueForge UUIDs are preserved as filament IDs so re-importing the same library does not create duplicates.
 
 ## Desktop Update Notices
 
diff --git a/src/hooks/useProfileManager.ts b/src/hooks/useProfileManager.ts
index a6db5fb..9d1bdfa 100644
--- a/src/hooks/useProfileManager.ts
+++ b/src/hooks/useProfileManager.ts
@@ -10,6 +10,7 @@ import {
     deleteProfile as deleteProfileFromList,
     importProfiles,
     parseProfileFile,
+    parseHueForgeCSV,
     exportProfileBlob,
     profileFileName,
     loadLastProfileId,
@@ -149,7 +150,12 @@ export function useProfileManager({ filaments, setFilaments }: UseProfileManager
             if (!file) return;
             const reader = new FileReader();
             reader.onload = () => {
-                const incoming = parseProfileFile(reader.result as string);
+                const content = reader.result as string;
+                const isCSV = file.name.toLowerCase().endsWith('.csv');
+                const profileName = file.name.replace(/\.csv$/i, '') || 'HueForge Import';
+                const incoming = isCSV
+                    ? parseHueForgeCSV(content, profileName)
+                    : parseProfileFile(content);
                 if (!incoming) {
                     console.error('Invalid profile file');
                     return;
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index d6bcf3d..be56d1d 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -226,6 +226,63 @@ export function parseProfileFile(json: string): AutoPaintProfile[] | null {
     }
 }
 
+/**
+ * Parse a HueForge spool library CSV into a single AutoPaint profile.
+ *
+ * The CSV must have a header row. Column order is flexible — columns are
+ * matched by name. Required columns: Color (hex), TD (float). Optional but
+ * recommended: Brand, Name, Uuid.
+ *
+ * Each filament's display name is formatted as `<Brand>-<Name>-<Color>`,
+ * e.g. `Inland Basic-Light Brown-#bf9c81`. Rows missing both Color and TD
+ * are skipped. UUIDs are used as filament IDs when present (braces stripped);
+ * a random UUID is generated for rows without one.
+ *
+ * Returns null if the input has no header, no valid data rows, or cannot be
+ * parsed.
+ */
+export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'): AutoPaintProfile[] | null {
+    const lines = csv.split(/\r?\n/).filter((l) => l.trim());
+    if (lines.length < 2) return null;
+
+    const headers = lines[0].split(',').map((h) => h.trim());
+    const col = (row: string[], name: string) => {
+        const i = headers.indexOf(name);
+        return i >= 0 ? row[i]?.trim() ?? '' : '';
+    };
+
+    const filaments: import('../types').Filament[] = [];
+    for (const line of lines.slice(1)) {
+        const row = line.split(',');
+        const color = col(row, 'Color');
+        const tdRaw = col(row, 'TD');
+        const td = parseFloat(tdRaw);
+        if (!color || isNaN(td)) continue;
+
+        const rawId = col(row, 'Uuid').replace(/[{}]/g, '');
+        const id = rawId || crypto.randomUUID();
+        const colorName = col(row, 'Name');
+        const brand = col(row, 'Brand') || undefined;
+        const name = brand && colorName ? `${brand}-${colorName}-${color}` : colorName || undefined;
+
+        filaments.push({ id, color, td, name, brand });
+    }
+
+    if (filaments.length === 0) return null;
+
+    const now = Date.now();
+    return [
+        {
+            id: crypto.randomUUID(),
+            name: profileName,
+            version: CURRENT_PROFILE_VERSION,
+            filaments,
+            createdAt: now,
+            updatedAt: now,
+        },
+    ];
+}
+
 /** Build an export blob for a profile. */
 export function exportProfileBlob(profile: AutoPaintProfile): Blob {
     return new Blob([JSON.stringify(profile, null, 2)], { type: 'application/json' });
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 2d941a5..819c92a 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -4,6 +4,7 @@ import assert from 'node:assert/strict';
 import {
     profileFileName,
     renameProfile,
+    parseHueForgeCSV,
     type AutoPaintProfile,
 } from '../src/lib/profileManager.ts';
 
@@ -11,6 +12,66 @@ test('auto-paint profile exports use kfil filenames', () => {
     assert.equal(profileFileName('PLA Basic White'), 'PLA_Basic_White.kfil');
 });
 
+const HUEFORGE_CSV = `Brand, Type, Color, Name, TD, Tags, Secondary_Type, Secondary_Color, Secondary_Strength, Owned, Uuid
+Inland Basic,PLA,#bf9c81,Light Brown,1.7,,None,#0000ff,0,true,{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9}
+Overture Basic,PLA,#033877,Blue,3.5,,None,#0000ff,0,true,{c8518afd-068e-4a5c-90d2-9981d4d7edde}`;
+
+test('parseHueForgeCSV returns null for empty input', () => {
+    assert.equal(parseHueForgeCSV(''), null);
+    assert.equal(parseHueForgeCSV('Brand, Type, Color'), null);
+});
+
+test('parseHueForgeCSV returns null when no valid filament rows', () => {
+    const csv = `Brand, Type, Color, Name, TD, Tags, Secondary_Type, Secondary_Color, Secondary_Strength, Owned, Uuid
+Inland Basic,PLA,,Light Brown,,,,,,true,{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9}`;
+    assert.equal(parseHueForgeCSV(csv), null);
+});
+
+test('parseHueForgeCSV parses filaments from HueForge CSV', () => {
+    const profiles = parseHueForgeCSV(HUEFORGE_CSV, 'My Spools');
+    assert.ok(profiles);
+    assert.equal(profiles.length, 1);
+    assert.equal(profiles[0].name, 'My Spools');
+    assert.equal(profiles[0].filaments.length, 2);
+});
+
+test('parseHueForgeCSV maps color and TD correctly', () => {
+    const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
+    const [first] = profile.filaments;
+    assert.equal(first.color, '#bf9c81');
+    assert.equal(first.td, 1.7);
+});
+
+test('parseHueForgeCSV strips braces from UUIDs', () => {
+    const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
+    assert.equal(profile.filaments[0].id, '631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9');
+    assert.equal(profile.filaments[1].id, 'c8518afd-068e-4a5c-90d2-9981d4d7edde');
+});
+
+test('parseHueForgeCSV formats names as <mfr>-<color-name>-<color-hex>', () => {
+    const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
+    assert.equal(profile.filaments[0].name, 'Inland Basic-Light Brown-#bf9c81');
+    assert.equal(profile.filaments[1].name, 'Overture Basic-Blue-#033877');
+});
+
+test('parseHueForgeCSV preserves brand field', () => {
+    const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
+    assert.equal(profile.filaments[0].brand, 'Inland Basic');
+    assert.equal(profile.filaments[1].brand, 'Overture Basic');
+});
+
+test('parseHueForgeCSV handles columns in non-standard order', () => {
+    const csv = `TD, Name, Uuid, Color, Brand, Type
+1.7,Light Brown,{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9},#bf9c81,Inland Basic,PLA`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    const [f] = profile.filaments;
+    assert.equal(f.color, '#bf9c81');
+    assert.equal(f.td, 1.7);
+    assert.equal(f.brand, 'Inland Basic');
+    assert.equal(f.name, 'Inland Basic-Light Brown-#bf9c81');
+    assert.equal(f.id, '631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9');
+});
+
 test('auto-paint profiles can be renamed without changing filament data', () => {
     const profiles: AutoPaintProfile[] = [
         {

From 15380671b91c03f3faaa8cd86dcd301b5ed2fe61 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sun, 14 Jun 2026 15:35:46 -0500
Subject: [PATCH 02/81] Enhance CSV/TSV parsing in profile manager to handle
 quoted fields and delimiters

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/hooks/useProfileManager.ts |  4 +-
 src/lib/profileManager.ts      | 75 +++++++++++++++++++++++++++++-----
 tests/profileManager.test.ts   | 47 +++++++++++++++++++++
 3 files changed, 114 insertions(+), 12 deletions(-)

diff --git a/src/hooks/useProfileManager.ts b/src/hooks/useProfileManager.ts
index 9d1bdfa..1bab7cf 100644
--- a/src/hooks/useProfileManager.ts
+++ b/src/hooks/useProfileManager.ts
@@ -151,8 +151,8 @@ export function useProfileManager({ filaments, setFilaments }: UseProfileManager
             const reader = new FileReader();
             reader.onload = () => {
                 const content = reader.result as string;
-                const isCSV = file.name.toLowerCase().endsWith('.csv');
-                const profileName = file.name.replace(/\.csv$/i, '') || 'HueForge Import';
+                const isCSV = /\.(csv|tsv)$/i.test(file.name);
+                const profileName = file.name.replace(/\.(csv|tsv)$/i, '') || 'HueForge Import';
                 const incoming = isCSV
                     ? parseHueForgeCSV(content, profileName)
                     : parseProfileFile(content);
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index be56d1d..8b020d3 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -226,17 +226,70 @@ export function parseProfileFile(json: string): AutoPaintProfile[] | null {
     }
 }
 
+/** Infer delimiter from the header line: tab if tabs are present, otherwise comma. */
+function detectDelimiter(headerLine: string): ',' | '\t' {
+    return headerLine.includes('\t') ? '\t' : ',';
+}
+
 /**
- * Parse a HueForge spool library CSV into a single AutoPaint profile.
+ * Parse one CSV/TSV row into fields, handling RFC 4180 double-quoted fields
+ * (commas and newlines inside quotes, "" as escaped quote).
+ */
+function parseRow(line: string, delimiter: ',' | '\t'): string[] {
+    const fields: string[] = [];
+    let pos = 0;
+
+    while (pos <= line.length) {
+        if (pos === line.length) {
+            // line ended with a delimiter — trailing empty field
+            fields.push('');
+            break;
+        }
+
+        if (line[pos] === '"') {
+            let field = '';
+            pos++; // skip opening quote
+            for (;;) {
+                if (pos >= line.length) break; // unclosed quote — accept what we have
+                if (line[pos] === '"') {
+                    if (pos + 1 < line.length && line[pos + 1] === '"') {
+                        field += '"';
+                        pos += 2; // escaped quote ""
+                    } else {
+                        pos++; // closing quote
+                        break;
+                    }
+                } else {
+                    field += line[pos++];
+                }
+            }
+            fields.push(field);
+            if (pos < line.length && line[pos] === delimiter) pos++;
+            if (pos === line.length) break; // last field, no trailing delimiter
+        } else {
+            const end = line.indexOf(delimiter, pos);
+            if (end === -1) {
+                fields.push(line.slice(pos));
+                break;
+            }
+            fields.push(line.slice(pos, end));
+            pos = end + 1;
+            // if pos === line.length the loop continues and pushes trailing ''
+        }
+    }
+
+    return fields;
+}
+
+/**
+ * Parse a HueForge spool library CSV or TSV into a single AutoPaint profile.
  *
- * The CSV must have a header row. Column order is flexible — columns are
- * matched by name. Required columns: Color (hex), TD (float). Optional but
- * recommended: Brand, Name, Uuid.
+ * Accepts comma-separated (CSV) or tab-separated (TSV) input — detected from
+ * the header row. Column order is flexible. Required columns: Color (hex),
+ * TD (float). Optional: Brand, Name, Uuid.
  *
- * Each filament's display name is formatted as `<Brand>-<Name>-<Color>`,
- * e.g. `Inland Basic-Light Brown-#bf9c81`. Rows missing both Color and TD
- * are skipped. UUIDs are used as filament IDs when present (braces stripped);
- * a random UUID is generated for rows without one.
+ * Quoted fields with embedded commas are handled per RFC 4180 ("" escapes a
+ * literal quote). Rows missing Color or TD are skipped.
  *
  * Returns null if the input has no header, no valid data rows, or cannot be
  * parsed.
@@ -245,7 +298,9 @@ export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'):
     const lines = csv.split(/\r?\n/).filter((l) => l.trim());
     if (lines.length < 2) return null;
 
-    const headers = lines[0].split(',').map((h) => h.trim());
+    const delimiter = detectDelimiter(lines[0]);
+    const headers = parseRow(lines[0], delimiter).map((h) => h.trim());
+
     const col = (row: string[], name: string) => {
         const i = headers.indexOf(name);
         return i >= 0 ? row[i]?.trim() ?? '' : '';
@@ -253,7 +308,7 @@ export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'):
 
     const filaments: import('../types').Filament[] = [];
     for (const line of lines.slice(1)) {
-        const row = line.split(',');
+        const row = parseRow(line, delimiter);
         const color = col(row, 'Color');
         const tdRaw = col(row, 'TD');
         const td = parseFloat(tdRaw);
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 819c92a..3aed807 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -72,6 +72,53 @@ test('parseHueForgeCSV handles columns in non-standard order', () => {
     assert.equal(f.id, '631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9');
 });
 
+test('parseHueForgeCSV handles quoted fields containing commas', () => {
+    const csv = `Brand,Color,Name,TD,Uuid
+"Inland, Basic",#bf9c81,"Light, Brown",1.7,{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9}`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    const [f] = profile.filaments;
+    assert.equal(f.brand, 'Inland, Basic');
+    assert.equal(f.color, '#bf9c81');
+    assert.equal(f.name, 'Inland, Basic-Light, Brown-#bf9c81');
+    assert.equal(f.td, 1.7);
+});
+
+test('parseHueForgeCSV handles escaped quotes inside quoted fields', () => {
+    const csv = `Brand,Color,Name,TD
+"Brand ""X""",#ff0000,Red,2.1`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    assert.equal(profile.filaments[0].brand, 'Brand "X"');
+});
+
+test('parseHueForgeCSV handles field with backslash and embedded quote (double-escape)', () => {
+    // brand value: backslash \"  (backslash + quote, 12 chars)
+    // RFC 4180: wrap in quotes, double the interior " → "backslash \"""
+    // JS template: \\ for the literal backslash → "backslash \\"""
+    const csv = `Brand,Color,Name,TD
+"backslash \\""",#aa1122,Red,1.5`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    assert.equal(profile.filaments[0].brand, 'backslash \\"');
+});
+
+test('parseHueForgeCSV parses TSV input', () => {
+    const tsv = `Brand\tColor\tName\tTD\tUuid
+Inland Basic\t#bf9c81\tLight Brown\t1.7\t{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9}
+Overture Basic\t#033877\tBlue\t3.5\t{c8518afd-068e-4a5c-90d2-9981d4d7edde}`;
+    const profiles = parseHueForgeCSV(tsv, 'My Spools');
+    assert.ok(profiles);
+    assert.equal(profiles[0].filaments.length, 2);
+    assert.equal(profiles[0].filaments[0].color, '#bf9c81');
+    assert.equal(profiles[0].filaments[0].brand, 'Inland Basic');
+    assert.equal(profiles[0].filaments[1].color, '#033877');
+});
+
+test('parseHueForgeCSV TSV does not split on commas in values', () => {
+    const tsv = `Brand\tColor\tName\tTD
+Inland, Basic\t#bf9c81\tLight Brown\t1.7`;
+    const [profile] = parseHueForgeCSV(tsv)!;
+    assert.equal(profile.filaments[0].brand, 'Inland, Basic');
+});
+
 test('auto-paint profiles can be renamed without changing filament data', () => {
     const profiles: AutoPaintProfile[] = [
         {

From 2f4a4e6472c242e1ec2808ddf98a06a5cf25089f Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sun, 14 Jun 2026 15:46:57 -0500
Subject: [PATCH 03/81] Enhance CSV parsing to normalize hex colors and skip
 invalid rows

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/lib/profileManager.ts    |  6 ++++--
 tests/profileManager.test.ts | 35 ++++++++++++++++++++++++++++-------
 2 files changed, 32 insertions(+), 9 deletions(-)

diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 8b020d3..46efc79 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -1,4 +1,5 @@
 import type { Filament } from '../types';
+import { normalizeHexColor } from './colorUtils.ts';
 
 export interface AutoPaintProfile {
     id: string;
@@ -309,10 +310,11 @@ export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'):
     const filaments: import('../types').Filament[] = [];
     for (const line of lines.slice(1)) {
         const row = parseRow(line, delimiter);
-        const color = col(row, 'Color');
+        const colorRaw = col(row, 'Color');
+        const color = normalizeHexColor(colorRaw, '');
         const tdRaw = col(row, 'TD');
         const td = parseFloat(tdRaw);
-        if (!color || isNaN(td)) continue;
+        if (!color || isNaN(td) || td < 0.5 || td > 10.0) continue;
 
         const rawId = col(row, 'Uuid').replace(/[{}]/g, '');
         const id = rawId || crypto.randomUUID();
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 3aed807..387bf95 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -38,7 +38,7 @@ test('parseHueForgeCSV parses filaments from HueForge CSV', () => {
 test('parseHueForgeCSV maps color and TD correctly', () => {
     const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
     const [first] = profile.filaments;
-    assert.equal(first.color, '#bf9c81');
+    assert.equal(first.color, '#BF9C81');
     assert.equal(first.td, 1.7);
 });
 
@@ -50,7 +50,7 @@ test('parseHueForgeCSV strips braces from UUIDs', () => {
 
 test('parseHueForgeCSV formats names as <mfr>-<color-name>-<color-hex>', () => {
     const [profile] = parseHueForgeCSV(HUEFORGE_CSV)!;
-    assert.equal(profile.filaments[0].name, 'Inland Basic-Light Brown-#bf9c81');
+    assert.equal(profile.filaments[0].name, 'Inland Basic-Light Brown-#BF9C81');
     assert.equal(profile.filaments[1].name, 'Overture Basic-Blue-#033877');
 });
 
@@ -65,10 +65,10 @@ test('parseHueForgeCSV handles columns in non-standard order', () => {
 1.7,Light Brown,{631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9},#bf9c81,Inland Basic,PLA`;
     const [profile] = parseHueForgeCSV(csv)!;
     const [f] = profile.filaments;
-    assert.equal(f.color, '#bf9c81');
+    assert.equal(f.color, '#BF9C81');
     assert.equal(f.td, 1.7);
     assert.equal(f.brand, 'Inland Basic');
-    assert.equal(f.name, 'Inland Basic-Light Brown-#bf9c81');
+    assert.equal(f.name, 'Inland Basic-Light Brown-#BF9C81');
     assert.equal(f.id, '631cbb3a-9db8-45b4-96cd-5d21a5f3b2e9');
 });
 
@@ -78,8 +78,8 @@ test('parseHueForgeCSV handles quoted fields containing commas', () => {
     const [profile] = parseHueForgeCSV(csv)!;
     const [f] = profile.filaments;
     assert.equal(f.brand, 'Inland, Basic');
-    assert.equal(f.color, '#bf9c81');
-    assert.equal(f.name, 'Inland, Basic-Light, Brown-#bf9c81');
+    assert.equal(f.color, '#BF9C81');
+    assert.equal(f.name, 'Inland, Basic-Light, Brown-#BF9C81');
     assert.equal(f.td, 1.7);
 });
 
@@ -107,7 +107,7 @@ Overture Basic\t#033877\tBlue\t3.5\t{c8518afd-068e-4a5c-90d2-9981d4d7edde}`;
     const profiles = parseHueForgeCSV(tsv, 'My Spools');
     assert.ok(profiles);
     assert.equal(profiles[0].filaments.length, 2);
-    assert.equal(profiles[0].filaments[0].color, '#bf9c81');
+    assert.equal(profiles[0].filaments[0].color, '#BF9C81');
     assert.equal(profiles[0].filaments[0].brand, 'Inland Basic');
     assert.equal(profiles[0].filaments[1].color, '#033877');
 });
@@ -119,6 +119,27 @@ Inland, Basic\t#bf9c81\tLight Brown\t1.7`;
     assert.equal(profile.filaments[0].brand, 'Inland, Basic');
 });
 
+test('parseHueForgeCSV skips rows with invalid hex color', () => {
+    const csv = `Brand,Color,Name,TD
+Inland Basic,red,Light Brown,1.7
+Inland Basic,rgb(255,0,0),Light Brown,1.7
+Overture Basic,#033877,Blue,3.5`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    assert.equal(profile.filaments.length, 1);
+    assert.equal(profile.filaments[0].color, '#033877');
+});
+
+test('parseHueForgeCSV skips rows with TD out of plausible range', () => {
+    const csv = `Brand,Color,Name,TD
+Inland Basic,#bf9c81,Light Brown,-1
+Inland Basic,#bf9c81,Light Brown,0
+Inland Basic,#bf9c81,Light Brown,99
+Overture Basic,#033877,Blue,3.5`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    assert.equal(profile.filaments.length, 1);
+    assert.equal(profile.filaments[0].td, 3.5);
+});
+
 test('auto-paint profiles can be renamed without changing filament data', () => {
     const profiles: AutoPaintProfile[] = [
         {

From 35f2e8573e729eb53187e011493567f7ac80c75e Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 18 Jun 2026 22:36:25 +0300
Subject: [PATCH 04/81] Prepare 3.2.0 development cycle

---
 CHANGELOG.md              | 8 ++++++++
 package-lock.json         | 4 ++--
 package.json              | 2 +-
 public/version.json       | 4 ++--
 src-tauri/Cargo.lock      | 2 +-
 src-tauri/Cargo.toml      | 2 +-
 src-tauri/tauri.conf.json | 2 +-
 7 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 396752a..e9f46aa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,14 @@
 
 All notable changes to Kromacut are documented in this file.
 
+## v3.2.0 - unreleased
+
+### Added
+
+### Changed
+
+### Fixed
+
 ## v3.1.0 - 2026-06-18
 
 ### Added
diff --git a/package-lock.json b/package-lock.json
index e26282c..9e0073a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
     "name": "kromacut",
-    "version": "3.1.0",
+    "version": "3.2.0",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "kromacut",
-            "version": "3.1.0",
+            "version": "3.2.0",
             "license": "AGPL-3.0-only",
             "dependencies": {
                 "@dnd-kit/core": "^6.3.1",
diff --git a/package.json b/package.json
index 9939a14..9b40379 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
     "name": "kromacut",
     "private": true,
-    "version": "3.1.0",
+    "version": "3.2.0",
     "license": "AGPL-3.0-only",
     "type": "module",
     "scripts": {
diff --git a/public/version.json b/public/version.json
index 3802684..42f8d13 100644
--- a/public/version.json
+++ b/public/version.json
@@ -1,5 +1,5 @@
 {
-  "version": "3.1.0",
+  "version": "3.2.0",
   "download_url": "https://github.com/vycdev/Kromacut/releases/latest",
-  "release_notes": "Kromacut 3.1.0 adds orthographic preview mode, experimental Flat Paint, desktop update settings, and next-best-color filament suggestions."
+  "release_notes": "Upcoming Kromacut 3.2.0 release with new features and improvements."
 }
diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock
index 99efa6e..61370cc 100644
--- a/src-tauri/Cargo.lock
+++ b/src-tauri/Cargo.lock
@@ -1907,7 +1907,7 @@ dependencies = [
 
 [[package]]
 name = "kromacut"
-version = "3.1.0"
+version = "3.2.0"
 dependencies = [
  "log",
  "reqwest 0.12.28",
diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml
index 3be2eaa..cfbae60 100644
--- a/src-tauri/Cargo.toml
+++ b/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "kromacut"
-version = "3.1.0"
+version = "3.2.0"
 description = "Kromacut - Multi-color lithophane 3D print generator"
 authors = ["vycdev"]
 license = "AGPL-3.0-only"
diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json
index 3405864..3b89c1e 100644
--- a/src-tauri/tauri.conf.json
+++ b/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
     "$schema": "../node_modules/@tauri-apps/cli/config.schema.json",
     "productName": "Kromacut",
-    "version": "3.1.0",
+    "version": "3.2.0",
     "identifier": "com.kromacut.lithophane",
     "build": {
         "frontendDist": "../dist",

From 2191c2ec4f6e399ea42f883212c918b629435e15 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 20 Jun 2026 21:25:23 +0300
Subject: [PATCH 05/81] Add auto-paint regression baseline

---
 CHANGELOG.md                           |    4 +
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md     |  418 ++++++++
 package.json                           |    1 +
 scripts/generate-auto-paint-goldens.ts |   67 ++
 src/lib/autoPaint.ts                   |    2 +-
 tests/assets/auto-paint-goldens.json   | 1218 ++++++++++++++++++++++++
 tests/autoPaint.test.ts                |  192 ++++
 tests/autoPaintGoldenFixtures.ts       |  122 +++
 tests/autoPaintGoldens.test.ts         |  118 +++
 tests/imageFixtures.ts                 |  114 ++-
 tests/optimizer.test.ts                |   70 ++
 11 files changed, 2317 insertions(+), 9 deletions(-)
 create mode 100644 docs/AUTOPAINT_IMPROVEMENT_PLAN.md
 create mode 100644 scripts/generate-auto-paint-goldens.ts
 create mode 100644 tests/assets/auto-paint-goldens.json
 create mode 100644 tests/autoPaint.test.ts
 create mode 100644 tests/autoPaintGoldenFixtures.ts
 create mode 100644 tests/autoPaintGoldens.test.ts
 create mode 100644 tests/optimizer.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e9f46aa..4fb4b2f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,10 +6,14 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
+- **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
+
 ### Changed
 
 ### Fixed
 
+- **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
+
 ## v3.1.0 - 2026-06-18
 
 ### Added
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
new file mode 100644
index 0000000..f35c4e2
--- /dev/null
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -0,0 +1,418 @@
+# Auto-Paint Algorithm Improvement Plan
+
+> Status: **PLANNED — no implementation started.**
+> Source: code review of the Auto-paint pipeline (2026-06-11). All file/line references
+> are against `develop` at commit `6b55485`.
+
+This document records verified findings about the current Auto-paint algorithms and
+turns them into a phased, testable improvement plan. Each phase is independently
+shippable and ordered so that correctness fixes land before behavioral changes, and
+measurement lands before everything.
+
+---
+
+## 1. Invariants that must hold in every phase
+
+These come from product constraints and existing tests. Any phase that breaks one is
+not shippable.
+
+- **Result schema stability**: `AutoPaintResult` and `autoPaintToSliceHeights` output
+  shapes are unchanged. Export (3MF/STL), persisted state (`ThreeDControlsStateShape`),
+  and saved profiles all consume these.
+- **Printability**: foundation zone always present; slice heights are exact
+  `layerHeight` multiples (first = `max(firstLayerHeight, layerHeight)`); ≤500 layers
+  (`autoPaint.ts:1516`); no zero-thickness zones.
+- **Layer snapping**: per-pixel snapping behavior in `ThreeDView.tsx` untouched unless a
+  phase explicitly targets it.
+- **Determinism**: same inputs + same seed → byte-identical result. (Phase 3 makes the
+  no-seed case deterministic too; it must not break the seeded case.)
+- **Worker responsiveness**: algorithm work stays in `autoPaint.worker.ts`; the main
+  thread never runs the optimizer.
+- **User data compatibility**: persisted `optimizerAlgorithm` values
+  (`auto | exhaustive | simulated-annealing | genetic`), saved profiles (`.kfil`/`.kapp`),
+  and calibration data (`CalibrationResult`) keep their meaning.
+- **Existing test suites stay green**: `tests/export3mf.test.ts` (manifoldness, color
+  collapse, seeded auto-paint regression stacks) and `tests/e2e/kromacut-flow.spec.ts`.
+
+---
+
+## 2. Verified findings
+
+### F1 — Legacy enhanced path is unreachable in production
+
+`useAutoPaintWorker.ts:203-206` always sends `optimizerOptions` (at minimum
+`{ algorithm }`), and `findBestFilamentOrder` (`autoPaint.ts:835-843`) routes to the
+advanced optimizer whenever options are present. The legacy subset-aware search
+(`findBestFilamentOrderLegacy`, `autoPaint.ts:974-1063`) only runs from tests and
+`debugAutoPaint`. Production therefore always uses the weaker scorer (F2) and never
+does subset selection (F3).
+
+### F2 — Advanced optimizer scores a different physical model than what gets built
+
+`scoreFilamentOrder` → `findBestAchievableColor` → `simulateStackAtHeight`
+(`optimizer.ts:166-238`):
+
+- Transition thickness budget is `prevFilament.td * 3` (`optimizer.ts:226`) — keyed to
+  the **previous** filament's TD. The real zone model sizes zones by the **incoming**
+  filament's TD and ΔE convergence (`calculateTransitionThickness`,
+  `autoPaint.ts:284-325`).
+- Because that budget is independent of color distance, the advanced score **cannot
+  see transition cost** (a yellow→purple order is not penalized for its expensive
+  transition).
+- Samples 20 uniform heights; ignores foundation opacity, layer grid, and compression.
+- Objective is pure weighted mean ΔE — it lacks the legacy scorer's height-spread,
+  layer-count (0.5/layer), and transition-waste (1.5/entry) penalties
+  (`scoreSequenceAgainstImage`, `autoPaint.ts:734-806`).
+- Minor: `findBestAchievableColor`'s sampled height range includes the foundation TD
+  that `simulateStackAtHeight` never consumes (top samples are duplicates).
+
+The legacy scorer builds its palette via `calculateIdealHeight` — the same model that
+`generateAutoLayers` builds geometry with and `autoPaintToSliceHeights` previews with.
+The optimizer optimizes objective A; the build pipeline realizes model B.
+
+### F3 — Subset selection lost
+
+All three advanced algorithms permute the **full** filament set. Legacy evaluated all
+non-empty subsets for ≤6 filaments (1,956 evaluations at N=6) and stopped greedy
+addition when no filament helped for >6. Today nothing can drop a harmful filament;
+repeated swaps can only add occurrences.
+
+### F4 — Region weighting is spatially blind and its mode detection is inverted
+
+- Swatches lose pixel positions at extraction (`useSwatches.ts:62-109` — pure color
+  histogram).
+- `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) reduces the full W×H weight map
+  to mean+variance, then boosts clusters by **luminance band**, never by location.
+- Numerically verified (replicated `generateCenterWeightedMapSimple` /
+  `generateEdgeWeightedMapSimple` + normalization): center maps have variance
+  ≈0.055-0.067 → classified `isHighContrast=true` → applies the **edge** adjustment;
+  edge maps on 1:1/4:3 images have variance ≈0.045-0.048 → applies the **center**
+  adjustment. The modes are swapped on square images and identical (both "edge") at
+  16:9. Behavior depends on aspect ratio, never on image content.
+- `generateAutoLayers:1267-1282` allocates the full Float32Array map per request
+  (~45 MB for the 3888×2916 fixture) only to compute two scalars.
+- The repeated-swaps path ignores region weights entirely
+  (`buildRepeatedSwapSequence` clusters at `autoPaint.ts:1098` without them).
+
+### F5 — Optimizer cache returns stale results across region modes
+
+`OptimizerCache.getCacheKey` (`optimizer.ts:101-114`) hashes the first 20 cluster
+colors but **not their weights**, and not `regionWeights` or SA/GA tuning params.
+Region weighting only changes weights → identical key → with an explicit seed,
+switching Region priority returns the cached previous-mode order (UI shows "Cache
+hit").
+
+### F6 — Non-deterministic by default
+
+Without a user seed, SA/GA seed from `Date.now()` (`optimizer.ts:525`): same image +
+filaments produce different orders run to run. Caching is also disabled in that case.
+
+### F7 — Repeated swaps are a second, conflicting optimization
+
+`buildRepeatedSwapSequence` (`autoPaint.ts:1088-1185`): greedy insert-only; position
+loop starts at 1 (`:1137`) so the foundation can never change; capped at 4 insertions;
+scored with the **legacy** objective on top of a base order chosen by the **advanced**
+objective; no remove/relocate moves.
+
+### F8 — Physics gaps shared by both paths
+
+- `blendColors` (`autoPaint.ts:217-241`) lerps in gamma sRGB with a **scalar**
+  transmission. Calibration already fits **per-channel TD** (`CalibrationResult.td:
+[r,g,b]`, `calibration.ts:283-322`) that auto-paint never reads — only
+  `tdSingleValue`.
+- `FRONTLIT_TD_SCALE = 0.1` (`autoPaint.ts:271`) is a hard-coded global fudge.
+- Zone _i_ blends over the **pure** color of filament _i−1_
+  (`buildAchievableColorPalette:656-663`, `autoPaintToSliceHeights:1499-1506`). Valid
+  pre-compression (zones are sized for ΔE convergence), wrong after `compressZones` —
+  compressed previews look cleaner than the print will, and ordering is never re-scored
+  under compression.
+- ΔE is CIE76, which over-penalizes chroma differences in saturated regions.
+- Note: gamma-space lerp is self-consistent with how calibration _measures_
+  (`predictWorkingBlendRgb`, `calibration.ts:128-140` fits `tdSingleValue` against the
+  same gamma-space model). Any change to the blend model must move together with
+  calibration fitting or it invalidates calibrated TDs.
+
+### F9 — Worker protocol: no progress, terminate-only cancel
+
+`autoPaint.worker.ts` is single-shot request/response. Exhaustive at 8 filaments ≈
+40,320 permutations × ~670 stack sims each with zero progress feedback. The hook
+terminates + recreates the worker per input change (`useAutoPaintWorker.ts:177-219`),
+paying worker startup each time.
+
+### F10 — Minor issues
+
+- `luminanceToHeight` (`autoPaint.ts:1551`) is dead code (no callers).
+- `scoreSequenceAgainstImage` multiplies weighted ΔE by `imageTargets.length`
+  (`autoPaint.ts:777`), so fixed penalty constants change relative strength with
+  cluster count.
+- SA neighbor allows `i === j` (wasted iterations) (`optimizer.ts:333-335`).
+- Zone caps (`td * 0.7`) produce off-grid zone boundaries (hidden by per-pixel re-snap).
+- UI "Exhaustive (≤8 filaments)" implies subset search; it is full-set permutations
+  only. Hook silently downgrades exhaustive >8 to `auto`
+  (`useAutoPaintWorker.ts:189-192`), duplicating a guard in `ThreeDControls.tsx:130-134`.
+- `tests/`: **no unit tests exist for `autoPaint.ts` or `optimizer.ts` internals.**
+  Coverage is indirect (export3mf seeded stacks, e2e flow).
+
+---
+
+## 3. The plan
+
+Phases are ordered: measurement → low-risk correctness → objective unification →
+search-space unification → polish → gated physics. Do not reorder Phase 4 before
+Phase 3 (widening the search around a misaligned objective optimizes the wrong thing
+harder).
+
+### Phase 0 — Test baseline + benchmark harness (prerequisite for everything)
+
+Goal: pin current behavior and make quality measurable before changing anything.
+
+- [x] **0.1 Unit tests for `autoPaint.ts` pure functions** (new
+  `tests/autoPaint.test.ts`):
+  - `calculateTransitionThickness`: returns ≥ `layerHeight`; respects `0.7×TD` cap;
+    early-exit for near-identical colors.
+  - `compressZones`: zones tile `[0, H]` contiguously (each `startHeight` equals
+    previous `endHeight`); ratio honored; no-op when under max.
+  - `calculateIdealHeight`: foundation = `max(baseThickness, td×1.3)`; zone count =
+    filament count.
+  - `autoPaintToSliceHeights`: every slice = `layerHeight` (first =
+    `max(firstLayerHeight, layerHeight)`); ≤500 layers; `virtualSwatches`,
+    `filamentSwatches`, `colorSliceHeights`, `colorOrder` lengths agree.
+- [x] **0.2 Seeded golden snapshots** of `generateAutoLayers` for the
+      2/4/8-color `.kapp` profiles × both fixture images (`tests/assets`), with
+      enhanced on/off and repeated swaps on/off: assert `filamentOrder`, zone
+      boundaries (±1e-6), `totalHeight`, `compressionRatio`. These get **re-baselined
+      deliberately** in Phases 3/4 — their job is making behavior changes visible,
+      not frozen.
+- [x] **0.3 Determinism tests**: per algorithm, same seed twice → deep-equal result.
+- [ ] **0.4 Benchmark harness** (`tests/benchmark/autoPaintBench.ts`, runnable via a
+  package script, not part of CI gating initially). Per image × profile × algorithm ×
+  seed, emit JSON with:
+  - Weighted mean ΔE (report **both** CIE76 and CIEDE2000) from clustered targets to
+    nearest achievable palette color; weighted P95.
+  - Coverage@2.3 and @5.0 (fraction of image weight within JND thresholds).
+  - **End-to-end realized error**: run the ThreeDView polyline mapping (port of
+    `ThreeDView.tsx:753-1002`, reuse the port in `tests/export3mf.test.ts:~700-768`)
+    over fixture pixels; report pixel-weighted ΔE of mapped vs original. *This is the
+    primary metric — it measures the whole pipeline, not the scorer's opinion of itself.*
+  - Structure: total height, layer count, sequence length, wasted-layer fraction,
+    compression ratio under a fixed `maxHeight` scenario.
+  - Cost: wall time, evaluations, iterations.
+  - Stability: cross-seed rank agreement for SA/GA.
+- [ ] **0.5 Acceptance rule for later phases** (documented in the harness README):
+      end-to-end realized ΔE improves on average across fixtures and regresses on no
+      fixture beyond tolerance (suggest 5%), within cost budgets (≤2 s for 8 filaments).
+
+Risk: none (additive). Estimated scope: tests only.
+
+### Phase 1 — Region weighting made spatially correct; delete the heuristic
+
+Goal: per-color weights actually reflect where colors sit in the image. Fixes F4.
+
+- [ ] **1.1** Extend swatch extraction (`useSwatches.ts`) to accumulate, per color, in
+      the same tile pass that builds the histogram: `centerWeight` and `edgeWeight`
+      (sum of the geometric per-pixel weight functions evaluated inline — no
+      Float32Array maps materialized). Both modes computed in one pass so switching
+      modes never rescans the image. Swatch entries gain optional fields; existing
+      consumers unaffected.
+- [ ] **1.2** Thread the chosen mode's weighted count through
+      `useAutoPaintWorker` → worker request → `generateAutoLayers`: when mode ≠
+      `uniform`, use the weighted count as `count` input to `clusterImageColors`
+      (which already weights by count). Keep raw count for display.
+- [ ] **1.3** Delete `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) and the
+      per-request map generation in `generateAutoLayers:1267-1282`. Remove
+      `regionWeights` from `OptimizerOptions`/`ScoringContext` (or keep as deprecated
+      no-op field if persisted anywhere — verify; current persistence stores only the
+      mode string, so removal should be safe).
+- [ ] **1.4** Repeated-swaps path uses the same weighted targets (fixes the
+      inconsistency at `autoPaint.ts:1098`).
+- [ ] **1.5 Tests**: synthetic fixture (red center disc on blue border):
+  - `center` mode must rank red clusters above blue; `edge` mode the reverse.
+  - Mode `uniform` byte-identical to pre-change output (golden snapshot).
+  - No `Float32Array(width*height)` allocation in the worker path (can assert via
+    absence of the code path / memory not practical — code-level assertion).
+
+Risk: low-medium (plumbing). User-visible: center/edge modes start doing what their
+labels say (today they are swapped or no-ops — treat as bug fix, note in CHANGELOG).
+
+### Phase 2 — Cache correctness + determinism by default
+
+Goal: fix F5, F6. Small, independent, immediately shippable.
+
+- [ ] **2.1** Cache key includes cluster **weights**, full cluster set (not first 20),
+      and all algorithm-relevant options (temperature, cooling, population, mutation,
+      elite, maxIterations). Simplest robust form: hash a canonical JSON of
+      `{filaments, clusters(L,a,b,weight), layerHeight, firstLayerHeight, algorithm,
+    seed, tuning}`.
+- [ ] **2.2** Default seed = stable 32-bit hash of the same canonical inputs instead of
+      `Date.now()` (`optimizer.ts:525`). User-provided seed still overrides. This makes
+      every run reproducible and cacheable; remove the `hasExplicitSeed` cache gating.
+- [ ] **2.3 Tests**: same inputs, no seed, twice → identical result. Toggling region
+      mode with a fixed seed → different cache entries (regression test for F5).
+      Changing only `temperature` → cache miss.
+
+Risk: low. User-visible: results stop changing between identical runs (improvement);
+"Cache hit" indicator becomes trustworthy.
+
+### Phase 3 — Unify the objective (one scorer, zone-accurate)
+
+Goal: the optimizer optimizes the same model the pipeline builds. Fixes F2; partially
+F8 (scoring side of the pure-background issue can be folded in here or deferred to
+Phase 6b).
+
+- [ ] **3.1** Move/share the palette builder: expose `buildAchievableColorPalette` +
+      `scoreSequenceAgainstImage` (or a thin `scoreSequence(sequence, context)`
+      wrapper) for use by `optimizer.ts`. `ScoringContext` carries the weighted Lab
+      targets as today.
+- [ ] **3.2** Replace `scoreFilamentOrder`/`findBestAchievableColor`/
+      `simulateStackAtHeight` with the unified scorer in exhaustive, SA, and GA.
+- [ ] **3.3 Performance work so per-eval cost stays acceptable**:
+  - Memoize `calculateTransitionThickness(bgColorHex, filamentId)` per optimizer run —
+    pair space ≤ N², eliminates the dominant inner loop.
+  - Memoize palette per unique sequence string (SA revisits neighbors).
+  - Fix the score-scale fragility while touching it: normalize by total target weight
+    instead of multiplying by `imageTargets.length` (`autoPaint.ts:777`), and rescale
+    the structural penalty constants to match (calibrate against Phase 0 harness so
+    rankings on fixtures are preserved or improved — this is a tuning task, use the
+    harness).
+- [ ] **3.4** SA neighbor: redraw `j` until `j ≠ i` (F10).
+- [ ] **3.5 Tests**: property test — the score the optimizer reports for its chosen
+      order equals `scoreSequence` of that order under the build model (was untrue
+      before). Re-baseline Phase 0 golden snapshots; harness must satisfy the Phase 0.5
+      acceptance rule. Budget: ≤2 s for 8 filaments (exhaustive falls back per
+      existing UI guard).
+
+Risk: medium — orders will change for users (expected: improvement, verified by
+harness). Determinism preserved (seeded). Schema unchanged.
+
+### Phase 4 — Variable-length search space (subsets + repeats, natively)
+
+Goal: one search over sequences, restoring subset selection (F3) and integrating
+repeats (F7). Replaces `buildRepeatedSwapSequence`.
+
+Search space: sequences of filament occurrences, length 1..(N + 4), no consecutive
+duplicates, repeats allowed **only when** `allowRepeatedSwaps` is on (otherwise
+sequences are permutations of subsets). 500-layer guard enforced via scoring penalty +
+hard cap.
+
+- [ ] **4.1** `exhaustive` (≤6 filaments): all permutations of all non-empty subsets
+      (1,956 evals at N=6 — legacy semantics restored) under the unified scorer. When
+      repeats are on, extend with the bounded insertion expansion as a post-pass _of
+      the same scorer_ (cheap and already consistent), or fold repeats into beam
+      search (4.2) and route there. Update UI label/threshold honestly (≤6, not ≤8;
+      keep the existing >threshold downgrade-to-auto behavior in one place — remove
+      the duplicate guard, F10).
+- [ ] **4.2** **Beam search** (new internal algorithm, used by `auto` for 7-12
+      filaments): build sequences bottom-up; at each depth keep top-K (K≈100, tunable
+      via harness) partial stacks scored with the unified scorer; candidate extensions
+      = any non-duplicate filament occurrence + "stop" (subset selection falls out
+      naturally). Deterministic, anytime, trivially reports progress (depth/maxDepth).
+- [ ] **4.3** **Variable-length SA** (replaces permutation SA; used by
+      `simulated-annealing` and by `auto` for >12): moves = swap(i,j), relocate(i→j),
+      insert(filament, pos) [only if repeats allowed or filament unused],
+      remove(pos) [if length > 1], replace(pos, filament). Seeded move selection;
+      geometric cooling as today.
+- [ ] **4.4** GA (`genetic` UI value): keep permutation GA over the full set initially
+      but wrap with subset-aware repair, or route `genetic` to variable-length SA with
+      a different default budget if GA quality on the harness is not competitive.
+      Decide on harness data, not in advance.
+- [ ] **4.5** Delete `buildRepeatedSwapSequence`; `generateAutoLayers` passes
+      `allowRepeatedSwaps` into optimizer options instead
+      (`autoPaint.ts:1307-1316`).
+- [ ] **4.6 Tests**: printability invariants (foundation exists; no consecutive
+  duplicate filament ids; sequence length caps; result schema unchanged; slice snapping
+  unchanged); per-seed determinism for each algorithm; harness non-regression per
+  Phase 0.5; specific scenario tests:
+  - A filament strictly worse than every alternative (e.g., a near-duplicate hue with
+    worse TD) gets dropped (subset regression — impossible today).
+  - Thin-white-over-red produces a pink intermediate when repeats are on (repeated-swap
+    regression).
+  - `allowRepeatedSwaps=false` → no filament appears twice.
+
+Risk: medium-high (largest behavioral change; biggest quality upside). UI: **no new
+dropdown entries** — `auto/exhaustive/simulated-annealing/genetic` keep their persisted
+values and re-map internally (decision log §4).
+
+### Phase 5 — Worker progress + lifecycle polish
+
+Goal: fix F9 ergonomics. Independent of phases 3-4 but nicer after them (beam search
+has natural progress).
+
+- [ ] **5.1** Optimizer accepts `onProgress(iteration, total, bestScore)`; worker
+      throttles (~10 Hz) `postMessage({ type: 'progress', id, ... })`; final message
+      keeps the current shape (`{ id, result }`) for compatibility.
+- [ ] **5.2** Hook surfaces `progress` in `UseAutoPaintWorkerResult`; AutoPaintTab
+      shows it next to the spinner ("Optimizing… 43%").
+- [ ] **5.3** Keep terminate-based cancel; optionally keep a warm worker between
+      requests and cancel via `id` checks instead of terminate (measure startup cost
+      first — only do this if it's noticeable).
+- [ ] **5.4 Tests**: progress monotonic 0→1 (mirror `tests/algorithms-progress.test.ts`
+      pattern); stale progress messages (old `id`) ignored.
+
+Risk: low.
+
+### Phase 6 — Physics upgrades (each gated behind a constant + harness validation)
+
+Goal: close F8 where measurement proves it helps. Each item independent; ship only
+with harness evidence. These change preview colors for existing projects — CHANGELOG
+each.
+
+- [ ] **6a Per-channel TD blending where calibration exists**: `blendColors` uses
+      `calibration.td: [r,g,b]` (per-channel transmission, gamma-space — consistent
+      with how calibration measures) when present; scalar `tdSingleValue` fallback
+      unchanged for uncalibrated filaments. Touches `blendColors` call sites in
+      `autoPaint.ts` only; `Filament` already carries `calibration`.
+- [ ] **6b Compression-aware backgrounds**: carry the actual blended end-color of zone
+      _i−1_ forward as zone _i_'s background in `buildAchievableColorPalette` and
+      `autoPaintToSliceHeights` (today: pure color, `autoPaint.ts:656-663, 1499-1506`).
+      Makes compressed previews honest and lets the (unified) scorer see compression
+      damage. Optionally: when `compressionRatio < 0.9`, re-score the top-k candidate
+      orders under compression and pick the best (bounded cost).
+- [ ] **6c CIEDE2000** behind a metric constant for scoring + clustering distances
+      (~3-4× distance cost; affordable at ≤32 targets). Adopt only if harness shows
+      end-to-end improvement on saturated fixtures.
+- [ ] **6d FRONTLIT_TD_SCALE**: leave at 0.1 for now; add a calibration-wizard-derived
+      frontlit factor as a future item (requires new measurement flow — out of scope).
+- [ ] **6e Cleanup**: delete dead `luminanceToHeight` (`autoPaint.ts:1551`); update the
+      stale module doc header (`autoPaint.ts:1-17`).
+
+Risk: medium (visual shifts); mitigated by gating + harness + CHANGELOG.
+
+---
+
+## 4. Decision log
+
+- **No new UI algorithm choices.** Persisted `optimizerAlgorithm` values keep their
+  names; internals re-map (`auto` → subset-exhaustive ≤6 / beam 7-12 / var-length SA
+  above; `exhaustive` → subset-exhaustive with honest ≤6 cap; `simulated-annealing` →
+  variable-length SA; `genetic` → keep or alias per Phase 4.4 harness data). Beam
+  search is an `auto` implementation detail, not a dropdown entry. Rationale: choices
+  are speed/quality trade-offs users already understand; renaming breaks saved
+  profiles/state.
+- **Rejected: DP / shortest-path over discretized color states.** Reachable-color
+  state space (Lab × height with path-dependent blending) discretizes poorly; beam
+  search captures the same "build bottom-up, prune" idea without state-explosion risk.
+- **Rejected (for now): variable-length genomes in GA.** Crossover design is fiddly;
+  at ≤16 filaments variable-length SA + beam cover the space. Revisit only if harness
+  shows SA stuck.
+- **Gamma-space blending stays** (not switched to linear-light): calibration fits TDs
+  against the same gamma-space model, so the pair is self-consistent; changing it
+  would invalidate users' calibrated TDs (F8 note). Per-channel TD (6a) improves hue
+  realism without breaking that consistency.
+- **`buildRepeatedSwapSequence` is deleted in Phase 4**, not improved in place — its
+  objective-mixing is structural (F7).
+
+## 5. Quick reference: finding → phase
+
+| Finding                                   | Fixed in            |
+| ----------------------------------------- | ------------------- |
+| F1 legacy path dead / weak scorer in prod | Phase 3 (+4)        |
+| F2 misaligned objective                   | Phase 3             |
+| F3 subset selection lost                  | Phase 4             |
+| F4 region weighting blind/inverted        | Phase 1             |
+| F5 stale cache across modes               | Phase 2             |
+| F6 non-deterministic default              | Phase 2             |
+| F7 repeated swaps bolt-on                 | Phase 4             |
+| F8 physics gaps                           | Phase 6 (a-d)       |
+| F9 worker progress                        | Phase 5             |
+| F10 minor issues                          | Phases 3.4, 4.1, 6e |
+| No unit tests / no benchmark              | Phase 0             |
diff --git a/package.json b/package.json
index 9b40379..3364639 100644
--- a/package.json
+++ b/package.json
@@ -8,6 +8,7 @@
         "dev": "vite",
         "build": "tsc -b && vite build && node scripts/generate-docs-seo-pages.mjs",
         "test": "node --no-warnings --experimental-strip-types tests/run-tests.ts",
+        "test:autopaint:update": "node --no-warnings --experimental-strip-types scripts/generate-auto-paint-goldens.ts",
         "test:e2e": "playwright test --grep @smoke",
         "test:e2e:matrix": "playwright test --grep @matrix",
         "test:e2e:stress": "playwright test --grep @stress",
diff --git a/scripts/generate-auto-paint-goldens.ts b/scripts/generate-auto-paint-goldens.ts
new file mode 100644
index 0000000..7b40b26
--- /dev/null
+++ b/scripts/generate-auto-paint-goldens.ts
@@ -0,0 +1,67 @@
+import { writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { createServer } from 'vite';
+
+import { autoPaintGoldenScenarios } from '../tests/autoPaintGoldenFixtures.ts';
+
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+
+const LAYER_HEIGHT = 0.08;
+const FIRST_LAYER_HEIGHT = 0.16;
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule('/src/lib/autoPaint.ts')) as AutoPaintModule;
+    } finally {
+        await server.close();
+    }
+}
+
+const { generateAutoLayers } = await loadAutoPaintModule();
+const goldens = Object.fromEntries(
+    autoPaintGoldenScenarios().map((scenario) => {
+        const result = generateAutoLayers(
+            scenario.filaments,
+            scenario.imageSwatches,
+            LAYER_HEIGHT,
+            FIRST_LAYER_HEIGHT,
+            undefined,
+            scenario.enhancedColorMatch,
+            scenario.allowRepeatedSwaps,
+            { algorithm: 'auto', seed: scenario.seed },
+            'uniform',
+            scenario.imageDimensions
+        );
+
+        return [
+            scenario.name,
+            {
+                filamentOrder: result.filamentOrder,
+                transitionZones: result.transitionZones.map((zone) => ({
+                    filamentId: zone.filamentId,
+                    startHeight: zone.startHeight,
+                    endHeight: zone.endHeight,
+                    idealThickness: zone.idealThickness,
+                    actualThickness: zone.actualThickness,
+                })),
+                totalHeight: result.totalHeight,
+                compressionRatio: result.compressionRatio,
+            },
+        ];
+    })
+);
+
+const outputPath = resolve('tests', 'assets', 'auto-paint-goldens.json');
+writeFileSync(outputPath, `${JSON.stringify(goldens, null, 2)}\n`);
+console.log(`Wrote ${Object.keys(goldens).length} auto-paint goldens to ${outputPath}`);
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 56f98d8..2893847 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -1513,7 +1513,7 @@ export function autoPaintToSliceHeights(
         currentZ += thickness;
         layerIndex++;
 
-        if (layerIndex > 500) {
+        if (layerIndex >= 500) {
             console.warn('autoPaintToSliceHeights: too many layers, stopping at 500');
             break;
         }
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
new file mode 100644
index 0000000..33125d2
--- /dev/null
+++ b/tests/assets/auto-paint-goldens.json
@@ -0,0 +1,1218 @@
+{
+  "B&W / logo-png / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / logo-png / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / logo-png / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "p9c63ms",
+      "plvjtmc"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0,
+        "endHeight": 0.7800000000000001,
+        "idealThickness": 0.7800000000000001,
+        "actualThickness": 0.7800000000000001
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.7800000000000001,
+        "endHeight": 0.8600000000000001,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      }
+    ],
+    "totalHeight": 0.8600000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / logo-png / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "p9c63ms",
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0,
+        "endHeight": 0.7800000000000001,
+        "idealThickness": 0.7800000000000001,
+        "actualThickness": 0.7800000000000001
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.7800000000000001,
+        "endHeight": 0.8600000000000001,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.8600000000000001,
+        "endHeight": 1.2800000000000002,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 1.2800000000000002,
+    "compressionRatio": 1
+  },
+  "B&W / large-jpeg / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / large-jpeg / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / large-jpeg / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "B&W / large-jpeg / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 0.5800000000000001,
+    "compressionRatio": 1
+  },
+  "GH#27 / logo-png / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "h8zuocq",
+      "xud8mzr",
+      "y202l1e"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.405,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.405,
+        "endHeight": 0.645,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.645,
+        "endHeight": 0.974,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      }
+    ],
+    "totalHeight": 0.974,
+    "compressionRatio": 1
+  },
+  "GH#27 / logo-png / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "h8zuocq",
+      "xud8mzr",
+      "y202l1e"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.405,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.405,
+        "endHeight": 0.645,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.645,
+        "endHeight": 0.974,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      }
+    ],
+    "totalHeight": 0.974,
+    "compressionRatio": 1
+  },
+  "GH#27 / logo-png / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "h8zuocq",
+      "xud8mzr",
+      "plvjtmc",
+      "y202l1e"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0,
+        "endHeight": 0.45500000000000007,
+        "idealThickness": 0.45500000000000007,
+        "actualThickness": 0.45500000000000007
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.45500000000000007,
+        "endHeight": 0.6950000000000001,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.6950000000000001,
+        "endHeight": 0.775,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.775,
+        "endHeight": 1.104,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      }
+    ],
+    "totalHeight": 1.104,
+    "compressionRatio": 1
+  },
+  "GH#27 / logo-png / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "h8zuocq",
+      "xud8mzr",
+      "h8zuocq",
+      "y202l1e",
+      "plvjtmc",
+      "y202l1e",
+      "plvjtmc"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0,
+        "endHeight": 0.45500000000000007,
+        "idealThickness": 0.45500000000000007,
+        "actualThickness": 0.45500000000000007
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.45500000000000007,
+        "endHeight": 0.6950000000000001,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.6950000000000001,
+        "endHeight": 0.935,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.935,
+        "endHeight": 1.264,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.264,
+        "endHeight": 1.344,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 1.344,
+        "endHeight": 1.673,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.673,
+        "endHeight": 1.7530000000000001,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      }
+    ],
+    "totalHeight": 1.7530000000000001,
+    "compressionRatio": 1
+  },
+  "GH#27 / large-jpeg / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "h8zuocq",
+      "xud8mzr",
+      "y202l1e"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.405,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.405,
+        "endHeight": 0.645,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.645,
+        "endHeight": 0.974,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      }
+    ],
+    "totalHeight": 0.974,
+    "compressionRatio": 1
+  },
+  "GH#27 / large-jpeg / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "h8zuocq",
+      "xud8mzr",
+      "y202l1e"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.405,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.405,
+        "endHeight": 0.645,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.645,
+        "endHeight": 0.974,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      }
+    ],
+    "totalHeight": 0.974,
+    "compressionRatio": 1
+  },
+  "GH#27 / large-jpeg / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "xud8mzr",
+      "y202l1e",
+      "plvjtmc",
+      "h8zuocq"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0,
+        "endHeight": 0.4810000000000001,
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.4810000000000001
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.4810000000000001,
+        "endHeight": 0.81,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.81,
+        "endHeight": 0.89,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.89,
+        "endHeight": 1.135,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      }
+    ],
+    "totalHeight": 1.135,
+    "compressionRatio": 1
+  },
+  "GH#27 / large-jpeg / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "xud8mzr",
+      "plvjtmc",
+      "xud8mzr",
+      "plvjtmc",
+      "y202l1e",
+      "xud8mzr",
+      "plvjtmc",
+      "h8zuocq"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0,
+        "endHeight": 0.4810000000000001,
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.4810000000000001
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.4810000000000001,
+        "endHeight": 0.561,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.561,
+        "endHeight": 0.8200000000000001,
+        "idealThickness": 0.259,
+        "actualThickness": 0.259
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.8200000000000001,
+        "endHeight": 0.9,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.9,
+        "endHeight": 1.229,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 1.229,
+        "endHeight": 1.488,
+        "idealThickness": 0.259,
+        "actualThickness": 0.259
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.488,
+        "endHeight": 1.568,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 1.568,
+        "endHeight": 1.8130000000000002,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
+      }
+    ],
+    "totalHeight": 1.8130000000000002,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "98z555k",
+      "upcjpfe",
+      "xyyxysq",
+      "w8cncoa",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0.16,
+        "endHeight": 0.356,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.356,
+        "endHeight": 0.6219999999999999,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.6219999999999999,
+        "endHeight": 0.8949999999999998,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8949999999999998,
+        "endHeight": 1.2379999999999998,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.2379999999999998,
+        "endHeight": 1.5949999999999998,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.5949999999999998,
+        "endHeight": 2.0359999999999996,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.0359999999999996,
+        "endHeight": 2.4559999999999995,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 2.4559999999999995,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / logo-png / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "98z555k",
+      "upcjpfe",
+      "xyyxysq",
+      "w8cncoa",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0.16,
+        "endHeight": 0.356,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.356,
+        "endHeight": 0.6219999999999999,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.6219999999999999,
+        "endHeight": 0.8949999999999998,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8949999999999998,
+        "endHeight": 1.2379999999999998,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.2379999999999998,
+        "endHeight": 1.5949999999999998,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.5949999999999998,
+        "endHeight": 2.0359999999999996,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.0359999999999996,
+        "endHeight": 2.4559999999999995,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 2.4559999999999995,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "p9c63ms",
+      "plvjtmc",
+      "upcjpfe",
+      "azwg1yp",
+      "98z555k",
+      "xyyxysq",
+      "w8cncoa",
+      "vsn9q6u"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0,
+        "endHeight": 0.7800000000000001,
+        "idealThickness": 0.7800000000000001,
+        "actualThickness": 0.7800000000000001
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.7800000000000001,
+        "endHeight": 0.8600000000000001,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8600000000000001,
+        "endHeight": 1.203,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 1.203,
+        "endHeight": 1.399,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 1.399,
+        "endHeight": 1.672,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.672,
+        "endHeight": 2.029,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 2.029,
+        "endHeight": 2.4699999999999998,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.4699999999999998,
+        "endHeight": 2.7359999999999998,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      }
+    ],
+    "totalHeight": 2.7359999999999998,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "vsn9q6u",
+      "98z555k",
+      "vsn9q6u",
+      "azwg1yp",
+      "xyyxysq",
+      "w8cncoa",
+      "upcjpfe",
+      "azwg1yp",
+      "p9c63ms",
+      "plvjtmc",
+      "azwg1yp",
+      "w8cncoa"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0,
+        "endHeight": 0.49400000000000005,
+        "idealThickness": 0.49400000000000005,
+        "actualThickness": 0.49400000000000005
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.49400000000000005,
+        "endHeight": 0.767,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.767,
+        "endHeight": 1.033,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 1.033,
+        "endHeight": 1.2289999999999999,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.2289999999999999,
+        "endHeight": 1.5859999999999999,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.5859999999999999,
+        "endHeight": 2.0269999999999997,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 2.0269999999999997,
+        "endHeight": 2.3699999999999997,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.3699999999999997,
+        "endHeight": 2.566,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.566,
+        "endHeight": 2.9859999999999998,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 2.9859999999999998,
+        "endHeight": 3.066,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 3.066,
+        "endHeight": 3.262,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 3.262,
+        "endHeight": 3.703,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      }
+    ],
+    "totalHeight": 3.703,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
+    "filamentOrder": [
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "98z555k",
+      "upcjpfe",
+      "xyyxysq",
+      "w8cncoa",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0.16,
+        "endHeight": 0.356,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.356,
+        "endHeight": 0.6219999999999999,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.6219999999999999,
+        "endHeight": 0.8949999999999998,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8949999999999998,
+        "endHeight": 1.2379999999999998,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.2379999999999998,
+        "endHeight": 1.5949999999999998,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.5949999999999998,
+        "endHeight": 2.0359999999999996,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.0359999999999996,
+        "endHeight": 2.4559999999999995,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 2.4559999999999995,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / large-jpeg / enhanced=false / repeats=true": {
+    "filamentOrder": [
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "98z555k",
+      "upcjpfe",
+      "xyyxysq",
+      "w8cncoa",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0.16,
+        "endHeight": 0.356,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.356,
+        "endHeight": 0.6219999999999999,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.6219999999999999,
+        "endHeight": 0.8949999999999998,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8949999999999998,
+        "endHeight": 1.2379999999999998,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.2379999999999998,
+        "endHeight": 1.5949999999999998,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.5949999999999998,
+        "endHeight": 2.0359999999999996,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.0359999999999996,
+        "endHeight": 2.4559999999999995,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 2.4559999999999995,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
+    "filamentOrder": [
+      "azwg1yp",
+      "98z555k",
+      "upcjpfe",
+      "xyyxysq",
+      "w8cncoa",
+      "vsn9q6u",
+      "plvjtmc",
+      "p9c63ms"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0,
+        "endHeight": 0.364,
+        "idealThickness": 0.364,
+        "actualThickness": 0.364
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.364,
+        "endHeight": 0.637,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.637,
+        "endHeight": 0.98,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 0.98,
+        "endHeight": 1.337,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.337,
+        "endHeight": 1.778,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.778,
+        "endHeight": 2.044,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 2.044,
+        "endHeight": 2.124,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.124,
+        "endHeight": 2.544,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      }
+    ],
+    "totalHeight": 2.544,
+    "compressionRatio": 1
+  },
+  "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
+    "filamentOrder": [
+      "azwg1yp",
+      "98z555k",
+      "plvjtmc",
+      "p9c63ms",
+      "w8cncoa",
+      "xyyxysq",
+      "vsn9q6u",
+      "upcjpfe",
+      "98z555k",
+      "upcjpfe",
+      "plvjtmc",
+      "w8cncoa"
+    ],
+    "transitionZones": [
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 0,
+        "endHeight": 0.364,
+        "idealThickness": 0.364,
+        "actualThickness": 0.364
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.364,
+        "endHeight": 0.637,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.637,
+        "endHeight": 0.717,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.717,
+        "endHeight": 1.137,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.137,
+        "endHeight": 1.5779999999999998,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.5779999999999998,
+        "endHeight": 1.9349999999999998,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.9349999999999998,
+        "endHeight": 2.2009999999999996,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 2.2009999999999996,
+        "endHeight": 2.5439999999999996,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 2.5439999999999996,
+        "endHeight": 2.8169999999999997,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 2.8169999999999997,
+        "endHeight": 3.1599999999999997,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 3.1599999999999997,
+        "endHeight": 3.2399999999999998,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 3.2399999999999998,
+        "endHeight": 3.6809999999999996,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
+      }
+    ],
+    "totalHeight": 3.6809999999999996,
+    "compressionRatio": 1
+  }
+}
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
new file mode 100644
index 0000000..5153d65
--- /dev/null
+++ b/tests/autoPaint.test.ts
@@ -0,0 +1,192 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+
+const EPSILON = 1e-9;
+let autoPaintModule: Promise<AutoPaintModule> | null = null;
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
+    return autoPaintModule;
+}
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+function assertAlmostEqual(actual: number, expected: number, message?: string) {
+    assert.ok(
+        Math.abs(actual - expected) <= EPSILON,
+        message ?? `expected ${actual} to be within ${EPSILON} of ${expected}`
+    );
+}
+
+test('transition thickness stays printable and respects its TD cap', async () => {
+    const { calculateTransitionThickness, hexToRgb } = await loadAutoPaintModule();
+    const layerHeight = 0.1;
+    const td = 1;
+    const thickness = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        td,
+        layerHeight
+    );
+
+    assert.ok(thickness >= layerHeight, 'a transition must contain at least one layer');
+    assert.ok(thickness <= td * 0.7 + EPSILON, 'a transition must not exceed the TD cap');
+
+    const nearIdenticalThickness = calculateTransitionThickness(
+        hexToRgb('#112233'),
+        hexToRgb('#112234'),
+        td,
+        layerHeight
+    );
+    assert.equal(
+        nearIdenticalThickness,
+        layerHeight,
+        'near-identical colors should use exactly one layer'
+    );
+});
+
+test('ideal-height zones include a foundation and remain contiguous when compressed', async () => {
+    const { calculateIdealHeight, compressZones } = await loadAutoPaintModule();
+    const layerHeight = 0.1;
+    const baseThickness = 0.6;
+    const { idealHeight, zones } = calculateIdealHeight(
+        [
+            { id: 'black', color: '#000000', td: 0.5 },
+            { id: 'red', color: '#ff0000', td: 0.8 },
+            { id: 'white', color: '#ffffff', td: 1.1 },
+        ],
+        layerHeight,
+        baseThickness
+    );
+
+    assert.equal(zones.length, 3, 'each filament should produce one zone');
+    assertAlmostEqual(
+        zones[0].actualThickness,
+        Math.max(baseThickness, 0.5 * 1.3),
+        'the foundation must be thick enough to be opaque'
+    );
+    assertAlmostEqual(zones[0].startHeight, 0);
+    assertAlmostEqual(zones[zones.length - 1].endHeight, idealHeight);
+
+    const { compressedZones, compressionRatio } = compressZones(zones, idealHeight / 2);
+    assertAlmostEqual(compressionRatio, 0.5);
+    assert.equal(compressedZones.length, zones.length);
+    assertAlmostEqual(
+        compressedZones[compressedZones.length - 1].endHeight,
+        idealHeight / 2,
+        'compressed zones should end exactly at the requested height'
+    );
+
+    for (let index = 0; index < compressedZones.length; index++) {
+        const zone = compressedZones[index];
+        assert.ok(zone.actualThickness > 0, `zone ${index} must have positive thickness`);
+        if (index > 0) {
+            assertAlmostEqual(
+                zone.startHeight,
+                compressedZones[index - 1].endHeight,
+                `zone ${index} must start where the previous zone ends`
+            );
+        }
+    }
+
+    const noCompression = compressZones(zones, idealHeight + 1);
+    assert.equal(noCompression.compressionRatio, 1, 'a sufficiently tall limit should not compress');
+    assert.deepEqual(noCompression.compressedZones, zones);
+});
+
+test('auto-paint slice data stays synchronized and uses print-layer heights', async () => {
+    const { autoPaintToSliceHeights, generateAutoLayers } = await loadAutoPaintModule();
+    const layerHeight = 0.1;
+    const firstLayerHeight = 0.2;
+    const result = generateAutoLayers(
+        [
+            { id: 'black', color: '#000000', td: 1 },
+            { id: 'white', color: '#ffffff', td: 1.5 },
+        ],
+        [
+            { hex: '#000000', count: 10 },
+            { hex: '#ffffff', count: 10 },
+        ],
+        layerHeight,
+        firstLayerHeight,
+        undefined,
+        false
+    );
+    const slices = autoPaintToSliceHeights(result, layerHeight, firstLayerHeight);
+
+    assert.ok(slices.colorSliceHeights.length > 0, 'a valid stack should produce slices');
+    assert.equal(slices.colorSliceHeights[0], firstLayerHeight);
+    for (const height of slices.colorSliceHeights.slice(1)) {
+        assert.equal(height, layerHeight, 'all later slices should use the configured layer height');
+    }
+    assert.ok(slices.colorSliceHeights.length <= 500, 'slice output must respect the safety limit');
+    assert.equal(slices.virtualSwatches.length, slices.colorSliceHeights.length);
+    assert.equal(slices.filamentSwatches.length, slices.colorSliceHeights.length);
+    assert.equal(slices.colorOrder.length, slices.colorSliceHeights.length);
+    assert.deepEqual(
+        slices.colorOrder,
+        slices.colorOrder.map((_, index) => index),
+        'slice ordering should be sequential'
+    );
+});
+
+test('auto-paint slice data never returns more than 500 layers', async () => {
+    const { autoPaintToSliceHeights } = await loadAutoPaintModule();
+    const tallResult = {
+        layers: [
+            {
+                filamentId: 'black',
+                filamentColor: '#000000',
+                startHeight: 0,
+                endHeight: 100,
+            },
+        ],
+        totalHeight: 100,
+        idealHeight: 100,
+        autoHeight: 100,
+        compressionRatio: 1,
+        filamentOrder: ['black'],
+        transitionZones: [
+            {
+                filamentId: 'black',
+                filamentColor: '#000000',
+                filamentTd: 1,
+                startHeight: 0,
+                endHeight: 100,
+                idealThickness: 100,
+                actualThickness: 100,
+            },
+        ],
+        confidence: 1,
+        confidenceFactors: {
+            calibrationQuality: 1,
+            filamentCoverage: 1,
+            compressionImpact: 1,
+        },
+    };
+
+    const slices = autoPaintToSliceHeights(tallResult, 0.1, 0.2);
+    assert.ok(slices.colorSliceHeights.length <= 500);
+    assert.equal(slices.colorSliceHeights.length, 500);
+});
diff --git a/tests/autoPaintGoldenFixtures.ts b/tests/autoPaintGoldenFixtures.ts
new file mode 100644
index 0000000..371c331
--- /dev/null
+++ b/tests/autoPaintGoldenFixtures.ts
@@ -0,0 +1,122 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+import {
+    colorSwatchesFromJpegBlocks,
+    logoFixturePath,
+    largeIssueFixturePath,
+    readPngFixture,
+    testAssetsRoot,
+    type PngImage,
+} from './imageFixtures.ts';
+
+export interface AutoPaintGoldenScenario {
+    name: string;
+    filaments: Array<{ id: string; color: string; td: number }>;
+    imageSwatches: Array<{ hex: string; count: number }>;
+    imageDimensions: { width: number; height: number };
+    enhancedColorMatch: boolean;
+    allowRepeatedSwaps: boolean;
+    seed: number;
+}
+
+interface FilamentProfileFixture {
+    name: string;
+    filaments: Array<{ id: string; color: string; td: number }>;
+}
+
+const PROFILE_FILES = [
+    ['2_Colors.kapp', 2],
+    ['4_Colors.kapp', 4],
+    ['8_Colors.kapp', 8],
+] as const;
+const SWATCH_CAP = 2 ** 14;
+
+function readProfile(fileName: string, expectedFilamentCount: number): FilamentProfileFixture {
+    const profilePath = resolve(testAssetsRoot, 'filament-profiles', fileName);
+    const parsed = JSON.parse(readFileSync(profilePath, 'utf8')) as Partial<FilamentProfileFixture>;
+
+    if (!parsed.name || !parsed.filaments || parsed.filaments.length !== expectedFilamentCount) {
+        throw new Error(`Unexpected auto-paint profile fixture: ${fileName}`);
+    }
+
+    return {
+        name: parsed.name,
+        filaments: parsed.filaments.map((filament) => ({
+            id: filament.id,
+            color: filament.color,
+            td: filament.td,
+        })),
+    };
+}
+
+function rgbToHex(r: number, g: number, b: number) {
+    return `#${[r, g, b]
+        .map((value) => value.toString(16).padStart(2, '0'))
+        .join('')}`;
+}
+
+function pngSwatches(image: PngImage): Array<{ hex: string; count: number }> {
+    const counts = new Map<string, number>();
+
+    for (let index = 0; index < image.rgba.length; index += 4) {
+        if (image.rgba[index + 3] === 0) continue;
+
+        const hex = rgbToHex(image.rgba[index], image.rgba[index + 1], image.rgba[index + 2]);
+        counts.set(hex, (counts.get(hex) ?? 0) + 1);
+    }
+
+    return Array.from(counts.entries())
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .slice(0, SWATCH_CAP)
+        .map(([hex, count]) => ({ hex, count }));
+}
+
+function scenarioSeed(profileIndex: number, fixtureIndex: number, enhanced: boolean, repeats: boolean) {
+    return (
+        0x4b524f4d +
+        profileIndex * 1009 +
+        fixtureIndex * 101 +
+        (enhanced ? 17 : 0) +
+        (repeats ? 3 : 0)
+    );
+}
+
+export function autoPaintGoldenScenarios(): AutoPaintGoldenScenario[] {
+    const png = readPngFixture(logoFixturePath);
+    const fixtures = [
+        {
+            name: 'logo-png',
+            imageSwatches: pngSwatches(png),
+            imageDimensions: { width: png.width, height: png.height },
+        },
+        {
+            name: 'large-jpeg',
+            imageSwatches: colorSwatchesFromJpegBlocks(largeIssueFixturePath),
+            imageDimensions: { width: 3888, height: 2916 },
+        },
+    ];
+
+    return PROFILE_FILES.flatMap(([fileName, filamentCount], profileIndex) => {
+        const profile = readProfile(fileName, filamentCount);
+
+        return fixtures.flatMap((fixture, fixtureIndex) =>
+            [false, true].flatMap((enhancedColorMatch) =>
+                [false, true].map((allowRepeatedSwaps) => ({
+                    name: `${profile.name} / ${fixture.name} / enhanced=${enhancedColorMatch} / repeats=${allowRepeatedSwaps}`,
+                    filaments: profile.filaments,
+                    imageSwatches: fixture.imageSwatches,
+                    imageDimensions: fixture.imageDimensions,
+                    enhancedColorMatch,
+                    allowRepeatedSwaps,
+                    seed: scenarioSeed(
+                        profileIndex,
+                        fixtureIndex,
+                        enhancedColorMatch,
+                        allowRepeatedSwaps
+                    ),
+                }))
+            )
+        );
+    });
+}
diff --git a/tests/autoPaintGoldens.test.ts b/tests/autoPaintGoldens.test.ts
new file mode 100644
index 0000000..4c313af
--- /dev/null
+++ b/tests/autoPaintGoldens.test.ts
@@ -0,0 +1,118 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import test, { type TestContext } from 'node:test';
+import { createServer } from 'vite';
+
+import { autoPaintGoldenScenarios } from './autoPaintGoldenFixtures.ts';
+
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+
+interface AutoPaintGolden {
+    filamentOrder: string[];
+    transitionZones: Array<{
+        filamentId: string;
+        startHeight: number;
+        endHeight: number;
+        idealThickness: number;
+        actualThickness: number;
+    }>;
+    totalHeight: number;
+    compressionRatio: number;
+}
+
+const LAYER_HEIGHT = 0.08;
+const FIRST_LAYER_HEIGHT = 0.16;
+const EPSILON = 1e-6;
+const goldenPath = resolve('tests', 'assets', 'auto-paint-goldens.json');
+let autoPaintModule: Promise<AutoPaintModule> | null = null;
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
+    return autoPaintModule;
+}
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+function snapshot(result: ReturnType<AutoPaintModule['generateAutoLayers']>): AutoPaintGolden {
+    return {
+        filamentOrder: result.filamentOrder,
+        transitionZones: result.transitionZones.map((zone) => ({
+            filamentId: zone.filamentId,
+            startHeight: zone.startHeight,
+            endHeight: zone.endHeight,
+            idealThickness: zone.idealThickness,
+            actualThickness: zone.actualThickness,
+        })),
+        totalHeight: result.totalHeight,
+        compressionRatio: result.compressionRatio,
+    };
+}
+
+function assertApproximateGolden(actual: AutoPaintGolden, expected: AutoPaintGolden) {
+    assert.deepEqual(actual.filamentOrder, expected.filamentOrder, 'filament order changed');
+    assert.equal(actual.transitionZones.length, expected.transitionZones.length, 'zone count changed');
+    assert.ok(
+        Math.abs(actual.totalHeight - expected.totalHeight) <= EPSILON,
+        `total height changed from ${expected.totalHeight} to ${actual.totalHeight}`
+    );
+    assert.ok(
+        Math.abs(actual.compressionRatio - expected.compressionRatio) <= EPSILON,
+        `compression ratio changed from ${expected.compressionRatio} to ${actual.compressionRatio}`
+    );
+
+    actual.transitionZones.forEach((zone, index) => {
+        const expectedZone = expected.transitionZones[index];
+        assert.equal(zone.filamentId, expectedZone.filamentId, `zone ${index} filament changed`);
+
+        for (const key of ['startHeight', 'endHeight', 'idealThickness', 'actualThickness'] as const) {
+            assert.ok(
+                Math.abs(zone[key] - expectedZone[key]) <= EPSILON,
+                `zone ${index} ${key} changed from ${expectedZone[key]} to ${zone[key]}`
+            );
+        }
+    });
+}
+
+test('seeded auto-paint stack goldens stay deliberate', async (t: TestContext) => {
+    const expected = JSON.parse(readFileSync(goldenPath, 'utf8')) as Record<string, AutoPaintGolden>;
+    const scenarios = autoPaintGoldenScenarios();
+    assert.deepEqual(Object.keys(expected).sort(), scenarios.map((scenario) => scenario.name).sort());
+
+    const { generateAutoLayers } = await loadAutoPaintModule();
+    for (const scenario of scenarios) {
+        await t.test(scenario.name, () => {
+            const result = generateAutoLayers(
+                scenario.filaments,
+                scenario.imageSwatches,
+                LAYER_HEIGHT,
+                FIRST_LAYER_HEIGHT,
+                undefined,
+                scenario.enhancedColorMatch,
+                scenario.allowRepeatedSwaps,
+                { algorithm: 'auto', seed: scenario.seed },
+                'uniform',
+                scenario.imageDimensions
+            );
+
+            assertApproximateGolden(snapshot(result), expected[scenario.name]);
+        });
+    }
+});
diff --git a/tests/imageFixtures.ts b/tests/imageFixtures.ts
index 460945b..2fb0842 100644
--- a/tests/imageFixtures.ts
+++ b/tests/imageFixtures.ts
@@ -41,6 +41,11 @@ interface JpegLuminanceBlocks {
     blockWidth: number;
     blockHeight: number;
     values: Float32Array;
+    componentIds: number[];
+    componentBlocks: Map<
+        number,
+        { blockWidth: number; blockHeight: number; values: Float32Array }
+    >;
 }
 
 export const testAssetsRoot = resolve(dirname(fileURLToPath(import.meta.url)), 'assets');
@@ -446,6 +451,22 @@ function readJpegLuminanceBlocks(filePath: string): JpegLuminanceBlocks {
     const values = new Float32Array(blockWidth * blockHeight);
     values.fill(255);
 
+    const componentBlocks = new Map<
+        number,
+        { blockWidth: number; blockHeight: number; values: Float32Array }
+    >();
+    for (const component of components) {
+        const componentBlockWidth = mcusX * component.horizontalSampling;
+        const componentBlockHeight = mcusY * component.verticalSampling;
+        const componentValues = new Float32Array(componentBlockWidth * componentBlockHeight);
+        componentValues.fill(128);
+        componentBlocks.set(component.id, {
+            blockWidth: componentBlockWidth,
+            blockHeight: componentBlockHeight,
+            values: componentValues,
+        });
+    }
+
     const reader = new JpegBitReader(data, entropyOffset);
     const dcPredictors = new Map<number, number>();
     const luminanceComponentId = components[0].id;
@@ -482,15 +503,25 @@ function readJpegLuminanceBlocks(filePath: string): JpegLuminanceBlocks {
                         dcPredictors.set(component.id, dc);
                         skipJpegBlockAc(reader, acTable);
 
-                        if (component.id === luminanceComponentId) {
-                            const blockX = mcuX * maxHorizontalSampling + bx;
-                            const blockY = mcuY * maxVerticalSampling + by;
+                        const componentBlock = componentBlocks.get(component.id);
+                        assert.ok(componentBlock, `Missing block storage for component ${component.id}`);
+                        const blockX = mcuX * component.horizontalSampling + bx;
+                        const blockY = mcuY * component.verticalSampling + by;
+                        const average = Math.max(
+                            0,
+                            Math.min(255, (dc * quantizationTable[0]) / 8 + 128)
+                        );
+
+                        if (
+                            blockX < componentBlock.blockWidth &&
+                            blockY < componentBlock.blockHeight
+                        ) {
+                            componentBlock.values[blockY * componentBlock.blockWidth + blockX] =
+                                average;
+                        }
 
+                        if (component.id === luminanceComponentId) {
                             if (blockX < blockWidth && blockY < blockHeight) {
-                                const average = Math.max(
-                                    0,
-                                    Math.min(255, (dc * quantizationTable[0]) / 8 + 128)
-                                );
                                 values[blockY * blockWidth + blockX] = average;
                             }
                         }
@@ -502,11 +533,78 @@ function readJpegLuminanceBlocks(filePath: string): JpegLuminanceBlocks {
         }
     }
 
-    const result = { width, height, blockWidth, blockHeight, values };
+    const result = {
+        width,
+        height,
+        blockWidth,
+        blockHeight,
+        values,
+        componentIds: components.map((component) => component.id),
+        componentBlocks,
+    };
     jpegLuminanceBlockCache.set(filePath, result);
     return result;
 }
 
+/**
+ * Create a compact, stable color histogram from a baseline JPEG's DC blocks.
+ *
+ * The existing test decoder intentionally skips AC coefficients because mesh
+ * fixtures only need image structure. For auto-paint regression coverage we
+ * reuse those block averages: they preserve broad image colors while keeping
+ * the fixture fast to load and dependency-free.
+ */
+export function colorSwatchesFromJpegBlocks(
+    filePath: string,
+    maxColors: number = 4096
+): Array<{ hex: string; count: number }> {
+    const image = readJpegLuminanceBlocks(filePath);
+    const [luminanceId, cbId, crId] = image.componentIds;
+    const luminanceBlocks = image.componentBlocks.get(luminanceId);
+    const cbBlocks = cbId === undefined ? undefined : image.componentBlocks.get(cbId);
+    const crBlocks = crId === undefined ? undefined : image.componentBlocks.get(crId);
+    assert.ok(luminanceBlocks, 'JPEG fixture should include a luminance component');
+
+    const counts = new Map<string, number>();
+    const clampByte = (value: number) => Math.max(0, Math.min(255, Math.round(value)));
+    const quantize = (value: number) => Math.min(255, Math.round(value / 16) * 16);
+    const sample = (
+        component: { blockWidth: number; blockHeight: number; values: Float32Array },
+        x: number,
+        y: number
+    ) => {
+        const sourceX = Math.min(
+            component.blockWidth - 1,
+            Math.floor((x * component.blockWidth) / image.blockWidth)
+        );
+        const sourceY = Math.min(
+            component.blockHeight - 1,
+            Math.floor((y * component.blockHeight) / image.blockHeight)
+        );
+        return component.values[sourceY * component.blockWidth + sourceX];
+    };
+
+    for (let y = 0; y < image.blockHeight; y++) {
+        for (let x = 0; x < image.blockWidth; x++) {
+            const luminance = sample(luminanceBlocks, x, y);
+            const cb = cbBlocks ? sample(cbBlocks, x, y) : 128;
+            const cr = crBlocks ? sample(crBlocks, x, y) : 128;
+            const r = quantize(clampByte(luminance + 1.402 * (cr - 128)));
+            const g = quantize(clampByte(luminance - 0.344136 * (cb - 128) - 0.714136 * (cr - 128)));
+            const b = quantize(clampByte(luminance + 1.772 * (cb - 128)));
+            const hex = `#${[r, g, b]
+                .map((value) => value.toString(16).padStart(2, '0'))
+                .join('')}`;
+            counts.set(hex, (counts.get(hex) ?? 0) + 1);
+        }
+    }
+
+    return Array.from(counts.entries())
+        .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+        .slice(0, maxColors)
+        .map(([hex, count]) => ({ hex, count }));
+}
+
 export function maskFromPngAlpha(filePath: string, maxSide: number): RasterMask {
     const image = readPng(filePath);
     const sampleSize = Math.max(1, Math.ceil(Math.max(image.width, image.height) / maxSide));
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
new file mode 100644
index 0000000..84cff3c
--- /dev/null
+++ b/tests/optimizer.test.ts
@@ -0,0 +1,70 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+type OptimizerModule = typeof import('../src/lib/optimizer.ts');
+
+const filaments = [
+    { id: 'black', color: '#101010', td: 0.8 },
+    { id: 'blue', color: '#2557a7', td: 1.4 },
+    { id: 'red', color: '#bb4b3b', td: 1.8 },
+    { id: 'white', color: '#eeeeee', td: 2.2 },
+];
+const context = {
+    imageColors: [
+        { L: 16, a: 0, b: 0, weight: 0.2 },
+        { L: 38, a: 12, b: -34, weight: 0.25 },
+        { L: 51, a: 38, b: 26, weight: 0.3 },
+        { L: 91, a: 0, b: 0, weight: 0.25 },
+    ],
+    layerHeight: 0.08,
+    firstLayerHeight: 0.16,
+};
+let optimizerModule: Promise<OptimizerModule> | null = null;
+
+async function loadOptimizerModule(): Promise<OptimizerModule> {
+    optimizerModule ??= loadViteModule<OptimizerModule>('/src/lib/optimizer.ts');
+    return optimizerModule;
+}
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+test('each optimizer produces the same result for the same seed', async (t) => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+
+    for (const algorithm of algorithms) {
+        await t.test(algorithm, () => {
+            const options = {
+                algorithm,
+                seed: 0x4b524f4d,
+                cachingEnabled: false,
+                maxIterations: 30,
+                populationSize: 16,
+            };
+
+            const first = optimizeFilamentOrder(filaments, context, options);
+            const second = optimizeFilamentOrder(filaments, context, options);
+
+            assert.deepEqual(second, first);
+        });
+    }
+});

From 43eb66e3d2be16b3e95d4751070006f666992cc7 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 20 Jun 2026 21:30:04 +0300
Subject: [PATCH 06/81] Add auto-paint benchmark harness

---
 CHANGELOG.md                       |   1 +
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md |   4 +-
 package.json                       |   1 +
 tests/benchmark/README.md          |   7 ++
 tests/benchmark/autoPaintBench.ts  | 121 +++++++++++++++++++++++++++++
 5 files changed, 132 insertions(+), 2 deletions(-)
 create mode 100644 tests/benchmark/README.md
 create mode 100644 tests/benchmark/autoPaintBench.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4fb4b2f..a4f938a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,7 @@ All notable changes to Kromacut are documented in this file.
 ### Added
 
 - **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
+- **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures palette and preview-realized color error, coverage, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles.
 
 ### Changed
 
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index f35c4e2..fe88a09 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -184,7 +184,7 @@ Goal: pin current behavior and make quality measurable before changing anything.
       deliberately** in Phases 3/4 — their job is making behavior changes visible,
       not frozen.
 - [x] **0.3 Determinism tests**: per algorithm, same seed twice → deep-equal result.
-- [ ] **0.4 Benchmark harness** (`tests/benchmark/autoPaintBench.ts`, runnable via a
+- [x] **0.4 Benchmark harness** (`tests/benchmark/autoPaintBench.ts`, runnable via a
   package script, not part of CI gating initially). Per image × profile × algorithm ×
   seed, emit JSON with:
   - Weighted mean ΔE (report **both** CIE76 and CIEDE2000) from clustered targets to
@@ -198,7 +198,7 @@ Goal: pin current behavior and make quality measurable before changing anything.
     compression ratio under a fixed `maxHeight` scenario.
   - Cost: wall time, evaluations, iterations.
   - Stability: cross-seed rank agreement for SA/GA.
-- [ ] **0.5 Acceptance rule for later phases** (documented in the harness README):
+- [x] **0.5 Acceptance rule for later phases** (documented in the harness README):
       end-to-end realized ΔE improves on average across fixtures and regresses on no
       fixture beyond tolerance (suggest 5%), within cost budgets (≤2 s for 8 filaments).
 
diff --git a/package.json b/package.json
index 3364639..e3aa684 100644
--- a/package.json
+++ b/package.json
@@ -9,6 +9,7 @@
         "build": "tsc -b && vite build && node scripts/generate-docs-seo-pages.mjs",
         "test": "node --no-warnings --experimental-strip-types tests/run-tests.ts",
         "test:autopaint:update": "node --no-warnings --experimental-strip-types scripts/generate-auto-paint-goldens.ts",
+        "benchmark:autopaint": "node --no-warnings --experimental-strip-types tests/benchmark/autoPaintBench.ts",
         "test:e2e": "playwright test --grep @smoke",
         "test:e2e:matrix": "playwright test --grep @matrix",
         "test:e2e:stress": "playwright test --grep @stress",
diff --git a/tests/benchmark/README.md b/tests/benchmark/README.md
new file mode 100644
index 0000000..4a9481f
--- /dev/null
+++ b/tests/benchmark/README.md
@@ -0,0 +1,7 @@
+# Auto-paint benchmark
+
+Run `npm run benchmark:autopaint > benchmark.json` to create a local JSON report. It is deliberately outside normal tests: it measures quality and cost across the saved profiles and image fixtures.
+
+The main number is `realizedError.weightedMean`. It replays the preview's Lab-space color-to-height projection and compares the virtual color at that printable height with the target color. Lower is better.
+
+For Phase 3 and later, accept a change only when average realized error improves, no fixture regresses by more than 5%, and the 8-filament case stays within a 2-second budget on the comparison machine. Record the machine and the command when comparing reports.
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
new file mode 100644
index 0000000..84f4a41
--- /dev/null
+++ b/tests/benchmark/autoPaintBench.ts
@@ -0,0 +1,121 @@
+import { performance } from 'node:perf_hooks';
+import { resolve } from 'node:path';
+import { createServer } from 'vite';
+
+import { autoPaintGoldenScenarios } from '../autoPaintGoldenFixtures.ts';
+
+type AutoPaintModule = typeof import('../../src/lib/autoPaint.ts');
+type Algorithm = 'auto' | 'exhaustive' | 'simulated-annealing' | 'genetic';
+type Lab = { L: number; a: number; b: number };
+
+const LAYER_HEIGHT = 0.08;
+const FIRST_LAYER_HEIGHT = 0.16;
+const COMPRESSED_MAX_HEIGHT = 1.2;
+const SEEDS = [0x4b524f4d, 0x4b524f4e, 0x4b524f4f];
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    const server = await createServer({
+        appType: 'custom', cacheDir: 'dist/.vite-test-cache', configFile: false, logLevel: 'error',
+        optimizeDeps: { noDiscovery: true }, resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(), server: { hmr: false, middlewareMode: true },
+    });
+    try { return (await server.ssrLoadModule('/src/lib/autoPaint.ts')) as AutoPaintModule; }
+    finally { await server.close(); }
+}
+
+function ciede2000(left: Lab, right: Lab) {
+    const c1 = Math.hypot(left.a, left.b);
+    const c2 = Math.hypot(right.a, right.b);
+    const averageC = (c1 + c2) / 2;
+    const g = 0.5 * (1 - Math.sqrt(averageC ** 7 / (averageC ** 7 + 25 ** 7)));
+    const a1 = (1 + g) * left.a;
+    const a2 = (1 + g) * right.a;
+    const c1p = Math.hypot(a1, left.b);
+    const c2p = Math.hypot(a2, right.b);
+    const h = (a: number, b: number) => (Math.atan2(b, a) * 180 / Math.PI + 360) % 360;
+    const h1 = h(a1, left.b), h2 = h(a2, right.b);
+    const deltaL = right.L - left.L, deltaC = c2p - c1p;
+    const deltaHAngle = c1p * c2p === 0 ? 0 : Math.abs(h2 - h1) <= 180 ? h2 - h1 : h2 <= h1 ? h2 - h1 + 360 : h2 - h1 - 360;
+    const deltaH = 2 * Math.sqrt(c1p * c2p) * Math.sin((deltaHAngle / 2) * Math.PI / 180);
+    const meanL = (left.L + right.L) / 2, meanC = (c1p + c2p) / 2;
+    const meanH = c1p * c2p === 0 ? h1 + h2 : Math.abs(h1 - h2) <= 180 ? (h1 + h2) / 2 : h1 + h2 < 360 ? (h1 + h2 + 360) / 2 : (h1 + h2 - 360) / 2;
+    const t = 1 - 0.17 * Math.cos((meanH - 30) * Math.PI / 180) + 0.24 * Math.cos(2 * meanH * Math.PI / 180) + 0.32 * Math.cos((3 * meanH + 6) * Math.PI / 180) - 0.2 * Math.cos((4 * meanH - 63) * Math.PI / 180);
+    const sl = 1 + 0.015 * (meanL - 50) ** 2 / Math.sqrt(20 + (meanL - 50) ** 2);
+    const sc = 1 + 0.045 * meanC;
+    const sh = 1 + 0.015 * meanC * t;
+    const rt = -2 * Math.sqrt(meanC ** 7 / (meanC ** 7 + 25 ** 7)) * Math.sin((60 * Math.exp(-(((meanH - 275) / 25) ** 2))) * Math.PI / 180);
+    return Math.sqrt((deltaL / sl) ** 2 + (deltaC / sc) ** 2 + (deltaH / sh) ** 2 + rt * (deltaC / sc) * (deltaH / sh));
+}
+
+function weightedSummary(samples: Array<{ value: number; weight: number }>) {
+    const totalWeight = samples.reduce((sum, sample) => sum + sample.weight, 0);
+    const weightedMean = samples.reduce((sum, sample) => sum + sample.value * sample.weight, 0) / totalWeight;
+    const ordered = [...samples].sort((a, b) => a.value - b.value);
+    let cumulative = 0;
+    const p95 = ordered.find((sample) => (cumulative += sample.weight) >= totalWeight * 0.95)?.value ?? 0;
+    return { weightedMean, p95, totalWeight };
+}
+
+function cumulativeHeights(sliceHeights: number[], colorOrder: number[]) {
+    let total = 0;
+    return colorOrder.map((index, position) => {
+        total += position === 0 ? Math.max(sliceHeights[index], FIRST_LAYER_HEIGHT) : sliceHeights[index];
+        return total;
+    });
+}
+
+function projectHeight(target: Lab, nodes: Array<{ lab: Lab; min: number; max: number }>, cumulative: number[]) {
+    let bestDistance = Infinity, height = cumulative[0] ?? 0;
+    for (const node of nodes) {
+        const distance = Math.hypot(target.L - node.lab.L, target.a - node.lab.a, target.b - node.lab.b);
+        if (distance < bestDistance) { bestDistance = distance; height = (node.min + node.max) / 2; }
+    }
+    for (let index = 0; index < nodes.length - 1; index++) {
+        const from = nodes[index], to = nodes[index + 1];
+        const dL = to.lab.L - from.lab.L, da = to.lab.a - from.lab.a, db = to.lab.b - from.lab.b;
+        const lengthSq = dL * dL + da * da + db * db;
+        if (lengthSq < 0.01) continue;
+        const t = Math.max(0, Math.min(1, ((target.L - from.lab.L) * dL + (target.a - from.lab.a) * da + (target.b - from.lab.b) * db) / lengthSq));
+        const distance = Math.hypot(target.L - (from.lab.L + t * dL), target.a - (from.lab.a + t * da), target.b - (from.lab.b + t * db));
+        if (distance < bestDistance) { bestDistance = distance; height = from.max + t * (to.min - from.max); }
+    }
+    return Math.max(cumulative[0] ?? 0, Math.min(cumulative.at(-1) ?? 0, height));
+}
+
+const autoPaint = await loadAutoPaintModule();
+const output: unknown[] = [];
+
+for (const scenario of autoPaintGoldenScenarios().filter(
+    (scenario) => scenario.enhancedColorMatch && scenario.allowRepeatedSwaps
+)) {
+    const profileSize = scenario.filaments.length;
+    const algorithms: Algorithm[] = profileSize <= 6
+        ? ['auto', 'exhaustive', 'simulated-annealing', 'genetic']
+        : ['auto', 'simulated-annealing', 'genetic'];
+    for (const algorithm of algorithms) {
+        const seeds = algorithm === 'simulated-annealing' || algorithm === 'genetic' ? SEEDS : [SEEDS[0]];
+        for (const seed of seeds) {
+            const start = performance.now();
+            const result = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, undefined, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed }, 'uniform', scenario.imageDimensions);
+            const elapsedMs = performance.now() - start;
+            const slices = autoPaint.autoPaintToSliceHeights(result, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
+            const palette = slices.virtualSwatches.map((swatch) => autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex)));
+            const targets = scenario.imageSwatches.map((swatch) => ({ lab: autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex)), weight: swatch.count }));
+            const errors76 = targets.map((target) => ({ weight: target.weight, value: Math.min(...palette.map((entry) => autoPaint.deltaELab(target.lab, entry))) }));
+            const errors2000 = targets.map((target) => ({ weight: target.weight, value: Math.min(...palette.map((entry) => ciede2000(target.lab, entry))) }));
+            const coverage = (limit: number) => errors76.filter((sample) => sample.value <= limit).reduce((sum, sample) => sum + sample.weight, 0) / errors76.reduce((sum, sample) => sum + sample.weight, 0);
+            const heights = cumulativeHeights(slices.colorSliceHeights, slices.colorOrder);
+            const nodes = palette.map((lab, index) => ({ lab, min: heights[index], max: heights[index] }));
+            const realized = targets.map((target) => {
+                const height = projectHeight(target.lab, nodes, heights);
+                const slice = Math.min(heights.length - 1, heights.findIndex((value) => value >= height));
+                return { weight: target.weight, value: autoPaint.deltaELab(target.lab, palette[Math.max(0, slice)]) };
+            });
+            const compressed = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, COMPRESSED_MAX_HEIGHT, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed }, 'uniform', scenario.imageDimensions);
+            const used = new Set(errors76.map((_, targetIndex) => palette.reduce((best, entry, index) => autoPaint.deltaELab(targets[targetIndex].lab, entry) < autoPaint.deltaELab(targets[targetIndex].lab, palette[best]) ? index : best, 0)));
+            output.push({ scenario: scenario.name, algorithm, seed, colorError: { cie76: weightedSummary(errors76), ciede2000: weightedSummary(errors2000), coverageAt2_3: coverage(2.3), coverageAt5: coverage(5) }, realizedError: weightedSummary(realized), structure: { totalHeight: result.totalHeight, layerCount: slices.colorSliceHeights.length, sequenceLength: result.filamentOrder.length, wastedLayerFraction: slices.colorSliceHeights.length ? (slices.colorSliceHeights.length - used.size) / slices.colorSliceHeights.length : 0, compressedMaxHeight: COMPRESSED_MAX_HEIGHT, compressionRatio: compressed.compressionRatio }, cost: { wallTimeMs: elapsedMs, iterations: result.optimizerMetadata?.iterations ?? 0 } });
+        }
+    }
+}
+
+console.log(JSON.stringify({ generatedAt: new Date().toISOString(), results: output }, null, 2));

From 1544270fe2bc6fb60cf4a38e8b33bfb7f4d01e28 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 10:08:47 +0300
Subject: [PATCH 07/81] Fix auto-paint region priority

---
 CHANGELOG.md                       |   2 +
 README.md                          |   2 +-
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md |  10 +--
 src/components/ThreeDControls.tsx  |   1 -
 src/docs/3d-mode.md                |   2 +
 src/hooks/useAutoPaintWorker.ts    |  43 ++++++---
 src/hooks/useSwatches.ts           |  29 +++++-
 src/lib/autoPaint.ts               | 124 ++------------------------
 src/lib/optimizer.ts               |   2 -
 src/lib/regionWeighting.ts         |  76 ++++++++++------
 src/types/index.ts                 |  11 ++-
 src/workers/autoPaint.worker.ts    |   6 +-
 tests/autoPaintGoldens.test.ts     |   4 +-
 tests/benchmark/autoPaintBench.ts  |   4 +-
 tests/export3mf.test.ts            |   8 +-
 tests/regionWeighting.test.ts      | 138 +++++++++++++++++++++++++++++
 16 files changed, 273 insertions(+), 189 deletions(-)
 create mode 100644 tests/regionWeighting.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4f938a..2186dae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,8 @@ All notable changes to Kromacut are documented in this file.
 
 ### Fixed
 
+- **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
+
 - **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
 
 ## v3.1.0 - 2026-06-18
diff --git a/README.md b/README.md
index 053e906..9679a1a 100644
--- a/README.md
+++ b/README.md
@@ -164,7 +164,7 @@ Prioritize accuracy in specific image regions during optimization:
 |---|---|
 | **Uniform** | All pixels weighted equally (default). |
 | **Center** | Gaussian falloff from center — faces and subjects in the middle get higher priority. |
-| **Edge** | Sobel edge detection — high-contrast boundaries prioritized over flat regions. |
+| **Edge** | Colors nearer the outer edges of the image get higher priority. |
 
 Region weighting is most useful when filament budget is limited and you want the optimizer to focus on visually important areas.
 
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index fe88a09..20c3132 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -208,24 +208,24 @@ Risk: none (additive). Estimated scope: tests only.
 
 Goal: per-color weights actually reflect where colors sit in the image. Fixes F4.
 
-- [ ] **1.1** Extend swatch extraction (`useSwatches.ts`) to accumulate, per color, in
+- [x] **1.1** Extend swatch extraction (`useSwatches.ts`) to accumulate, per color, in
       the same tile pass that builds the histogram: `centerWeight` and `edgeWeight`
       (sum of the geometric per-pixel weight functions evaluated inline — no
       Float32Array maps materialized). Both modes computed in one pass so switching
       modes never rescans the image. Swatch entries gain optional fields; existing
       consumers unaffected.
-- [ ] **1.2** Thread the chosen mode's weighted count through
+- [x] **1.2** Thread the chosen mode's weighted count through
       `useAutoPaintWorker` → worker request → `generateAutoLayers`: when mode ≠
       `uniform`, use the weighted count as `count` input to `clusterImageColors`
       (which already weights by count). Keep raw count for display.
-- [ ] **1.3** Delete `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) and the
+- [x] **1.3** Delete `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) and the
       per-request map generation in `generateAutoLayers:1267-1282`. Remove
       `regionWeights` from `OptimizerOptions`/`ScoringContext` (or keep as deprecated
       no-op field if persisted anywhere — verify; current persistence stores only the
       mode string, so removal should be safe).
-- [ ] **1.4** Repeated-swaps path uses the same weighted targets (fixes the
+- [x] **1.4** Repeated-swaps path uses the same weighted targets (fixes the
       inconsistency at `autoPaint.ts:1098`).
-- [ ] **1.5 Tests**: synthetic fixture (red center disc on blue border):
+- [x] **1.5 Tests**: synthetic fixture (red center disc on blue border):
   - `center` mode must rank red clusters above blue; `edge` mode the reverse.
   - Mode `uniform` byte-identical to pre-change output (golden snapshot).
   - No `Float32Array(width*height)` allocation in the worker path (can assert via
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 5ab499a..93b9f4b 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -222,7 +222,6 @@ export default function ThreeDControls({
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
-        imageDimensions,
     });
 
     const autoPaintSliceData = useMemo(() => {
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 9cf25eb..0a0c450 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -104,6 +104,8 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 
 Use **Auto (smart selection)** unless you have a reason to compare algorithms.
 
+**Region priority** changes which source colors the optimizer values most: **Center-weighted** gives more importance to colors that occur near the middle of the image, while **Edge-weighted** favors colors nearer its outer edges. It does not crop or change the image itself.
+
 ## Transition Zones And Confidence
 
 After Auto-paint computes a result, Kromacut can show:
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index 9562473..d28f53c 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -12,13 +12,13 @@
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import type { AutoPaintResult } from '../lib/autoPaint';
-import type { Filament } from '../types';
+import type { Filament, Swatch } from '../types';
 import type { AutoPaintWorkerRequest, AutoPaintWorkerResponse } from '../workers/autoPaint.worker';
 
 export interface UseAutoPaintWorkerOptions {
     paintMode: 'manual' | 'autopaint';
     filaments: Filament[];
-    filtered: Array<{ hex: string; a: number } & Record<string, unknown>>;
+    filtered: Swatch[];
     layerHeight: number;
     slicerFirstLayerHeight: number;
     autoPaintMaxHeight?: number;
@@ -27,7 +27,6 @@ export interface UseAutoPaintWorkerOptions {
     optimizerAlgorithm: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
     optimizerSeed?: number;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
-    imageDimensions?: { width: number; height: number } | null;
 }
 
 export interface UseAutoPaintWorkerResult {
@@ -59,7 +58,6 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
-        imageDimensions,
     } = opts;
 
     const [autoPaintResult, setAutoPaintResult] = useState<AutoPaintResult | undefined>(undefined);
@@ -107,17 +105,39 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
             .join(';');
     }, [filaments]);
 
+    const selectedImageSwatches = useMemo(() => {
+        const rawSwatches = filtered.map((swatch) => ({
+            hex: swatch.hex,
+            rawCount: swatch.count ?? 1,
+            weightedCount:
+                regionWeightingMode === 'center'
+                    ? swatch.centerWeight
+                    : regionWeightingMode === 'edge'
+                      ? swatch.edgeWeight
+                      : undefined,
+        }));
+        const totalWeight = rawSwatches.reduce(
+            (total, swatch) => total + (swatch.weightedCount ?? 0),
+            0
+        );
+
+        return rawSwatches.map((swatch) => ({
+            hex: swatch.hex,
+            count:
+                regionWeightingMode !== 'uniform' && totalWeight > 0
+                    ? swatch.weightedCount ?? 0
+                    : swatch.rawCount,
+        }));
+    }, [filtered, regionWeightingMode]);
+
     const filteredKey = useMemo(() => {
-        return filtered.map((s) => `${s.hex}:${(s.count as number | undefined) ?? 0}`).join(';');
-    }, [filtered]);
+        return selectedImageSwatches.map((s) => `${s.hex}:${s.count}`).join(';');
+    }, [selectedImageSwatches]);
 
     // Keep stable references when only array identity changes but content does not.
     const stableFilaments = useStableValueByKey(filaments, filamentsKey);
     const stableImageSwatches = useStableValueByKey(
-        filtered.map((s) => ({
-            hex: s.hex,
-            count: s.count as number | undefined,
-        })),
+        selectedImageSwatches,
         filteredKey
     );
 
@@ -204,8 +224,6 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
                         algorithm,
                         ...(optimizerSeed !== undefined && { seed: optimizerSeed }),
                     },
-                    regionWeightingMode,
-                    imageDimensions: imageDimensions ?? undefined,
                 };
 
                 worker.postMessage(request);
@@ -238,7 +256,6 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
-        imageDimensions,
         getWorker,
         stableFilaments,
         stableImageSwatches,
diff --git a/src/hooks/useSwatches.ts b/src/hooks/useSwatches.ts
index 143159e..a246084 100644
--- a/src/hooks/useSwatches.ts
+++ b/src/hooks/useSwatches.ts
@@ -1,11 +1,14 @@
 import { useEffect, useRef, useState } from 'react';
 import { rgbToHsl } from '../lib/color';
+import { centerWeightAt, edgeWeightAt } from '../lib/regionWeighting';
 
 // Manages swatch computation with cancellation & immediate override
 export interface SwatchEntry {
     hex: string;
     a: number;
     count: number;
+    centerWeight?: number;
+    edgeWeight?: number;
     isTransparent?: boolean;
 }
 
@@ -59,7 +62,10 @@ export function useSwatches(imageSrc: string | null) {
                 const h = img.naturalHeight;
                 setImageDimensions({ width: w, height: h, opaqueWidth: w, opaqueHeight: h });
                 const TILE = 1024;
-                const map = new Map<number, number>();
+                const map = new Map<
+                    number,
+                    { count: number; centerWeight: number; edgeWeight: number }
+                >();
                 const tile = document.createElement('canvas');
                 const tctx = tile.getContext('2d', {
                     willReadFrequently: true,
@@ -101,14 +107,23 @@ export function useSwatches(imageSrc: string | null) {
                             const g = data[i + 1];
                             const b = data[i + 2];
                             const key = ((r << 24) | (g << 16) | (b << 8) | a) >>> 0;
-                            map.set(key, (map.get(key) || 0) + 1);
+                            const centerWeight = centerWeightAt(px, py, w, h);
+                            const edgeWeight = edgeWeightAt(px, py, w, h);
+                            const existing = map.get(key);
+                            if (existing) {
+                                existing.count++;
+                                existing.centerWeight += centerWeight;
+                                existing.edgeWeight += edgeWeight;
+                            } else {
+                                map.set(key, { count: 1, centerWeight, edgeWeight });
+                            }
                         }
                     }
                     await new Promise((r) => setTimeout(r, 0));
                     if (runId !== runRef.current || cancelled) return;
                 }
                 const top = Array.from(map.entries())
-                    .sort((a, b) => b[1] - a[1])
+                    .sort((a, b) => b[1].count - a[1].count)
                     .slice(0, Math.min(map.size, SWATCH_CAP))
                     .map((entry) => {
                         const key = entry[0];
@@ -123,7 +138,9 @@ export function useSwatches(imageSrc: string | null) {
                             hex,
                             a,
                             hsl: rgbToHsl(r, g, b),
-                            freq: entry[1],
+                            freq: entry[1].count,
+                            centerWeight: entry[1].centerWeight,
+                            edgeWeight: entry[1].edgeWeight,
                         };
                     });
                 top.sort((a, b) => {
@@ -145,6 +162,8 @@ export function useSwatches(imageSrc: string | null) {
                         hex: t.hex,
                         a: typeof t.a === 'number' ? t.a : 255,
                         count: t.freq,
+                        centerWeight: t.centerWeight,
+                        edgeWeight: t.edgeWeight,
                         isTransparent: typeof t.a === 'number' ? t.a === 0 : false,
                     }));
                     if (transparentCount > 0) {
@@ -153,6 +172,8 @@ export function useSwatches(imageSrc: string | null) {
                             hex: '#000000',
                             a: 0,
                             count: transparentCount,
+                            centerWeight: 0,
+                            edgeWeight: 0,
                             isTransparent: true,
                         });
                     }
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 2893847..caee487 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -23,7 +23,6 @@ import {
     type OptimizerResult,
     type ScoringContext,
 } from './optimizer';
-import { generateCenterWeightedMapSimple, generateEdgeWeightedMapSimple } from './regionWeighting';
 import { computeProfileConfidence } from './calibration';
 
 export { LAYER_ACTIVATION_EPSILON } from './layerActivation';
@@ -466,7 +465,7 @@ export function compressZones(
  * @param threshold - DeltaE merge threshold (default 5.0)
  * @returns Weighted Lab targets, normalized so weights sum to 1.0
  */
-function clusterImageColors(
+export function clusterImageColors(
     swatches: Array<{ hex: string; count?: number }>,
     maxClusters: number = 32,
     threshold: number = 5.0
@@ -853,76 +852,6 @@ function findBestFilamentOrder(
     };
 }
 
-/**
- * Apply region weighting heuristic to clustered colors.
- * 
- * This is an approximation since spatial information is lost during clustering.
- * We analyze the region weight distribution and adjust cluster weights accordingly:
- * - High-weight regions (center or edges) boost colors commonly found there
- * - Uses luminance as a proxy for spatial distribution (centers tend brighter, edges darker)
- * 
- * @param clusters Weighted Lab color clusters
- * @param regionWeights Per-pixel region importance weights
- * @returns Adjusted color clusters with modified weights
- */
-function applyRegionWeightHeuristic(
-    clusters: WeightedLab[],
-    regionWeights: Float32Array
-): WeightedLab[] {
-    if (clusters.length === 0 || regionWeights.length === 0) return clusters;
-
-    // Calculate average region weight to determine mode strength
-    let sumWeight = 0;
-    for (let i = 0; i < regionWeights.length; i++) {
-        sumWeight += regionWeights[i];
-    }
-    const avgWeight = sumWeight / regionWeights.length;
-
-    // Calculate luminance variance to detect contrast distribution
-    // Higher contrast (edge mode) vs more uniform (center mode)
-    let sumSqDiff = 0;
-    for (let i = 0; i < regionWeights.length; i++) {
-        const diff = regionWeights[i] - avgWeight;
-        sumSqDiff += diff * diff;
-    }
-    const variance = sumSqDiff / regionWeights.length;
-    const isHighContrast = variance > 0.05; // Threshold for edge-weighted pattern
-
-    // Apply heuristic adjustments
-    let totalAdjustedWeight = 0;
-    const adjustedClusters = clusters.map((cluster) => {
-        let modifier = 1.0;
-
-        if (isHighContrast) {
-            // Edge-weighted mode: boost high-contrast colors (very light or very dark)
-            const isHighContrast = cluster.L < 30 || cluster.L > 70;
-            modifier = isHighContrast ? 1.3 : 0.85;
-        } else {
-            // Center-weighted mode: boost mid-luminance colors (typical of center regions)
-            const isMidLuminance = cluster.L >= 35 && cluster.L <= 65;
-            modifier = isMidLuminance ? 1.2 : 0.9;
-        }
-
-        const adjustedWeight = cluster.weight * modifier;
-        totalAdjustedWeight += adjustedWeight;
-
-        return {
-            ...cluster,
-            weight: adjustedWeight,
-        };
-    });
-
-    // Renormalize to sum to 1.0
-    if (totalAdjustedWeight > 0) {
-        return adjustedClusters.map((c) => ({
-            ...c,
-            weight: c.weight / totalAdjustedWeight,
-        }));
-    }
-
-    return clusters;
-}
-
 /**
  * Advanced optimizer path using simulated annealing / genetic algorithm
  */
@@ -933,22 +862,14 @@ function findBestFilamentOrderWithOptimizer(
     firstLayerHeight: number,
     optimizerOptions: Partial<OptimizerOptions>
 ): { sortedFilaments: Filament[]; result: OptimizerResult } {
-    // Cluster image colors into weighted Lab targets
-    let imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
-
-    // Apply region weight heuristic if region weights are provided
-    // Note: This is an approximation since we've lost pixel positions during clustering.
-    // Proper implementation would require weighting pixels before aggregation.
-    if (optimizerOptions.regionWeights) {
-        imageTargets = applyRegionWeightHeuristic(imageTargets, optimizerOptions.regionWeights);
-    }
+    // Spatial weighting has already been folded into swatch counts by the caller.
+    const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
 
     // Build scoring context
     const context: ScoringContext = {
         imageColors: imageTargets,
         layerHeight,
         firstLayerHeight,
-        regionWeights: optimizerOptions.regionWeights,
     };
 
     // Apply frontlit TD scale
@@ -1204,9 +1125,7 @@ function buildRepeatedSwapSequence(
  * @param maxHeight - Optional maximum height constraint (undefined = auto)
  * @param enhancedColorMatch - If true, optimize filament ordering for best color reproduction
  * @param allowRepeatedSwaps - If true, allow filaments to appear multiple times in the stack
- * @param optimizerOptions - Advanced optimizer settings (algorithm, seeding, region weighting)
- * @param regionWeightingMode - Region weighting strategy: uniform, center, or edge
- * @param imageDimensions - Image width and height for region weight map generation
+ * @param optimizerOptions - Advanced optimizer settings (algorithm and seeding)
  * @returns Generated layer segments with zone information
  */
 export function generateAutoLayers(
@@ -1217,9 +1136,7 @@ export function generateAutoLayers(
     maxHeight?: number,
     enhancedColorMatch?: boolean,
     allowRepeatedSwaps?: boolean,
-    optimizerOptions?: Partial<OptimizerOptions>,
-    regionWeightingMode: 'uniform' | 'center' | 'edge' = 'uniform',
-    imageDimensions?: { width: number; height: number } | null
+    optimizerOptions?: Partial<OptimizerOptions>
 ): AutoPaintResult {
     // --- STEP 1: VALIDATION ---
     if (filaments.length === 0) {
@@ -1262,35 +1179,6 @@ export function generateAutoLayers(
     let sortedFilaments: Filament[];
     let optimizerResult: OptimizerResult | undefined;
 
-    // Generate region weight map if dimensions are available and mode is not uniform
-    let regionWeights: Float32Array | undefined;
-    if (imageDimensions && regionWeightingMode !== 'uniform') {
-        if (regionWeightingMode === 'center') {
-            // Center-weighted: prioritize center of image
-            regionWeights = generateCenterWeightedMapSimple(
-                imageDimensions.width,
-                imageDimensions.height,
-                0.5 // strength parameter
-            );
-        } else if (regionWeightingMode === 'edge') {
-            // Edge-weighted (geometry-based): prioritize border regions.
-            regionWeights = generateEdgeWeightedMapSimple(
-                imageDimensions.width,
-                imageDimensions.height
-            );
-        }
-    }
-
-    // Merge region weights into optimizer options
-    const mergedOptimizerOptions: Partial<OptimizerOptions> | undefined = optimizerOptions
-        ? {
-              ...optimizerOptions,
-              regionWeights: regionWeights ?? optimizerOptions.regionWeights,
-          }
-        : regionWeights
-          ? { regionWeights }
-          : undefined;
-
     if (enhancedColorMatch) {
         // Enhanced: find the ordering that best covers the image's color palette
         const orderingResult = findBestFilamentOrder(
@@ -1298,7 +1186,7 @@ export function generateAutoLayers(
             imageSwatches,
             layerHeight,
             firstLayerHeight,
-            mergedOptimizerOptions
+            optimizerOptions
         );
 
         sortedFilaments = orderingResult.sortedFilaments;
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 8cfd373..4da41d7 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -26,7 +26,6 @@ export interface OptimizerOptions {
     populationSize?: number; // Population size for GA
     mutationRate?: number; // Mutation probability for GA
     eliteCount?: number; // Number of elite individuals to preserve in GA
-    regionWeights?: Float32Array; // Per-pixel importance weights (0-1)
     cachingEnabled?: boolean; // Enable result caching
 }
 
@@ -43,7 +42,6 @@ export interface ScoringContext {
     imageColors: Array<Lab & { weight: number }>; // Weighted Lab colors from image
     layerHeight: number;
     firstLayerHeight: number;
-    regionWeights?: Float32Array; // Per-pixel importance
 }
 
 // ============================================================================
diff --git a/src/lib/regionWeighting.ts b/src/lib/regionWeighting.ts
index 3360f5f..37f9d45 100644
--- a/src/lib/regionWeighting.ts
+++ b/src/lib/regionWeighting.ts
@@ -20,6 +20,51 @@ export interface RegionWeightOptions {
     customMask?: Float32Array; // User-provided weights
 }
 
+const DEFAULT_CENTER_WEIGHT_STRENGTH = 0.5;
+
+function normalizedDistanceAt(x: number, y: number, width: number, height: number): number {
+    const centerX = width / 2;
+    const centerY = height / 2;
+    const maxDistance = Math.hypot(centerX, centerY);
+
+    if (maxDistance === 0) return 0;
+    return Math.hypot(x - centerX, y - centerY) / maxDistance;
+}
+
+function normalizedWeight(raw: number, min: number, max: number): number {
+    const range = max - min;
+    return range > 0 ? (raw - min) / range : 1;
+}
+
+function nearestCenterDistance(width: number, height: number): number {
+    const nearestX = Math.abs(Math.floor(width / 2) - width / 2);
+    const nearestY = Math.abs(Math.floor(height / 2) - height / 2);
+    const maxDistance = Math.hypot(width / 2, height / 2);
+    return maxDistance > 0 ? Math.hypot(nearestX, nearestY) / maxDistance : 0;
+}
+
+/** Scalar equivalent of generateCenterWeightedMapSimple. */
+export function centerWeightAt(
+    x: number,
+    y: number,
+    width: number,
+    height: number,
+    strength: number = DEFAULT_CENTER_WEIGHT_STRENGTH
+): number {
+    const denominator = 2 * (1 - strength);
+    const raw = Math.exp(-(normalizedDistanceAt(x, y, width, height) ** 2 / denominator));
+    const min = Math.exp(-1 / denominator);
+    const max = Math.exp(-(nearestCenterDistance(width, height) ** 2 / denominator));
+
+    return normalizedWeight(raw, min, max);
+}
+
+/** Scalar equivalent of generateEdgeWeightedMapSimple. */
+export function edgeWeightAt(x: number, y: number, width: number, height: number): number {
+    const raw = normalizedDistanceAt(x, y, width, height) ** 1.35;
+    return normalizedWeight(raw, nearestCenterDistance(width, height) ** 1.35, 1);
+}
+
 // ============================================================================
 // Weight Map Generation
 // ============================================================================
@@ -76,26 +121,12 @@ export function generateCenterWeightedMapSimple(
     strength: number = 0.5
 ): Float32Array {
     const weights = new Float32Array(width * height);
-    const centerX = width / 2;
-    const centerY = height / 2;
-    const maxDist = Math.sqrt(centerX * centerX + centerY * centerY);
 
     for (let y = 0; y < height; y++) {
         for (let x = 0; x < width; x++) {
-            const dx = x - centerX;
-            const dy = y - centerY;
-            const dist = Math.sqrt(dx * dx + dy * dy);
-            const normalizedDist = dist / maxDist;
-
-            // Gaussian fall-off: weight = 1 at center, decreases with distance
-            // strength controls how quickly weight falls off
-            const weight = Math.exp(-((normalizedDist * normalizedDist) / (2 * (1 - strength))));
-
-            weights[y * width + x] = weight;
+            weights[y * width + x] = centerWeightAt(x, y, width, height, strength);
         }
     }
-
-    normalizeWeights(weights);
     return weights;
 }
 
@@ -105,23 +136,12 @@ export function generateCenterWeightedMapSimple(
  */
 export function generateEdgeWeightedMapSimple(width: number, height: number): Float32Array {
     const weights = new Float32Array(width * height);
-    const centerX = width / 2;
-    const centerY = height / 2;
-    const maxDist = Math.sqrt(centerX * centerX + centerY * centerY);
 
     for (let y = 0; y < height; y++) {
         for (let x = 0; x < width; x++) {
-            const dx = x - centerX;
-            const dy = y - centerY;
-            const dist = Math.sqrt(dx * dx + dy * dy);
-            const normalizedDist = maxDist > 0 ? dist / maxDist : 0;
-
-            // Low in center, high toward borders
-            weights[y * width + x] = Math.pow(normalizedDist, 1.35);
+            weights[y * width + x] = edgeWeightAt(x, y, width, height);
         }
     }
-
-    normalizeWeights(weights);
     return weights;
 }
 
@@ -435,4 +455,4 @@ function heatmapColor(value: number): { r: number; g: number; b: number } {
     }
 
     return { r, g, b };
-}
\ No newline at end of file
+}
diff --git a/src/types/index.ts b/src/types/index.ts
index 1955e62..aea169d 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -1,7 +1,16 @@
 import type { AutoPaintResult } from '../lib/autoPaint';
 import type { CalibrationResult } from '../lib/calibration';
 
-export type Swatch = { hex: string; a: number };
+export type Swatch = {
+    hex: string;
+    a: number;
+    /** Raw pixel count, kept for display and non-spatial consumers. */
+    count?: number;
+    /** Sum of center-priority weights for this color's source pixels. */
+    centerWeight?: number;
+    /** Sum of edge-priority weights for this color's source pixels. */
+    edgeWeight?: number;
+};
 
 export interface CustomPalette {
     id: string;
diff --git a/src/workers/autoPaint.worker.ts b/src/workers/autoPaint.worker.ts
index 3936f8b..8b91d0a 100644
--- a/src/workers/autoPaint.worker.ts
+++ b/src/workers/autoPaint.worker.ts
@@ -21,8 +21,6 @@ export interface AutoPaintWorkerRequest {
     enhancedColorMatch?: boolean;
     allowRepeatedSwaps?: boolean;
     optimizerOptions?: Partial<OptimizerOptions>;
-    regionWeightingMode: 'uniform' | 'center' | 'edge';
-    imageDimensions?: { width: number; height: number } | null;
 }
 
 export interface AutoPaintWorkerResponse {
@@ -43,9 +41,7 @@ self.onmessage = (e: MessageEvent<AutoPaintWorkerRequest>) => {
             req.maxHeight,
             req.enhancedColorMatch,
             req.allowRepeatedSwaps,
-            req.optimizerOptions,
-            req.regionWeightingMode,
-            req.imageDimensions
+            req.optimizerOptions
         );
 
         const response: AutoPaintWorkerResponse = { id: req.id, result };
diff --git a/tests/autoPaintGoldens.test.ts b/tests/autoPaintGoldens.test.ts
index 4c313af..3d515b5 100644
--- a/tests/autoPaintGoldens.test.ts
+++ b/tests/autoPaintGoldens.test.ts
@@ -107,9 +107,7 @@ test('seeded auto-paint stack goldens stay deliberate', async (t: TestContext) =
                 undefined,
                 scenario.enhancedColorMatch,
                 scenario.allowRepeatedSwaps,
-                { algorithm: 'auto', seed: scenario.seed },
-                'uniform',
-                scenario.imageDimensions
+                { algorithm: 'auto', seed: scenario.seed }
             );
 
             assertApproximateGolden(snapshot(result), expected[scenario.name]);
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
index 84f4a41..c5a99d7 100644
--- a/tests/benchmark/autoPaintBench.ts
+++ b/tests/benchmark/autoPaintBench.ts
@@ -96,7 +96,7 @@ for (const scenario of autoPaintGoldenScenarios().filter(
         const seeds = algorithm === 'simulated-annealing' || algorithm === 'genetic' ? SEEDS : [SEEDS[0]];
         for (const seed of seeds) {
             const start = performance.now();
-            const result = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, undefined, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed }, 'uniform', scenario.imageDimensions);
+            const result = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, undefined, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
             const elapsedMs = performance.now() - start;
             const slices = autoPaint.autoPaintToSliceHeights(result, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
             const palette = slices.virtualSwatches.map((swatch) => autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex)));
@@ -111,7 +111,7 @@ for (const scenario of autoPaintGoldenScenarios().filter(
                 const slice = Math.min(heights.length - 1, heights.findIndex((value) => value >= height));
                 return { weight: target.weight, value: autoPaint.deltaELab(target.lab, palette[Math.max(0, slice)]) };
             });
-            const compressed = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, COMPRESSED_MAX_HEIGHT, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed }, 'uniform', scenario.imageDimensions);
+            const compressed = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, COMPRESSED_MAX_HEIGHT, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
             const used = new Set(errors76.map((_, targetIndex) => palette.reduce((best, entry, index) => autoPaint.deltaELab(targets[targetIndex].lab, entry) < autoPaint.deltaELab(targets[targetIndex].lab, palette[best]) ? index : best, 0)));
             output.push({ scenario: scenario.name, algorithm, seed, colorError: { cie76: weightedSummary(errors76), ciede2000: weightedSummary(errors2000), coverageAt2_3: coverage(2.3), coverageAt5: coverage(5) }, realizedError: weightedSummary(realized), structure: { totalHeight: result.totalHeight, layerCount: slices.colorSliceHeights.length, sequenceLength: result.filamentOrder.length, wastedLayerFraction: slices.colorSliceHeights.length ? (slices.colorSliceHeights.length - used.size) / slices.colorSliceHeights.length : 0, compressedMaxHeight: COMPRESSED_MAX_HEIGHT, compressionRatio: compressed.compressionRatio }, cost: { wallTimeMs: elapsedMs, iterations: result.optimizerMetadata?.iterations ?? 0 } });
         }
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index 508b4e3..e02c31a 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -40,9 +40,7 @@ interface AutoPaintModule {
         maxHeight?: number,
         enhancedColorMatch?: boolean,
         allowRepeatedSwaps?: boolean,
-        optimizerOptions?: { algorithm: OptimizerAlgorithm; seed?: number },
-        regionWeightingMode?: 'uniform' | 'center' | 'edge',
-        imageDimensions?: { width: number; height: number } | null
+        optimizerOptions?: { algorithm: OptimizerAlgorithm; seed?: number }
     ): unknown;
     autoPaintToSliceHeights(
         result: unknown,
@@ -789,9 +787,7 @@ async function buildAutoPaintLogoRegressionStack(
         {
             algorithm: 'auto',
             seed,
-        },
-        'uniform',
-        { width: image.width, height: image.height }
+        }
     );
     const sliceData = autoPaintToSliceHeights(autoPaintResult, layerHeight, firstLayerHeight);
     const cumulativeHeights = buildCumulativeHeights(
diff --git a/tests/regionWeighting.test.ts b/tests/regionWeighting.test.ts
new file mode 100644
index 0000000..0ea304f
--- /dev/null
+++ b/tests/regionWeighting.test.ts
@@ -0,0 +1,138 @@
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+import {
+    centerWeightAt,
+    edgeWeightAt,
+    generateCenterWeightedMapSimple,
+    generateEdgeWeightedMapSimple,
+} from '../src/lib/regionWeighting.ts';
+
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+let autoPaintModule: Promise<AutoPaintModule> | null = null;
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
+    return autoPaintModule;
+}
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+test('scalar region weights match the existing center and edge maps', () => {
+    for (const [width, height] of [
+        [1, 1],
+        [4, 4],
+        [5, 3],
+        [16, 9],
+    ]) {
+        const center = generateCenterWeightedMapSimple(width, height);
+        const edge = generateEdgeWeightedMapSimple(width, height);
+
+        for (let y = 0; y < height; y++) {
+            for (let x = 0; x < width; x++) {
+                const index = y * width + x;
+                assert.ok(Math.abs(center[index] - centerWeightAt(x, y, width, height)) < 1e-6);
+                assert.ok(Math.abs(edge[index] - edgeWeightAt(x, y, width, height)) < 1e-6);
+            }
+        }
+    }
+});
+
+test('center and edge weights favor opposite image regions', () => {
+    const width = 9;
+    const height = 9;
+    const center = centerWeightAt(4, 4, width, height);
+    const corner = centerWeightAt(0, 0, width, height);
+    const edgeCenter = edgeWeightAt(4, 4, width, height);
+    const edgeCorner = edgeWeightAt(0, 0, width, height);
+
+    assert.ok(center > corner, 'center mode should favor the center');
+    assert.ok(edgeCorner > edgeCenter, 'edge mode should favor the border');
+});
+
+test('spatial color totals prioritize a center disc or an edge border as selected', async () => {
+    const { clusterImageColors, deltaELab, hexToRgb, rgbToLab } = await loadAutoPaintModule();
+    const width = 25;
+    const height = 25;
+    let redCenter = 0;
+    let blueCenter = 0;
+    let redEdge = 0;
+    let blueEdge = 0;
+
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const isRedCenterDisc = Math.hypot(x - width / 2, y - height / 2) <= 9;
+            const centerWeight = centerWeightAt(x, y, width, height);
+            const edgeWeight = edgeWeightAt(x, y, width, height);
+            if (isRedCenterDisc) {
+                redCenter += centerWeight;
+                redEdge += edgeWeight;
+            } else {
+                blueCenter += centerWeight;
+                blueEdge += edgeWeight;
+            }
+        }
+    }
+
+    const redLab = rgbToLab(hexToRgb('#ff0000'));
+    const blueLab = rgbToLab(hexToRgb('#0000ff'));
+    const weightFor = (clusters: ReturnType<typeof clusterImageColors>, lab: typeof redLab) =>
+        clusters.reduce((best, cluster) =>
+            deltaELab(cluster, lab) < deltaELab(best, lab) ? cluster : best
+        ).weight;
+
+    const centerClusters = clusterImageColors(
+        [
+            { hex: '#ff0000', count: redCenter },
+            { hex: '#0000ff', count: blueCenter },
+        ],
+        2,
+        0.1
+    );
+    const edgeClusters = clusterImageColors(
+        [
+            { hex: '#ff0000', count: redEdge },
+            { hex: '#0000ff', count: blueEdge },
+        ],
+        2,
+        0.1
+    );
+
+    assert.ok(
+        weightFor(centerClusters, redLab) > weightFor(centerClusters, blueLab),
+        'center mode should rank the red center disc above the blue border'
+    );
+    assert.ok(
+        weightFor(edgeClusters, blueLab) > weightFor(edgeClusters, redLab),
+        'edge mode should rank the blue border above the red center disc'
+    );
+});
+
+test('the auto-paint worker path does not create an image-sized region map', () => {
+    const autoPaintSource = readFileSync(resolve('src', 'lib', 'autoPaint.ts'), 'utf8');
+    const workerSource = readFileSync(resolve('src', 'workers', 'autoPaint.worker.ts'), 'utf8');
+
+    assert.doesNotMatch(autoPaintSource, /generate(?:Center|Edge)WeightedMapSimple/);
+    assert.doesNotMatch(autoPaintSource, /regionWeights/);
+    assert.doesNotMatch(workerSource, /regionWeightingMode|imageDimensions/);
+});

From 966c13afbc133a4ffd422aec14ebe21c98461e93 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 10:15:04 +0300
Subject: [PATCH 08/81] Make auto-paint optimization deterministic

---
 CHANGELOG.md                       |   2 +
 README.md                          |   6 +-
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md |   6 +-
 src/components/AutoPaintTab.tsx    |   2 +-
 src/docs/3d-mode.md                |   2 +-
 src/lib/optimizer.ts               | 107 +++++++++++++++--------------
 tests/optimizer.test.ts            |  71 +++++++++++++++++++
 7 files changed, 138 insertions(+), 58 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2186dae..dd3e499 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,8 @@ All notable changes to Kromacut are documented in this file.
 
 ### Fixed
 
+- **Auto-paint optimizer cache and default seed** - Cache entries now include all target-color weights, every target cluster, and optimizer tuning values. Blank seeds now derive a stable value from the active inputs, making identical runs repeatable and cacheable instead of randomly changing.
+
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
 
 - **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
diff --git a/README.md b/README.md
index 9679a1a..7a41447 100644
--- a/README.md
+++ b/README.md
@@ -154,7 +154,7 @@ The optimizer displays metadata after generation:
 - **Converged** — Whether the algorithm reached a stable solution
 - **Cache hit** — Whether results were retrieved from cache (instant)
 
-**Optimizer seed** — Set a random seed for reproducible results across runs. Useful for A/B testing different configurations.
+**Optimizer seed** — Leave blank for an automatic stable seed, or enter a number to use a specific repeatable seed for A/B comparisons.
 
 ### Region Weighting
 
@@ -179,8 +179,8 @@ Region weighting is most useful when filament budget is limited and you want the
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
 | **Optimizer algorithm** | Choose which optimization algorithm to use: Auto (recommended), Exhaustive, Simulated Annealing, or Genetic. Auto selects the best algorithm based on search space size. |
-| **Optimizer seed** | Set a random seed for reproducible optimizer results. Leave blank for random behavior. Useful for testing and comparing configurations. |
-| **Region weighting** | Prioritize specific image regions: Uniform (equal), Center (Gaussian falloff), or Edge (Sobel detection). Helps focus quality budget on important areas. |
+| **Optimizer seed** | Leave blank for an automatic stable seed, or enter a number for a specific repeatable run. |
+| **Region weighting** | Prioritize specific image regions: Uniform (equal), Center (image middle), or Edge (outer image border). Helps focus quality budget on important areas. |
 
 ### Filament profiles
 
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index 20c3132..2efc33b 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -238,15 +238,15 @@ labels say (today they are swapped or no-ops — treat as bug fix, note in CHANG
 
 Goal: fix F5, F6. Small, independent, immediately shippable.
 
-- [ ] **2.1** Cache key includes cluster **weights**, full cluster set (not first 20),
+- [x] **2.1** Cache key includes cluster **weights**, full cluster set (not first 20),
       and all algorithm-relevant options (temperature, cooling, population, mutation,
       elite, maxIterations). Simplest robust form: hash a canonical JSON of
       `{filaments, clusters(L,a,b,weight), layerHeight, firstLayerHeight, algorithm,
     seed, tuning}`.
-- [ ] **2.2** Default seed = stable 32-bit hash of the same canonical inputs instead of
+- [x] **2.2** Default seed = stable 32-bit hash of the same canonical inputs instead of
       `Date.now()` (`optimizer.ts:525`). User-provided seed still overrides. This makes
       every run reproducible and cacheable; remove the `hasExplicitSeed` cache gating.
-- [ ] **2.3 Tests**: same inputs, no seed, twice → identical result. Toggling region
+- [x] **2.3 Tests**: same inputs, no seed, twice → identical result. Toggling region
       mode with a fixed seed → different cache entries (regression test for F5).
       Changing only `temperature` → cache miss.
 
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 5f93e40..17d2569 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -738,7 +738,7 @@ export default function AutoPaintTab({
                                     <Input
                                         id="optimizer-seed"
                                         type="text"
-                                        placeholder="Random"
+                                        placeholder="Automatic"
                                         value={localOptimizerSeed}
                                         onChange={(e) => setLocalOptimizerSeed(e.target.value)}
                                         onBlur={() => {
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 0a0c450..a19241e 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -100,7 +100,7 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 | --------------- | ------------------------------------------------------------ |
 | Algorithm       | Auto, Exhaustive, Simulated Annealing, or Genetic Algorithm. |
 | Region priority | Uniform, Center-weighted, or Edge-weighted matching.         |
-| Seed (optional) | A number that makes optimizer results repeatable.            |
+| Seed (optional) | Overrides the automatic stable seed for an intentional comparison. |
 
 Use **Auto (smart selection)** unless you have a reason to compare algorithms.
 
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 4da41d7..3a9bbf4 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -5,7 +5,6 @@
  * for multi-material lithophanes. Supports:
  * - Simulated Annealing: Probabilistic global optimization with temperature scheduling
  * - Genetic Algorithm: Population-based evolutionary optimization
- * - Region Weighting: Prioritize important image areas (faces, focal points)
  * - Deterministic Seeding: Reproducible results for A/B testing
  * - Result Caching: Skip redundant computations
  */
@@ -89,48 +88,11 @@ class OptimizerCache {
     private cache = new Map<string, OptimizerResult>();
     private maxSize = 100;
 
-    private getCacheKey(
-        filaments: Filament[],
-        context: ScoringContext,
-        algorithm?: string,
-        seed?: number
-    ): string {
-        // Create stable key from filaments and context
-        const filamentKey = filaments
-            .map((f) => `${f.color}:${f.td.toFixed(2)}`)
-            .sort()
-            .join('|');
-
-        const imageKey = context.imageColors
-            .slice(0, 20) // Sample first 20 colors for hash
-            .map((c) => `${c.L.toFixed(1)},${c.a.toFixed(1)},${c.b.toFixed(1)}`)
-            .join('|');
-
-        const algoKey = algorithm ?? 'auto';
-        const seedKey = seed ?? 0;
-
-        return `${filamentKey}__${imageKey}__${context.layerHeight}__${context.firstLayerHeight}__${algoKey}__${seedKey}`;
-    }
-
-    get(
-        filaments: Filament[],
-        context: ScoringContext,
-        algorithm?: string,
-        seed?: number
-    ): OptimizerResult | null {
-        const key = this.getCacheKey(filaments, context, algorithm, seed);
+    get(key: string): OptimizerResult | null {
         return this.cache.get(key) || null;
     }
 
-    set(
-        filaments: Filament[],
-        context: ScoringContext,
-        result: OptimizerResult,
-        algorithm?: string,
-        seed?: number
-    ): void {
-        const key = this.getCacheKey(filaments, context, algorithm, seed);
-
+    set(key: string, result: OptimizerResult): void {
         // Evict oldest if at capacity
         if (this.cache.size >= this.maxSize) {
             const firstKey = this.cache.keys().next().value;
@@ -151,6 +113,52 @@ class OptimizerCache {
 
 const globalCache = new OptimizerCache();
 
+function tuningFingerprint(options: OptimizerOptions) {
+    return {
+        maxIterations: options.maxIterations ?? null,
+        temperature: options.temperature ?? null,
+        coolingRate: options.coolingRate ?? null,
+        populationSize: options.populationSize ?? null,
+        mutationRate: options.mutationRate ?? null,
+        eliteCount: options.eliteCount ?? null,
+    };
+}
+
+function canonicalOptimizerInput(
+    filaments: Filament[],
+    context: ScoringContext,
+    algorithm: string,
+    options: OptimizerOptions,
+    seed?: number
+): string {
+    return JSON.stringify({
+        filaments: filaments.map((filament) => ({
+            id: filament.id,
+            color: filament.color,
+            td: filament.td,
+        })),
+        clusters: context.imageColors.map((color) => ({
+            L: color.L,
+            a: color.a,
+            b: color.b,
+            weight: color.weight,
+        })),
+        layerHeight: context.layerHeight,
+        firstLayerHeight: context.firstLayerHeight,
+        algorithm,
+        seed: seed ?? null,
+        tuning: tuningFingerprint(options),
+    });
+}
+
+function stableHash32(value: string): number {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index++) {
+        hash = Math.imul(hash ^ value.charCodeAt(index), 0x01000193);
+    }
+    return hash >>> 0;
+}
+
 // ============================================================================
 // Scoring Functions
 // ============================================================================
@@ -515,12 +523,8 @@ export function optimizeFilamentOrder(
     context: ScoringContext,
     options: Partial<OptimizerOptions> = {}
 ): OptimizerResult {
-    // Determine if user provided explicit seed (for caching purposes)
-    const hasExplicitSeed = options.seed !== undefined;
-
     const opts: OptimizerOptions = {
         algorithm: 'auto',
-        seed: Date.now(),
         cachingEnabled: true,
         ...options,
     };
@@ -537,9 +541,13 @@ export function optimizeFilamentOrder(
         }
     }
 
-    // Only check cache if user provided explicit seed (random seeds should not be cached)
-    if (opts.cachingEnabled && hasExplicitSeed) {
-        const cached = globalCache.get(filaments, context, algorithm, opts.seed);
+    const defaultSeedInput = canonicalOptimizerInput(filaments, context, algorithm, opts);
+    const seed = opts.seed ?? stableHash32(defaultSeedInput);
+    opts.seed = seed;
+    const cacheKey = canonicalOptimizerInput(filaments, context, algorithm, opts, seed);
+
+    if (opts.cachingEnabled) {
+        const cached = globalCache.get(cacheKey);
         if (cached) {
             return { ...cached, cacheHit: true };
         }
@@ -564,9 +572,8 @@ export function optimizeFilamentOrder(
     // Tag the result with the resolved algorithm
     result.resolvedAlgorithm = algorithm;
 
-    // Only cache if user provided explicit seed (don't cache random results)
-    if (opts.cachingEnabled && hasExplicitSeed) {
-        globalCache.set(filaments, context, result, algorithm, opts.seed);
+    if (opts.cachingEnabled) {
+        globalCache.set(cacheKey, result);
     }
 
     return result;
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 84cff3c..d97e25e 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -68,3 +68,74 @@ test('each optimizer produces the same result for the same seed', async (t) => {
         });
     }
 });
+
+function withoutCacheState<T extends { cacheHit?: boolean }>(result: T): Omit<T, 'cacheHit'> {
+    const outcome = { ...result };
+    delete outcome.cacheHit;
+    return outcome as Omit<T, 'cacheHit'>;
+}
+
+test('cache keys include all weighted clusters and optimizer tuning', async () => {
+    const { clearOptimizerCache, getOptimizerCacheStats, optimizeFilamentOrder } =
+        await loadOptimizerModule();
+    clearOptimizerCache();
+
+    const manyClusters = {
+        ...context,
+        imageColors: Array.from({ length: 21 }, (_, index) => ({
+            L: 10 + index * 3,
+            a: index - 10,
+            b: 10 - index,
+            weight: index === 20 ? 0.01 : 1,
+        })),
+    };
+    const options = {
+        algorithm: 'simulated-annealing' as const,
+        seed: 12345,
+        maxIterations: 30,
+        temperature: 75,
+        cachingEnabled: true,
+    };
+
+    const first = optimizeFilamentOrder(filaments, manyClusters, options);
+    const cached = optimizeFilamentOrder(filaments, manyClusters, options);
+    assert.equal(first.cacheHit, undefined);
+    assert.equal(cached.cacheHit, true);
+    assert.equal(getOptimizerCacheStats().size, 1);
+
+    const regionWeightedClusters = {
+        ...manyClusters,
+        imageColors: manyClusters.imageColors.map((cluster, index) => ({
+            ...cluster,
+            weight: index === 20 ? 0.5 : cluster.weight,
+        })),
+    };
+    const changedWeight = optimizeFilamentOrder(filaments, regionWeightedClusters, options);
+    assert.equal(changedWeight.cacheHit, undefined, 'a changed spatial weight must miss cache');
+    assert.equal(getOptimizerCacheStats().size, 2);
+
+    const changedTemperature = optimizeFilamentOrder(filaments, manyClusters, {
+        ...options,
+        temperature: 76,
+    });
+    assert.equal(changedTemperature.cacheHit, undefined, 'a changed temperature must miss cache');
+    assert.equal(getOptimizerCacheStats().size, 3);
+});
+
+test('default optimizer seeds are stable and cacheable', async () => {
+    const { clearOptimizerCache, optimizeFilamentOrder } = await loadOptimizerModule();
+    clearOptimizerCache();
+
+    const options = {
+        algorithm: 'genetic' as const,
+        maxIterations: 20,
+        populationSize: 16,
+        cachingEnabled: true,
+    };
+    const first = optimizeFilamentOrder(filaments, context, options);
+    const second = optimizeFilamentOrder(filaments, context, options);
+
+    assert.equal(first.cacheHit, undefined);
+    assert.equal(second.cacheHit, true);
+    assert.deepEqual(withoutCacheState(second), withoutCacheState(first));
+});

From bc1d1552ac7d7d34e6f2285c2e75784ca0e38750 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 11:50:56 +0300
Subject: [PATCH 09/81] Unify auto-paint optimizer scoring

---
 CHANGELOG.md                         |   2 +
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md   |  14 +-
 src/lib/autoPaint.ts                 | 253 ++++++-----
 src/lib/optimizer.ts                 | 145 +++----
 tests/assets/auto-paint-goldens.json | 610 +++++++++++----------------
 tests/optimizer.test.ts              |  32 ++
 6 files changed, 504 insertions(+), 552 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index dd3e499..63c4c49 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,8 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
+- **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
+
 ### Fixed
 
 - **Auto-paint optimizer cache and default seed** - Cache entries now include all target-color weights, every target cluster, and optimizer tuning values. Blank seeds now derive a stable value from the active inputs, making identical runs repeatable and cacheable instead of randomly changing.
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index 2efc33b..68cbefd 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -259,13 +259,13 @@ Goal: the optimizer optimizes the same model the pipeline builds. Fixes F2; part
 F8 (scoring side of the pure-background issue can be folded in here or deferred to
 Phase 6b).
 
-- [ ] **3.1** Move/share the palette builder: expose `buildAchievableColorPalette` +
+- [x] **3.1** Move/share the palette builder: expose `buildAchievableColorPalette` +
       `scoreSequenceAgainstImage` (or a thin `scoreSequence(sequence, context)`
       wrapper) for use by `optimizer.ts`. `ScoringContext` carries the weighted Lab
       targets as today.
-- [ ] **3.2** Replace `scoreFilamentOrder`/`findBestAchievableColor`/
+- [x] **3.2** Replace `scoreFilamentOrder`/`findBestAchievableColor`/
       `simulateStackAtHeight` with the unified scorer in exhaustive, SA, and GA.
-- [ ] **3.3 Performance work so per-eval cost stays acceptable**:
+- [x] **3.3 Performance work so per-eval cost stays acceptable**:
   - Memoize `calculateTransitionThickness(bgColorHex, filamentId)` per optimizer run —
     pair space ≤ N², eliminates the dominant inner loop.
   - Memoize palette per unique sequence string (SA revisits neighbors).
@@ -274,12 +274,16 @@ Phase 6b).
     the structural penalty constants to match (calibrate against Phase 0 harness so
     rankings on fixtures are preserved or improved — this is a tuning task, use the
     harness).
-- [ ] **3.4** SA neighbor: redraw `j` until `j ≠ i` (F10).
-- [ ] **3.5 Tests**: property test — the score the optimizer reports for its chosen
+- [x] **3.4** SA neighbor: redraw `j` until `j ≠ i` (F10).
+- [x] **3.5 Tests**: property test — the score the optimizer reports for its chosen
       order equals `scoreSequence` of that order under the build model (was untrue
       before). Re-baseline Phase 0 golden snapshots; harness must satisfy the Phase 0.5
       acceptance rule. Budget: ≤2 s for 8 filaments (exhaustive falls back per
       existing UI guard).
+      Validated on the development machine with `npm run benchmark:autopaint` against
+      Phase 2 commit `966c13a`: Auto-mode average realized ΔE improved from 34.75 to
+      30.23, every fixture held or improved, and the slowest 8-filament Auto run was
+      42 ms.
 
 Risk: medium — orders will change for users (expected: improvement, verified by
 harness). Determinism preserved (seeded). Schema unchanged.
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index caee487..8cc930c 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -42,7 +42,7 @@ export interface Lab {
 }
 
 /** Lab color with a frequency weight (0-1, normalized) */
-interface WeightedLab extends Lab {
+export interface WeightedLab extends Lab {
     weight: number;
 }
 
@@ -332,12 +332,14 @@ export function calculateTransitionThickness(
  * @param sortedFilaments - Filaments sorted dark to light
  * @param layerHeight - Physical layer height
  * @param baseThickness - Minimum thickness for the first (darkest) layer
+ * @param transitionThicknessCache - Optional cache shared by optimizer evaluations
  * @returns Object with ideal height and zone breakdown
  */
 export function calculateIdealHeight(
     sortedFilaments: Array<{ id: string; color: string; td: number }>,
     layerHeight: number,
-    baseThickness: number = 0.6
+    baseThickness: number = 0.6,
+    transitionThicknessCache?: Map<string, number>
 ): { idealHeight: number; zones: TransitionZone[] } {
     if (sortedFilaments.length === 0) {
         return { idealHeight: baseThickness, zones: [] };
@@ -374,12 +376,26 @@ export function calculateIdealHeight(
         const filamentRgb = hexToRgb(filament.color);
 
         // Calculate how thick this zone needs to be
-        const transitionThickness = calculateTransitionThickness(
-            currentBackgroundColor,
-            filamentRgb,
+        const transitionKey = [
+            currentBackgroundColor.r,
+            currentBackgroundColor.g,
+            currentBackgroundColor.b,
+            filamentRgb.r,
+            filamentRgb.g,
+            filamentRgb.b,
             filament.td,
-            layerHeight
-        );
+            layerHeight,
+        ].join(':');
+        let transitionThickness = transitionThicknessCache?.get(transitionKey);
+        if (transitionThickness === undefined) {
+            transitionThickness = calculateTransitionThickness(
+                currentBackgroundColor,
+                filamentRgb,
+                filament.td,
+                layerHeight
+            );
+            transitionThicknessCache?.set(transitionKey, transitionThickness);
+        }
 
         zones.push({
             filamentId: filament.id,
@@ -597,12 +613,16 @@ function permutations<T>(arr: T[]): T[][] {
  * @param sequence - Ordered filament sequence (can include repeats)
  * @param layerHeight - Physical layer height
  * @param firstLayerHeight - First layer height
+ * @param maxHeight - Optional height constraint applied before sampling the palette
+ * @param transitionThicknessCache - Optional cache shared by optimizer evaluations
  * @returns Array of achievable { height, lab, rgb } at each layer step
  */
-function buildAchievableColorPalette(
+export function buildAchievableColorPalette(
     sequence: Array<{ id: string; color: string; td: number }>,
     layerHeight: number,
-    firstLayerHeight: number
+    firstLayerHeight: number,
+    maxHeight?: number,
+    transitionThicknessCache?: Map<string, number>
 ): Array<{ height: number; lab: Lab; rgb: RGB }> {
     if (sequence.length === 0) return [];
 
@@ -610,12 +630,15 @@ function buildAchievableColorPalette(
     const { zones } = calculateIdealHeight(
         sequence.map((f) => ({ id: f.id, color: f.color, td: f.td })),
         layerHeight,
-        Math.max(firstLayerHeight, layerHeight)
+        Math.max(firstLayerHeight, layerHeight),
+        transitionThicknessCache
     );
 
     if (zones.length === 0) return [];
 
-    const totalHeight = zones[zones.length - 1].endHeight;
+    const activeZones =
+        maxHeight === undefined ? zones : compressZones(zones, maxHeight).compressedZones;
+    const totalHeight = activeZones[activeZones.length - 1].endHeight;
     const palette: Array<{ height: number; lab: Lab; rgb: RGB }> = [];
 
     let currentZ = 0;
@@ -628,31 +651,32 @@ function buildAchievableColorPalette(
 
         // Find active zone
         let activeZoneIndex = 0;
-        for (let zi = 0; zi < zones.length; zi++) {
-            if (currentZ >= zones[zi].startHeight && currentZ < zones[zi].endHeight) {
+        for (let zi = 0; zi < activeZones.length; zi++) {
+            if (currentZ >= activeZones[zi].startHeight && currentZ < activeZones[zi].endHeight) {
                 activeZoneIndex = zi;
                 break;
             }
-            if (currentZ >= zones[zi].startHeight) {
+            if (currentZ >= activeZones[zi].startHeight) {
                 activeZoneIndex = zi;
             }
         }
 
         if (activeZoneIndex !== prevZoneIndex) {
-            thicknessInCurrentZone = currentZ - zones[activeZoneIndex].startHeight + thickness;
+            thicknessInCurrentZone =
+                currentZ - activeZones[activeZoneIndex].startHeight + thickness;
             prevZoneIndex = activeZoneIndex;
         } else {
             thicknessInCurrentZone += thickness;
         }
 
-        const zone = zones[activeZoneIndex];
+        const zone = activeZones[activeZoneIndex];
         const filamentColor = hexToRgb(zone.filamentColor);
 
         let blendedColor: RGB;
         if (activeZoneIndex === 0) {
             blendedColor = filamentColor;
         } else {
-            const bgColor = hexToRgb(zones[activeZoneIndex - 1].filamentColor);
+            const bgColor = hexToRgb(activeZones[activeZoneIndex - 1].filamentColor);
             blendedColor = blendColors(
                 bgColor,
                 filamentColor,
@@ -670,54 +694,18 @@ function buildAchievableColorPalette(
         currentZ += thickness;
         layerIndex++;
 
-        if (layerIndex > 500) break;
+        if (layerIndex >= 500) break;
     }
 
     return palette;
 }
 
-/**
- * Deduplicate a palette by collapsing consecutive entries whose colors
- * are within a DeltaE threshold. Each cluster is represented by its
- * midpoint height, giving the best possible height spread.
- */
-function deduplicatePalette(
-    palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
-    threshold: number = 3.0
-): Array<{ height: number; lab: Lab; rgb: RGB }> {
-    if (palette.length === 0) return [];
-
-    const result: Array<{ height: number; lab: Lab; rgb: RGB }> = [];
-    let clusterStart = 0;
-
-    for (let i = 1; i <= palette.length; i++) {
-        const prev = palette[i - 1];
-        const curr = i < palette.length ? palette[i] : null;
-
-        const shouldBreak =
-            !curr ||
-            Math.sqrt(
-                (curr.lab.L - prev.lab.L) ** 2 +
-                    (curr.lab.a - prev.lab.a) ** 2 +
-                    (curr.lab.b - prev.lab.b) ** 2
-            ) >= threshold;
-
-        if (shouldBreak) {
-            // Use the midpoint entry of this cluster
-            const midIdx = Math.floor((clusterStart + (i - 1)) / 2);
-            result.push(palette[midIdx]);
-            clusterStart = i;
-        }
-    }
-
-    return result;
-}
-
 /**
  * Score a filament sequence against weighted image target colors.
  *
  * The score combines:
- * 1. Weighted color accuracy — for each target, min DeltaE × weight.
+ * 1. Preview-realized color accuracy — project each target onto the printable
+ *    Lab path, then evaluate the discrete layer that the preview will render.
  *    Dominant image colors contribute more to the score, so the optimizer
  *    prioritizes filament orderings that nail the most common colors.
  * 2. Height spread — penalizes when distinct image colors collapse to
@@ -730,29 +718,30 @@ function deduplicatePalette(
  *    any target color. These are "wasted" intermediate layers that exist
  *    only as transitions and contribute no useful color to the image.
  */
-function scoreSequenceAgainstImage(
+export function scoreSequenceAgainstImage(
     palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
     imageTargets: WeightedLab[]
 ): number {
     if (palette.length === 0) return Infinity;
 
-    // Deduplicate: collapse consecutive near-identical colors
-    const reduced = deduplicatePalette(palette, 3.0);
-    if (reduced.length === 0) return Infinity;
+    // Mirror enhanced auto-paint mapping: project each image color onto the
+    // palette's Lab polyline, then use the printable layer at that height.
+    const paletteEntries = palette;
+    if (paletteEntries.length === 0) return Infinity;
 
-    // 1. Weighted color accuracy: sum of (min DeltaE × weight) per target
+    // 1. Weighted preview-realized DeltaE per target
     let weightedDeltaE = 0;
     const bestMatchHeights: number[] = [];
 
-    // Also track which reduced palette entries are "useful" (matched by a target)
+    // Also track which printable palette entries are useful to a target.
     const usedPaletteEntries = new Set<number>();
 
     for (const target of imageTargets) {
         let minDE = Infinity;
-        let bestHeight = reduced[0].height;
+        let bestHeight = paletteEntries[0].height;
         let bestIdx = 0;
-        for (let ri = 0; ri < reduced.length; ri++) {
-            const entry = reduced[ri];
+        for (let ri = 0; ri < paletteEntries.length; ri++) {
+            const entry = paletteEntries[ri];
             const de = Math.sqrt(
                 (entry.lab.L - target.L) ** 2 +
                     (entry.lab.a - target.a) ** 2 +
@@ -765,23 +754,67 @@ function scoreSequenceAgainstImage(
                 if (de < 0.5) break;
             }
         }
-        weightedDeltaE += minDE * target.weight;
+
+        for (let ri = 0; ri < paletteEntries.length - 1; ri++) {
+            const start = paletteEntries[ri];
+            const end = paletteEntries[ri + 1];
+            const dL = end.lab.L - start.lab.L;
+            const da = end.lab.a - start.lab.a;
+            const db = end.lab.b - start.lab.b;
+            const lengthSquared = dL * dL + da * da + db * db;
+            if (lengthSquared < 0.01) continue;
+
+            const t = Math.max(
+                0,
+                Math.min(
+                    1,
+                    ((target.L - start.lab.L) * dL +
+                        (target.a - start.lab.a) * da +
+                        (target.b - start.lab.b) * db) /
+                        lengthSquared
+                )
+            );
+            const projectedL = start.lab.L + t * dL;
+            const projectedA = start.lab.a + t * da;
+            const projectedB = start.lab.b + t * db;
+            const projectedDistance = Math.sqrt(
+                (target.L - projectedL) ** 2 +
+                    (target.a - projectedA) ** 2 +
+                    (target.b - projectedB) ** 2
+            );
+            if (projectedDistance < minDE) {
+                minDE = projectedDistance;
+                bestHeight = start.height + t * (end.height - start.height);
+            }
+        }
+
+        const mappedIdx = paletteEntries.findIndex((entry) => entry.height >= bestHeight);
+        bestIdx = mappedIdx >= 0 ? mappedIdx : paletteEntries.length - 1;
+        const mappedColor = paletteEntries[bestIdx].lab;
+        const mappedDeltaE = Math.sqrt(
+            (mappedColor.L - target.L) ** 2 +
+                (mappedColor.a - target.a) ** 2 +
+                (mappedColor.b - target.b) ** 2
+        );
+
+        weightedDeltaE += mappedDeltaE * target.weight;
         bestMatchHeights.push(bestHeight);
-        // Mark this palette entry as useful if it's a decent match
-        if (minDE < 15) usedPaletteEntries.add(bestIdx);
+        // Mark this palette entry as useful if its printable color is a decent match.
+        if (mappedDeltaE < 15) usedPaletteEntries.add(bestIdx);
     }
 
-    // Scale up so the magnitude is comparable to pre-weighting scores
-    weightedDeltaE *= imageTargets.length;
+    const totalTargetWeight = imageTargets.reduce((sum, target) => sum + target.weight, 0);
+    weightedDeltaE = totalTargetWeight > 0 ? weightedDeltaE / totalTargetWeight : Infinity;
 
     // 2. Height spread penalty: penalize when distinct image colors
     //    collapse to the same height (leading to flat surfaces)
-    if (bestMatchHeights.length > 1 && reduced.length > 1) {
-        const totalModelHeight = reduced[reduced.length - 1].height - reduced[0].height;
+    if (bestMatchHeights.length > 1 && paletteEntries.length > 1) {
+        const totalModelHeight =
+            paletteEntries[paletteEntries.length - 1].height - paletteEntries[0].height;
         if (totalModelHeight > 0) {
             const uniqueHeights = new Set(bestMatchHeights.map((h) => Math.round(h * 100)));
             const spreadRatio = uniqueHeights.size / imageTargets.length;
-            const spreadPenalty = (1 - spreadRatio) * imageTargets.length * 5;
+            const spreadPenalty = (1 - spreadRatio);
             weightedDeltaE += spreadPenalty;
         }
     }
@@ -789,16 +822,15 @@ function scoreSequenceAgainstImage(
     // 3. Total layer count penalty: raw palette size reflects actual model height.
     //    A sequence with expensive transitions (dissimilar hues) produces many
     //    layers; smooth transitions (similar hues) produce few.
-    //    penalty = 0.5 per raw layer — small per layer but adds up significantly
-    //    for wasteful sequences (e.g., 40 layers vs 15 layers = +12.5 penalty)
-    weightedDeltaE += palette.length * 0.5;
+    //    This is deliberately small so color accuracy remains the deciding factor.
+    weightedDeltaE += palette.length * 0.005;
 
     // 4. Transition waste penalty: palette entries not matched by any target.
-    //    If a reduced palette entry is not the best match for any image target,
+    //    If a printable palette entry is not the best match for any image target,
     //    the transition height that produced it is wasted model space.
-    if (reduced.length > 1) {
-        const wastedEntries = reduced.length - usedPaletteEntries.size;
-        weightedDeltaE += wastedEntries * 1.5;
+    if (paletteEntries.length > 1) {
+        const wastedEntries = paletteEntries.length - usedPaletteEntries.size;
+        weightedDeltaE += wastedEntries * 0.015;
     }
 
     return weightedDeltaE;
@@ -824,7 +856,8 @@ function findBestFilamentOrder(
     imageSwatches: Array<{ hex: string; count?: number }>,
     layerHeight: number,
     firstLayerHeight: number,
-    optimizerOptions?: Partial<OptimizerOptions>
+    optimizerOptions?: Partial<OptimizerOptions>,
+    maxHeight?: number
 ): { sortedFilaments: Filament[]; result?: OptimizerResult } {
     if (filaments.length <= 1) {
         return { sortedFilaments: [...filaments] };
@@ -837,7 +870,8 @@ function findBestFilamentOrder(
             imageSwatches,
             layerHeight,
             firstLayerHeight,
-            optimizerOptions
+            optimizerOptions,
+            maxHeight
         );
     }
 
@@ -847,7 +881,8 @@ function findBestFilamentOrder(
             filaments,
             imageSwatches,
             layerHeight,
-            firstLayerHeight
+            firstLayerHeight,
+            maxHeight
         ),
     };
 }
@@ -860,7 +895,8 @@ function findBestFilamentOrderWithOptimizer(
     imageSwatches: Array<{ hex: string; count?: number }>,
     layerHeight: number,
     firstLayerHeight: number,
-    optimizerOptions: Partial<OptimizerOptions>
+    optimizerOptions: Partial<OptimizerOptions>,
+    maxHeight?: number
 ): { sortedFilaments: Filament[]; result: OptimizerResult } {
     // Spatial weighting has already been folded into swatch counts by the caller.
     const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
@@ -870,6 +906,7 @@ function findBestFilamentOrderWithOptimizer(
         imageColors: imageTargets,
         layerHeight,
         firstLayerHeight,
+        maxHeight,
     };
 
     // Apply frontlit TD scale
@@ -896,7 +933,8 @@ function findBestFilamentOrderLegacy(
     filaments: Filament[],
     imageSwatches: Array<{ hex: string; count?: number }>,
     layerHeight: number,
-    firstLayerHeight: number
+    firstLayerHeight: number,
+    maxHeight?: number
 ): Filament[] {
     if (filaments.length <= 1) return [...filaments];
 
@@ -920,7 +958,12 @@ function findBestFilamentOrderLegacy(
         for (const subset of subsets) {
             const perms = permutations(subset);
             for (const perm of perms) {
-                const palette = buildAchievableColorPalette(perm, layerHeight, firstLayerHeight);
+                const palette = buildAchievableColorPalette(
+                    perm,
+                    layerHeight,
+                    firstLayerHeight,
+                    maxHeight
+                );
                 const score = scoreSequenceAgainstImage(palette, imageTargets);
                 if (score < bestScore) {
                     bestScore = score;
@@ -944,7 +987,12 @@ function findBestFilamentOrderLegacy(
         const remaining = scaledFilaments.filter((sf) => sf.id !== startFilament.id);
         const sequence = [startFilament];
 
-        let palette = buildAchievableColorPalette(sequence, layerHeight, firstLayerHeight);
+        let palette = buildAchievableColorPalette(
+            sequence,
+            layerHeight,
+            firstLayerHeight,
+            maxHeight
+        );
         let currentScore = scoreSequenceAgainstImage(palette, imageTargets);
         const pool = [...remaining];
 
@@ -957,7 +1005,8 @@ function findBestFilamentOrderLegacy(
                 const candidatePalette = buildAchievableColorPalette(
                     candidate,
                     layerHeight,
-                    firstLayerHeight
+                    firstLayerHeight,
+                    maxHeight
                 );
                 const candidateScore = scoreSequenceAgainstImage(candidatePalette, imageTargets);
                 if (candidateScore < bestScore) {
@@ -970,7 +1019,12 @@ function findBestFilamentOrderLegacy(
             if (bestIdx < 0 || currentScore - bestScore < 0.5) break;
 
             sequence.push(pool.splice(bestIdx, 1)[0]);
-            palette = buildAchievableColorPalette(sequence, layerHeight, firstLayerHeight);
+            palette = buildAchievableColorPalette(
+                sequence,
+                layerHeight,
+                firstLayerHeight,
+                maxHeight
+            );
             currentScore = bestScore;
         }
 
@@ -1011,7 +1065,8 @@ function buildRepeatedSwapSequence(
     allFilaments: Filament[],
     imageSwatches: Array<{ hex: string; count?: number }>,
     layerHeight: number,
-    firstLayerHeight: number
+    firstLayerHeight: number,
+    maxHeight?: number
 ): Filament[] {
     if (baseFilaments.length === 0) return [];
 
@@ -1028,7 +1083,8 @@ function buildRepeatedSwapSequence(
     let currentPalette = buildAchievableColorPalette(
         currentSequence,
         layerHeight,
-        firstLayerHeight
+        firstLayerHeight,
+        maxHeight
     );
     let currentScore = scoreSequenceAgainstImage(currentPalette, imageTargets);
 
@@ -1041,7 +1097,8 @@ function buildRepeatedSwapSequence(
     // Maximum number of extra swaps to try (avoid runaway sequences)
     const MAX_EXTRA_SWAPS = Math.min(4, allFilaments.length);
     // Minimum improvement threshold — stop if gains are diminishing
-    const MIN_IMPROVEMENT = 2.0;
+    // The scorer is normalized by target weight, so this is a fractional delta.
+    const MIN_IMPROVEMENT = 0.001;
 
     for (let iter = 0; iter < MAX_EXTRA_SWAPS; iter++) {
         let bestCandidate: (typeof candidates)[0] | null = null;
@@ -1069,7 +1126,8 @@ function buildRepeatedSwapSequence(
                 const trialPalette = buildAchievableColorPalette(
                     trial,
                     layerHeight,
-                    firstLayerHeight
+                    firstLayerHeight,
+                    maxHeight
                 );
                 const trialScore = scoreSequenceAgainstImage(trialPalette, imageTargets);
 
@@ -1093,7 +1151,8 @@ function buildRepeatedSwapSequence(
         currentPalette = buildAchievableColorPalette(
             currentSequence,
             layerHeight,
-            firstLayerHeight
+            firstLayerHeight,
+            maxHeight
         );
         currentScore = bestScore;
     }
@@ -1186,7 +1245,8 @@ export function generateAutoLayers(
             imageSwatches,
             layerHeight,
             firstLayerHeight,
-            optimizerOptions
+            optimizerOptions,
+            maxHeight
         );
 
         sortedFilaments = orderingResult.sortedFilaments;
@@ -1199,7 +1259,8 @@ export function generateAutoLayers(
                 filaments,
                 imageSwatches,
                 layerHeight,
-                firstLayerHeight
+                firstLayerHeight,
+                maxHeight
             );
         }
     } else {
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 3a9bbf4..fdc8cc2 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -10,7 +10,11 @@
  */
 
 import type { Filament } from '../types';
-import { rgbToLab, deltaELab, hexToRgb, blendColors, type RGB, type Lab } from './autoPaint';
+import {
+    buildAchievableColorPalette,
+    scoreSequenceAgainstImage,
+    type WeightedLab,
+} from './autoPaint';
 
 // ============================================================================
 // Type Definitions
@@ -38,9 +42,10 @@ export interface OptimizerResult {
 }
 
 export interface ScoringContext {
-    imageColors: Array<Lab & { weight: number }>; // Weighted Lab colors from image
+    imageColors: WeightedLab[];
     layerHeight: number;
     firstLayerHeight: number;
+    maxHeight?: number;
 }
 
 // ============================================================================
@@ -145,6 +150,7 @@ function canonicalOptimizerInput(
         })),
         layerHeight: context.layerHeight,
         firstLayerHeight: context.firstLayerHeight,
+        maxHeight: context.maxHeight ?? null,
         algorithm,
         seed: seed ?? null,
         tuning: tuningFingerprint(options),
@@ -163,91 +169,40 @@ function stableHash32(value: string): number {
 // Scoring Functions
 // ============================================================================
 
-/**
- * Calculate quality score for a filament ordering.
- * Lower score = better color reproduction.
- *
- * Score is weighted deltaE between image colors and achievable blended colors.
- */
-function scoreFilamentOrder(filaments: Filament[], context: ScoringContext): number {
-    if (filaments.length === 0) return Infinity;
-
-    let totalError = 0;
-    let totalWeight = 0;
-
-    // For each image color, find the best achievable match using this filament stack
-    for (const targetColor of context.imageColors) {
-        const achievableColor = findBestAchievableColor(targetColor, filaments);
-        const error = deltaELab(targetColor, achievableColor);
-
-        // Apply region weight if provided
-        totalError += error * targetColor.weight;
-        totalWeight += targetColor.weight;
-    }
-
-    return totalWeight > 0 ? totalError / totalWeight : Infinity;
-}
-
-/**
- * Find the best color achievable by stacking filaments to a certain height.
- * Uses Beer-Lambert simulation to predict the blended color at various heights.
- */
-function findBestAchievableColor(targetLab: Lab, filaments: Filament[]): Lab {
-    if (filaments.length === 0) return { L: 0, a: 0, b: 0 };
-    if (filaments.length === 1) {
-        return rgbToLab(hexToRgb(filaments[0].color));
-    }
-
-    // Sample heights from base to full stack
-    const maxHeight = filaments.reduce((sum, f) => sum + f.td * 3, 0); // ~3x TD per filament
-    const steps = 20;
-    let bestLab = rgbToLab(hexToRgb(filaments[0].color));
-    let bestDelta = deltaELab(targetLab, bestLab);
-
-    for (let i = 0; i <= steps; i++) {
-        const height = (i / steps) * maxHeight;
-        const blendedColor = simulateStackAtHeight(filaments, height);
-        const blendedLab = rgbToLab(blendedColor);
-        const delta = deltaELab(targetLab, blendedLab);
-
-        if (delta < bestDelta) {
-            bestDelta = delta;
-            bestLab = blendedLab;
+export function createSequenceScorer(context: ScoringContext): (filaments: Filament[]) => number {
+    const paletteCache = new Map<string, ReturnType<typeof buildAchievableColorPalette>>();
+    const transitionThicknessCache = new Map<string, number>();
+
+    return (filaments) => {
+        if (filaments.length === 0) return Infinity;
+        const sequenceKey = filaments.map((filament) => `${filament.id}:${filament.color}:${filament.td}`).join('|');
+        let palette = paletteCache.get(sequenceKey);
+        if (!palette) {
+            palette = buildAchievableColorPalette(
+                filaments,
+                context.layerHeight,
+                context.firstLayerHeight,
+                context.maxHeight,
+                transitionThicknessCache
+            );
+            paletteCache.set(sequenceKey, palette);
         }
-    }
-
-    return bestLab;
+        return scoreSequenceAgainstImage(palette, context.imageColors);
+    };
 }
 
-/**
- * Simulate the blended color of stacked filaments at a given height.
- */
-function simulateStackAtHeight(filaments: Filament[], targetHeight: number): RGB {
-    let currentHeight = 0;
-    let blendedColor = hexToRgb(filaments[0].color);
-
-    for (let i = 1; i < filaments.length && currentHeight < targetHeight; i++) {
-        const prevFilament = filaments[i - 1];
-        const currentFilament = filaments[i];
-        const transitionHeight = Math.min(prevFilament.td * 3, targetHeight - currentHeight);
-
-        if (transitionHeight <= 0) break;
-
-        const bgColor = blendedColor;
-        const fgColor = hexToRgb(currentFilament.color);
-        blendedColor = blendColors(bgColor, fgColor, currentFilament.td, transitionHeight);
-
-        currentHeight += transitionHeight;
-    }
-
-    return blendedColor;
+export function scoreFilamentSequence(filaments: Filament[], context: ScoringContext): number {
+    return createSequenceScorer(context)(filaments);
 }
 
 // ============================================================================
 // Exhaustive Search (Optimal but slow for >8 filaments)
 // ============================================================================
 
-function optimizeExhaustive(filaments: Filament[], context: ScoringContext): OptimizerResult {
+function optimizeExhaustive(
+    filaments: Filament[],
+    scoreSequence: (filaments: Filament[]) => number
+): OptimizerResult {
     if (filaments.length === 0) {
         return {
             order: [],
@@ -260,21 +215,21 @@ function optimizeExhaustive(filaments: Filament[], context: ScoringContext): Opt
     if (filaments.length === 1) {
         return {
             order: [filaments[0]],
-            score: scoreFilamentOrder(filaments, context),
+            score: scoreSequence(filaments),
             iterations: 1,
             converged: true,
         };
     }
 
     let bestOrder = filaments;
-    let bestScore = scoreFilamentOrder(filaments, context);
+    let bestScore = scoreSequence(filaments);
     let iterations = 0;
 
     // Generate all permutations
     const permute = (arr: Filament[], start = 0): void => {
         if (start === arr.length - 1) {
             iterations++;
-            const score = scoreFilamentOrder(arr, context);
+            const score = scoreSequence(arr);
             if (score < bestScore) {
                 bestScore = score;
                 bestOrder = [...arr];
@@ -311,21 +266,21 @@ function optimizeExhaustive(filaments: Filament[], context: ScoringContext): Opt
  */
 function optimizeSimulatedAnnealing(
     filaments: Filament[],
-    context: ScoringContext,
+    scoreSequence: (filaments: Filament[]) => number,
     options: OptimizerOptions
 ): OptimizerResult {
     if (filaments.length <= 1) {
-        return optimizeExhaustive(filaments, context);
+        return optimizeExhaustive(filaments, scoreSequence);
     }
 
     const rng = new SeededRandom(options.seed);
     const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
-    const initialTemp = options.temperature ?? 100.0;
+    const initialTemp = options.temperature ?? 10.0;
     const coolingRate = options.coolingRate ?? 0.995;
     const minTemp = 0.01;
 
     let currentOrder = rng.shuffle(filaments);
-    let currentScore = scoreFilamentOrder(currentOrder, context);
+    let currentScore = scoreSequence(currentOrder);
     let bestOrder = [...currentOrder];
     let bestScore = currentScore;
     let temperature = initialTemp;
@@ -337,10 +292,11 @@ function optimizeSimulatedAnnealing(
         // Generate neighbor by swapping two random filaments
         const newOrder = [...currentOrder];
         const i = rng.nextInt(0, newOrder.length);
-        const j = rng.nextInt(0, newOrder.length);
+        let j = rng.nextInt(0, newOrder.length - 1);
+        if (j >= i) j++;
         [newOrder[i], newOrder[j]] = [newOrder[j], newOrder[i]];
 
-        const newScore = scoreFilamentOrder(newOrder, context);
+        const newScore = scoreSequence(newOrder);
         const deltaE = newScore - currentScore;
 
         // Accept if better, or with probability exp(-ΔE/T) if worse
@@ -382,11 +338,11 @@ function optimizeSimulatedAnnealing(
  */
 function optimizeGenetic(
     filaments: Filament[],
-    context: ScoringContext,
+    scoreSequence: (filaments: Filament[]) => number,
     options: OptimizerOptions
 ): OptimizerResult {
     if (filaments.length <= 1) {
-        return optimizeExhaustive(filaments, context);
+        return optimizeExhaustive(filaments, scoreSequence);
     }
 
     const rng = new SeededRandom(options.seed);
@@ -399,7 +355,7 @@ function optimizeGenetic(
     let population: Array<{ order: Filament[]; score: number }> = [];
     for (let i = 0; i < populationSize; i++) {
         const order = rng.shuffle(filaments);
-        const score = scoreFilamentOrder(order, context);
+        const score = scoreSequence(order);
         population.push({ order, score });
     }
 
@@ -444,7 +400,7 @@ function optimizeGenetic(
                 [child[i], child[j]] = [child[j], child[i]];
             }
 
-            const score = scoreFilamentOrder(child, context);
+            const score = scoreSequence(child);
             nextGeneration.push({ order: child, score });
         }
 
@@ -554,16 +510,17 @@ export function optimizeFilamentOrder(
     }
 
     let result: OptimizerResult;
+    const scoreSequence = createSequenceScorer(context);
 
     switch (algorithm) {
         case 'exhaustive':
-            result = optimizeExhaustive(filaments, context);
+            result = optimizeExhaustive(filaments, scoreSequence);
             break;
         case 'simulated-annealing':
-            result = optimizeSimulatedAnnealing(filaments, context, opts);
+            result = optimizeSimulatedAnnealing(filaments, scoreSequence, opts);
             break;
         case 'genetic':
-            result = optimizeGenetic(filaments, context, opts);
+            result = optimizeGenetic(filaments, scoreSequence, opts);
             break;
         default:
             throw new Error(`Unknown algorithm: ${algorithm}`);
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 33125d2..2ecbba8 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -49,58 +49,50 @@
   },
   "B&W / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "p9c63ms",
-      "plvjtmc"
+      "plvjtmc",
+      "p9c63ms"
     ],
     "transitionZones": [
       {
-        "filamentId": "p9c63ms",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.7800000000000001,
-        "idealThickness": 0.7800000000000001,
-        "actualThickness": 0.7800000000000001
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.7800000000000001,
-        "endHeight": 0.8600000000000001,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "p9c63ms",
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
       }
     ],
-    "totalHeight": 0.8600000000000001,
+    "totalHeight": 0.5800000000000001,
     "compressionRatio": 1
   },
   "B&W / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "p9c63ms",
       "plvjtmc",
       "p9c63ms"
     ],
     "transitionZones": [
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 0,
-        "endHeight": 0.7800000000000001,
-        "idealThickness": 0.7800000000000001,
-        "actualThickness": 0.7800000000000001
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.7800000000000001,
-        "endHeight": 0.8600000000000001,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 0.8600000000000001,
-        "endHeight": 1.2800000000000002,
+        "startHeight": 0.16,
+        "endHeight": 0.5800000000000001,
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.42000000000000004
       }
     ],
-    "totalHeight": 1.2800000000000002,
+    "totalHeight": 0.5800000000000001,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=false / repeats=false": {
@@ -281,106 +273,90 @@
   },
   "GH#27 / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "h8zuocq",
-      "xud8mzr",
       "plvjtmc",
-      "y202l1e"
+      "y202l1e",
+      "h8zuocq",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.45500000000000007,
-        "idealThickness": 0.45500000000000007,
-        "actualThickness": 0.45500000000000007
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.45500000000000007,
-        "endHeight": 0.6950000000000001,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "filamentId": "y202l1e",
+        "startHeight": 0.16,
+        "endHeight": 0.489,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.6950000000000001,
-        "endHeight": 0.775,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "h8zuocq",
+        "startHeight": 0.489,
+        "endHeight": 0.734,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.775,
-        "endHeight": 1.104,
-        "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "filamentId": "xud8mzr",
+        "startHeight": 0.734,
+        "endHeight": 0.974,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.104,
+    "totalHeight": 0.974,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "h8zuocq",
-      "xud8mzr",
-      "h8zuocq",
-      "y202l1e",
       "plvjtmc",
       "y202l1e",
-      "plvjtmc"
+      "h8zuocq",
+      "y202l1e",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.45500000000000007,
-        "idealThickness": 0.45500000000000007,
-        "actualThickness": 0.45500000000000007
-      },
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.45500000000000007,
-        "endHeight": 0.6950000000000001,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
-      },
-      {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.6950000000000001,
-        "endHeight": 0.935,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.935,
-        "endHeight": 1.264,
+        "startHeight": 0.16,
+        "endHeight": 0.489,
         "idealThickness": 0.329,
         "actualThickness": 0.329
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.264,
-        "endHeight": 1.344,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "h8zuocq",
+        "startHeight": 0.489,
+        "endHeight": 0.734,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 1.344,
-        "endHeight": 1.673,
+        "startHeight": 0.734,
+        "endHeight": 1.063,
         "idealThickness": 0.329,
         "actualThickness": 0.329
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.673,
-        "endHeight": 1.7530000000000001,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "xud8mzr",
+        "startHeight": 1.063,
+        "endHeight": 1.322,
+        "idealThickness": 0.259,
+        "actualThickness": 0.259
       }
     ],
-    "totalHeight": 1.7530000000000001,
+    "totalHeight": 1.322,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -465,114 +441,90 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "xud8mzr",
-      "y202l1e",
       "plvjtmc",
-      "h8zuocq"
+      "y202l1e",
+      "h8zuocq",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.4810000000000001,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.4810000000000001
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.4810000000000001,
-        "endHeight": 0.81,
+        "startHeight": 0.16,
+        "endHeight": 0.489,
         "idealThickness": 0.329,
         "actualThickness": 0.329
       },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.81,
-        "endHeight": 0.89,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.89,
-        "endHeight": 1.135,
+        "startHeight": 0.489,
+        "endHeight": 0.734,
         "idealThickness": 0.245,
         "actualThickness": 0.245
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.734,
+        "endHeight": 0.974,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.135,
+    "totalHeight": 0.974,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "xud8mzr",
-      "plvjtmc",
-      "xud8mzr",
       "plvjtmc",
       "y202l1e",
-      "xud8mzr",
-      "plvjtmc",
-      "h8zuocq"
+      "h8zuocq",
+      "y202l1e",
+      "xud8mzr"
     ],
     "transitionZones": [
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0,
-        "endHeight": 0.4810000000000001,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.4810000000000001
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.4810000000000001,
-        "endHeight": 0.561,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.561,
-        "endHeight": 0.8200000000000001,
-        "idealThickness": 0.259,
-        "actualThickness": 0.259
+        "filamentId": "y202l1e",
+        "startHeight": 0.16,
+        "endHeight": 0.489,
+        "idealThickness": 0.329,
+        "actualThickness": 0.329
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.8200000000000001,
-        "endHeight": 0.9,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "h8zuocq",
+        "startHeight": 0.489,
+        "endHeight": 0.734,
+        "idealThickness": 0.245,
+        "actualThickness": 0.245
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.9,
-        "endHeight": 1.229,
+        "startHeight": 0.734,
+        "endHeight": 1.063,
         "idealThickness": 0.329,
         "actualThickness": 0.329
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 1.229,
-        "endHeight": 1.488,
+        "startHeight": 1.063,
+        "endHeight": 1.322,
         "idealThickness": 0.259,
         "actualThickness": 0.259
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.488,
-        "endHeight": 1.568,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "h8zuocq",
-        "startHeight": 1.568,
-        "endHeight": 1.8130000000000002,
-        "idealThickness": 0.245,
-        "actualThickness": 0.245
       }
     ],
-    "totalHeight": 1.8130000000000002,
+    "totalHeight": 1.322,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -721,178 +673,154 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "p9c63ms",
       "plvjtmc",
-      "upcjpfe",
       "azwg1yp",
-      "98z555k",
       "xyyxysq",
       "w8cncoa",
-      "vsn9q6u"
+      "upcjpfe",
+      "p9c63ms",
+      "vsn9q6u",
+      "98z555k"
     ],
     "transitionZones": [
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 0,
-        "endHeight": 0.7800000000000001,
-        "idealThickness": 0.7800000000000001,
-        "actualThickness": 0.7800000000000001
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.7800000000000001,
-        "endHeight": 0.8600000000000001,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.8600000000000001,
-        "endHeight": 1.203,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.203,
-        "endHeight": 1.399,
+        "startHeight": 0.16,
+        "endHeight": 0.356,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.19599999999999998
       },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 1.399,
-        "endHeight": 1.672,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.672,
-        "endHeight": 2.029,
+        "startHeight": 0.356,
+        "endHeight": 0.713,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 2.029,
-        "endHeight": 2.4699999999999998,
+        "startHeight": 0.713,
+        "endHeight": 1.154,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
       },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 1.154,
+        "endHeight": 1.4969999999999999,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.4969999999999999,
+        "endHeight": 1.9169999999999998,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.4699999999999998,
-        "endHeight": 2.7359999999999998,
+        "startHeight": 1.9169999999999998,
+        "endHeight": 2.183,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 2.183,
+        "endHeight": 2.456,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
       }
     ],
-    "totalHeight": 2.7359999999999998,
+    "totalHeight": 2.456,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "vsn9q6u",
-      "98z555k",
-      "vsn9q6u",
+      "plvjtmc",
       "azwg1yp",
       "xyyxysq",
       "w8cncoa",
       "upcjpfe",
-      "azwg1yp",
       "p9c63ms",
-      "plvjtmc",
-      "azwg1yp",
-      "w8cncoa"
+      "w8cncoa",
+      "vsn9q6u",
+      "98z555k"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.49400000000000005,
-        "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.49400000000000005
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 0.49400000000000005,
-        "endHeight": 0.767,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.767,
-        "endHeight": 1.033,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.033,
-        "endHeight": 1.2289999999999999,
+        "startHeight": 0.16,
+        "endHeight": 0.356,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.19599999999999998
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.2289999999999999,
-        "endHeight": 1.5859999999999999,
+        "startHeight": 0.356,
+        "endHeight": 0.713,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.5859999999999999,
-        "endHeight": 2.0269999999999997,
+        "startHeight": 0.713,
+        "endHeight": 1.154,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.0269999999999997,
-        "endHeight": 2.3699999999999997,
+        "startHeight": 1.154,
+        "endHeight": 1.4969999999999999,
         "idealThickness": 0.343,
         "actualThickness": 0.343
       },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 2.3699999999999997,
-        "endHeight": 2.566,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
-      },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 2.566,
-        "endHeight": 2.9859999999999998,
+        "startHeight": 1.4969999999999999,
+        "endHeight": 1.9169999999999998,
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.42000000000000004
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.9859999999999998,
-        "endHeight": 3.066,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "w8cncoa",
+        "startHeight": 1.9169999999999998,
+        "endHeight": 2.3579999999999997,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
       },
       {
-        "filamentId": "azwg1yp",
-        "startHeight": 3.066,
-        "endHeight": 3.262,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.3579999999999997,
+        "endHeight": 2.6239999999999997,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 3.262,
-        "endHeight": 3.703,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "filamentId": "98z555k",
+        "startHeight": 2.6239999999999997,
+        "endHeight": 2.897,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
       }
     ],
-    "totalHeight": 3.703,
+    "totalHeight": 2.897,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -1041,178 +969,146 @@
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
+      "upcjpfe",
+      "plvjtmc",
+      "p9c63ms",
       "azwg1yp",
+      "w8cncoa",
       "98z555k",
-      "upcjpfe",
       "xyyxysq",
-      "w8cncoa",
-      "vsn9q6u",
-      "plvjtmc",
-      "p9c63ms"
+      "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "upcjpfe",
         "startHeight": 0,
-        "endHeight": 0.364,
-        "idealThickness": 0.364,
-        "actualThickness": 0.364
+        "endHeight": 0.6370000000000001,
+        "idealThickness": 0.6370000000000001,
+        "actualThickness": 0.6370000000000001
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 0.364,
-        "endHeight": 0.637,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "filamentId": "plvjtmc",
+        "startHeight": 0.6370000000000001,
+        "endHeight": 0.7170000000000001,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.637,
-        "endHeight": 0.98,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "filamentId": "p9c63ms",
+        "startHeight": 0.7170000000000001,
+        "endHeight": 1.137,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 0.98,
-        "endHeight": 1.337,
-        "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "filamentId": "azwg1yp",
+        "startHeight": 1.137,
+        "endHeight": 1.333,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.337,
-        "endHeight": 1.778,
+        "startHeight": 1.333,
+        "endHeight": 1.774,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.778,
-        "endHeight": 2.044,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "filamentId": "98z555k",
+        "startHeight": 1.774,
+        "endHeight": 2.047,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.044,
-        "endHeight": 2.124,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "xyyxysq",
+        "startHeight": 2.047,
+        "endHeight": 2.404,
+        "idealThickness": 0.357,
+        "actualThickness": 0.357
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 2.124,
-        "endHeight": 2.544,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.404,
+        "endHeight": 2.67,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
       }
     ],
-    "totalHeight": 2.544,
+    "totalHeight": 2.67,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "azwg1yp",
-      "98z555k",
-      "plvjtmc",
-      "p9c63ms",
-      "w8cncoa",
-      "xyyxysq",
       "vsn9q6u",
+      "xyyxysq",
+      "w8cncoa",
       "upcjpfe",
       "98z555k",
-      "upcjpfe",
       "plvjtmc",
-      "w8cncoa"
+      "p9c63ms",
+      "azwg1yp"
     ],
     "transitionZones": [
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "vsn9q6u",
         "startHeight": 0,
-        "endHeight": 0.364,
-        "idealThickness": 0.364,
-        "actualThickness": 0.364
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 0.364,
-        "endHeight": 0.637,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.637,
-        "endHeight": 0.717,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 0.717,
-        "endHeight": 1.137,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
-      },
-      {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.137,
-        "endHeight": 1.5779999999999998,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "endHeight": 0.49400000000000005,
+        "idealThickness": 0.49400000000000005,
+        "actualThickness": 0.49400000000000005
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.5779999999999998,
-        "endHeight": 1.9349999999999998,
+        "startHeight": 0.49400000000000005,
+        "endHeight": 0.851,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.9349999999999998,
-        "endHeight": 2.2009999999999996,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "filamentId": "w8cncoa",
+        "startHeight": 0.851,
+        "endHeight": 1.2919999999999998,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.2009999999999996,
-        "endHeight": 2.5439999999999996,
+        "startHeight": 1.2919999999999998,
+        "endHeight": 1.6349999999999998,
         "idealThickness": 0.343,
         "actualThickness": 0.343
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.5439999999999996,
-        "endHeight": 2.8169999999999997,
+        "startHeight": 1.6349999999999998,
+        "endHeight": 1.9079999999999997,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.27299999999999996
       },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.8169999999999997,
-        "endHeight": 3.1599999999999997,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 3.1599999999999997,
-        "endHeight": 3.2399999999999998,
+        "startHeight": 1.9079999999999997,
+        "endHeight": 1.9879999999999998,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 3.2399999999999998,
-        "endHeight": 3.6809999999999996,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "filamentId": "p9c63ms",
+        "startHeight": 1.9879999999999998,
+        "endHeight": 2.408,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.408,
+        "endHeight": 2.604,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
       }
     ],
-    "totalHeight": 3.6809999999999996,
+    "totalHeight": 2.604,
     "compressionRatio": 1
   }
 }
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index d97e25e..2fd634f 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -139,3 +139,35 @@ test('default optimizer seeds are stable and cacheable', async () => {
     assert.equal(second.cacheHit, true);
     assert.deepEqual(withoutCacheState(second), withoutCacheState(first));
 });
+
+test('optimizer scores its selected order with the shared build-model scorer', async () => {
+    const { optimizeFilamentOrder, scoreFilamentSequence } = await loadOptimizerModule();
+    const result = optimizeFilamentOrder(filaments, context, {
+        algorithm: 'exhaustive',
+        seed: 99,
+        cachingEnabled: false,
+    });
+
+    assert.equal(result.score, scoreFilamentSequence(result.order, context));
+});
+
+test('the shared scorer evaluates the compressed stack when Max Height is set', async () => {
+    const { optimizeFilamentOrder, scoreFilamentSequence } = await loadOptimizerModule();
+    const compressedContext = { ...context, maxHeight: 0.24 };
+    const options = {
+        algorithm: 'exhaustive' as const,
+        seed: 99,
+        cachingEnabled: false,
+    };
+
+    const unconstrainedScore = scoreFilamentSequence(filaments, context);
+    const compressedScore = scoreFilamentSequence(filaments, compressedContext);
+    const result = optimizeFilamentOrder(filaments, compressedContext, options);
+
+    assert.notEqual(
+        compressedScore,
+        unconstrainedScore,
+        'compression must change the palette being scored'
+    );
+    assert.equal(result.score, scoreFilamentSequence(result.order, compressedContext));
+});

From 6d41030e36c069c39504f15f4159a0f0d0130d54 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 15:26:34 +0300
Subject: [PATCH 10/81] Add variable-length auto-paint search

---
 CHANGELOG.md                         |   1 +
 README.md                            |  14 +-
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md   |  16 +-
 src/components/AutoPaintTab.tsx      |   4 +-
 src/components/ThreeDControls.tsx    |   2 +-
 src/docs/3d-mode.md                  |   5 +
 src/hooks/useAutoPaintWorker.ts      |   7 +-
 src/lib/autoPaint.ts                 | 341 ++----------------
 src/lib/optimizer.ts                 | 504 +++++++++++++++++----------
 tests/assets/auto-paint-goldens.json | 274 ++++++++-------
 tests/autoPaint.test.ts              |  40 +++
 tests/optimizer.test.ts              | 113 ++++++
 12 files changed, 681 insertions(+), 640 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 63c4c49..66836d4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,7 @@ All notable changes to Kromacut are documented in this file.
 ### Changed
 
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
+- **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
 
 ### Fixed
 
diff --git a/README.md b/README.md
index 7a41447..a7d6e7a 100644
--- a/README.md
+++ b/README.md
@@ -142,10 +142,10 @@ When **Enhanced color matching** is enabled, Kromacut uses advanced optimization
 
 | Algorithm | When Used | Description |
 |---|---|---|
-| **Exhaustive search** | 1-4 filaments | Evaluates all possible orderings to guarantee the optimal solution. Fast for small sets. |
-| **Simulated Annealing** | 5-8 filaments | Physics-inspired probabilistic search that escapes local minima via controlled randomness. Balances quality and speed. |
-| **Genetic Algorithm** | 9+ filaments | Evolution-inspired population-based search with crossover and mutation. Best for large filament sets where exhaustive search is prohibitive (8! = 40,320 permutations). |
-| **Auto** | Default | Automatically selects the best algorithm based on filament count and search space size. |
+| **Exhaustive search** | Up to 6 filaments | Evaluates every ordered, non-empty subset to guarantee the best available stack. |
+| **Beam search** | Auto, 7-12 filaments | Keeps the strongest partial stacks as it grows them, letting Auto omit unhelpful filaments without an expensive full enumeration. |
+| **Variable-length annealing** | Auto, 13+ filaments; manual Simulated Annealing or Genetic | Searches swaps, moves, insertions, removals, and replacements. The Genetic setting currently uses this search with a larger budget. |
+| **Auto** | Default | Chooses exhaustive search, beam search, or variable-length annealing from the filament count. |
 
 The optimizer displays metadata after generation:
 - **Algorithm used** — Which method was selected
@@ -173,12 +173,12 @@ Region weighting is most useful when filament budget is limited and you want the
 | Option | Description |
 |---|---|
 | **Max Height** | Constrains the total model height (mm). When set below the auto-calculated ideal, zones are uniformly compressed. Leave blank or click `Auto` for the physics-derived default. |
-| **Enhanced color matching** | Optimizes filament ordering for best color reproduction rather than simple luminance sorting. Uses advanced algorithms (exhaustive, simulated annealing, genetic) automatically selected based on filament count. Scoring considers weighted DeltaE accuracy, height spread, layer count, and transition waste. |
-| **Allow repeated filament swaps** | (Requires Enhanced color matching) Allows a filament to appear more than once in the stack. This creates intermediate blended colors — for example, a thin white layer over red produces pink. The algorithm greedily inserts up to 4 extra swaps, each at the position that best improves the score. |
+| **Enhanced color matching** | Optimizes the printable filament sequence rather than simply sorting by luminance. It may omit filaments that do not improve the result and evaluates the actual preview color-to-height path. |
+| **Allow repeated filament swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once, up to four extra occurrences, when that creates a useful color transition. For example, a thin white layer over red can create pink. |
 | **Height dithering** | (Requires Enhanced color matching) Applies block-aware Floyd-Steinberg error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
-| **Optimizer algorithm** | Choose which optimization algorithm to use: Auto (recommended), Exhaustive, Simulated Annealing, or Genetic. Auto selects the best algorithm based on search space size. |
+| **Optimizer algorithm** | Choose Auto (recommended), Exhaustive (up to 6 filaments), Simulated Annealing, or Genetic. Auto uses exhaustive search through 6 filaments, beam search through 12, then variable-length annealing. |
 | **Optimizer seed** | Leave blank for an automatic stable seed, or enter a number for a specific repeatable run. |
 | **Region weighting** | Prioritize specific image regions: Uniform (equal), Center (image middle), or Edge (outer image border). Helps focus quality budget on important areas. |
 
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index 68cbefd..e03ab76 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -298,31 +298,31 @@ duplicates, repeats allowed **only when** `allowRepeatedSwaps` is on (otherwise
 sequences are permutations of subsets). 500-layer guard enforced via scoring penalty +
 hard cap.
 
-- [ ] **4.1** `exhaustive` (≤6 filaments): all permutations of all non-empty subsets
+- [x] **4.1** `exhaustive` (≤6 filaments): all permutations of all non-empty subsets
       (1,956 evals at N=6 — legacy semantics restored) under the unified scorer. When
       repeats are on, extend with the bounded insertion expansion as a post-pass _of
       the same scorer_ (cheap and already consistent), or fold repeats into beam
       search (4.2) and route there. Update UI label/threshold honestly (≤6, not ≤8;
       keep the existing >threshold downgrade-to-auto behavior in one place — remove
       the duplicate guard, F10).
-- [ ] **4.2** **Beam search** (new internal algorithm, used by `auto` for 7-12
+- [x] **4.2** **Beam search** (new internal algorithm, used by `auto` for 7-12
       filaments): build sequences bottom-up; at each depth keep top-K (K≈100, tunable
       via harness) partial stacks scored with the unified scorer; candidate extensions
       = any non-duplicate filament occurrence + "stop" (subset selection falls out
       naturally). Deterministic, anytime, trivially reports progress (depth/maxDepth).
-- [ ] **4.3** **Variable-length SA** (replaces permutation SA; used by
+- [x] **4.3** **Variable-length SA** (replaces permutation SA; used by
       `simulated-annealing` and by `auto` for >12): moves = swap(i,j), relocate(i→j),
       insert(filament, pos) [only if repeats allowed or filament unused],
       remove(pos) [if length > 1], replace(pos, filament). Seeded move selection;
       geometric cooling as today.
-- [ ] **4.4** GA (`genetic` UI value): keep permutation GA over the full set initially
+- [x] **4.4** GA (`genetic` UI value): keep permutation GA over the full set initially
       but wrap with subset-aware repair, or route `genetic` to variable-length SA with
       a different default budget if GA quality on the harness is not competitive.
       Decide on harness data, not in advance.
-- [ ] **4.5** Delete `buildRepeatedSwapSequence`; `generateAutoLayers` passes
+- [x] **4.5** Delete `buildRepeatedSwapSequence`; `generateAutoLayers` passes
       `allowRepeatedSwaps` into optimizer options instead
       (`autoPaint.ts:1307-1316`).
-- [ ] **4.6 Tests**: printability invariants (foundation exists; no consecutive
+- [x] **4.6 Tests**: printability invariants (foundation exists; no consecutive
   duplicate filament ids; sequence length caps; result schema unchanged; slice snapping
   unchanged); per-seed determinism for each algorithm; harness non-regression per
   Phase 0.5; specific scenario tests:
@@ -331,6 +331,10 @@ hard cap.
   - Thin-white-over-red produces a pink intermediate when repeats are on (repeated-swap
     regression).
   - `allowRepeatedSwaps=false` → no filament appears twice.
+  Validated on the development machine with `npm run benchmark:autopaint` against
+  Phase 3 commit `bc1d155`: Auto-mode average realized ΔE improved from 30.23 to
+  29.96, every fixture held or improved, and the slowest 8-filament Auto run was
+  331 ms.
 
 Risk: medium-high (largest behavioral change; biggest quality upside). UI: **no new
 dropdown entries** — `auto/exhaustive/simulated-annealing/genetic` keep their persisted
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 17d2569..a8dae08 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -681,9 +681,9 @@ export default function AutoPaintTab({
                                             <SelectItem
                                                 value="exhaustive"
                                                 className="text-xs"
-                                                disabled={filaments.length > 8}
+                                                disabled={filaments.length > 6}
                                             >
-                                                Exhaustive (≤8 filaments)
+                                                Exhaustive (≤6 filaments)
                                             </SelectItem>
                                             <SelectItem
                                                 value="simulated-annealing"
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 93b9f4b..e296561 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -128,7 +128,7 @@ export default function ThreeDControls({
     );
 
     useEffect(() => {
-        if (optimizerAlgorithm === 'exhaustive' && filaments.length > 8) {
+        if (optimizerAlgorithm === 'exhaustive' && filaments.length > 6) {
             setOptimizerAlgorithm('auto');
         }
     }, [filaments.length, optimizerAlgorithm]);
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index a19241e..a26e5ea 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -103,6 +103,11 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 | Seed (optional) | Overrides the automatic stable seed for an intentional comparison. |
 
 Use **Auto (smart selection)** unless you have a reason to compare algorithms.
+Auto uses exact ordered-subset search through 6 filaments, beam search from 7 to 12,
+then variable-length simulated annealing for larger profiles. With Enhanced color
+matching, Kromacut can omit filaments that do not improve the printable stack. When
+Repeated swaps is enabled, it can also add up to four non-adjacent repeated filament
+occurrences when they improve the blend path.
 
 **Region priority** changes which source colors the optimizer values most: **Center-weighted** gives more importance to colors that occur near the middle of the image, while **Edge-weighted** favors colors nearer its outer edges. It does not crop or change the image itself.
 
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index d28f53c..689249f 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -206,11 +206,6 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         debounceTimerRef.current = setTimeout(() => {
             try {
                 const worker = getWorker();
-                const algorithm =
-                    optimizerAlgorithm === 'exhaustive' && stableFilaments.length > 8
-                        ? 'auto'
-                        : optimizerAlgorithm;
-
                 const request: AutoPaintWorkerRequest = {
                     id,
                     filaments: stableFilaments,
@@ -221,7 +216,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
                     enhancedColorMatch,
                     allowRepeatedSwaps,
                     optimizerOptions: {
-                        algorithm,
+                        algorithm: optimizerAlgorithm,
                         ...(optimizerSeed !== undefined && { seed: optimizerSeed }),
                     },
                 };
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 8cc930c..36000da 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -571,39 +571,6 @@ export function clusterImageColors(
 // ENHANCED COLOR MATCHING — ORDERING OPTIMIZATION
 // =============================================================================
 
-/**
- * Generate all non-empty subsets of an array.
- * For N items, produces 2^N - 1 subsets.
- */
-function nonEmptySubsets<T>(arr: T[]): T[][] {
-    const result: T[][] = [];
-    const n = arr.length;
-    for (let mask = 1; mask < 1 << n; mask++) {
-        const subset: T[] = [];
-        for (let i = 0; i < n; i++) {
-            if (mask & (1 << i)) subset.push(arr[i]);
-        }
-        result.push(subset);
-    }
-    return result;
-}
-
-/**
- * Generate all permutations of an array.
- * Only used when array.length <= 7 (5040 permutations max).
- */
-function permutations<T>(arr: T[]): T[][] {
-    if (arr.length <= 1) return [arr];
-    const result: T[][] = [];
-    for (let i = 0; i < arr.length; i++) {
-        const rest = [...arr.slice(0, i), ...arr.slice(i + 1)];
-        for (const perm of permutations(rest)) {
-            result.push([arr[i], ...perm]);
-        }
-    }
-    return result;
-}
-
 /**
  * Build the achievable color palette for a given filament sequence.
  *
@@ -839,15 +806,9 @@ export function scoreSequenceAgainstImage(
 /**
  * Find the best filament ordering for the image colors.
  *
- * If optimizer options are provided, uses the advanced optimizer (simulated annealing, genetic algorithm).
- * Otherwise, falls back to legacy exhaustive/greedy search.
- *
- * NOT all filaments need to be used — the algorithm evaluates subsets
- * and only includes filaments that improve color reproduction.
- *
- * For ≤6 filaments, tries all permutations of all non-empty subsets.
- * For >6 filaments, uses a greedy build that adds one filament at a time
- * and stops when no further addition improves the score.
+ * Uses the variable-length optimizer for every enhanced-color run. It may
+ * omit unhelpful filaments and, when enabled, repeat a filament to create
+ * a useful extra color transition.
  *
  * @returns Optimal filament ordering (may be a subset of the input) and optimizer result
  */
@@ -857,38 +818,26 @@ function findBestFilamentOrder(
     layerHeight: number,
     firstLayerHeight: number,
     optimizerOptions?: Partial<OptimizerOptions>,
-    maxHeight?: number
+    maxHeight?: number,
+    allowRepeatedSwaps: boolean = false
 ): { sortedFilaments: Filament[]; result?: OptimizerResult } {
     if (filaments.length <= 1) {
         return { sortedFilaments: [...filaments] };
     }
 
-    // Use advanced optimizer if options provided
-    if (optimizerOptions) {
-        return findBestFilamentOrderWithOptimizer(
-            filaments,
-            imageSwatches,
-            layerHeight,
-            firstLayerHeight,
-            optimizerOptions,
-            maxHeight
-        );
-    }
-
-    // Legacy implementation
-    return {
-        sortedFilaments: findBestFilamentOrderLegacy(
-            filaments,
-            imageSwatches,
-            layerHeight,
-            firstLayerHeight,
-            maxHeight
-        ),
-    };
+    return findBestFilamentOrderWithOptimizer(
+        filaments,
+        imageSwatches,
+        layerHeight,
+        firstLayerHeight,
+        optimizerOptions ?? {},
+        maxHeight,
+        allowRepeatedSwaps
+    );
 }
 
 /**
- * Advanced optimizer path using simulated annealing / genetic algorithm
+ * Advanced optimizer path using the shared variable-length sequence search.
  */
 function findBestFilamentOrderWithOptimizer(
     filaments: Filament[],
@@ -896,7 +845,8 @@ function findBestFilamentOrderWithOptimizer(
     layerHeight: number,
     firstLayerHeight: number,
     optimizerOptions: Partial<OptimizerOptions>,
-    maxHeight?: number
+    maxHeight?: number,
+    allowRepeatedSwaps: boolean = false
 ): { sortedFilaments: Filament[]; result: OptimizerResult } {
     // Spatial weighting has already been folded into swatch counts by the caller.
     const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
@@ -916,7 +866,10 @@ function findBestFilamentOrderWithOptimizer(
     }));
 
     // Run optimizer
-    const result = optimizeFilamentOrder(scaledFilaments, context, optimizerOptions);
+    const result = optimizeFilamentOrder(scaledFilaments, context, {
+        ...optimizerOptions,
+        allowRepeatedSwaps,
+    });
 
     // Map back to original filaments (unscaled TDs)
     const sortedFilaments = result.order.map((sf) =>
@@ -926,244 +879,6 @@ function findBestFilamentOrderWithOptimizer(
     return { sortedFilaments, result };
 }
 
-/**
- * Legacy optimizer path (exhaustive for ≤6, greedy for >6)
- */
-function findBestFilamentOrderLegacy(
-    filaments: Filament[],
-    imageSwatches: Array<{ hex: string; count?: number }>,
-    layerHeight: number,
-    firstLayerHeight: number,
-    maxHeight?: number
-): Filament[] {
-    if (filaments.length <= 1) return [...filaments];
-
-    // Cluster image colors into weighted representative targets
-    const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
-    if (imageTargets.length === 0) return [...filaments];
-
-    // Apply frontlit TD scale
-    const scaledFilaments = filaments.map((f) => ({
-        ...f,
-        td: f.td * FRONTLIT_TD_SCALE,
-    }));
-
-    if (filaments.length <= 6) {
-        // Exhaustive search — try all permutations of all non-empty subsets
-        // For N=6: sum of k! * C(6,k) for k=1..6 = 1957 total permutations
-        const subsets = nonEmptySubsets(scaledFilaments);
-        let bestScore = Infinity;
-        let bestPerm = scaledFilaments;
-
-        for (const subset of subsets) {
-            const perms = permutations(subset);
-            for (const perm of perms) {
-                const palette = buildAchievableColorPalette(
-                    perm,
-                    layerHeight,
-                    firstLayerHeight,
-                    maxHeight
-                );
-                const score = scoreSequenceAgainstImage(palette, imageTargets);
-                if (score < bestScore) {
-                    bestScore = score;
-                    bestPerm = perm;
-                }
-            }
-        }
-
-        // Return the original filaments in the best ordering (unscaled TDs)
-        return bestPerm.map((sf) => filaments.find((f) => f.id === sf.id)!);
-    }
-
-    // Greedy heuristic for large sets:
-    // Build the sequence one filament at a time, stopping when no addition helps.
-    // Try each filament as a possible starting point.
-    const allStarts = scaledFilaments.map((f, idx) => ({ f, idx }));
-    let globalBestSequence: typeof scaledFilaments = [];
-    let globalBestScore = Infinity;
-
-    for (const { f: startFilament } of allStarts) {
-        const remaining = scaledFilaments.filter((sf) => sf.id !== startFilament.id);
-        const sequence = [startFilament];
-
-        let palette = buildAchievableColorPalette(
-            sequence,
-            layerHeight,
-            firstLayerHeight,
-            maxHeight
-        );
-        let currentScore = scoreSequenceAgainstImage(palette, imageTargets);
-        const pool = [...remaining];
-
-        while (pool.length > 0) {
-            let bestIdx = -1;
-            let bestScore = currentScore;
-
-            for (let i = 0; i < pool.length; i++) {
-                const candidate = [...sequence, pool[i]];
-                const candidatePalette = buildAchievableColorPalette(
-                    candidate,
-                    layerHeight,
-                    firstLayerHeight,
-                    maxHeight
-                );
-                const candidateScore = scoreSequenceAgainstImage(candidatePalette, imageTargets);
-                if (candidateScore < bestScore) {
-                    bestScore = candidateScore;
-                    bestIdx = i;
-                }
-            }
-
-            // Stop if no filament improves the score
-            if (bestIdx < 0 || currentScore - bestScore < 0.5) break;
-
-            sequence.push(pool.splice(bestIdx, 1)[0]);
-            palette = buildAchievableColorPalette(
-                sequence,
-                layerHeight,
-                firstLayerHeight,
-                maxHeight
-            );
-            currentScore = bestScore;
-        }
-
-        if (currentScore < globalBestScore) {
-            globalBestScore = currentScore;
-            globalBestSequence = [...sequence];
-        }
-    }
-
-    return globalBestSequence.map((sf) => filaments.find((f) => f.id === sf.id)!);
-}
-
-// =============================================================================
-// REPEATED SWAPS — SEQUENCE EXPANSION
-// =============================================================================
-
-/**
- * Build an expanded filament sequence that allows filaments to repeat.
- *
- * Uses a greedy approach: starting from the base ordering, repeatedly
- * tries inserting each available filament at the top of the stack.
- * Stops when no insertion improves the palette coverage, or when
- * a maximum sequence length is reached.
- *
- * Note: candidates are drawn from ALL original filaments, not just those
- * in the base ordering — a filament omitted from the base ordering might
- * still be useful as a blending layer.
- *
- * @param baseFilaments - The initial filament ordering (already optimized, may be a subset)
- * @param allFilaments - The full set of available filaments
- * @param imageSwatches - Target colors from the image
- * @param layerHeight - Physical layer height
- * @param firstLayerHeight - First layer height
- * @returns Expanded filament sequence with potential repeats
- */
-function buildRepeatedSwapSequence(
-    baseFilaments: Filament[],
-    allFilaments: Filament[],
-    imageSwatches: Array<{ hex: string; count?: number }>,
-    layerHeight: number,
-    firstLayerHeight: number,
-    maxHeight?: number
-): Filament[] {
-    if (baseFilaments.length === 0) return [];
-
-    // Cluster image colors into weighted representative targets
-    const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
-    if (imageTargets.length === 0) return [...baseFilaments];
-
-    // Start with the base sequence
-    let currentSequence = baseFilaments.map((f) => ({
-        ...f,
-        td: f.td * FRONTLIT_TD_SCALE,
-    }));
-
-    let currentPalette = buildAchievableColorPalette(
-        currentSequence,
-        layerHeight,
-        firstLayerHeight,
-        maxHeight
-    );
-    let currentScore = scoreSequenceAgainstImage(currentPalette, imageTargets);
-
-    // Use ALL filaments as insertion candidates (scaled)
-    const candidates = allFilaments.map((f) => ({
-        ...f,
-        td: f.td * FRONTLIT_TD_SCALE,
-    }));
-
-    // Maximum number of extra swaps to try (avoid runaway sequences)
-    const MAX_EXTRA_SWAPS = Math.min(4, allFilaments.length);
-    // Minimum improvement threshold — stop if gains are diminishing
-    // The scorer is normalized by target weight, so this is a fractional delta.
-    const MIN_IMPROVEMENT = 0.001;
-
-    for (let iter = 0; iter < MAX_EXTRA_SWAPS; iter++) {
-        let bestCandidate: (typeof candidates)[0] | null = null;
-        let bestInsertPos = -1;
-        let bestScore = currentScore;
-
-        for (const candidate of candidates) {
-            // Try inserting at every position in the sequence (not just append).
-            // Inserting earlier lets later filaments blend on top naturally,
-            // potentially reusing existing transitions rather than creating
-            // expensive new ones.
-            // Position 0 = new foundation, position len = append at top.
-            // Skip if it would create consecutive identical filaments.
-            for (let pos = 1; pos <= currentSequence.length; pos++) {
-                // Skip consecutive duplicates
-                if (pos > 0 && currentSequence[pos - 1].id === candidate.id) continue;
-                if (pos < currentSequence.length && currentSequence[pos].id === candidate.id)
-                    continue;
-
-                const trial = [
-                    ...currentSequence.slice(0, pos),
-                    candidate,
-                    ...currentSequence.slice(pos),
-                ];
-                const trialPalette = buildAchievableColorPalette(
-                    trial,
-                    layerHeight,
-                    firstLayerHeight,
-                    maxHeight
-                );
-                const trialScore = scoreSequenceAgainstImage(trialPalette, imageTargets);
-
-                if (trialScore < bestScore) {
-                    bestScore = trialScore;
-                    bestCandidate = candidate;
-                    bestInsertPos = pos;
-                }
-            }
-        }
-
-        if (!bestCandidate || bestInsertPos < 0 || currentScore - bestScore < MIN_IMPROVEMENT) {
-            break; // No meaningful improvement
-        }
-
-        currentSequence = [
-            ...currentSequence.slice(0, bestInsertPos),
-            bestCandidate,
-            ...currentSequence.slice(bestInsertPos),
-        ];
-        currentPalette = buildAchievableColorPalette(
-            currentSequence,
-            layerHeight,
-            firstLayerHeight,
-            maxHeight
-        );
-        currentScore = bestScore;
-    }
-
-    // Map back to original (unscaled) filaments, preserving sequence with repeats
-    return currentSequence.map((sf) => {
-        const orig = allFilaments.find((f) => f.id === sf.id)!;
-        return { ...orig }; // Return copies with original TD
-    });
-}
-
 // =============================================================================
 // MAIN AUTO-PAINT ALGORITHM
 // =============================================================================
@@ -1246,23 +961,13 @@ export function generateAutoLayers(
             layerHeight,
             firstLayerHeight,
             optimizerOptions,
-            maxHeight
+            maxHeight,
+            allowRepeatedSwaps
         );
 
         sortedFilaments = orderingResult.sortedFilaments;
         optimizerResult = orderingResult.result;
 
-        // If repeated swaps are also enabled, expand the sequence
-        if (allowRepeatedSwaps) {
-            sortedFilaments = buildRepeatedSwapSequence(
-                sortedFilaments,
-                filaments,
-                imageSwatches,
-                layerHeight,
-                firstLayerHeight,
-                maxHeight
-            );
-        }
     } else {
         // Standard: sort by luminance (dark to light)
         sortedFilaments = [...filaments].sort((a, b) => {
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index fdc8cc2..904d2c0 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -1,10 +1,11 @@
 /**
  * Advanced Filament Order Optimizer
  *
- * Implements sophisticated optimization algorithms to find the best filament ordering
- * for multi-material lithophanes. Supports:
- * - Simulated Annealing: Probabilistic global optimization with temperature scheduling
- * - Genetic Algorithm: Population-based evolutionary optimization
+ * Finds the best printable filament sequence for multi-material lithophanes.
+ * Supports:
+ * - Exhaustive ordered-subset search for small profiles
+ * - Beam search for medium profiles
+ * - Variable-length simulated annealing for large profiles
  * - Deterministic Seeding: Reproducible results for A/B testing
  * - Result Caching: Skip redundant computations
  */
@@ -22,13 +23,15 @@ import {
 
 export interface OptimizerOptions {
     algorithm: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
+    allowRepeatedSwaps?: boolean;
     seed?: number; // For deterministic results
     maxIterations?: number; // Algorithm-specific iteration limit
     temperature?: number; // Initial temperature for SA
     coolingRate?: number; // Temperature decay for SA
-    populationSize?: number; // Population size for GA
-    mutationRate?: number; // Mutation probability for GA
-    eliteCount?: number; // Number of elite individuals to preserve in GA
+    populationSize?: number; // Retained for persisted optimizer compatibility
+    mutationRate?: number; // Retained for persisted optimizer compatibility
+    eliteCount?: number; // Retained for persisted optimizer compatibility
+    beamWidth?: number; // Number of partial stacks kept by beam search
     cachingEnabled?: boolean; // Enable result caching
 }
 
@@ -120,12 +123,14 @@ const globalCache = new OptimizerCache();
 
 function tuningFingerprint(options: OptimizerOptions) {
     return {
+        allowRepeatedSwaps: options.allowRepeatedSwaps ?? false,
         maxIterations: options.maxIterations ?? null,
         temperature: options.temperature ?? null,
         coolingRate: options.coolingRate ?? null,
         populationSize: options.populationSize ?? null,
         mutationRate: options.mutationRate ?? null,
         eliteCount: options.eliteCount ?? null,
+        beamWidth: options.beamWidth ?? null,
     };
 }
 
@@ -196,12 +201,104 @@ export function scoreFilamentSequence(filaments: Filament[], context: ScoringCon
 }
 
 // ============================================================================
-// Exhaustive Search (Optimal but slow for >8 filaments)
+// Variable-length sequence helpers
+// ============================================================================
+
+const MAX_EXHAUSTIVE_FILAMENTS = 6;
+const AUTO_BEAM_MAX_FILAMENTS = 12;
+const MAX_EXTRA_REPEATS = 4;
+const DEFAULT_BEAM_WIDTH = 100;
+
+type SequenceScorer = (filaments: Filament[]) => number;
+type ResolvedOptimizerAlgorithm =
+    | 'exhaustive'
+    | 'beam'
+    | 'simulated-annealing'
+    | 'genetic';
+
+interface ScoredSequence {
+    order: Filament[];
+    score: number;
+}
+
+function sequenceKey(sequence: Filament[]): string {
+    return sequence.map((filament) => filament.id).join('|');
+}
+
+function hasConsecutiveDuplicates(sequence: Filament[]): boolean {
+    return sequence.some((filament, index) => index > 0 && filament.id === sequence[index - 1].id);
+}
+
+function hasDuplicateIds(sequence: Filament[]): boolean {
+    return new Set(sequence.map((filament) => filament.id)).size !== sequence.length;
+}
+
+function isValidSequence(sequence: Filament[], allowRepeatedSwaps: boolean): boolean {
+    return (
+        sequence.length > 0 &&
+        !hasConsecutiveDuplicates(sequence) &&
+        (allowRepeatedSwaps || !hasDuplicateIds(sequence))
+    );
+}
+
+function maxSequenceLength(filaments: Filament[], allowRepeatedSwaps: boolean): number {
+    return filaments.length + (allowRepeatedSwaps ? MAX_EXTRA_REPEATS : 0);
+}
+
+function isBetterCandidate(
+    candidate: ScoredSequence,
+    current: ScoredSequence | null
+): boolean {
+    if (!current) return true;
+    if (candidate.score !== current.score) return candidate.score < current.score;
+    return sequenceKey(candidate.order) < sequenceKey(current.order);
+}
+
+function expandWithRepeatedFilaments(
+    initial: ScoredSequence,
+    filaments: Filament[],
+    scoreSequence: SequenceScorer
+): { best: ScoredSequence; iterations: number } {
+    const maxLength = maxSequenceLength(filaments, true);
+    let best = initial;
+    let iterations = 0;
+
+    while (best.order.length < maxLength) {
+        let next: ScoredSequence | null = null;
+
+        for (const filament of filaments) {
+            for (let position = 0; position <= best.order.length; position++) {
+                const candidateOrder = [
+                    ...best.order.slice(0, position),
+                    filament,
+                    ...best.order.slice(position),
+                ];
+                if (!isValidSequence(candidateOrder, true)) continue;
+
+                const candidate = {
+                    order: candidateOrder,
+                    score: scoreSequence(candidateOrder),
+                };
+                iterations++;
+                if (isBetterCandidate(candidate, next)) next = candidate;
+            }
+        }
+
+        if (!next || next.score >= best.score) break;
+        best = next;
+    }
+
+    return { best, iterations };
+}
+
+// ============================================================================
+// Exhaustive Search (all ordered non-empty subsets, up to six filaments)
 // ============================================================================
 
 function optimizeExhaustive(
     filaments: Filament[],
-    scoreSequence: (filaments: Filament[]) => number
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
 ): OptimizerResult {
     if (filaments.length === 0) {
         return {
@@ -212,43 +309,115 @@ function optimizeExhaustive(
         };
     }
 
-    if (filaments.length === 1) {
+    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    let best: ScoredSequence | null = null;
+    let iterations = 0;
+
+    const visit = (sequence: Filament[], remaining: Filament[]): void => {
+        if (sequence.length > 0) {
+            const candidate = { order: sequence, score: scoreSequence(sequence) };
+            iterations++;
+            if (isBetterCandidate(candidate, best)) best = candidate;
+        }
+
+        for (let index = 0; index < remaining.length; index++) {
+            visit(
+                [...sequence, remaining[index]],
+                [...remaining.slice(0, index), ...remaining.slice(index + 1)]
+            );
+        }
+    };
+
+    visit([], filaments);
+    const baseBest = best ?? { order: [filaments[0]], score: scoreSequence([filaments[0]]) };
+
+    if (!allowRepeatedSwaps) {
         return {
-            order: [filaments[0]],
-            score: scoreSequence(filaments),
-            iterations: 1,
+            order: baseBest.order,
+            score: baseBest.score,
+            iterations,
             converged: true,
         };
     }
 
-    let bestOrder = filaments;
-    let bestScore = scoreSequence(filaments);
+    const expanded = expandWithRepeatedFilaments(baseBest, filaments, scoreSequence);
+    return {
+        order: expanded.best.order,
+        score: expanded.best.score,
+        iterations: iterations + expanded.iterations,
+        converged: true,
+    };
+}
+
+// ============================================================================
+// Beam Search (deterministic variable-length search for medium profiles)
+// ============================================================================
+
+function optimizeBeamSearch(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    if (filaments.length <= 1) {
+        return optimizeExhaustive(filaments, scoreSequence, options);
+    }
+
+    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const beamWidth = options.beamWidth ?? DEFAULT_BEAM_WIDTH;
     let iterations = 0;
+    let best: ScoredSequence | null = null;
 
-    // Generate all permutations
-    const permute = (arr: Filament[], start = 0): void => {
-        if (start === arr.length - 1) {
-            iterations++;
-            const score = scoreSequence(arr);
-            if (score < bestScore) {
-                bestScore = score;
-                bestOrder = [...arr];
+    let beam = filaments.map((filament) => {
+        const candidate = { order: [filament], score: scoreSequence([filament]) };
+        iterations++;
+        if (isBetterCandidate(candidate, best)) best = candidate;
+        return candidate;
+    });
+    beam.sort((left, right) =>
+        left.score === right.score
+            ? sequenceKey(left.order).localeCompare(sequenceKey(right.order))
+            : left.score - right.score
+    );
+    beam = beam.slice(0, beamWidth);
+
+    for (let depth = 1; depth < maximumLength && beam.length > 0; depth++) {
+        const candidates = new Map<string, ScoredSequence>();
+
+        for (const state of beam) {
+            for (const filament of filaments) {
+                if (state.order.at(-1)?.id === filament.id) continue;
+                if (
+                    !allowRepeatedSwaps &&
+                    state.order.some((existing) => existing.id === filament.id)
+                ) {
+                    continue;
+                }
+
+                const order = [...state.order, filament];
+                const key = sequenceKey(order);
+                if (candidates.has(key)) continue;
+
+                const candidate = { order, score: scoreSequence(order) };
+                candidates.set(key, candidate);
+                iterations++;
+                if (isBetterCandidate(candidate, best)) best = candidate;
             }
-            return;
         }
 
-        for (let i = start; i < arr.length; i++) {
-            [arr[start], arr[i]] = [arr[i], arr[start]];
-            permute(arr, start + 1);
-            [arr[start], arr[i]] = [arr[i], arr[start]];
-        }
-    };
-
-    permute([...filaments]);
+        beam = [...candidates.values()]
+            .sort((left, right) =>
+                left.score === right.score
+                    ? sequenceKey(left.order).localeCompare(sequenceKey(right.order))
+                    : left.score - right.score
+            )
+            .slice(0, beamWidth);
+    }
 
+    const bestSequence = best ?? { order: [filaments[0]], score: scoreSequence([filaments[0]]) };
     return {
-        order: bestOrder,
-        score: bestScore,
+        order: bestSequence.order,
+        score: bestSequence.score,
         iterations,
         converged: true,
     };
@@ -264,22 +433,106 @@ function optimizeExhaustive(
  * SA is a probabilistic technique that can escape local minima by accepting
  * worse solutions with probability exp(-ΔE/T), where T decreases over time.
  */
+function randomInitialSequence(
+    filaments: Filament[],
+    allowRepeatedSwaps: boolean,
+    rng: SeededRandom
+): Filament[] {
+    const shuffled = rng.shuffle(filaments);
+    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const initialLength = rng.nextInt(1, Math.min(filaments.length, maximumLength) + 1);
+    return shuffled.slice(0, initialLength);
+}
+
+function sequenceEquals(left: Filament[], right: Filament[]): boolean {
+    return (
+        left.length === right.length &&
+        left.every((filament, index) => filament.id === right[index].id)
+    );
+}
+
+function buildVariableLengthNeighbor(
+    sequence: Filament[],
+    filaments: Filament[],
+    allowRepeatedSwaps: boolean,
+    rng: SeededRandom
+): Filament[] {
+    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const availableMoves: Array<'swap' | 'relocate' | 'insert' | 'remove' | 'replace'> = [];
+
+    if (sequence.length > 1) {
+        availableMoves.push('swap', 'relocate', 'remove');
+    }
+    if (sequence.length < maximumLength) availableMoves.push('insert');
+    availableMoves.push('replace');
+
+    for (let attempt = 0; attempt < 12; attempt++) {
+        const move = availableMoves[rng.nextInt(0, availableMoves.length)];
+        const candidate = [...sequence];
+
+        if (move === 'swap' && candidate.length > 1) {
+            const first = rng.nextInt(0, candidate.length);
+            let second = rng.nextInt(0, candidate.length - 1);
+            if (second >= first) second++;
+            [candidate[first], candidate[second]] = [candidate[second], candidate[first]];
+        } else if (move === 'relocate' && candidate.length > 1) {
+            const from = rng.nextInt(0, candidate.length);
+            const [moved] = candidate.splice(from, 1);
+            candidate.splice(rng.nextInt(0, candidate.length + 1), 0, moved);
+        } else if (move === 'insert' && candidate.length < maximumLength) {
+            const eligible = allowRepeatedSwaps
+                ? filaments
+                : filaments.filter(
+                      (filament) => !candidate.some((existing) => existing.id === filament.id)
+                  );
+            if (eligible.length === 0) continue;
+            candidate.splice(
+                rng.nextInt(0, candidate.length + 1),
+                0,
+                eligible[rng.nextInt(0, eligible.length)]
+            );
+        } else if (move === 'remove' && candidate.length > 1) {
+            candidate.splice(rng.nextInt(0, candidate.length), 1);
+        } else if (move === 'replace') {
+            const position = rng.nextInt(0, candidate.length);
+            const eligible = filaments.filter((filament) => {
+                if (filament.id === candidate[position].id) return false;
+                return (
+                    allowRepeatedSwaps ||
+                    !candidate.some(
+                        (existing, index) => index !== position && existing.id === filament.id
+                    )
+                );
+            });
+            if (eligible.length === 0) continue;
+            candidate[position] = eligible[rng.nextInt(0, eligible.length)];
+        }
+
+        if (isValidSequence(candidate, allowRepeatedSwaps) && !sequenceEquals(candidate, sequence)) {
+            return candidate;
+        }
+    }
+
+    return sequence;
+}
+
 function optimizeSimulatedAnnealing(
     filaments: Filament[],
-    scoreSequence: (filaments: Filament[]) => number,
+    scoreSequence: SequenceScorer,
     options: OptimizerOptions
 ): OptimizerResult {
     if (filaments.length <= 1) {
-        return optimizeExhaustive(filaments, scoreSequence);
+        return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
+    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
     const rng = new SeededRandom(options.seed);
     const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
     const initialTemp = options.temperature ?? 10.0;
     const coolingRate = options.coolingRate ?? 0.995;
     const minTemp = 0.01;
 
-    let currentOrder = rng.shuffle(filaments);
+    let currentOrder = randomInitialSequence(filaments, allowRepeatedSwaps, rng);
     let currentScore = scoreSequence(currentOrder);
     let bestOrder = [...currentOrder];
     let bestScore = currentScore;
@@ -289,12 +542,16 @@ function optimizeSimulatedAnnealing(
     while (iterations < maxIterations && temperature > minTemp) {
         iterations++;
 
-        // Generate neighbor by swapping two random filaments
-        const newOrder = [...currentOrder];
-        const i = rng.nextInt(0, newOrder.length);
-        let j = rng.nextInt(0, newOrder.length - 1);
-        if (j >= i) j++;
-        [newOrder[i], newOrder[j]] = [newOrder[j], newOrder[i]];
+        const newOrder = buildVariableLengthNeighbor(
+            currentOrder,
+            filaments,
+            allowRepeatedSwaps,
+            rng
+        );
+        if (sequenceEquals(newOrder, currentOrder)) {
+            temperature *= coolingRate;
+            continue;
+        }
 
         const newScore = scoreSequence(newOrder);
         const deltaE = newScore - currentScore;
@@ -327,139 +584,42 @@ function optimizeSimulatedAnnealing(
 }
 
 // ============================================================================
-// Genetic Algorithm (Great for large search spaces)
+// Genetic compatibility route
 // ============================================================================
 
 /**
- * Genetic Algorithm optimizer with elitism and tournament selection.
- *
- * Maintains a population of candidate solutions, evolves them through
- * selection, crossover, and mutation.
+ * The persisted Genetic option currently routes to the variable-length
+ * annealer. Fixed-length crossover cannot represent subset or repeat moves.
  */
 function optimizeGenetic(
     filaments: Filament[],
-    scoreSequence: (filaments: Filament[]) => number,
+    scoreSequence: SequenceScorer,
     options: OptimizerOptions
 ): OptimizerResult {
-    if (filaments.length <= 1) {
-        return optimizeExhaustive(filaments, scoreSequence);
-    }
-
-    const rng = new SeededRandom(options.seed);
-    const populationSize = options.populationSize ?? Math.max(50, filaments.length * 10);
-    const maxGenerations = options.maxIterations ?? 100;
-    const mutationRate = options.mutationRate ?? 0.1;
-    const eliteCount = options.eliteCount ?? Math.max(2, Math.floor(populationSize * 0.1));
-
-    // Initialize population with random orderings
-    let population: Array<{ order: Filament[]; score: number }> = [];
-    for (let i = 0; i < populationSize; i++) {
-        const order = rng.shuffle(filaments);
-        const score = scoreSequence(order);
-        population.push({ order, score });
-    }
-
-    let bestEver = { ...population[0] };
-    let generations = 0;
-    let stagnantGenerations = 0;
-    const maxStagnant = 20;
-
-    while (generations < maxGenerations && stagnantGenerations < maxStagnant) {
-        generations++;
-
-        // Sort by score (lower is better)
-        population.sort((a, b) => a.score - b.score);
-
-        // Check for improvement
-        if (population[0].score < bestEver.score) {
-            bestEver = { order: [...population[0].order], score: population[0].score };
-            stagnantGenerations = 0;
-        } else {
-            stagnantGenerations++;
-        }
-
-        // Elitism: preserve best individuals
-        const nextGeneration = population.slice(0, eliteCount).map((ind) => ({
-            order: [...ind.order],
-            score: ind.score,
-        }));
-
-        // Generate offspring
-        while (nextGeneration.length < populationSize) {
-            // Tournament selection: pick 3 random, choose best
-            const parent1 = tournamentSelect(population, 3, rng);
-            const parent2 = tournamentSelect(population, 3, rng);
-
-            // Order crossover (OX)
-            const child = orderCrossover(parent1.order, parent2.order, rng);
-
-            // Mutation: swap two positions with probability
-            if (rng.next() < mutationRate) {
-                const i = rng.nextInt(0, child.length);
-                const j = rng.nextInt(0, child.length);
-                [child[i], child[j]] = [child[j], child[i]];
-            }
-
-            const score = scoreSequence(child);
-            nextGeneration.push({ order: child, score });
-        }
-
-        population = nextGeneration;
-    }
-
-    return {
-        order: bestEver.order,
-        score: bestEver.score,
-        iterations: generations,
-        converged: stagnantGenerations >= maxStagnant,
-    };
-}
-
-/**
- * Tournament selection: pick k random individuals, return best one
- */
-function tournamentSelect(
-    population: Array<{ order: Filament[]; score: number }>,
-    tournamentSize: number,
-    rng: SeededRandom
-): { order: Filament[]; score: number } {
-    let best = population[rng.nextInt(0, population.length)];
-
-    for (let i = 1; i < tournamentSize; i++) {
-        const candidate = population[rng.nextInt(0, population.length)];
-        if (candidate.score < best.score) {
-            best = candidate;
-        }
-    }
-
-    return { order: [...best.order], score: best.score };
+    // Genetic crossover assumes a fixed permutation. Until a variable-length
+    // crossover proves competitive, keep the persisted UI choice but route it
+    // through the variable-length annealer with a slightly larger budget.
+    return optimizeSimulatedAnnealing(filaments, scoreSequence, {
+        ...options,
+        maxIterations: options.maxIterations ?? Math.max(1500, filaments.length * 150),
+    });
 }
 
-/**
- * Order crossover (OX): preserves relative order from both parents
- */
-function orderCrossover(parent1: Filament[], parent2: Filament[], rng: SeededRandom): Filament[] {
-    const length = parent1.length;
-    const start = rng.nextInt(0, length);
-    const end = rng.nextInt(start + 1, length + 1);
-
-    // Copy segment from parent1
-    const child: (Filament | null)[] = new Array(length).fill(null);
-    for (let i = start; i < end; i++) {
-        child[i] = parent1[i];
+function resolveAlgorithm(
+    requested: OptimizerOptions['algorithm'],
+    filamentCount: number
+): ResolvedOptimizerAlgorithm {
+    if (requested === 'auto') {
+        if (filamentCount <= MAX_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
+        if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
+        return 'simulated-annealing';
     }
 
-    // Fill remaining from parent2, preserving order
-    const remaining = parent2.filter((f) => !child.includes(f));
-    let remainingIdx = 0;
-
-    for (let i = 0; i < length; i++) {
-        if (child[i] === null) {
-            child[i] = remaining[remainingIdx++];
-        }
+    if (requested === 'exhaustive' && filamentCount > MAX_EXHAUSTIVE_FILAMENTS) {
+        return filamentCount <= AUTO_BEAM_MAX_FILAMENTS ? 'beam' : 'simulated-annealing';
     }
 
-    return child as Filament[];
+    return requested;
 }
 
 // ============================================================================
@@ -485,17 +645,7 @@ export function optimizeFilamentOrder(
         ...options,
     };
 
-    // Auto-select algorithm based on problem size (before cache check)
-    let algorithm = opts.algorithm;
-    if (algorithm === 'auto') {
-        if (filaments.length <= 6) {
-            algorithm = 'exhaustive';
-        } else if (filaments.length <= 10) {
-            algorithm = 'simulated-annealing';
-        } else {
-            algorithm = 'genetic';
-        }
-    }
+    const algorithm = resolveAlgorithm(opts.algorithm, filaments.length);
 
     const defaultSeedInput = canonicalOptimizerInput(filaments, context, algorithm, opts);
     const seed = opts.seed ?? stableHash32(defaultSeedInput);
@@ -514,7 +664,10 @@ export function optimizeFilamentOrder(
 
     switch (algorithm) {
         case 'exhaustive':
-            result = optimizeExhaustive(filaments, scoreSequence);
+            result = optimizeExhaustive(filaments, scoreSequence, opts);
+            break;
+        case 'beam':
+            result = optimizeBeamSearch(filaments, scoreSequence, opts);
             break;
         case 'simulated-annealing':
             result = optimizeSimulatedAnnealing(filaments, scoreSequence, opts);
@@ -527,7 +680,8 @@ export function optimizeFilamentOrder(
     }
 
     // Tag the result with the resolved algorithm
-    result.resolvedAlgorithm = algorithm;
+    result.resolvedAlgorithm =
+        algorithm === 'genetic' ? 'variable-length-sa' : algorithm;
 
     if (opts.cachingEnabled) {
         globalCache.set(cacheKey, result);
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 2ecbba8..ca837d7 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -673,154 +673,162 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "plvjtmc",
+      "vsn9q6u",
+      "98z555k",
+      "upcjpfe",
       "azwg1yp",
       "xyyxysq",
-      "w8cncoa",
-      "upcjpfe",
-      "p9c63ms",
-      "vsn9q6u",
-      "98z555k"
+      "w8cncoa"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "vsn9q6u",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.49400000000000005,
+        "idealThickness": 0.49400000000000005,
+        "actualThickness": 0.49400000000000005
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 0.49400000000000005,
+        "endHeight": 0.767,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.767,
+        "endHeight": 1.11,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.16,
-        "endHeight": 0.356,
+        "startHeight": 1.11,
+        "endHeight": 1.306,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.19599999999999998
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 0.356,
-        "endHeight": 0.713,
+        "startHeight": 1.306,
+        "endHeight": 1.663,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 0.713,
-        "endHeight": 1.154,
+        "startHeight": 1.663,
+        "endHeight": 2.104,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.154,
-        "endHeight": 1.4969999999999999,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
-      },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.4969999999999999,
-        "endHeight": 1.9169999999999998,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.9169999999999998,
-        "endHeight": 2.183,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 2.183,
-        "endHeight": 2.456,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
       }
     ],
-    "totalHeight": 2.456,
+    "totalHeight": 2.104,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "plvjtmc",
+      "98z555k",
+      "w8cncoa",
       "azwg1yp",
       "xyyxysq",
       "w8cncoa",
       "upcjpfe",
-      "p9c63ms",
-      "w8cncoa",
       "vsn9q6u",
-      "98z555k"
+      "98z555k",
+      "plvjtmc",
+      "azwg1yp",
+      "98z555k",
+      "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.507,
+        "idealThickness": 0.507,
+        "actualThickness": 0.507
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 0.507,
+        "endHeight": 0.948,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.44099999999999995
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.16,
-        "endHeight": 0.356,
+        "startHeight": 0.948,
+        "endHeight": 1.144,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.19599999999999998
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 0.356,
-        "endHeight": 0.713,
+        "startHeight": 1.144,
+        "endHeight": 1.501,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 0.713,
-        "endHeight": 1.154,
+        "startHeight": 1.501,
+        "endHeight": 1.9419999999999997,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 1.154,
-        "endHeight": 1.4969999999999999,
+        "startHeight": 1.9419999999999997,
+        "endHeight": 2.2849999999999997,
         "idealThickness": 0.343,
         "actualThickness": 0.343
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.4969999999999999,
-        "endHeight": 1.9169999999999998,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.2849999999999997,
+        "endHeight": 2.5509999999999997,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.9169999999999998,
-        "endHeight": 2.3579999999999997,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "filamentId": "98z555k",
+        "startHeight": 2.5509999999999997,
+        "endHeight": 2.824,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.27299999999999996
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.3579999999999997,
-        "endHeight": 2.6239999999999997,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "filamentId": "plvjtmc",
+        "startHeight": 2.824,
+        "endHeight": 2.904,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.904,
+        "endHeight": 3.1,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.19599999999999998
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.6239999999999997,
-        "endHeight": 2.897,
+        "startHeight": 3.1,
+        "endHeight": 3.373,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.27299999999999996
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 3.373,
+        "endHeight": 3.6390000000000002,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
       }
     ],
-    "totalHeight": 2.897,
+    "totalHeight": 3.6390000000000002,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -972,9 +980,7 @@
       "upcjpfe",
       "plvjtmc",
       "p9c63ms",
-      "azwg1yp",
       "w8cncoa",
-      "98z555k",
       "xyyxysq",
       "vsn9q6u"
     ],
@@ -1000,55 +1006,45 @@
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.42000000000000004
       },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 1.137,
-        "endHeight": 1.333,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
-      },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.333,
-        "endHeight": 1.774,
+        "startHeight": 1.137,
+        "endHeight": 1.5779999999999998,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.44099999999999995
       },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 1.774,
-        "endHeight": 2.047,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 2.047,
-        "endHeight": 2.404,
+        "startHeight": 1.5779999999999998,
+        "endHeight": 1.9349999999999998,
         "idealThickness": 0.357,
         "actualThickness": 0.357
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.404,
-        "endHeight": 2.67,
+        "startHeight": 1.9349999999999998,
+        "endHeight": 2.2009999999999996,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.26599999999999996
       }
     ],
-    "totalHeight": 2.67,
+    "totalHeight": 2.2009999999999996,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
       "vsn9q6u",
       "xyyxysq",
-      "w8cncoa",
       "upcjpfe",
-      "98z555k",
       "plvjtmc",
       "p9c63ms",
-      "azwg1yp"
+      "upcjpfe",
+      "98z555k",
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "plvjtmc",
+      "p9c63ms"
     ],
     "transitionZones": [
       {
@@ -1066,49 +1062,77 @@
         "actualThickness": 0.357
       },
       {
-        "filamentId": "w8cncoa",
+        "filamentId": "upcjpfe",
         "startHeight": 0.851,
-        "endHeight": 1.2919999999999998,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "endHeight": 1.194,
+        "idealThickness": 0.343,
+        "actualThickness": 0.343
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.194,
+        "endHeight": 1.274,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.274,
+        "endHeight": 1.694,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 1.2919999999999998,
-        "endHeight": 1.6349999999999998,
+        "startHeight": 1.694,
+        "endHeight": 2.037,
         "idealThickness": 0.343,
         "actualThickness": 0.343
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.6349999999999998,
-        "endHeight": 1.9079999999999997,
+        "startHeight": 2.037,
+        "endHeight": 2.31,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.27299999999999996
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.9079999999999997,
-        "endHeight": 1.9879999999999998,
+        "startHeight": 2.31,
+        "endHeight": 2.39,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.9879999999999998,
-        "endHeight": 2.408,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.408,
-        "endHeight": 2.604,
+        "startHeight": 2.39,
+        "endHeight": 2.5860000000000003,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.19599999999999998
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.5860000000000003,
+        "endHeight": 2.8520000000000003,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.26599999999999996
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 2.8520000000000003,
+        "endHeight": 2.9320000000000004,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 2.9320000000000004,
+        "endHeight": 3.3520000000000003,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.42000000000000004
       }
     ],
-    "totalHeight": 2.604,
+    "totalHeight": 3.3520000000000003,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 5153d65..8b97442 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -151,6 +151,46 @@ test('auto-paint slice data stays synchronized and uses print-layer heights', as
     );
 });
 
+test('enhanced repeated-swap search keeps the printable red-to-pink transition', async () => {
+    const { autoPaintToSliceHeights, generateAutoLayers, hexToRgb } =
+        await loadAutoPaintModule();
+    const layerHeight = 0.08;
+    const firstLayerHeight = 0.16;
+    const result = generateAutoLayers(
+        [
+            { id: 'red', color: '#ff0000', td: 1.2 },
+            { id: 'white', color: '#ffffff', td: 1.2 },
+        ],
+        [
+            { hex: '#ff0000', count: 20 },
+            { hex: '#ff8080', count: 80 },
+        ],
+        layerHeight,
+        firstLayerHeight,
+        undefined,
+        true,
+        true,
+        { algorithm: 'exhaustive', seed: 4 }
+    );
+    const slices = autoPaintToSliceHeights(result, layerHeight, firstLayerHeight);
+
+    assert.ok(
+        result.filamentOrder.includes('red') && result.filamentOrder.includes('white'),
+        'the optimized stack should include red under white'
+    );
+    assert.ok(
+        result.filamentOrder.every((id, index) => index === 0 || id !== result.filamentOrder[index - 1]),
+        'the optimizer must never emit adjacent duplicate swaps'
+    );
+    assert.ok(
+        slices.virtualSwatches.some((swatch) => {
+            const { r, g, b } = hexToRgb(swatch.hex);
+            return r > 180 && g > 40 && g < 220 && b > 40 && b < 220;
+        }),
+        'a thin white transition over red should produce a pink printable swatch'
+    );
+});
+
 test('auto-paint slice data never returns more than 500 layers', async () => {
     const { autoPaintToSliceHeights } = await loadAutoPaintModule();
     const tallResult = {
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 2fd634f..bf6c954 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -171,3 +171,116 @@ test('the shared scorer evaluates the compressed stack when Max Height is set',
     );
     assert.equal(result.score, scoreFilamentSequence(result.order, compressedContext));
 });
+
+test('exhaustive search evaluates ordered subsets and drops a strictly worse filament', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const candidates = [
+        { id: 'black', color: '#000000', td: 0.8 },
+        { id: 'white', color: '#ffffff', td: 1.2 },
+        { id: 'near-white', color: '#fefefe', td: 1.2 },
+    ];
+    const target = {
+        imageColors: [{ L: 100, a: 0, b: 0, weight: 1 }],
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+    };
+
+    const result = optimizeFilamentOrder(candidates, target, {
+        algorithm: 'exhaustive',
+        cachingEnabled: false,
+    });
+
+    assert.equal(result.iterations, 15, 'three filaments have 15 ordered non-empty subsets');
+    assert.deepEqual(result.order.map((filament) => filament.id), ['white']);
+});
+
+test('repeats can close the RGB color path to reach the missing magenta blend', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const primaries = [
+        { id: 'red', color: '#ff0000', td: 1.2 },
+        { id: 'green', color: '#00ff00', td: 1.2 },
+        { id: 'blue', color: '#0000ff', td: 1.2 },
+    ];
+    const spectrumTargets = {
+        imageColors: [
+            { L: 53, a: 80, b: 67, weight: 0.05 },
+            { L: 88, a: -86, b: 83, weight: 0.05 },
+            { L: 32, a: 79, b: -108, weight: 0.05 },
+            { L: 97, a: -22, b: 94, weight: 0.28 },
+            { L: 91, a: -48, b: -14, weight: 0.28 },
+            { L: 60, a: 98, b: -61, weight: 0.29 },
+        ],
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+    };
+
+    const result = optimizeFilamentOrder(primaries, spectrumTargets, {
+        algorithm: 'exhaustive',
+        allowRepeatedSwaps: true,
+        cachingEnabled: false,
+    });
+
+    const ids = result.order.map((filament) => filament.id);
+    assert.ok(
+        new Set(ids).size < ids.length,
+        'closing the RGB path should repeat one primary for the magenta transition'
+    );
+    assert.ok(
+        ids.every((id, index) => index === 0 || id !== ids[index - 1]),
+        'repeated stacks must not contain adjacent duplicate filaments'
+    );
+    assert.ok(ids.length <= primaries.length + 4);
+});
+
+test('variable-length optimizers preserve sequence safety invariants', async (t) => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+
+    for (const allowRepeatedSwaps of [false, true]) {
+        for (const algorithm of algorithms) {
+            await t.test(`${algorithm} / repeats=${allowRepeatedSwaps}`, () => {
+                const result = optimizeFilamentOrder(filaments, context, {
+                    algorithm,
+                    allowRepeatedSwaps,
+                    seed: 20260621,
+                    maxIterations: 40,
+                    cachingEnabled: false,
+                });
+                const ids = result.order.map((filament) => filament.id);
+
+                assert.ok(ids.length >= 1);
+                assert.ok(ids.length <= filaments.length + (allowRepeatedSwaps ? 4 : 0));
+                assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]));
+                if (!allowRepeatedSwaps) {
+                    assert.equal(new Set(ids).size, ids.length);
+                }
+            });
+        }
+    }
+});
+
+test('auto uses beam search for medium profiles and protects exhaustive search above six', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const mediumProfile = [
+        ...filaments,
+        { id: 'green', color: '#42a85f', td: 1.6 },
+        { id: 'yellow', color: '#e7cd38', td: 1.7 },
+        { id: 'purple', color: '#7545a8', td: 1.9 },
+    ];
+
+    const auto = optimizeFilamentOrder(mediumProfile, context, {
+        algorithm: 'auto',
+        seed: 7,
+        cachingEnabled: false,
+    });
+    const guardedExhaustive = optimizeFilamentOrder(mediumProfile, context, {
+        algorithm: 'exhaustive',
+        seed: 7,
+        cachingEnabled: false,
+    });
+
+    assert.equal(auto.resolvedAlgorithm, 'beam');
+    assert.equal(guardedExhaustive.resolvedAlgorithm, 'beam');
+    assert.ok(auto.order.length <= mediumProfile.length);
+    assert.equal(new Set(auto.order.map((filament) => filament.id)).size, auto.order.length);
+});

From d685832faffd1640c68b1af5d388083976a61cb4 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 17:00:54 +0300
Subject: [PATCH 11/81] Improve auto-paint progress and 3MF exports

---
 CHANGELOG.md                       |  3 ++
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md | 12 ++++----
 src/components/AutoPaintTab.tsx    |  7 ++++-
 src/components/ThreeDControls.tsx  |  2 ++
 src/docs/3d-mode.md                |  2 ++
 src/hooks/useAutoPaintWorker.ts    | 30 +++++++++++++++++--
 src/lib/export3mf.ts               |  9 ++++--
 src/lib/optimizer.ts               | 43 ++++++++++++++++++++++++++
 src/workers/autoPaint.worker.ts    | 48 ++++++++++++++++++++++++++----
 tests/autoPaintWorker.test.ts      | 10 +++++++
 tests/export3mf.test.ts            | 25 ++++++++++++++++
 tests/optimizer.test.ts            | 25 ++++++++++++++++
 12 files changed, 198 insertions(+), 18 deletions(-)
 create mode 100644 tests/autoPaintWorker.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 66836d4..a9e4729 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,6 +8,7 @@ All notable changes to Kromacut are documented in this file.
 
 - **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
 - **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures palette and preview-realized color error, coverage, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles.
+- **Auto-paint optimization progress** - Enhanced matching now reports an approximate completion percentage while its background search is running.
 
 ### Changed
 
@@ -22,6 +23,8 @@ All notable changes to Kromacut are documented in this file.
 
 - **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
 
+- **Desktop 3MF export reliability** - 3MF model XML now goes directly into the archive instead of being read back through `FileReader`, avoiding desktop WebView `NotReadableError` failures during export.
+
 ## v3.1.0 - 2026-06-18
 
 ### Added
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index e03ab76..afb434c 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -345,15 +345,15 @@ values and re-map internally (decision log §4).
 Goal: fix F9 ergonomics. Independent of phases 3-4 but nicer after them (beam search
 has natural progress).
 
-- [ ] **5.1** Optimizer accepts `onProgress(iteration, total, bestScore)`; worker
+- [x] **5.1** Optimizer accepts `onProgress(iteration, total, bestScore)`; worker
       throttles (~10 Hz) `postMessage({ type: 'progress', id, ... })`; final message
       keeps the current shape (`{ id, result }`) for compatibility.
-- [ ] **5.2** Hook surfaces `progress` in `UseAutoPaintWorkerResult`; AutoPaintTab
+- [x] **5.2** Hook surfaces `progress` in `UseAutoPaintWorkerResult`; AutoPaintTab
       shows it next to the spinner ("Optimizing… 43%").
-- [ ] **5.3** Keep terminate-based cancel; optionally keep a warm worker between
-      requests and cancel via `id` checks instead of terminate (measure startup cost
-      first — only do this if it's noticeable).
-- [ ] **5.4 Tests**: progress monotonic 0→1 (mirror `tests/algorithms-progress.test.ts`
+- [x] **5.3** Kept terminate-based cancellation. A warm worker was not added because
+      its startup cost is not currently noticeable enough to justify a more complex
+      cancellation path.
+- [x] **5.4 Tests**: progress monotonic 0→1 (mirror `tests/algorithms-progress.test.ts`
       pattern); stale progress messages (old `id`) ignored.
 
 Risk: low.
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index a8dae08..2e5739d 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -77,6 +77,7 @@ interface AutoPaintTabProps {
     autoPaintResult?: AutoPaintResult;
     autoPaintSliceData?: AutoPaintSliceData;
     isComputing?: boolean;
+    progress?: number;
     error?: string;
     calibrationLayerHeight: number;
     setCalibrationLayerHeight: (v: number) => void;
@@ -139,6 +140,7 @@ export default function AutoPaintTab({
     autoPaintResult,
     autoPaintSliceData,
     isComputing = false,
+    progress = 0,
     error,
     calibrationLayerHeight,
     filteredCount,
@@ -513,7 +515,10 @@ export default function AutoPaintTab({
                             {isComputing && (
                                 <div className="flex items-center gap-1.5 text-[10px] text-primary">
                                     <Loader2 className="w-3 h-3 animate-spin" />
-                                    <span>Optimizing filament order...</span>
+                                    <span>
+                                        Optimizing filament order...
+                                        {progress > 0 ? ` ${Math.round(progress * 100)}%` : ''}
+                                    </span>
                                 </div>
                             )}
                             {error && !isComputing && (
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index e296561..5078c80 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -209,6 +209,7 @@ export default function ThreeDControls({
     const {
         autoPaintResult,
         isComputing: isAutoPaintComputing,
+        progress: autoPaintProgress,
         error: autoPaintError,
     } = useAutoPaintWorker({
         paintMode,
@@ -459,6 +460,7 @@ export default function ThreeDControls({
                     autoPaintResult={autoPaintResult}
                     autoPaintSliceData={autoPaintSliceData}
                     isComputing={isAutoPaintComputing}
+                    progress={autoPaintProgress}
                     error={autoPaintError}
                     calibrationLayerHeight={calibrationLayerHeight}
                     setCalibrationLayerHeight={setCalibrationLayerHeight}
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index a26e5ea..024324f 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -80,6 +80,8 @@ Optional controls appear with enhanced matching:
 - **Line width** should roughly match the printer line or nozzle width used for dither dots.
 - **Optimizer Settings** let you choose **Algorithm**, **Region priority**, and an optional **Seed**.
 
+While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
+
 ## Flat Paint
 
 **Flat Paint (flat face-down print)** builds a uniform-thickness slab instead of a stepped relief. Every printed layer has the full model footprint:
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index 689249f..2db6027 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -13,7 +13,11 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import type { AutoPaintResult } from '../lib/autoPaint';
 import type { Filament, Swatch } from '../types';
-import type { AutoPaintWorkerRequest, AutoPaintWorkerResponse } from '../workers/autoPaint.worker';
+import type {
+    AutoPaintWorkerProgress,
+    AutoPaintWorkerRequest,
+    AutoPaintWorkerResponse,
+} from '../workers/autoPaint.worker';
 
 export interface UseAutoPaintWorkerOptions {
     paintMode: 'manual' | 'autopaint';
@@ -32,11 +36,22 @@ export interface UseAutoPaintWorkerOptions {
 export interface UseAutoPaintWorkerResult {
     autoPaintResult: AutoPaintResult | undefined;
     isComputing: boolean;
+    progress: number;
     error?: string;
 }
 
 let nextRequestId = 1;
 
+export function isCurrentAutoPaintWorkerResponse(responseId: number, activeRequestId: number): boolean {
+    return responseId === activeRequestId;
+}
+
+function isAutoPaintWorkerProgress(
+    response: AutoPaintWorkerResponse
+): response is AutoPaintWorkerProgress {
+    return 'type' in response && response.type === 'progress';
+}
+
 function useStableValueByKey<T>(value: T, key: string): T {
     const stableRef = useRef<{ key: string; value: T } | null>(null);
     if (!stableRef.current || stableRef.current.key !== key) {
@@ -62,6 +77,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
 
     const [autoPaintResult, setAutoPaintResult] = useState<AutoPaintResult | undefined>(undefined);
     const [isComputing, setIsComputing] = useState(false);
+    const [progress, setProgress] = useState(0);
     const [error, setError] = useState<string | undefined>(undefined);
 
     const workerRef = useRef<Worker | null>(null);
@@ -86,6 +102,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
 
             activeRequestIdRef.current = 0;
             setIsComputing(false);
+            setProgress(nextError ? 0 : 1);
             setError(nextError);
 
             if (nextError) {
@@ -150,7 +167,12 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
 
             workerRef.current.onmessage = (e: MessageEvent<AutoPaintWorkerResponse>) => {
                 const resp = e.data;
-                if (resp.id !== activeRequestIdRef.current) return;
+                if (!isCurrentAutoPaintWorkerResponse(resp.id, activeRequestIdRef.current)) return;
+
+                if (isAutoPaintWorkerProgress(resp)) {
+                    setProgress((current) => Math.max(current, resp.progress));
+                    return;
+                }
 
                 if (resp.error) {
                     finishRequest(resp.id, resp.error);
@@ -190,6 +212,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
             cancelWorker();
             setAutoPaintResult(undefined);
             setIsComputing(false);
+            setProgress(0);
             setError(undefined);
             return;
         }
@@ -201,6 +224,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         activeRequestIdRef.current = id;
         setAutoPaintResult(undefined);
         setIsComputing(true);
+        setProgress(0);
         setError(undefined);
 
         debounceTimerRef.current = setTimeout(() => {
@@ -259,5 +283,5 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         finishRequest,
     ]);
 
-    return { autoPaintResult, isComputing, error };
+    return { autoPaintResult, isComputing, progress, error };
 }
diff --git a/src/lib/export3mf.ts b/src/lib/export3mf.ts
index a14185f..308ee54 100644
--- a/src/lib/export3mf.ts
+++ b/src/lib/export3mf.ts
@@ -634,9 +634,12 @@ export async function exportObjectTo3MFBlob(
 
     flushXmlChunk();
 
-    const finalBlob = new Blob(xmlParts, { type: 'text/xml' });
-
-    zip.folder('3D')?.file('3dmodel.model', finalBlob);
+    // JSZip reads Blob inputs through FileReader. In the Tauri webview that
+    // extra read can fail with NotReadableError even though this XML was just
+    // generated in memory. Passing text lets JSZip encode it directly.
+    const modelXml = xmlParts.join('');
+    xmlParts.length = 0;
+    zip.folder('3D')?.file('3dmodel.model', modelXml);
 
     // Generate Metadata/model_settings.config
     // This is required for Bambu Studio / Orca Slicer / Creality Print to correctly identify
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 904d2c0..b3281ae 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -33,6 +33,7 @@ export interface OptimizerOptions {
     eliteCount?: number; // Retained for persisted optimizer compatibility
     beamWidth?: number; // Number of partial stacks kept by beam search
     cachingEnabled?: boolean; // Enable result caching
+    onProgress?: (iteration: number, total: number, bestScore: number) => void;
 }
 
 export interface OptimizerResult {
@@ -254,6 +255,33 @@ function isBetterCandidate(
     return sequenceKey(candidate.order) < sequenceKey(current.order);
 }
 
+function reportProgress(
+    options: OptimizerOptions,
+    iteration: number,
+    total: number,
+    bestScore: number
+) {
+    options.onProgress?.(Math.min(iteration, total), Math.max(total, 1), bestScore);
+}
+
+function orderedSubsetCount(filamentCount: number): number {
+    let total = 0;
+    let permutations = 1;
+    for (let length = 1; length <= filamentCount; length++) {
+        permutations *= filamentCount - length + 1;
+        total += permutations;
+    }
+    return total;
+}
+
+function repeatedInsertionUpperBound(filamentCount: number): number {
+    let total = 0;
+    for (let extra = 0; extra < MAX_EXTRA_REPEATS; extra++) {
+        total += filamentCount * (filamentCount + extra + 1);
+    }
+    return total;
+}
+
 function expandWithRepeatedFilaments(
     initial: ScoredSequence,
     filaments: Filament[],
@@ -310,14 +338,19 @@ function optimizeExhaustive(
     }
 
     const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const totalIterations =
+        orderedSubsetCount(filaments.length) +
+        (allowRepeatedSwaps ? repeatedInsertionUpperBound(filaments.length) : 0);
     let best: ScoredSequence | null = null;
     let iterations = 0;
+    reportProgress(options, 0, totalIterations, Infinity);
 
     const visit = (sequence: Filament[], remaining: Filament[]): void => {
         if (sequence.length > 0) {
             const candidate = { order: sequence, score: scoreSequence(sequence) };
             iterations++;
             if (isBetterCandidate(candidate, best)) best = candidate;
+            reportProgress(options, iterations, totalIterations, best?.score ?? Infinity);
         }
 
         for (let index = 0; index < remaining.length; index++) {
@@ -365,13 +398,17 @@ function optimizeBeamSearch(
     const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
     const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
     const beamWidth = options.beamWidth ?? DEFAULT_BEAM_WIDTH;
+    const totalIterations =
+        filaments.length + (maximumLength - 1) * beamWidth * filaments.length;
     let iterations = 0;
     let best: ScoredSequence | null = null;
+    reportProgress(options, 0, totalIterations, Infinity);
 
     let beam = filaments.map((filament) => {
         const candidate = { order: [filament], score: scoreSequence([filament]) };
         iterations++;
         if (isBetterCandidate(candidate, best)) best = candidate;
+        reportProgress(options, iterations, totalIterations, best?.score ?? Infinity);
         return candidate;
     });
     beam.sort((left, right) =>
@@ -402,6 +439,7 @@ function optimizeBeamSearch(
                 candidates.set(key, candidate);
                 iterations++;
                 if (isBetterCandidate(candidate, best)) best = candidate;
+                reportProgress(options, iterations, totalIterations, best?.score ?? Infinity);
             }
         }
 
@@ -538,6 +576,7 @@ function optimizeSimulatedAnnealing(
     let bestScore = currentScore;
     let temperature = initialTemp;
     let iterations = 0;
+    reportProgress(options, 0, maxIterations, bestScore);
 
     while (iterations < maxIterations && temperature > minTemp) {
         iterations++;
@@ -550,6 +589,7 @@ function optimizeSimulatedAnnealing(
         );
         if (sequenceEquals(newOrder, currentOrder)) {
             temperature *= coolingRate;
+            reportProgress(options, iterations, maxIterations, bestScore);
             continue;
         }
 
@@ -570,6 +610,7 @@ function optimizeSimulatedAnnealing(
         }
 
         temperature *= coolingRate;
+        reportProgress(options, iterations, maxIterations, bestScore);
     }
 
     // Convergence check: did we stabilize?
@@ -655,6 +696,7 @@ export function optimizeFilamentOrder(
     if (opts.cachingEnabled) {
         const cached = globalCache.get(cacheKey);
         if (cached) {
+            reportProgress(opts, 1, 1, cached.score);
             return { ...cached, cacheHit: true };
         }
     }
@@ -682,6 +724,7 @@ export function optimizeFilamentOrder(
     // Tag the result with the resolved algorithm
     result.resolvedAlgorithm =
         algorithm === 'genetic' ? 'variable-length-sa' : algorithm;
+    reportProgress(opts, result.iterations, result.iterations, result.score);
 
     if (opts.cachingEnabled) {
         globalCache.set(cacheKey, result);
diff --git a/src/workers/autoPaint.worker.ts b/src/workers/autoPaint.worker.ts
index 8b91d0a..165c5bf 100644
--- a/src/workers/autoPaint.worker.ts
+++ b/src/workers/autoPaint.worker.ts
@@ -11,6 +11,8 @@ import type { Filament } from '../types';
 import type { OptimizerOptions } from '../lib/optimizer';
 import type { AutoPaintResult } from '../lib/autoPaint';
 
+type WorkerOptimizerOptions = Omit<OptimizerOptions, 'onProgress'>;
+
 export interface AutoPaintWorkerRequest {
     id: number;
     filaments: Filament[];
@@ -20,17 +22,49 @@ export interface AutoPaintWorkerRequest {
     maxHeight?: number;
     enhancedColorMatch?: boolean;
     allowRepeatedSwaps?: boolean;
-    optimizerOptions?: Partial<OptimizerOptions>;
+    optimizerOptions?: Partial<WorkerOptimizerOptions>;
 }
 
-export interface AutoPaintWorkerResponse {
+export interface AutoPaintWorkerResult {
     id: number;
     result?: AutoPaintResult;
     error?: string;
 }
 
+export interface AutoPaintWorkerProgress {
+    type: 'progress';
+    id: number;
+    progress: number;
+    iteration: number;
+    total: number;
+    bestScore: number;
+}
+
+export type AutoPaintWorkerResponse = AutoPaintWorkerResult | AutoPaintWorkerProgress;
+
 self.onmessage = (e: MessageEvent<AutoPaintWorkerRequest>) => {
     const req = e.data;
+    const PROGRESS_INTERVAL_MS = 100;
+    let lastProgress = 0;
+    let lastProgressAt = -Infinity;
+
+    const reportProgress = (iteration: number, total: number, bestScore: number) => {
+        const progress = Math.max(lastProgress, Math.min(1, total > 0 ? iteration / total : 0));
+        const now = performance.now();
+        if (progress < 1 && now - lastProgressAt < PROGRESS_INTERVAL_MS) return;
+
+        lastProgress = progress;
+        lastProgressAt = now;
+        const response: AutoPaintWorkerProgress = {
+            type: 'progress',
+            id: req.id,
+            progress,
+            iteration,
+            total,
+            bestScore,
+        };
+        self.postMessage(response);
+    };
 
     try {
         const result = generateAutoLayers(
@@ -41,13 +75,17 @@ self.onmessage = (e: MessageEvent<AutoPaintWorkerRequest>) => {
             req.maxHeight,
             req.enhancedColorMatch,
             req.allowRepeatedSwaps,
-            req.optimizerOptions
+            {
+                ...req.optimizerOptions,
+                onProgress: reportProgress,
+            }
         );
 
-        const response: AutoPaintWorkerResponse = { id: req.id, result };
+        reportProgress(1, 1, result.optimizerMetadata?.score ?? Infinity);
+        const response: AutoPaintWorkerResult = { id: req.id, result };
         self.postMessage(response);
     } catch (err) {
-        const response: AutoPaintWorkerResponse = {
+        const response: AutoPaintWorkerResult = {
             id: req.id,
             error: err instanceof Error ? err.message : String(err),
         };
diff --git a/tests/autoPaintWorker.test.ts b/tests/autoPaintWorker.test.ts
new file mode 100644
index 0000000..964b451
--- /dev/null
+++ b/tests/autoPaintWorker.test.ts
@@ -0,0 +1,10 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+
+import { isCurrentAutoPaintWorkerResponse } from '../src/hooks/useAutoPaintWorker.ts';
+
+test('auto-paint worker ignores progress and result messages from stale requests', () => {
+    assert.equal(isCurrentAutoPaintWorkerResponse(7, 7), true);
+    assert.equal(isCurrentAutoPaintWorkerResponse(6, 7), false);
+    assert.equal(isCurrentAutoPaintWorkerResponse(8, 7), false);
+});
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index e02c31a..17f7953 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -1406,6 +1406,31 @@ test('3MF export keeps generated meshes as separate layer objects', async () =>
     );
 });
 
+test('3MF export does not require FileReader to read generated model XML', async () => {
+    const { exportObjectTo3MFBlob } = await loadExport3mfModule();
+    const previousFileReader = globalThis.FileReader;
+
+    class RejectingFileReader {
+        error = new DOMException('Generated blobs must not be re-read', 'NotReadableError');
+        onerror: ((event: { target: RejectingFileReader }) => void) | null = null;
+
+        readAsArrayBuffer() {
+            this.onerror?.({ target: this });
+        }
+    }
+
+    globalThis.FileReader = RejectingFileReader as unknown as typeof FileReader;
+    try {
+        const root = new THREE.Group();
+        root.add(createLayerMesh(createSharedCubeGeometry(), 0xff0000));
+
+        const blob = await exportObjectTo3MFBlob(root);
+        assert.ok(blob.size > 0);
+    } finally {
+        globalThis.FileReader = previousFileReader;
+    }
+});
+
 test('exports include preview-hidden layers with their original filament colors', async () => {
     const root = new THREE.Group();
     const first = createLayerMesh(createSharedCubeGeometry(), 0xff0000);
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index bf6c954..270d2a0 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -69,6 +69,31 @@ test('each optimizer produces the same result for the same seed', async (t) => {
     }
 });
 
+test('optimizer progress is monotonic and completes for every algorithm', async (t) => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+
+    for (const algorithm of algorithms) {
+        await t.test(algorithm, () => {
+            const samples: number[] = [];
+            optimizeFilamentOrder(filaments, context, {
+                algorithm,
+                seed: 42,
+                maxIterations: 30,
+                cachingEnabled: false,
+                onProgress: (iteration, total) => samples.push(total > 0 ? iteration / total : 0),
+            });
+
+            assert.ok(samples.length > 0);
+            assert.equal(samples.at(-1), 1);
+            assert.ok(
+                samples.every((sample, index) => index === 0 || sample >= samples[index - 1]),
+                'progress must never move backwards'
+            );
+        });
+    }
+});
+
 function withoutCacheState<T extends { cacheHit?: boolean }>(result: T): Omit<T, 'cacheHit'> {
     const outcome = { ...result };
     delete outcome.cacheHit;

From 8b838c54e7e2821f4ca804ab1c0cb72d9bd19821 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sun, 21 Jun 2026 11:04:06 -0500
Subject: [PATCH 12/81] update to note tsv in docs, add escaped newline
 parsing.

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 CHANGELOG.md                      |  2 +-
 README.md                         |  2 +-
 src/components/AutoPaintTab.tsx   |  2 +-
 src/docs/settings-and-controls.md |  4 +-
 src/lib/profileManager.ts         | 83 ++++++++++++++++++-------------
 tests/profileManager.test.ts      | 11 ++++
 6 files changed, 64 insertions(+), 40 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b438243..5182846 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,7 +9,7 @@ All notable changes to Kromacut are documented in this file.
 - **Orthographic camera toggle** - Added a camera toggle button to the 3D preview toolbar that switches between perspective and orthographic projection. The button shows the current mode and preserves the camera position and depth range when toggling.
 - **Flat Paint mode (experimental)** - Added a Flat Paint option to Auto-paint that builds a uniform, face-down slab: each pixel column's layer order is reversed so the artwork sits flat against the build plate (pre-mirrored for face-down printing) under a transparent carrier layer, the back is filled with the foundation filament so every layer has the full footprint, and 3MF export merges the parts into one object per physical filament for AMS/toolchanger printers. Includes flat-mode print instructions, a performance warning for tall stacks, mutual exclusion with Smooth Meshing, and regression tests covering the layout, meshing, STL compaction, and 3MF grouping.
 - **Desktop update settings** - Added desktop-only settings to manually check for updates and control whether update notices run on startup.
-- **HueForge spool CSV import** - Auto-paint filament profiles can now be imported from a HueForge spool library CSV export. Each spool is imported as a filament entry with its HueForge UUID preserved as the filament ID, named `<Brand>-<Color Name>-<Hex>` (e.g. `Inland Basic-Light Brown-#bf9c81`). Column order in the CSV is flexible.
+- **HueForge spool CSV/TSV import** - Auto-paint filament profiles can now be imported from a HueForge spool library CSV or TSV export. Each spool is imported as a filament entry with its HueForge UUID preserved as the filament ID, named `<Brand>-<Color Name>-<Hex>` (e.g. `Inland Basic-Light Brown-#bf9c81`). Column order is flexible and quoted fields with embedded commas or newlines are handled per RFC 4180.
 
 ### Changed
 
diff --git a/README.md b/README.md
index 7d96f5f..4b28dfd 100644
--- a/README.md
+++ b/README.md
@@ -190,7 +190,7 @@ Auto-paint configurations (filament lists) can be saved, loaded, and shared as *
 - **Load** — Select a saved profile from the dropdown to restore its filaments.
 - **Rename** — Change the selected profile name without changing its filaments.
 - **Export** — Download the current filaments as a `.kfil` file (JSON) to share with others.
-- **Import** — Load a `.kfil`, legacy `.kapp`, or `.json` profile file from disk.
+- **Import** — Load a `.kfil`, legacy `.kapp`, `.json`, or HueForge spool `.csv`/`.tsv` profile file from disk.
 - **Delete** — Remove a saved profile.
 
 Profiles are stored in browser `localStorage` and persist across sessions.
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 669d7fa..737b8da 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -353,7 +353,7 @@ export default function AutoPaintTab({
                         <input
                             ref={importInputRef}
                             type="file"
-                            accept=".kfil,.kapp,.json,.csv"
+                            accept=".kfil,.kapp,.json,.csv,.tsv"
                             data-testid="autopaint-profile-import-input"
                             className="hidden"
                             onChange={handleImportFile}
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index 7ea5780..9783a6e 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -72,7 +72,7 @@ Use the **upload icon** in the Auto-paint profile toolbar to import a file. Use
 | Kromacut profile | `.kfil` | Native format. Supports single profiles and arrays of profiles in one file. |
 | Legacy Kromacut profile | `.kapp` | Older native format, still fully supported on import. |
 | Raw JSON | `.json` | Accepted if the file contains a profile object or an array of profile objects. |
-| HueForge spool CSV | `.csv` | See below. |
+| HueForge spool CSV/TSV | `.csv`, `.tsv` | See below. |
 
 ### Duplicate handling
 
@@ -86,7 +86,7 @@ A short summary of how many profiles were imported, overwritten, skipped, or ren
 
 ### Importing from HueForge
 
-HueForge spool library exports (`.csv`) can be imported directly. Use **Export Spools** in HueForge to save a CSV, then click the upload icon in the Auto-paint filament profile toolbar and select the file. Each spool becomes a filament entry named `<Brand>-<Color Name>-<Hex>`, for example `Inland Basic-Light Brown-#bf9c81`. HueForge UUIDs are preserved as filament IDs so re-importing the same library does not create duplicates.
+HueForge spool library exports (`.csv` or `.tsv`) can be imported directly. Use **Export Spools** in HueForge to save a CSV, then click the upload icon in the Auto-paint filament profile toolbar and select the file. The delimiter (comma or tab) is detected automatically from the header row. Each spool becomes a filament entry named `<Brand>-<Color Name>-<Hex>`, for example `Inland Basic-Light Brown-#bf9c81`. HueForge UUIDs are preserved as filament IDs so re-importing the same library does not create duplicates.
 
 ## Desktop Update Notices
 
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 46efc79..1b2c978 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -233,53 +233,65 @@ function detectDelimiter(headerLine: string): ',' | '\t' {
 }
 
 /**
- * Parse one CSV/TSV row into fields, handling RFC 4180 double-quoted fields
- * (commas and newlines inside quotes, "" as escaped quote).
+ * Parse a CSV/TSV string into rows of fields per RFC 4180: handles embedded
+ * commas, "" escaped quotes, and newlines inside quoted fields.
  */
-function parseRow(line: string, delimiter: ',' | '\t'): string[] {
-    const fields: string[] = [];
+function parseCSV(content: string, delimiter: ',' | '\t'): string[][] {
+    const rows: string[][] = [];
+    let fields: string[] = [];
+    let field = '';
     let pos = 0;
+    const len = content.length;
 
-    while (pos <= line.length) {
-        if (pos === line.length) {
-            // line ended with a delimiter — trailing empty field
-            fields.push('');
+    while (pos <= len) {
+        if (pos === len) {
+            fields.push(field);
+            if (fields.some((f) => f.trim())) rows.push(fields);
             break;
         }
 
-        if (line[pos] === '"') {
-            let field = '';
-            pos++; // skip opening quote
+        const ch = content[pos];
+
+        if (ch === '"') {
+            pos++;
             for (;;) {
-                if (pos >= line.length) break; // unclosed quote — accept what we have
-                if (line[pos] === '"') {
-                    if (pos + 1 < line.length && line[pos + 1] === '"') {
+                if (pos >= len) break; // unclosed quote at EOF — accept what we have
+                if (content[pos] === '"') {
+                    if (pos + 1 < len && content[pos + 1] === '"') {
                         field += '"';
-                        pos += 2; // escaped quote ""
+                        pos += 2;
                     } else {
                         pos++; // closing quote
                         break;
                     }
                 } else {
-                    field += line[pos++];
+                    field += content[pos++];
                 }
             }
+        } else if (ch === delimiter) {
+            fields.push(field);
+            field = '';
+            pos++;
+        } else if (ch === '\r') {
+            pos++;
+            if (pos < len && content[pos] === '\n') pos++;
             fields.push(field);
-            if (pos < line.length && line[pos] === delimiter) pos++;
-            if (pos === line.length) break; // last field, no trailing delimiter
+            field = '';
+            if (fields.some((f) => f.trim())) rows.push(fields);
+            fields = [];
+        } else if (ch === '\n') {
+            fields.push(field);
+            field = '';
+            if (fields.some((f) => f.trim())) rows.push(fields);
+            fields = [];
+            pos++;
         } else {
-            const end = line.indexOf(delimiter, pos);
-            if (end === -1) {
-                fields.push(line.slice(pos));
-                break;
-            }
-            fields.push(line.slice(pos, end));
-            pos = end + 1;
-            // if pos === line.length the loop continues and pushes trailing ''
+            field += ch;
+            pos++;
         }
     }
 
-    return fields;
+    return rows;
 }
 
 /**
@@ -289,18 +301,20 @@ function parseRow(line: string, delimiter: ',' | '\t'): string[] {
  * the header row. Column order is flexible. Required columns: Color (hex),
  * TD (float). Optional: Brand, Name, Uuid.
  *
- * Quoted fields with embedded commas are handled per RFC 4180 ("" escapes a
- * literal quote). Rows missing Color or TD are skipped.
+ * Quoted fields with embedded commas, newlines, and "" escaped quotes are
+ * supported per RFC 4180. Rows missing Color or TD are skipped.
  *
  * Returns null if the input has no header, no valid data rows, or cannot be
  * parsed.
  */
 export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'): AutoPaintProfile[] | null {
-    const lines = csv.split(/\r?\n/).filter((l) => l.trim());
-    if (lines.length < 2) return null;
+    const firstNewline = csv.indexOf('\n');
+    const headerLine = firstNewline >= 0 ? csv.slice(0, firstNewline) : csv;
+    const delimiter = detectDelimiter(headerLine);
+    const rows = parseCSV(csv, delimiter);
+    if (rows.length < 2) return null;
 
-    const delimiter = detectDelimiter(lines[0]);
-    const headers = parseRow(lines[0], delimiter).map((h) => h.trim());
+    const headers = rows[0].map((h) => h.trim());
 
     const col = (row: string[], name: string) => {
         const i = headers.indexOf(name);
@@ -308,8 +322,7 @@ export function parseHueForgeCSV(csv: string, profileName = 'HueForge Import'):
     };
 
     const filaments: import('../types').Filament[] = [];
-    for (const line of lines.slice(1)) {
-        const row = parseRow(line, delimiter);
+    for (const row of rows.slice(1)) {
         const colorRaw = col(row, 'Color');
         const color = normalizeHexColor(colorRaw, '');
         const tdRaw = col(row, 'TD');
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 387bf95..941f631 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -112,6 +112,17 @@ Overture Basic\t#033877\tBlue\t3.5\t{c8518afd-068e-4a5c-90d2-9981d4d7edde}`;
     assert.equal(profiles[0].filaments[1].color, '#033877');
 });
 
+test('parseHueForgeCSV handles quoted fields containing newlines', () => {
+    const csv = `Brand,Color,Name,TD
+"Inland\nBasic",#bf9c81,"Light\nBrown",1.7`;
+    const [profile] = parseHueForgeCSV(csv)!;
+    const [f] = profile.filaments;
+    assert.equal(f.brand, 'Inland\nBasic');
+    assert.equal(f.name, 'Inland\nBasic-Light\nBrown-#BF9C81');
+    assert.equal(f.color, '#BF9C81');
+    assert.equal(f.td, 1.7);
+});
+
 test('parseHueForgeCSV TSV does not split on commas in values', () => {
     const tsv = `Brand\tColor\tName\tTD
 Inland, Basic\t#bf9c81\tLight Brown\t1.7`;

From 46a666208f80bc4d3f3e79062a2feaa113edb946 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 21:37:25 +0300
Subject: [PATCH 13/81] Harden auto-paint physics and 3MF export

---
 CHANGELOG.md                       |   3 +-
 README.md                          |   2 +-
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md |  24 ++-
 src/docs/3d-mode.md                |   2 +
 src/lib/autoPaint.ts               | 294 ++++++++++++++++++-----------
 src/lib/export3mf.ts               |  59 +++++-
 src/lib/optimizer.ts               |   7 +-
 tests/autoPaint.test.ts            |  82 ++++++++
 tests/export3mf.test.ts            |   9 +-
 tests/optimizer.test.ts            |  23 +++
 10 files changed, 367 insertions(+), 138 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a9e4729..4e311c3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ All notable changes to Kromacut are documented in this file.
 
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
 - **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
+- **Calibrated Auto-paint previews** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends, while the scalar working TD continues to control layer-zone thickness.
 
 ### Fixed
 
@@ -23,7 +24,7 @@ All notable changes to Kromacut are documented in this file.
 
 - **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
 
-- **Desktop 3MF export reliability** - 3MF model XML now goes directly into the archive instead of being read back through `FileReader`, avoiding desktop WebView `NotReadableError` failures during export.
+- **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
 ## v3.1.0 - 2026-06-18
 
diff --git a/README.md b/README.md
index a7d6e7a..a651ae5 100644
--- a/README.md
+++ b/README.md
@@ -134,7 +134,7 @@ Each filament row in the Auto-paint tab includes a **calibration wizard** to hel
 4. **Automatic TD calculation** — The wizard performs exponential regression on your measurements to compute the optimal TD value with a confidence score (High/Medium/Low/Very Low).
 5. **Save profile** — Keep calibrated filaments in a reusable profile for future projects.
 
-Calibrated filaments display a confidence badge next to their TD value. Higher confidence = more accurate optical simulation = better print results.
+Calibrated filaments display a confidence badge next to their TD value. Higher confidence = more accurate optical simulation = better print results. Auto-paint also uses the calibrated red, green, and blue TD values for preview blending, while the working TD continues to set layer-zone thickness.
 
 ### Advanced Optimizer
 
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
index afb434c..b66174a 100644
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
@@ -364,23 +364,21 @@ Goal: close F8 where measurement proves it helps. Each item independent; ship on
 with harness evidence. These change preview colors for existing projects — CHANGELOG
 each.
 
-- [ ] **6a Per-channel TD blending where calibration exists**: `blendColors` uses
+- [x] **6a Per-channel TD blending where calibration exists**: `blendColors` uses
       `calibration.td: [r,g,b]` (per-channel transmission, gamma-space — consistent
       with how calibration measures) when present; scalar `tdSingleValue` fallback
       unchanged for uncalibrated filaments. Touches `blendColors` call sites in
       `autoPaint.ts` only; `Filament` already carries `calibration`.
-- [ ] **6b Compression-aware backgrounds**: carry the actual blended end-color of zone
-      _i−1_ forward as zone _i_'s background in `buildAchievableColorPalette` and
-      `autoPaintToSliceHeights` (today: pure color, `autoPaint.ts:656-663, 1499-1506`).
-      Makes compressed previews honest and lets the (unified) scorer see compression
-      damage. Optionally: when `compressionRatio < 0.9`, re-score the top-k candidate
-      orders under compression and pick the best (bounded cost).
-- [ ] **6c CIEDE2000** behind a metric constant for scoring + clustering distances
-      (~3-4× distance cost; affordable at ≤32 targets). Adopt only if harness shows
-      end-to-end improvement on saturated fixtures.
-- [ ] **6d FRONTLIT_TD_SCALE**: leave at 0.1 for now; add a calibration-wizard-derived
-      frontlit factor as a future item (requires new measurement flow — out of scope).
-- [ ] **6e Cleanup**: delete dead `luminanceToHeight` (`autoPaint.ts:1551`); update the
+- [ ] **6b Compression-aware backgrounds**: implemented behind
+      `USE_COMPRESSION_AWARE_BACKGROUNDS`, but not enabled. The harness regressed the
+      8-color large-image case from ΔE 11.58 to 13.26 (14.5%), beyond the 5% tolerance.
+      Revisit only with a better compression model or measured compressed-stack data.
+- [x] **6c CIEDE2000 evaluation**: implemented behind `OPTIMIZER_DISTANCE_METRIC` for
+      scoring and clustering, but retained CIE76. The harness put CIEDE2000's two
+      8-filament runs at 4.1–4.7 s, over the 2 s budget, so it did not earn adoption.
+- [x] **6d FRONTLIT_TD_SCALE**: deliberately retained at 0.1. A calibrated front-lit
+      factor needs a new measurement workflow and remains out of scope.
+- [x] **6e Cleanup**: deleted dead `luminanceToHeight`; updated the
       stale module doc header (`autoPaint.ts:1-17`).
 
 Risk: medium (visual shifts); mitigated by gating + harness + CHANGELOG.
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 024324f..897fe8f 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -82,6 +82,8 @@ Optional controls appear with enhanced matching:
 
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
 
+When a filament has been calibrated, Auto-paint also uses its measured red, green, and blue TD values to preview color transitions. The normal working TD still controls layer-zone thickness, so calibration makes the color model more faithful without changing your print-height settings.
+
 ## Flat Paint
 
 **Flat Paint (flat face-down print)** builds a uniform-thickness slab instead of a stepped relief. Every printed layer has the full model footprint:
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 36000da..717651e 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -1,19 +1,11 @@
 /**
- * Auto-Paint Algorithm for Filament Painting (HueForge-style lithophanes)
+ * Auto-paint optical model and printable color-stack planner.
  *
- * This module implements a physically-accurate optical simulation for
- * multi-filament lithophane printing using the Beer-Lambert law.
+ * This module models multi-filament prints with Beer-Lambert blending, then
+ * turns the selected filament stack into layer zones and preview colors.
  *
- * Key concepts:
- * 1. TRANSITION ZONES: Each filament needs enough vertical space to fully
- *    transition from the previous color to its pure color.
- * 2. CUMULATIVE HEIGHT: Total height = sum of all transition zones.
- * 3. COMPRESSION: If user sets a max height below the ideal, zones are compressed.
- * 4. LUMINANCE MAPPING: Image pixel brightness maps to position within zones.
- * 5. ENHANCED COLOR MATCHING: Optimizes filament ordering by evaluating all
- *    permutations for best color reproduction (DeltaE-based).
- * 6. REPEATED SWAPS: Allows filaments to appear multiple times in the stack
- *    to create intermediate blended colors (e.g., thin white over red = pink).
+ * It keeps the optimizer and preview on the same model: optional calibrated
+ * per-channel TDs and printable layer sampling are shared by both paths.
  */
 
 import type { Filament } from '../types';
@@ -23,7 +15,7 @@ import {
     type OptimizerResult,
     type ScoringContext,
 } from './optimizer';
-import { computeProfileConfidence } from './calibration';
+import { computeProfileConfidence, type CalibrationRgb } from './calibration';
 
 export { LAYER_ACTIVATION_EPSILON } from './layerActivation';
 
@@ -46,11 +38,14 @@ export interface WeightedLab extends Lab {
     weight: number;
 }
 
+type ColorDistanceMetric = 'cie76' | 'ciede2000';
+
 /** A transition zone between two filaments */
 export interface TransitionZone {
     filamentId: string;
     filamentColor: string;
     filamentTd: number; // Transmission Distance of this filament
+    filamentTdChannels?: CalibrationRgb; // Calibrated R, G, B TDs when available
     startHeight: number; // mm from Z=0
     endHeight: number; // mm from Z=0
     idealThickness: number; // Uncompressed zone thickness
@@ -209,36 +204,105 @@ export function getLuminance(color: RGB): number {
  *
  * @param backgroundColor - The color of the existing stack
  * @param filamentColor - The color of the filament being added
- * @param filamentTD - Transmission Distance of the filament (mm)
+ * @param filamentTD - Scalar working TD or calibrated R, G, B TDs (mm)
  * @param layerThickness - How thick the filament layer is (mm)
  * @returns The resulting blended color
  */
 export function blendColors(
     backgroundColor: RGB,
     filamentColor: RGB,
-    filamentTD: number,
+    filamentTD: number | CalibrationRgb,
     layerThickness: number
 ): RGB {
-    // Prevent division by zero or invalid TD
-    if (filamentTD <= 0 || layerThickness <= 0) {
+    if (layerThickness <= 0) {
         return filamentColor;
     }
 
-    // Beer-Lambert law: transmission = 10^(-thickness/TD)
-    // At thickness == TD, transmission = 10^(-1) = 0.1 (10%)
-    const transmission = Math.pow(0.1, layerThickness / filamentTD);
+    const channelTd: CalibrationRgb =
+        typeof filamentTD === 'number' ? [filamentTD, filamentTD, filamentTD] : filamentTD;
+    if (channelTd.some((td) => !Number.isFinite(td) || td <= 0)) {
+        return filamentColor;
+    }
 
-    // Opacity is the inverse of transmission
-    const opacity = 1 - transmission;
+    const blendChannel = (background: number, filament: number, td: number) => {
+        // Beer-Lambert law: transmission = 10^(-thickness/TD).
+        // At thickness == TD, transmission = 10^(-1) = 0.1 (10%).
+        const transmission = Math.pow(0.1, layerThickness / td);
+        return filament * (1 - transmission) + background * transmission;
+    };
 
-    // Linear interpolation (simple RGB mixing)
     return {
-        r: filamentColor.r * opacity + backgroundColor.r * transmission,
-        g: filamentColor.g * opacity + backgroundColor.g * transmission,
-        b: filamentColor.b * opacity + backgroundColor.b * transmission,
+        r: blendChannel(backgroundColor.r, filamentColor.r, channelTd[0]),
+        g: blendChannel(backgroundColor.g, filamentColor.g, channelTd[1]),
+        b: blendChannel(backgroundColor.b, filamentColor.b, channelTd[2]),
     };
 }
 
+/** Calculate Delta E (CIEDE2000) directly from Lab values. */
+export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
+    const chroma1 = Math.hypot(lab1.a, lab1.b);
+    const chroma2 = Math.hypot(lab2.a, lab2.b);
+    const averageChroma = (chroma1 + chroma2) / 2;
+    const g = 0.5 * (1 - Math.sqrt(averageChroma ** 7 / (averageChroma ** 7 + 25 ** 7)));
+    const a1 = (1 + g) * lab1.a;
+    const a2 = (1 + g) * lab2.a;
+    const adjustedChroma1 = Math.hypot(a1, lab1.b);
+    const adjustedChroma2 = Math.hypot(a2, lab2.b);
+    const hue = (a: number, b: number) => (Math.atan2(b, a) * 180 / Math.PI + 360) % 360;
+    const hue1 = hue(a1, lab1.b);
+    const hue2 = hue(a2, lab2.b);
+    const deltaL = lab2.L - lab1.L;
+    const deltaChroma = adjustedChroma2 - adjustedChroma1;
+    const hueDifference =
+        adjustedChroma1 * adjustedChroma2 === 0
+            ? 0
+            : Math.abs(hue2 - hue1) <= 180
+              ? hue2 - hue1
+              : hue2 <= hue1
+                ? hue2 - hue1 + 360
+                : hue2 - hue1 - 360;
+    const deltaHue =
+        2 * Math.sqrt(adjustedChroma1 * adjustedChroma2) * Math.sin((hueDifference / 2) * Math.PI / 180);
+    const meanL = (lab1.L + lab2.L) / 2;
+    const meanChroma = (adjustedChroma1 + adjustedChroma2) / 2;
+    const meanHue =
+        adjustedChroma1 * adjustedChroma2 === 0
+            ? hue1 + hue2
+            : Math.abs(hue1 - hue2) <= 180
+              ? (hue1 + hue2) / 2
+              : hue1 + hue2 < 360
+                ? (hue1 + hue2 + 360) / 2
+                : (hue1 + hue2 - 360) / 2;
+    const hueWeight =
+        1 -
+        0.17 * Math.cos((meanHue - 30) * Math.PI / 180) +
+        0.24 * Math.cos(2 * meanHue * Math.PI / 180) +
+        0.32 * Math.cos((3 * meanHue + 6) * Math.PI / 180) -
+        0.2 * Math.cos((4 * meanHue - 63) * Math.PI / 180);
+    const lightnessScale = 1 + 0.015 * (meanL - 50) ** 2 / Math.sqrt(20 + (meanL - 50) ** 2);
+    const chromaScale = 1 + 0.045 * meanChroma;
+    const hueScale = 1 + 0.015 * meanChroma * hueWeight;
+    const rotation =
+        -2 *
+        Math.sqrt(meanChroma ** 7 / (meanChroma ** 7 + 25 ** 7)) *
+        Math.sin((60 * Math.exp(-(((meanHue - 275) / 25) ** 2))) * Math.PI / 180);
+
+    return Math.sqrt(
+        (deltaL / lightnessScale) ** 2 +
+            (deltaChroma / chromaScale) ** 2 +
+            (deltaHue / hueScale) ** 2 +
+            rotation * (deltaChroma / chromaScale) * (deltaHue / hueScale)
+    );
+}
+
+const OPTIMIZER_DISTANCE_METRIC: ColorDistanceMetric = 'cie76';
+
+function optimizerColorDistance(left: Lab, right: Lab): number {
+    return OPTIMIZER_DISTANCE_METRIC === 'ciede2000'
+        ? deltaE2000Lab(left, right)
+        : deltaELab(left, right);
+}
+
 /**
  * Calculate the opacity (how opaque) a filament layer is at a given thickness.
  *
@@ -268,6 +332,37 @@ const DELTA_E_THRESHOLD = 2.3; // "Just noticeable difference"
  * Scale user-entered TD values down for internal simulation.
  */
 const FRONTLIT_TD_SCALE = 0.1;
+const USE_CALIBRATED_CHANNEL_TD = true;
+const USE_COMPRESSION_AWARE_BACKGROUNDS = false;
+
+type AutoPaintFilament = Pick<Filament, 'id' | 'color' | 'td' | 'calibration'>;
+
+function calibratedTdChannels(filament: AutoPaintFilament): CalibrationRgb | undefined {
+    if (!USE_CALIBRATED_CHANNEL_TD) return undefined;
+    const channels = filament.calibration?.td;
+    if (!channels || channels.some((td) => !Number.isFinite(td) || td <= 0)) {
+        return undefined;
+    }
+    return channels;
+}
+
+function scaleFilamentForFrontlight(filament: Filament): Filament {
+    const scaledTd = filament.td * FRONTLIT_TD_SCALE;
+    if (!filament.calibration) {
+        return { ...filament, td: scaledTd };
+    }
+
+    const calibration = filament.calibration;
+    return {
+        ...filament,
+        td: scaledTd,
+        calibration: {
+            ...calibration,
+            td: calibration.td.map((td) => td * FRONTLIT_TD_SCALE) as CalibrationRgb,
+            tdSingleValue: calibration.tdSingleValue * FRONTLIT_TD_SCALE,
+        },
+    };
+}
 
 /**
  * Simulate adding filament layers until the blended color matches the
@@ -336,7 +431,7 @@ export function calculateTransitionThickness(
  * @returns Object with ideal height and zone breakdown
  */
 export function calculateIdealHeight(
-    sortedFilaments: Array<{ id: string; color: string; td: number }>,
+    sortedFilaments: AutoPaintFilament[],
     layerHeight: number,
     baseThickness: number = 0.6,
     transitionThicknessCache?: Map<string, number>
@@ -363,6 +458,7 @@ export function calculateIdealHeight(
         filamentId: firstFilament.id,
         filamentColor: firstFilament.color,
         filamentTd: firstFilament.td,
+        filamentTdChannels: calibratedTdChannels(firstFilament),
         startHeight: 0,
         endHeight: foundationThickness,
         idealThickness: foundationThickness,
@@ -401,6 +497,7 @@ export function calculateIdealHeight(
             filamentId: filament.id,
             filamentColor: filament.color,
             filamentTd: filament.td,
+            filamentTdChannels: calibratedTdChannels(filament),
             startHeight: currentHeight,
             endHeight: currentHeight + transitionThickness,
             idealThickness: transitionThickness,
@@ -457,6 +554,37 @@ export function compressZones(
     return { compressedZones, compressionRatio };
 }
 
+function buildZoneBackgrounds(zones: TransitionZone[]): RGB[] {
+    if (zones.length === 0) return [];
+
+    const backgrounds: RGB[] = [];
+    let previousEndColor = hexToRgb(zones[0].filamentColor);
+
+    for (let index = 0; index < zones.length; index++) {
+        const zone = zones[index];
+        const filamentColor = hexToRgb(zone.filamentColor);
+        const backgroundColor =
+            index === 0
+                ? filamentColor
+                : USE_COMPRESSION_AWARE_BACKGROUNDS
+                  ? previousEndColor
+                  : hexToRgb(zones[index - 1].filamentColor);
+        backgrounds.push(backgroundColor);
+
+        previousEndColor =
+            index === 0
+                ? filamentColor
+                : blendColors(
+                      backgroundColor,
+                      filamentColor,
+                      zone.filamentTdChannels ?? zone.filamentTd,
+                      zone.actualThickness
+                  );
+    }
+
+    return backgrounds;
+}
+
 // =============================================================================
 // IMAGE COLOR ANALYSIS
 // =============================================================================
@@ -505,24 +633,21 @@ export function clusterImageColors(
         totalCount: number;
     }> = [];
 
-    const thresholdSq = threshold * threshold;
-
     for (const item of items) {
         // Find nearest existing cluster
         let bestIdx = -1;
-        let bestDeSq = Infinity;
+        let bestDistance = Infinity;
 
         for (let ci = 0; ci < clusters.length; ci++) {
             const c = clusters[ci];
-            const deSq =
-                (item.lab.L - c.L) ** 2 + (item.lab.a - c.a) ** 2 + (item.lab.b - c.b) ** 2;
-            if (deSq < bestDeSq) {
-                bestDeSq = deSq;
+            const distance = optimizerColorDistance(item.lab, c);
+            if (distance < bestDistance) {
+                bestDistance = distance;
                 bestIdx = ci;
             }
         }
 
-        if (bestIdx >= 0 && bestDeSq < thresholdSq) {
+        if (bestIdx >= 0 && bestDistance < threshold) {
             // Merge into existing cluster (weighted centroid update)
             const c = clusters[bestIdx];
             const total = c.totalCount + item.count;
@@ -585,7 +710,7 @@ export function clusterImageColors(
  * @returns Array of achievable { height, lab, rgb } at each layer step
  */
 export function buildAchievableColorPalette(
-    sequence: Array<{ id: string; color: string; td: number }>,
+    sequence: AutoPaintFilament[],
     layerHeight: number,
     firstLayerHeight: number,
     maxHeight?: number,
@@ -595,7 +720,7 @@ export function buildAchievableColorPalette(
 
     // Calculate zones for this sequence
     const { zones } = calculateIdealHeight(
-        sequence.map((f) => ({ id: f.id, color: f.color, td: f.td })),
+        sequence,
         layerHeight,
         Math.max(firstLayerHeight, layerHeight),
         transitionThicknessCache
@@ -607,6 +732,7 @@ export function buildAchievableColorPalette(
         maxHeight === undefined ? zones : compressZones(zones, maxHeight).compressedZones;
     const totalHeight = activeZones[activeZones.length - 1].endHeight;
     const palette: Array<{ height: number; lab: Lab; rgb: RGB }> = [];
+    const zoneBackgrounds = buildZoneBackgrounds(activeZones);
 
     let currentZ = 0;
     let layerIndex = 0;
@@ -643,11 +769,10 @@ export function buildAchievableColorPalette(
         if (activeZoneIndex === 0) {
             blendedColor = filamentColor;
         } else {
-            const bgColor = hexToRgb(activeZones[activeZoneIndex - 1].filamentColor);
             blendedColor = blendColors(
-                bgColor,
+                zoneBackgrounds[activeZoneIndex],
                 filamentColor,
-                zone.filamentTd,
+                zone.filamentTdChannels ?? zone.filamentTd,
                 thicknessInCurrentZone
             );
         }
@@ -709,11 +834,7 @@ export function scoreSequenceAgainstImage(
         let bestIdx = 0;
         for (let ri = 0; ri < paletteEntries.length; ri++) {
             const entry = paletteEntries[ri];
-            const de = Math.sqrt(
-                (entry.lab.L - target.L) ** 2 +
-                    (entry.lab.a - target.a) ** 2 +
-                    (entry.lab.b - target.b) ** 2
-            );
+            const de = optimizerColorDistance(entry.lab, target);
             if (de < minDE) {
                 minDE = de;
                 bestHeight = entry.height;
@@ -744,11 +865,11 @@ export function scoreSequenceAgainstImage(
             const projectedL = start.lab.L + t * dL;
             const projectedA = start.lab.a + t * da;
             const projectedB = start.lab.b + t * db;
-            const projectedDistance = Math.sqrt(
-                (target.L - projectedL) ** 2 +
-                    (target.a - projectedA) ** 2 +
-                    (target.b - projectedB) ** 2
-            );
+            const projectedDistance = optimizerColorDistance(target, {
+                L: projectedL,
+                a: projectedA,
+                b: projectedB,
+            });
             if (projectedDistance < minDE) {
                 minDE = projectedDistance;
                 bestHeight = start.height + t * (end.height - start.height);
@@ -758,11 +879,7 @@ export function scoreSequenceAgainstImage(
         const mappedIdx = paletteEntries.findIndex((entry) => entry.height >= bestHeight);
         bestIdx = mappedIdx >= 0 ? mappedIdx : paletteEntries.length - 1;
         const mappedColor = paletteEntries[bestIdx].lab;
-        const mappedDeltaE = Math.sqrt(
-            (mappedColor.L - target.L) ** 2 +
-                (mappedColor.a - target.a) ** 2 +
-                (mappedColor.b - target.b) ** 2
-        );
+        const mappedDeltaE = optimizerColorDistance(mappedColor, target);
 
         weightedDeltaE += mappedDeltaE * target.weight;
         bestMatchHeights.push(bestHeight);
@@ -860,10 +977,7 @@ function findBestFilamentOrderWithOptimizer(
     };
 
     // Apply frontlit TD scale
-    const scaledFilaments = filaments.map((f) => ({
-        ...f,
-        td: f.td * FRONTLIT_TD_SCALE,
-    }));
+    const scaledFilaments = filaments.map(scaleFilamentForFrontlight);
 
     // Run optimizer
     const result = optimizeFilamentOrder(scaledFilaments, context, {
@@ -980,14 +1094,11 @@ export function generateAutoLayers(
     const filamentOrder = sortedFilaments.map((f) => f.id);
 
     // Apply frontlit TD scale for internal simulation
-    const scaledFilaments = sortedFilaments.map((f) => ({
-        ...f,
-        td: f.td * FRONTLIT_TD_SCALE,
-    }));
+    const scaledFilaments = sortedFilaments.map(scaleFilamentForFrontlight);
 
     // --- STEP 3: CALCULATE IDEAL HEIGHT WITH TRANSITION ZONES ---
     const { idealHeight, zones } = calculateIdealHeight(
-        scaledFilaments.map((f) => ({ id: f.id, color: f.color, td: f.td })),
+        scaledFilaments,
         layerHeight,
         Math.max(firstLayerHeight, layerHeight)
     );
@@ -1109,6 +1220,7 @@ export function autoPaintToSliceHeights(
     const colorOrder: number[] = [];
 
     const zones = result.transitionZones;
+    const zoneBackgrounds = buildZoneBackgrounds(zones);
 
     // Generate layers at each layerHeight increment from 0 to totalHeight.
     // For each layer, simulate the Beer-Lambert blended color at that Z.
@@ -1150,11 +1262,10 @@ export function autoPaintToSliceHeights(
         if (activeZoneIndex === 0) {
             blendedColor = filamentColor;
         } else {
-            const bgColor = hexToRgb(zones[activeZoneIndex - 1].filamentColor);
             blendedColor = blendColors(
-                bgColor,
+                zoneBackgrounds[activeZoneIndex],
                 filamentColor,
-                zone.filamentTd,
+                zone.filamentTdChannels ?? zone.filamentTd,
                 thicknessInCurrentZone
             );
         }
@@ -1181,53 +1292,6 @@ export function autoPaintToSliceHeights(
     };
 }
 
-// =============================================================================
-// LUMINANCE-TO-HEIGHT MAPPING
-// =============================================================================
-
-/**
- * Map a pixel's luminance to a target height within the transition zones.
- *
- * This is the key function that determines how image brightness translates
- * to physical height in the 3D model.
- *
- * The mapping works as follows:
- * - Darkest pixels (luminance = 0) → minimum height (base layer only)
- * - Lightest pixels (luminance = 1) → maximum height (all layers)
- * - Mid-tones → proportional position within the transition zones
- *
- * @param normalizedLuminance - Pixel luminance normalized to 0-1
- * @param transitionZones - The computed transition zones
- * @param totalHeight - Total model height
- * @param firstLayerHeight - First layer height
- * @returns Target height in mm
- */
-export function luminanceToHeight(
-    normalizedLuminance: number,
-    transitionZones: TransitionZone[],
-    totalHeight: number,
-    firstLayerHeight: number
-): number {
-    if (transitionZones.length === 0) {
-        return firstLayerHeight;
-    }
-
-    // Base height (darkest pixels get at least the foundation)
-    const baseHeight = transitionZones[0].endHeight;
-
-    if (normalizedLuminance <= 0) {
-        return baseHeight;
-    }
-
-    if (normalizedLuminance >= 1) {
-        return totalHeight;
-    }
-
-    // Linear interpolation from base to total height
-    // This gives a smooth gradient where brightness = height
-    return baseHeight + normalizedLuminance * (totalHeight - baseHeight);
-}
-
 // =============================================================================
 // CONFIDENCE SCORING
 // =============================================================================
diff --git a/src/lib/export3mf.ts b/src/lib/export3mf.ts
index 308ee54..09ae70f 100644
--- a/src/lib/export3mf.ts
+++ b/src/lib/export3mf.ts
@@ -23,6 +23,54 @@ type ExportGeometrySource = {
     itemSize?: number;
 };
 
+function utf8ByteLength(value: string): number {
+    let length = 0;
+    for (let index = 0; index < value.length; index++) {
+        const code = value.charCodeAt(index);
+        if (code < 0x80) {
+            length += 1;
+        } else if (code < 0x800) {
+            length += 2;
+        } else if (
+            code >= 0xd800 &&
+            code <= 0xdbff &&
+            index + 1 < value.length &&
+            value.charCodeAt(index + 1) >= 0xdc00 &&
+            value.charCodeAt(index + 1) <= 0xdfff
+        ) {
+            length += 4;
+            index++;
+        } else {
+            // This also matches TextEncoder's replacement behavior for an
+            // unpaired UTF-16 surrogate.
+            length += 3;
+        }
+    }
+    return length;
+}
+
+/**
+ * Encodes XML chunks straight into one JSZip-supported byte buffer. This
+ * avoids both Blob/FileReader reads in desktop WebViews and Array.join's
+ * string-size limit without making temporary copies of every XML chunk.
+ */
+function encodeXmlChunks(chunks: string[]): Uint8Array {
+    const byteLength = chunks.reduce((total, chunk) => total + utf8ByteLength(chunk), 0);
+    const output = new Uint8Array(byteLength);
+    const encoder = new TextEncoder();
+    let offset = 0;
+
+    for (const chunk of chunks) {
+        const { read, written } = encoder.encodeInto(chunk, output.subarray(offset));
+        if (read !== chunk.length) {
+            throw new Error('Could not encode complete 3MF model XML');
+        }
+        offset += written;
+    }
+
+    return output;
+}
+
 /**
  * Meshes tagged with the same `userData.kromacutExportGroup` key are merged
  * into a single 3MF object (used by Flat Paint to export one object per
@@ -634,12 +682,11 @@ export async function exportObjectTo3MFBlob(
 
     flushXmlChunk();
 
-    // JSZip reads Blob inputs through FileReader. In the Tauri webview that
-    // extra read can fail with NotReadableError even though this XML was just
-    // generated in memory. Passing text lets JSZip encode it directly.
-    const modelXml = xmlParts.join('');
-    xmlParts.length = 0;
-    zip.folder('3D')?.file('3dmodel.model', modelXml);
+    // JSZip accepts Uint8Array directly. Encoding into it chunk-by-chunk
+    // avoids both the Tauri WebView FileReader failure for Blobs and
+    // Array.join's string-size limit for large models.
+    const modelXmlBytes = encodeXmlChunks(xmlParts.splice(0));
+    zip.folder('3D')?.file('3dmodel.model', modelXmlBytes, { binary: true });
 
     // Generate Metadata/model_settings.config
     // This is required for Bambu Studio / Orca Slicer / Creality Print to correctly identify
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index b3281ae..6754c57 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -147,6 +147,7 @@ function canonicalOptimizerInput(
             id: filament.id,
             color: filament.color,
             td: filament.td,
+            calibrationTd: filament.calibration?.td ?? null,
         })),
         clusters: context.imageColors.map((color) => ({
             L: color.L,
@@ -181,7 +182,11 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
 
     return (filaments) => {
         if (filaments.length === 0) return Infinity;
-        const sequenceKey = filaments.map((filament) => `${filament.id}:${filament.color}:${filament.td}`).join('|');
+        const sequenceKey = filaments
+            .map((filament) =>
+                [filament.id, filament.color, filament.td, ...(filament.calibration?.td ?? [])].join(':')
+            )
+            .join('|');
         let palette = paletteCache.get(sequenceKey);
         if (!palette) {
             palette = buildAchievableColorPalette(
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 8b97442..be07d9e 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -39,6 +39,16 @@ function assertAlmostEqual(actual: number, expected: number, message?: string) {
     );
 }
 
+test('CIEDE2000 distance matches the published reference pair', async () => {
+    const { deltaE2000Lab } = await loadAutoPaintModule();
+    const distance = deltaE2000Lab(
+        { L: 50, a: 2.6772, b: -79.7751 },
+        { L: 50, a: 0, b: -82.7485 }
+    );
+
+    assert.ok(Math.abs(distance - 2.0425) < 0.0001);
+});
+
 test('transition thickness stays printable and respects its TD cap', async () => {
     const { calculateTransitionThickness, hexToRgb } = await loadAutoPaintModule();
     const layerHeight = 0.1;
@@ -66,6 +76,78 @@ test('transition thickness stays printable and respects its TD cap', async () =>
     );
 });
 
+test('calibrated per-channel TDs tint blends without changing scalar TD behavior', async () => {
+    const { blendColors } = await loadAutoPaintModule();
+    const background = { r: 0, g: 0, b: 0 };
+    const filament = { r: 200, g: 200, b: 200 };
+
+    const scalar = blendColors(background, filament, 1, 0.25);
+    const equalChannels = blendColors(background, filament, [1, 1, 1], 0.25);
+    const calibrated = blendColors(background, filament, [0.5, 1, 2], 0.25);
+
+    assert.deepEqual(equalChannels, scalar, 'equal channel TDs must preserve legacy scalar blending');
+    assert.ok(
+        calibrated.r > calibrated.g && calibrated.g > calibrated.b,
+        'shorter channel TDs must become opaque sooner'
+    );
+});
+
+test('calibrated channel TDs flow through generated auto-paint preview slices', async () => {
+    const { autoPaintToSliceHeights, generateAutoLayers, hexToRgb } =
+        await loadAutoPaintModule();
+    const baseFilaments = [
+        { id: 'black', color: '#000000', td: 1 },
+        { id: 'white', color: '#ffffff', td: 16 },
+    ];
+    const calibratedFilaments = [
+        baseFilaments[0],
+        {
+            ...baseFilaments[1],
+            calibration: {
+                color: '#ffffff',
+                measurements: [],
+                td: [8, 16, 32] as [number, number, number],
+                tdSingleValue: 16,
+                confidence: 1,
+                calibrationDate: '2026-01-01T00:00:00.000Z',
+            },
+        },
+    ];
+    const swatches = [
+        { hex: '#000000', count: 1 },
+        { hex: '#ffffff', count: 1 },
+    ];
+    const scalarResult = generateAutoLayers(baseFilaments, swatches, 0.1, 0.2, undefined, false);
+    const calibratedResult = generateAutoLayers(
+        calibratedFilaments,
+        swatches,
+        0.1,
+        0.2,
+        undefined,
+        false
+    );
+    const scalarSlices = autoPaintToSliceHeights(scalarResult, 0.1, 0.2);
+    const calibratedSlices = autoPaintToSliceHeights(calibratedResult, 0.1, 0.2);
+
+    assert.deepEqual(
+        calibratedSlices.colorSliceHeights,
+        scalarSlices.colorSliceHeights,
+        'zone thickness remains governed by the scalar working TD'
+    );
+    const whiteLayer = calibratedSlices.filamentSwatches.findIndex((swatch) => swatch.hex === '#ffffff');
+    assert.ok(whiteLayer >= 0, 'the calibrated filament should contribute preview layers');
+
+    const scalarColor = hexToRgb(scalarSlices.virtualSwatches[whiteLayer].hex);
+    const calibratedColor = hexToRgb(calibratedSlices.virtualSwatches[whiteLayer].hex);
+    assert.equal(scalarColor.r, scalarColor.g, 'the scalar white blend remains neutral');
+    assert.equal(scalarColor.g, scalarColor.b, 'the scalar white blend remains neutral');
+    assert.notEqual(
+        calibratedColor.r,
+        calibratedColor.b,
+        'calibrated channel TDs produce their measured color bias'
+    );
+});
+
 test('ideal-height zones include a foundation and remain contiguous when compressed', async () => {
     const { calculateIdealHeight, compressZones } = await loadAutoPaintModule();
     const layerHeight = 0.1;
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index 17f7953..e737fa0 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -1406,7 +1406,7 @@ test('3MF export keeps generated meshes as separate layer objects', async () =>
     );
 });
 
-test('3MF export does not require FileReader to read generated model XML', async () => {
+test('3MF export streams generated model XML without FileReader', async () => {
     const { exportObjectTo3MFBlob } = await loadExport3mfModule();
     const previousFileReader = globalThis.FileReader;
 
@@ -1431,6 +1431,13 @@ test('3MF export does not require FileReader to read generated model XML', async
     }
 });
 
+test('3MF export keeps generated model XML chunked for large models', () => {
+    const source = readFileSync(resolve(process.cwd(), 'src/lib/export3mf.ts'), 'utf8');
+
+    assert.doesNotMatch(source, /xmlParts\.join\(/);
+    assert.match(source, /encodeXmlChunks\(xmlParts\.splice\(0\)\)/);
+});
+
 test('exports include preview-hidden layers with their original filament colors', async () => {
     const root = new THREE.Group();
     const first = createLayerMesh(createSharedCubeGeometry(), 0xff0000);
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 270d2a0..8ecbbb8 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -145,6 +145,29 @@ test('cache keys include all weighted clusters and optimizer tuning', async () =
     });
     assert.equal(changedTemperature.cacheHit, undefined, 'a changed temperature must miss cache');
     assert.equal(getOptimizerCacheStats().size, 3);
+
+    const calibratedFilaments = filaments.map((filament, index) =>
+        index === 2
+            ? {
+                  ...filament,
+                  calibration: {
+                      color: filament.color,
+                      measurements: [],
+                      td: [1.2, 1.8, 2.4] as [number, number, number],
+                      tdSingleValue: filament.td,
+                      confidence: 1,
+                      calibrationDate: '2026-01-01T00:00:00.000Z',
+                  },
+              }
+            : filament
+    );
+    const changedCalibration = optimizeFilamentOrder(calibratedFilaments, manyClusters, options);
+    assert.equal(
+        changedCalibration.cacheHit,
+        undefined,
+        'changed per-channel calibration TDs must miss cache'
+    );
+    assert.equal(getOptimizerCacheStats().size, 4);
 });
 
 test('default optimizer seeds are stable and cacheable', async () => {

From 109a417e97c7c14ef7883ddaa55d5e29363a9934 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 21 Jun 2026 21:38:48 +0300
Subject: [PATCH 14/81] Keep auto-paint plan local

---
 .gitignore                         |   1 +
 docs/AUTOPAINT_IMPROVEMENT_PLAN.md | 424 -----------------------------
 2 files changed, 1 insertion(+), 424 deletions(-)
 delete mode 100644 docs/AUTOPAINT_IMPROVEMENT_PLAN.md

diff --git a/.gitignore b/.gitignore
index 4cbec2b..8f9935e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -27,6 +27,7 @@ test-results/
 
 .todo
 .claude
+docs/AUTOPAINT_IMPROVEMENT_PLAN.md
 
 # Tauri / Rust build artifacts
 src-tauri/target/
diff --git a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md b/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
deleted file mode 100644
index b66174a..0000000
--- a/docs/AUTOPAINT_IMPROVEMENT_PLAN.md
+++ /dev/null
@@ -1,424 +0,0 @@
-# Auto-Paint Algorithm Improvement Plan
-
-> Status: **PLANNED — no implementation started.**
-> Source: code review of the Auto-paint pipeline (2026-06-11). All file/line references
-> are against `develop` at commit `6b55485`.
-
-This document records verified findings about the current Auto-paint algorithms and
-turns them into a phased, testable improvement plan. Each phase is independently
-shippable and ordered so that correctness fixes land before behavioral changes, and
-measurement lands before everything.
-
----
-
-## 1. Invariants that must hold in every phase
-
-These come from product constraints and existing tests. Any phase that breaks one is
-not shippable.
-
-- **Result schema stability**: `AutoPaintResult` and `autoPaintToSliceHeights` output
-  shapes are unchanged. Export (3MF/STL), persisted state (`ThreeDControlsStateShape`),
-  and saved profiles all consume these.
-- **Printability**: foundation zone always present; slice heights are exact
-  `layerHeight` multiples (first = `max(firstLayerHeight, layerHeight)`); ≤500 layers
-  (`autoPaint.ts:1516`); no zero-thickness zones.
-- **Layer snapping**: per-pixel snapping behavior in `ThreeDView.tsx` untouched unless a
-  phase explicitly targets it.
-- **Determinism**: same inputs + same seed → byte-identical result. (Phase 3 makes the
-  no-seed case deterministic too; it must not break the seeded case.)
-- **Worker responsiveness**: algorithm work stays in `autoPaint.worker.ts`; the main
-  thread never runs the optimizer.
-- **User data compatibility**: persisted `optimizerAlgorithm` values
-  (`auto | exhaustive | simulated-annealing | genetic`), saved profiles (`.kfil`/`.kapp`),
-  and calibration data (`CalibrationResult`) keep their meaning.
-- **Existing test suites stay green**: `tests/export3mf.test.ts` (manifoldness, color
-  collapse, seeded auto-paint regression stacks) and `tests/e2e/kromacut-flow.spec.ts`.
-
----
-
-## 2. Verified findings
-
-### F1 — Legacy enhanced path is unreachable in production
-
-`useAutoPaintWorker.ts:203-206` always sends `optimizerOptions` (at minimum
-`{ algorithm }`), and `findBestFilamentOrder` (`autoPaint.ts:835-843`) routes to the
-advanced optimizer whenever options are present. The legacy subset-aware search
-(`findBestFilamentOrderLegacy`, `autoPaint.ts:974-1063`) only runs from tests and
-`debugAutoPaint`. Production therefore always uses the weaker scorer (F2) and never
-does subset selection (F3).
-
-### F2 — Advanced optimizer scores a different physical model than what gets built
-
-`scoreFilamentOrder` → `findBestAchievableColor` → `simulateStackAtHeight`
-(`optimizer.ts:166-238`):
-
-- Transition thickness budget is `prevFilament.td * 3` (`optimizer.ts:226`) — keyed to
-  the **previous** filament's TD. The real zone model sizes zones by the **incoming**
-  filament's TD and ΔE convergence (`calculateTransitionThickness`,
-  `autoPaint.ts:284-325`).
-- Because that budget is independent of color distance, the advanced score **cannot
-  see transition cost** (a yellow→purple order is not penalized for its expensive
-  transition).
-- Samples 20 uniform heights; ignores foundation opacity, layer grid, and compression.
-- Objective is pure weighted mean ΔE — it lacks the legacy scorer's height-spread,
-  layer-count (0.5/layer), and transition-waste (1.5/entry) penalties
-  (`scoreSequenceAgainstImage`, `autoPaint.ts:734-806`).
-- Minor: `findBestAchievableColor`'s sampled height range includes the foundation TD
-  that `simulateStackAtHeight` never consumes (top samples are duplicates).
-
-The legacy scorer builds its palette via `calculateIdealHeight` — the same model that
-`generateAutoLayers` builds geometry with and `autoPaintToSliceHeights` previews with.
-The optimizer optimizes objective A; the build pipeline realizes model B.
-
-### F3 — Subset selection lost
-
-All three advanced algorithms permute the **full** filament set. Legacy evaluated all
-non-empty subsets for ≤6 filaments (1,956 evaluations at N=6) and stopped greedy
-addition when no filament helped for >6. Today nothing can drop a harmful filament;
-repeated swaps can only add occurrences.
-
-### F4 — Region weighting is spatially blind and its mode detection is inverted
-
-- Swatches lose pixel positions at extraction (`useSwatches.ts:62-109` — pure color
-  histogram).
-- `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) reduces the full W×H weight map
-  to mean+variance, then boosts clusters by **luminance band**, never by location.
-- Numerically verified (replicated `generateCenterWeightedMapSimple` /
-  `generateEdgeWeightedMapSimple` + normalization): center maps have variance
-  ≈0.055-0.067 → classified `isHighContrast=true` → applies the **edge** adjustment;
-  edge maps on 1:1/4:3 images have variance ≈0.045-0.048 → applies the **center**
-  adjustment. The modes are swapped on square images and identical (both "edge") at
-  16:9. Behavior depends on aspect ratio, never on image content.
-- `generateAutoLayers:1267-1282` allocates the full Float32Array map per request
-  (~45 MB for the 3888×2916 fixture) only to compute two scalars.
-- The repeated-swaps path ignores region weights entirely
-  (`buildRepeatedSwapSequence` clusters at `autoPaint.ts:1098` without them).
-
-### F5 — Optimizer cache returns stale results across region modes
-
-`OptimizerCache.getCacheKey` (`optimizer.ts:101-114`) hashes the first 20 cluster
-colors but **not their weights**, and not `regionWeights` or SA/GA tuning params.
-Region weighting only changes weights → identical key → with an explicit seed,
-switching Region priority returns the cached previous-mode order (UI shows "Cache
-hit").
-
-### F6 — Non-deterministic by default
-
-Without a user seed, SA/GA seed from `Date.now()` (`optimizer.ts:525`): same image +
-filaments produce different orders run to run. Caching is also disabled in that case.
-
-### F7 — Repeated swaps are a second, conflicting optimization
-
-`buildRepeatedSwapSequence` (`autoPaint.ts:1088-1185`): greedy insert-only; position
-loop starts at 1 (`:1137`) so the foundation can never change; capped at 4 insertions;
-scored with the **legacy** objective on top of a base order chosen by the **advanced**
-objective; no remove/relocate moves.
-
-### F8 — Physics gaps shared by both paths
-
-- `blendColors` (`autoPaint.ts:217-241`) lerps in gamma sRGB with a **scalar**
-  transmission. Calibration already fits **per-channel TD** (`CalibrationResult.td:
-[r,g,b]`, `calibration.ts:283-322`) that auto-paint never reads — only
-  `tdSingleValue`.
-- `FRONTLIT_TD_SCALE = 0.1` (`autoPaint.ts:271`) is a hard-coded global fudge.
-- Zone _i_ blends over the **pure** color of filament _i−1_
-  (`buildAchievableColorPalette:656-663`, `autoPaintToSliceHeights:1499-1506`). Valid
-  pre-compression (zones are sized for ΔE convergence), wrong after `compressZones` —
-  compressed previews look cleaner than the print will, and ordering is never re-scored
-  under compression.
-- ΔE is CIE76, which over-penalizes chroma differences in saturated regions.
-- Note: gamma-space lerp is self-consistent with how calibration _measures_
-  (`predictWorkingBlendRgb`, `calibration.ts:128-140` fits `tdSingleValue` against the
-  same gamma-space model). Any change to the blend model must move together with
-  calibration fitting or it invalidates calibrated TDs.
-
-### F9 — Worker protocol: no progress, terminate-only cancel
-
-`autoPaint.worker.ts` is single-shot request/response. Exhaustive at 8 filaments ≈
-40,320 permutations × ~670 stack sims each with zero progress feedback. The hook
-terminates + recreates the worker per input change (`useAutoPaintWorker.ts:177-219`),
-paying worker startup each time.
-
-### F10 — Minor issues
-
-- `luminanceToHeight` (`autoPaint.ts:1551`) is dead code (no callers).
-- `scoreSequenceAgainstImage` multiplies weighted ΔE by `imageTargets.length`
-  (`autoPaint.ts:777`), so fixed penalty constants change relative strength with
-  cluster count.
-- SA neighbor allows `i === j` (wasted iterations) (`optimizer.ts:333-335`).
-- Zone caps (`td * 0.7`) produce off-grid zone boundaries (hidden by per-pixel re-snap).
-- UI "Exhaustive (≤8 filaments)" implies subset search; it is full-set permutations
-  only. Hook silently downgrades exhaustive >8 to `auto`
-  (`useAutoPaintWorker.ts:189-192`), duplicating a guard in `ThreeDControls.tsx:130-134`.
-- `tests/`: **no unit tests exist for `autoPaint.ts` or `optimizer.ts` internals.**
-  Coverage is indirect (export3mf seeded stacks, e2e flow).
-
----
-
-## 3. The plan
-
-Phases are ordered: measurement → low-risk correctness → objective unification →
-search-space unification → polish → gated physics. Do not reorder Phase 4 before
-Phase 3 (widening the search around a misaligned objective optimizes the wrong thing
-harder).
-
-### Phase 0 — Test baseline + benchmark harness (prerequisite for everything)
-
-Goal: pin current behavior and make quality measurable before changing anything.
-
-- [x] **0.1 Unit tests for `autoPaint.ts` pure functions** (new
-  `tests/autoPaint.test.ts`):
-  - `calculateTransitionThickness`: returns ≥ `layerHeight`; respects `0.7×TD` cap;
-    early-exit for near-identical colors.
-  - `compressZones`: zones tile `[0, H]` contiguously (each `startHeight` equals
-    previous `endHeight`); ratio honored; no-op when under max.
-  - `calculateIdealHeight`: foundation = `max(baseThickness, td×1.3)`; zone count =
-    filament count.
-  - `autoPaintToSliceHeights`: every slice = `layerHeight` (first =
-    `max(firstLayerHeight, layerHeight)`); ≤500 layers; `virtualSwatches`,
-    `filamentSwatches`, `colorSliceHeights`, `colorOrder` lengths agree.
-- [x] **0.2 Seeded golden snapshots** of `generateAutoLayers` for the
-      2/4/8-color `.kapp` profiles × both fixture images (`tests/assets`), with
-      enhanced on/off and repeated swaps on/off: assert `filamentOrder`, zone
-      boundaries (±1e-6), `totalHeight`, `compressionRatio`. These get **re-baselined
-      deliberately** in Phases 3/4 — their job is making behavior changes visible,
-      not frozen.
-- [x] **0.3 Determinism tests**: per algorithm, same seed twice → deep-equal result.
-- [x] **0.4 Benchmark harness** (`tests/benchmark/autoPaintBench.ts`, runnable via a
-  package script, not part of CI gating initially). Per image × profile × algorithm ×
-  seed, emit JSON with:
-  - Weighted mean ΔE (report **both** CIE76 and CIEDE2000) from clustered targets to
-    nearest achievable palette color; weighted P95.
-  - Coverage@2.3 and @5.0 (fraction of image weight within JND thresholds).
-  - **End-to-end realized error**: run the ThreeDView polyline mapping (port of
-    `ThreeDView.tsx:753-1002`, reuse the port in `tests/export3mf.test.ts:~700-768`)
-    over fixture pixels; report pixel-weighted ΔE of mapped vs original. *This is the
-    primary metric — it measures the whole pipeline, not the scorer's opinion of itself.*
-  - Structure: total height, layer count, sequence length, wasted-layer fraction,
-    compression ratio under a fixed `maxHeight` scenario.
-  - Cost: wall time, evaluations, iterations.
-  - Stability: cross-seed rank agreement for SA/GA.
-- [x] **0.5 Acceptance rule for later phases** (documented in the harness README):
-      end-to-end realized ΔE improves on average across fixtures and regresses on no
-      fixture beyond tolerance (suggest 5%), within cost budgets (≤2 s for 8 filaments).
-
-Risk: none (additive). Estimated scope: tests only.
-
-### Phase 1 — Region weighting made spatially correct; delete the heuristic
-
-Goal: per-color weights actually reflect where colors sit in the image. Fixes F4.
-
-- [x] **1.1** Extend swatch extraction (`useSwatches.ts`) to accumulate, per color, in
-      the same tile pass that builds the histogram: `centerWeight` and `edgeWeight`
-      (sum of the geometric per-pixel weight functions evaluated inline — no
-      Float32Array maps materialized). Both modes computed in one pass so switching
-      modes never rescans the image. Swatch entries gain optional fields; existing
-      consumers unaffected.
-- [x] **1.2** Thread the chosen mode's weighted count through
-      `useAutoPaintWorker` → worker request → `generateAutoLayers`: when mode ≠
-      `uniform`, use the weighted count as `count` input to `clusterImageColors`
-      (which already weights by count). Keep raw count for display.
-- [x] **1.3** Delete `applyRegionWeightHeuristic` (`autoPaint.ts:868-924`) and the
-      per-request map generation in `generateAutoLayers:1267-1282`. Remove
-      `regionWeights` from `OptimizerOptions`/`ScoringContext` (or keep as deprecated
-      no-op field if persisted anywhere — verify; current persistence stores only the
-      mode string, so removal should be safe).
-- [x] **1.4** Repeated-swaps path uses the same weighted targets (fixes the
-      inconsistency at `autoPaint.ts:1098`).
-- [x] **1.5 Tests**: synthetic fixture (red center disc on blue border):
-  - `center` mode must rank red clusters above blue; `edge` mode the reverse.
-  - Mode `uniform` byte-identical to pre-change output (golden snapshot).
-  - No `Float32Array(width*height)` allocation in the worker path (can assert via
-    absence of the code path / memory not practical — code-level assertion).
-
-Risk: low-medium (plumbing). User-visible: center/edge modes start doing what their
-labels say (today they are swapped or no-ops — treat as bug fix, note in CHANGELOG).
-
-### Phase 2 — Cache correctness + determinism by default
-
-Goal: fix F5, F6. Small, independent, immediately shippable.
-
-- [x] **2.1** Cache key includes cluster **weights**, full cluster set (not first 20),
-      and all algorithm-relevant options (temperature, cooling, population, mutation,
-      elite, maxIterations). Simplest robust form: hash a canonical JSON of
-      `{filaments, clusters(L,a,b,weight), layerHeight, firstLayerHeight, algorithm,
-    seed, tuning}`.
-- [x] **2.2** Default seed = stable 32-bit hash of the same canonical inputs instead of
-      `Date.now()` (`optimizer.ts:525`). User-provided seed still overrides. This makes
-      every run reproducible and cacheable; remove the `hasExplicitSeed` cache gating.
-- [x] **2.3 Tests**: same inputs, no seed, twice → identical result. Toggling region
-      mode with a fixed seed → different cache entries (regression test for F5).
-      Changing only `temperature` → cache miss.
-
-Risk: low. User-visible: results stop changing between identical runs (improvement);
-"Cache hit" indicator becomes trustworthy.
-
-### Phase 3 — Unify the objective (one scorer, zone-accurate)
-
-Goal: the optimizer optimizes the same model the pipeline builds. Fixes F2; partially
-F8 (scoring side of the pure-background issue can be folded in here or deferred to
-Phase 6b).
-
-- [x] **3.1** Move/share the palette builder: expose `buildAchievableColorPalette` +
-      `scoreSequenceAgainstImage` (or a thin `scoreSequence(sequence, context)`
-      wrapper) for use by `optimizer.ts`. `ScoringContext` carries the weighted Lab
-      targets as today.
-- [x] **3.2** Replace `scoreFilamentOrder`/`findBestAchievableColor`/
-      `simulateStackAtHeight` with the unified scorer in exhaustive, SA, and GA.
-- [x] **3.3 Performance work so per-eval cost stays acceptable**:
-  - Memoize `calculateTransitionThickness(bgColorHex, filamentId)` per optimizer run —
-    pair space ≤ N², eliminates the dominant inner loop.
-  - Memoize palette per unique sequence string (SA revisits neighbors).
-  - Fix the score-scale fragility while touching it: normalize by total target weight
-    instead of multiplying by `imageTargets.length` (`autoPaint.ts:777`), and rescale
-    the structural penalty constants to match (calibrate against Phase 0 harness so
-    rankings on fixtures are preserved or improved — this is a tuning task, use the
-    harness).
-- [x] **3.4** SA neighbor: redraw `j` until `j ≠ i` (F10).
-- [x] **3.5 Tests**: property test — the score the optimizer reports for its chosen
-      order equals `scoreSequence` of that order under the build model (was untrue
-      before). Re-baseline Phase 0 golden snapshots; harness must satisfy the Phase 0.5
-      acceptance rule. Budget: ≤2 s for 8 filaments (exhaustive falls back per
-      existing UI guard).
-      Validated on the development machine with `npm run benchmark:autopaint` against
-      Phase 2 commit `966c13a`: Auto-mode average realized ΔE improved from 34.75 to
-      30.23, every fixture held or improved, and the slowest 8-filament Auto run was
-      42 ms.
-
-Risk: medium — orders will change for users (expected: improvement, verified by
-harness). Determinism preserved (seeded). Schema unchanged.
-
-### Phase 4 — Variable-length search space (subsets + repeats, natively)
-
-Goal: one search over sequences, restoring subset selection (F3) and integrating
-repeats (F7). Replaces `buildRepeatedSwapSequence`.
-
-Search space: sequences of filament occurrences, length 1..(N + 4), no consecutive
-duplicates, repeats allowed **only when** `allowRepeatedSwaps` is on (otherwise
-sequences are permutations of subsets). 500-layer guard enforced via scoring penalty +
-hard cap.
-
-- [x] **4.1** `exhaustive` (≤6 filaments): all permutations of all non-empty subsets
-      (1,956 evals at N=6 — legacy semantics restored) under the unified scorer. When
-      repeats are on, extend with the bounded insertion expansion as a post-pass _of
-      the same scorer_ (cheap and already consistent), or fold repeats into beam
-      search (4.2) and route there. Update UI label/threshold honestly (≤6, not ≤8;
-      keep the existing >threshold downgrade-to-auto behavior in one place — remove
-      the duplicate guard, F10).
-- [x] **4.2** **Beam search** (new internal algorithm, used by `auto` for 7-12
-      filaments): build sequences bottom-up; at each depth keep top-K (K≈100, tunable
-      via harness) partial stacks scored with the unified scorer; candidate extensions
-      = any non-duplicate filament occurrence + "stop" (subset selection falls out
-      naturally). Deterministic, anytime, trivially reports progress (depth/maxDepth).
-- [x] **4.3** **Variable-length SA** (replaces permutation SA; used by
-      `simulated-annealing` and by `auto` for >12): moves = swap(i,j), relocate(i→j),
-      insert(filament, pos) [only if repeats allowed or filament unused],
-      remove(pos) [if length > 1], replace(pos, filament). Seeded move selection;
-      geometric cooling as today.
-- [x] **4.4** GA (`genetic` UI value): keep permutation GA over the full set initially
-      but wrap with subset-aware repair, or route `genetic` to variable-length SA with
-      a different default budget if GA quality on the harness is not competitive.
-      Decide on harness data, not in advance.
-- [x] **4.5** Delete `buildRepeatedSwapSequence`; `generateAutoLayers` passes
-      `allowRepeatedSwaps` into optimizer options instead
-      (`autoPaint.ts:1307-1316`).
-- [x] **4.6 Tests**: printability invariants (foundation exists; no consecutive
-  duplicate filament ids; sequence length caps; result schema unchanged; slice snapping
-  unchanged); per-seed determinism for each algorithm; harness non-regression per
-  Phase 0.5; specific scenario tests:
-  - A filament strictly worse than every alternative (e.g., a near-duplicate hue with
-    worse TD) gets dropped (subset regression — impossible today).
-  - Thin-white-over-red produces a pink intermediate when repeats are on (repeated-swap
-    regression).
-  - `allowRepeatedSwaps=false` → no filament appears twice.
-  Validated on the development machine with `npm run benchmark:autopaint` against
-  Phase 3 commit `bc1d155`: Auto-mode average realized ΔE improved from 30.23 to
-  29.96, every fixture held or improved, and the slowest 8-filament Auto run was
-  331 ms.
-
-Risk: medium-high (largest behavioral change; biggest quality upside). UI: **no new
-dropdown entries** — `auto/exhaustive/simulated-annealing/genetic` keep their persisted
-values and re-map internally (decision log §4).
-
-### Phase 5 — Worker progress + lifecycle polish
-
-Goal: fix F9 ergonomics. Independent of phases 3-4 but nicer after them (beam search
-has natural progress).
-
-- [x] **5.1** Optimizer accepts `onProgress(iteration, total, bestScore)`; worker
-      throttles (~10 Hz) `postMessage({ type: 'progress', id, ... })`; final message
-      keeps the current shape (`{ id, result }`) for compatibility.
-- [x] **5.2** Hook surfaces `progress` in `UseAutoPaintWorkerResult`; AutoPaintTab
-      shows it next to the spinner ("Optimizing… 43%").
-- [x] **5.3** Kept terminate-based cancellation. A warm worker was not added because
-      its startup cost is not currently noticeable enough to justify a more complex
-      cancellation path.
-- [x] **5.4 Tests**: progress monotonic 0→1 (mirror `tests/algorithms-progress.test.ts`
-      pattern); stale progress messages (old `id`) ignored.
-
-Risk: low.
-
-### Phase 6 — Physics upgrades (each gated behind a constant + harness validation)
-
-Goal: close F8 where measurement proves it helps. Each item independent; ship only
-with harness evidence. These change preview colors for existing projects — CHANGELOG
-each.
-
-- [x] **6a Per-channel TD blending where calibration exists**: `blendColors` uses
-      `calibration.td: [r,g,b]` (per-channel transmission, gamma-space — consistent
-      with how calibration measures) when present; scalar `tdSingleValue` fallback
-      unchanged for uncalibrated filaments. Touches `blendColors` call sites in
-      `autoPaint.ts` only; `Filament` already carries `calibration`.
-- [ ] **6b Compression-aware backgrounds**: implemented behind
-      `USE_COMPRESSION_AWARE_BACKGROUNDS`, but not enabled. The harness regressed the
-      8-color large-image case from ΔE 11.58 to 13.26 (14.5%), beyond the 5% tolerance.
-      Revisit only with a better compression model or measured compressed-stack data.
-- [x] **6c CIEDE2000 evaluation**: implemented behind `OPTIMIZER_DISTANCE_METRIC` for
-      scoring and clustering, but retained CIE76. The harness put CIEDE2000's two
-      8-filament runs at 4.1–4.7 s, over the 2 s budget, so it did not earn adoption.
-- [x] **6d FRONTLIT_TD_SCALE**: deliberately retained at 0.1. A calibrated front-lit
-      factor needs a new measurement workflow and remains out of scope.
-- [x] **6e Cleanup**: deleted dead `luminanceToHeight`; updated the
-      stale module doc header (`autoPaint.ts:1-17`).
-
-Risk: medium (visual shifts); mitigated by gating + harness + CHANGELOG.
-
----
-
-## 4. Decision log
-
-- **No new UI algorithm choices.** Persisted `optimizerAlgorithm` values keep their
-  names; internals re-map (`auto` → subset-exhaustive ≤6 / beam 7-12 / var-length SA
-  above; `exhaustive` → subset-exhaustive with honest ≤6 cap; `simulated-annealing` →
-  variable-length SA; `genetic` → keep or alias per Phase 4.4 harness data). Beam
-  search is an `auto` implementation detail, not a dropdown entry. Rationale: choices
-  are speed/quality trade-offs users already understand; renaming breaks saved
-  profiles/state.
-- **Rejected: DP / shortest-path over discretized color states.** Reachable-color
-  state space (Lab × height with path-dependent blending) discretizes poorly; beam
-  search captures the same "build bottom-up, prune" idea without state-explosion risk.
-- **Rejected (for now): variable-length genomes in GA.** Crossover design is fiddly;
-  at ≤16 filaments variable-length SA + beam cover the space. Revisit only if harness
-  shows SA stuck.
-- **Gamma-space blending stays** (not switched to linear-light): calibration fits TDs
-  against the same gamma-space model, so the pair is self-consistent; changing it
-  would invalidate users' calibrated TDs (F8 note). Per-channel TD (6a) improves hue
-  realism without breaking that consistency.
-- **`buildRepeatedSwapSequence` is deleted in Phase 4**, not improved in place — its
-  objective-mixing is structural (F7).
-
-## 5. Quick reference: finding → phase
-
-| Finding                                   | Fixed in            |
-| ----------------------------------------- | ------------------- |
-| F1 legacy path dead / weak scorer in prod | Phase 3 (+4)        |
-| F2 misaligned objective                   | Phase 3             |
-| F3 subset selection lost                  | Phase 4             |
-| F4 region weighting blind/inverted        | Phase 1             |
-| F5 stale cache across modes               | Phase 2             |
-| F6 non-deterministic default              | Phase 2             |
-| F7 repeated swaps bolt-on                 | Phase 4             |
-| F8 physics gaps                           | Phase 6 (a-d)       |
-| F9 worker progress                        | Phase 5             |
-| F10 minor issues                          | Phases 3.4, 4.1, 6e |
-| No unit tests / no benchmark              | Phase 0             |

From 9d766cd0616d1a92891ecfb7d3bb867b58c8f307 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 22 Jun 2026 21:15:28 +0300
Subject: [PATCH 15/81] Allow explicit exhaustive auto-paint search

---
 src/components/AutoPaintTab.tsx   |  8 ++------
 src/components/ThreeDControls.tsx |  6 ------
 src/lib/optimizer.ts              | 10 +++-------
 tests/optimizer.test.ts           | 11 ++++++++---
 4 files changed, 13 insertions(+), 22 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 2e5739d..60029a1 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -683,12 +683,8 @@ export default function AutoPaintTab({
                                             <SelectItem value="auto" className="text-xs">
                                                 Auto (smart selection)
                                             </SelectItem>
-                                            <SelectItem
-                                                value="exhaustive"
-                                                className="text-xs"
-                                                disabled={filaments.length > 6}
-                                            >
-                                                Exhaustive (≤6 filaments)
+                                            <SelectItem value="exhaustive" className="text-xs">
+                                                Exhaustive (recommended ≤6)
                                             </SelectItem>
                                             <SelectItem
                                                 value="simulated-annealing"
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 5078c80..64eaf17 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -127,12 +127,6 @@ export default function ThreeDControls({
         persisted?.regionWeightingMode ?? 'uniform'
     );
 
-    useEffect(() => {
-        if (optimizerAlgorithm === 'exhaustive' && filaments.length > 6) {
-            setOptimizerAlgorithm('auto');
-        }
-    }, [filaments.length, optimizerAlgorithm]);
-
     const handleEnhancedColorMatchChange = useCallback((v: boolean) => {
         setEnhancedColorMatch(v);
         if (!v) {
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 6754c57..36124e3 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -210,7 +210,7 @@ export function scoreFilamentSequence(filaments: Filament[], context: ScoringCon
 // Variable-length sequence helpers
 // ============================================================================
 
-const MAX_EXHAUSTIVE_FILAMENTS = 6;
+const MAX_AUTO_EXHAUSTIVE_FILAMENTS = 6;
 const AUTO_BEAM_MAX_FILAMENTS = 12;
 const MAX_EXTRA_REPEATS = 4;
 const DEFAULT_BEAM_WIDTH = 100;
@@ -325,7 +325,7 @@ function expandWithRepeatedFilaments(
 }
 
 // ============================================================================
-// Exhaustive Search (all ordered non-empty subsets, up to six filaments)
+// Exhaustive Search (all ordered non-empty subsets)
 // ============================================================================
 
 function optimizeExhaustive(
@@ -656,15 +656,11 @@ function resolveAlgorithm(
     filamentCount: number
 ): ResolvedOptimizerAlgorithm {
     if (requested === 'auto') {
-        if (filamentCount <= MAX_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
+        if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
         if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
         return 'simulated-annealing';
     }
 
-    if (requested === 'exhaustive' && filamentCount > MAX_EXHAUSTIVE_FILAMENTS) {
-        return filamentCount <= AUTO_BEAM_MAX_FILAMENTS ? 'beam' : 'simulated-annealing';
-    }
-
     return requested;
 }
 
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 8ecbbb8..132f039 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -307,7 +307,7 @@ test('variable-length optimizers preserve sequence safety invariants', async (t)
     }
 });
 
-test('auto uses beam search for medium profiles and protects exhaustive search above six', async () => {
+test('auto uses beam search for medium profiles while explicit exhaustive remains exact', async () => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
@@ -321,14 +321,19 @@ test('auto uses beam search for medium profiles and protects exhaustive search a
         seed: 7,
         cachingEnabled: false,
     });
-    const guardedExhaustive = optimizeFilamentOrder(mediumProfile, context, {
+    const exhaustive = optimizeFilamentOrder(mediumProfile, context, {
         algorithm: 'exhaustive',
         seed: 7,
         cachingEnabled: false,
     });
 
     assert.equal(auto.resolvedAlgorithm, 'beam');
-    assert.equal(guardedExhaustive.resolvedAlgorithm, 'beam');
+    assert.equal(exhaustive.resolvedAlgorithm, 'exhaustive');
+    assert.equal(
+        exhaustive.iterations,
+        13_699,
+        'seven filaments have 13,699 ordered non-empty subsets'
+    );
     assert.ok(auto.order.length <= mediumProfile.length);
     assert.equal(new Set(auto.order.map((filament) => filament.id)).size, auto.order.length);
 });

From 30ecd49e57546f345d0a166c943980d041dbed80 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 22 Jun 2026 21:52:26 +0300
Subject: [PATCH 16/81] Add Reddit community links

---
 CHANGELOG.md              |  1 +
 README.md                 |  2 +-
 src/assets/discord.svg    |  1 +
 src/assets/github.svg     |  1 +
 src/assets/reddit.svg     |  1 +
 src/components/Header.tsx | 39 +++++++++++++++++++++++++++++++++------
 6 files changed, 38 insertions(+), 7 deletions(-)
 create mode 100644 src/assets/discord.svg
 create mode 100644 src/assets/github.svg
 create mode 100644 src/assets/reddit.svg

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4e311c3..d93196b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
+- **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 - **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
 - **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures palette and preview-realized color error, coverage, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles.
 - **Auto-paint optimization progress** - Enhanced matching now reports an approximate completion percentage while its background search is running.
diff --git a/README.md b/README.md
index a651ae5..f4c6a56 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 # Kromacut
 
-[![Patreon](https://img.shields.io/badge/Patreon-Support-orange?logo=patreon&logoColor=white)](https://www.patreon.com/cw/vycdev) [![Discord](https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/nU63sFMcnX) [![YouTube](https://img.shields.io/badge/YouTube-@vycdev-red?logo=youtube&logoColor=white)](https://www.youtube.com/@vycdev) [![Release](https://img.shields.io/github/v/release/vycdev/kromacut?cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases/latest) [![Repo size](https://img.shields.io/github/repo-size/vycdev/kromacut?cacheSeconds=3600)](https://github.com/vycdev/Kromacut) [![Total downloads](https://img.shields.io/github/downloads/vycdev/Kromacut/total?label=total%20downloads&cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases) [![Latest downloads](https://img.shields.io/github/downloads/vycdev/Kromacut/latest/total?cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases/latest)
+[![Patreon](https://img.shields.io/badge/Patreon-Support-orange?logo=patreon&logoColor=white)](https://www.patreon.com/cw/vycdev) [![Discord](https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white)](https://discord.gg/nU63sFMcnX) [![Reddit](https://img.shields.io/badge/Reddit-r%2Fkromacut-FF4500?logo=reddit&logoColor=white)](https://www.reddit.com/r/kromacut/) [![YouTube](https://img.shields.io/badge/YouTube-@vycdev-red?logo=youtube&logoColor=white)](https://www.youtube.com/@vycdev) [![Release](https://img.shields.io/github/v/release/vycdev/kromacut?cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases/latest) [![Repo size](https://img.shields.io/github/repo-size/vycdev/kromacut?cacheSeconds=3600)](https://github.com/vycdev/Kromacut) [![Total downloads](https://img.shields.io/github/downloads/vycdev/Kromacut/total?label=total%20downloads&cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases) [![Latest downloads](https://img.shields.io/github/downloads/vycdev/Kromacut/latest/total?cacheSeconds=3600)](https://github.com/vycdev/Kromacut/releases/latest)
 
 Open-source HueForge-style tool for converting images into stacked, color-layered 3D prints.
 
diff --git a/src/assets/discord.svg b/src/assets/discord.svg
new file mode 100644
index 0000000..9d7796b
--- /dev/null
+++ b/src/assets/discord.svg
@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Discord</title><path d="M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 00-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z"/></svg>
\ No newline at end of file
diff --git a/src/assets/github.svg b/src/assets/github.svg
new file mode 100644
index 0000000..538ec5b
--- /dev/null
+++ b/src/assets/github.svg
@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>GitHub</title><path d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></svg>
\ No newline at end of file
diff --git a/src/assets/reddit.svg b/src/assets/reddit.svg
new file mode 100644
index 0000000..ea03883
--- /dev/null
+++ b/src/assets/reddit.svg
@@ -0,0 +1 @@
+<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><title>Reddit</title><path d="M12 0C5.373 0 0 5.373 0 12c0 3.314 1.343 6.314 3.515 8.485l-2.286 2.286C.775 23.225 1.097 24 1.738 24H12c6.627 0 12-5.373 12-12S18.627 0 12 0Zm4.388 3.199c1.104 0 1.999.895 1.999 1.999 0 1.105-.895 2-1.999 2-.946 0-1.739-.657-1.947-1.539v.002c-1.147.162-2.032 1.15-2.032 2.341v.007c1.776.067 3.4.567 4.686 1.363.473-.363 1.064-.58 1.707-.58 1.547 0 2.802 1.254 2.802 2.802 0 1.117-.655 2.081-1.601 2.531-.088 3.256-3.637 5.876-7.997 5.876-4.361 0-7.905-2.617-7.998-5.87-.954-.447-1.614-1.415-1.614-2.538 0-1.548 1.255-2.802 2.803-2.802.645 0 1.239.218 1.712.585 1.275-.79 2.881-1.291 4.64-1.365v-.01c0-1.663 1.263-3.034 2.88-3.207.188-.911.993-1.595 1.959-1.595Zm-8.085 8.376c-.784 0-1.459.78-1.506 1.797-.047 1.016.64 1.429 1.426 1.429.786 0 1.371-.369 1.418-1.385.047-1.017-.553-1.841-1.338-1.841Zm7.406 0c-.786 0-1.385.824-1.338 1.841.047 1.017.634 1.385 1.418 1.385.785 0 1.473-.413 1.426-1.429-.046-1.017-.721-1.797-1.506-1.797Zm-3.703 4.013c-.974 0-1.907.048-2.77.135-.147.015-.241.168-.183.305.483 1.154 1.622 1.964 2.953 1.964 1.33 0 2.47-.81 2.953-1.964.057-.137-.037-.29-.184-.305-.863-.087-1.795-.135-2.769-.135Z"/></svg>
\ No newline at end of file
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 6cdcd5c..50a6a93 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -7,12 +7,10 @@ import {
     CheckCircle2,
     Download,
     Image,
-    Github,
     Heart,
     Loader2,
     Moon,
     Sun,
-    MessageCircle,
     RefreshCw,
     Settings,
     X,
@@ -41,6 +39,9 @@ import {
     subscribeToUpdateCheckOnStartup,
 } from '@/lib/updatePreferences';
 import logo from '../assets/logo.png';
+import discordIcon from '../assets/discord.svg';
+import githubIcon from '../assets/github.svg';
+import redditIcon from '../assets/reddit.svg';
 
 interface Props {
     onLoadTest: () => void;
@@ -197,6 +198,24 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                     <Image className="w-4 h-4" />
                     <span className="max-sm:hidden">Load TD Test</span>
                 </Button>
+                <Button
+                    size="sm"
+                    asChild
+                    className="bg-gradient-to-r from-orange-500 to-red-500 hover:from-orange-600 hover:to-red-600 text-white font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
+                >
+                    <a
+                        href="https://www.reddit.com/r/kromacut/"
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        aria-label="r/kromacut on Reddit"
+                        title="r/kromacut on Reddit"
+                    >
+                        <span className="flex size-4 shrink-0 items-center justify-center">
+                            <img src={redditIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
+                        </span>
+                        <span className="max-sm:hidden">Reddit</span>
+                    </a>
+                </Button>
                 <Button
                     size="sm"
                     asChild
@@ -209,7 +228,9 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                         aria-label="Discord"
                         title="Discord"
                     >
-                        <MessageCircle className="w-4 h-4" />
+                        <span className="flex size-4 shrink-0 items-center justify-center">
+                            <img src={discordIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
+                        </span>
                         <span className="max-sm:hidden">Discord</span>
                     </a>
                 </Button>
@@ -225,7 +246,9 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                         aria-label="GitHub"
                         title="GitHub"
                     >
-                        <Github className="w-4 h-4" />
+                        <span className="flex size-4 shrink-0 items-center justify-center">
+                            <img src={githubIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
+                        </span>
                         <span className="max-sm:hidden">GitHub</span>
                     </a>
                 </Button>
@@ -268,7 +291,10 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                         onClick={(event) => event.stopPropagation()}
                     >
                         <div className="mb-5 flex items-center justify-between gap-4">
-                            <h2 id={settingsTitleId} className="text-lg font-semibold text-foreground">
+                            <h2
+                                id={settingsTitleId}
+                                className="text-lg font-semibold text-foreground"
+                            >
                                 Settings
                             </h2>
                             <Button
@@ -384,7 +410,8 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                                                 <Download className="mt-0.5 h-4 w-4 flex-shrink-0 text-primary" />
                                                 <div className="min-w-0 flex-1">
                                                     <div className="text-sm font-medium text-foreground">
-                                                        Version {availableUpdate.version} is available
+                                                        Version {availableUpdate.version} is
+                                                        available
                                                     </div>
                                                     {availableUpdate.release_notes && (
                                                         <div className="mt-1 line-clamp-2 text-xs text-muted-foreground">

From 682322697a64f254d3c73047346b40b7cf6be075 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 10:06:04 +0300
Subject: [PATCH 17/81] Improve calibration image sampler

---
 CHANGELOG.md                                 |   1 +
 src/components/FilamentCalibrationWizard.tsx | 160 ++++++++++++++-----
 src/docs/3d-mode.md                          |   2 +-
 3 files changed, 118 insertions(+), 45 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d93196b..9b3c679 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
+- **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
 - **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
 - **Calibrated Auto-paint previews** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends, while the scalar working TD continues to control layer-zone thickness.
diff --git a/src/components/FilamentCalibrationWizard.tsx b/src/components/FilamentCalibrationWizard.tsx
index 4ee74c4..beb19bb 100644
--- a/src/components/FilamentCalibrationWizard.tsx
+++ b/src/components/FilamentCalibrationWizard.tsx
@@ -42,6 +42,12 @@ type WizardStep = 'intro' | 'print' | 'measure' | 'results';
 type SamplerTarget = 'white-reference' | 'measurement';
 
 type RgbInputState = { r: string; g: string; b: string };
+type SamplerPoint = { x: number; y: number };
+
+// The brush stays a consistent size on screen, then scales to the source image
+// so the outlined area is the exact area being averaged.
+const SAMPLER_BRUSH_RADIUS_PX = 16;
+const SAMPLER_BRUSH_DIAMETER_PX = SAMPLER_BRUSH_RADIUS_PX * 2;
 
 const buildRgbInputState = (rgb?: CalibrationRgb): RgbInputState => ({
     r: String(rgb?.[0] ?? DEFAULT_WHITE_REFERENCE[0]),
@@ -67,12 +73,13 @@ function sampleAverageRgb(
     ctx: CanvasRenderingContext2D,
     centerX: number,
     centerY: number,
-    radius = 2
+    radius: number
 ): CalibrationRgb {
-    const startX = Math.max(0, centerX - radius);
-    const startY = Math.max(0, centerY - radius);
-    const endX = Math.min(ctx.canvas.width - 1, centerX + radius);
-    const endY = Math.min(ctx.canvas.height - 1, centerY + radius);
+    const roundedRadius = Math.max(1, Math.round(radius));
+    const startX = Math.max(0, centerX - roundedRadius);
+    const startY = Math.max(0, centerY - roundedRadius);
+    const endX = Math.min(ctx.canvas.width - 1, centerX + roundedRadius);
+    const endY = Math.min(ctx.canvas.height - 1, centerY + roundedRadius);
     const width = endX - startX + 1;
     const height = endY - startY + 1;
     const imageData = ctx.getImageData(startX, startY, width, height).data;
@@ -82,13 +89,22 @@ function sampleAverageRgb(
     let totalB = 0;
     let samples = 0;
 
-    for (let i = 0; i < imageData.length; i += 4) {
-        const alpha = imageData[i + 3] / 255;
-        if (alpha <= 0) continue;
-        totalR += imageData[i] * alpha;
-        totalG += imageData[i + 1] * alpha;
-        totalB += imageData[i + 2] * alpha;
-        samples += alpha;
+    for (let y = startY; y <= endY; y++) {
+        for (let x = startX; x <= endX; x++) {
+            const distanceX = x - centerX;
+            const distanceY = y - centerY;
+            if (distanceX * distanceX + distanceY * distanceY > roundedRadius * roundedRadius) {
+                continue;
+            }
+
+            const pixelIndex = ((y - startY) * width + (x - startX)) * 4;
+            const alpha = imageData[pixelIndex + 3] / 255;
+            if (alpha <= 0) continue;
+            totalR += imageData[pixelIndex] * alpha;
+            totalG += imageData[pixelIndex + 1] * alpha;
+            totalB += imageData[pixelIndex + 2] * alpha;
+            samples += alpha;
+        }
     }
 
     if (samples <= 0) return [0, 0, 0];
@@ -132,6 +148,8 @@ export function FilamentCalibrationWizard({
     const [samplerTarget, setSamplerTarget] = useState<SamplerTarget>('measurement');
     const [pickerImageSrc, setPickerImageSrc] = useState<string | null>(null);
     const [pickerStatus, setPickerStatus] = useState<string | null>(null);
+    const [samplerPoint, setSamplerPoint] = useState<SamplerPoint | null>(null);
+    const [lastSamplePoint, setLastSamplePoint] = useState<SamplerPoint | null>(null);
     const [currentLayers, setCurrentLayers] = useState<string>('');
     const [currentRGB, setCurrentRGB] = useState({ r: '', g: '', b: '' });
     const [result, setResult] = useState<CalibrationResult | null>(null);
@@ -156,8 +174,10 @@ export function FilamentCalibrationWizard({
             const reader = new FileReader();
             reader.onload = () => {
                 setPickerImageSrc(typeof reader.result === 'string' ? reader.result : null);
+                setSamplerPoint(null);
+                setLastSamplePoint(null);
                 setPickerStatus(
-                    'Image loaded. Click anywhere on it to sample RGB into the selected target.'
+                    'Image loaded. Move the circular brush over a uniform area, then click to sample it.'
                 );
             };
             reader.readAsDataURL(file);
@@ -180,32 +200,50 @@ export function FilamentCalibrationWizard({
         ctx.drawImage(image, 0, 0);
     }, []);
 
+    const getSamplerCoordinates = useCallback((event: React.MouseEvent<HTMLImageElement>) => {
+        const image = pickerImageRef.current;
+        const canvas = pickerCanvasRef.current;
+        if (!image || !canvas) return null;
+
+        const rect = image.getBoundingClientRect();
+        if (rect.width <= 0 || rect.height <= 0) return null;
+
+        const normalizedX = Math.max(0, Math.min(1, (event.clientX - rect.left) / rect.width));
+        const normalizedY = Math.max(0, Math.min(1, (event.clientY - rect.top) / rect.height));
+
+        return {
+            imageX: Math.min(canvas.width - 1, Math.floor(normalizedX * canvas.width)),
+            imageY: Math.min(canvas.height - 1, Math.floor(normalizedY * canvas.height)),
+            displayPoint: { x: normalizedX * 100, y: normalizedY * 100 },
+            imageRadius: Math.max(1, (SAMPLER_BRUSH_RADIUS_PX / rect.width) * canvas.width),
+        };
+    }, []);
+
+    const handleSamplerMove = useCallback(
+        (event: React.MouseEvent<HTMLImageElement>) => {
+            const coordinates = getSamplerCoordinates(event);
+            if (coordinates) setSamplerPoint(coordinates.displayPoint);
+        },
+        [getSamplerCoordinates]
+    );
+
     const handleSamplerClick = useCallback(
         (event: React.MouseEvent<HTMLImageElement>) => {
-            const image = pickerImageRef.current;
             const canvas = pickerCanvasRef.current;
-            if (!image || !canvas) return;
+            const coordinates = getSamplerCoordinates(event);
+            if (!canvas || !coordinates) return;
 
             const ctx = canvas.getContext('2d');
             if (!ctx) return;
 
-            const rect = image.getBoundingClientRect();
-            const x = Math.max(
-                0,
-                Math.min(
-                    canvas.width - 1,
-                    Math.floor(((event.clientX - rect.left) / rect.width) * canvas.width)
-                )
+            const rgb = sampleAverageRgb(
+                ctx,
+                coordinates.imageX,
+                coordinates.imageY,
+                coordinates.imageRadius
             );
-            const y = Math.max(
-                0,
-                Math.min(
-                    canvas.height - 1,
-                    Math.floor(((event.clientY - rect.top) / rect.height) * canvas.height)
-                )
-            );
-
-            const rgb = sampleAverageRgb(ctx, x, y, 2);
+            setSamplerPoint(coordinates.displayPoint);
+            setLastSamplePoint(coordinates.displayPoint);
 
             if (samplerTarget === 'white-reference') {
                 setWhiteReferenceInput(rgbToInputState(rgb));
@@ -219,7 +257,7 @@ export function FilamentCalibrationWizard({
                 }.`
             );
         },
-        [samplerTarget]
+        [getSamplerCoordinates, samplerTarget]
     );
 
     const handleAddMeasurement = useCallback(() => {
@@ -296,6 +334,8 @@ export function FilamentCalibrationWizard({
             setSamplerTarget('measurement');
             setPickerImageSrc(null);
             setPickerStatus(null);
+            setSamplerPoint(null);
+            setLastSamplePoint(null);
             setResult(null);
             setErrorMessage(null);
         }
@@ -312,6 +352,8 @@ export function FilamentCalibrationWizard({
             setSamplerTarget('measurement');
             setPickerImageSrc(null);
             setPickerStatus(null);
+            setSamplerPoint(null);
+            setLastSamplePoint(null);
             setCurrentLayers('');
             setCurrentRGB({ r: '', g: '', b: '' });
             setResult(null);
@@ -459,7 +501,7 @@ export function FilamentCalibrationWizard({
                                     <Label className="text-sm">Image Sampler</Label>
                                     <p className="text-xs leading-relaxed text-muted-foreground">
                                         Upload a photo or screenshot, choose where clicks should go,
-                                        then click the image to capture an averaged RGB sample.
+                                        then use the circular brush to capture an averaged RGB sample.
                                     </p>
                                 </div>
                                 <input
@@ -539,22 +581,52 @@ export function FilamentCalibrationWizard({
                             {pickerImageSrc ? (
                                 <div className="space-y-3">
                                     <div className="relative overflow-hidden rounded-xl border border-border/60 bg-background shadow-sm">
-                                        <img
-                                            ref={pickerImageRef}
-                                            src={pickerImageSrc}
-                                            alt="Uploaded calibration sample"
-                                            className="max-h-[28rem] w-full cursor-crosshair select-none object-contain"
-                                            onLoad={handlePickerImageLoad}
-                                            onClick={handleSamplerClick}
-                                            draggable={false}
-                                        />
+                                        <div className="relative mx-auto w-fit max-w-full">
+                                            <img
+                                                ref={pickerImageRef}
+                                                src={pickerImageSrc}
+                                                alt="Uploaded calibration sample"
+                                                className="block max-h-[28rem] max-w-full cursor-crosshair select-none object-contain"
+                                                onLoad={handlePickerImageLoad}
+                                                onMouseMove={handleSamplerMove}
+                                                onMouseLeave={() => setSamplerPoint(null)}
+                                                onClick={handleSamplerClick}
+                                                draggable={false}
+                                            />
+                                            {lastSamplePoint && (
+                                                <div
+                                                    aria-hidden="true"
+                                                    className="pointer-events-none absolute z-10 rounded-full border-2 border-dashed border-foreground/80 bg-background/10 shadow-sm"
+                                                    style={{
+                                                        width: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
+                                                        height: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
+                                                        left: `${lastSamplePoint.x}%`,
+                                                        top: `${lastSamplePoint.y}%`,
+                                                        transform: 'translate(-50%, -50%)',
+                                                    }}
+                                                />
+                                            )}
+                                            {samplerPoint && (
+                                                <div
+                                                    aria-hidden="true"
+                                                    className="pointer-events-none absolute z-20 rounded-full border-2 border-primary bg-primary/15 shadow-[0_0_0_1px_hsl(var(--background))]"
+                                                    style={{
+                                                        width: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
+                                                        height: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
+                                                        left: `${samplerPoint.x}%`,
+                                                        top: `${samplerPoint.y}%`,
+                                                        transform: 'translate(-50%, -50%)',
+                                                    }}
+                                                />
+                                            )}
+                                        </div>
                                         <div className="pointer-events-none absolute left-3 top-3 rounded-full border border-primary/25 bg-background/90 px-3 py-1 text-[11px] font-medium text-foreground shadow-sm backdrop-blur">
-                                            Click to sample into {activeSamplerLabel}
+                                            Circular brush averages into {activeSamplerLabel}
                                         </div>
                                     </div>
                                     <div className="rounded-lg border border-primary/15 bg-primary/5 px-3 py-2 text-xs text-muted-foreground">
                                         {pickerStatus ??
-                                            'Click the image to capture a sample into the selected target.'}
+                                            'Move the circular brush over a uniform area, then click to capture it.'}
                                     </div>
                                 </div>
                             ) : (
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 897fe8f..85ec4d0 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -49,7 +49,7 @@ Use the wand button to auto-estimate TD from color, or use the calibration butto
 Click the calibration button on a filament row to open **Calibrate Filament TD**. The wizard has three parts:
 
 1. **Step 1: Print Test Patches** lists the filament, layer height, 100% infill, patch size, and layer counts. Use **Download Test Patches STL** if you want Kromacut to generate the patch model.
-2. **Step 2: Measure RGB Values** lets you enter measurements manually or upload a photo with **Image Sampler**. Use **Fill White Reference** on the empty backlight first, then use **Fill Measurement RGB** for each printed patch.
+2. **Step 2: Measure RGB Values** lets you enter measurements manually or upload a photo with **Image Sampler**. Use **Fill White Reference** on the empty backlight first, then use **Fill Measurement RGB** for each printed patch. The visible circular brush averages the pixels inside it, so place it over a uniform patch area and away from edges or glare.
 3. **Calibration Complete** shows the fitted TD value, RGB channel estimates, white reference, and confidence. Click **Save Calibration** to apply it to the filament.
 
 Use at least three saved measurements before calculating TD. More measurements usually improve confidence if the lighting and sampling setup stays consistent.

From 15c64b070ded8dac545a96ecab5a0dbcbc039214 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 10:07:00 +0300
Subject: [PATCH 18/81] Revert gitignore

---
 .gitignore | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index 8f9935e..4cbec2b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -27,7 +27,6 @@ test-results/
 
 .todo
 .claude
-docs/AUTOPAINT_IMPROVEMENT_PLAN.md
 
 # Tauri / Rust build artifacts
 src-tauri/target/

From 8df9f88b331ae12561d632d66236a4c809701b0d Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 12:19:50 +0300
Subject: [PATCH 19/81] Fix auto-paint printable height planning

---
 CHANGELOG.md                         |   2 +
 src/docs/3d-mode.md                  |   2 +-
 src/lib/autoPaint.ts                 | 425 +++++++++------
 tests/assets/auto-paint-goldens.json | 760 +++++++++++++--------------
 tests/autoPaint.test.ts              |  64 +++
 5 files changed, 706 insertions(+), 547 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9b3c679..c94c273 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,8 @@ All notable changes to Kromacut are documented in this file.
 
 ### Fixed
 
+- **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
+
 - **Auto-paint optimizer cache and default seed** - Cache entries now include all target-color weights, every target cluster, and optimizer tuning values. Blank seeds now derive a stable value from the active inputs, making identical runs repeatable and cacheable instead of randomly changing.
 
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 85ec4d0..51f8f4b 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -67,7 +67,7 @@ Auto-paint profiles store reusable filament sets.
 
 ## Max Height
 
-**Max Height** limits the total model height in Auto-paint. Leave it on **Auto** for the physics-derived height. Set a smaller value when the model is too tall, but watch for compressed transition zones.
+**Max Height** limits the total printed model height in Auto-paint. Leave it on **Auto** for the physics-derived, layer-aligned height. If a value falls between valid first-layer and layer-height steps, Kromacut uses the next lower printable height so the generated model never exceeds your cap. Set a smaller value when the model is too tall, but watch for compressed transition zones.
 
 ## Enhanced Color Matching
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 717651e..eb83af8 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -60,12 +60,26 @@ export interface AutoPaintLayer {
     endHeight: number; // mm from Z=0
 }
 
+/** One physically printable auto-paint layer, including its simulated visible color. */
+interface PrintableAutoPaintLayer extends AutoPaintLayer {
+    thickness: number;
+    zoneIndex: number;
+    virtualColor: RGB;
+}
+
+interface PrintableAutoPaintStack {
+    layers: PrintableAutoPaintLayer[];
+    zones: TransitionZone[];
+    totalHeight: number;
+    truncated: boolean;
+}
+
 /** Result from the auto-paint generator */
 export interface AutoPaintResult {
     layers: AutoPaintLayer[];
-    totalHeight: number;
-    idealHeight: number; // What height would be ideal without compression
-    autoHeight: number; // The default height when user hasn't set a max
+    totalHeight: number; // Actual height of the discrete printable stack
+    idealHeight: number; // Continuous optical height before compression
+    autoHeight: number; // Default discrete printable height when no cap is set
     compressionRatio: number; // 1.0 = no compression, 0.5 = 50% compressed
     filamentOrder: string[]; // Filament IDs in order (dark to light)
     transitionZones: TransitionZone[]; // Detailed zone info
@@ -554,6 +568,203 @@ export function compressZones(
     return { compressedZones, compressionRatio };
 }
 
+const PRINTABLE_HEIGHT_EPSILON = 1e-8;
+const MAX_PRINTABLE_AUTO_PAINT_LAYERS = 500;
+
+function printableFirstLayerHeight(layerHeight: number, firstLayerHeight: number): number {
+    return Math.max(layerHeight, firstLayerHeight);
+}
+
+function roundPrintableHeight(height: number): number {
+    return Number(height.toFixed(8));
+}
+
+/**
+ * Return the smallest valid slicer height that fully covers `height`.
+ *
+ * Auto-paint zones are continuous, but the generated model can only contain a
+ * thick first layer followed by whole normal-height layers. Keeping this rule
+ * here prevents the optimizer, preview, and export paths from disagreeing
+ * about the physical stack height.
+ */
+export function ceilAutoPaintHeightToPrintableStack(
+    height: number,
+    layerHeight: number,
+    firstLayerHeight: number
+): number {
+    if (!Number.isFinite(height) || height <= 0 || layerHeight <= 0) return 0;
+
+    const first = printableFirstLayerHeight(layerHeight, firstLayerHeight);
+    if (height <= first + PRINTABLE_HEIGHT_EPSILON) return roundPrintableHeight(first);
+
+    const regularLayers = Math.ceil(
+        (height - first - PRINTABLE_HEIGHT_EPSILON) / layerHeight
+    );
+    return roundPrintableHeight(first + Math.max(0, regularLayers) * layerHeight);
+}
+
+/**
+ * Return the tallest valid slicer height that does not exceed `maxHeight`.
+ *
+ * A requested cap between printable layer boundaries is intentionally rounded
+ * down. A partial final layer would violate the configured print settings and
+ * rounding it up would violate the user's cap.
+ */
+export function floorAutoPaintHeightToPrintableStack(
+    maxHeight: number,
+    layerHeight: number,
+    firstLayerHeight: number
+): number {
+    if (!Number.isFinite(maxHeight) || maxHeight <= 0 || layerHeight <= 0) return 0;
+
+    const first = printableFirstLayerHeight(layerHeight, firstLayerHeight);
+    // A cap smaller than the required first layer cannot produce a valid stack.
+    // Return zero rather than silently exceeding the caller's maximum.
+    if (maxHeight < first - PRINTABLE_HEIGHT_EPSILON) return 0;
+
+    const regularLayers = Math.floor(
+        (maxHeight - first + PRINTABLE_HEIGHT_EPSILON) / layerHeight
+    );
+    return roundPrintableHeight(first + Math.max(0, regularLayers) * layerHeight);
+}
+
+function findTransitionZoneAtHeight(zones: TransitionZone[], height: number): number {
+    let activeZoneIndex = 0;
+
+    for (let index = 0; index < zones.length; index++) {
+        const zone = zones[index];
+        if (
+            height + PRINTABLE_HEIGHT_EPSILON >= zone.startHeight &&
+            height < zone.endHeight - PRINTABLE_HEIGHT_EPSILON
+        ) {
+            return index;
+        }
+        if (height + PRINTABLE_HEIGHT_EPSILON >= zone.startHeight) {
+            activeZoneIndex = index;
+        }
+    }
+
+    return activeZoneIndex;
+}
+
+/**
+ * Convert continuous transition zones into the exact printable stack used by
+ * preview, meshing, and export. Zone changes occur at whole layer boundaries;
+ * every layer has either the first-layer height or the configured layer height.
+ */
+function buildPrintableAutoPaintStack(
+    zones: TransitionZone[],
+    layerHeight: number,
+    firstLayerHeight: number
+): PrintableAutoPaintStack {
+    if (zones.length === 0 || layerHeight <= 0) {
+        return { layers: [], zones: [], totalHeight: 0, truncated: false };
+    }
+
+    const continuousTotalHeight = zones[zones.length - 1].endHeight;
+    const printableTotalHeight = ceilAutoPaintHeightToPrintableStack(
+        continuousTotalHeight,
+        layerHeight,
+        firstLayerHeight
+    );
+    if (printableTotalHeight <= 0) {
+        return { layers: [], zones: [], totalHeight: 0, truncated: false };
+    }
+
+    const uncoloredLayers: Array<{
+        thickness: number;
+        startHeight: number;
+        endHeight: number;
+        sourceZoneIndex: number;
+    }> = [];
+    let currentHeight = 0;
+    let layerIndex = 0;
+
+    while (
+        currentHeight < printableTotalHeight - PRINTABLE_HEIGHT_EPSILON &&
+        layerIndex < MAX_PRINTABLE_AUTO_PAINT_LAYERS
+    ) {
+        const thickness =
+            layerIndex === 0
+                ? printableFirstLayerHeight(layerHeight, firstLayerHeight)
+                : layerHeight;
+        const sourceZoneIndex = findTransitionZoneAtHeight(zones, currentHeight);
+        const endHeight = roundPrintableHeight(currentHeight + thickness);
+
+        uncoloredLayers.push({
+            thickness: roundPrintableHeight(thickness),
+            startHeight: roundPrintableHeight(currentHeight),
+            endHeight,
+            sourceZoneIndex,
+        });
+        currentHeight = endHeight;
+        layerIndex++;
+    }
+
+    const truncated = currentHeight < printableTotalHeight - PRINTABLE_HEIGHT_EPSILON;
+    const actualZoneIndices: number[] = [];
+    for (const layer of uncoloredLayers) {
+        if (actualZoneIndices.at(-1) !== layer.sourceZoneIndex) {
+            actualZoneIndices.push(layer.sourceZoneIndex);
+        }
+    }
+
+    const sourceToActualZone = new Map<number, number>();
+    const printableZones = actualZoneIndices.map((sourceZoneIndex, actualZoneIndex) => {
+        sourceToActualZone.set(sourceZoneIndex, actualZoneIndex);
+        const source = zones[sourceZoneIndex];
+        const zoneLayers = uncoloredLayers.filter(
+            (layer) => layer.sourceZoneIndex === sourceZoneIndex
+        );
+        const startHeight = zoneLayers[0].startHeight;
+        const endHeight = zoneLayers[zoneLayers.length - 1].endHeight;
+
+        return {
+            ...source,
+            startHeight,
+            endHeight,
+            actualThickness: roundPrintableHeight(endHeight - startHeight),
+        };
+    });
+
+    const zoneBackgrounds = buildZoneBackgrounds(printableZones);
+    const thicknessByZone = new Array(printableZones.length).fill(0);
+    const layers = uncoloredLayers.map((layer) => {
+        const zoneIndex = sourceToActualZone.get(layer.sourceZoneIndex)!;
+        const zone = printableZones[zoneIndex];
+        const thicknessInZone = roundPrintableHeight(
+            (thicknessByZone[zoneIndex] += layer.thickness)
+        );
+        const filamentColor = hexToRgb(zone.filamentColor);
+        const virtualColor =
+            zoneIndex === 0
+                ? filamentColor
+                : blendColors(
+                      zoneBackgrounds[zoneIndex],
+                      filamentColor,
+                      zone.filamentTdChannels ?? zone.filamentTd,
+                      thicknessInZone
+                  );
+
+        return {
+            filamentId: zone.filamentId,
+            filamentColor: zone.filamentColor,
+            startHeight: layer.startHeight,
+            endHeight: layer.endHeight,
+            thickness: layer.thickness,
+            zoneIndex,
+            virtualColor,
+        };
+    });
+
+    return {
+        layers,
+        zones: printableZones,
+        totalHeight: layers.at(-1)?.endHeight ?? 0,
+        truncated,
+    };
+}
+
 function buildZoneBackgrounds(zones: TransitionZone[]): RGB[] {
     if (zones.length === 0) return [];
 
@@ -728,68 +939,21 @@ export function buildAchievableColorPalette(
 
     if (zones.length === 0) return [];
 
+    const printableMaxHeight =
+        maxHeight === undefined
+            ? undefined
+            : floorAutoPaintHeightToPrintableStack(maxHeight, layerHeight, firstLayerHeight);
     const activeZones =
-        maxHeight === undefined ? zones : compressZones(zones, maxHeight).compressedZones;
-    const totalHeight = activeZones[activeZones.length - 1].endHeight;
-    const palette: Array<{ height: number; lab: Lab; rgb: RGB }> = [];
-    const zoneBackgrounds = buildZoneBackgrounds(activeZones);
-
-    let currentZ = 0;
-    let layerIndex = 0;
-    let prevZoneIndex = 0;
-    let thicknessInCurrentZone = 0;
-
-    while (currentZ < totalHeight + layerHeight * 0.5) {
-        const thickness = layerIndex === 0 ? Math.max(firstLayerHeight, layerHeight) : layerHeight;
-
-        // Find active zone
-        let activeZoneIndex = 0;
-        for (let zi = 0; zi < activeZones.length; zi++) {
-            if (currentZ >= activeZones[zi].startHeight && currentZ < activeZones[zi].endHeight) {
-                activeZoneIndex = zi;
-                break;
-            }
-            if (currentZ >= activeZones[zi].startHeight) {
-                activeZoneIndex = zi;
-            }
-        }
-
-        if (activeZoneIndex !== prevZoneIndex) {
-            thicknessInCurrentZone =
-                currentZ - activeZones[activeZoneIndex].startHeight + thickness;
-            prevZoneIndex = activeZoneIndex;
-        } else {
-            thicknessInCurrentZone += thickness;
-        }
-
-        const zone = activeZones[activeZoneIndex];
-        const filamentColor = hexToRgb(zone.filamentColor);
-
-        let blendedColor: RGB;
-        if (activeZoneIndex === 0) {
-            blendedColor = filamentColor;
-        } else {
-            blendedColor = blendColors(
-                zoneBackgrounds[activeZoneIndex],
-                filamentColor,
-                zone.filamentTdChannels ?? zone.filamentTd,
-                thicknessInCurrentZone
-            );
-        }
-
-        palette.push({
-            height: currentZ + thickness,
-            lab: rgbToLab(blendedColor),
-            rgb: blendedColor,
-        });
-
-        currentZ += thickness;
-        layerIndex++;
-
-        if (layerIndex >= 500) break;
-    }
-
-    return palette;
+        printableMaxHeight === undefined
+            ? zones
+            : compressZones(zones, printableMaxHeight).compressedZones;
+    const stack = buildPrintableAutoPaintStack(activeZones, layerHeight, firstLayerHeight);
+
+    return stack.layers.map((layer) => ({
+        height: layer.endHeight,
+        lab: rgbToLab(layer.virtualColor),
+        rgb: layer.virtualColor,
+    }));
 }
 
 /**
@@ -1091,8 +1255,6 @@ export function generateAutoLayers(
         });
     }
 
-    const filamentOrder = sortedFilaments.map((f) => f.id);
-
     // Apply frontlit TD scale for internal simulation
     const scaledFilaments = sortedFilaments.map(scaleFilamentForFrontlight);
 
@@ -1103,43 +1265,53 @@ export function generateAutoLayers(
         Math.max(firstLayerHeight, layerHeight)
     );
 
-    // --- STEP 4: APPLY COMPRESSION IF NEEDED ---
-    // autoHeight = idealHeight — the physics-derived value from the
-    // DeltaE convergence simulation. This is the height the algorithm
-    // determines is needed for accurate color reproduction.
-    // No hardcoded cap — each transition zone is already bounded by
-    // opacity thresholds (85%) and DeltaE convergence (< 2.3).
-    const autoHeight = idealHeight;
-    const targetMaxHeight = maxHeight ?? autoHeight;
+    // --- STEP 4: APPLY COMPRESSION ON THE PRINTABLE HEIGHT GRID ---
+    // Keep the continuous optical ideal for diagnostics, but expose and build
+    // a layer-aligned auto height so every consumer sees a real print stack.
+    const autoHeight = ceilAutoPaintHeightToPrintableStack(
+        idealHeight,
+        layerHeight,
+        firstLayerHeight
+    );
+    const targetMaxHeight =
+        maxHeight === undefined
+            ? autoHeight
+            : floorAutoPaintHeightToPrintableStack(maxHeight, layerHeight, firstLayerHeight);
     const { compressedZones, compressionRatio } = compressZones(zones, targetMaxHeight);
 
-    // --- STEP 5: GENERATE LAYER SEGMENTS FROM ZONES ---
-    const layers: AutoPaintLayer[] = compressedZones.map((zone) => ({
+    // --- STEP 5: BUILD THE ACTUAL PRINTABLE STACK ---
+    const printableStack = buildPrintableAutoPaintStack(
+        compressedZones,
+        layerHeight,
+        firstLayerHeight
+    );
+    const layers: AutoPaintLayer[] = printableStack.zones.map((zone) => ({
         filamentId: zone.filamentId,
         filamentColor: zone.filamentColor,
         startHeight: zone.startHeight,
         endHeight: zone.endHeight,
     }));
-
-    const totalHeight =
-        compressedZones.length > 0 ? compressedZones[compressedZones.length - 1].endHeight : 0;
+    const filamentOrder = printableStack.zones.map((zone) => zone.filamentId);
+    const printedFilaments = filamentOrder
+        .map((id) => filaments.find((filament) => filament.id === id))
+        .filter((filament): filament is Filament => filament !== undefined);
 
     // --- STEP 6: CALCULATE CONFIDENCE METRICS ---
     const confidence = calculateAutoConfidence(
         filaments,
         imageSwatches,
-        sortedFilaments,
+        printedFilaments,
         compressionRatio
     );
 
     const result: AutoPaintResult = {
         layers,
-        totalHeight,
+        totalHeight: printableStack.totalHeight,
         idealHeight,
         autoHeight,
         compressionRatio,
         filamentOrder,
-        transitionZones: compressedZones,
+        transitionZones: printableStack.zones,
         ...confidence,
     };
 
@@ -1214,81 +1386,26 @@ export function autoPaintToSliceHeights(
         };
     }
 
-    const virtualSwatches: Array<{ hex: string; a: number }> = [];
-    const filamentSwatches: Array<{ hex: string; a: number }> = [];
-    const colorSliceHeights: number[] = [];
-    const colorOrder: number[] = [];
-
-    const zones = result.transitionZones;
-    const zoneBackgrounds = buildZoneBackgrounds(zones);
-
-    // Generate layers at each layerHeight increment from 0 to totalHeight.
-    // For each layer, simulate the Beer-Lambert blended color at that Z.
-    let currentZ = 0;
-    let layerIndex = 0;
-    let prevZoneIndex = 0;
-    let thicknessInCurrentZone = 0;
-
-    while (currentZ < result.totalHeight) {
-        const thickness = layerIndex === 0 ? Math.max(firstLayerHeight, layerHeight) : layerHeight;
-
-        // Find which zone is active at this Z height
-        let activeZoneIndex = 0;
-        for (let zi = 0; zi < zones.length; zi++) {
-            if (currentZ >= zones[zi].startHeight && currentZ < zones[zi].endHeight) {
-                activeZoneIndex = zi;
-                break;
-            }
-            if (currentZ >= zones[zi].startHeight) {
-                activeZoneIndex = zi;
-            }
-        }
-
-        // Track cumulative thickness within this zone for blending
-        if (activeZoneIndex !== prevZoneIndex) {
-            thicknessInCurrentZone = currentZ - zones[activeZoneIndex].startHeight + thickness;
-            prevZoneIndex = activeZoneIndex;
-        } else {
-            thicknessInCurrentZone += thickness;
-        }
-
-        const zone = zones[activeZoneIndex];
-        const filamentColor = hexToRgb(zone.filamentColor);
-
-        // Simulate the blended color at this layer:
-        // Foundation zone → pure filament color (opaque base)
-        // Subsequent zones → blend filament onto the previous zone's color
-        let blendedColor: RGB;
-        if (activeZoneIndex === 0) {
-            blendedColor = filamentColor;
-        } else {
-            blendedColor = blendColors(
-                zoneBackgrounds[activeZoneIndex],
-                filamentColor,
-                zone.filamentTdChannels ?? zone.filamentTd,
-                thicknessInCurrentZone
-            );
-        }
-
-        virtualSwatches.push({ hex: rgbToHex(blendedColor), a: 255 });
-        filamentSwatches.push({ hex: zone.filamentColor, a: 255 });
-        colorSliceHeights.push(Number(thickness.toFixed(8)));
-        colorOrder.push(layerIndex);
-
-        currentZ += thickness;
-        layerIndex++;
-
-        if (layerIndex >= 500) {
-            console.warn('autoPaintToSliceHeights: too many layers, stopping at 500');
-            break;
-        }
+    const stack = buildPrintableAutoPaintStack(
+        result.transitionZones,
+        layerHeight,
+        firstLayerHeight
+    );
+    if (stack.truncated) {
+        console.warn('autoPaintToSliceHeights: too many layers, stopping at 500');
     }
 
     return {
-        colorSliceHeights,
-        colorOrder,
-        virtualSwatches,
-        filamentSwatches,
+        colorSliceHeights: stack.layers.map((layer) => layer.thickness),
+        colorOrder: stack.layers.map((_, index) => index),
+        virtualSwatches: stack.layers.map((layer) => ({
+            hex: rgbToHex(layer.virtualColor),
+            a: 255,
+        })),
+        filamentSwatches: stack.layers.map((layer) => ({
+            hex: layer.filamentColor,
+            a: 255,
+        })),
     };
 }
 
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index ca837d7..b152177 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -15,12 +15,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / logo-png / enhanced=false / repeats=true": {
@@ -39,12 +39,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / logo-png / enhanced=true / repeats=false": {
@@ -63,12 +63,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / logo-png / enhanced=true / repeats=true": {
@@ -87,12 +87,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=false / repeats=false": {
@@ -111,12 +111,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=false / repeats=true": {
@@ -135,12 +135,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=true / repeats=false": {
@@ -159,12 +159,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=true / repeats=true": {
@@ -183,12 +183,12 @@
       {
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
-        "endHeight": 0.5800000000000001,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 0.5800000000000001,
+    "totalHeight": 0.64,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=false / repeats=false": {
@@ -209,26 +209,26 @@
       {
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
-        "endHeight": 0.405,
+        "endHeight": 0.48,
         "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.405,
-        "endHeight": 0.645,
+        "startHeight": 0.48,
+        "endHeight": 0.72,
         "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.645,
-        "endHeight": 0.974,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=false / repeats=true": {
@@ -249,75 +249,76 @@
       {
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
-        "endHeight": 0.405,
+        "endHeight": 0.48,
         "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.405,
-        "endHeight": 0.645,
+        "startHeight": 0.48,
+        "endHeight": 0.72,
         "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.645,
-        "endHeight": 0.974,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
+      "xud8mzr",
       "plvjtmc",
       "y202l1e",
-      "h8zuocq",
-      "xud8mzr"
+      "h8zuocq"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "xud8mzr",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.56,
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.56
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.56,
+        "endHeight": 0.64,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.16,
-        "endHeight": 0.489,
+        "startHeight": 0.64,
+        "endHeight": 0.96,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.489,
-        "endHeight": 0.734,
+        "startHeight": 0.96,
+        "endHeight": 1.2,
         "idealThickness": 0.245,
-        "actualThickness": 0.245
-      },
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.734,
-        "endHeight": 0.974,
-        "idealThickness": 0.24,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.2,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
       "plvjtmc",
-      "y202l1e",
+      "xud8mzr",
       "h8zuocq",
+      "plvjtmc",
       "y202l1e",
-      "xud8mzr"
+      "h8zuocq"
     ],
     "transitionZones": [
       {
@@ -328,35 +329,42 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.16,
-        "endHeight": 0.489,
-        "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "endHeight": 0.48,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.489,
-        "endHeight": 0.734,
-        "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "startHeight": 0.48,
+        "endHeight": 0.72,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.72,
+        "endHeight": 0.8,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.734,
-        "endHeight": 1.063,
+        "startHeight": 0.8,
+        "endHeight": 1.12,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 1.063,
-        "endHeight": 1.322,
-        "idealThickness": 0.259,
-        "actualThickness": 0.259
+        "filamentId": "h8zuocq",
+        "startHeight": 1.12,
+        "endHeight": 1.36,
+        "idealThickness": 0.245,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.322,
+    "totalHeight": 1.36,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -377,26 +385,26 @@
       {
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
-        "endHeight": 0.405,
+        "endHeight": 0.48,
         "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.405,
-        "endHeight": 0.645,
+        "startHeight": 0.48,
+        "endHeight": 0.72,
         "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.645,
-        "endHeight": 0.974,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=true": {
@@ -417,34 +425,34 @@
       {
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
-        "endHeight": 0.405,
+        "endHeight": 0.48,
         "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.405,
-        "endHeight": 0.645,
+        "startHeight": 0.48,
+        "endHeight": 0.72,
         "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.645,
-        "endHeight": 0.974,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
       "plvjtmc",
-      "y202l1e",
+      "xud8mzr",
       "h8zuocq",
-      "xud8mzr"
+      "y202l1e"
     ],
     "transitionZones": [
       {
@@ -455,34 +463,34 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.16,
-        "endHeight": 0.489,
-        "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "endHeight": 0.48,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.489,
-        "endHeight": 0.734,
-        "idealThickness": 0.245,
-        "actualThickness": 0.245
-      },
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.734,
-        "endHeight": 0.974,
+        "startHeight": 0.48,
+        "endHeight": 0.72,
         "idealThickness": 0.24,
         "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.72,
+        "endHeight": 1.04,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 0.974,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
       "plvjtmc",
-      "y202l1e",
+      "xud8mzr",
       "h8zuocq",
       "y202l1e",
       "xud8mzr"
@@ -496,35 +504,35 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.16,
-        "endHeight": 0.489,
-        "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "endHeight": 0.48,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.489,
-        "endHeight": 0.734,
-        "idealThickness": 0.245,
-        "actualThickness": 0.245
+        "startHeight": 0.48,
+        "endHeight": 0.72,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.734,
-        "endHeight": 1.063,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.329,
-        "actualThickness": 0.329
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 1.063,
-        "endHeight": 1.322,
+        "startHeight": 1.04,
+        "endHeight": 1.28,
         "idealThickness": 0.259,
-        "actualThickness": 0.259
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.322,
+    "totalHeight": 1.28,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -549,54 +557,54 @@
       {
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
-        "endHeight": 0.356,
+        "endHeight": 0.4,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 0.356,
-        "endHeight": 0.6219999999999999,
+        "startHeight": 0.4,
+        "endHeight": 0.64,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.6219999999999999,
-        "endHeight": 0.8949999999999998,
+        "startHeight": 0.64,
+        "endHeight": 0.96,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.8949999999999998,
-        "endHeight": 1.2379999999999998,
+        "startHeight": 0.96,
+        "endHeight": 1.28,
         "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.2379999999999998,
-        "endHeight": 1.5949999999999998,
+        "startHeight": 1.28,
+        "endHeight": 1.6,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.5949999999999998,
-        "endHeight": 2.0359999999999996,
+        "startHeight": 1.6,
+        "endHeight": 2.08,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.48
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 2.0359999999999996,
-        "endHeight": 2.4559999999999995,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.4559999999999995,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=true": {
@@ -621,214 +629,222 @@
       {
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
-        "endHeight": 0.356,
+        "endHeight": 0.4,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 0.356,
-        "endHeight": 0.6219999999999999,
+        "startHeight": 0.4,
+        "endHeight": 0.64,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.6219999999999999,
-        "endHeight": 0.8949999999999998,
+        "startHeight": 0.64,
+        "endHeight": 0.96,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.8949999999999998,
-        "endHeight": 1.2379999999999998,
+        "startHeight": 0.96,
+        "endHeight": 1.28,
         "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.2379999999999998,
-        "endHeight": 1.5949999999999998,
+        "startHeight": 1.28,
+        "endHeight": 1.6,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.5949999999999998,
-        "endHeight": 2.0359999999999996,
+        "startHeight": 1.6,
+        "endHeight": 2.08,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.48
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 2.0359999999999996,
-        "endHeight": 2.4559999999999995,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.4559999999999995,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
       "vsn9q6u",
       "98z555k",
-      "upcjpfe",
-      "azwg1yp",
       "xyyxysq",
-      "w8cncoa"
+      "w8cncoa",
+      "p9c63ms",
+      "plvjtmc",
+      "azwg1yp"
     ],
     "transitionZones": [
       {
         "filamentId": "vsn9q6u",
         "startHeight": 0,
-        "endHeight": 0.49400000000000005,
+        "endHeight": 0.56,
         "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.49400000000000005
+        "actualThickness": 0.56
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.49400000000000005,
-        "endHeight": 0.767,
+        "startHeight": 0.56,
+        "endHeight": 0.8,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.767,
-        "endHeight": 1.11,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
-      },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 1.11,
-        "endHeight": 1.306,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.306,
-        "endHeight": 1.663,
+        "startHeight": 0.8,
+        "endHeight": 1.2,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.4
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.663,
-        "endHeight": 2.104,
+        "startHeight": 1.2,
+        "endHeight": 1.6,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.6,
+        "endHeight": 2,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 2,
+        "endHeight": 2.08,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.08,
+        "endHeight": 2.32,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2.104,
+    "totalHeight": 2.32,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
       "98z555k",
-      "w8cncoa",
       "azwg1yp",
       "xyyxysq",
       "w8cncoa",
-      "upcjpfe",
+      "p9c63ms",
       "vsn9q6u",
       "98z555k",
       "plvjtmc",
       "azwg1yp",
-      "98z555k",
-      "vsn9q6u"
+      "vsn9q6u",
+      "w8cncoa",
+      "xyyxysq"
     ],
     "transitionZones": [
       {
         "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.507,
+        "endHeight": 0.56,
         "idealThickness": 0.507,
-        "actualThickness": 0.507
-      },
-      {
-        "filamentId": "w8cncoa",
-        "startHeight": 0.507,
-        "endHeight": 0.948,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.56
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.948,
-        "endHeight": 1.144,
+        "startHeight": 0.56,
+        "endHeight": 0.72,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.16
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.144,
-        "endHeight": 1.501,
+        "startHeight": 0.72,
+        "endHeight": 1.12,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.4
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.501,
-        "endHeight": 1.9419999999999997,
+        "startHeight": 1.12,
+        "endHeight": 1.52,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.9419999999999997,
-        "endHeight": 2.2849999999999997,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "filamentId": "p9c63ms",
+        "startHeight": 1.52,
+        "endHeight": 2,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.48
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.2849999999999997,
-        "endHeight": 2.5509999999999997,
+        "startHeight": 2,
+        "endHeight": 2.24,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.5509999999999997,
-        "endHeight": 2.824,
+        "startHeight": 2.24,
+        "endHeight": 2.48,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 2.824,
-        "endHeight": 2.904,
+        "startHeight": 2.48,
+        "endHeight": 2.56,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.904,
-        "endHeight": 3.1,
+        "startHeight": 2.56,
+        "endHeight": 2.8,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 3.1,
-        "endHeight": 3.373,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 3.373,
-        "endHeight": 3.6390000000000002,
+        "startHeight": 2.8,
+        "endHeight": 3.04,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 3.04,
+        "endHeight": 3.52,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.48
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 3.52,
+        "endHeight": 3.84,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.6390000000000002,
+    "totalHeight": 3.84,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -853,54 +869,54 @@
       {
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
-        "endHeight": 0.356,
+        "endHeight": 0.4,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 0.356,
-        "endHeight": 0.6219999999999999,
+        "startHeight": 0.4,
+        "endHeight": 0.64,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.6219999999999999,
-        "endHeight": 0.8949999999999998,
+        "startHeight": 0.64,
+        "endHeight": 0.96,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.8949999999999998,
-        "endHeight": 1.2379999999999998,
+        "startHeight": 0.96,
+        "endHeight": 1.28,
         "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.2379999999999998,
-        "endHeight": 1.5949999999999998,
+        "startHeight": 1.28,
+        "endHeight": 1.6,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.5949999999999998,
-        "endHeight": 2.0359999999999996,
+        "startHeight": 1.6,
+        "endHeight": 2.08,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.48
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 2.0359999999999996,
-        "endHeight": 2.4559999999999995,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.4559999999999995,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=true": {
@@ -925,214 +941,174 @@
       {
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
-        "endHeight": 0.356,
+        "endHeight": 0.4,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 0.356,
-        "endHeight": 0.6219999999999999,
+        "startHeight": 0.4,
+        "endHeight": 0.64,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.6219999999999999,
-        "endHeight": 0.8949999999999998,
+        "startHeight": 0.64,
+        "endHeight": 0.96,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.8949999999999998,
-        "endHeight": 1.2379999999999998,
+        "startHeight": 0.96,
+        "endHeight": 1.28,
         "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.2379999999999998,
-        "endHeight": 1.5949999999999998,
+        "startHeight": 1.28,
+        "endHeight": 1.6,
         "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.5949999999999998,
-        "endHeight": 2.0359999999999996,
+        "startHeight": 1.6,
+        "endHeight": 2.08,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "actualThickness": 0.48
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 2.0359999999999996,
-        "endHeight": 2.4559999999999995,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.4559999999999995,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "upcjpfe",
       "plvjtmc",
       "p9c63ms",
-      "w8cncoa",
-      "xyyxysq",
-      "vsn9q6u"
+      "98z555k",
+      "upcjpfe",
+      "vsn9q6u",
+      "xyyxysq"
     ],
     "transitionZones": [
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0,
-        "endHeight": 0.6370000000000001,
-        "idealThickness": 0.6370000000000001,
-        "actualThickness": 0.6370000000000001
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.6370000000000001,
-        "endHeight": 0.7170000000000001,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 0.7170000000000001,
-        "endHeight": 1.137,
+        "startHeight": 0.16,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "actualThickness": 0.48
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.137,
-        "endHeight": 1.5779999999999998,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.44099999999999995
+        "filamentId": "98z555k",
+        "startHeight": 0.64,
+        "endHeight": 0.88,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.5779999999999998,
-        "endHeight": 1.9349999999999998,
-        "idealThickness": 0.357,
-        "actualThickness": 0.357
+        "filamentId": "upcjpfe",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.9349999999999998,
-        "endHeight": 2.2009999999999996,
+        "startHeight": 1.2,
+        "endHeight": 1.52,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.52,
+        "endHeight": 1.84,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.2009999999999996,
+    "totalHeight": 1.84,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "vsn9q6u",
-      "xyyxysq",
-      "upcjpfe",
       "plvjtmc",
       "p9c63ms",
-      "upcjpfe",
       "98z555k",
-      "plvjtmc",
-      "azwg1yp",
+      "upcjpfe",
       "vsn9q6u",
-      "plvjtmc",
-      "p9c63ms"
+      "xyyxysq",
+      "vsn9q6u"
     ],
     "transitionZones": [
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0,
-        "endHeight": 0.49400000000000005,
-        "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.49400000000000005
-      },
-      {
-        "filamentId": "xyyxysq",
-        "startHeight": 0.49400000000000005,
-        "endHeight": 0.851,
-        "idealThickness": 0.357,
-        "actualThickness": 0.357
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.851,
-        "endHeight": 1.194,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.194,
-        "endHeight": 1.274,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 1.274,
-        "endHeight": 1.694,
+        "startHeight": 0.16,
+        "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.694,
-        "endHeight": 2.037,
-        "idealThickness": 0.343,
-        "actualThickness": 0.343
+        "actualThickness": 0.48
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.037,
-        "endHeight": 2.31,
+        "startHeight": 0.64,
+        "endHeight": 0.88,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.27299999999999996
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.31,
-        "endHeight": 2.39,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "azwg1yp",
-        "startHeight": 2.39,
-        "endHeight": 2.5860000000000003,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.19599999999999998
+        "filamentId": "upcjpfe",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.5860000000000003,
-        "endHeight": 2.8520000000000003,
+        "startHeight": 1.2,
+        "endHeight": 1.52,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.26599999999999996
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.8520000000000003,
-        "endHeight": 2.9320000000000004,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "xyyxysq",
+        "startHeight": 1.52,
+        "endHeight": 1.84,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 2.9320000000000004,
-        "endHeight": 3.3520000000000003,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.42000000000000004
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.84,
+        "endHeight": 2.16,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.3520000000000003,
+    "totalHeight": 2.16,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index be07d9e..42fedd4 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -233,6 +233,70 @@ test('auto-paint slice data stays synchronized and uses print-layer heights', as
     );
 });
 
+test('auto-paint caps and optimizer palettes use the same discrete printable stack', async () => {
+    const {
+        autoPaintToSliceHeights,
+        buildAchievableColorPalette,
+        floorAutoPaintHeightToPrintableStack,
+        generateAutoLayers,
+        rgbToHex,
+    } = await loadAutoPaintModule();
+    const layerHeight = 0.1;
+    const firstLayerHeight = 0.2;
+    const maxHeight = 0.35;
+    const filaments = [
+        { id: 'black', color: '#000000', td: 1 },
+        { id: 'white', color: '#ffffff', td: 1.5 },
+    ];
+    const swatches = [
+        { hex: '#000000', count: 10 },
+        { hex: '#ffffff', count: 10 },
+    ];
+
+    const result = generateAutoLayers(
+        filaments,
+        swatches,
+        layerHeight,
+        firstLayerHeight,
+        maxHeight,
+        false
+    );
+    const slices = autoPaintToSliceHeights(result, layerHeight, firstLayerHeight);
+    const printedHeight = slices.colorSliceHeights.reduce(
+        (total, height, index) => total + (index === 0 ? Math.max(height, firstLayerHeight) : height),
+        0
+    );
+
+    assertAlmostEqual(result.totalHeight, 0.3, 'cap should snap down to a valid stack height');
+    assertAlmostEqual(printedHeight, result.totalHeight, 'reported and printable heights must agree');
+    assert.ok(printedHeight <= maxHeight + EPSILON, 'the printed stack must not exceed Max Height');
+    assert.equal(
+        floorAutoPaintHeightToPrintableStack(0.15, layerHeight, firstLayerHeight),
+        0,
+        'an impossible cap must not be rounded up past the requested maximum'
+    );
+
+    const palette = buildAchievableColorPalette(
+        filaments.map((filament) => ({ ...filament, td: filament.td * 0.1 })),
+        layerHeight,
+        firstLayerHeight,
+        maxHeight
+    );
+    assert.deepEqual(
+        palette.map((entry) => entry.height),
+        slices.colorSliceHeights.reduce<number[]>((heights, thickness) => {
+            heights.push(Number(((heights.at(-1) ?? 0) + thickness).toFixed(8)));
+            return heights;
+        }, []),
+        'the optimizer palette must sample the same layer tops as the preview'
+    );
+    assert.deepEqual(
+        palette.map((entry) => rgbToHex(entry.rgb)),
+        slices.virtualSwatches.map((swatch) => swatch.hex),
+        'the optimizer palette must use the preview-visible layer colors'
+    );
+});
+
 test('enhanced repeated-swap search keeps the printable red-to-pink transition', async () => {
     const { autoPaintToSliceHeights, generateAutoLayers, hexToRgb } =
         await loadAutoPaintModule();

From 0ec0b492dfd0c060f97b08cbe9c043502e1b0bc7 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 12:33:46 +0300
Subject: [PATCH 20/81] Use calibrated TDs for auto-paint transitions

---
 CHANGELOG.md            |  2 +-
 README.md               |  2 +-
 src/docs/3d-mode.md     |  2 +-
 src/lib/autoPaint.ts    | 41 +++++++++++++++++-------
 tests/autoPaint.test.ts | 70 ++++++++++++++++++++++++++++++++++++++---
 5 files changed, 99 insertions(+), 18 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c94c273..7851696 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,7 +16,7 @@ All notable changes to Kromacut are documented in this file.
 - **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
 - **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
-- **Calibrated Auto-paint previews** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends, while the scalar working TD continues to control layer-zone thickness.
+- **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 
 ### Fixed
 
diff --git a/README.md b/README.md
index f4c6a56..adea118 100644
--- a/README.md
+++ b/README.md
@@ -134,7 +134,7 @@ Each filament row in the Auto-paint tab includes a **calibration wizard** to hel
 4. **Automatic TD calculation** — The wizard performs exponential regression on your measurements to compute the optimal TD value with a confidence score (High/Medium/Low/Very Low).
 5. **Save profile** — Keep calibrated filaments in a reusable profile for future projects.
 
-Calibrated filaments display a confidence badge next to their TD value. Higher confidence = more accurate optical simulation = better print results. Auto-paint also uses the calibrated red, green, and blue TD values for preview blending, while the working TD continues to set layer-zone thickness.
+Calibrated filaments display a confidence badge next to their TD value. Higher confidence = more accurate optical simulation = better print results. Auto-paint uses calibrated red, green, and blue TD values for both preview blending and transition-zone thickness, so calibration can change the generated stack height and swap plan.
 
 ### Advanced Optimizer
 
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 51f8f4b..656a480 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -82,7 +82,7 @@ Optional controls appear with enhanced matching:
 
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
 
-When a filament has been calibrated, Auto-paint also uses its measured red, green, and blue TD values to preview color transitions. The normal working TD still controls layer-zone thickness, so calibration makes the color model more faithful without changing your print-height settings.
+When a filament has been calibrated, Auto-paint uses its measured red, green, and blue TD values for both transition colors and transition thickness. Calibration can therefore change the generated stack height and swap plan as well as the preview color, making the print model more faithful to the measured filament.
 
 ## Flat Paint
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index eb83af8..248b000 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -320,14 +320,23 @@ function optimizerColorDistance(left: Lab, right: Lab): number {
 /**
  * Calculate the opacity (how opaque) a filament layer is at a given thickness.
  *
- * @param filamentTD - Transmission Distance (mm)
+ * @param filamentTD - Scalar TD, or calibrated R, G, B TDs (mm)
  * @param thickness - Layer thickness (mm)
- * @returns Opacity value (0-1)
+ * @returns Opacity value (0-1); calibrated TDs return the least-opaque channel
  */
-export function getOpacity(filamentTD: number, thickness: number): number {
-    if (filamentTD <= 0 || thickness <= 0) return 0;
-    const transmission = Math.pow(0.1, thickness / filamentTD);
-    return 1 - transmission;
+export function getOpacity(
+    filamentTD: number | CalibrationRgb,
+    thickness: number
+): number {
+    if (thickness <= 0) return 0;
+
+    const channelTds: CalibrationRgb =
+        typeof filamentTD === 'number' ? [filamentTD, filamentTD, filamentTD] : filamentTD;
+    if (channelTds.some((td) => !Number.isFinite(td) || td <= 0)) return 0;
+
+    return Math.min(
+        ...channelTds.map((td) => 1 - Math.pow(0.1, thickness / td))
+    );
 }
 
 // =============================================================================
@@ -385,14 +394,14 @@ function scaleFilamentForFrontlight(filament: Filament): Filament {
  *
  * @param backgroundColor - Starting background color
  * @param filamentColor - Target filament color
- * @param filamentTD - Transmission distance of the filament
+ * @param filamentTD - Scalar TD or calibrated R, G, B TDs of the filament
  * @param layerHeight - Physical layer height increment
  * @returns Thickness needed for complete transition
  */
 export function calculateTransitionThickness(
     backgroundColor: RGB,
     filamentColor: RGB,
-    filamentTD: number,
+    filamentTD: number | CalibrationRgb,
     layerHeight: number
 ): number {
     // Early exit if colors are already close
@@ -402,6 +411,11 @@ export function calculateTransitionThickness(
 
     let thickness = 0;
     let currentColor = backgroundColor;
+    const channelTds: CalibrationRgb =
+        typeof filamentTD === 'number' ? [filamentTD, filamentTD, filamentTD] : filamentTD;
+    if (channelTds.some((td) => !Number.isFinite(td) || td <= 0)) {
+        return layerHeight;
+    }
 
     // The cap determines the absolute maximum transition thickness.
     // At 0.7×TD, opacity ≈ 80%. At 1×TD, opacity ≈ 90%.
@@ -410,7 +424,7 @@ export function calculateTransitionThickness(
     // We use 0.7×TD — if the color hasn't converged by ~80% opacity,
     // additional thickness gives diminishing visual returns.
     const OPACITY_CAP = 0.7;
-    const maxThickness = Math.max(layerHeight, filamentTD * OPACITY_CAP);
+    const maxThickness = Math.max(layerHeight, Math.max(...channelTds) * OPACITY_CAP);
 
     // Simulate adding layers until color converges or we hit the cap
     while (thickness < maxThickness) {
@@ -484,6 +498,7 @@ export function calculateIdealHeight(
     for (let i = 1; i < sortedFilaments.length; i++) {
         const filament = sortedFilaments[i];
         const filamentRgb = hexToRgb(filament.color);
+        const transitionTd = calibratedTdChannels(filament) ?? filament.td;
 
         // Calculate how thick this zone needs to be
         const transitionKey = [
@@ -493,7 +508,11 @@ export function calculateIdealHeight(
             filamentRgb.r,
             filamentRgb.g,
             filamentRgb.b,
-            filament.td,
+            ...(
+                typeof transitionTd === 'number'
+                    ? [transitionTd]
+                    : transitionTd
+            ),
             layerHeight,
         ].join(':');
         let transitionThickness = transitionThicknessCache?.get(transitionKey);
@@ -501,7 +520,7 @@ export function calculateIdealHeight(
             transitionThickness = calculateTransitionThickness(
                 currentBackgroundColor,
                 filamentRgb,
-                filament.td,
+                transitionTd,
                 layerHeight
             );
             transitionThicknessCache?.set(transitionKey, transitionThickness);
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 42fedd4..420b9b3 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -76,6 +76,64 @@ test('transition thickness stays printable and respects its TD cap', async () =>
     );
 });
 
+test('calibrated channel TDs determine transition thickness', async () => {
+    const { calculateTransitionThickness, hexToRgb } = await loadAutoPaintModule();
+    const layerHeight = 0.1;
+    const scalarThickness = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        1,
+        layerHeight
+    );
+    const calibratedThickness = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        [0.5, 1, 2],
+        layerHeight
+    );
+
+    assert.ok(
+        calibratedThickness > scalarThickness,
+        'the slowest calibrated channel must be allowed more transition thickness'
+    );
+    assert.ok(
+        calibratedThickness <= 2 * 0.7 + EPSILON,
+        'the calibrated transition must respect the slowest-channel TD cap'
+    );
+});
+
+test('transition-thickness cache distinguishes calibrated channel TDs', async () => {
+    const { calculateIdealHeight } = await loadAutoPaintModule();
+    const cache = new Map<string, number>();
+    const baseStack = [
+        { id: 'black', color: '#000000', td: 0.2 },
+        { id: 'white', color: '#ffffff', td: 1 },
+    ];
+    const calibratedStack = [
+        baseStack[0],
+        {
+            ...baseStack[1],
+            calibration: {
+                color: '#ffffff',
+                measurements: [],
+                td: [0.5, 1, 2] as [number, number, number],
+                tdSingleValue: 1,
+                confidence: 1,
+                calibrationDate: '2026-01-01T00:00:00.000Z',
+            },
+        },
+    ];
+
+    const scalar = calculateIdealHeight(baseStack, 0.1, 0.2, cache);
+    const calibrated = calculateIdealHeight(calibratedStack, 0.1, 0.2, cache);
+
+    assert.ok(
+        calibrated.zones[1].idealThickness > scalar.zones[1].idealThickness,
+        'a calibrated transition must not reuse a scalar-TD cache entry'
+    );
+    assert.equal(cache.size, 2, 'scalar and calibrated transition calculations need distinct keys');
+});
+
 test('calibrated per-channel TDs tint blends without changing scalar TD behavior', async () => {
     const { blendColors } = await loadAutoPaintModule();
     const background = { r: 0, g: 0, b: 0 };
@@ -129,10 +187,14 @@ test('calibrated channel TDs flow through generated auto-paint preview slices',
     const scalarSlices = autoPaintToSliceHeights(scalarResult, 0.1, 0.2);
     const calibratedSlices = autoPaintToSliceHeights(calibratedResult, 0.1, 0.2);
 
-    assert.deepEqual(
-        calibratedSlices.colorSliceHeights,
-        scalarSlices.colorSliceHeights,
-        'zone thickness remains governed by the scalar working TD'
+    assert.ok(
+        calibratedResult.transitionZones[1].idealThickness >
+            scalarResult.transitionZones[1].idealThickness,
+        'calibrated channel TDs must change the planned transition thickness'
+    );
+    assert.ok(
+        calibratedSlices.colorSliceHeights.length > scalarSlices.colorSliceHeights.length,
+        'the preview must contain the additional calibrated transition layers'
     );
     const whiteLayer = calibratedSlices.filamentSwatches.findIndex((swatch) => swatch.hex === '#ffffff');
     assert.ok(whiteLayer >= 0, 'the calibrated filament should contribute preview layers');

From 2efd54710826377d12af687134e671fe0df92084 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 12:41:55 +0300
Subject: [PATCH 21/81] Chain auto-paint transition colors

---
 CHANGELOG.md                         |   1 +
 src/lib/autoPaint.ts                 |  18 +-
 tests/assets/auto-paint-goldens.json | 450 +++++++++++++++------------
 tests/autoPaint.test.ts              |  82 +++++
 4 files changed, 341 insertions(+), 210 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7851696..3439624 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
 - **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
+- **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 
 ### Fixed
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 248b000..9fabea1 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -356,7 +356,6 @@ const DELTA_E_THRESHOLD = 2.3; // "Just noticeable difference"
  */
 const FRONTLIT_TD_SCALE = 0.1;
 const USE_CALIBRATED_CHANNEL_TD = true;
-const USE_COMPRESSION_AWARE_BACKGROUNDS = false;
 
 type AutoPaintFilament = Pick<Filament, 'id' | 'color' | 'td' | 'calibration'>;
 
@@ -537,8 +536,14 @@ export function calculateIdealHeight(
             actualThickness: transitionThickness,
         });
 
-        // Update for next iteration
-        currentBackgroundColor = filamentRgb;
+        // The next filament is deposited over this transition's actual end
+        // color, not an idealized pure-filament shortcut.
+        currentBackgroundColor = blendColors(
+            currentBackgroundColor,
+            filamentRgb,
+            transitionTd,
+            transitionThickness
+        );
         currentHeight += transitionThickness;
     }
 
@@ -793,12 +798,7 @@ function buildZoneBackgrounds(zones: TransitionZone[]): RGB[] {
     for (let index = 0; index < zones.length; index++) {
         const zone = zones[index];
         const filamentColor = hexToRgb(zone.filamentColor);
-        const backgroundColor =
-            index === 0
-                ? filamentColor
-                : USE_COMPRESSION_AWARE_BACKGROUNDS
-                  ? previousEndColor
-                  : hexToRgb(zones[index - 1].filamentColor);
+        const backgroundColor = index === 0 ? filamentColor : previousEndColor;
         backgrounds.push(backgroundColor);
 
         previousEndColor =
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index b152177..d15f749 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -217,7 +217,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.24,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
@@ -257,7 +257,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.24,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
@@ -273,52 +273,44 @@
   },
   "GH#27 / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "xud8mzr",
       "plvjtmc",
       "y202l1e",
-      "h8zuocq"
+      "xud8mzr"
     ],
     "transitionZones": [
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.56
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.56,
-        "endHeight": 0.64,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "startHeight": 0,
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.64,
-        "endHeight": 0.96,
+        "startHeight": 0.16,
+        "endHeight": 0.56,
         "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.96,
-        "endHeight": 1.2,
-        "idealThickness": 0.245,
+        "filamentId": "xud8mzr",
+        "startHeight": 0.56,
+        "endHeight": 0.8,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.2,
+    "totalHeight": 0.8,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
       "plvjtmc",
+      "y202l1e",
       "xud8mzr",
-      "h8zuocq",
-      "plvjtmc",
       "y202l1e",
-      "h8zuocq"
+      "h8zuocq",
+      "y202l1e"
     ],
     "transitionZones": [
       {
@@ -329,25 +321,18 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "y202l1e",
         "startHeight": 0.16,
-        "endHeight": 0.48,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.48,
-        "endHeight": 0.72,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.56,
+        "idealThickness": 0.329,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.72,
+        "filamentId": "xud8mzr",
+        "startHeight": 0.56,
         "endHeight": 0.8,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
@@ -362,9 +347,16 @@
         "endHeight": 1.36,
         "idealThickness": 0.245,
         "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 1.36,
+        "endHeight": 1.68,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.36,
+    "totalHeight": 1.68,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -393,7 +385,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.24,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
@@ -433,7 +425,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.24,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
@@ -451,8 +443,8 @@
     "filamentOrder": [
       "plvjtmc",
       "xud8mzr",
-      "h8zuocq",
-      "y202l1e"
+      "y202l1e",
+      "h8zuocq"
     ],
     "transitionZones": [
       {
@@ -470,18 +462,18 @@
         "actualThickness": 0.32
       },
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "y202l1e",
         "startHeight": 0.48,
-        "endHeight": 0.72,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.8,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.72,
+        "filamentId": "h8zuocq",
+        "startHeight": 0.8,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "idealThickness": 0.245,
+        "actualThickness": 0.24
       }
     ],
     "totalHeight": 1.04,
@@ -491,8 +483,9 @@
     "filamentOrder": [
       "plvjtmc",
       "xud8mzr",
-      "h8zuocq",
       "y202l1e",
+      "xud8mzr",
+      "h8zuocq",
       "xud8mzr"
     ],
     "transitionZones": [
@@ -510,29 +503,36 @@
         "idealThickness": 0.259,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.48,
-        "endHeight": 0.72,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
-      },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.72,
-        "endHeight": 1.04,
+        "startHeight": 0.48,
+        "endHeight": 0.8,
         "idealThickness": 0.329,
         "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
+        "startHeight": 0.8,
+        "endHeight": 1.04,
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "h8zuocq",
         "startHeight": 1.04,
         "endHeight": 1.28,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 1.28,
+        "endHeight": 1.52,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.28,
+    "totalHeight": 1.52,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -681,170 +681,178 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "vsn9q6u",
       "98z555k",
       "xyyxysq",
       "w8cncoa",
-      "p9c63ms",
+      "vsn9q6u",
       "plvjtmc",
-      "azwg1yp"
+      "azwg1yp",
+      "p9c63ms",
+      "upcjpfe"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "98z555k",
         "startHeight": 0,
         "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
+        "idealThickness": 0.507,
         "actualThickness": 0.56
       },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 0.56,
-        "endHeight": 0.8,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
-      },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 0.8,
-        "endHeight": 1.2,
+        "startHeight": 0.56,
+        "endHeight": 0.88,
         "idealThickness": 0.357,
-        "actualThickness": 0.4
+        "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.2,
-        "endHeight": 1.6,
+        "startHeight": 0.88,
+        "endHeight": 1.36,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
+        "actualThickness": 0.48
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.6,
-        "endHeight": 2,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.36,
+        "endHeight": 1.6,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 2,
-        "endHeight": 2.08,
+        "startHeight": 1.6,
+        "endHeight": 1.68,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.08,
-        "endHeight": 2.32,
+        "startHeight": 1.68,
+        "endHeight": 1.92,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.24
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.92,
+        "endHeight": 2.32,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 2.32,
+        "endHeight": 2.64,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.32,
+    "totalHeight": 2.64,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "98z555k",
       "azwg1yp",
       "xyyxysq",
       "w8cncoa",
-      "p9c63ms",
+      "azwg1yp",
       "vsn9q6u",
       "98z555k",
-      "plvjtmc",
-      "azwg1yp",
       "vsn9q6u",
-      "w8cncoa",
-      "xyyxysq"
+      "upcjpfe",
+      "azwg1yp",
+      "upcjpfe",
+      "p9c63ms",
+      "w8cncoa"
     ],
     "transitionZones": [
-      {
-        "filamentId": "98z555k",
-        "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.56,
-        "endHeight": 0.72,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "startHeight": 0,
+        "endHeight": 0.4,
+        "idealThickness": 0.364,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 0.72,
-        "endHeight": 1.12,
+        "startHeight": 0.4,
+        "endHeight": 0.8,
         "idealThickness": 0.357,
         "actualThickness": 0.4
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.12,
-        "endHeight": 1.52,
+        "startHeight": 0.8,
+        "endHeight": 1.2,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.4
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.52,
-        "endHeight": 2,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.48
+        "filamentId": "azwg1yp",
+        "startHeight": 1.2,
+        "endHeight": 1.36,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2,
-        "endHeight": 2.24,
+        "startHeight": 1.36,
+        "endHeight": 1.68,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "actualThickness": 0.32
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.24,
-        "endHeight": 2.48,
+        "startHeight": 1.68,
+        "endHeight": 1.92,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.48,
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.92,
+        "endHeight": 2.24,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 2.24,
         "endHeight": 2.56,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "azwg1yp",
         "startHeight": 2.56,
-        "endHeight": 2.8,
+        "endHeight": 2.72,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.24
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.8,
-        "endHeight": 3.04,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "filamentId": "upcjpfe",
+        "startHeight": 2.72,
+        "endHeight": 3.12,
+        "idealThickness": 0.343,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 3.04,
+        "filamentId": "p9c63ms",
+        "startHeight": 3.12,
         "endHeight": 3.52,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.48
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "xyyxysq",
+        "filamentId": "w8cncoa",
         "startHeight": 3.52,
-        "endHeight": 3.84,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "endHeight": 3.92,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 3.84,
+    "totalHeight": 3.92,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -993,122 +1001,162 @@
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "plvjtmc",
-      "p9c63ms",
       "98z555k",
       "upcjpfe",
-      "vsn9q6u",
-      "xyyxysq"
+      "azwg1yp",
+      "plvjtmc",
+      "p9c63ms",
+      "w8cncoa"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.56,
+        "idealThickness": 0.507,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 0.16,
-        "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.48
+        "filamentId": "upcjpfe",
+        "startHeight": 0.56,
+        "endHeight": 0.88,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 0.64,
-        "endHeight": 0.88,
-        "idealThickness": 0.27299999999999996,
+        "filamentId": "azwg1yp",
+        "startHeight": 0.88,
+        "endHeight": 1.12,
+        "idealThickness": 0.19599999999999998,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.88,
+        "filamentId": "plvjtmc",
+        "startHeight": 1.12,
         "endHeight": 1.2,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "p9c63ms",
         "startHeight": 1.2,
-        "endHeight": 1.52,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "endHeight": 1.6,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.52,
-        "endHeight": 1.84,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "filamentId": "w8cncoa",
+        "startHeight": 1.6,
+        "endHeight": 2,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 1.84,
+    "totalHeight": 2,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "98z555k",
+      "upcjpfe",
       "plvjtmc",
       "p9c63ms",
+      "w8cncoa",
       "98z555k",
-      "upcjpfe",
       "vsn9q6u",
       "xyyxysq",
-      "vsn9q6u"
+      "vsn9q6u",
+      "xyyxysq",
+      "plvjtmc",
+      "p9c63ms"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.56,
+        "idealThickness": 0.507,
+        "actualThickness": 0.56
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.56,
+        "endHeight": 0.88,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.88,
+        "endHeight": 0.96,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 0.16,
-        "endHeight": 0.64,
+        "startHeight": 0.96,
+        "endHeight": 1.36,
         "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.36,
+        "endHeight": 1.84,
+        "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.64,
-        "endHeight": 0.88,
+        "startHeight": 1.84,
+        "endHeight": 2.08,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.2,
-        "endHeight": 1.52,
+        "startHeight": 2.08,
+        "endHeight": 2.4,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.52,
-        "endHeight": 1.84,
+        "startHeight": 2.4,
+        "endHeight": 2.72,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.84,
-        "endHeight": 2.16,
+        "startHeight": 2.72,
+        "endHeight": 2.96,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 2.96,
+        "endHeight": 3.36,
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 3.36,
+        "endHeight": 3.44,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 3.44,
+        "endHeight": 3.84,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.16,
+    "totalHeight": 3.84,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 420b9b3..753434b 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -259,6 +259,88 @@ test('ideal-height zones include a foundation and remain contiguous when compres
     assert.deepEqual(noCompression.compressedZones, zones);
 });
 
+test('transition planning carries the actual prior end color into the next zone', async () => {
+    const { blendColors, calculateIdealHeight, calculateTransitionThickness, hexToRgb } =
+        await loadAutoPaintModule();
+    const layerHeight = 0.04;
+    const foundation = hexToRgb('#ff0000');
+    const middle = hexToRgb('#ff8800');
+    const final = hexToRgb('#ff0000');
+    const middleThickness = calculateTransitionThickness(foundation, middle, 0.2, layerHeight);
+    const actualMiddleEnd = blendColors(foundation, middle, 0.2, middleThickness);
+    const chainedFinalThickness = calculateTransitionThickness(
+        actualMiddleEnd,
+        final,
+        0.3,
+        layerHeight
+    );
+    const pureMiddleFinalThickness = calculateTransitionThickness(
+        middle,
+        final,
+        0.3,
+        layerHeight
+    );
+    const { zones } = calculateIdealHeight(
+        [
+            { id: 'foundation', color: '#ff0000', td: 0.1 },
+            { id: 'middle', color: '#ff8800', td: 0.2 },
+            { id: 'final', color: '#ff0000', td: 0.3 },
+        ],
+        layerHeight,
+        layerHeight
+    );
+
+    assertAlmostEqual(zones[2].idealThickness, chainedFinalThickness);
+    assert.notEqual(
+        chainedFinalThickness,
+        pureMiddleFinalThickness,
+        'the fixture must distinguish chained and pure-filament backgrounds'
+    );
+});
+
+test('preview slices blend each zone over the actual prior end color', async () => {
+    const { autoPaintToSliceHeights, blendColors, hexToRgb, rgbToHex } =
+        await loadAutoPaintModule();
+    const first = hexToRgb('#ff0000');
+    const middle = hexToRgb('#ff8800');
+    const final = hexToRgb('#ff0000');
+    const middleEnd = blendColors(first, middle, 0.2, 0.1);
+    const expectedFinal = rgbToHex(blendColors(middleEnd, final, 0.3, 0.1));
+    const pureMiddleFinal = rgbToHex(blendColors(middle, final, 0.3, 0.1));
+    const result = {
+        layers: [
+            { filamentId: 'first', filamentColor: '#ff0000', startHeight: 0, endHeight: 0.1 },
+            { filamentId: 'middle', filamentColor: '#ff8800', startHeight: 0.1, endHeight: 0.2 },
+            { filamentId: 'final', filamentColor: '#ff0000', startHeight: 0.2, endHeight: 0.3 },
+        ],
+        totalHeight: 0.3,
+        idealHeight: 0.3,
+        autoHeight: 0.3,
+        compressionRatio: 1,
+        filamentOrder: ['first', 'middle', 'final'],
+        transitionZones: [
+            {
+                filamentId: 'first', filamentColor: '#ff0000', filamentTd: 0.1,
+                startHeight: 0, endHeight: 0.1, idealThickness: 0.1, actualThickness: 0.1,
+            },
+            {
+                filamentId: 'middle', filamentColor: '#ff8800', filamentTd: 0.2,
+                startHeight: 0.1, endHeight: 0.2, idealThickness: 0.1, actualThickness: 0.1,
+            },
+            {
+                filamentId: 'final', filamentColor: '#ff0000', filamentTd: 0.3,
+                startHeight: 0.2, endHeight: 0.3, idealThickness: 0.1, actualThickness: 0.1,
+            },
+        ],
+        confidence: 1,
+        confidenceFactors: { calibrationQuality: 1, filamentCoverage: 1, compressionImpact: 1 },
+    };
+
+    const slices = autoPaintToSliceHeights(result, 0.1, 0.1);
+    assert.equal(slices.virtualSwatches.at(-1)?.hex, expectedFinal);
+    assert.notEqual(expectedFinal, pureMiddleFinal, 'the fixture must expose chained blending');
+});
+
 test('auto-paint slice data stays synchronized and uses print-layer heights', async () => {
     const { autoPaintToSliceHeights, generateAutoLayers } = await loadAutoPaintModule();
     const layerHeight = 0.1;

From f1273b517094ffa96aa6c651f64c97205ef815ca Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 12:54:01 +0300
Subject: [PATCH 22/81] Use linear-light auto-paint blending

---
 CHANGELOG.md                         |   1 +
 README.md                            |   2 +-
 src/lib/autoPaint.ts                 |  24 +-
 tests/assets/auto-paint-goldens.json | 508 ++++++++++++++-------------
 tests/autoPaint.test.ts              |  39 +-
 5 files changed, 315 insertions(+), 259 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3439624..e0b62b7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -18,6 +18,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
+- **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
 
 ### Fixed
 
diff --git a/README.md b/README.md
index adea118..b221319 100644
--- a/README.md
+++ b/README.md
@@ -112,7 +112,7 @@ Auto-paint is an automated layer-generation mode that replaces the manual palett
 ### Core concepts
 
 - **Filaments**: Each filament has a hex color and a **Transmission Distance (TD)** value (in mm). TD describes how translucent the filament is — at a thickness equal to TD, only ~10% of light passes through. Dark/opaque filaments have low TD (e.g. 0.5 mm); light/translucent filaments have high TD (e.g. 6+ mm). When you add a filament without specifying a TD, Kromacut estimates one from the color's luminance and saturation.
-- **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / TD)`. This physically models the color you see when printing thin semi-transparent layers on top of each other.
+- **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / TD)`. It blends in linear-light sRGB before converting back for display and color matching, which better models the color you see from thin semi-transparent layers.
 - **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or opacity exceeds 85%. The result is a set of transition zones, each with a start height, end height, and the filament used.
 - **Luminance-to-height mapping**: Once the transition zones are computed, each pixel's brightness is mapped to a target height in the model. Dark pixels get the minimum height (base layer only), bright pixels get the full height (all layers), and mid-tones fall proportionally in between. This produces the characteristic lithophane-style relief where image brightness = model thickness.
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 9fabea1..cfc335c 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -127,6 +127,22 @@ export function rgbToHex(rgb: RGB): string {
     return `#${toHex(rgb.r)}${toHex(rgb.g)}${toHex(rgb.b)}`;
 }
 
+function srgbChannelToLinear(channel: number): number {
+    const normalized = Math.max(0, Math.min(255, channel)) / 255;
+    return normalized <= 0.04045
+        ? normalized / 12.92
+        : Math.pow((normalized + 0.055) / 1.055, 2.4);
+}
+
+function linearChannelToSrgb(channel: number): number {
+    const clamped = Math.max(0, Math.min(1, channel));
+    const normalized =
+        clamped <= 0.0031308
+            ? clamped * 12.92
+            : 1.055 * Math.pow(clamped, 1 / 2.4) - 0.055;
+    return normalized * 255;
+}
+
 /**
  * Convert RGB (0-255) to Lab color space for perceptual color difference
  */
@@ -215,6 +231,8 @@ export function getLuminance(color: RGB): number {
  *
  * The transmission follows: T = 0.1^(thickness/TD)
  * At thickness == TD, transmission is 10% (filament definition of TD).
+ * Blending takes place in linear-light sRGB, then converts back to display
+ * sRGB for color matching and preview output.
  *
  * @param backgroundColor - The color of the existing stack
  * @param filamentColor - The color of the filament being added
@@ -242,7 +260,11 @@ export function blendColors(
         // Beer-Lambert law: transmission = 10^(-thickness/TD).
         // At thickness == TD, transmission = 10^(-1) = 0.1 (10%).
         const transmission = Math.pow(0.1, layerThickness / td);
-        return filament * (1 - transmission) + background * transmission;
+        const backgroundLinear = srgbChannelToLinear(background);
+        const filamentLinear = srgbChannelToLinear(filament);
+        return linearChannelToSrgb(
+            filamentLinear * (1 - transmission) + backgroundLinear * transmission
+        );
     };
 
     return {
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index d15f749..6be460e 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -170,7 +170,8 @@
   "B&W / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
       "plvjtmc",
-      "p9c63ms"
+      "p9c63ms",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
@@ -186,9 +187,16 @@
         "endHeight": 0.64,
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.48
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.64,
+        "endHeight": 0.72,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 0.64,
+    "totalHeight": 0.72,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=false / repeats=false": {
@@ -217,7 +225,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
@@ -257,7 +265,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
@@ -274,8 +282,9 @@
   "GH#27 / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
       "plvjtmc",
+      "xud8mzr",
       "y202l1e",
-      "xud8mzr"
+      "h8zuocq"
     ],
     "transitionZones": [
       {
@@ -286,29 +295,37 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.16,
-        "endHeight": 0.56,
-        "idealThickness": 0.329,
-        "actualThickness": 0.4
+        "endHeight": 0.48,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.56,
+        "filamentId": "y202l1e",
+        "startHeight": 0.48,
         "endHeight": 0.8,
-        "idealThickness": 0.259,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.8,
+        "endHeight": 1.04,
+        "idealThickness": 0.245,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 0.8,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
       "plvjtmc",
-      "y202l1e",
       "xud8mzr",
       "y202l1e",
+      "plvjtmc",
+      "y202l1e",
       "h8zuocq",
       "y202l1e"
     ],
@@ -321,42 +338,49 @@
         "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.16,
-        "endHeight": 0.56,
-        "idealThickness": 0.329,
-        "actualThickness": 0.4
+        "endHeight": 0.48,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.56,
+        "filamentId": "y202l1e",
+        "startHeight": 0.48,
         "endHeight": 0.8,
-        "idealThickness": 0.259,
-        "actualThickness": 0.24
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "plvjtmc",
         "startHeight": 0.8,
-        "endHeight": 1.12,
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
         "idealThickness": 0.329,
         "actualThickness": 0.32
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
+        "startHeight": 1.2,
+        "endHeight": 1.44,
         "idealThickness": 0.245,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 1.36,
-        "endHeight": 1.68,
+        "startHeight": 1.44,
+        "endHeight": 1.76,
         "idealThickness": 0.329,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.68,
+    "totalHeight": 1.76,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -385,7 +409,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
@@ -425,7 +449,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0.48,
         "endHeight": 0.72,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
@@ -441,25 +465,18 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "plvjtmc",
-      "xud8mzr",
+      "h8zuocq",
       "y202l1e",
-      "h8zuocq"
+      "plvjtmc",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "h8zuocq",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
-      },
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
+        "idealThickness": 0.45500000000000007,
+        "actualThickness": 0.48
       },
       {
         "filamentId": "y202l1e",
@@ -469,39 +486,41 @@
         "actualThickness": 0.32
       },
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0.8,
-        "endHeight": 1.04,
-        "idealThickness": 0.245,
-        "actualThickness": 0.24
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.04,
+    "totalHeight": 1.2,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "plvjtmc",
-      "xud8mzr",
+      "h8zuocq",
       "y202l1e",
-      "xud8mzr",
+      "plvjtmc",
       "h8zuocq",
-      "xud8mzr"
+      "plvjtmc",
+      "xud8mzr",
+      "plvjtmc",
+      "y202l1e"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "h8zuocq",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
-      },
-      {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
+        "idealThickness": 0.45500000000000007,
+        "actualThickness": 0.48
       },
       {
         "filamentId": "y202l1e",
@@ -511,28 +530,49 @@
         "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "plvjtmc",
         "startHeight": 0.8,
-        "endHeight": 1.04,
-        "idealThickness": 0.259,
-        "actualThickness": 0.24
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 1.04,
-        "endHeight": 1.28,
-        "idealThickness": 0.24,
+        "startHeight": 0.88,
+        "endHeight": 1.12,
+        "idealThickness": 0.245,
         "actualThickness": 0.24
       },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.12,
+        "endHeight": 1.2,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 1.28,
+        "startHeight": 1.2,
         "endHeight": 1.52,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.52,
+        "endHeight": 1.6,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 1.6,
+        "endHeight": 1.92,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.52,
+    "totalHeight": 1.92,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -681,90 +721,74 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "98z555k",
-      "xyyxysq",
-      "w8cncoa",
-      "vsn9q6u",
       "plvjtmc",
       "azwg1yp",
-      "p9c63ms",
-      "upcjpfe"
+      "upcjpfe",
+      "w8cncoa",
+      "vsn9q6u",
+      "98z555k"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 0.56,
-        "endHeight": 0.88,
-        "idealThickness": 0.357,
+        "filamentId": "azwg1yp",
+        "startHeight": 0.16,
+        "endHeight": 0.4,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.4,
+        "endHeight": 0.72,
+        "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 0.88,
-        "endHeight": 1.36,
+        "startHeight": 0.72,
+        "endHeight": 1.2,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.36,
-        "endHeight": 1.6,
+        "startHeight": 1.2,
+        "endHeight": 1.44,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.6,
+        "filamentId": "98z555k",
+        "startHeight": 1.44,
         "endHeight": 1.68,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 1.68,
-        "endHeight": 1.92,
-        "idealThickness": 0.19599999999999998,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
-      },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.92,
-        "endHeight": 2.32,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.32,
-        "endHeight": 2.64,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.64,
+    "totalHeight": 1.68,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
       "azwg1yp",
       "xyyxysq",
+      "upcjpfe",
       "w8cncoa",
+      "vsn9q6u",
+      "98z555k",
+      "plvjtmc",
       "azwg1yp",
       "vsn9q6u",
       "98z555k",
       "vsn9q6u",
-      "upcjpfe",
-      "azwg1yp",
-      "upcjpfe",
-      "p9c63ms",
-      "w8cncoa"
+      "98z555k"
     ],
     "transitionZones": [
       {
@@ -782,77 +806,77 @@
         "actualThickness": 0.4
       },
       {
-        "filamentId": "w8cncoa",
+        "filamentId": "upcjpfe",
         "startHeight": 0.8,
-        "endHeight": 1.2,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
+        "endHeight": 1.12,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "azwg1yp",
-        "startHeight": 1.2,
-        "endHeight": 1.36,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "filamentId": "w8cncoa",
+        "startHeight": 1.12,
+        "endHeight": 1.52,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.36,
-        "endHeight": 1.68,
+        "startHeight": 1.52,
+        "endHeight": 1.84,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.68,
-        "endHeight": 1.92,
+        "startHeight": 1.84,
+        "endHeight": 2.08,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.92,
-        "endHeight": 2.24,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.24,
-        "endHeight": 2.56,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 2.08,
+        "endHeight": 2.16,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.56,
-        "endHeight": 2.72,
+        "startHeight": 2.16,
+        "endHeight": 2.32,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.16
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.72,
-        "endHeight": 3.12,
-        "idealThickness": 0.343,
-        "actualThickness": 0.4
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.32,
+        "endHeight": 2.64,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 3.12,
-        "endHeight": 3.52,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "filamentId": "98z555k",
+        "startHeight": 2.64,
+        "endHeight": 2.88,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 3.52,
-        "endHeight": 3.92,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.88,
+        "endHeight": 3.2,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 3.2,
+        "endHeight": 3.44,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 3.92,
+    "totalHeight": 3.44,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -1001,162 +1025,154 @@
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "98z555k",
-      "upcjpfe",
+      "vsn9q6u",
       "azwg1yp",
-      "plvjtmc",
-      "p9c63ms",
-      "w8cncoa"
+      "upcjpfe",
+      "98z555k",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "vsn9q6u",
         "startHeight": 0,
         "endHeight": 0.56,
-        "idealThickness": 0.507,
+        "idealThickness": 0.49400000000000005,
         "actualThickness": 0.56
       },
       {
-        "filamentId": "upcjpfe",
+        "filamentId": "azwg1yp",
         "startHeight": 0.56,
-        "endHeight": 0.88,
+        "endHeight": 0.72,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "azwg1yp",
-        "startHeight": 0.88,
-        "endHeight": 1.12,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.24
+        "filamentId": "98z555k",
+        "startHeight": 1.04,
+        "endHeight": 1.36,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.12,
-        "endHeight": 1.2,
+        "startHeight": 1.36,
+        "endHeight": 1.44,
         "idealThickness": 0.08,
         "actualThickness": 0.08
-      },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.2,
-        "endHeight": 1.6,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
-      },
-      {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.6,
-        "endHeight": 2,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2,
+    "totalHeight": 1.44,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "98z555k",
-      "upcjpfe",
+      "p9c63ms",
+      "vsn9q6u",
       "plvjtmc",
       "p9c63ms",
-      "w8cncoa",
+      "plvjtmc",
+      "upcjpfe",
       "98z555k",
-      "vsn9q6u",
-      "xyyxysq",
-      "vsn9q6u",
-      "xyyxysq",
+      "upcjpfe",
+      "98z555k",
+      "upcjpfe",
       "plvjtmc",
       "p9c63ms"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "p9c63ms",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
+        "endHeight": 0.8,
+        "idealThickness": 0.7800000000000001,
+        "actualThickness": 0.8
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.56,
-        "endHeight": 0.88,
-        "idealThickness": 0.343,
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.8,
+        "endHeight": 1.12,
+        "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.88,
-        "endHeight": 0.96,
+        "startHeight": 1.12,
+        "endHeight": 1.2,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 0.96,
-        "endHeight": 1.36,
+        "startHeight": 1.2,
+        "endHeight": 1.6,
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.4
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.36,
-        "endHeight": 1.84,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.48
+        "filamentId": "plvjtmc",
+        "startHeight": 1.6,
+        "endHeight": 1.68,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 1.84,
-        "endHeight": 2.08,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "filamentId": "upcjpfe",
+        "startHeight": 1.68,
+        "endHeight": 2,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.08,
-        "endHeight": 2.4,
-        "idealThickness": 0.26599999999999996,
+        "filamentId": "98z555k",
+        "startHeight": 2,
+        "endHeight": 2.32,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 2.4,
-        "endHeight": 2.72,
-        "idealThickness": 0.357,
+        "filamentId": "upcjpfe",
+        "startHeight": 2.32,
+        "endHeight": 2.64,
+        "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.72,
-        "endHeight": 2.96,
-        "idealThickness": 0.26599999999999996,
+        "filamentId": "98z555k",
+        "startHeight": 2.64,
+        "endHeight": 2.88,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 2.96,
-        "endHeight": 3.36,
-        "idealThickness": 0.357,
+        "filamentId": "upcjpfe",
+        "startHeight": 2.88,
+        "endHeight": 3.28,
+        "idealThickness": 0.343,
         "actualThickness": 0.4
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 3.36,
-        "endHeight": 3.44,
+        "startHeight": 3.28,
+        "endHeight": 3.36,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 3.44,
-        "endHeight": 3.84,
+        "startHeight": 3.36,
+        "endHeight": 3.76,
         "idealThickness": 0.42000000000000004,
         "actualThickness": 0.4
       }
     ],
-    "totalHeight": 3.84,
+    "totalHeight": 3.76,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 753434b..9c5a192 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -150,6 +150,23 @@ test('calibrated per-channel TDs tint blends without changing scalar TD behavior
     );
 });
 
+test('Beer-Lambert blends operate in linear light before returning sRGB', async () => {
+    const { blendColors } = await loadAutoPaintModule();
+    const halfTransmissionThickness = Math.log10(2);
+    const blended = blendColors(
+        { r: 0, g: 0, b: 0 },
+        { r: 255, g: 255, b: 255 },
+        1,
+        halfTransmissionThickness
+    );
+    const expectedSrgb = 255 * (1.055 * Math.pow(0.5, 1 / 2.4) - 0.055);
+
+    assertAlmostEqual(blended.r, expectedSrgb);
+    assertAlmostEqual(blended.g, expectedSrgb);
+    assertAlmostEqual(blended.b, expectedSrgb);
+    assert.ok(blended.r > 180, 'a 50% linear-light blend must not be gamma-space mid-gray');
+});
+
 test('calibrated channel TDs flow through generated auto-paint preview slices', async () => {
     const { autoPaintToSliceHeights, generateAutoLayers, hexToRgb } =
         await loadAutoPaintModule();
@@ -262,29 +279,29 @@ test('ideal-height zones include a foundation and remain contiguous when compres
 test('transition planning carries the actual prior end color into the next zone', async () => {
     const { blendColors, calculateIdealHeight, calculateTransitionThickness, hexToRgb } =
         await loadAutoPaintModule();
-    const layerHeight = 0.04;
-    const foundation = hexToRgb('#ff0000');
-    const middle = hexToRgb('#ff8800');
-    const final = hexToRgb('#ff0000');
-    const middleThickness = calculateTransitionThickness(foundation, middle, 0.2, layerHeight);
-    const actualMiddleEnd = blendColors(foundation, middle, 0.2, middleThickness);
+    const layerHeight = 0.02;
+    const foundation = hexToRgb('#ffffff');
+    const middle = hexToRgb('#000000');
+    const final = hexToRgb('#666666');
+    const middleThickness = calculateTransitionThickness(foundation, middle, 0.1, layerHeight);
+    const actualMiddleEnd = blendColors(foundation, middle, 0.1, middleThickness);
     const chainedFinalThickness = calculateTransitionThickness(
         actualMiddleEnd,
         final,
-        0.3,
+        0.15,
         layerHeight
     );
     const pureMiddleFinalThickness = calculateTransitionThickness(
         middle,
         final,
-        0.3,
+        0.15,
         layerHeight
     );
     const { zones } = calculateIdealHeight(
         [
-            { id: 'foundation', color: '#ff0000', td: 0.1 },
-            { id: 'middle', color: '#ff8800', td: 0.2 },
-            { id: 'final', color: '#ff0000', td: 0.3 },
+            { id: 'foundation', color: '#ffffff', td: 0.1 },
+            { id: 'middle', color: '#000000', td: 0.1 },
+            { id: 'final', color: '#666666', td: 0.15 },
         ],
         layerHeight,
         layerHeight

From 7d6174edf4be885a2d1ca4ec3dda641a8a2a7a29 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 15:13:35 +0300
Subject: [PATCH 23/81] Fit filament calibration in linear-light model

---
 CHANGELOG.md              |   1 +
 src/lib/autoPaint.ts      |  23 +-------
 src/lib/calibration.ts    |  71 ++++++++++++++++++-------
 src/lib/colorSpace.ts     |  42 +++++++++++++++
 tests/calibration.test.ts | 109 ++++++++++++++++++++++++++++++++++++++
 5 files changed, 206 insertions(+), 40 deletions(-)
 create mode 100644 src/lib/colorSpace.ts
 create mode 100644 tests/calibration.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e0b62b7..f8a1320 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -19,6 +19,7 @@ All notable changes to Kromacut are documented in this file.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
+- **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
 
 ### Fixed
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index cfc335c..246ba25 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -16,6 +16,7 @@ import {
     type ScoringContext,
 } from './optimizer';
 import { computeProfileConfidence, type CalibrationRgb } from './calibration';
+import { blendSrgbChannel } from './colorSpace';
 
 export { LAYER_ACTIVATION_EPSILON } from './layerActivation';
 
@@ -127,22 +128,6 @@ export function rgbToHex(rgb: RGB): string {
     return `#${toHex(rgb.r)}${toHex(rgb.g)}${toHex(rgb.b)}`;
 }
 
-function srgbChannelToLinear(channel: number): number {
-    const normalized = Math.max(0, Math.min(255, channel)) / 255;
-    return normalized <= 0.04045
-        ? normalized / 12.92
-        : Math.pow((normalized + 0.055) / 1.055, 2.4);
-}
-
-function linearChannelToSrgb(channel: number): number {
-    const clamped = Math.max(0, Math.min(1, channel));
-    const normalized =
-        clamped <= 0.0031308
-            ? clamped * 12.92
-            : 1.055 * Math.pow(clamped, 1 / 2.4) - 0.055;
-    return normalized * 255;
-}
-
 /**
  * Convert RGB (0-255) to Lab color space for perceptual color difference
  */
@@ -260,11 +245,7 @@ export function blendColors(
         // Beer-Lambert law: transmission = 10^(-thickness/TD).
         // At thickness == TD, transmission = 10^(-1) = 0.1 (10%).
         const transmission = Math.pow(0.1, layerThickness / td);
-        const backgroundLinear = srgbChannelToLinear(background);
-        const filamentLinear = srgbChannelToLinear(filament);
-        return linearChannelToSrgb(
-            filamentLinear * (1 - transmission) + backgroundLinear * transmission
-        );
+        return blendSrgbChannel(background, filament, transmission);
     };
 
     return {
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index bd74984..fabf992 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -1,4 +1,5 @@
 import { estimateTDFromColor } from './colorUtils';
+import { blendSrgbChannel, srgbChannelToLinear } from './colorSpace';
 
 /**
  * Filament Calibration System
@@ -9,7 +10,7 @@ import { estimateTDFromColor } from './colorUtils';
  * Calibration process:
  * 1. User prints test patches at different layer counts (e.g., 2, 4, 6, 8, 10 layers)
  * 2. User photographs patches on backlit surface and samples RGB values
- * 3. Algorithm fits Beer-Lambert curve to derive TD for each color channel
+ * 3. Algorithm fits a linear-light Beer-Lambert curve to derive TD for each color channel
  * 4. Confidence score computed based on fit quality and measurement consistency
  */
 
@@ -25,7 +26,7 @@ export type CalibrationRgb = [number, number, number];
 export interface CalibrationMeasurement {
     layers: number; // Number of layers printed
     rgb: CalibrationRgb; // Measured RGB value (0-255)
-    transmission: CalibrationRgb; // Normalized transmission (0-1)
+    transmission: CalibrationRgb; // Normalized linear-light transmission (0-1)
 }
 
 /**
@@ -133,12 +134,27 @@ function predictWorkingBlendRgb(
 ): CalibrationRgb {
     const transmission = Math.pow(10, -thickness / td);
     return [
-        Math.round(filamentRgb[0] + (whiteReference[0] - filamentRgb[0]) * transmission),
-        Math.round(filamentRgb[1] + (whiteReference[1] - filamentRgb[1]) * transmission),
-        Math.round(filamentRgb[2] + (whiteReference[2] - filamentRgb[2]) * transmission),
+        Math.round(blendSrgbChannel(whiteReference[0], filamentRgb[0], transmission)),
+        Math.round(blendSrgbChannel(whiteReference[1], filamentRgb[1], transmission)),
+        Math.round(blendSrgbChannel(whiteReference[2], filamentRgb[2], transmission)),
     ];
 }
 
+function transmissionFromMeasuredBlend(
+    measured: number,
+    filament: number,
+    background: number
+): number | undefined {
+    const filamentLinear = srgbChannelToLinear(filament);
+    const backgroundLinear = srgbChannelToLinear(background);
+    const contrast = backgroundLinear - filamentLinear;
+
+    if (Math.abs(contrast) < 1e-6) return undefined;
+
+    const transmission = (srgbChannelToLinear(measured) - filamentLinear) / contrast;
+    return transmission > 0 && transmission < 1 ? transmission : undefined;
+}
+
 function evaluateWorkingTdFit(
     measurements: CalibrationMeasurement[],
     layerHeight: number,
@@ -300,8 +316,17 @@ export function calculateTDFromMeasurements(
     const tdChannels: [number, number, number] = [0, 0, 0];
     const confidences: [number, number, number] = [0, 0, 0];
 
+    const filamentRgb = hexToRgb(filamentColor) ?? [128, 128, 128];
+    const reference = sanitizeWhiteReference(whiteReference);
+
     for (let channel = 0; channel < 3; channel++) {
-        const { td, confidence } = fitTDForChannel(sorted, channel, layerHeight);
+        const { td, confidence } = fitTDForChannel(
+            sorted,
+            channel,
+            layerHeight,
+            filamentRgb,
+            reference
+        );
         tdChannels[channel] = td;
         confidences[channel] = confidence;
     }
@@ -327,14 +352,20 @@ export function calculateTDFromMeasurements(
 function fitTDForChannel(
     measurements: CalibrationMeasurement[],
     channel: number,
-    layerHeight: number
+    layerHeight: number,
+    filamentRgb: CalibrationRgb,
+    whiteReference: CalibrationRgb
 ): { td: number; confidence: number } {
     // Compute TD from each measurement
     const tdEstimates: Array<{ td: number; thickness: number; transmission: number }> = [];
 
     for (const measurement of measurements) {
-        const transmission = measurement.transmission[channel];
-        if (transmission <= 0 || transmission >= 1) continue; // Skip invalid measurements
+        const transmission = transmissionFromMeasuredBlend(
+            measurement.rgb[channel],
+            filamentRgb[channel],
+            whiteReference[channel]
+        );
+        if (transmission === undefined) continue; // Skip invalid or zero-contrast measurements
 
         const thickness = measurement.layers * layerHeight;
         const td = -thickness / Math.log10(transmission);
@@ -355,8 +386,9 @@ function fitTDForChannel(
     let totalWeight = 0;
 
     for (const { td, transmission } of tdEstimates) {
-        // Weight function: peaks at T=0.5, drops off at extremes
-        const weight = 1 - Math.abs(transmission - 0.5) * 2; // 0 at T=0 or T=1, 1 at T=0.5
+        // Weight function: peaks at T=0.5, but preserve a small contribution
+        // from valid measurements near either endpoint.
+        const weight = Math.max(0.05, 1 - Math.abs(transmission - 0.5) * 2);
         weightedSum += td * weight;
         totalWeight += weight;
     }
@@ -377,7 +409,7 @@ function fitTDForChannel(
 }
 
 /**
- * Convert measured RGB values to normalized transmission values.
+ * Convert measured RGB values to normalized linear-light transmission values.
  * Uses a measured white reference so camera and backlight tint are normalized out.
  */
 export function rgbToTransmission(
@@ -386,9 +418,9 @@ export function rgbToTransmission(
 ): CalibrationRgb {
     const reference = sanitizeWhiteReference(whiteReference);
     return [
-        Math.max(0, Math.min(1, rgb[0] / reference[0])),
-        Math.max(0, Math.min(1, rgb[1] / reference[1])),
-        Math.max(0, Math.min(1, rgb[2] / reference[2])),
+        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[0]) / srgbChannelToLinear(reference[0]))),
+        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[1]) / srgbChannelToLinear(reference[1]))),
+        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[2]) / srgbChannelToLinear(reference[2]))),
     ];
 }
 
@@ -418,11 +450,12 @@ export function predictTransmission(
 
     const reference = sanitizeWhiteReference(whiteReference);
 
-    // Tint the measured white-reference backlight by filament color
+    // Simulate the same linear-light blend Auto-paint uses: the filament is
+    // the foreground and the measured backlight is the background.
     return [
-        Math.round(transmission[0] * (rgb[0] / 255) * reference[0]),
-        Math.round(transmission[1] * (rgb[1] / 255) * reference[1]),
-        Math.round(transmission[2] * (rgb[2] / 255) * reference[2]),
+        Math.round(blendSrgbChannel(reference[0], rgb[0], transmission[0])),
+        Math.round(blendSrgbChannel(reference[1], rgb[1], transmission[1])),
+        Math.round(blendSrgbChannel(reference[2], rgb[2], transmission[2])),
     ];
 }
 
diff --git a/src/lib/colorSpace.ts b/src/lib/colorSpace.ts
new file mode 100644
index 0000000..65cfe32
--- /dev/null
+++ b/src/lib/colorSpace.ts
@@ -0,0 +1,42 @@
+/**
+ * sRGB transfer functions and light-space compositing helpers.
+ *
+ * RGB values shown in the UI are sRGB-encoded display values. Convert them to
+ * linear light before applying physical transmission or opacity calculations.
+ */
+
+const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value));
+
+export function srgbChannelToLinear(channel: number): number {
+    const normalized = clamp(channel, 0, 255) / 255;
+    return normalized <= 0.04045
+        ? normalized / 12.92
+        : Math.pow((normalized + 0.055) / 1.055, 2.4);
+}
+
+export function linearChannelToSrgb(channel: number): number {
+    const clamped = clamp(channel, 0, 1);
+    const normalized =
+        clamped <= 0.0031308
+            ? clamped * 12.92
+            : 1.055 * Math.pow(clamped, 1 / 2.4) - 0.055;
+    return normalized * 255;
+}
+
+/**
+ * Composite a transmissive foreground over a background. `transmission` is
+ * the fraction of background light that passes through the foreground.
+ */
+export function blendSrgbChannel(
+    background: number,
+    foreground: number,
+    transmission: number
+): number {
+    const clampedTransmission = clamp(transmission, 0, 1);
+    const backgroundLinear = srgbChannelToLinear(background);
+    const foregroundLinear = srgbChannelToLinear(foreground);
+    return linearChannelToSrgb(
+        foregroundLinear * (1 - clampedTransmission) +
+            backgroundLinear * clampedTransmission
+    );
+}
diff --git a/tests/calibration.test.ts b/tests/calibration.test.ts
new file mode 100644
index 0000000..1999f26
--- /dev/null
+++ b/tests/calibration.test.ts
@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+type CalibrationModule = typeof import('../src/lib/calibration.ts');
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+
+let calibrationModule: Promise<CalibrationModule> | null = null;
+let autoPaintModule: Promise<AutoPaintModule> | null = null;
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+async function loadCalibrationModule(): Promise<CalibrationModule> {
+    calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts');
+    return calibrationModule;
+}
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
+    return autoPaintModule;
+}
+
+function assertClose(actual: number, expected: number, tolerance: number, message?: string) {
+    assert.ok(
+        Math.abs(actual - expected) <= tolerance,
+        message ?? `expected ${actual} to be within ${tolerance} of ${expected}`
+    );
+}
+
+test('calibration predictions use Auto-paint’s linear-light transmission model', async () => {
+    const calibration = await loadCalibrationModule();
+    const autoPaint = await loadAutoPaintModule();
+    const halfTransmissionThickness = Math.log10(2);
+    const predicted = calibration.predictTransmission(
+        '#000000',
+        1,
+        halfTransmissionThickness,
+        [1, 1, 1]
+    );
+    const autoPaintBlend = autoPaint.blendColors(
+        { r: 255, g: 255, b: 255 },
+        { r: 0, g: 0, b: 0 },
+        1,
+        halfTransmissionThickness
+    );
+
+    assert.deepEqual(predicted, [188, 188, 188]);
+    assert.deepEqual(predicted, [
+        Math.round(autoPaintBlend.r),
+        Math.round(autoPaintBlend.g),
+        Math.round(autoPaintBlend.b),
+    ]);
+
+    const normalizedTransmission = calibration.rgbToTransmission(predicted);
+    for (const channel of normalizedTransmission) {
+        assertClose(channel, 0.5, 0.01, 'measurement transmission must be decoded in linear light');
+    }
+});
+
+test('calibration recovers channel TDs from linear-light patch measurements', async () => {
+    const calibration = await loadCalibrationModule();
+    const layerHeight = 0.1;
+    const filamentColor = '#204080';
+    const whiteReference: [number, number, number] = [230, 240, 255];
+    const knownTd: [number, number, number] = [1.4, 2, 3.2];
+    const measurements = [2, 4, 6, 8, 10].map((layers) => ({
+        layers,
+        rgb: calibration.predictTransmission(
+            filamentColor,
+            layers,
+            layerHeight,
+            knownTd,
+            whiteReference
+        ),
+        // The fit must derive transmission from the RGB observations, rather
+        // than trusting a cached value created with an earlier color model.
+        transmission: [0, 0, 0] as [number, number, number],
+    }));
+
+    const result = calibration.calculateTDFromMeasurements(
+        measurements,
+        layerHeight,
+        whiteReference,
+        filamentColor
+    );
+
+    for (let channel = 0; channel < knownTd.length; channel++) {
+        assertClose(result.td[channel], knownTd[channel], 0.03);
+    }
+    assert.ok(result.confidence > 0.7);
+});

From 89716a14cd22a4d7486b80ff3decbd0991176b66 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 15:13:47 +0300
Subject: [PATCH 24/81] Score auto-paint with CIEDE2000 and p95 tail term

---
 CHANGELOG.md                         |   4 +-
 src/lib/autoPaint.ts                 | 226 ++++++++----
 tests/assets/auto-paint-goldens.json | 494 +++++++++++++--------------
 tests/autoPaintQuality.test.ts       | 114 +++++++
 tests/benchmark/autoPaintBench.ts    | 138 ++++----
 5 files changed, 596 insertions(+), 380 deletions(-)
 create mode 100644 tests/autoPaintQuality.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f8a1320..a4699a6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -8,7 +8,8 @@ All notable changes to Kromacut are documented in this file.
 
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 - **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
-- **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures palette and preview-realized color error, coverage, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles.
+- **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures realized print error (CIEDE2000 mean, p95, and coverage) for both the uncompressed and the Max Height-compressed stack, plus the achievable palette floor, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles. It measures the printed result through the same canonical color-to-height mapper the optimizer scores with, instead of a separately-implemented projection.
+- **Auto-paint quality budgets** - Added realized-ΔE00 budget tests (weighted mean, p95 tail, and ΔE00≤6 coverage) for the printable, max-height-capped stack on the representative fixture profiles, guarding against optimizer-objective regressions even when intentional ordering changes update the goldens.
 - **Auto-paint optimization progress** - Enhanced matching now reports an approximate completion percentage while its background search is running.
 
 ### Changed
@@ -20,6 +21,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
 - **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
+- **Auto-paint optimizer metric** - The optimizer now scores realized print error in CIEDE2000 (ΔE2000) instead of CIE76, and adds a weighted p95 tail term so a few rare but conspicuous colors are not sacrificed to lower the average. Nearest-color and Lab-polyline projection stay in Euclidean CIE76, where they are geometrically valid and fast. Selected filament orders change for some Enhanced color-match profiles.
 
 ### Fixed
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 246ba25..e2be859 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -314,12 +314,29 @@ export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
 
 const OPTIMIZER_DISTANCE_METRIC: ColorDistanceMetric = 'cie76';
 
+/**
+ * Geometric color distance used for nearest-match and polyline projection.
+ * Deliberately a Euclidean Lab metric (CIE76): projecting a target onto the
+ * palette's Lab polyline assumes a Euclidean space, so a non-Euclidean metric
+ * (CIEDE2000) would be geometrically inconsistent here — and this runs in the
+ * hot per-segment loop, where CIE76 keeps the search fast.
+ */
 function optimizerColorDistance(left: Lab, right: Lab): number {
     return OPTIMIZER_DISTANCE_METRIC === 'ciede2000'
         ? deltaE2000Lab(left, right)
         : deltaELab(left, right);
 }
 
+/**
+ * Perceptual realized-error metric for the optimizer objective and benchmark
+ * reporting. CIEDE2000 tracks visible print error far better than CIE76, and it
+ * is only evaluated once per image target per sequence (after projection), so
+ * its higher cost stays negligible against the search.
+ */
+function realizedColorError(left: Lab, right: Lab): number {
+    return deltaE2000Lab(left, right);
+}
+
 /**
  * Calculate the opacity (how opaque) a filament layer is at a given thickness.
  *
@@ -978,60 +995,46 @@ export function buildAchievableColorPalette(
     }));
 }
 
+export interface MappedTarget {
+    target: WeightedLab;
+    /** Printable palette index whose color the preview renders for this target. */
+    paletteIndex: number;
+    /** Lab color of that printable palette entry. */
+    mappedLab: Lab;
+    /** Continuous projected height before snapping to a printable layer. */
+    projectedHeight: number;
+}
+
 /**
- * Score a filament sequence against weighted image target colors.
- *
- * The score combines:
- * 1. Preview-realized color accuracy — project each target onto the printable
- *    Lab path, then evaluate the discrete layer that the preview will render.
- *    Dominant image colors contribute more to the score, so the optimizer
- *    prioritizes filament orderings that nail the most common colors.
- * 2. Height spread — penalizes when distinct image colors collapse to
- *    the same height (leading to flat surfaces).
- * 3. Total layer count — penalizes the raw number of layers in the palette.
- *    This punishes sequences with expensive transitions between dissimilar
- *    colors (e.g., yellow→purple takes many layers to transition, vs
- *    yellow→orange which is quick). More layers = taller model.
- * 4. Transition waste — penalizes palette layers that don't closely match
- *    any target color. These are "wasted" intermediate layers that exist
- *    only as transitions and contribute no useful color to the image.
+ * Map each weighted image target onto the printable palette the way the preview
+ * does: find the closest point on the palette's Lab polyline (Euclidean
+ * projection), then snap to the printable layer at that height. Shared by the
+ * optimizer objective and the benchmark so the two cannot drift.
  */
-export function scoreSequenceAgainstImage(
+export function mapTargetsToPrintablePalette(
     palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
     imageTargets: WeightedLab[]
-): number {
-    if (palette.length === 0) return Infinity;
-
-    // Mirror enhanced auto-paint mapping: project each image color onto the
-    // palette's Lab polyline, then use the printable layer at that height.
-    const paletteEntries = palette;
-    if (paletteEntries.length === 0) return Infinity;
-
-    // 1. Weighted preview-realized DeltaE per target
-    let weightedDeltaE = 0;
-    const bestMatchHeights: number[] = [];
-
-    // Also track which printable palette entries are useful to a target.
-    const usedPaletteEntries = new Set<number>();
-
-    for (const target of imageTargets) {
-        let minDE = Infinity;
-        let bestHeight = paletteEntries[0].height;
-        let bestIdx = 0;
-        for (let ri = 0; ri < paletteEntries.length; ri++) {
-            const entry = paletteEntries[ri];
-            const de = optimizerColorDistance(entry.lab, target);
-            if (de < minDE) {
-                minDE = de;
-                bestHeight = entry.height;
-                bestIdx = ri;
+): MappedTarget[] {
+    if (palette.length === 0) return [];
+
+    return imageTargets.map((target) => {
+        let minDistance = Infinity;
+        let bestHeight = palette[0].height;
+
+        // Nearest printable color seeds the projection threshold.
+        for (let ri = 0; ri < palette.length; ri++) {
+            const de = optimizerColorDistance(palette[ri].lab, target);
+            if (de < minDistance) {
+                minDistance = de;
+                bestHeight = palette[ri].height;
                 if (de < 0.5) break;
             }
         }
 
-        for (let ri = 0; ri < paletteEntries.length - 1; ri++) {
-            const start = paletteEntries[ri];
-            const end = paletteEntries[ri + 1];
+        // Refine against the closest point on each polyline segment.
+        for (let ri = 0; ri < palette.length - 1; ri++) {
+            const start = palette[ri];
+            const end = palette[ri + 1];
             const dL = end.lab.L - start.lab.L;
             const da = end.lab.a - start.lab.a;
             const db = end.lab.b - start.lab.b;
@@ -1048,44 +1051,119 @@ export function scoreSequenceAgainstImage(
                         lengthSquared
                 )
             );
-            const projectedL = start.lab.L + t * dL;
-            const projectedA = start.lab.a + t * da;
-            const projectedB = start.lab.b + t * db;
             const projectedDistance = optimizerColorDistance(target, {
-                L: projectedL,
-                a: projectedA,
-                b: projectedB,
+                L: start.lab.L + t * dL,
+                a: start.lab.a + t * da,
+                b: start.lab.b + t * db,
             });
-            if (projectedDistance < minDE) {
-                minDE = projectedDistance;
+            if (projectedDistance < minDistance) {
+                minDistance = projectedDistance;
                 bestHeight = start.height + t * (end.height - start.height);
             }
         }
 
-        const mappedIdx = paletteEntries.findIndex((entry) => entry.height >= bestHeight);
-        bestIdx = mappedIdx >= 0 ? mappedIdx : paletteEntries.length - 1;
-        const mappedColor = paletteEntries[bestIdx].lab;
-        const mappedDeltaE = optimizerColorDistance(mappedColor, target);
+        const mappedIdx = palette.findIndex((entry) => entry.height >= bestHeight);
+        const paletteIndex = mappedIdx >= 0 ? mappedIdx : palette.length - 1;
+
+        return {
+            target,
+            paletteIndex,
+            mappedLab: palette[paletteIndex].lab,
+            projectedHeight: bestHeight,
+        };
+    });
+}
+
+/**
+ * Weighted percentile over realized-error samples: the smallest sample value
+ * whose cumulative weight reaches `quantile` of the total weight.
+ */
+export function weightedErrorPercentile(
+    samples: Array<{ value: number; weight: number }>,
+    quantile: number
+): number {
+    if (samples.length === 0) return 0;
+    const totalWeight = samples.reduce((sum, sample) => sum + sample.weight, 0);
+    if (totalWeight <= 0) return 0;
+
+    const ordered = [...samples].sort((left, right) => left.value - right.value);
+    const threshold = totalWeight * quantile;
+    let cumulative = 0;
+    for (const sample of ordered) {
+        cumulative += sample.weight;
+        if (cumulative >= threshold) return sample.value;
+    }
+    return ordered[ordered.length - 1].value;
+}
+
+/** Weight applied to the weighted-p95 realized-error tail in the objective. */
+const REALIZED_ERROR_TAIL_WEIGHT = 0.5;
+/** Percentile used for the realized-error tail term. */
+const REALIZED_ERROR_TAIL_PERCENTILE = 0.95;
+/** A printable palette entry counts as "used" if a target lands within this ΔE00. */
+const USEFUL_PALETTE_MATCH_DE = 8;
+
+/**
+ * Score a filament sequence against weighted image target colors.
+ *
+ * The score combines:
+ * 1. Preview-realized color accuracy — project each target onto the printable
+ *    Lab path, snap to the layer the preview renders, and measure the visible
+ *    error in CIEDE2000. The objective uses the weighted mean plus a weighted
+ *    p95 tail, so a few rare but conspicuous colors cannot be abandoned to
+ *    lower the average. Dominant image colors carry more weight.
+ * 2. Height spread — penalizes when distinct image colors collapse to
+ *    the same height (leading to flat surfaces).
+ * 3. Total layer count — penalizes the raw number of layers in the palette.
+ *    This punishes sequences with expensive transitions between dissimilar
+ *    colors (e.g., yellow→purple takes many layers to transition, vs
+ *    yellow→orange which is quick). More layers = taller model.
+ * 4. Transition waste — penalizes palette layers that don't closely match
+ *    any target color. These are "wasted" intermediate layers that exist
+ *    only as transitions and contribute no useful color to the image.
+ */
+export function scoreSequenceAgainstImage(
+    palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
+    imageTargets: WeightedLab[]
+): number {
+    if (palette.length === 0) return Infinity;
+    if (imageTargets.length === 0) return Infinity;
+
+    const mapped = mapTargetsToPrintablePalette(palette, imageTargets);
 
-        weightedDeltaE += mappedDeltaE * target.weight;
-        bestMatchHeights.push(bestHeight);
+    // 1. Weighted realized color error (CIEDE2000), with a p95 tail term so a
+    //    few rare conspicuous colors cannot be sacrificed to lower the mean.
+    let weightedErrorSum = 0;
+    let totalWeight = 0;
+    const errorSamples: Array<{ value: number; weight: number }> = [];
+    const bestMatchHeights: number[] = [];
+    const usedPaletteEntries = new Set<number>();
+
+    for (const entry of mapped) {
+        const realizedDeltaE = realizedColorError(entry.mappedLab, entry.target);
+        const weight = entry.target.weight;
+        weightedErrorSum += realizedDeltaE * weight;
+        totalWeight += weight;
+        errorSamples.push({ value: realizedDeltaE, weight });
+        bestMatchHeights.push(entry.projectedHeight);
         // Mark this palette entry as useful if its printable color is a decent match.
-        if (mappedDeltaE < 15) usedPaletteEntries.add(bestIdx);
+        if (realizedDeltaE < USEFUL_PALETTE_MATCH_DE) usedPaletteEntries.add(entry.paletteIndex);
     }
 
-    const totalTargetWeight = imageTargets.reduce((sum, target) => sum + target.weight, 0);
-    weightedDeltaE = totalTargetWeight > 0 ? weightedDeltaE / totalTargetWeight : Infinity;
+    if (totalWeight <= 0) return Infinity;
+
+    const weightedMean = weightedErrorSum / totalWeight;
+    const weightedTail = weightedErrorPercentile(errorSamples, REALIZED_ERROR_TAIL_PERCENTILE);
+    let score = weightedMean + REALIZED_ERROR_TAIL_WEIGHT * weightedTail;
 
     // 2. Height spread penalty: penalize when distinct image colors
-    //    collapse to the same height (leading to flat surfaces)
-    if (bestMatchHeights.length > 1 && paletteEntries.length > 1) {
-        const totalModelHeight =
-            paletteEntries[paletteEntries.length - 1].height - paletteEntries[0].height;
+    //    collapse to the same height (leading to flat surfaces).
+    if (bestMatchHeights.length > 1 && palette.length > 1) {
+        const totalModelHeight = palette[palette.length - 1].height - palette[0].height;
         if (totalModelHeight > 0) {
             const uniqueHeights = new Set(bestMatchHeights.map((h) => Math.round(h * 100)));
             const spreadRatio = uniqueHeights.size / imageTargets.length;
-            const spreadPenalty = (1 - spreadRatio);
-            weightedDeltaE += spreadPenalty;
+            score += 1 - spreadRatio;
         }
     }
 
@@ -1093,17 +1171,17 @@ export function scoreSequenceAgainstImage(
     //    A sequence with expensive transitions (dissimilar hues) produces many
     //    layers; smooth transitions (similar hues) produce few.
     //    This is deliberately small so color accuracy remains the deciding factor.
-    weightedDeltaE += palette.length * 0.005;
+    score += palette.length * 0.005;
 
     // 4. Transition waste penalty: palette entries not matched by any target.
     //    If a printable palette entry is not the best match for any image target,
     //    the transition height that produced it is wasted model space.
-    if (paletteEntries.length > 1) {
-        const wastedEntries = paletteEntries.length - usedPaletteEntries.size;
-        weightedDeltaE += wastedEntries * 0.015;
+    if (palette.length > 1) {
+        const wastedEntries = palette.length - usedPaletteEntries.size;
+        score += wastedEntries * 0.015;
     }
 
-    return weightedDeltaE;
+    return score;
 }
 
 /**
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 6be460e..75ac003 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -281,106 +281,82 @@
   },
   "GH#27 / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "plvjtmc",
       "xud8mzr",
-      "y202l1e",
-      "h8zuocq"
+      "plvjtmc",
+      "h8zuocq",
+      "y202l1e"
     ],
     "transitionZones": [
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
-      },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.16,
-        "endHeight": 0.48,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
+        "startHeight": 0,
+        "endHeight": 0.56,
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 0.56,
+        "endHeight": 0.64,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.8,
-        "endHeight": 1.04,
+        "startHeight": 0.64,
+        "endHeight": 0.88,
         "idealThickness": 0.245,
         "actualThickness": 0.24
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.04,
+    "totalHeight": 1.2,
     "compressionRatio": 1
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "plvjtmc",
       "xud8mzr",
-      "y202l1e",
       "plvjtmc",
-      "y202l1e",
       "h8zuocq",
       "y202l1e"
     ],
     "transitionZones": [
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
-      },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 0.16,
-        "endHeight": 0.48,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "y202l1e",
-        "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "startHeight": 0,
+        "endHeight": 0.56,
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.56
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.8,
-        "endHeight": 0.88,
+        "startHeight": 0.56,
+        "endHeight": 0.64,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
-      {
-        "filamentId": "y202l1e",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 1.2,
-        "endHeight": 1.44,
+        "startHeight": 0.64,
+        "endHeight": 0.88,
         "idealThickness": 0.245,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
+        "startHeight": 0.88,
+        "endHeight": 1.2,
         "idealThickness": 0.329,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.76,
+    "totalHeight": 1.2,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -465,53 +441,53 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "h8zuocq",
-      "y202l1e",
       "plvjtmc",
-      "xud8mzr"
+      "h8zuocq",
+      "xud8mzr",
+      "y202l1e"
     ],
     "transitionZones": [
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.48,
-        "idealThickness": 0.45500000000000007,
-        "actualThickness": 0.48
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.329,
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.48,
+        "idealThickness": 0.245,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.8,
-        "endHeight": 0.88,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "xud8mzr",
+        "startHeight": 0.48,
+        "endHeight": 0.72,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
-        "idealThickness": 0.259,
+        "filamentId": "y202l1e",
+        "startHeight": 0.72,
+        "endHeight": 1.04,
+        "idealThickness": 0.329,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 1.2,
+    "totalHeight": 1.04,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
       "h8zuocq",
-      "y202l1e",
       "plvjtmc",
+      "xud8mzr",
       "h8zuocq",
       "plvjtmc",
+      "h8zuocq",
       "xud8mzr",
-      "plvjtmc",
       "y202l1e"
     ],
     "transitionZones": [
@@ -522,57 +498,57 @@
         "idealThickness": 0.45500000000000007,
         "actualThickness": 0.48
       },
-      {
-        "filamentId": "y202l1e",
-        "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.8,
-        "endHeight": 0.88,
+        "startHeight": 0.48,
+        "endHeight": 0.56,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 0.56,
+        "endHeight": 0.8,
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
+      },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 0.88,
-        "endHeight": 1.12,
-        "idealThickness": 0.245,
+        "startHeight": 0.8,
+        "endHeight": 1.04,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.12,
-        "endHeight": 1.2,
+        "startHeight": 1.04,
+        "endHeight": 1.12,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 1.2,
-        "endHeight": 1.52,
-        "idealThickness": 0.259,
-        "actualThickness": 0.32
+        "filamentId": "h8zuocq",
+        "startHeight": 1.12,
+        "endHeight": 1.36,
+        "idealThickness": 0.245,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.52,
+        "filamentId": "xud8mzr",
+        "startHeight": 1.36,
         "endHeight": 1.6,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
         "startHeight": 1.6,
-        "endHeight": 1.92,
+        "endHeight": 2,
         "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 1.92,
+    "totalHeight": 2,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -724,9 +700,10 @@
       "plvjtmc",
       "azwg1yp",
       "upcjpfe",
-      "w8cncoa",
       "vsn9q6u",
-      "98z555k"
+      "98z555k",
+      "xyyxysq",
+      "w8cncoa"
     ],
     "transitionZones": [
       {
@@ -750,133 +727,140 @@
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "w8cncoa",
-        "startHeight": 0.72,
-        "endHeight": 1.2,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.48
-      },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.2,
-        "endHeight": 1.44,
+        "startHeight": 0.72,
+        "endHeight": 1.04,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "actualThickness": 0.32
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.44,
-        "endHeight": 1.68,
+        "startHeight": 1.04,
+        "endHeight": 1.28,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.28,
+        "endHeight": 1.6,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "w8cncoa",
+        "startHeight": 1.6,
+        "endHeight": 2.08,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.48
       }
     ],
-    "totalHeight": 1.68,
+    "totalHeight": 2.08,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "azwg1yp",
-      "xyyxysq",
-      "upcjpfe",
       "w8cncoa",
-      "vsn9q6u",
-      "98z555k",
-      "plvjtmc",
+      "xyyxysq",
       "azwg1yp",
       "vsn9q6u",
       "98z555k",
       "vsn9q6u",
-      "98z555k"
+      "plvjtmc",
+      "azwg1yp",
+      "xyyxysq",
+      "upcjpfe",
+      "w8cncoa",
+      "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "w8cncoa",
         "startHeight": 0,
-        "endHeight": 0.4,
-        "idealThickness": 0.364,
-        "actualThickness": 0.4
+        "endHeight": 0.88,
+        "idealThickness": 0.8190000000000001,
+        "actualThickness": 0.88
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 0.4,
-        "endHeight": 0.8,
+        "startHeight": 0.88,
+        "endHeight": 1.2,
         "idealThickness": 0.357,
-        "actualThickness": 0.4
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.8,
-        "endHeight": 1.12,
-        "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "w8cncoa",
-        "startHeight": 1.12,
-        "endHeight": 1.52,
-        "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
+        "filamentId": "azwg1yp",
+        "startHeight": 1.2,
+        "endHeight": 1.44,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.52,
-        "endHeight": 1.84,
+        "startHeight": 1.44,
+        "endHeight": 1.68,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "actualThickness": 0.24
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.84,
-        "endHeight": 2.08,
+        "startHeight": 1.68,
+        "endHeight": 1.92,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.92,
+        "endHeight": 2.24,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 2.08,
-        "endHeight": 2.16,
+        "startHeight": 2.24,
+        "endHeight": 2.32,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.16,
-        "endHeight": 2.32,
+        "startHeight": 2.32,
+        "endHeight": 2.48,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.16
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.32,
-        "endHeight": 2.64,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 2.64,
+        "filamentId": "xyyxysq",
+        "startHeight": 2.48,
         "endHeight": 2.88,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "upcjpfe",
         "startHeight": 2.88,
         "endHeight": 3.2,
-        "idealThickness": 0.26599999999999996,
+        "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "98z555k",
+        "filamentId": "w8cncoa",
         "startHeight": 3.2,
-        "endHeight": 3.44,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "endHeight": 3.6,
+        "idealThickness": 0.44099999999999995,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 3.6,
+        "endHeight": 3.92,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.44,
+    "totalHeight": 3.92,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -1025,154 +1009,170 @@
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "vsn9q6u",
+      "w8cncoa",
       "azwg1yp",
-      "upcjpfe",
+      "plvjtmc",
       "98z555k",
-      "plvjtmc"
+      "upcjpfe",
+      "vsn9q6u",
+      "xyyxysq"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "w8cncoa",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.56
+        "endHeight": 0.88,
+        "idealThickness": 0.8190000000000001,
+        "actualThickness": 0.88
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.56,
-        "endHeight": 0.72,
+        "startHeight": 0.88,
+        "endHeight": 1.04,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.16
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.72,
-        "endHeight": 1.04,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 1.04,
+        "endHeight": 1.12,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.04,
-        "endHeight": 1.36,
+        "startHeight": 1.12,
+        "endHeight": 1.44,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.36,
-        "endHeight": 1.44,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "upcjpfe",
+        "startHeight": 1.44,
+        "endHeight": 1.76,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.76,
+        "endHeight": 2,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 2,
+        "endHeight": 2.4,
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 1.44,
+    "totalHeight": 2.4,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "p9c63ms",
+      "azwg1yp",
       "vsn9q6u",
-      "plvjtmc",
-      "p9c63ms",
-      "plvjtmc",
       "upcjpfe",
+      "plvjtmc",
+      "vsn9q6u",
+      "xyyxysq",
       "98z555k",
-      "upcjpfe",
+      "plvjtmc",
       "98z555k",
       "upcjpfe",
-      "plvjtmc",
-      "p9c63ms"
+      "azwg1yp",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "p9c63ms",
+        "filamentId": "azwg1yp",
         "startHeight": 0,
-        "endHeight": 0.8,
-        "idealThickness": 0.7800000000000001,
-        "actualThickness": 0.8
+        "endHeight": 0.4,
+        "idealThickness": 0.364,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 0.8,
-        "endHeight": 1.12,
+        "startHeight": 0.4,
+        "endHeight": 0.64,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.12,
-        "endHeight": 1.2,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.2,
-        "endHeight": 1.6,
-        "idealThickness": 0.42000000000000004,
+        "filamentId": "upcjpfe",
+        "startHeight": 0.64,
+        "endHeight": 1.04,
+        "idealThickness": 0.343,
         "actualThickness": 0.4
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.6,
-        "endHeight": 1.68,
+        "startHeight": 1.04,
+        "endHeight": 1.12,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.68,
-        "endHeight": 2,
-        "idealThickness": 0.343,
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.12,
+        "endHeight": 1.36,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.36,
+        "endHeight": 1.68,
+        "idealThickness": 0.357,
         "actualThickness": 0.32
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2,
-        "endHeight": 2.32,
+        "startHeight": 1.68,
+        "endHeight": 2,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.32,
-        "endHeight": 2.64,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 2,
+        "endHeight": 2.08,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.64,
-        "endHeight": 2.88,
+        "startHeight": 2.08,
+        "endHeight": 2.32,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.88,
-        "endHeight": 3.28,
+        "startHeight": 2.32,
+        "endHeight": 2.72,
         "idealThickness": 0.343,
         "actualThickness": 0.4
       },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.72,
+        "endHeight": 2.88,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.16
+      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 3.28,
-        "endHeight": 3.36,
+        "startHeight": 2.88,
+        "endHeight": 2.96,
         "idealThickness": 0.08,
         "actualThickness": 0.08
-      },
-      {
-        "filamentId": "p9c63ms",
-        "startHeight": 3.36,
-        "endHeight": 3.76,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 3.76,
+    "totalHeight": 2.96,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaintQuality.test.ts b/tests/autoPaintQuality.test.ts
new file mode 100644
index 0000000..5467a72
--- /dev/null
+++ b/tests/autoPaintQuality.test.ts
@@ -0,0 +1,114 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+import { autoPaintGoldenScenarios } from './autoPaintGoldenFixtures.ts';
+
+type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
+type AutoPaintResult = ReturnType<AutoPaintModule['generateAutoLayers']>;
+type Sample = { value: number; weight: number };
+
+const LAYER_HEIGHT = 0.08;
+const FIRST_LAYER_HEIGHT = 0.16;
+const COMPRESSED_MAX_HEIGHT = 1.2;
+
+/**
+ * Realized-quality floors for the printable (max-height-capped) stack, measured
+ * in CIEDE2000 against the raw image colors through the shared optimizer mapper.
+ *
+ * Unlike the exact-match goldens, these are deliberately loose guards: they let
+ * orderings be re-tuned, but fail if the objective ever regresses visible print
+ * quality. Catastrophic-mismatch fixtures (e.g. B&W) are excluded because no
+ * ordering can satisfy a meaningful budget there.
+ */
+const QUALITY_BUDGETS: Record<string, { meanMax: number; p95Max: number; coverage6Min: number }> = {
+    'GH#27 / large-jpeg / enhanced=true / repeats=true': { meanMax: 11, p95Max: 22, coverage6Min: 0.35 },
+    'Current 8 Colors / logo-png / enhanced=true / repeats=true': { meanMax: 12, p95Max: 20, coverage6Min: 0.15 },
+    'Current 8 Colors / large-jpeg / enhanced=true / repeats=true': { meanMax: 15, p95Max: 23, coverage6Min: 0.08 },
+};
+
+let autoPaintModule: Promise<AutoPaintModule> | null = null;
+
+async function loadAutoPaintModule(): Promise<AutoPaintModule> {
+    autoPaintModule ??= (async () => {
+        const server = await createServer({
+            appType: 'custom',
+            cacheDir: 'dist/.vite-test-cache',
+            configFile: false,
+            logLevel: 'error',
+            optimizeDeps: { noDiscovery: true },
+            resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+            root: process.cwd(),
+            server: { hmr: false, middlewareMode: true },
+        });
+        try {
+            return (await server.ssrLoadModule('/src/lib/autoPaint.ts')) as AutoPaintModule;
+        } finally {
+            await server.close();
+        }
+    })();
+    return autoPaintModule;
+}
+
+function cumulativeHeights(sliceHeights: number[], colorOrder: number[]): number[] {
+    let total = 0;
+    return colorOrder.map((index, position) => {
+        total += position === 0 ? Math.max(sliceHeights[index], FIRST_LAYER_HEIGHT) : sliceHeights[index];
+        return total;
+    });
+}
+
+function realizedQuality(autoPaint: AutoPaintModule, result: AutoPaintResult, imageSwatches: Array<{ hex: string; count?: number }>) {
+    const slices = autoPaint.autoPaintToSliceHeights(result, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
+    const heights = cumulativeHeights(slices.colorSliceHeights, slices.colorOrder);
+    const palette = slices.virtualSwatches.map((swatch, index) => {
+        const rgb = autoPaint.hexToRgb(swatch.hex);
+        return { height: heights[index], lab: autoPaint.rgbToLab(rgb), rgb };
+    });
+    const targets = imageSwatches.map((swatch) => {
+        const lab = autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex));
+        return { L: lab.L, a: lab.a, b: lab.b, weight: swatch.count ?? 1 };
+    });
+
+    const samples: Sample[] = autoPaint
+        .mapTargetsToPrintablePalette(palette, targets)
+        .map((entry) => ({ value: autoPaint.deltaE2000Lab(entry.mappedLab, entry.target), weight: entry.target.weight }));
+
+    const totalWeight = samples.reduce((sum, sample) => sum + sample.weight, 0);
+    const mean = samples.reduce((sum, sample) => sum + sample.value * sample.weight, 0) / totalWeight;
+    const p95 = autoPaint.weightedErrorPercentile(samples, 0.95);
+    const coverage6 = samples.filter((s) => s.value <= 6).reduce((sum, s) => sum + s.weight, 0) / totalWeight;
+    return { mean, p95, coverage6 };
+}
+
+test('printable auto-paint stacks meet realized ΔE00 quality budgets', async (t) => {
+    const autoPaint = await loadAutoPaintModule();
+    const scenarios = autoPaintGoldenScenarios();
+
+    for (const [name, budget] of Object.entries(QUALITY_BUDGETS)) {
+        const scenario = scenarios.find((candidate) => candidate.name === name);
+        assert.ok(scenario, `quality-budget scenario "${name}" not found in fixtures`);
+
+        await t.test(name, () => {
+            const result = autoPaint.generateAutoLayers(
+                scenario.filaments,
+                scenario.imageSwatches,
+                LAYER_HEIGHT,
+                FIRST_LAYER_HEIGHT,
+                COMPRESSED_MAX_HEIGHT,
+                scenario.enhancedColorMatch,
+                scenario.allowRepeatedSwaps,
+                { algorithm: 'auto', seed: scenario.seed }
+            );
+            const { mean, p95, coverage6 } = realizedQuality(autoPaint, result, scenario.imageSwatches);
+
+            assert.ok(mean <= budget.meanMax, `mean ΔE00 ${mean.toFixed(2)} exceeds budget ${budget.meanMax}`);
+            assert.ok(p95 <= budget.p95Max, `p95 ΔE00 ${p95.toFixed(2)} exceeds budget ${budget.p95Max}`);
+            assert.ok(
+                coverage6 >= budget.coverage6Min,
+                `coverage@ΔE00≤6 ${(coverage6 * 100).toFixed(1)}% below floor ${(budget.coverage6Min * 100).toFixed(1)}%`
+            );
+        });
+    }
+});
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
index c5a99d7..edb6df9 100644
--- a/tests/benchmark/autoPaintBench.ts
+++ b/tests/benchmark/autoPaintBench.ts
@@ -7,6 +7,9 @@ import { autoPaintGoldenScenarios } from '../autoPaintGoldenFixtures.ts';
 type AutoPaintModule = typeof import('../../src/lib/autoPaint.ts');
 type Algorithm = 'auto' | 'exhaustive' | 'simulated-annealing' | 'genetic';
 type Lab = { L: number; a: number; b: number };
+type WeightedLab = Lab & { weight: number };
+type Sample = { value: number; weight: number };
+type AutoPaintResult = ReturnType<AutoPaintModule['generateAutoLayers']>;
 
 const LAYER_HEIGHT = 0.08;
 const FIRST_LAYER_HEIGHT = 0.16;
@@ -23,37 +26,23 @@ async function loadAutoPaintModule(): Promise<AutoPaintModule> {
     finally { await server.close(); }
 }
 
-function ciede2000(left: Lab, right: Lab) {
-    const c1 = Math.hypot(left.a, left.b);
-    const c2 = Math.hypot(right.a, right.b);
-    const averageC = (c1 + c2) / 2;
-    const g = 0.5 * (1 - Math.sqrt(averageC ** 7 / (averageC ** 7 + 25 ** 7)));
-    const a1 = (1 + g) * left.a;
-    const a2 = (1 + g) * right.a;
-    const c1p = Math.hypot(a1, left.b);
-    const c2p = Math.hypot(a2, right.b);
-    const h = (a: number, b: number) => (Math.atan2(b, a) * 180 / Math.PI + 360) % 360;
-    const h1 = h(a1, left.b), h2 = h(a2, right.b);
-    const deltaL = right.L - left.L, deltaC = c2p - c1p;
-    const deltaHAngle = c1p * c2p === 0 ? 0 : Math.abs(h2 - h1) <= 180 ? h2 - h1 : h2 <= h1 ? h2 - h1 + 360 : h2 - h1 - 360;
-    const deltaH = 2 * Math.sqrt(c1p * c2p) * Math.sin((deltaHAngle / 2) * Math.PI / 180);
-    const meanL = (left.L + right.L) / 2, meanC = (c1p + c2p) / 2;
-    const meanH = c1p * c2p === 0 ? h1 + h2 : Math.abs(h1 - h2) <= 180 ? (h1 + h2) / 2 : h1 + h2 < 360 ? (h1 + h2 + 360) / 2 : (h1 + h2 - 360) / 2;
-    const t = 1 - 0.17 * Math.cos((meanH - 30) * Math.PI / 180) + 0.24 * Math.cos(2 * meanH * Math.PI / 180) + 0.32 * Math.cos((3 * meanH + 6) * Math.PI / 180) - 0.2 * Math.cos((4 * meanH - 63) * Math.PI / 180);
-    const sl = 1 + 0.015 * (meanL - 50) ** 2 / Math.sqrt(20 + (meanL - 50) ** 2);
-    const sc = 1 + 0.045 * meanC;
-    const sh = 1 + 0.015 * meanC * t;
-    const rt = -2 * Math.sqrt(meanC ** 7 / (meanC ** 7 + 25 ** 7)) * Math.sin((60 * Math.exp(-(((meanH - 275) / 25) ** 2))) * Math.PI / 180);
-    return Math.sqrt((deltaL / sl) ** 2 + (deltaC / sc) ** 2 + (deltaH / sh) ** 2 + rt * (deltaC / sc) * (deltaH / sh));
-}
-
-function weightedSummary(samples: Array<{ value: number; weight: number }>) {
+function weightedSummary(samples: Sample[]) {
     const totalWeight = samples.reduce((sum, sample) => sum + sample.weight, 0);
-    const weightedMean = samples.reduce((sum, sample) => sum + sample.value * sample.weight, 0) / totalWeight;
+    const weightedMean = totalWeight > 0
+        ? samples.reduce((sum, sample) => sum + sample.value * sample.weight, 0) / totalWeight
+        : 0;
     const ordered = [...samples].sort((a, b) => a.value - b.value);
     let cumulative = 0;
     const p95 = ordered.find((sample) => (cumulative += sample.weight) >= totalWeight * 0.95)?.value ?? 0;
-    return { weightedMean, p95, totalWeight };
+    return { weightedMean, p95 };
+}
+
+function coverage(samples: Sample[], limit: number) {
+    const totalWeight = samples.reduce((sum, sample) => sum + sample.weight, 0);
+    if (totalWeight <= 0) return 0;
+    return samples
+        .filter((sample) => sample.value <= limit)
+        .reduce((sum, sample) => sum + sample.weight, 0) / totalWeight;
 }
 
 function cumulativeHeights(sliceHeights: number[], colorOrder: number[]) {
@@ -64,25 +53,36 @@ function cumulativeHeights(sliceHeights: number[], colorOrder: number[]) {
     });
 }
 
-function projectHeight(target: Lab, nodes: Array<{ lab: Lab; min: number; max: number }>, cumulative: number[]) {
-    let bestDistance = Infinity, height = cumulative[0] ?? 0;
-    for (const node of nodes) {
-        const distance = Math.hypot(target.L - node.lab.L, target.a - node.lab.a, target.b - node.lab.b);
-        if (distance < bestDistance) { bestDistance = distance; height = (node.min + node.max) / 2; }
-    }
-    for (let index = 0; index < nodes.length - 1; index++) {
-        const from = nodes[index], to = nodes[index + 1];
-        const dL = to.lab.L - from.lab.L, da = to.lab.a - from.lab.a, db = to.lab.b - from.lab.b;
-        const lengthSq = dL * dL + da * da + db * db;
-        if (lengthSq < 0.01) continue;
-        const t = Math.max(0, Math.min(1, ((target.L - from.lab.L) * dL + (target.a - from.lab.a) * da + (target.b - from.lab.b) * db) / lengthSq));
-        const distance = Math.hypot(target.L - (from.lab.L + t * dL), target.a - (from.lab.a + t * da), target.b - (from.lab.b + t * db));
-        if (distance < bestDistance) { bestDistance = distance; height = from.max + t * (to.min - from.max); }
-    }
-    return Math.max(cumulative[0] ?? 0, Math.min(cumulative.at(-1) ?? 0, height));
+const autoPaint = await loadAutoPaintModule();
+
+// Build the printed palette exactly as the preview renders it: the per-layer
+// virtual blend colors stacked at their cumulative print heights.
+function realizedPalette(result: AutoPaintResult) {
+    const slices = autoPaint.autoPaintToSliceHeights(result, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
+    const heights = cumulativeHeights(slices.colorSliceHeights, slices.colorOrder);
+    return slices.virtualSwatches.map((swatch, index) => {
+        const rgb = autoPaint.hexToRgb(swatch.hex);
+        return { height: heights[index], lab: autoPaint.rgbToLab(rgb), rgb };
+    });
+}
+
+// Realized error of the printed stack, measured through the SAME canonical
+// mapper the optimizer scores with (no separately-implemented projection).
+function realizedError(result: AutoPaintResult, targets: WeightedLab[]) {
+    const palette = realizedPalette(result);
+    if (palette.length === 0) return { weightedMean: 0, p95: 0, coverageAt3: 0, coverageAt6: 0 };
+    const mapped = autoPaint.mapTargetsToPrintablePalette(palette, targets);
+    const samples: Sample[] = mapped.map((entry) => ({
+        value: autoPaint.deltaE2000Lab(entry.mappedLab, entry.target),
+        weight: entry.target.weight,
+    }));
+    return {
+        ...weightedSummary(samples),
+        coverageAt3: coverage(samples, 3),
+        coverageAt6: coverage(samples, 6),
+    };
 }
 
-const autoPaint = await loadAutoPaintModule();
 const output: unknown[] = [];
 
 for (const scenario of autoPaintGoldenScenarios().filter(
@@ -92,28 +92,50 @@ for (const scenario of autoPaintGoldenScenarios().filter(
     const algorithms: Algorithm[] = profileSize <= 6
         ? ['auto', 'exhaustive', 'simulated-annealing', 'genetic']
         : ['auto', 'simulated-annealing', 'genetic'];
+    // Measure against the raw image colors (ground truth), not the optimizer's
+    // clustered targets, so the benchmark is an independent yardstick.
+    const targets: WeightedLab[] = scenario.imageSwatches.map((swatch) => {
+        const lab = autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex));
+        return { L: lab.L, a: lab.a, b: lab.b, weight: swatch.count ?? 1 };
+    });
+    // Theoretical floor: best match of each target to any palette color.
+    const paletteFloor = (result: AutoPaintResult): Sample[] => {
+        const palette = realizedPalette(result);
+        return targets.map((target) => ({
+            value: palette.length
+                ? Math.min(...palette.map((entry) => autoPaint.deltaE2000Lab(target, entry.lab)))
+                : 0,
+            weight: target.weight,
+        }));
+    };
     for (const algorithm of algorithms) {
         const seeds = algorithm === 'simulated-annealing' || algorithm === 'genetic' ? SEEDS : [SEEDS[0]];
         for (const seed of seeds) {
             const start = performance.now();
             const result = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, undefined, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
             const elapsedMs = performance.now() - start;
+            const compressed = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, COMPRESSED_MAX_HEIGHT, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
             const slices = autoPaint.autoPaintToSliceHeights(result, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
-            const palette = slices.virtualSwatches.map((swatch) => autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex)));
-            const targets = scenario.imageSwatches.map((swatch) => ({ lab: autoPaint.rgbToLab(autoPaint.hexToRgb(swatch.hex)), weight: swatch.count }));
-            const errors76 = targets.map((target) => ({ weight: target.weight, value: Math.min(...palette.map((entry) => autoPaint.deltaELab(target.lab, entry))) }));
-            const errors2000 = targets.map((target) => ({ weight: target.weight, value: Math.min(...palette.map((entry) => ciede2000(target.lab, entry))) }));
-            const coverage = (limit: number) => errors76.filter((sample) => sample.value <= limit).reduce((sum, sample) => sum + sample.weight, 0) / errors76.reduce((sum, sample) => sum + sample.weight, 0);
-            const heights = cumulativeHeights(slices.colorSliceHeights, slices.colorOrder);
-            const nodes = palette.map((lab, index) => ({ lab, min: heights[index], max: heights[index] }));
-            const realized = targets.map((target) => {
-                const height = projectHeight(target.lab, nodes, heights);
-                const slice = Math.min(heights.length - 1, heights.findIndex((value) => value >= height));
-                return { weight: target.weight, value: autoPaint.deltaELab(target.lab, palette[Math.max(0, slice)]) };
+            const compressedSlices = autoPaint.autoPaintToSliceHeights(compressed, LAYER_HEIGHT, FIRST_LAYER_HEIGHT);
+            output.push({
+                scenario: scenario.name,
+                algorithm,
+                seed,
+                paletteFloorCiede2000: weightedSummary(paletteFloor(result)),
+                realized: {
+                    uncompressed: realizedError(result, targets),
+                    compressed: realizedError(compressed, targets),
+                },
+                structure: {
+                    totalHeight: result.totalHeight,
+                    layerCount: slices.colorSliceHeights.length,
+                    sequenceLength: result.filamentOrder.length,
+                    compressedMaxHeight: COMPRESSED_MAX_HEIGHT,
+                    compressedLayerCount: compressedSlices.colorSliceHeights.length,
+                    compressionRatio: compressed.compressionRatio,
+                },
+                cost: { wallTimeMs: elapsedMs, iterations: result.optimizerMetadata?.iterations ?? 0 },
             });
-            const compressed = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, COMPRESSED_MAX_HEIGHT, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
-            const used = new Set(errors76.map((_, targetIndex) => palette.reduce((best, entry, index) => autoPaint.deltaELab(targets[targetIndex].lab, entry) < autoPaint.deltaELab(targets[targetIndex].lab, palette[best]) ? index : best, 0)));
-            output.push({ scenario: scenario.name, algorithm, seed, colorError: { cie76: weightedSummary(errors76), ciede2000: weightedSummary(errors2000), coverageAt2_3: coverage(2.3), coverageAt5: coverage(5) }, realizedError: weightedSummary(realized), structure: { totalHeight: result.totalHeight, layerCount: slices.colorSliceHeights.length, sequenceLength: result.filamentOrder.length, wastedLayerFraction: slices.colorSliceHeights.length ? (slices.colorSliceHeights.length - used.size) / slices.colorSliceHeights.length : 0, compressedMaxHeight: COMPRESSED_MAX_HEIGHT, compressionRatio: compressed.compressionRatio }, cost: { wallTimeMs: elapsedMs, iterations: result.optimizerMetadata?.iterations ?? 0 } });
         }
     }
 }

From dc997870795e2a14d6c6c9ea10da2a6bce15a823 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 16:49:34 +0300
Subject: [PATCH 25/81] Replace auto-paint optimizer menu with effort tiers

---
 CHANGELOG.md                           |   1 +
 scripts/generate-auto-paint-goldens.ts |   2 +-
 src/App.tsx                            |   3 +-
 src/components/AutoPaintTab.tsx        |  22 +-
 src/components/ThreeDControls.tsx      |   4 +-
 src/hooks/useAutoPaintWorker.ts        |   2 +-
 src/lib/autoPaint.ts                   |   4 +-
 src/lib/optimizer.ts                   | 283 ++++++++++++++++-----
 src/types/index.ts                     |   4 +-
 tests/assets/auto-paint-goldens.json   | 330 ++++++++++++-------------
 tests/autoPaintGoldens.test.ts         |   2 +-
 tests/autoPaintQuality.test.ts         |   2 +-
 tests/benchmark/autoPaintBench.ts      |   9 +-
 tests/export3mf.test.ts                |   4 +-
 tests/optimizer.test.ts                |  52 +++-
 15 files changed, 446 insertions(+), 278 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a4699a6..53c9949 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
 - **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
 - **Auto-paint optimizer metric** - The optimizer now scores realized print error in CIEDE2000 (ΔE2000) instead of CIE76, and adds a weighted p95 tail term so a few rare but conspicuous colors are not sacrificed to lower the average. Nearest-color and Lab-polyline projection stay in Euclidean CIE76, where they are geometrically valid and fast. Selected filament orders change for some Enhanced color-match profiles.
+- **Auto-paint optimizer tiers** - Replaced the algorithm menu (Auto / Exhaustive / Simulated Annealing / Genetic) with three intent-named effort tiers: **Fast** (deterministic beam search), **Balanced** (the new default — beam-seeded deterministic multi-start local search that often finds a shorter, equal-or-better stack), and **Thorough** (exact enumeration for small profiles, otherwise an exact-seeded larger hybrid). Every tier is fully reproducible from its seed, and higher tiers never score worse than lower ones. Saved profiles migrate automatically: Exhaustive and Genetic become Thorough, Auto and Simulated Annealing become Balanced. The "Genetic" option — which only ever ran annealing — has been removed.
 
 ### Fixed
 
diff --git a/scripts/generate-auto-paint-goldens.ts b/scripts/generate-auto-paint-goldens.ts
index 7b40b26..6c60be8 100644
--- a/scripts/generate-auto-paint-goldens.ts
+++ b/scripts/generate-auto-paint-goldens.ts
@@ -39,7 +39,7 @@ const goldens = Object.fromEntries(
             undefined,
             scenario.enhancedColorMatch,
             scenario.allowRepeatedSwaps,
-            { algorithm: 'auto', seed: scenario.seed },
+            { algorithm: 'balanced', seed: scenario.seed },
             'uniform',
             scenario.imageDimensions
         );
diff --git a/src/App.tsx b/src/App.tsx
index aab12b8..9d22a48 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -27,6 +27,7 @@ import { useAppHandlers, type ExportProgressStep } from './hooks/useAppHandlers'
 import { useProcessingState } from './hooks/useProcessingState';
 import { useBuildWarning } from './hooks/useBuildWarning';
 import { clampProgress } from './lib/progress';
+import { normalizeOptimizerTier } from './lib/optimizer';
 import ResizableSplitter from './components/ResizableSplitter';
 import { ControlsPanel } from './components/ControlsPanel';
 import { usePaletteManager } from './hooks/usePaletteManager';
@@ -100,7 +101,7 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
         return {
             filaments: parsed.filaments,
             paintMode,
-            optimizerAlgorithm: parsed.optimizerAlgorithm,
+            optimizerAlgorithm: normalizeOptimizerTier(parsed.optimizerAlgorithm),
             optimizerSeed: parsed.optimizerSeed,
             regionWeightingMode: parsed.regionWeightingMode,
             enhancedColorMatch: parsed.enhancedColorMatch ?? false,
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 60029a1..04c1293 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -101,8 +101,8 @@ interface AutoPaintTabProps {
     setFlatPaint: (v: boolean) => void;
 
     // Optimizer options
-    optimizerAlgorithm: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
-    setOptimizerAlgorithm: (v: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto') => void;
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
+    setOptimizerAlgorithm: (v: 'fast' | 'balanced' | 'thorough') => void;
     optimizerSeed: number | undefined;
     setOptimizerSeed: (v: number | undefined) => void;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
@@ -680,20 +680,14 @@ export default function AutoPaintTab({
                                             <SelectValue />
                                         </SelectTrigger>
                                         <SelectContent>
-                                            <SelectItem value="auto" className="text-xs">
-                                                Auto (smart selection)
+                                            <SelectItem value="fast" className="text-xs">
+                                                Fast
                                             </SelectItem>
-                                            <SelectItem value="exhaustive" className="text-xs">
-                                                Exhaustive (recommended ≤6)
+                                            <SelectItem value="balanced" className="text-xs">
+                                                Balanced (recommended)
                                             </SelectItem>
-                                            <SelectItem
-                                                value="simulated-annealing"
-                                                className="text-xs"
-                                            >
-                                                Simulated Annealing
-                                            </SelectItem>
-                                            <SelectItem value="genetic" className="text-xs">
-                                                Genetic Algorithm
+                                            <SelectItem value="thorough" className="text-xs">
+                                                Thorough (slower)
                                             </SelectItem>
                                         </SelectContent>
                                     </Select>
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 64eaf17..f81c678 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -117,8 +117,8 @@ export default function ThreeDControls({
     const [flatPaint, setFlatPaint] = useState(initialFlatPaint);
 
     // --- Optimizer Options ---
-    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto'>(
-        persisted?.optimizerAlgorithm ?? 'auto'
+    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<'fast' | 'balanced' | 'thorough'>(
+        persisted?.optimizerAlgorithm ?? 'balanced'
     );
     const [optimizerSeed, setOptimizerSeed] = useState<number | undefined>(
         persisted?.optimizerSeed
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index 2db6027..509c897 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -28,7 +28,7 @@ export interface UseAutoPaintWorkerOptions {
     autoPaintMaxHeight?: number;
     enhancedColorMatch: boolean;
     allowRepeatedSwaps: boolean;
-    optimizerAlgorithm: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
     optimizerSeed?: number;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
 }
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index e2be859..59dca1f 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -93,7 +93,7 @@ export interface AutoPaintResult {
     };
     // Optimizer metadata (for advanced optimizer only)
     optimizerMetadata?: {
-        algorithm: string; // 'exhaustive' | 'simulated-annealing' | 'genetic'
+        algorithm: string; // resolved: 'exhaustive' | 'beam' | 'simulated-annealing' | 'balanced-hybrid'
         score: number; // Quality score achieved
         iterations: number; // Iterations performed
         converged: boolean; // Whether algorithm converged
@@ -1418,7 +1418,7 @@ export function generateAutoLayers(
     // Add optimizer metadata if available
     if (optimizerResult) {
         result.optimizerMetadata = {
-            algorithm: optimizerResult.resolvedAlgorithm || optimizerOptions?.algorithm || 'auto',
+            algorithm: optimizerResult.resolvedAlgorithm || optimizerOptions?.algorithm || 'balanced',
             score: optimizerResult.score,
             iterations: optimizerResult.iterations,
             converged: optimizerResult.converged,
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 36124e3..f43bbc4 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -21,8 +21,39 @@ import {
 // Type Definitions
 // ============================================================================
 
+/** User-facing optimizer effort tiers (persisted and shown in the UI). */
+export type OptimizerTier = 'fast' | 'balanced' | 'thorough';
+
+/**
+ * Values the optimizer accepts: the user-facing tiers plus explicit concrete
+ * searches (used by tests, benchmarks, and advanced callers). The UI only ever
+ * stores a tier.
+ */
+export type OptimizerAlgorithm = OptimizerTier | 'exhaustive' | 'beam' | 'simulated-annealing';
+
+/**
+ * Map any persisted or legacy optimizer-algorithm value to a current UI tier.
+ * Earlier releases stored 'auto' | 'exhaustive' | 'simulated-annealing' | 'genetic'.
+ */
+export function normalizeOptimizerTier(value: string | undefined | null): OptimizerTier {
+    switch (value) {
+        case 'fast':
+        case 'balanced':
+        case 'thorough':
+            return value;
+        case 'exhaustive': // explicit exact search → closest tier is Thorough
+        case 'genetic': // legacy "max effort" option
+            return 'thorough';
+        case 'beam':
+            return 'fast';
+        // 'auto', 'simulated-annealing', anything unknown → the smart default
+        default:
+            return 'balanced';
+    }
+}
+
 export interface OptimizerOptions {
-    algorithm: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
+    algorithm: OptimizerAlgorithm;
     allowRepeatedSwaps?: boolean;
     seed?: number; // For deterministic results
     maxIterations?: number; // Algorithm-specific iteration limit
@@ -220,7 +251,18 @@ type ResolvedOptimizerAlgorithm =
     | 'exhaustive'
     | 'beam'
     | 'simulated-annealing'
-    | 'genetic';
+    | 'balanced-hybrid';
+
+const SA_MIN_TEMPERATURE = 0.01;
+const SA_INITIAL_TEMPERATURE = 10.0;
+const SA_DEFAULT_COOLING_RATE = 0.995;
+// The balanced/thorough multi-start refines around good seeds, so it anneals at
+// a lower temperature scaled to the CIEDE2000 objective (scores ~5–30), where
+// the legacy SA temperature of 10 would just wander away from the seed.
+const SA_HYBRID_TEMPERATURE = 2.0;
+// Thorough seeds the hybrid with the exact no-repeat optimum when the ordered
+// subset space is small enough to enumerate quickly (≈7 filaments → 13,699).
+const THOROUGH_EXACT_SUBSET_LIMIT = 20000;
 
 interface ScoredSequence {
     order: Filament[];
@@ -559,31 +601,29 @@ function buildVariableLengthNeighbor(
     return sequence;
 }
 
-function optimizeSimulatedAnnealing(
+/**
+ * Core simulated-annealing loop from a given start. Deterministic for a fixed
+ * seeded `rng`. `onStep` fires once per iteration with the running best score so
+ * callers can drive progress. Reused by the balanced multi-start search.
+ */
+function runAnneal(
+    initialOrder: Filament[],
     filaments: Filament[],
     scoreSequence: SequenceScorer,
-    options: OptimizerOptions
-): OptimizerResult {
-    if (filaments.length <= 1) {
-        return optimizeExhaustive(filaments, scoreSequence, options);
-    }
-
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
-    const rng = new SeededRandom(options.seed);
-    const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
-    const initialTemp = options.temperature ?? 10.0;
-    const coolingRate = options.coolingRate ?? 0.995;
-    const minTemp = 0.01;
-
-    let currentOrder = randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+    allowRepeatedSwaps: boolean,
+    rng: SeededRandom,
+    maxIterations: number,
+    initialTemperature: number,
+    coolingRate: number,
+    onStep?: (bestScore: number) => void
+): { best: ScoredSequence; iterations: number } {
+    let currentOrder = initialOrder;
     let currentScore = scoreSequence(currentOrder);
-    let bestOrder = [...currentOrder];
-    let bestScore = currentScore;
-    let temperature = initialTemp;
+    let best: ScoredSequence = { order: [...currentOrder], score: currentScore };
+    let temperature = initialTemperature;
     let iterations = 0;
-    reportProgress(options, 0, maxIterations, bestScore);
 
-    while (iterations < maxIterations && temperature > minTemp) {
+    while (iterations < maxIterations && temperature > SA_MIN_TEMPERATURE) {
         iterations++;
 
         const newOrder = buildVariableLengthNeighbor(
@@ -594,7 +634,7 @@ function optimizeSimulatedAnnealing(
         );
         if (sequenceEquals(newOrder, currentOrder)) {
             temperature *= coolingRate;
-            reportProgress(options, iterations, maxIterations, bestScore);
+            onStep?.(best.score);
             continue;
         }
 
@@ -608,60 +648,172 @@ function optimizeSimulatedAnnealing(
             currentOrder = newOrder;
             currentScore = newScore;
 
-            if (currentScore < bestScore) {
-                bestScore = currentScore;
-                bestOrder = [...currentOrder];
+            if (currentScore < best.score) {
+                best = { order: [...currentOrder], score: currentScore };
             }
         }
 
         temperature *= coolingRate;
-        reportProgress(options, iterations, maxIterations, bestScore);
+        onStep?.(best.score);
+    }
+
+    return { best, iterations };
+}
+
+function optimizeSimulatedAnnealing(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    if (filaments.length <= 1) {
+        return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    // Convergence check: did we stabilize?
-    const converged = temperature <= minTemp || iterations >= maxIterations;
+    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const rng = new SeededRandom(options.seed);
+    const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
+    const initialTemp = options.temperature ?? SA_INITIAL_TEMPERATURE;
+    const coolingRate = options.coolingRate ?? SA_DEFAULT_COOLING_RATE;
+
+    const initialOrder = randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+    reportProgress(options, 0, maxIterations, scoreSequence(initialOrder));
+
+    let reported = 0;
+    const { best, iterations } = runAnneal(
+        initialOrder,
+        filaments,
+        scoreSequence,
+        allowRepeatedSwaps,
+        rng,
+        maxIterations,
+        initialTemp,
+        coolingRate,
+        (bestScore) => {
+            reported++;
+            reportProgress(options, reported, maxIterations, bestScore);
+        }
+    );
 
     return {
-        order: bestOrder,
-        score: bestScore,
+        order: best.order,
+        score: best.score,
         iterations,
-        converged,
+        converged: true,
     };
 }
 
-// ============================================================================
-// Genetic compatibility route
-// ============================================================================
-
 /**
- * The persisted Genetic option currently routes to the variable-length
- * annealer. Fixed-length crossover cannot represent subset or repeat moves.
+ * Balanced / Thorough hybrid: take beam search's deterministic best as a seed,
+ * then run several deterministic annealing restarts (the first refines the beam
+ * seed, the rest explore seeded-random starts) and keep the global best.
+ *
+ * The budget is a fixed iteration count, not a wall-clock deadline, so results
+ * stay reproducible across machines (goldens, caching, A/B seeds depend on it).
  */
-function optimizeGenetic(
+function optimizeBalanced(
     filaments: Filament[],
     scoreSequence: SequenceScorer,
-    options: OptimizerOptions
+    options: OptimizerOptions,
+    thorough: boolean
 ): OptimizerResult {
-    // Genetic crossover assumes a fixed permutation. Until a variable-length
-    // crossover proves competitive, keep the persisted UI choice but route it
-    // through the variable-length annealer with a slightly larger budget.
-    return optimizeSimulatedAnnealing(filaments, scoreSequence, {
-        ...options,
-        maxIterations: options.maxIterations ?? Math.max(1500, filaments.length * 150),
-    });
+    if (filaments.length <= 1) {
+        return optimizeExhaustive(filaments, scoreSequence, options);
+    }
+
+    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const rng = new SeededRandom(options.seed);
+    const restarts = thorough ? 12 : 5;
+    const iterationsPerRestart =
+        options.maxIterations ??
+        Math.max(thorough ? 1500 : 600, filaments.length * (thorough ? 250 : 120));
+    const initialTemp = options.temperature ?? SA_HYBRID_TEMPERATURE;
+    // Cool from the initial temperature to the floor across one restart so each
+    // restart spends its whole budget refining instead of freezing early.
+    const coolingRate =
+        options.coolingRate ??
+        Math.pow(SA_MIN_TEMPERATURE / initialTemp, 1 / Math.max(1, iterationsPerRestart));
+
+    // 1. Seeds. Beam is always cheap and strong. Thorough additionally enumerates
+    //    the exact no-repeat optimum when the subset space is small enough, then
+    //    lets the hybrid explore repeats around it — so Thorough ≥ exact ≥ beam.
+    const beam = optimizeBeamSearch(filaments, scoreSequence, { ...options, onProgress: undefined });
+    let best: ScoredSequence = { order: beam.order, score: beam.score };
+    let iterations = beam.iterations;
+
+    if (thorough && orderedSubsetCount(filaments.length) <= THOROUGH_EXACT_SUBSET_LIMIT) {
+        const exact = optimizeExhaustive(filaments, scoreSequence, { ...options, onProgress: undefined });
+        iterations += exact.iterations;
+        if (isBetterCandidate({ order: exact.order, score: exact.score }, best)) {
+            best = { order: exact.order, score: exact.score };
+        }
+    }
+
+    const total = iterations + restarts * iterationsPerRestart;
+    let reported = iterations;
+    reportProgress(options, reported, total, best.score);
+
+    // 2. Multi-start annealing: restart 0 refines the best seed; the rest explore
+    //    seeded-random starts. Keep the global best across all restarts.
+    for (let restart = 0; restart < restarts; restart++) {
+        const initialOrder =
+            restart === 0
+                ? best.order
+                : randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+
+        const outcome = runAnneal(
+            initialOrder,
+            filaments,
+            scoreSequence,
+            allowRepeatedSwaps,
+            rng,
+            iterationsPerRestart,
+            initialTemp,
+            coolingRate,
+            (bestScore) => {
+                reported++;
+                reportProgress(options, reported, total, Math.min(bestScore, best.score));
+            }
+        );
+
+        iterations += outcome.iterations;
+        if (isBetterCandidate(outcome.best, best)) best = outcome.best;
+    }
+
+    reportProgress(options, total, total, best.score);
+
+    return {
+        order: best.order,
+        score: best.score,
+        iterations,
+        converged: true,
+    };
 }
 
 function resolveAlgorithm(
-    requested: OptimizerOptions['algorithm'],
+    requested: OptimizerAlgorithm,
     filamentCount: number
 ): ResolvedOptimizerAlgorithm {
-    if (requested === 'auto') {
-        if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-        if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
-        return 'simulated-annealing';
+    switch (requested) {
+        // Explicit concrete searches pass through unchanged.
+        case 'exhaustive':
+        case 'beam':
+        case 'simulated-annealing':
+            return requested;
+        // Fast: exact when cheap, else the deterministic beam baseline.
+        case 'fast':
+            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
+            if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
+            return 'simulated-annealing';
+        // Balanced (default): exact for tiny profiles, beam-seeded multi-start otherwise.
+        case 'balanced':
+            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
+            return 'balanced-hybrid';
+        // Thorough: exact for tiny profiles, otherwise an exact-seeded larger
+        // hybrid (the hybrid itself enumerates when feasible — see optimizeBalanced).
+        case 'thorough':
+            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
+            return 'balanced-hybrid';
     }
-
-    return requested;
 }
 
 // ============================================================================
@@ -682,17 +834,21 @@ export function optimizeFilamentOrder(
     options: Partial<OptimizerOptions> = {}
 ): OptimizerResult {
     const opts: OptimizerOptions = {
-        algorithm: 'auto',
+        algorithm: 'balanced',
         cachingEnabled: true,
         ...options,
     };
 
-    const algorithm = resolveAlgorithm(opts.algorithm, filaments.length);
+    const resolved = resolveAlgorithm(opts.algorithm, filaments.length);
+    const thorough = opts.algorithm === 'thorough';
 
-    const defaultSeedInput = canonicalOptimizerInput(filaments, context, algorithm, opts);
+    // Key on the requested tier, not the resolved concrete: 'balanced' and
+    // 'thorough' both resolve to 'balanced-hybrid' but run different budgets and
+    // must not share a cache entry or default seed.
+    const defaultSeedInput = canonicalOptimizerInput(filaments, context, opts.algorithm, opts);
     const seed = opts.seed ?? stableHash32(defaultSeedInput);
     opts.seed = seed;
-    const cacheKey = canonicalOptimizerInput(filaments, context, algorithm, opts, seed);
+    const cacheKey = canonicalOptimizerInput(filaments, context, opts.algorithm, opts, seed);
 
     if (opts.cachingEnabled) {
         const cached = globalCache.get(cacheKey);
@@ -705,7 +861,7 @@ export function optimizeFilamentOrder(
     let result: OptimizerResult;
     const scoreSequence = createSequenceScorer(context);
 
-    switch (algorithm) {
+    switch (resolved) {
         case 'exhaustive':
             result = optimizeExhaustive(filaments, scoreSequence, opts);
             break;
@@ -715,16 +871,13 @@ export function optimizeFilamentOrder(
         case 'simulated-annealing':
             result = optimizeSimulatedAnnealing(filaments, scoreSequence, opts);
             break;
-        case 'genetic':
-            result = optimizeGenetic(filaments, scoreSequence, opts);
+        case 'balanced-hybrid':
+            result = optimizeBalanced(filaments, scoreSequence, opts, thorough);
             break;
-        default:
-            throw new Error(`Unknown algorithm: ${algorithm}`);
     }
 
     // Tag the result with the resolved algorithm
-    result.resolvedAlgorithm =
-        algorithm === 'genetic' ? 'variable-length-sa' : algorithm;
+    result.resolvedAlgorithm = resolved;
     reportProgress(opts, result.iterations, result.iterations, result.score);
 
     if (opts.cachingEnabled) {
diff --git a/src/types/index.ts b/src/types/index.ts
index aea169d..4ceb954 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -48,8 +48,8 @@ export interface ThreeDControlsStateShape {
     ditherLineWidth?: number;
     /** Flat Paint: build a flat, face-down slab (auto-paint only) */
     flatPaint?: boolean;
-    // Optimizer options
-    optimizerAlgorithm?: 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
+    // Optimizer options (effort tier; legacy values migrate on load)
+    optimizerAlgorithm?: 'fast' | 'balanced' | 'thorough';
     optimizerSeed?: number;
     regionWeightingMode?: 'uniform' | 'center' | 'edge';
     // Auto-paint computed state (only used when paintMode is 'autopaint')
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 75ac003..87b554f 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -697,170 +697,170 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
+      "98z555k",
+      "vsn9q6u",
       "plvjtmc",
       "azwg1yp",
-      "upcjpfe",
-      "vsn9q6u",
-      "98z555k",
       "xyyxysq",
+      "upcjpfe",
       "w8cncoa"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.56,
+        "idealThickness": 0.507,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "azwg1yp",
-        "startHeight": 0.16,
-        "endHeight": 0.4,
-        "idealThickness": 0.19599999999999998,
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.56,
+        "endHeight": 0.8,
+        "idealThickness": 0.26599999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.4,
-        "endHeight": 0.72,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.72,
-        "endHeight": 1.04,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 0.8,
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 1.04,
-        "endHeight": 1.28,
-        "idealThickness": 0.27299999999999996,
+        "filamentId": "azwg1yp",
+        "startHeight": 0.88,
+        "endHeight": 1.12,
+        "idealThickness": 0.19599999999999998,
         "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.28,
-        "endHeight": 1.6,
+        "startHeight": 1.12,
+        "endHeight": 1.44,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
+      {
+        "filamentId": "upcjpfe",
+        "startHeight": 1.44,
+        "endHeight": 1.76,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
+      },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.6,
-        "endHeight": 2.08,
+        "startHeight": 1.76,
+        "endHeight": 2.24,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
       }
     ],
-    "totalHeight": 2.08,
+    "totalHeight": 2.24,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "w8cncoa",
-      "xyyxysq",
-      "azwg1yp",
-      "vsn9q6u",
-      "98z555k",
       "vsn9q6u",
       "plvjtmc",
       "azwg1yp",
+      "upcjpfe",
+      "vsn9q6u",
+      "azwg1yp",
       "xyyxysq",
       "upcjpfe",
       "w8cncoa",
+      "vsn9q6u",
+      "98z555k",
       "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "w8cncoa",
+        "filamentId": "vsn9q6u",
         "startHeight": 0,
-        "endHeight": 0.88,
-        "idealThickness": 0.8190000000000001,
-        "actualThickness": 0.88
+        "endHeight": 0.56,
+        "idealThickness": 0.49400000000000005,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 0.56,
+        "endHeight": 0.64,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.2,
-        "endHeight": 1.44,
+        "startHeight": 0.64,
+        "endHeight": 0.8,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.24
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.44,
-        "endHeight": 1.68,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 1.68,
-        "endHeight": 1.92,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "filamentId": "upcjpfe",
+        "startHeight": 0.8,
+        "endHeight": 1.12,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.92,
-        "endHeight": 2.24,
+        "startHeight": 1.12,
+        "endHeight": 1.44,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.24,
-        "endHeight": 2.32,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.32,
-        "endHeight": 2.48,
+        "startHeight": 1.44,
+        "endHeight": 1.6,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.16
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 2.48,
-        "endHeight": 2.88,
+        "startHeight": 1.6,
+        "endHeight": 2,
         "idealThickness": 0.357,
         "actualThickness": 0.4
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.88,
-        "endHeight": 3.2,
+        "startHeight": 2,
+        "endHeight": 2.32,
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 3.2,
-        "endHeight": 3.6,
+        "startHeight": 2.32,
+        "endHeight": 2.72,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 3.6,
-        "endHeight": 3.92,
+        "startHeight": 2.72,
+        "endHeight": 3.04,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 3.04,
+        "endHeight": 3.28,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 3.28,
+        "endHeight": 3.6,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.92,
+    "totalHeight": 3.6,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -1010,12 +1010,12 @@
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
       "w8cncoa",
-      "azwg1yp",
+      "p9c63ms",
+      "xyyxysq",
+      "vsn9q6u",
       "plvjtmc",
       "98z555k",
-      "upcjpfe",
-      "vsn9q6u",
-      "xyyxysq"
+      "upcjpfe"
     ],
     "transitionZones": [
       {
@@ -1026,153 +1026,145 @@
         "actualThickness": 0.88
       },
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "p9c63ms",
         "startHeight": 0.88,
-        "endHeight": 1.04,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "endHeight": 1.28,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 1.28,
+        "endHeight": 1.6,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.6,
+        "endHeight": 1.92,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
+        "startHeight": 1.92,
+        "endHeight": 2,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
+        "startHeight": 2,
+        "endHeight": 2.24,
         "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.32
+        "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
+        "startHeight": 2.24,
+        "endHeight": 2.56,
         "idealThickness": 0.343,
         "actualThickness": 0.32
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.76,
-        "endHeight": 2,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
-      },
-      {
-        "filamentId": "xyyxysq",
-        "startHeight": 2,
-        "endHeight": 2.4,
-        "idealThickness": 0.357,
-        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 2.4,
+    "totalHeight": 2.56,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "azwg1yp",
       "vsn9q6u",
-      "upcjpfe",
       "plvjtmc",
-      "vsn9q6u",
-      "xyyxysq",
+      "upcjpfe",
       "98z555k",
-      "plvjtmc",
+      "upcjpfe",
+      "p9c63ms",
       "98z555k",
       "upcjpfe",
-      "azwg1yp",
-      "plvjtmc"
+      "plvjtmc",
+      "vsn9q6u",
+      "xyyxysq"
     ],
     "transitionZones": [
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "vsn9q6u",
         "startHeight": 0,
-        "endHeight": 0.4,
-        "idealThickness": 0.364,
-        "actualThickness": 0.4
+        "endHeight": 0.56,
+        "idealThickness": 0.49400000000000005,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.4,
+        "filamentId": "plvjtmc",
+        "startHeight": 0.56,
         "endHeight": 0.64,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "upcjpfe",
         "startHeight": 0.64,
-        "endHeight": 1.04,
+        "endHeight": 0.96,
         "idealThickness": 0.343,
-        "actualThickness": 0.4
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
-        "idealThickness": 0.26599999999999996,
+        "filamentId": "98z555k",
+        "startHeight": 0.96,
+        "endHeight": 1.2,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.36,
-        "endHeight": 1.68,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "filamentId": "upcjpfe",
+        "startHeight": 1.2,
+        "endHeight": 1.6,
+        "idealThickness": 0.343,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 1.68,
+        "filamentId": "p9c63ms",
+        "startHeight": 1.6,
         "endHeight": 2,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 2,
-        "endHeight": 2.08,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "98z555k",
-        "startHeight": 2.08,
-        "endHeight": 2.32,
+        "startHeight": 2,
+        "endHeight": 2.24,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.32,
-        "endHeight": 2.72,
+        "startHeight": 2.24,
+        "endHeight": 2.64,
         "idealThickness": 0.343,
         "actualThickness": 0.4
       },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 2.72,
-        "endHeight": 2.88,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
-      },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 2.88,
-        "endHeight": 2.96,
+        "startHeight": 2.64,
+        "endHeight": 2.72,
         "idealThickness": 0.08,
         "actualThickness": 0.08
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.72,
+        "endHeight": 2.96,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 2.96,
+        "endHeight": 3.28,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.96,
+    "totalHeight": 3.28,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaintGoldens.test.ts b/tests/autoPaintGoldens.test.ts
index 3d515b5..c14e255 100644
--- a/tests/autoPaintGoldens.test.ts
+++ b/tests/autoPaintGoldens.test.ts
@@ -107,7 +107,7 @@ test('seeded auto-paint stack goldens stay deliberate', async (t: TestContext) =
                 undefined,
                 scenario.enhancedColorMatch,
                 scenario.allowRepeatedSwaps,
-                { algorithm: 'auto', seed: scenario.seed }
+                { algorithm: 'balanced', seed: scenario.seed }
             );
 
             assertApproximateGolden(snapshot(result), expected[scenario.name]);
diff --git a/tests/autoPaintQuality.test.ts b/tests/autoPaintQuality.test.ts
index 5467a72..6eb68ec 100644
--- a/tests/autoPaintQuality.test.ts
+++ b/tests/autoPaintQuality.test.ts
@@ -99,7 +99,7 @@ test('printable auto-paint stacks meet realized ΔE00 quality budgets', async (t
                 COMPRESSED_MAX_HEIGHT,
                 scenario.enhancedColorMatch,
                 scenario.allowRepeatedSwaps,
-                { algorithm: 'auto', seed: scenario.seed }
+                { algorithm: 'balanced', seed: scenario.seed }
             );
             const { mean, p95, coverage6 } = realizedQuality(autoPaint, result, scenario.imageSwatches);
 
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
index edb6df9..3adbb15 100644
--- a/tests/benchmark/autoPaintBench.ts
+++ b/tests/benchmark/autoPaintBench.ts
@@ -5,7 +5,7 @@ import { createServer } from 'vite';
 import { autoPaintGoldenScenarios } from '../autoPaintGoldenFixtures.ts';
 
 type AutoPaintModule = typeof import('../../src/lib/autoPaint.ts');
-type Algorithm = 'auto' | 'exhaustive' | 'simulated-annealing' | 'genetic';
+type Algorithm = 'fast' | 'balanced' | 'thorough';
 type Lab = { L: number; a: number; b: number };
 type WeightedLab = Lab & { weight: number };
 type Sample = { value: number; weight: number };
@@ -88,10 +88,7 @@ const output: unknown[] = [];
 for (const scenario of autoPaintGoldenScenarios().filter(
     (scenario) => scenario.enhancedColorMatch && scenario.allowRepeatedSwaps
 )) {
-    const profileSize = scenario.filaments.length;
-    const algorithms: Algorithm[] = profileSize <= 6
-        ? ['auto', 'exhaustive', 'simulated-annealing', 'genetic']
-        : ['auto', 'simulated-annealing', 'genetic'];
+    const algorithms: Algorithm[] = ['fast', 'balanced', 'thorough'];
     // Measure against the raw image colors (ground truth), not the optimizer's
     // clustered targets, so the benchmark is an independent yardstick.
     const targets: WeightedLab[] = scenario.imageSwatches.map((swatch) => {
@@ -109,7 +106,7 @@ for (const scenario of autoPaintGoldenScenarios().filter(
         }));
     };
     for (const algorithm of algorithms) {
-        const seeds = algorithm === 'simulated-annealing' || algorithm === 'genetic' ? SEEDS : [SEEDS[0]];
+        const seeds = algorithm === 'balanced' ? SEEDS : [SEEDS[0]];
         for (const seed of seeds) {
             const start = performance.now();
             const result = autoPaint.generateAutoLayers(scenario.filaments, scenario.imageSwatches, LAYER_HEIGHT, FIRST_LAYER_HEIGHT, undefined, scenario.enhancedColorMatch, scenario.allowRepeatedSwaps, { algorithm, seed });
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index e737fa0..df2c1c6 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -22,7 +22,7 @@ import { inspectMeshIntegrity, type MeshIntegrityReport } from './meshDiagnostic
 type Export3mfModule = typeof import('../src/lib/export3mf.ts');
 type Export3MFOptions = Parameters<Export3mfModule['exportObjectTo3MFBlob']>[1];
 type MeshGenerator = typeof generateSmoothMesh;
-type OptimizerAlgorithm = 'exhaustive' | 'simulated-annealing' | 'genetic' | 'auto';
+type OptimizerAlgorithm = 'fast' | 'balanced' | 'thorough';
 
 interface AutoPaintSliceData {
     colorSliceHeights: number[];
@@ -785,7 +785,7 @@ async function buildAutoPaintLogoRegressionStack(
         true,
         true,
         {
-            algorithm: 'auto',
+            algorithm: 'balanced',
             seed,
         }
     );
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 132f039..4696c94 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -49,7 +49,7 @@ async function loadViteModule<T>(modulePath: string): Promise<T> {
 
 test('each optimizer produces the same result for the same seed', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -71,7 +71,7 @@ test('each optimizer produces the same result for the same seed', async (t) => {
 
 test('optimizer progress is monotonic and completes for every algorithm', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -175,9 +175,8 @@ test('default optimizer seeds are stable and cacheable', async () => {
     clearOptimizerCache();
 
     const options = {
-        algorithm: 'genetic' as const,
+        algorithm: 'simulated-annealing' as const,
         maxIterations: 20,
-        populationSize: 16,
         cachingEnabled: true,
     };
     const first = optimizeFilamentOrder(filaments, context, options);
@@ -282,7 +281,7 @@ test('repeats can close the RGB color path to reach the missing magenta blend',
 
 test('variable-length optimizers preserve sequence safety invariants', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'genetic', 'auto'] as const;
+    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
 
     for (const allowRepeatedSwaps of [false, true]) {
         for (const algorithm of algorithms) {
@@ -307,7 +306,7 @@ test('variable-length optimizers preserve sequence safety invariants', async (t)
     }
 });
 
-test('auto uses beam search for medium profiles while explicit exhaustive remains exact', async () => {
+test('fast uses beam search for medium profiles while explicit exhaustive remains exact', async () => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
@@ -316,8 +315,8 @@ test('auto uses beam search for medium profiles while explicit exhaustive remain
         { id: 'purple', color: '#7545a8', td: 1.9 },
     ];
 
-    const auto = optimizeFilamentOrder(mediumProfile, context, {
-        algorithm: 'auto',
+    const fast = optimizeFilamentOrder(mediumProfile, context, {
+        algorithm: 'fast',
         seed: 7,
         cachingEnabled: false,
     });
@@ -327,13 +326,44 @@ test('auto uses beam search for medium profiles while explicit exhaustive remain
         cachingEnabled: false,
     });
 
-    assert.equal(auto.resolvedAlgorithm, 'beam');
+    assert.equal(fast.resolvedAlgorithm, 'beam');
     assert.equal(exhaustive.resolvedAlgorithm, 'exhaustive');
     assert.equal(
         exhaustive.iterations,
         13_699,
         'seven filaments have 13,699 ordered non-empty subsets'
     );
-    assert.ok(auto.order.length <= mediumProfile.length);
-    assert.equal(new Set(auto.order.map((filament) => filament.id)).size, auto.order.length);
+    assert.ok(fast.order.length <= mediumProfile.length);
+    assert.equal(new Set(fast.order.map((filament) => filament.id)).size, fast.order.length);
+});
+
+test('balanced hybrid is deterministic, valid, and never worse than fast on a medium profile', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+    const mediumProfile = [
+        ...filaments,
+        { id: 'green', color: '#42a85f', td: 1.6 },
+        { id: 'yellow', color: '#e7cd38', td: 1.7 },
+        { id: 'purple', color: '#7545a8', td: 1.9 },
+    ];
+
+    const options = { algorithm: 'balanced' as const, seed: 7, cachingEnabled: false };
+    const first = optimizeFilamentOrder(mediumProfile, context, options);
+    const second = optimizeFilamentOrder(mediumProfile, context, options);
+    const fast = optimizeFilamentOrder(mediumProfile, context, {
+        algorithm: 'fast',
+        seed: 7,
+        cachingEnabled: false,
+    });
+
+    assert.equal(first.resolvedAlgorithm, 'balanced-hybrid');
+    assert.deepEqual(second, first, 'same seed must reproduce the same hybrid result');
+
+    const ids = first.order.map((filament) => filament.id);
+    assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]), 'no adjacent duplicates');
+    assert.equal(new Set(ids).size, ids.length, 'no repeats without allowRepeatedSwaps');
+
+    assert.ok(
+        first.score <= fast.score + 1e-9,
+        `balanced (${first.score}) must not be worse than fast (${fast.score})`
+    );
 });

From fff98e73f4ded69d6f9669219cdbcf4ab516d957 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 21:37:33 +0300
Subject: [PATCH 26/81] @ Add auto-paint detail controls and optimizer tiers

Replace the repeated-swaps toggle with an Off/2/4/6/8/12 selector and add
a transition-detail selector (80/90/95% opacity) so stack height vs color
resolution is an explicit trade-off. Expand the optimizer menu to five
effort tiers (Fast/Balanced/Thorough/Deep/Exact base order) and score
sequences against the already-processed palette with an added detail-
coverage term.

Polish the panel UI: a determinate progress bar, fixed-width label column
so controls align, a quality/speed meter under the algorithm picker, and
nesting the enhanced-matching sub-options under their gate toggle.
@
---
 CHANGELOG.md                         |   4 +-
 README.md                            |  37 ++-
 src/App.tsx                          |  39 ++-
 src/components/AutoPaintTab.tsx      | 400 ++++++++++++++++------
 src/components/ThreeDControls.tsx    |  42 ++-
 src/docs/3d-mode.md                  |  26 +-
 src/hooks/useAutoPaintWorker.ts      |  22 +-
 src/lib/autoPaint.ts                 |  91 ++++-
 src/lib/optimizer.ts                 | 296 ++++++++++++-----
 src/types/index.ts                   |  13 +-
 src/workers/autoPaint.worker.ts      |   6 +-
 tests/assets/auto-paint-goldens.json | 480 +++++++++++++++------------
 tests/autoPaint.test.ts              |  45 ++-
 tests/benchmark/autoPaintBench.ts    |   4 +-
 tests/optimizer.test.ts              | 139 +++++++-
 15 files changed, 1152 insertions(+), 492 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53c9949..ced4cb3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,13 +16,13 @@ All notable changes to Kromacut are documented in this file.
 
 - **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
-- **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
+- **Auto-paint detail controls** - Enhanced matching now scores every color from the already-processed 2D palette instead of applying a hidden second color reduction. Repeated swaps are now a selector with Off, 2, 4, 6, 8, and 12 extra occurrences; transition detail similarly exposes 80%, 90%, and 95% Beer-Lambert opacity endpoints so quality, stack height, and runtime are an intentional trade-off. Existing repeated-swap settings migrate to four extra occurrences.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
 - **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
 - **Auto-paint optimizer metric** - The optimizer now scores realized print error in CIEDE2000 (ΔE2000) instead of CIE76, and adds a weighted p95 tail term so a few rare but conspicuous colors are not sacrificed to lower the average. Nearest-color and Lab-polyline projection stay in Euclidean CIE76, where they are geometrically valid and fast. Selected filament orders change for some Enhanced color-match profiles.
-- **Auto-paint optimizer tiers** - Replaced the algorithm menu (Auto / Exhaustive / Simulated Annealing / Genetic) with three intent-named effort tiers: **Fast** (deterministic beam search), **Balanced** (the new default — beam-seeded deterministic multi-start local search that often finds a shorter, equal-or-better stack), and **Thorough** (exact enumeration for small profiles, otherwise an exact-seeded larger hybrid). Every tier is fully reproducible from its seed, and higher tiers never score worse than lower ones. Saved profiles migrate automatically: Exhaustive and Genetic become Thorough, Auto and Simulated Annealing become Balanced. The "Genetic" option — which only ever ran annealing — has been removed.
+- **Auto-paint optimizer tiers** - Enhanced matching now offers five reproducible effort tiers: **Fast** (narrow beam preview), **Balanced** (the full-beam default), **Thorough** (deeper hybrid refinement), **Deep** (a wider, much larger hybrid search), and **Exact base order** (all no-repeat orders). Each higher tier preserves the best result from the preceding tier for the same seed. Exact remains available for every profile and reports its candidate count; with repeated swaps it remains exact for the base order while refining repeats separately. Saved values migrate automatically: legacy Exhaustive becomes Exact, Genetic becomes Deep, and Auto or Simulated Annealing becomes Balanced.
 
 ### Fixed
 
diff --git a/README.md b/README.md
index b221319..dacf53d 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ Open-source HueForge-style tool for converting images into stacked, color-layere
 
 Kromacut is a browser-first app that converts images into multi-color lithophane 3D prints. It offers two powerful workflows:
 
-**Auto-paint mode** — Define your actual filaments (color + Transmission Distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, advanced optimizer (simulated annealing/genetic algorithms), and region weighting for spatial priority.
+**Auto-paint mode** — Define your actual filaments (color + Transmission Distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, five deterministic optimizer effort tiers, and region weighting for spatial priority.
 
 **Manual mode** — Reduce images to a small palette, manually tweak per-color layer heights and ordering, and fine-tune every aspect of the stack with complete control.
 
@@ -45,7 +45,7 @@ Another minimal test you can try yourself in the app header: the Transmission Di
 - Plain-text 3D print instructions that describe layer heights and exact layers where filament swaps are required.
 - Copy-to-clipboard button for the print instructions (produces a clean, copyable plain-text plan).
 - **Filament calibration wizard** — Accurately determine Transmission Distance (TD) values through measured samples with confidence scoring.
-- **Advanced optimizer** — Simulated annealing and genetic algorithms find optimal filament ordering for complex multi-color prints.
+- **Advanced optimizer** — Five deterministic effort tiers search for optimal filament ordering, from quick previews to exact base-order enumeration.
 - **Region weighting** — Prioritize accuracy in specific image areas (center, edges) during auto-paint optimization.
 
 ## Notable implementation details
@@ -66,7 +66,7 @@ Another minimal test you can try yourself in the app header: the Transmission Di
 3. Click **Add Filament** and configure your filaments:
    - Use the **calibration wizard** (calibrate icon) to measure accurate TD values, or
    - Enter TD values manually.
-4. Enable **Enhanced color matching** for optimal results (auto-selects best algorithm).
+4. Enable **Enhanced color matching** for optimal results; start with the **Balanced** optimizer tier.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize important areas.
 6. Use the **layer-by-layer preview slider** to verify transitions.
 7. Export via **Download STL** or **Download 3MF** and follow the print plan.
@@ -113,7 +113,7 @@ Auto-paint is an automated layer-generation mode that replaces the manual palett
 
 - **Filaments**: Each filament has a hex color and a **Transmission Distance (TD)** value (in mm). TD describes how translucent the filament is — at a thickness equal to TD, only ~10% of light passes through. Dark/opaque filaments have low TD (e.g. 0.5 mm); light/translucent filaments have high TD (e.g. 6+ mm). When you add a filament without specifying a TD, Kromacut estimates one from the color's luminance and saturation.
 - **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / TD)`. It blends in linear-light sRGB before converting back for display and color matching, which better models the color you see from thin semi-transparent layers.
-- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or opacity exceeds 85%. The result is a set of transition zones, each with a start height, end height, and the filament used.
+- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or reaches the selected opacity endpoint. **Compact** uses 80% opacity, **Detailed** uses 90% (one TD), and **Maximum** uses 95% (the same endpoint as the foundation layer). Higher endpoints retain more printable intermediate colors but create taller stacks.
 - **Luminance-to-height mapping**: Once the transition zones are computed, each pixel's brightness is mapped to a target height in the model. Dark pixels get the minimum height (base layer only), bright pixels get the full height (all layers), and mid-tones fall proportionally in between. This produces the characteristic lithophane-style relief where image brightness = model thickness.
 
 ### How it works (step by step)
@@ -138,14 +138,20 @@ Calibrated filaments display a confidence badge next to their TD value. Higher c
 
 ### Advanced Optimizer
 
-When **Enhanced color matching** is enabled, Kromacut uses advanced optimization algorithms to find the best filament order:
+When **Enhanced color matching** is enabled, choose an effort tier for the filament-order search:
 
-| Algorithm | When Used | Description |
+| Tier | Search | Best use |
 |---|---|---|
-| **Exhaustive search** | Up to 6 filaments | Evaluates every ordered, non-empty subset to guarantee the best available stack. |
-| **Beam search** | Auto, 7-12 filaments | Keeps the strongest partial stacks as it grows them, letting Auto omit unhelpful filaments without an expensive full enumeration. |
-| **Variable-length annealing** | Auto, 13+ filaments; manual Simulated Annealing or Genetic | Searches swaps, moves, insertions, removals, and replacements. The Genetic setting currently uses this search with a larger budget. |
-| **Auto** | Default | Chooses exhaustive search, beam search, or variable-length annealing from the filament count. |
+| **Fast** | Narrow deterministic beam search. | A quick preview while tuning settings. |
+| **Balanced** | Full deterministic beam search. | Recommended default for most prints. |
+| **Thorough** | Full beam plus deeper multi-start refinement. | A stronger search without a long wait. |
+| **Deep** | Wider beam plus substantially more deterministic refinement. | Difficult images when Thorough does not improve the stack. |
+| **Exact base order** | Enumerates every no-repeat base order. | A guaranteed best base order; the candidate count grows very quickly with each filament. |
+
+Each higher tier retains the best result from the tier below for the same seed. Exact
+base order checks 109,600 sequences at eight filaments and 986,409 at nine, so use it
+deliberately on larger profiles. With extra repeated swaps enabled, its base order is exact
+but repeated occurrences are still refined heuristically.
 
 The optimizer displays metadata after generation:
 - **Algorithm used** — Which method was selected
@@ -174,14 +180,17 @@ Region weighting is most useful when filament budget is limited and you want the
 |---|---|
 | **Max Height** | Constrains the total model height (mm). When set below the auto-calculated ideal, zones are uniformly compressed. Leave blank or click `Auto` for the physics-derived default. |
 | **Enhanced color matching** | Optimizes the printable filament sequence rather than simply sorting by luminance. It may omit filaments that do not improve the result and evaluates the actual preview color-to-height path. |
-| **Allow repeated filament swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once, up to four extra occurrences, when that creates a useful color transition. For example, a thin white layer over red can create pink. |
+| **Extra repeated swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once. Choose Off, 2, 4, 6, 8, or 12 additional occurrences; more repeats may create useful blend paths but substantially expand the search. |
 | **Height dithering** | (Requires Enhanced color matching) Applies block-aware Floyd-Steinberg error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
-| **Optimizer algorithm** | Choose Auto (recommended), Exhaustive (up to 6 filaments), Simulated Annealing, or Genetic. Auto uses exhaustive search through 6 filaments, beam search through 12, then variable-length annealing. |
+| **Optimizer algorithm** | Choose Fast for a preview, Balanced for the recommended full beam, Thorough or Deep for more search effort, or Exact base order when you want every no-repeat base stack checked. |
+| **Transition detail** | Chooses where a color transition stops: Compact at 80% opacity, Detailed at 90%, or Maximum at 95%. Higher detail preserves a longer physical color ramp, increasing model height, swaps, and runtime. |
 | **Optimizer seed** | Leave blank for an automatic stable seed, or enter a number for a specific repeatable run. |
 | **Region weighting** | Prioritize specific image regions: Uniform (equal), Center (image middle), or Edge (outer image border). Helps focus quality budget on important areas. |
 
+Enhanced matching uses every color in the palette currently produced by 2D mode; it does not silently reduce that palette again. For detail-critical work, first prepare the image in 2D with K-means (for example, weight 128) and the Auto palette set to the number of colors you want to preserve. More 2D colors improve the target representation but make the optimizer proportionally slower.
+
 ### Filament profiles
 
 Auto-paint configurations (filament lists) can be saved, loaded, and shared as **profiles**:
@@ -228,7 +237,7 @@ Click **Add to filaments** to insert the suggestion directly into the filament l
 2. Switch to the **Auto-paint** tab (inside the 3D controls panel).
 3. Click **Add Filament** and configure each filament's color and TD to match your real filament stock.
    - **Tip:** Use the calibration wizard (calibrate icon on each row) to measure accurate TD values.
-4. (Optional) Enable **Enhanced color matching** for better results with complex images. The optimizer will automatically select the best algorithm (exhaustive, simulated annealing, or genetic) based on your filament count.
+4. (Optional) Enable **Enhanced color matching** for better results with complex images. Start with the **Balanced** optimizer tier, then use Thorough, Deep, or Exact base order when you want to spend more search effort.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize accuracy in visually important areas.
 6. The 3D preview updates automatically. Adjust **Max Height** if the model is too tall.
 7. Use the **layer-by-layer preview slider** at the bottom of the 3D view to verify color transitions.
@@ -253,7 +262,7 @@ Transmission Distance (TD) is the concept HueForge uses to produce perceptual in
 - **Automatic Beer-Lambert blending** — Kromacut simulates light transmission through stacked filament layers using physically accurate optical models.
 - **Filament-based workflow** — Define your actual filaments (color + TD values) and let the algorithm compute optimal layer stacks automatically.
 - **Calibration wizard** — Measure accurate TD values from physical test prints for each filament.
-- **Advanced optimizer** — Simulated annealing and genetic algorithms find the best filament ordering for complex images.
+- **Advanced optimizer** — Deterministic effort tiers search for the best filament ordering for complex images, from quick beam previews to exact base-order enumeration.
 - **Transition zones** — Automatically calculated vertical zones where each filament blends from the color below to its own pure color.
 
 See the [Auto-paint section](#auto-paint) above for full details.
diff --git a/src/App.tsx b/src/App.tsx
index 9d22a48..00641b7 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -1,6 +1,12 @@
 import React, { useEffect, useRef, useState } from 'react';
 import ThreeDControls from './components/ThreeDControls';
-import type { ThreeDControlsStateShape } from './types';
+import {
+    AUTO_PAINT_REPEAT_LIMITS,
+    AUTO_PAINT_TRANSITION_OPACITIES,
+    type AutoPaintRepeatLimit,
+    type AutoPaintTransitionOpacity,
+    type ThreeDControlsStateShape,
+} from './types';
 import ThreeDView from './components/ThreeDView';
 import logo from './assets/logo.png';
 import tdTestImg from './assets/tdTest.png';
@@ -79,11 +85,26 @@ type AutoPaintPersisted = Pick<
     | 'regionWeightingMode'
     | 'enhancedColorMatch'
     | 'allowRepeatedSwaps'
+    | 'maxRepeatedSwaps'
+    | 'transitionOpacity'
     | 'heightDithering'
     | 'ditherLineWidth'
     | 'flatPaint'
 >;
 
+function isOneOf<T extends readonly number[]>(value: unknown, values: T): value is T[number] {
+    return typeof value === 'number' && values.includes(value as T[number]);
+}
+
+function normalizeRepeatLimit(value: unknown, legacyEnabled: unknown): AutoPaintRepeatLimit {
+    if (isOneOf(value, AUTO_PAINT_REPEAT_LIMITS)) return value;
+    return legacyEnabled === true ? 4 : 0;
+}
+
+function normalizeTransitionOpacity(value: unknown): AutoPaintTransitionOpacity {
+    return isOneOf(value, AUTO_PAINT_TRANSITION_OPACITIES) ? value : 0.9;
+}
+
 const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
     try {
         const raw = localStorage.getItem(AUTOPAINT_STORAGE_KEY);
@@ -105,7 +126,11 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
             optimizerSeed: parsed.optimizerSeed,
             regionWeightingMode: parsed.regionWeightingMode,
             enhancedColorMatch: parsed.enhancedColorMatch ?? false,
-            allowRepeatedSwaps: parsed.allowRepeatedSwaps ?? false,
+            maxRepeatedSwaps: normalizeRepeatLimit(
+                parsed.maxRepeatedSwaps,
+                parsed.allowRepeatedSwaps
+            ),
+            transitionOpacity: normalizeTransitionOpacity(parsed.transitionOpacity),
             heightDithering: parsed.heightDithering ?? false,
             ditherLineWidth: parsed.ditherLineWidth,
             flatPaint: parsed.flatPaint ?? false,
@@ -243,7 +268,9 @@ function App(): React.ReactElement | null {
                 regionWeightingMode:
                     autopaintHydrated.regionWeightingMode ?? prev.regionWeightingMode,
                 enhancedColorMatch: autopaintHydrated.enhancedColorMatch ?? prev.enhancedColorMatch,
-                allowRepeatedSwaps: autopaintHydrated.allowRepeatedSwaps ?? prev.allowRepeatedSwaps,
+                maxRepeatedSwaps:
+                    autopaintHydrated.maxRepeatedSwaps ?? prev.maxRepeatedSwaps,
+                transitionOpacity: autopaintHydrated.transitionOpacity ?? prev.transitionOpacity,
                 heightDithering: autopaintHydrated.heightDithering ?? prev.heightDithering,
                 ditherLineWidth: autopaintHydrated.ditherLineWidth ?? prev.ditherLineWidth,
                 flatPaint: autopaintHydrated.flatPaint ?? prev.flatPaint,
@@ -262,7 +289,8 @@ function App(): React.ReactElement | null {
             optimizerSeed: threeDState.optimizerSeed,
             regionWeightingMode: threeDState.regionWeightingMode,
             enhancedColorMatch: threeDState.enhancedColorMatch,
-            allowRepeatedSwaps: threeDState.allowRepeatedSwaps,
+            maxRepeatedSwaps: threeDState.maxRepeatedSwaps,
+            transitionOpacity: threeDState.transitionOpacity,
             heightDithering: threeDState.heightDithering,
             ditherLineWidth: threeDState.ditherLineWidth,
             flatPaint: threeDState.flatPaint,
@@ -274,7 +302,8 @@ function App(): React.ReactElement | null {
         threeDState.optimizerSeed,
         threeDState.regionWeightingMode,
         threeDState.enhancedColorMatch,
-        threeDState.allowRepeatedSwaps,
+        threeDState.maxRepeatedSwaps,
+        threeDState.transitionOpacity,
         threeDState.heightDithering,
         threeDState.ditherLineWidth,
         threeDState.flatPaint,
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 04c1293..862c9bb 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -27,13 +27,83 @@ import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover
 import { TabsContent } from '@/components/ui/tabs';
 import type { AutoPaintResult, TransitionZone } from '../lib/autoPaint';
 import type { AutoPaintProfile } from '../lib/profileManager';
-import type { Filament, Swatch } from '../types';
+import type { AutoPaintRepeatLimit, AutoPaintTransitionOpacity, Filament, Swatch } from '../types';
 import type { CalibrationResult } from '../lib/calibration';
+import { getExactBaseOrderCount } from '../lib/optimizer';
 import FilamentRow from './FilamentRow';
 import { FilamentCalibrationWizard } from './FilamentCalibrationWizard';
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
 import { useNextBestColorWorker } from '../hooks/useNextBestColorWorker';
 
+type OptimizerTierValue = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
+
+interface OptimizerTierMeta {
+    value: OptimizerTierValue;
+    label: string;
+    blurb: string;
+    /** Relative output quality, 1–5, for the inline meter. */
+    quality: number;
+    /** Relative speed, 1–5, for the inline meter (5 = fastest). */
+    speed: number;
+}
+
+const OPTIMIZER_TIERS: readonly OptimizerTierMeta[] = [
+    {
+        value: 'fast',
+        label: 'Fast',
+        blurb: 'Narrow beam search for a quick preview.',
+        quality: 2,
+        speed: 5,
+    },
+    {
+        value: 'balanced',
+        label: 'Balanced',
+        blurb: 'Full deterministic beam search; the recommended default.',
+        quality: 3,
+        speed: 4,
+    },
+    {
+        value: 'thorough',
+        label: 'Thorough',
+        blurb: 'Full beam plus deeper multi-start refinement.',
+        quality: 4,
+        speed: 3,
+    },
+    {
+        value: 'deep',
+        label: 'Deep',
+        blurb: 'Wide beam plus a much broader deterministic search.',
+        quality: 5,
+        speed: 2,
+    },
+    {
+        value: 'exact',
+        label: 'Exact base order',
+        blurb: 'Enumerates every no-repeat base order.',
+        quality: 5,
+        speed: 1,
+    },
+];
+
+/** Small 5-segment bar used to convey relative speed / quality of a tier. */
+function TierMeter({ label, value }: { label: string; value: number }): React.ReactElement {
+    return (
+        <span className="flex items-center gap-1">
+            <span className="text-muted-foreground">{label}</span>
+            <span className="flex gap-0.5">
+                {Array.from({ length: 5 }, (_, i) => (
+                    <span
+                        key={i}
+                        className={`h-2 w-1 rounded-sm ${
+                            i < value ? 'bg-primary' : 'bg-muted-foreground/25'
+                        }`}
+                    />
+                ))}
+            </span>
+        </span>
+    );
+}
+
 interface AutoPaintSliceData {
     virtualSwatches: Swatch[];
     colorSliceHeights: number[];
@@ -89,8 +159,10 @@ interface AutoPaintTabProps {
     // Enhanced matching options
     enhancedColorMatch: boolean;
     setEnhancedColorMatch: (v: boolean) => void;
-    allowRepeatedSwaps: boolean;
-    setAllowRepeatedSwaps: (v: boolean) => void;
+    maxRepeatedSwaps: AutoPaintRepeatLimit;
+    setMaxRepeatedSwaps: (v: AutoPaintRepeatLimit) => void;
+    transitionOpacity: AutoPaintTransitionOpacity;
+    setTransitionOpacity: (v: AutoPaintTransitionOpacity) => void;
     heightDithering: boolean;
     setHeightDithering: (v: boolean) => void;
     ditherLineWidth: number;
@@ -101,8 +173,8 @@ interface AutoPaintTabProps {
     setFlatPaint: (v: boolean) => void;
 
     // Optimizer options
-    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
-    setOptimizerAlgorithm: (v: 'fast' | 'balanced' | 'thorough') => void;
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
+    setOptimizerAlgorithm: (v: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact') => void;
     optimizerSeed: number | undefined;
     setOptimizerSeed: (v: number | undefined) => void;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
@@ -147,8 +219,10 @@ export default function AutoPaintTab({
     imageSwatches,
     enhancedColorMatch,
     setEnhancedColorMatch,
-    allowRepeatedSwaps,
-    setAllowRepeatedSwaps,
+    maxRepeatedSwaps,
+    setMaxRepeatedSwaps,
+    transitionOpacity,
+    setTransitionOpacity,
     heightDithering,
     setHeightDithering,
     ditherLineWidth,
@@ -180,6 +254,17 @@ export default function AutoPaintTab({
     const [localOptimizerSeed, setLocalOptimizerSeed] = React.useState(
         optimizerSeed?.toString() ?? ''
     );
+    const exactBaseOrderCount = getExactBaseOrderCount(filaments.length);
+    const activeTier =
+        OPTIMIZER_TIERS.find((tier) => tier.value === optimizerAlgorithm) ?? OPTIMIZER_TIERS[1];
+    const optimizerTierDescription =
+        optimizerAlgorithm === 'exact'
+            ? `Checks all ${exactBaseOrderCount.toLocaleString()} no-repeat base orders.${
+                  filaments.length > 8
+                      ? ' Large profiles can take a long time; start another search to cancel.'
+                      : ''
+              }`
+            : activeTier.blurb;
 
     // Calibration wizard state
     const [calibratingFilamentId, setCalibratingFilamentId] = React.useState<string | null>(null);
@@ -513,12 +598,24 @@ export default function AutoPaintTab({
                                 </div>
                             )}
                             {isComputing && (
-                                <div className="flex items-center gap-1.5 text-[10px] text-primary">
-                                    <Loader2 className="w-3 h-3 animate-spin" />
-                                    <span>
-                                        Optimizing filament order...
-                                        {progress > 0 ? ` ${Math.round(progress * 100)}%` : ''}
-                                    </span>
+                                <div className="space-y-1">
+                                    <div className="flex items-center justify-between text-[10px] text-primary">
+                                        <span className="flex items-center gap-1.5">
+                                            <Loader2 className="w-3 h-3 animate-spin" />
+                                            Optimizing filament order…
+                                        </span>
+                                        <span className="tabular-nums">
+                                            {Math.round(progress * 100)}%
+                                        </span>
+                                    </div>
+                                    <div className="h-1 w-full overflow-hidden rounded-full bg-muted">
+                                        <div
+                                            className="h-full rounded-full bg-primary transition-[width] duration-200 ease-out"
+                                            style={{
+                                                width: `${Math.max(2, Math.min(100, Math.round(progress * 100)))}%`,
+                                            }}
+                                        />
+                                    </div>
                                 </div>
                             )}
                             {error && !isComputing && (
@@ -545,82 +642,117 @@ export default function AutoPaintTab({
                                     onCheckedChange={setEnhancedColorMatch}
                                 />
                             </div>
-                            <div
-                                className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
-                            >
-                                <Label
-                                    htmlFor="allow-repeated-swaps"
-                                    className="text-xs font-medium text-foreground cursor-pointer"
+                            <div className="space-y-3 border-l border-border/50 pl-3 ml-1">
+                                <div
+                                    className={`flex items-center gap-2 transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
-                                    Allow repeated filament swaps
-                                </Label>
-                                <Switch
-                                    id="allow-repeated-swaps"
-                                    data-testid="autopaint-allow-repeated-swaps"
-                                    checked={allowRepeatedSwaps}
-                                    onCheckedChange={setAllowRepeatedSwaps}
-                                    disabled={!enhancedColorMatch}
-                                />
-                            </div>
-                            <div
-                                className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
-                            >
-                                <Label
-                                    htmlFor="height-dithering"
-                                    className="text-xs font-medium text-foreground cursor-pointer"
+                                    <Label
+                                        htmlFor="repeated-swaps"
+                                        className="text-xs font-medium text-foreground whitespace-nowrap"
+                                    >
+                                        Extra repeated swaps
+                                    </Label>
+                                    <Select
+                                        value={maxRepeatedSwaps.toString()}
+                                        onValueChange={(value) =>
+                                            setMaxRepeatedSwaps(
+                                                Number(value) as AutoPaintRepeatLimit
+                                            )
+                                        }
+                                        disabled={!enhancedColorMatch}
+                                    >
+                                        <SelectTrigger
+                                            id="repeated-swaps"
+                                            className="h-7 text-xs flex-1"
+                                        >
+                                            <SelectValue />
+                                        </SelectTrigger>
+                                        <SelectContent>
+                                            <SelectItem value="0" className="text-xs">
+                                                Off
+                                            </SelectItem>
+                                            <SelectItem value="2" className="text-xs">
+                                                2 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="4" className="text-xs">
+                                                4 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="6" className="text-xs">
+                                                6 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="8" className="text-xs">
+                                                8 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="12" className="text-xs">
+                                                12 extra swaps
+                                            </SelectItem>
+                                        </SelectContent>
+                                    </Select>
+                                </div>
+                                <div
+                                    className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
-                                    Height dithering
-                                </Label>
-                                <Switch
-                                    id="height-dithering"
-                                    data-testid="autopaint-height-dithering"
-                                    checked={heightDithering}
-                                    onCheckedChange={setHeightDithering}
-                                    disabled={!enhancedColorMatch}
-                                />
-                            </div>
-                            {heightDithering && enhancedColorMatch && (
-                                <div className="flex items-center gap-2 pl-0.5">
-                                    <label className="text-[11px] text-muted-foreground whitespace-nowrap">
-                                        Line width
-                                    </label>
-                                    <NumberInput
-                                        min={0.1}
-                                        max={2}
-                                        step={0.01}
-                                        value={localDitherLineWidth}
-                                        onChange={(e) => {
-                                            setLocalDitherLineWidth(e.target.value);
-                                        }}
-                                        onBlur={() => {
-                                            let val = parseFloat(localDitherLineWidth);
-                                            if (isNaN(val)) {
-                                                setLocalDitherLineWidth(ditherLineWidth.toString());
-                                                return;
-                                            }
-                                            val = Math.max(0.1, Math.min(2, val));
-                                            setDitherLineWidth(val);
-                                            setLocalDitherLineWidth(val.toString());
-                                        }}
-                                        onKeyDown={(e) => {
-                                            if (e.key === 'Enter') {
-                                                e.currentTarget.blur();
-                                            }
-                                        }}
-                                        className="w-20 h-7 text-xs"
-                                    />
-                                    <span className="text-[10px] text-muted-foreground">mm</span>
-                                    <Button
-                                        variant="ghost"
-                                        size="sm"
-                                        onClick={() => setDitherLineWidth(0.42)}
-                                        className="h-7 px-1.5 text-[10px] text-muted-foreground hover:text-foreground ml-auto"
-                                        title="Reset to default (0.42mm)"
+                                    <Label
+                                        htmlFor="height-dithering"
+                                        className="text-xs font-medium text-foreground cursor-pointer"
                                     >
-                                        Reset
-                                    </Button>
+                                        Height dithering
+                                    </Label>
+                                    <Switch
+                                        id="height-dithering"
+                                        data-testid="autopaint-height-dithering"
+                                        checked={heightDithering}
+                                        onCheckedChange={setHeightDithering}
+                                        disabled={!enhancedColorMatch}
+                                    />
                                 </div>
-                            )}
+                                {heightDithering && enhancedColorMatch && (
+                                    <div className="flex items-center gap-2 pl-0.5">
+                                        <label className="text-[11px] text-muted-foreground whitespace-nowrap">
+                                            Line width
+                                        </label>
+                                        <NumberInput
+                                            min={0.1}
+                                            max={2}
+                                            step={0.01}
+                                            value={localDitherLineWidth}
+                                            onChange={(e) => {
+                                                setLocalDitherLineWidth(e.target.value);
+                                            }}
+                                            onBlur={() => {
+                                                let val = parseFloat(localDitherLineWidth);
+                                                if (isNaN(val)) {
+                                                    setLocalDitherLineWidth(
+                                                        ditherLineWidth.toString()
+                                                    );
+                                                    return;
+                                                }
+                                                val = Math.max(0.1, Math.min(2, val));
+                                                setDitherLineWidth(val);
+                                                setLocalDitherLineWidth(val.toString());
+                                            }}
+                                            onKeyDown={(e) => {
+                                                if (e.key === 'Enter') {
+                                                    e.currentTarget.blur();
+                                                }
+                                            }}
+                                            className="w-20 h-7 text-xs"
+                                        />
+                                        <span className="text-[10px] text-muted-foreground">
+                                            mm
+                                        </span>
+                                        <Button
+                                            variant="ghost"
+                                            size="sm"
+                                            onClick={() => setDitherLineWidth(0.42)}
+                                            className="h-7 px-1.5 text-[10px] text-muted-foreground hover:text-foreground ml-auto"
+                                            title="Reset to default (0.42mm)"
+                                        >
+                                            Reset
+                                        </Button>
+                                    </div>
+                                )}
+                            </div>
                         </div>
                     )}
 
@@ -664,7 +796,7 @@ export default function AutoPaintTab({
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="optimizer-algorithm"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Algorithm
                                     </Label>
@@ -680,22 +812,40 @@ export default function AutoPaintTab({
                                             <SelectValue />
                                         </SelectTrigger>
                                         <SelectContent>
-                                            <SelectItem value="fast" className="text-xs">
-                                                Fast
-                                            </SelectItem>
-                                            <SelectItem value="balanced" className="text-xs">
-                                                Balanced (recommended)
-                                            </SelectItem>
-                                            <SelectItem value="thorough" className="text-xs">
-                                                Thorough (slower)
-                                            </SelectItem>
+                                            {OPTIMIZER_TIERS.map((tier) => (
+                                                <SelectItem
+                                                    key={tier.value}
+                                                    value={tier.value}
+                                                    className="text-xs"
+                                                >
+                                                    {tier.label}
+                                                </SelectItem>
+                                            ))}
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                <div className="pl-[120px] space-y-1.5">
+                                    <div className="flex items-center gap-3 text-[10px]">
+                                        <TierMeter label="Quality" value={activeTier.quality} />
+                                        <TierMeter label="Speed" value={activeTier.speed} />
+                                    </div>
+                                    <p className="text-[10px] text-muted-foreground">
+                                        {optimizerTierDescription}
+                                        {optimizerAlgorithm === 'exact' && maxRepeatedSwaps > 0 && (
+                                            <span>
+                                                {' '}
+                                                The base order is exact; up to {
+                                                    maxRepeatedSwaps
+                                                }{' '}
+                                                repeated swaps are refined heuristically.
+                                            </span>
+                                        )}
+                                    </p>
+                                </div>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="region-weighting"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Region priority
                                     </Label>
@@ -723,10 +873,49 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                <div className="flex items-center gap-2">
+                                    <Label
+                                        htmlFor="transition-opacity"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
+                                    >
+                                        Transition detail
+                                    </Label>
+                                    <Select
+                                        value={transitionOpacity.toString()}
+                                        onValueChange={(value) =>
+                                            setTransitionOpacity(
+                                                Number(value) as AutoPaintTransitionOpacity
+                                            )
+                                        }
+                                        disabled={!enhancedColorMatch}
+                                    >
+                                        <SelectTrigger
+                                            id="transition-opacity"
+                                            className="h-7 text-xs flex-1"
+                                        >
+                                            <SelectValue />
+                                        </SelectTrigger>
+                                        <SelectContent>
+                                            <SelectItem value="0.8" className="text-xs">
+                                                Compact (80% opacity)
+                                            </SelectItem>
+                                            <SelectItem value="0.9" className="text-xs">
+                                                Detailed (90% opacity)
+                                            </SelectItem>
+                                            <SelectItem value="0.95" className="text-xs">
+                                                Maximum (95% opacity)
+                                            </SelectItem>
+                                        </SelectContent>
+                                    </Select>
+                                </div>
+                                <p className="text-[10px] text-muted-foreground pl-[120px]">
+                                    Higher opacity retains a longer physical color ramp, improving
+                                    color resolution at the cost of height, swaps, and runtime.
+                                </p>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="optimizer-seed"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Seed (optional)
                                     </Label>
@@ -996,14 +1185,18 @@ export default function AutoPaintTab({
                                 ) : (
                                     <Sparkles className="w-3 h-3 mr-1.5" />
                                 )}
-                                {isNextBestComputing ? 'Finding suggestion...' : 'Suggest next filament'}
+                                {isNextBestComputing
+                                    ? 'Finding suggestion...'
+                                    : 'Suggest next filament'}
                             </Button>
                             {nextBestResult?.candidate && (
                                 <div className="p-2.5 rounded-md border border-border/50 bg-muted/30 space-y-1.5">
                                     <div className="flex items-center gap-2">
                                         <span
                                             className="w-5 h-5 rounded border border-border/50 flex-shrink-0"
-                                            style={{ backgroundColor: nextBestResult.candidate.hex }}
+                                            style={{
+                                                backgroundColor: nextBestResult.candidate.hex,
+                                            }}
                                         />
                                         <span className="text-xs font-mono font-semibold flex-1">
                                             {nextBestResult.candidate.hex.toUpperCase()}
@@ -1014,7 +1207,9 @@ export default function AutoPaintTab({
                                         >
                                             Est. ΔE{' '}
                                             <span className="text-sm font-bold text-green-600 dark:text-green-400">
-                                                +{nextBestResult.candidate.improvementPct.toFixed(1)}%
+                                                +
+                                                {nextBestResult.candidate.improvementPct.toFixed(1)}
+                                                %
                                             </span>
                                         </span>
                                     </div>
@@ -1049,7 +1244,10 @@ export default function AutoPaintTab({
                                         className="w-full h-7 text-xs mt-0.5"
                                         onClick={() => {
                                             suggestionCountRef.current += 1;
-                                            const nn = String(suggestionCountRef.current).padStart(2, '0');
+                                            const nn = String(suggestionCountRef.current).padStart(
+                                                2,
+                                                '0'
+                                            );
                                             addFilamentWithProps({
                                                 color: nextBestResult.candidate!.hex,
                                                 td: nextBestResult.candidate!.td,
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index f81c678..4367f7a 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -16,7 +16,12 @@ import { useProfileManager } from '../hooks/useProfileManager';
 import { useColorSlicing } from '../hooks/useColorSlicing';
 import { useSwapPlan } from '../hooks/useSwapPlan';
 import { useAutoPaintWorker } from '../hooks/useAutoPaintWorker';
-import type { Swatch, ThreeDControlsStateShape } from '../types';
+import type {
+    AutoPaintRepeatLimit,
+    AutoPaintTransitionOpacity,
+    Swatch,
+    ThreeDControlsStateShape,
+} from '../types';
 import PrintSettingsCard from './PrintSettingsCard';
 import PrintInstructions from './PrintInstructions';
 import AutoPaintTab from './AutoPaintTab';
@@ -111,13 +116,20 @@ export default function ThreeDControls({
     const [paintMode, setPaintMode] = useState<'manual' | 'autopaint'>(initialPaintMode);
     const [autoPaintMaxHeight, setAutoPaintMaxHeight] = useState<number | undefined>(undefined);
     const [enhancedColorMatch, setEnhancedColorMatch] = useState(persisted?.enhancedColorMatch ?? false);
-    const [allowRepeatedSwaps, setAllowRepeatedSwaps] = useState(persisted?.allowRepeatedSwaps ?? false);
+    const [maxRepeatedSwaps, setMaxRepeatedSwaps] = useState<AutoPaintRepeatLimit>(
+        persisted?.maxRepeatedSwaps ?? (persisted?.allowRepeatedSwaps ? 4 : 0)
+    );
+    const [transitionOpacity, setTransitionOpacity] = useState<AutoPaintTransitionOpacity>(
+        persisted?.transitionOpacity ?? 0.9
+    );
     const [heightDithering, setHeightDithering] = useState(persisted?.heightDithering ?? false);
     const [ditherLineWidth, setDitherLineWidth] = useState(persisted?.ditherLineWidth ?? 0.42);
     const [flatPaint, setFlatPaint] = useState(initialFlatPaint);
 
     // --- Optimizer Options ---
-    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<'fast' | 'balanced' | 'thorough'>(
+    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<
+        'fast' | 'balanced' | 'thorough' | 'deep' | 'exact'
+    >(
         persisted?.optimizerAlgorithm ?? 'balanced'
     );
     const [optimizerSeed, setOptimizerSeed] = useState<number | undefined>(
@@ -130,7 +142,6 @@ export default function ThreeDControls({
     const handleEnhancedColorMatchChange = useCallback((v: boolean) => {
         setEnhancedColorMatch(v);
         if (!v) {
-            setAllowRepeatedSwaps(false);
             setHeightDithering(false);
         }
     }, []);
@@ -155,7 +166,8 @@ export default function ThreeDControls({
             paintMode,
             filaments,
             enhancedColorMatch,
-            allowRepeatedSwaps,
+            maxRepeatedSwaps,
+            transitionOpacity,
             heightDithering,
             ditherLineWidth,
             flatPaint,
@@ -165,7 +177,7 @@ export default function ThreeDControls({
             smoothMeshing,
         });
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [paintMode, filaments, enhancedColorMatch, allowRepeatedSwaps, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
+    }, [paintMode, filaments, enhancedColorMatch, maxRepeatedSwaps, transitionOpacity, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
 
     useEffect(() => {
         savePrintSettingsToStorage({ layerHeight, slicerFirstLayerHeight, pixelSize, smoothMeshing });
@@ -213,11 +225,13 @@ export default function ThreeDControls({
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
     });
+    const autoPaintProgressPercent = Math.round(Math.max(0, Math.min(1, autoPaintProgress)) * 100);
 
     const autoPaintSliceData = useMemo(() => {
         if (!autoPaintResult) return undefined;
@@ -310,7 +324,8 @@ export default function ThreeDControls({
                 filaments,
                 paintMode,
                 enhancedColorMatch,
-                allowRepeatedSwaps,
+                maxRepeatedSwaps,
+                transitionOpacity,
                 heightDithering,
                 ditherLineWidth,
                 flatPaint,
@@ -352,7 +367,8 @@ export default function ThreeDControls({
         filaments,
         paintMode,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         heightDithering,
         ditherLineWidth,
         flatPaint,
@@ -378,7 +394,7 @@ export default function ThreeDControls({
                     {isAutoPaintComputing ? (
                         <>
                             <Loader2 className="w-4 h-4 animate-spin" />
-                            <span>Computing...</span>
+                            <span>Computing... {autoPaintProgressPercent}%</span>
                         </>
                     ) : (
                         <>
@@ -462,8 +478,10 @@ export default function ThreeDControls({
                     imageSwatches={filtered}
                     enhancedColorMatch={enhancedColorMatch}
                     setEnhancedColorMatch={handleEnhancedColorMatchChange}
-                    allowRepeatedSwaps={allowRepeatedSwaps}
-                    setAllowRepeatedSwaps={setAllowRepeatedSwaps}
+                    maxRepeatedSwaps={maxRepeatedSwaps}
+                    setMaxRepeatedSwaps={setMaxRepeatedSwaps}
+                    transitionOpacity={transitionOpacity}
+                    setTransitionOpacity={setTransitionOpacity}
                     heightDithering={heightDithering}
                     setHeightDithering={setHeightDithering}
                     ditherLineWidth={ditherLineWidth}
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 656a480..540405d 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -75,11 +75,14 @@ Enable **Enhanced color matching** when filament order matters and you want Krom
 
 Optional controls appear with enhanced matching:
 
-- **Allow repeated filament swaps** lets the same filament appear more than once.
+- **Extra repeated swaps** chooses whether a filament may reappear, and lets you allow 2, 4, 6, 8, or 12 extra occurrences. More repeats can create useful blend paths but expand the search space.
+- **Transition detail** chooses the opacity endpoint for each physical color transition: Compact stops at 80% opacity, Detailed at 90%, and Maximum at 95%. Higher settings create taller stacks with more printable intermediate colors.
 - **Height dithering** uses printable height dots to smooth tonal transitions.
 - **Line width** should roughly match the printer line or nozzle width used for dither dots.
 - **Optimizer Settings** let you choose **Algorithm**, **Region priority**, and an optional **Seed**.
 
+Enhanced matching scores the palette that is already visible in 2D mode; it does not reduce that palette again. For detailed work, prepare the image in 2D first (for example, K-means with a weight of 128 and an Auto palette of 64 or 128 colors), then switch to Auto-paint. This keeps the 2D palette decision explicit, but more source colors make every optimizer tier slower.
+
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
 
 When a filament has been calibrated, Auto-paint uses its measured red, green, and blue TD values for both transition colors and transition thickness. Calibration can therefore change the generated stack height and swap plan as well as the preview color, making the print model more faithful to the measured filament.
@@ -102,16 +105,23 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 
 | Setting         | Meaning                                                      |
 | --------------- | ------------------------------------------------------------ |
-| Algorithm       | Auto, Exhaustive, Simulated Annealing, or Genetic Algorithm. |
+| Algorithm       | Fast, Balanced, Thorough, Deep, or Exact base order.        |
 | Region priority | Uniform, Center-weighted, or Edge-weighted matching.         |
 | Seed (optional) | Overrides the automatic stable seed for an intentional comparison. |
 
-Use **Auto (smart selection)** unless you have a reason to compare algorithms.
-Auto uses exact ordered-subset search through 6 filaments, beam search from 7 to 12,
-then variable-length simulated annealing for larger profiles. With Enhanced color
-matching, Kromacut can omit filaments that do not improve the printable stack. When
-Repeated swaps is enabled, it can also add up to four non-adjacent repeated filament
-occurrences when they improve the blend path.
+Start with **Balanced**. It uses a full deterministic beam search and is the best
+general-purpose choice. **Fast** uses a narrower beam for a quicker preview.
+**Thorough** adds deeper multi-start refinement, while **Deep** widens the beam and
+spends substantially more time exploring alternatives. Each higher tier keeps the
+best result from the tier below for the same seed.
+
+**Exact base order** checks every possible no-repeat filament order. It checks 109,600
+orders at eight filaments and 986,409 at nine, so larger profiles can take a long time.
+The search stays in the background worker and you can start another search to cancel it.
+When **Extra repeated swaps** is above Off, Exact still proves the base order but treats
+repeated occurrences as a separate refined search. Enhanced matching can omit filaments that do
+not improve the printable stack and add the selected number of non-adjacent repeated occurrences
+when they improve the blend path.
 
 **Region priority** changes which source colors the optimizer values most: **Center-weighted** gives more importance to colors that occur near the middle of the image, while **Edge-weighted** favors colors nearer its outer edges. It does not crop or change the image itself.
 
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index 509c897..fb07d8b 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -12,7 +12,12 @@
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import type { AutoPaintResult } from '../lib/autoPaint';
-import type { Filament, Swatch } from '../types';
+import type {
+    AutoPaintRepeatLimit,
+    AutoPaintTransitionOpacity,
+    Filament,
+    Swatch,
+} from '../types';
 import type {
     AutoPaintWorkerProgress,
     AutoPaintWorkerRequest,
@@ -27,8 +32,9 @@ export interface UseAutoPaintWorkerOptions {
     slicerFirstLayerHeight: number;
     autoPaintMaxHeight?: number;
     enhancedColorMatch: boolean;
-    allowRepeatedSwaps: boolean;
-    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
+    maxRepeatedSwaps: AutoPaintRepeatLimit;
+    transitionOpacity: AutoPaintTransitionOpacity;
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
     optimizerSeed?: number;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
 }
@@ -69,7 +75,8 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
@@ -238,9 +245,11 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
                     firstLayerHeight: slicerFirstLayerHeight,
                     maxHeight: autoPaintMaxHeight,
                     enhancedColorMatch,
-                    allowRepeatedSwaps,
+                    maxRepeatedSwaps,
                     optimizerOptions: {
                         algorithm: optimizerAlgorithm,
+                        maxExtraRepeats: maxRepeatedSwaps,
+                        transitionOpacity,
                         ...(optimizerSeed !== undefined && { seed: optimizerSeed }),
                     },
                 };
@@ -271,7 +280,8 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 59dca1f..78c4b04 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -93,7 +93,7 @@ export interface AutoPaintResult {
     };
     // Optimizer metadata (for advanced optimizer only)
     optimizerMetadata?: {
-        algorithm: string; // resolved: 'exhaustive' | 'beam' | 'simulated-annealing' | 'balanced-hybrid'
+        algorithm: string; // concrete tier path, such as 'beam', 'deep-hybrid', or 'exact-base'
         score: number; // Quality score achieved
         iterations: number; // Iterations performed
         converged: boolean; // Whether algorithm converged
@@ -370,6 +370,24 @@ export function getOpacity(
  */
 const DELTA_E_THRESHOLD = 2.3; // "Just noticeable difference"
 
+/** Legacy compact transition endpoint: 80% opacity. The UI explicitly defaults to Detailed (90%). */
+export const DEFAULT_TRANSITION_OPACITY = 0.8;
+
+function normalizeTransitionOpacity(targetOpacity: number | undefined): number {
+    if (!Number.isFinite(targetOpacity)) return DEFAULT_TRANSITION_OPACITY;
+    return Math.max(0.5, Math.min(0.99, targetOpacity!));
+}
+
+function transitionThicknessMultiplier(targetOpacity: number): number {
+    // Keep the old compact 0.7×TD endpoint byte-for-byte stable. The detailed
+    // and maximum presets deliberately align with the familiar 1×TD and
+    // 1.3×TD (about 95%) optical landmarks.
+    if (Math.abs(targetOpacity - 0.8) < 1e-9) return 0.7;
+    if (Math.abs(targetOpacity - 0.9) < 1e-9) return 1;
+    if (Math.abs(targetOpacity - 0.95) < 1e-9) return 1.3;
+    return -Math.log10(1 - targetOpacity);
+}
+
 /**
  * Frontlit prints behave optically like a much shorter effective TD.
  * Scale user-entered TD values down for internal simulation.
@@ -421,7 +439,8 @@ export function calculateTransitionThickness(
     backgroundColor: RGB,
     filamentColor: RGB,
     filamentTD: number | CalibrationRgb,
-    layerHeight: number
+    layerHeight: number,
+    targetOpacity: number = DEFAULT_TRANSITION_OPACITY
 ): number {
     // Early exit if colors are already close
     if (deltaE(backgroundColor, filamentColor) < DELTA_E_THRESHOLD) {
@@ -436,14 +455,15 @@ export function calculateTransitionThickness(
         return layerHeight;
     }
 
-    // The cap determines the absolute maximum transition thickness.
-    // At 0.7×TD, opacity ≈ 80%. At 1×TD, opacity ≈ 90%.
-    // For transitions between adjacent colors in a sorted stack,
-    // DeltaE convergence typically fires well before this cap.
-    // We use 0.7×TD — if the color hasn't converged by ~80% opacity,
-    // additional thickness gives diminishing visual returns.
-    const OPACITY_CAP = 0.7;
-    const maxThickness = Math.max(layerHeight, Math.max(...channelTds) * OPACITY_CAP);
+    // The requested opacity determines the absolute maximum transition
+    // thickness. Perceptual convergence can still complete the transition
+    // earlier when the blended result is already close to the target color.
+    const resolvedOpacity = normalizeTransitionOpacity(targetOpacity);
+    const opacityThicknessMultiplier = transitionThicknessMultiplier(resolvedOpacity);
+    const maxThickness = Math.max(
+        layerHeight,
+        Math.max(...channelTds) * opacityThicknessMultiplier
+    );
 
     // Simulate adding layers until color converges or we hit the cap
     while (thickness < maxThickness) {
@@ -455,8 +475,9 @@ export function calculateTransitionThickness(
             break;
         }
 
-        // Also stop if opacity is already very high — diminishing returns
-        if (getOpacity(filamentTD, thickness) > 0.85) {
+        // Stop at the selected opacity endpoint when perceptual convergence
+        // has not already completed the transition.
+        if (getOpacity(filamentTD, thickness) >= resolvedOpacity) {
             break;
         }
     }
@@ -481,7 +502,8 @@ export function calculateIdealHeight(
     sortedFilaments: AutoPaintFilament[],
     layerHeight: number,
     baseThickness: number = 0.6,
-    transitionThicknessCache?: Map<string, number>
+    transitionThicknessCache?: Map<string, number>,
+    transitionOpacity: number = DEFAULT_TRANSITION_OPACITY
 ): { idealHeight: number; zones: TransitionZone[] } {
     if (sortedFilaments.length === 0) {
         return { idealHeight: baseThickness, zones: [] };
@@ -533,6 +555,7 @@ export function calculateIdealHeight(
                     : transitionTd
             ),
             layerHeight,
+            transitionOpacity,
         ].join(':');
         let transitionThickness = transitionThicknessCache?.get(transitionKey);
         if (transitionThickness === undefined) {
@@ -540,7 +563,8 @@ export function calculateIdealHeight(
                 currentBackgroundColor,
                 filamentRgb,
                 transitionTd,
-                layerHeight
+                layerHeight,
+                transitionOpacity
             );
             transitionThicknessCache?.set(transitionKey, transitionThickness);
         }
@@ -964,6 +988,7 @@ export function buildAchievableColorPalette(
     layerHeight: number,
     firstLayerHeight: number,
     maxHeight?: number,
+    transitionOpacity: number = DEFAULT_TRANSITION_OPACITY,
     transitionThicknessCache?: Map<string, number>
 ): Array<{ height: number; lab: Lab; rgb: RGB }> {
     if (sequence.length === 0) return [];
@@ -973,7 +998,8 @@ export function buildAchievableColorPalette(
         sequence,
         layerHeight,
         Math.max(firstLayerHeight, layerHeight),
-        transitionThicknessCache
+        transitionThicknessCache,
+        transitionOpacity
     );
 
     if (zones.length === 0) return [];
@@ -1100,6 +1126,10 @@ export function weightedErrorPercentile(
 const REALIZED_ERROR_TAIL_WEIGHT = 0.5;
 /** Percentile used for the realized-error tail term. */
 const REALIZED_ERROR_TAIL_PERCENTILE = 0.95;
+/** Detail coverage: targets within this realized error are treated as retained. */
+const DETAIL_COVERAGE_DE = 6;
+/** Prefer stacks that retain more weighted source-color detail. */
+const DETAIL_COVERAGE_PENALTY = 8;
 /** A printable palette entry counts as "used" if a target lands within this ΔE00. */
 const USEFUL_PALETTE_MATCH_DE = 8;
 
@@ -1138,6 +1168,7 @@ export function scoreSequenceAgainstImage(
     const errorSamples: Array<{ value: number; weight: number }> = [];
     const bestMatchHeights: number[] = [];
     const usedPaletteEntries = new Set<number>();
+    let detailCoveredWeight = 0;
 
     for (const entry of mapped) {
         const realizedDeltaE = realizedColorError(entry.mappedLab, entry.target);
@@ -1146,6 +1177,7 @@ export function scoreSequenceAgainstImage(
         totalWeight += weight;
         errorSamples.push({ value: realizedDeltaE, weight });
         bestMatchHeights.push(entry.projectedHeight);
+        if (realizedDeltaE <= DETAIL_COVERAGE_DE) detailCoveredWeight += weight;
         // Mark this palette entry as useful if its printable color is a decent match.
         if (realizedDeltaE < USEFUL_PALETTE_MATCH_DE) usedPaletteEntries.add(entry.paletteIndex);
     }
@@ -1155,6 +1187,7 @@ export function scoreSequenceAgainstImage(
     const weightedMean = weightedErrorSum / totalWeight;
     const weightedTail = weightedErrorPercentile(errorSamples, REALIZED_ERROR_TAIL_PERCENTILE);
     let score = weightedMean + REALIZED_ERROR_TAIL_WEIGHT * weightedTail;
+    score += (1 - detailCoveredWeight / totalWeight) * DETAIL_COVERAGE_PENALTY;
 
     // 2. Height spread penalty: penalize when distinct image colors
     //    collapse to the same height (leading to flat surfaces).
@@ -1220,6 +1253,26 @@ function findBestFilamentOrder(
 /**
  * Advanced optimizer path using the shared variable-length sequence search.
  */
+/**
+ * Convert the already-processed 2D palette into weighted optimizer targets
+ * without applying another palette-reduction pass.
+ */
+export function buildOptimizerImageTargets(
+    imageSwatches: Array<{ hex: string; count?: number }>
+): WeightedLab[] {
+    const totalWeight = imageSwatches.reduce(
+        (total, swatch) => total + Math.max(0, swatch.count ?? 1),
+        0
+    );
+
+    return imageSwatches
+        .map((swatch) => ({
+            ...rgbToLab(hexToRgb(swatch.hex)),
+            weight: Math.max(0, swatch.count ?? 1) / Math.max(1, totalWeight),
+        }))
+        .filter((target) => target.weight > 0);
+}
+
 function findBestFilamentOrderWithOptimizer(
     filaments: Filament[],
     imageSwatches: Array<{ hex: string; count?: number }>,
@@ -1229,8 +1282,7 @@ function findBestFilamentOrderWithOptimizer(
     maxHeight?: number,
     allowRepeatedSwaps: boolean = false
 ): { sortedFilaments: Filament[]; result: OptimizerResult } {
-    // Spatial weighting has already been folded into swatch counts by the caller.
-    const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
+    const imageTargets = buildOptimizerImageTargets(imageSwatches);
 
     // Build scoring context
     const context: ScoringContext = {
@@ -1238,6 +1290,7 @@ function findBestFilamentOrderWithOptimizer(
         layerHeight,
         firstLayerHeight,
         maxHeight,
+        transitionOpacity: optimizerOptions.transitionOpacity,
     };
 
     // Apply frontlit TD scale
@@ -1362,7 +1415,9 @@ export function generateAutoLayers(
     const { idealHeight, zones } = calculateIdealHeight(
         scaledFilaments,
         layerHeight,
-        Math.max(firstLayerHeight, layerHeight)
+        Math.max(firstLayerHeight, layerHeight),
+        undefined,
+        optimizerOptions?.transitionOpacity
     );
 
     // --- STEP 4: APPLY COMPRESSION ON THE PRINTABLE HEIGHT GRID ---
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index f43bbc4..627d8fe 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -22,7 +22,7 @@ import {
 // ============================================================================
 
 /** User-facing optimizer effort tiers (persisted and shown in the UI). */
-export type OptimizerTier = 'fast' | 'balanced' | 'thorough';
+export type OptimizerTier = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 
 /**
  * Values the optimizer accepts: the user-facing tiers plus explicit concrete
@@ -40,13 +40,16 @@ export function normalizeOptimizerTier(value: string | undefined | null): Optimi
         case 'fast':
         case 'balanced':
         case 'thorough':
+        case 'deep':
+        case 'exact':
             return value;
-        case 'exhaustive': // explicit exact search → closest tier is Thorough
+        case 'exhaustive': // explicit exact search → Exact base order
+            return 'exact';
         case 'genetic': // legacy "max effort" option
-            return 'thorough';
+            return 'deep';
         case 'beam':
-            return 'fast';
-        // 'auto', 'simulated-annealing', anything unknown → the smart default
+            return 'balanced';
+        // 'auto', 'simulated-annealing', anything unknown → the recommended default
         default:
             return 'balanced';
     }
@@ -54,7 +57,12 @@ export function normalizeOptimizerTier(value: string | undefined | null): Optimi
 
 export interface OptimizerOptions {
     algorithm: OptimizerAlgorithm;
+    /** Legacy compatibility flag; new callers should set maxExtraRepeats. */
     allowRepeatedSwaps?: boolean;
+    /** Maximum extra non-adjacent filament occurrences (0–12). */
+    maxExtraRepeats?: number;
+    /** Transition opacity target used by the shared printable-palette scorer. */
+    transitionOpacity?: number;
     seed?: number; // For deterministic results
     maxIterations?: number; // Algorithm-specific iteration limit
     temperature?: number; // Initial temperature for SA
@@ -81,6 +89,7 @@ export interface ScoringContext {
     layerHeight: number;
     firstLayerHeight: number;
     maxHeight?: number;
+    transitionOpacity?: number;
 }
 
 // ============================================================================
@@ -156,6 +165,8 @@ const globalCache = new OptimizerCache();
 function tuningFingerprint(options: OptimizerOptions) {
     return {
         allowRepeatedSwaps: options.allowRepeatedSwaps ?? false,
+        maxExtraRepeats: options.maxExtraRepeats ?? null,
+        transitionOpacity: options.transitionOpacity ?? null,
         maxIterations: options.maxIterations ?? null,
         temperature: options.temperature ?? null,
         coolingRate: options.coolingRate ?? null,
@@ -189,6 +200,7 @@ function canonicalOptimizerInput(
         layerHeight: context.layerHeight,
         firstLayerHeight: context.firstLayerHeight,
         maxHeight: context.maxHeight ?? null,
+        transitionOpacity: context.transitionOpacity ?? null,
         algorithm,
         seed: seed ?? null,
         tuning: tuningFingerprint(options),
@@ -225,6 +237,7 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
                 context.layerHeight,
                 context.firstLayerHeight,
                 context.maxHeight,
+                context.transitionOpacity,
                 transitionThicknessCache
             );
             paletteCache.set(sequenceKey, palette);
@@ -241,28 +254,51 @@ export function scoreFilamentSequence(filaments: Filament[], context: ScoringCon
 // Variable-length sequence helpers
 // ============================================================================
 
-const MAX_AUTO_EXHAUSTIVE_FILAMENTS = 6;
-const AUTO_BEAM_MAX_FILAMENTS = 12;
-const MAX_EXTRA_REPEATS = 4;
-const DEFAULT_BEAM_WIDTH = 100;
+const MAX_EXTRA_REPEATS = 12;
+const LEGACY_EXTRA_REPEATS = 4;
+const FAST_BEAM_WIDTH = 25;
+const BALANCED_BEAM_WIDTH = 100;
+const THOROUGH_BEAM_WIDTH = 100;
+const DEEP_BEAM_WIDTH = 250;
 
 type SequenceScorer = (filaments: Filament[]) => number;
 type ResolvedOptimizerAlgorithm =
     | 'exhaustive'
     | 'beam'
     | 'simulated-annealing'
-    | 'balanced-hybrid';
+    | 'narrow-beam'
+    | 'thorough-hybrid'
+    | 'deep-hybrid'
+    | 'exact-base';
 
 const SA_MIN_TEMPERATURE = 0.01;
 const SA_INITIAL_TEMPERATURE = 10.0;
 const SA_DEFAULT_COOLING_RATE = 0.995;
-// The balanced/thorough multi-start refines around good seeds, so it anneals at
-// a lower temperature scaled to the CIEDE2000 objective (scores ~5–30), where
+// The hybrid tiers refine around good seeds at a temperature scaled to the
+// CIEDE2000 objective (scores ~5–30), where
 // the legacy SA temperature of 10 would just wander away from the seed.
 const SA_HYBRID_TEMPERATURE = 2.0;
-// Thorough seeds the hybrid with the exact no-repeat optimum when the ordered
-// subset space is small enough to enumerate quickly (≈7 filaments → 13,699).
-const THOROUGH_EXACT_SUBSET_LIMIT = 20000;
+
+interface HybridSearchPlan {
+    beamWidth: number;
+    restarts: number;
+    minimumIterationsPerRestart: number;
+    iterationsPerFilament: number;
+}
+
+const THOROUGH_PLAN: HybridSearchPlan = {
+    beamWidth: THOROUGH_BEAM_WIDTH,
+    restarts: 12,
+    minimumIterationsPerRestart: 1_500,
+    iterationsPerFilament: 250,
+};
+
+const DEEP_PLAN: HybridSearchPlan = {
+    beamWidth: DEEP_BEAM_WIDTH,
+    restarts: 32,
+    minimumIterationsPerRestart: 4_000,
+    iterationsPerFilament: 500,
+};
 
 interface ScoredSequence {
     order: Filament[];
@@ -289,8 +325,15 @@ function isValidSequence(sequence: Filament[], allowRepeatedSwaps: boolean): boo
     );
 }
 
-function maxSequenceLength(filaments: Filament[], allowRepeatedSwaps: boolean): number {
-    return filaments.length + (allowRepeatedSwaps ? MAX_EXTRA_REPEATS : 0);
+function resolveMaxExtraRepeats(options: OptimizerOptions): number {
+    if (Number.isFinite(options.maxExtraRepeats)) {
+        return Math.max(0, Math.min(MAX_EXTRA_REPEATS, Math.floor(options.maxExtraRepeats!)));
+    }
+    return options.allowRepeatedSwaps ? LEGACY_EXTRA_REPEATS : 0;
+}
+
+function maxSequenceLength(filaments: Filament[], maxExtraRepeats: number): number {
+    return filaments.length + maxExtraRepeats;
 }
 
 function isBetterCandidate(
@@ -311,6 +354,22 @@ function reportProgress(
     options.onProgress?.(Math.min(iteration, total), Math.max(total, 1), bestScore);
 }
 
+function withProgressSpan(
+    options: OptimizerOptions,
+    start: number,
+    end: number
+): OptimizerOptions {
+    if (!options.onProgress) return { ...options, onProgress: undefined };
+
+    return {
+        ...options,
+        onProgress: (iteration, total, bestScore) => {
+            const phaseProgress = total > 0 ? Math.min(1, Math.max(0, iteration / total)) : 1;
+            options.onProgress?.(start + (end - start) * phaseProgress, 1, bestScore);
+        },
+    };
+}
+
 function orderedSubsetCount(filamentCount: number): number {
     let total = 0;
     let permutations = 1;
@@ -321,9 +380,14 @@ function orderedSubsetCount(filamentCount: number): number {
     return total;
 }
 
-function repeatedInsertionUpperBound(filamentCount: number): number {
+/** Number of no-repeat base sequences an Exact search would evaluate. */
+export function getExactBaseOrderCount(filamentCount: number): number {
+    return filamentCount > 0 ? orderedSubsetCount(filamentCount) : 0;
+}
+
+function repeatedInsertionUpperBound(filamentCount: number, maxExtraRepeats: number): number {
     let total = 0;
-    for (let extra = 0; extra < MAX_EXTRA_REPEATS; extra++) {
+    for (let extra = 0; extra < maxExtraRepeats; extra++) {
         total += filamentCount * (filamentCount + extra + 1);
     }
     return total;
@@ -332,9 +396,10 @@ function repeatedInsertionUpperBound(filamentCount: number): number {
 function expandWithRepeatedFilaments(
     initial: ScoredSequence,
     filaments: Filament[],
-    scoreSequence: SequenceScorer
+    scoreSequence: SequenceScorer,
+    maxExtraRepeats: number
 ): { best: ScoredSequence; iterations: number } {
-    const maxLength = maxSequenceLength(filaments, true);
+    const maxLength = maxSequenceLength(filaments, maxExtraRepeats);
     let best = initial;
     let iterations = 0;
 
@@ -384,10 +449,11 @@ function optimizeExhaustive(
         };
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
     const totalIterations =
         orderedSubsetCount(filaments.length) +
-        (allowRepeatedSwaps ? repeatedInsertionUpperBound(filaments.length) : 0);
+        (allowRepeatedSwaps ? repeatedInsertionUpperBound(filaments.length, maxExtraRepeats) : 0);
     let best: ScoredSequence | null = null;
     let iterations = 0;
     reportProgress(options, 0, totalIterations, Infinity);
@@ -420,7 +486,12 @@ function optimizeExhaustive(
         };
     }
 
-    const expanded = expandWithRepeatedFilaments(baseBest, filaments, scoreSequence);
+    const expanded = expandWithRepeatedFilaments(
+        baseBest,
+        filaments,
+        scoreSequence,
+        maxExtraRepeats
+    );
     return {
         order: expanded.best.order,
         score: expanded.best.score,
@@ -442,9 +513,10 @@ function optimizeBeamSearch(
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
-    const beamWidth = options.beamWidth ?? DEFAULT_BEAM_WIDTH;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
+    const beamWidth = options.beamWidth ?? BALANCED_BEAM_WIDTH;
     const totalIterations =
         filaments.length + (maximumLength - 1) * beamWidth * filaments.length;
     let iterations = 0;
@@ -520,11 +592,11 @@ function optimizeBeamSearch(
  */
 function randomInitialSequence(
     filaments: Filament[],
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom
 ): Filament[] {
     const shuffled = rng.shuffle(filaments);
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
     const initialLength = rng.nextInt(1, Math.min(filaments.length, maximumLength) + 1);
     return shuffled.slice(0, initialLength);
 }
@@ -539,10 +611,11 @@ function sequenceEquals(left: Filament[], right: Filament[]): boolean {
 function buildVariableLengthNeighbor(
     sequence: Filament[],
     filaments: Filament[],
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom
 ): Filament[] {
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
     const availableMoves: Array<'swap' | 'relocate' | 'insert' | 'remove' | 'replace'> = [];
 
     if (sequence.length > 1) {
@@ -610,7 +683,7 @@ function runAnneal(
     initialOrder: Filament[],
     filaments: Filament[],
     scoreSequence: SequenceScorer,
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom,
     maxIterations: number,
     initialTemperature: number,
@@ -629,7 +702,7 @@ function runAnneal(
         const newOrder = buildVariableLengthNeighbor(
             currentOrder,
             filaments,
-            allowRepeatedSwaps,
+            maxExtraRepeats,
             rng
         );
         if (sequenceEquals(newOrder, currentOrder)) {
@@ -669,13 +742,13 @@ function optimizeSimulatedAnnealing(
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
     const rng = new SeededRandom(options.seed);
     const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
     const initialTemp = options.temperature ?? SA_INITIAL_TEMPERATURE;
     const coolingRate = options.coolingRate ?? SA_DEFAULT_COOLING_RATE;
 
-    const initialOrder = randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+    const initialOrder = randomInitialSequence(filaments, maxExtraRepeats, rng);
     reportProgress(options, 0, maxIterations, scoreSequence(initialOrder));
 
     let reported = 0;
@@ -683,7 +756,7 @@ function optimizeSimulatedAnnealing(
         initialOrder,
         filaments,
         scoreSequence,
-        allowRepeatedSwaps,
+        maxExtraRepeats,
         rng,
         maxIterations,
         initialTemp,
@@ -703,29 +776,26 @@ function optimizeSimulatedAnnealing(
 }
 
 /**
- * Balanced / Thorough hybrid: take beam search's deterministic best as a seed,
- * then run several deterministic annealing restarts (the first refines the beam
- * seed, the rest explore seeded-random starts) and keep the global best.
- *
- * The budget is a fixed iteration count, not a wall-clock deadline, so results
- * stay reproducible across machines (goldens, caching, A/B seeds depend on it).
+ * Refine a deterministic beam result with seeded multi-start annealing. A
+ * supplied baseline is retained throughout, so a deeper tier can never return
+ * a worse result than the tier it extends.
  */
-function optimizeBalanced(
+function optimizeHybrid(
     filaments: Filament[],
     scoreSequence: SequenceScorer,
     options: OptimizerOptions,
-    thorough: boolean
+    plan: HybridSearchPlan,
+    baseline?: OptimizerResult
 ): OptimizerResult {
     if (filaments.length <= 1) {
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
     const rng = new SeededRandom(options.seed);
-    const restarts = thorough ? 12 : 5;
     const iterationsPerRestart =
         options.maxIterations ??
-        Math.max(thorough ? 1500 : 600, filaments.length * (thorough ? 250 : 120));
+        Math.max(plan.minimumIterationsPerRestart, filaments.length * plan.iterationsPerFilament);
     const initialTemp = options.temperature ?? SA_HYBRID_TEMPERATURE;
     // Cool from the initial temperature to the floor across one restart so each
     // restart spends its whole budget refining instead of freezing early.
@@ -733,38 +803,37 @@ function optimizeBalanced(
         options.coolingRate ??
         Math.pow(SA_MIN_TEMPERATURE / initialTemp, 1 / Math.max(1, iterationsPerRestart));
 
-    // 1. Seeds. Beam is always cheap and strong. Thorough additionally enumerates
-    //    the exact no-repeat optimum when the subset space is small enough, then
-    //    lets the hybrid explore repeats around it — so Thorough ≥ exact ≥ beam.
-    const beam = optimizeBeamSearch(filaments, scoreSequence, { ...options, onProgress: undefined });
+    // Beam provides a strong deterministic seed before the broader local search.
+    const beam = optimizeBeamSearch(filaments, scoreSequence, {
+        ...options,
+        beamWidth: options.beamWidth ?? plan.beamWidth,
+        onProgress: undefined,
+    });
     let best: ScoredSequence = { order: beam.order, score: beam.score };
     let iterations = beam.iterations;
 
-    if (thorough && orderedSubsetCount(filaments.length) <= THOROUGH_EXACT_SUBSET_LIMIT) {
-        const exact = optimizeExhaustive(filaments, scoreSequence, { ...options, onProgress: undefined });
-        iterations += exact.iterations;
-        if (isBetterCandidate({ order: exact.order, score: exact.score }, best)) {
-            best = { order: exact.order, score: exact.score };
-        }
+    if (baseline && isBetterCandidate({ order: baseline.order, score: baseline.score }, best)) {
+        best = { order: baseline.order, score: baseline.score };
     }
+    iterations += baseline?.iterations ?? 0;
 
-    const total = iterations + restarts * iterationsPerRestart;
+    const total = iterations + plan.restarts * iterationsPerRestart;
     let reported = iterations;
     reportProgress(options, reported, total, best.score);
 
-    // 2. Multi-start annealing: restart 0 refines the best seed; the rest explore
-    //    seeded-random starts. Keep the global best across all restarts.
-    for (let restart = 0; restart < restarts; restart++) {
+    // Restart 0 refines the strongest retained candidate; the rest explore
+    // seeded-random starts. Keep the global best across all restarts.
+    for (let restart = 0; restart < plan.restarts; restart++) {
         const initialOrder =
             restart === 0
                 ? best.order
-                : randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+                : randomInitialSequence(filaments, maxExtraRepeats, rng);
 
         const outcome = runAnneal(
             initialOrder,
             filaments,
             scoreSequence,
-            allowRepeatedSwaps,
+            maxExtraRepeats,
             rng,
             iterationsPerRestart,
             initialTemp,
@@ -789,30 +858,84 @@ function optimizeBalanced(
     };
 }
 
+/** Deep is Thorough plus a wider, much larger hybrid pass. */
+function optimizeDeep(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    const thorough = optimizeHybrid(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0, 0.2),
+        THOROUGH_PLAN
+    );
+    return optimizeHybrid(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0.2, 1),
+        DEEP_PLAN,
+        thorough
+    );
+}
+
+/**
+ * Exact base-order search. Repeated swaps remain a separate larger space, so
+ * when they are enabled retain Deep's repeat-aware result alongside exact base
+ * enumeration and its greedy repeat refinement.
+ */
+function optimizeExactBase(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    if (resolveMaxExtraRepeats(options) === 0) {
+        return optimizeExhaustive(filaments, scoreSequence, options);
+    }
+
+    const deep = optimizeDeep(filaments, scoreSequence, withProgressSpan(options, 0, 0.4));
+    const exact = optimizeExhaustive(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0.4, 1)
+    );
+    const exactCandidate = { order: exact.order, score: exact.score };
+    const deepCandidate = { order: deep.order, score: deep.score };
+    const best = isBetterCandidate(deepCandidate, exactCandidate) ? deepCandidate : exactCandidate;
+
+    return {
+        order: best.order,
+        score: best.score,
+        iterations: deep.iterations + exact.iterations,
+        converged: true,
+    };
+}
+
 function resolveAlgorithm(
     requested: OptimizerAlgorithm,
     filamentCount: number
 ): ResolvedOptimizerAlgorithm {
+    if (filamentCount <= 1) return 'exhaustive';
+
     switch (requested) {
         // Explicit concrete searches pass through unchanged.
         case 'exhaustive':
         case 'beam':
         case 'simulated-annealing':
             return requested;
-        // Fast: exact when cheap, else the deterministic beam baseline.
+        // Fast uses a deliberately narrow beam for rapid previews.
         case 'fast':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
-            return 'simulated-annealing';
-        // Balanced (default): exact for tiny profiles, beam-seeded multi-start otherwise.
+            return 'narrow-beam';
+        // Balanced is the full deterministic beam baseline.
         case 'balanced':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            return 'balanced-hybrid';
-        // Thorough: exact for tiny profiles, otherwise an exact-seeded larger
-        // hybrid (the hybrid itself enumerates when feasible — see optimizeBalanced).
+            return 'beam';
+        // Thorough and Deep are progressively broader deterministic hybrids.
         case 'thorough':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            return 'balanced-hybrid';
+            return 'thorough-hybrid';
+        case 'deep':
+            return 'deep-hybrid';
+        case 'exact':
+            return 'exact-base';
     }
 }
 
@@ -840,12 +963,11 @@ export function optimizeFilamentOrder(
     };
 
     const resolved = resolveAlgorithm(opts.algorithm, filaments.length);
-    const thorough = opts.algorithm === 'thorough';
 
-    // Key on the requested tier, not the resolved concrete: 'balanced' and
-    // 'thorough' both resolve to 'balanced-hybrid' but run different budgets and
-    // must not share a cache entry or default seed.
-    const defaultSeedInput = canonicalOptimizerInput(filaments, context, opts.algorithm, opts);
+    // Tiers share the same automatic seed so higher effort builds directly on
+    // comparable deterministic search paths. The cache key still includes the
+    // requested tier because their budgets and outputs can differ.
+    const defaultSeedInput = canonicalOptimizerInput(filaments, context, 'tier-comparison', opts);
     const seed = opts.seed ?? stableHash32(defaultSeedInput);
     opts.seed = seed;
     const cacheKey = canonicalOptimizerInput(filaments, context, opts.algorithm, opts, seed);
@@ -871,8 +993,20 @@ export function optimizeFilamentOrder(
         case 'simulated-annealing':
             result = optimizeSimulatedAnnealing(filaments, scoreSequence, opts);
             break;
-        case 'balanced-hybrid':
-            result = optimizeBalanced(filaments, scoreSequence, opts, thorough);
+        case 'narrow-beam':
+            result = optimizeBeamSearch(filaments, scoreSequence, {
+                ...opts,
+                beamWidth: opts.beamWidth ?? FAST_BEAM_WIDTH,
+            });
+            break;
+        case 'thorough-hybrid':
+            result = optimizeHybrid(filaments, scoreSequence, opts, THOROUGH_PLAN);
+            break;
+        case 'deep-hybrid':
+            result = optimizeDeep(filaments, scoreSequence, opts);
+            break;
+        case 'exact-base':
+            result = optimizeExactBase(filaments, scoreSequence, opts);
             break;
     }
 
diff --git a/src/types/index.ts b/src/types/index.ts
index 4ceb954..99cac53 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -1,6 +1,12 @@
 import type { AutoPaintResult } from '../lib/autoPaint';
 import type { CalibrationResult } from '../lib/calibration';
 
+export const AUTO_PAINT_REPEAT_LIMITS = [0, 2, 4, 6, 8, 12] as const;
+export type AutoPaintRepeatLimit = (typeof AUTO_PAINT_REPEAT_LIMITS)[number];
+
+export const AUTO_PAINT_TRANSITION_OPACITIES = [0.8, 0.9, 0.95] as const;
+export type AutoPaintTransitionOpacity = (typeof AUTO_PAINT_TRANSITION_OPACITIES)[number];
+
 export type Swatch = {
     hex: string;
     a: number;
@@ -43,13 +49,18 @@ export interface ThreeDControlsStateShape {
     paintMode: 'manual' | 'autopaint';
     // Enhanced color matching options
     enhancedColorMatch?: boolean;
+    /** Legacy persisted value. Migrate to maxRepeatedSwaps when loading. */
     allowRepeatedSwaps?: boolean;
+    /** Maximum extra non-adjacent filament occurrences the optimizer may add. */
+    maxRepeatedSwaps?: AutoPaintRepeatLimit;
+    /** Target transition opacity used to create the printable color ramp. */
+    transitionOpacity?: AutoPaintTransitionOpacity;
     heightDithering?: boolean;
     ditherLineWidth?: number;
     /** Flat Paint: build a flat, face-down slab (auto-paint only) */
     flatPaint?: boolean;
     // Optimizer options (effort tier; legacy values migrate on load)
-    optimizerAlgorithm?: 'fast' | 'balanced' | 'thorough';
+    optimizerAlgorithm?: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
     optimizerSeed?: number;
     regionWeightingMode?: 'uniform' | 'center' | 'edge';
     // Auto-paint computed state (only used when paintMode is 'autopaint')
diff --git a/src/workers/autoPaint.worker.ts b/src/workers/autoPaint.worker.ts
index 165c5bf..2f2c142 100644
--- a/src/workers/autoPaint.worker.ts
+++ b/src/workers/autoPaint.worker.ts
@@ -7,7 +7,7 @@
  */
 
 import { generateAutoLayers } from '../lib/autoPaint';
-import type { Filament } from '../types';
+import type { AutoPaintRepeatLimit, Filament } from '../types';
 import type { OptimizerOptions } from '../lib/optimizer';
 import type { AutoPaintResult } from '../lib/autoPaint';
 
@@ -21,7 +21,7 @@ export interface AutoPaintWorkerRequest {
     firstLayerHeight: number;
     maxHeight?: number;
     enhancedColorMatch?: boolean;
-    allowRepeatedSwaps?: boolean;
+    maxRepeatedSwaps?: AutoPaintRepeatLimit;
     optimizerOptions?: Partial<WorkerOptimizerOptions>;
 }
 
@@ -74,7 +74,7 @@ self.onmessage = (e: MessageEvent<AutoPaintWorkerRequest>) => {
             req.firstLayerHeight,
             req.maxHeight,
             req.enhancedColorMatch,
-            req.allowRepeatedSwaps,
+            (req.maxRepeatedSwaps ?? 0) > 0,
             {
                 ...req.optimizerOptions,
                 onProgress: reportProgress,
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 87b554f..914f056 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -321,42 +321,74 @@
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "xud8mzr",
       "plvjtmc",
       "h8zuocq",
-      "y202l1e"
+      "y202l1e",
+      "plvjtmc",
+      "y202l1e",
+      "xud8mzr",
+      "y202l1e",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.56
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.48,
+        "idealThickness": 0.245,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.48,
+        "endHeight": 0.8,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.56,
-        "endHeight": 0.64,
+        "startHeight": 0.8,
+        "endHeight": 0.88,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.64,
-        "endHeight": 0.88,
-        "idealThickness": 0.245,
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 1.2,
+        "endHeight": 1.44,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
+        "startHeight": 1.44,
+        "endHeight": 1.76,
         "idealThickness": 0.329,
         "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.76,
+        "endHeight": 1.84,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 1.2,
+    "totalHeight": 1.84,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -443,8 +475,8 @@
     "filamentOrder": [
       "plvjtmc",
       "h8zuocq",
-      "xud8mzr",
-      "y202l1e"
+      "y202l1e",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
@@ -462,18 +494,18 @@
         "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "y202l1e",
         "startHeight": 0.48,
-        "endHeight": 0.72,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.8,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.72,
+        "filamentId": "xud8mzr",
+        "startHeight": 0.8,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
       }
     ],
     "totalHeight": 1.04,
@@ -481,74 +513,74 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "h8zuocq",
-      "plvjtmc",
       "xud8mzr",
       "h8zuocq",
       "plvjtmc",
+      "y202l1e",
+      "plvjtmc",
       "h8zuocq",
-      "xud8mzr",
-      "y202l1e"
+      "plvjtmc",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "xud8mzr",
         "startHeight": 0,
-        "endHeight": 0.48,
-        "idealThickness": 0.45500000000000007,
-        "actualThickness": 0.48
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.48,
         "endHeight": 0.56,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "h8zuocq",
         "startHeight": 0.56,
         "endHeight": 0.8,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0.8,
-        "endHeight": 1.04,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
+        "startHeight": 1.2,
+        "endHeight": 1.28,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
+        "startHeight": 1.28,
+        "endHeight": 1.52,
         "idealThickness": 0.245,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 1.36,
+        "filamentId": "plvjtmc",
+        "startHeight": 1.52,
         "endHeight": 1.6,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 1.6,
-        "endHeight": 2,
-        "idealThickness": 0.329,
-        "actualThickness": 0.4
+        "endHeight": 1.84,
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2,
+    "totalHeight": 1.84,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -697,104 +729,105 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "98z555k",
-      "vsn9q6u",
       "plvjtmc",
+      "98z555k",
+      "upcjpfe",
       "azwg1yp",
       "xyyxysq",
-      "upcjpfe",
-      "w8cncoa"
+      "w8cncoa",
+      "p9c63ms",
+      "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.56,
-        "endHeight": 0.8,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "filamentId": "98z555k",
+        "startHeight": 0.16,
+        "endHeight": 0.48,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.8,
-        "endHeight": 0.88,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "upcjpfe",
+        "startHeight": 0.48,
+        "endHeight": 0.8,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.88,
-        "endHeight": 1.12,
+        "startHeight": 0.8,
+        "endHeight": 1.04,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
+        "startHeight": 1.04,
+        "endHeight": 1.36,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.76,
-        "endHeight": 2.24,
+        "startHeight": 1.36,
+        "endHeight": 1.84,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.84,
+        "endHeight": 2.24,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.24,
+        "endHeight": 2.48,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2.24,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "98z555k",
       "vsn9q6u",
-      "plvjtmc",
-      "azwg1yp",
       "upcjpfe",
-      "vsn9q6u",
       "azwg1yp",
       "xyyxysq",
       "upcjpfe",
       "w8cncoa",
       "vsn9q6u",
-      "98z555k",
-      "vsn9q6u"
+      "plvjtmc",
+      "azwg1yp",
+      "upcjpfe",
+      "azwg1yp"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "98z555k",
         "startHeight": 0,
         "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
+        "idealThickness": 0.507,
         "actualThickness": 0.56
       },
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "vsn9q6u",
         "startHeight": 0.56,
-        "endHeight": 0.64,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 0.64,
         "endHeight": 0.8,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
@@ -803,61 +836,68 @@
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.44,
-        "endHeight": 1.6,
+        "startHeight": 1.12,
+        "endHeight": 1.36,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.6,
-        "endHeight": 2,
+        "startHeight": 1.36,
+        "endHeight": 1.68,
         "idealThickness": 0.357,
-        "actualThickness": 0.4
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2,
-        "endHeight": 2.32,
+        "startHeight": 1.68,
+        "endHeight": 2.08,
         "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "actualThickness": 0.4
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 2.32,
-        "endHeight": 2.72,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
+        "startHeight": 2.48,
+        "endHeight": 2.72,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "plvjtmc",
         "startHeight": 2.72,
+        "endHeight": 2.8,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.8,
         "endHeight": 3.04,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "98z555k",
+        "filamentId": "upcjpfe",
         "startHeight": 3.04,
-        "endHeight": 3.28,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "endHeight": 3.36,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 3.28,
+        "filamentId": "azwg1yp",
+        "startHeight": 3.36,
         "endHeight": 3.6,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       }
     ],
     "totalHeight": 3.6,
@@ -1010,12 +1050,12 @@
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
       "w8cncoa",
-      "p9c63ms",
-      "xyyxysq",
-      "vsn9q6u",
+      "azwg1yp",
       "plvjtmc",
-      "98z555k",
-      "upcjpfe"
+      "vsn9q6u",
+      "xyyxysq",
+      "upcjpfe",
+      "98z555k"
     ],
     "transitionZones": [
       {
@@ -1026,145 +1066,153 @@
         "actualThickness": 0.88
       },
       {
-        "filamentId": "p9c63ms",
+        "filamentId": "azwg1yp",
         "startHeight": 0.88,
-        "endHeight": 1.28,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "endHeight": 1.04,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.28,
-        "endHeight": 1.6,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 1.04,
+        "endHeight": 1.12,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.6,
-        "endHeight": 1.92,
+        "startHeight": 1.12,
+        "endHeight": 1.44,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.92,
-        "endHeight": 2,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 2,
-        "endHeight": 2.24,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "filamentId": "xyyxysq",
+        "startHeight": 1.44,
+        "endHeight": 1.76,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.24,
-        "endHeight": 2.56,
+        "startHeight": 1.76,
+        "endHeight": 2.08,
         "idealThickness": 0.343,
         "actualThickness": 0.32
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 2.08,
+        "endHeight": 2.4,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.56,
+    "totalHeight": 2.4,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "azwg1yp",
+      "upcjpfe",
       "vsn9q6u",
       "plvjtmc",
-      "upcjpfe",
       "98z555k",
       "upcjpfe",
+      "vsn9q6u",
+      "xyyxysq",
+      "vsn9q6u",
       "p9c63ms",
       "98z555k",
-      "upcjpfe",
-      "plvjtmc",
-      "vsn9q6u",
-      "xyyxysq"
+      "upcjpfe"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "azwg1yp",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.56
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.56,
-        "endHeight": 0.64,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "endHeight": 0.4,
+        "idealThickness": 0.364,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.64,
-        "endHeight": 0.96,
+        "startHeight": 0.4,
+        "endHeight": 0.72,
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.72,
+        "endHeight": 1.04,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.04,
+        "endHeight": 1.12,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.96,
-        "endHeight": 1.2,
+        "startHeight": 1.12,
+        "endHeight": 1.36,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 1.2,
-        "endHeight": 1.6,
+        "startHeight": 1.36,
+        "endHeight": 1.68,
         "idealThickness": 0.343,
-        "actualThickness": 0.4
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.6,
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.68,
         "endHeight": 2,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "98z555k",
+        "filamentId": "xyyxysq",
         "startHeight": 2,
-        "endHeight": 2.24,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "endHeight": 2.32,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.24,
-        "endHeight": 2.64,
-        "idealThickness": 0.343,
-        "actualThickness": 0.4
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.32,
+        "endHeight": 2.56,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.64,
-        "endHeight": 2.72,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "p9c63ms",
+        "startHeight": 2.56,
+        "endHeight": 3.04,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.48
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.72,
-        "endHeight": 2.96,
-        "idealThickness": 0.26599999999999996,
+        "filamentId": "98z555k",
+        "startHeight": 3.04,
+        "endHeight": 3.28,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 2.96,
-        "endHeight": 3.28,
-        "idealThickness": 0.357,
+        "filamentId": "upcjpfe",
+        "startHeight": 3.28,
+        "endHeight": 3.6,
+        "idealThickness": 0.343,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.28,
+    "totalHeight": 3.6,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 9c5a192..e80e449 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -49,19 +49,52 @@ test('CIEDE2000 distance matches the published reference pair', async () => {
     assert.ok(Math.abs(distance - 2.0425) < 0.0001);
 });
 
-test('transition thickness stays printable and respects its TD cap', async () => {
+test('enhanced matching keeps every color from the processed 2D palette', async () => {
+    const { buildOptimizerImageTargets } = await loadAutoPaintModule();
+    const targets = buildOptimizerImageTargets([
+        { hex: '#ff0000', count: 6 },
+        { hex: '#00ff00', count: 3 },
+        { hex: '#0000ff', count: 1 },
+    ]);
+
+    assert.equal(targets.length, 3, 'the optimizer must not perform a second color reduction');
+    assertAlmostEqual(targets.reduce((sum, target) => sum + target.weight, 0), 1);
+    assertAlmostEqual(targets[0].weight, 0.6);
+    assertAlmostEqual(targets[1].weight, 0.3);
+    assertAlmostEqual(targets[2].weight, 0.1);
+});
+
+test('transition thickness follows the selected Beer-Lambert opacity endpoint', async () => {
     const { calculateTransitionThickness, hexToRgb } = await loadAutoPaintModule();
     const layerHeight = 0.1;
     const td = 1;
-    const thickness = calculateTransitionThickness(
+    const compact = calculateTransitionThickness(
         hexToRgb('#000000'),
         hexToRgb('#ffffff'),
         td,
-        layerHeight
+        layerHeight,
+        0.8
+    );
+    const detailed = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        td,
+        layerHeight,
+        0.9
+    );
+    const maximum = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        td,
+        layerHeight,
+        0.95
     );
 
-    assert.ok(thickness >= layerHeight, 'a transition must contain at least one layer');
-    assert.ok(thickness <= td * 0.7 + EPSILON, 'a transition must not exceed the TD cap');
+    assert.ok(compact >= layerHeight, 'a transition must contain at least one layer');
+    assert.ok(compact <= 0.7 * td + EPSILON);
+    assert.ok(detailed <= td + EPSILON);
+    assert.ok(maximum <= 1.3 * td + EPSILON);
+    assert.ok(compact <= detailed && detailed <= maximum, 'detail modes must not shorten the ramp');
 
     const nearIdenticalThickness = calculateTransitionThickness(
         hexToRgb('#112233'),
@@ -98,7 +131,7 @@ test('calibrated channel TDs determine transition thickness', async () => {
     );
     assert.ok(
         calibratedThickness <= 2 * 0.7 + EPSILON,
-        'the calibrated transition must respect the slowest-channel TD cap'
+        'the calibrated transition must respect the default slowest-channel TD cap'
     );
 });
 
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
index 3adbb15..06a1284 100644
--- a/tests/benchmark/autoPaintBench.ts
+++ b/tests/benchmark/autoPaintBench.ts
@@ -5,7 +5,7 @@ import { createServer } from 'vite';
 import { autoPaintGoldenScenarios } from '../autoPaintGoldenFixtures.ts';
 
 type AutoPaintModule = typeof import('../../src/lib/autoPaint.ts');
-type Algorithm = 'fast' | 'balanced' | 'thorough';
+type Algorithm = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 type Lab = { L: number; a: number; b: number };
 type WeightedLab = Lab & { weight: number };
 type Sample = { value: number; weight: number };
@@ -88,7 +88,7 @@ const output: unknown[] = [];
 for (const scenario of autoPaintGoldenScenarios().filter(
     (scenario) => scenario.enhancedColorMatch && scenario.allowRepeatedSwaps
 )) {
-    const algorithms: Algorithm[] = ['fast', 'balanced', 'thorough'];
+    const algorithms: Algorithm[] = ['fast', 'balanced', 'thorough', 'deep', 'exact'];
     // Measure against the raw image colors (ground truth), not the optimizer's
     // clustered targets, so the benchmark is an independent yardstick.
     const targets: WeightedLab[] = scenario.imageSwatches.map((swatch) => {
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 4696c94..b92031b 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -49,7 +49,15 @@ async function loadViteModule<T>(modulePath: string): Promise<T> {
 
 test('each optimizer produces the same result for the same seed', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -71,7 +79,15 @@ test('each optimizer produces the same result for the same seed', async (t) => {
 
 test('optimizer progress is monotonic and completes for every algorithm', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -92,6 +108,25 @@ test('optimizer progress is monotonic and completes for every algorithm', async
             );
         });
     }
+
+    const exactRepeatSamples: number[] = [];
+    optimizeFilamentOrder(filaments, context, {
+        algorithm: 'exact',
+        allowRepeatedSwaps: true,
+        seed: 42,
+        maxIterations: 20,
+        cachingEnabled: false,
+        onProgress: (iteration, total) =>
+            exactRepeatSamples.push(total > 0 ? iteration / total : 0),
+    });
+    assert.ok(exactRepeatSamples.length > 2, 'exact repeat refinement must report intermediate progress');
+    assert.equal(exactRepeatSamples.at(-1), 1);
+    assert.ok(
+        exactRepeatSamples.every(
+            (sample, index) => index === 0 || sample >= exactRepeatSamples[index - 1]
+        ),
+        'exact repeat refinement progress must never move backwards'
+    );
 });
 
 function withoutCacheState<T extends { cacheHit?: boolean }>(result: T): Omit<T, 'cacheHit'> {
@@ -281,7 +316,15 @@ test('repeats can close the RGB color path to reach the missing magenta blend',
 
 test('variable-length optimizers preserve sequence safety invariants', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const allowRepeatedSwaps of [false, true]) {
         for (const algorithm of algorithms) {
@@ -306,7 +349,27 @@ test('variable-length optimizers preserve sequence safety invariants', async (t)
     }
 });
 
-test('fast uses beam search for medium profiles while explicit exhaustive remains exact', async () => {
+test('maxExtraRepeats supports the full user-facing repeat-limit range', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+
+    for (const maxExtraRepeats of [0, 2, 4, 6, 8, 12]) {
+        const result = optimizeFilamentOrder(filaments, context, {
+            algorithm: 'balanced',
+            maxExtraRepeats,
+            seed: 20260624,
+            cachingEnabled: false,
+        });
+        const ids = result.order.map((filament) => filament.id);
+
+        assert.ok(ids.length <= filaments.length + maxExtraRepeats);
+        assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]));
+        if (maxExtraRepeats === 0) {
+            assert.equal(new Set(ids).size, ids.length, 'Off must prohibit all repeated filaments');
+        }
+    }
+});
+
+test('fast uses a narrow beam while explicit exhaustive remains exact', async () => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
@@ -326,7 +389,7 @@ test('fast uses beam search for medium profiles while explicit exhaustive remain
         cachingEnabled: false,
     });
 
-    assert.equal(fast.resolvedAlgorithm, 'beam');
+    assert.equal(fast.resolvedAlgorithm, 'narrow-beam');
     assert.equal(exhaustive.resolvedAlgorithm, 'exhaustive');
     assert.equal(
         exhaustive.iterations,
@@ -337,8 +400,12 @@ test('fast uses beam search for medium profiles while explicit exhaustive remain
     assert.equal(new Set(fast.order.map((filament) => filament.id)).size, fast.order.length);
 });
 
-test('balanced hybrid is deterministic, valid, and never worse than fast on a medium profile', async () => {
-    const { optimizeFilamentOrder } = await loadOptimizerModule();
+test('effort tiers are deterministic and preserve the previous tier best result', async () => {
+    const {
+        getExactBaseOrderCount,
+        normalizeOptimizerTier,
+        optimizeFilamentOrder,
+    } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
         { id: 'green', color: '#42a85f', td: 1.6 },
@@ -346,24 +413,62 @@ test('balanced hybrid is deterministic, valid, and never worse than fast on a me
         { id: 'purple', color: '#7545a8', td: 1.9 },
     ];
 
-    const options = { algorithm: 'balanced' as const, seed: 7, cachingEnabled: false };
-    const first = optimizeFilamentOrder(mediumProfile, context, options);
-    const second = optimizeFilamentOrder(mediumProfile, context, options);
+    const options = { seed: 7, cachingEnabled: false, maxIterations: 30 };
     const fast = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
         algorithm: 'fast',
-        seed: 7,
-        cachingEnabled: false,
+    });
+    const balanced = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'balanced',
+    });
+    const thorough = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'thorough',
+    });
+    const deep = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'deep',
+    });
+    const exact = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'exact',
+    });
+    const deepAgain = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'deep',
     });
 
-    assert.equal(first.resolvedAlgorithm, 'balanced-hybrid');
-    assert.deepEqual(second, first, 'same seed must reproduce the same hybrid result');
+    assert.equal(fast.resolvedAlgorithm, 'narrow-beam');
+    assert.equal(balanced.resolvedAlgorithm, 'beam');
+    assert.equal(thorough.resolvedAlgorithm, 'thorough-hybrid');
+    assert.equal(deep.resolvedAlgorithm, 'deep-hybrid');
+    assert.equal(exact.resolvedAlgorithm, 'exact-base');
+    assert.deepEqual(deepAgain, deep, 'same seed must reproduce the Deep tier');
 
-    const ids = first.order.map((filament) => filament.id);
+    const ids = deep.order.map((filament) => filament.id);
     assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]), 'no adjacent duplicates');
     assert.equal(new Set(ids).size, ids.length, 'no repeats without allowRepeatedSwaps');
 
     assert.ok(
-        first.score <= fast.score + 1e-9,
-        `balanced (${first.score}) must not be worse than fast (${fast.score})`
+        balanced.score <= fast.score + 1e-9,
+        `balanced (${balanced.score}) must not be worse than fast (${fast.score})`
     );
+    assert.ok(
+        thorough.score <= balanced.score + 1e-9,
+        `thorough (${thorough.score}) must not be worse than balanced (${balanced.score})`
+    );
+    assert.ok(
+        deep.score <= thorough.score + 1e-9,
+        `deep (${deep.score}) must not be worse than thorough (${thorough.score})`
+    );
+    assert.ok(
+        exact.score <= deep.score + 1e-9,
+        `exact (${exact.score}) must not be worse than deep (${deep.score})`
+    );
+
+    assert.equal(getExactBaseOrderCount(8), 109_600);
+    assert.equal(getExactBaseOrderCount(9), 986_409);
+    assert.equal(normalizeOptimizerTier('exhaustive'), 'exact');
+    assert.equal(normalizeOptimizerTier('genetic'), 'deep');
 });

From 67ea4485805269d23503853aee67c8f1566080fc Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 21:37:33 +0300
Subject: [PATCH 27/81] Add auto-paint detail controls and optimizer tiers

Replace the repeated-swaps toggle with an Off/2/4/6/8/12 selector and add
a transition-detail selector (80/90/95% opacity) so stack height vs color
resolution is an explicit trade-off. Expand the optimizer menu to five
effort tiers (Fast/Balanced/Thorough/Deep/Exact base order) and score
sequences against the already-processed palette with an added detail-
coverage term.

Polish the panel UI: a determinate progress bar, fixed-width label column
so controls align, a quality/speed meter under the algorithm picker, and
nesting the enhanced-matching sub-options under their gate toggle.
---
 CHANGELOG.md                         |   4 +-
 README.md                            |  37 ++-
 src/App.tsx                          |  39 ++-
 src/components/AutoPaintTab.tsx      | 400 ++++++++++++++++------
 src/components/ThreeDControls.tsx    |  42 ++-
 src/docs/3d-mode.md                  |  26 +-
 src/hooks/useAutoPaintWorker.ts      |  22 +-
 src/lib/autoPaint.ts                 |  91 ++++-
 src/lib/optimizer.ts                 | 296 ++++++++++++-----
 src/types/index.ts                   |  13 +-
 src/workers/autoPaint.worker.ts      |   6 +-
 tests/assets/auto-paint-goldens.json | 480 +++++++++++++++------------
 tests/autoPaint.test.ts              |  45 ++-
 tests/benchmark/autoPaintBench.ts    |   4 +-
 tests/optimizer.test.ts              | 139 +++++++-
 15 files changed, 1152 insertions(+), 492 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53c9949..ced4cb3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,13 +16,13 @@ All notable changes to Kromacut are documented in this file.
 
 - **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
-- **Auto-paint sequence search** - Enhanced matching can now omit filaments that do not improve the printable stack and can natively add up to four non-adjacent repeated swaps when they create useful blends. Auto uses exact subset search through six filaments, deterministic beam search through twelve, and variable-length annealing beyond that.
+- **Auto-paint detail controls** - Enhanced matching now scores every color from the already-processed 2D palette instead of applying a hidden second color reduction. Repeated swaps are now a selector with Off, 2, 4, 6, 8, and 12 extra occurrences; transition detail similarly exposes 80%, 90%, and 95% Beer-Lambert opacity endpoints so quality, stack height, and runtime are an intentional trade-off. Existing repeated-swap settings migrate to four extra occurrences.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
 - **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
 - **Auto-paint optimizer metric** - The optimizer now scores realized print error in CIEDE2000 (ΔE2000) instead of CIE76, and adds a weighted p95 tail term so a few rare but conspicuous colors are not sacrificed to lower the average. Nearest-color and Lab-polyline projection stay in Euclidean CIE76, where they are geometrically valid and fast. Selected filament orders change for some Enhanced color-match profiles.
-- **Auto-paint optimizer tiers** - Replaced the algorithm menu (Auto / Exhaustive / Simulated Annealing / Genetic) with three intent-named effort tiers: **Fast** (deterministic beam search), **Balanced** (the new default — beam-seeded deterministic multi-start local search that often finds a shorter, equal-or-better stack), and **Thorough** (exact enumeration for small profiles, otherwise an exact-seeded larger hybrid). Every tier is fully reproducible from its seed, and higher tiers never score worse than lower ones. Saved profiles migrate automatically: Exhaustive and Genetic become Thorough, Auto and Simulated Annealing become Balanced. The "Genetic" option — which only ever ran annealing — has been removed.
+- **Auto-paint optimizer tiers** - Enhanced matching now offers five reproducible effort tiers: **Fast** (narrow beam preview), **Balanced** (the full-beam default), **Thorough** (deeper hybrid refinement), **Deep** (a wider, much larger hybrid search), and **Exact base order** (all no-repeat orders). Each higher tier preserves the best result from the preceding tier for the same seed. Exact remains available for every profile and reports its candidate count; with repeated swaps it remains exact for the base order while refining repeats separately. Saved values migrate automatically: legacy Exhaustive becomes Exact, Genetic becomes Deep, and Auto or Simulated Annealing becomes Balanced.
 
 ### Fixed
 
diff --git a/README.md b/README.md
index b221319..dacf53d 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ Open-source HueForge-style tool for converting images into stacked, color-layere
 
 Kromacut is a browser-first app that converts images into multi-color lithophane 3D prints. It offers two powerful workflows:
 
-**Auto-paint mode** — Define your actual filaments (color + Transmission Distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, advanced optimizer (simulated annealing/genetic algorithms), and region weighting for spatial priority.
+**Auto-paint mode** — Define your actual filaments (color + Transmission Distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, five deterministic optimizer effort tiers, and region weighting for spatial priority.
 
 **Manual mode** — Reduce images to a small palette, manually tweak per-color layer heights and ordering, and fine-tune every aspect of the stack with complete control.
 
@@ -45,7 +45,7 @@ Another minimal test you can try yourself in the app header: the Transmission Di
 - Plain-text 3D print instructions that describe layer heights and exact layers where filament swaps are required.
 - Copy-to-clipboard button for the print instructions (produces a clean, copyable plain-text plan).
 - **Filament calibration wizard** — Accurately determine Transmission Distance (TD) values through measured samples with confidence scoring.
-- **Advanced optimizer** — Simulated annealing and genetic algorithms find optimal filament ordering for complex multi-color prints.
+- **Advanced optimizer** — Five deterministic effort tiers search for optimal filament ordering, from quick previews to exact base-order enumeration.
 - **Region weighting** — Prioritize accuracy in specific image areas (center, edges) during auto-paint optimization.
 
 ## Notable implementation details
@@ -66,7 +66,7 @@ Another minimal test you can try yourself in the app header: the Transmission Di
 3. Click **Add Filament** and configure your filaments:
    - Use the **calibration wizard** (calibrate icon) to measure accurate TD values, or
    - Enter TD values manually.
-4. Enable **Enhanced color matching** for optimal results (auto-selects best algorithm).
+4. Enable **Enhanced color matching** for optimal results; start with the **Balanced** optimizer tier.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize important areas.
 6. Use the **layer-by-layer preview slider** to verify transitions.
 7. Export via **Download STL** or **Download 3MF** and follow the print plan.
@@ -113,7 +113,7 @@ Auto-paint is an automated layer-generation mode that replaces the manual palett
 
 - **Filaments**: Each filament has a hex color and a **Transmission Distance (TD)** value (in mm). TD describes how translucent the filament is — at a thickness equal to TD, only ~10% of light passes through. Dark/opaque filaments have low TD (e.g. 0.5 mm); light/translucent filaments have high TD (e.g. 6+ mm). When you add a filament without specifying a TD, Kromacut estimates one from the color's luminance and saturation.
 - **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / TD)`. It blends in linear-light sRGB before converting back for display and color matching, which better models the color you see from thin semi-transparent layers.
-- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or opacity exceeds 85%. The result is a set of transition zones, each with a start height, end height, and the filament used.
+- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or reaches the selected opacity endpoint. **Compact** uses 80% opacity, **Detailed** uses 90% (one TD), and **Maximum** uses 95% (the same endpoint as the foundation layer). Higher endpoints retain more printable intermediate colors but create taller stacks.
 - **Luminance-to-height mapping**: Once the transition zones are computed, each pixel's brightness is mapped to a target height in the model. Dark pixels get the minimum height (base layer only), bright pixels get the full height (all layers), and mid-tones fall proportionally in between. This produces the characteristic lithophane-style relief where image brightness = model thickness.
 
 ### How it works (step by step)
@@ -138,14 +138,20 @@ Calibrated filaments display a confidence badge next to their TD value. Higher c
 
 ### Advanced Optimizer
 
-When **Enhanced color matching** is enabled, Kromacut uses advanced optimization algorithms to find the best filament order:
+When **Enhanced color matching** is enabled, choose an effort tier for the filament-order search:
 
-| Algorithm | When Used | Description |
+| Tier | Search | Best use |
 |---|---|---|
-| **Exhaustive search** | Up to 6 filaments | Evaluates every ordered, non-empty subset to guarantee the best available stack. |
-| **Beam search** | Auto, 7-12 filaments | Keeps the strongest partial stacks as it grows them, letting Auto omit unhelpful filaments without an expensive full enumeration. |
-| **Variable-length annealing** | Auto, 13+ filaments; manual Simulated Annealing or Genetic | Searches swaps, moves, insertions, removals, and replacements. The Genetic setting currently uses this search with a larger budget. |
-| **Auto** | Default | Chooses exhaustive search, beam search, or variable-length annealing from the filament count. |
+| **Fast** | Narrow deterministic beam search. | A quick preview while tuning settings. |
+| **Balanced** | Full deterministic beam search. | Recommended default for most prints. |
+| **Thorough** | Full beam plus deeper multi-start refinement. | A stronger search without a long wait. |
+| **Deep** | Wider beam plus substantially more deterministic refinement. | Difficult images when Thorough does not improve the stack. |
+| **Exact base order** | Enumerates every no-repeat base order. | A guaranteed best base order; the candidate count grows very quickly with each filament. |
+
+Each higher tier retains the best result from the tier below for the same seed. Exact
+base order checks 109,600 sequences at eight filaments and 986,409 at nine, so use it
+deliberately on larger profiles. With extra repeated swaps enabled, its base order is exact
+but repeated occurrences are still refined heuristically.
 
 The optimizer displays metadata after generation:
 - **Algorithm used** — Which method was selected
@@ -174,14 +180,17 @@ Region weighting is most useful when filament budget is limited and you want the
 |---|---|
 | **Max Height** | Constrains the total model height (mm). When set below the auto-calculated ideal, zones are uniformly compressed. Leave blank or click `Auto` for the physics-derived default. |
 | **Enhanced color matching** | Optimizes the printable filament sequence rather than simply sorting by luminance. It may omit filaments that do not improve the result and evaluates the actual preview color-to-height path. |
-| **Allow repeated filament swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once, up to four extra occurrences, when that creates a useful color transition. For example, a thin white layer over red can create pink. |
+| **Extra repeated swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once. Choose Off, 2, 4, 6, 8, or 12 additional occurrences; more repeats may create useful blend paths but substantially expand the search. |
 | **Height dithering** | (Requires Enhanced color matching) Applies block-aware Floyd-Steinberg error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
-| **Optimizer algorithm** | Choose Auto (recommended), Exhaustive (up to 6 filaments), Simulated Annealing, or Genetic. Auto uses exhaustive search through 6 filaments, beam search through 12, then variable-length annealing. |
+| **Optimizer algorithm** | Choose Fast for a preview, Balanced for the recommended full beam, Thorough or Deep for more search effort, or Exact base order when you want every no-repeat base stack checked. |
+| **Transition detail** | Chooses where a color transition stops: Compact at 80% opacity, Detailed at 90%, or Maximum at 95%. Higher detail preserves a longer physical color ramp, increasing model height, swaps, and runtime. |
 | **Optimizer seed** | Leave blank for an automatic stable seed, or enter a number for a specific repeatable run. |
 | **Region weighting** | Prioritize specific image regions: Uniform (equal), Center (image middle), or Edge (outer image border). Helps focus quality budget on important areas. |
 
+Enhanced matching uses every color in the palette currently produced by 2D mode; it does not silently reduce that palette again. For detail-critical work, first prepare the image in 2D with K-means (for example, weight 128) and the Auto palette set to the number of colors you want to preserve. More 2D colors improve the target representation but make the optimizer proportionally slower.
+
 ### Filament profiles
 
 Auto-paint configurations (filament lists) can be saved, loaded, and shared as **profiles**:
@@ -228,7 +237,7 @@ Click **Add to filaments** to insert the suggestion directly into the filament l
 2. Switch to the **Auto-paint** tab (inside the 3D controls panel).
 3. Click **Add Filament** and configure each filament's color and TD to match your real filament stock.
    - **Tip:** Use the calibration wizard (calibrate icon on each row) to measure accurate TD values.
-4. (Optional) Enable **Enhanced color matching** for better results with complex images. The optimizer will automatically select the best algorithm (exhaustive, simulated annealing, or genetic) based on your filament count.
+4. (Optional) Enable **Enhanced color matching** for better results with complex images. Start with the **Balanced** optimizer tier, then use Thorough, Deep, or Exact base order when you want to spend more search effort.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize accuracy in visually important areas.
 6. The 3D preview updates automatically. Adjust **Max Height** if the model is too tall.
 7. Use the **layer-by-layer preview slider** at the bottom of the 3D view to verify color transitions.
@@ -253,7 +262,7 @@ Transmission Distance (TD) is the concept HueForge uses to produce perceptual in
 - **Automatic Beer-Lambert blending** — Kromacut simulates light transmission through stacked filament layers using physically accurate optical models.
 - **Filament-based workflow** — Define your actual filaments (color + TD values) and let the algorithm compute optimal layer stacks automatically.
 - **Calibration wizard** — Measure accurate TD values from physical test prints for each filament.
-- **Advanced optimizer** — Simulated annealing and genetic algorithms find the best filament ordering for complex images.
+- **Advanced optimizer** — Deterministic effort tiers search for the best filament ordering for complex images, from quick beam previews to exact base-order enumeration.
 - **Transition zones** — Automatically calculated vertical zones where each filament blends from the color below to its own pure color.
 
 See the [Auto-paint section](#auto-paint) above for full details.
diff --git a/src/App.tsx b/src/App.tsx
index 9d22a48..00641b7 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -1,6 +1,12 @@
 import React, { useEffect, useRef, useState } from 'react';
 import ThreeDControls from './components/ThreeDControls';
-import type { ThreeDControlsStateShape } from './types';
+import {
+    AUTO_PAINT_REPEAT_LIMITS,
+    AUTO_PAINT_TRANSITION_OPACITIES,
+    type AutoPaintRepeatLimit,
+    type AutoPaintTransitionOpacity,
+    type ThreeDControlsStateShape,
+} from './types';
 import ThreeDView from './components/ThreeDView';
 import logo from './assets/logo.png';
 import tdTestImg from './assets/tdTest.png';
@@ -79,11 +85,26 @@ type AutoPaintPersisted = Pick<
     | 'regionWeightingMode'
     | 'enhancedColorMatch'
     | 'allowRepeatedSwaps'
+    | 'maxRepeatedSwaps'
+    | 'transitionOpacity'
     | 'heightDithering'
     | 'ditherLineWidth'
     | 'flatPaint'
 >;
 
+function isOneOf<T extends readonly number[]>(value: unknown, values: T): value is T[number] {
+    return typeof value === 'number' && values.includes(value as T[number]);
+}
+
+function normalizeRepeatLimit(value: unknown, legacyEnabled: unknown): AutoPaintRepeatLimit {
+    if (isOneOf(value, AUTO_PAINT_REPEAT_LIMITS)) return value;
+    return legacyEnabled === true ? 4 : 0;
+}
+
+function normalizeTransitionOpacity(value: unknown): AutoPaintTransitionOpacity {
+    return isOneOf(value, AUTO_PAINT_TRANSITION_OPACITIES) ? value : 0.9;
+}
+
 const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
     try {
         const raw = localStorage.getItem(AUTOPAINT_STORAGE_KEY);
@@ -105,7 +126,11 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
             optimizerSeed: parsed.optimizerSeed,
             regionWeightingMode: parsed.regionWeightingMode,
             enhancedColorMatch: parsed.enhancedColorMatch ?? false,
-            allowRepeatedSwaps: parsed.allowRepeatedSwaps ?? false,
+            maxRepeatedSwaps: normalizeRepeatLimit(
+                parsed.maxRepeatedSwaps,
+                parsed.allowRepeatedSwaps
+            ),
+            transitionOpacity: normalizeTransitionOpacity(parsed.transitionOpacity),
             heightDithering: parsed.heightDithering ?? false,
             ditherLineWidth: parsed.ditherLineWidth,
             flatPaint: parsed.flatPaint ?? false,
@@ -243,7 +268,9 @@ function App(): React.ReactElement | null {
                 regionWeightingMode:
                     autopaintHydrated.regionWeightingMode ?? prev.regionWeightingMode,
                 enhancedColorMatch: autopaintHydrated.enhancedColorMatch ?? prev.enhancedColorMatch,
-                allowRepeatedSwaps: autopaintHydrated.allowRepeatedSwaps ?? prev.allowRepeatedSwaps,
+                maxRepeatedSwaps:
+                    autopaintHydrated.maxRepeatedSwaps ?? prev.maxRepeatedSwaps,
+                transitionOpacity: autopaintHydrated.transitionOpacity ?? prev.transitionOpacity,
                 heightDithering: autopaintHydrated.heightDithering ?? prev.heightDithering,
                 ditherLineWidth: autopaintHydrated.ditherLineWidth ?? prev.ditherLineWidth,
                 flatPaint: autopaintHydrated.flatPaint ?? prev.flatPaint,
@@ -262,7 +289,8 @@ function App(): React.ReactElement | null {
             optimizerSeed: threeDState.optimizerSeed,
             regionWeightingMode: threeDState.regionWeightingMode,
             enhancedColorMatch: threeDState.enhancedColorMatch,
-            allowRepeatedSwaps: threeDState.allowRepeatedSwaps,
+            maxRepeatedSwaps: threeDState.maxRepeatedSwaps,
+            transitionOpacity: threeDState.transitionOpacity,
             heightDithering: threeDState.heightDithering,
             ditherLineWidth: threeDState.ditherLineWidth,
             flatPaint: threeDState.flatPaint,
@@ -274,7 +302,8 @@ function App(): React.ReactElement | null {
         threeDState.optimizerSeed,
         threeDState.regionWeightingMode,
         threeDState.enhancedColorMatch,
-        threeDState.allowRepeatedSwaps,
+        threeDState.maxRepeatedSwaps,
+        threeDState.transitionOpacity,
         threeDState.heightDithering,
         threeDState.ditherLineWidth,
         threeDState.flatPaint,
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 04c1293..862c9bb 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -27,13 +27,83 @@ import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover
 import { TabsContent } from '@/components/ui/tabs';
 import type { AutoPaintResult, TransitionZone } from '../lib/autoPaint';
 import type { AutoPaintProfile } from '../lib/profileManager';
-import type { Filament, Swatch } from '../types';
+import type { AutoPaintRepeatLimit, AutoPaintTransitionOpacity, Filament, Swatch } from '../types';
 import type { CalibrationResult } from '../lib/calibration';
+import { getExactBaseOrderCount } from '../lib/optimizer';
 import FilamentRow from './FilamentRow';
 import { FilamentCalibrationWizard } from './FilamentCalibrationWizard';
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
 import { useNextBestColorWorker } from '../hooks/useNextBestColorWorker';
 
+type OptimizerTierValue = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
+
+interface OptimizerTierMeta {
+    value: OptimizerTierValue;
+    label: string;
+    blurb: string;
+    /** Relative output quality, 1–5, for the inline meter. */
+    quality: number;
+    /** Relative speed, 1–5, for the inline meter (5 = fastest). */
+    speed: number;
+}
+
+const OPTIMIZER_TIERS: readonly OptimizerTierMeta[] = [
+    {
+        value: 'fast',
+        label: 'Fast',
+        blurb: 'Narrow beam search for a quick preview.',
+        quality: 2,
+        speed: 5,
+    },
+    {
+        value: 'balanced',
+        label: 'Balanced',
+        blurb: 'Full deterministic beam search; the recommended default.',
+        quality: 3,
+        speed: 4,
+    },
+    {
+        value: 'thorough',
+        label: 'Thorough',
+        blurb: 'Full beam plus deeper multi-start refinement.',
+        quality: 4,
+        speed: 3,
+    },
+    {
+        value: 'deep',
+        label: 'Deep',
+        blurb: 'Wide beam plus a much broader deterministic search.',
+        quality: 5,
+        speed: 2,
+    },
+    {
+        value: 'exact',
+        label: 'Exact base order',
+        blurb: 'Enumerates every no-repeat base order.',
+        quality: 5,
+        speed: 1,
+    },
+];
+
+/** Small 5-segment bar used to convey relative speed / quality of a tier. */
+function TierMeter({ label, value }: { label: string; value: number }): React.ReactElement {
+    return (
+        <span className="flex items-center gap-1">
+            <span className="text-muted-foreground">{label}</span>
+            <span className="flex gap-0.5">
+                {Array.from({ length: 5 }, (_, i) => (
+                    <span
+                        key={i}
+                        className={`h-2 w-1 rounded-sm ${
+                            i < value ? 'bg-primary' : 'bg-muted-foreground/25'
+                        }`}
+                    />
+                ))}
+            </span>
+        </span>
+    );
+}
+
 interface AutoPaintSliceData {
     virtualSwatches: Swatch[];
     colorSliceHeights: number[];
@@ -89,8 +159,10 @@ interface AutoPaintTabProps {
     // Enhanced matching options
     enhancedColorMatch: boolean;
     setEnhancedColorMatch: (v: boolean) => void;
-    allowRepeatedSwaps: boolean;
-    setAllowRepeatedSwaps: (v: boolean) => void;
+    maxRepeatedSwaps: AutoPaintRepeatLimit;
+    setMaxRepeatedSwaps: (v: AutoPaintRepeatLimit) => void;
+    transitionOpacity: AutoPaintTransitionOpacity;
+    setTransitionOpacity: (v: AutoPaintTransitionOpacity) => void;
     heightDithering: boolean;
     setHeightDithering: (v: boolean) => void;
     ditherLineWidth: number;
@@ -101,8 +173,8 @@ interface AutoPaintTabProps {
     setFlatPaint: (v: boolean) => void;
 
     // Optimizer options
-    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
-    setOptimizerAlgorithm: (v: 'fast' | 'balanced' | 'thorough') => void;
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
+    setOptimizerAlgorithm: (v: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact') => void;
     optimizerSeed: number | undefined;
     setOptimizerSeed: (v: number | undefined) => void;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
@@ -147,8 +219,10 @@ export default function AutoPaintTab({
     imageSwatches,
     enhancedColorMatch,
     setEnhancedColorMatch,
-    allowRepeatedSwaps,
-    setAllowRepeatedSwaps,
+    maxRepeatedSwaps,
+    setMaxRepeatedSwaps,
+    transitionOpacity,
+    setTransitionOpacity,
     heightDithering,
     setHeightDithering,
     ditherLineWidth,
@@ -180,6 +254,17 @@ export default function AutoPaintTab({
     const [localOptimizerSeed, setLocalOptimizerSeed] = React.useState(
         optimizerSeed?.toString() ?? ''
     );
+    const exactBaseOrderCount = getExactBaseOrderCount(filaments.length);
+    const activeTier =
+        OPTIMIZER_TIERS.find((tier) => tier.value === optimizerAlgorithm) ?? OPTIMIZER_TIERS[1];
+    const optimizerTierDescription =
+        optimizerAlgorithm === 'exact'
+            ? `Checks all ${exactBaseOrderCount.toLocaleString()} no-repeat base orders.${
+                  filaments.length > 8
+                      ? ' Large profiles can take a long time; start another search to cancel.'
+                      : ''
+              }`
+            : activeTier.blurb;
 
     // Calibration wizard state
     const [calibratingFilamentId, setCalibratingFilamentId] = React.useState<string | null>(null);
@@ -513,12 +598,24 @@ export default function AutoPaintTab({
                                 </div>
                             )}
                             {isComputing && (
-                                <div className="flex items-center gap-1.5 text-[10px] text-primary">
-                                    <Loader2 className="w-3 h-3 animate-spin" />
-                                    <span>
-                                        Optimizing filament order...
-                                        {progress > 0 ? ` ${Math.round(progress * 100)}%` : ''}
-                                    </span>
+                                <div className="space-y-1">
+                                    <div className="flex items-center justify-between text-[10px] text-primary">
+                                        <span className="flex items-center gap-1.5">
+                                            <Loader2 className="w-3 h-3 animate-spin" />
+                                            Optimizing filament order…
+                                        </span>
+                                        <span className="tabular-nums">
+                                            {Math.round(progress * 100)}%
+                                        </span>
+                                    </div>
+                                    <div className="h-1 w-full overflow-hidden rounded-full bg-muted">
+                                        <div
+                                            className="h-full rounded-full bg-primary transition-[width] duration-200 ease-out"
+                                            style={{
+                                                width: `${Math.max(2, Math.min(100, Math.round(progress * 100)))}%`,
+                                            }}
+                                        />
+                                    </div>
                                 </div>
                             )}
                             {error && !isComputing && (
@@ -545,82 +642,117 @@ export default function AutoPaintTab({
                                     onCheckedChange={setEnhancedColorMatch}
                                 />
                             </div>
-                            <div
-                                className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
-                            >
-                                <Label
-                                    htmlFor="allow-repeated-swaps"
-                                    className="text-xs font-medium text-foreground cursor-pointer"
+                            <div className="space-y-3 border-l border-border/50 pl-3 ml-1">
+                                <div
+                                    className={`flex items-center gap-2 transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
-                                    Allow repeated filament swaps
-                                </Label>
-                                <Switch
-                                    id="allow-repeated-swaps"
-                                    data-testid="autopaint-allow-repeated-swaps"
-                                    checked={allowRepeatedSwaps}
-                                    onCheckedChange={setAllowRepeatedSwaps}
-                                    disabled={!enhancedColorMatch}
-                                />
-                            </div>
-                            <div
-                                className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
-                            >
-                                <Label
-                                    htmlFor="height-dithering"
-                                    className="text-xs font-medium text-foreground cursor-pointer"
+                                    <Label
+                                        htmlFor="repeated-swaps"
+                                        className="text-xs font-medium text-foreground whitespace-nowrap"
+                                    >
+                                        Extra repeated swaps
+                                    </Label>
+                                    <Select
+                                        value={maxRepeatedSwaps.toString()}
+                                        onValueChange={(value) =>
+                                            setMaxRepeatedSwaps(
+                                                Number(value) as AutoPaintRepeatLimit
+                                            )
+                                        }
+                                        disabled={!enhancedColorMatch}
+                                    >
+                                        <SelectTrigger
+                                            id="repeated-swaps"
+                                            className="h-7 text-xs flex-1"
+                                        >
+                                            <SelectValue />
+                                        </SelectTrigger>
+                                        <SelectContent>
+                                            <SelectItem value="0" className="text-xs">
+                                                Off
+                                            </SelectItem>
+                                            <SelectItem value="2" className="text-xs">
+                                                2 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="4" className="text-xs">
+                                                4 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="6" className="text-xs">
+                                                6 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="8" className="text-xs">
+                                                8 extra swaps
+                                            </SelectItem>
+                                            <SelectItem value="12" className="text-xs">
+                                                12 extra swaps
+                                            </SelectItem>
+                                        </SelectContent>
+                                    </Select>
+                                </div>
+                                <div
+                                    className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
-                                    Height dithering
-                                </Label>
-                                <Switch
-                                    id="height-dithering"
-                                    data-testid="autopaint-height-dithering"
-                                    checked={heightDithering}
-                                    onCheckedChange={setHeightDithering}
-                                    disabled={!enhancedColorMatch}
-                                />
-                            </div>
-                            {heightDithering && enhancedColorMatch && (
-                                <div className="flex items-center gap-2 pl-0.5">
-                                    <label className="text-[11px] text-muted-foreground whitespace-nowrap">
-                                        Line width
-                                    </label>
-                                    <NumberInput
-                                        min={0.1}
-                                        max={2}
-                                        step={0.01}
-                                        value={localDitherLineWidth}
-                                        onChange={(e) => {
-                                            setLocalDitherLineWidth(e.target.value);
-                                        }}
-                                        onBlur={() => {
-                                            let val = parseFloat(localDitherLineWidth);
-                                            if (isNaN(val)) {
-                                                setLocalDitherLineWidth(ditherLineWidth.toString());
-                                                return;
-                                            }
-                                            val = Math.max(0.1, Math.min(2, val));
-                                            setDitherLineWidth(val);
-                                            setLocalDitherLineWidth(val.toString());
-                                        }}
-                                        onKeyDown={(e) => {
-                                            if (e.key === 'Enter') {
-                                                e.currentTarget.blur();
-                                            }
-                                        }}
-                                        className="w-20 h-7 text-xs"
-                                    />
-                                    <span className="text-[10px] text-muted-foreground">mm</span>
-                                    <Button
-                                        variant="ghost"
-                                        size="sm"
-                                        onClick={() => setDitherLineWidth(0.42)}
-                                        className="h-7 px-1.5 text-[10px] text-muted-foreground hover:text-foreground ml-auto"
-                                        title="Reset to default (0.42mm)"
+                                    <Label
+                                        htmlFor="height-dithering"
+                                        className="text-xs font-medium text-foreground cursor-pointer"
                                     >
-                                        Reset
-                                    </Button>
+                                        Height dithering
+                                    </Label>
+                                    <Switch
+                                        id="height-dithering"
+                                        data-testid="autopaint-height-dithering"
+                                        checked={heightDithering}
+                                        onCheckedChange={setHeightDithering}
+                                        disabled={!enhancedColorMatch}
+                                    />
                                 </div>
-                            )}
+                                {heightDithering && enhancedColorMatch && (
+                                    <div className="flex items-center gap-2 pl-0.5">
+                                        <label className="text-[11px] text-muted-foreground whitespace-nowrap">
+                                            Line width
+                                        </label>
+                                        <NumberInput
+                                            min={0.1}
+                                            max={2}
+                                            step={0.01}
+                                            value={localDitherLineWidth}
+                                            onChange={(e) => {
+                                                setLocalDitherLineWidth(e.target.value);
+                                            }}
+                                            onBlur={() => {
+                                                let val = parseFloat(localDitherLineWidth);
+                                                if (isNaN(val)) {
+                                                    setLocalDitherLineWidth(
+                                                        ditherLineWidth.toString()
+                                                    );
+                                                    return;
+                                                }
+                                                val = Math.max(0.1, Math.min(2, val));
+                                                setDitherLineWidth(val);
+                                                setLocalDitherLineWidth(val.toString());
+                                            }}
+                                            onKeyDown={(e) => {
+                                                if (e.key === 'Enter') {
+                                                    e.currentTarget.blur();
+                                                }
+                                            }}
+                                            className="w-20 h-7 text-xs"
+                                        />
+                                        <span className="text-[10px] text-muted-foreground">
+                                            mm
+                                        </span>
+                                        <Button
+                                            variant="ghost"
+                                            size="sm"
+                                            onClick={() => setDitherLineWidth(0.42)}
+                                            className="h-7 px-1.5 text-[10px] text-muted-foreground hover:text-foreground ml-auto"
+                                            title="Reset to default (0.42mm)"
+                                        >
+                                            Reset
+                                        </Button>
+                                    </div>
+                                )}
+                            </div>
                         </div>
                     )}
 
@@ -664,7 +796,7 @@ export default function AutoPaintTab({
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="optimizer-algorithm"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Algorithm
                                     </Label>
@@ -680,22 +812,40 @@ export default function AutoPaintTab({
                                             <SelectValue />
                                         </SelectTrigger>
                                         <SelectContent>
-                                            <SelectItem value="fast" className="text-xs">
-                                                Fast
-                                            </SelectItem>
-                                            <SelectItem value="balanced" className="text-xs">
-                                                Balanced (recommended)
-                                            </SelectItem>
-                                            <SelectItem value="thorough" className="text-xs">
-                                                Thorough (slower)
-                                            </SelectItem>
+                                            {OPTIMIZER_TIERS.map((tier) => (
+                                                <SelectItem
+                                                    key={tier.value}
+                                                    value={tier.value}
+                                                    className="text-xs"
+                                                >
+                                                    {tier.label}
+                                                </SelectItem>
+                                            ))}
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                <div className="pl-[120px] space-y-1.5">
+                                    <div className="flex items-center gap-3 text-[10px]">
+                                        <TierMeter label="Quality" value={activeTier.quality} />
+                                        <TierMeter label="Speed" value={activeTier.speed} />
+                                    </div>
+                                    <p className="text-[10px] text-muted-foreground">
+                                        {optimizerTierDescription}
+                                        {optimizerAlgorithm === 'exact' && maxRepeatedSwaps > 0 && (
+                                            <span>
+                                                {' '}
+                                                The base order is exact; up to {
+                                                    maxRepeatedSwaps
+                                                }{' '}
+                                                repeated swaps are refined heuristically.
+                                            </span>
+                                        )}
+                                    </p>
+                                </div>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="region-weighting"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Region priority
                                     </Label>
@@ -723,10 +873,49 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                <div className="flex items-center gap-2">
+                                    <Label
+                                        htmlFor="transition-opacity"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
+                                    >
+                                        Transition detail
+                                    </Label>
+                                    <Select
+                                        value={transitionOpacity.toString()}
+                                        onValueChange={(value) =>
+                                            setTransitionOpacity(
+                                                Number(value) as AutoPaintTransitionOpacity
+                                            )
+                                        }
+                                        disabled={!enhancedColorMatch}
+                                    >
+                                        <SelectTrigger
+                                            id="transition-opacity"
+                                            className="h-7 text-xs flex-1"
+                                        >
+                                            <SelectValue />
+                                        </SelectTrigger>
+                                        <SelectContent>
+                                            <SelectItem value="0.8" className="text-xs">
+                                                Compact (80% opacity)
+                                            </SelectItem>
+                                            <SelectItem value="0.9" className="text-xs">
+                                                Detailed (90% opacity)
+                                            </SelectItem>
+                                            <SelectItem value="0.95" className="text-xs">
+                                                Maximum (95% opacity)
+                                            </SelectItem>
+                                        </SelectContent>
+                                    </Select>
+                                </div>
+                                <p className="text-[10px] text-muted-foreground pl-[120px]">
+                                    Higher opacity retains a longer physical color ramp, improving
+                                    color resolution at the cost of height, swaps, and runtime.
+                                </p>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="optimizer-seed"
-                                        className="text-xs text-muted-foreground whitespace-nowrap"
+                                        className="w-28 shrink-0 text-xs text-muted-foreground whitespace-nowrap"
                                     >
                                         Seed (optional)
                                     </Label>
@@ -996,14 +1185,18 @@ export default function AutoPaintTab({
                                 ) : (
                                     <Sparkles className="w-3 h-3 mr-1.5" />
                                 )}
-                                {isNextBestComputing ? 'Finding suggestion...' : 'Suggest next filament'}
+                                {isNextBestComputing
+                                    ? 'Finding suggestion...'
+                                    : 'Suggest next filament'}
                             </Button>
                             {nextBestResult?.candidate && (
                                 <div className="p-2.5 rounded-md border border-border/50 bg-muted/30 space-y-1.5">
                                     <div className="flex items-center gap-2">
                                         <span
                                             className="w-5 h-5 rounded border border-border/50 flex-shrink-0"
-                                            style={{ backgroundColor: nextBestResult.candidate.hex }}
+                                            style={{
+                                                backgroundColor: nextBestResult.candidate.hex,
+                                            }}
                                         />
                                         <span className="text-xs font-mono font-semibold flex-1">
                                             {nextBestResult.candidate.hex.toUpperCase()}
@@ -1014,7 +1207,9 @@ export default function AutoPaintTab({
                                         >
                                             Est. ΔE{' '}
                                             <span className="text-sm font-bold text-green-600 dark:text-green-400">
-                                                +{nextBestResult.candidate.improvementPct.toFixed(1)}%
+                                                +
+                                                {nextBestResult.candidate.improvementPct.toFixed(1)}
+                                                %
                                             </span>
                                         </span>
                                     </div>
@@ -1049,7 +1244,10 @@ export default function AutoPaintTab({
                                         className="w-full h-7 text-xs mt-0.5"
                                         onClick={() => {
                                             suggestionCountRef.current += 1;
-                                            const nn = String(suggestionCountRef.current).padStart(2, '0');
+                                            const nn = String(suggestionCountRef.current).padStart(
+                                                2,
+                                                '0'
+                                            );
                                             addFilamentWithProps({
                                                 color: nextBestResult.candidate!.hex,
                                                 td: nextBestResult.candidate!.td,
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index f81c678..4367f7a 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -16,7 +16,12 @@ import { useProfileManager } from '../hooks/useProfileManager';
 import { useColorSlicing } from '../hooks/useColorSlicing';
 import { useSwapPlan } from '../hooks/useSwapPlan';
 import { useAutoPaintWorker } from '../hooks/useAutoPaintWorker';
-import type { Swatch, ThreeDControlsStateShape } from '../types';
+import type {
+    AutoPaintRepeatLimit,
+    AutoPaintTransitionOpacity,
+    Swatch,
+    ThreeDControlsStateShape,
+} from '../types';
 import PrintSettingsCard from './PrintSettingsCard';
 import PrintInstructions from './PrintInstructions';
 import AutoPaintTab from './AutoPaintTab';
@@ -111,13 +116,20 @@ export default function ThreeDControls({
     const [paintMode, setPaintMode] = useState<'manual' | 'autopaint'>(initialPaintMode);
     const [autoPaintMaxHeight, setAutoPaintMaxHeight] = useState<number | undefined>(undefined);
     const [enhancedColorMatch, setEnhancedColorMatch] = useState(persisted?.enhancedColorMatch ?? false);
-    const [allowRepeatedSwaps, setAllowRepeatedSwaps] = useState(persisted?.allowRepeatedSwaps ?? false);
+    const [maxRepeatedSwaps, setMaxRepeatedSwaps] = useState<AutoPaintRepeatLimit>(
+        persisted?.maxRepeatedSwaps ?? (persisted?.allowRepeatedSwaps ? 4 : 0)
+    );
+    const [transitionOpacity, setTransitionOpacity] = useState<AutoPaintTransitionOpacity>(
+        persisted?.transitionOpacity ?? 0.9
+    );
     const [heightDithering, setHeightDithering] = useState(persisted?.heightDithering ?? false);
     const [ditherLineWidth, setDitherLineWidth] = useState(persisted?.ditherLineWidth ?? 0.42);
     const [flatPaint, setFlatPaint] = useState(initialFlatPaint);
 
     // --- Optimizer Options ---
-    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<'fast' | 'balanced' | 'thorough'>(
+    const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<
+        'fast' | 'balanced' | 'thorough' | 'deep' | 'exact'
+    >(
         persisted?.optimizerAlgorithm ?? 'balanced'
     );
     const [optimizerSeed, setOptimizerSeed] = useState<number | undefined>(
@@ -130,7 +142,6 @@ export default function ThreeDControls({
     const handleEnhancedColorMatchChange = useCallback((v: boolean) => {
         setEnhancedColorMatch(v);
         if (!v) {
-            setAllowRepeatedSwaps(false);
             setHeightDithering(false);
         }
     }, []);
@@ -155,7 +166,8 @@ export default function ThreeDControls({
             paintMode,
             filaments,
             enhancedColorMatch,
-            allowRepeatedSwaps,
+            maxRepeatedSwaps,
+            transitionOpacity,
             heightDithering,
             ditherLineWidth,
             flatPaint,
@@ -165,7 +177,7 @@ export default function ThreeDControls({
             smoothMeshing,
         });
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [paintMode, filaments, enhancedColorMatch, allowRepeatedSwaps, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
+    }, [paintMode, filaments, enhancedColorMatch, maxRepeatedSwaps, transitionOpacity, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
 
     useEffect(() => {
         savePrintSettingsToStorage({ layerHeight, slicerFirstLayerHeight, pixelSize, smoothMeshing });
@@ -213,11 +225,13 @@ export default function ThreeDControls({
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
     });
+    const autoPaintProgressPercent = Math.round(Math.max(0, Math.min(1, autoPaintProgress)) * 100);
 
     const autoPaintSliceData = useMemo(() => {
         if (!autoPaintResult) return undefined;
@@ -310,7 +324,8 @@ export default function ThreeDControls({
                 filaments,
                 paintMode,
                 enhancedColorMatch,
-                allowRepeatedSwaps,
+                maxRepeatedSwaps,
+                transitionOpacity,
                 heightDithering,
                 ditherLineWidth,
                 flatPaint,
@@ -352,7 +367,8 @@ export default function ThreeDControls({
         filaments,
         paintMode,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         heightDithering,
         ditherLineWidth,
         flatPaint,
@@ -378,7 +394,7 @@ export default function ThreeDControls({
                     {isAutoPaintComputing ? (
                         <>
                             <Loader2 className="w-4 h-4 animate-spin" />
-                            <span>Computing...</span>
+                            <span>Computing... {autoPaintProgressPercent}%</span>
                         </>
                     ) : (
                         <>
@@ -462,8 +478,10 @@ export default function ThreeDControls({
                     imageSwatches={filtered}
                     enhancedColorMatch={enhancedColorMatch}
                     setEnhancedColorMatch={handleEnhancedColorMatchChange}
-                    allowRepeatedSwaps={allowRepeatedSwaps}
-                    setAllowRepeatedSwaps={setAllowRepeatedSwaps}
+                    maxRepeatedSwaps={maxRepeatedSwaps}
+                    setMaxRepeatedSwaps={setMaxRepeatedSwaps}
+                    transitionOpacity={transitionOpacity}
+                    setTransitionOpacity={setTransitionOpacity}
                     heightDithering={heightDithering}
                     setHeightDithering={setHeightDithering}
                     ditherLineWidth={ditherLineWidth}
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 656a480..540405d 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -75,11 +75,14 @@ Enable **Enhanced color matching** when filament order matters and you want Krom
 
 Optional controls appear with enhanced matching:
 
-- **Allow repeated filament swaps** lets the same filament appear more than once.
+- **Extra repeated swaps** chooses whether a filament may reappear, and lets you allow 2, 4, 6, 8, or 12 extra occurrences. More repeats can create useful blend paths but expand the search space.
+- **Transition detail** chooses the opacity endpoint for each physical color transition: Compact stops at 80% opacity, Detailed at 90%, and Maximum at 95%. Higher settings create taller stacks with more printable intermediate colors.
 - **Height dithering** uses printable height dots to smooth tonal transitions.
 - **Line width** should roughly match the printer line or nozzle width used for dither dots.
 - **Optimizer Settings** let you choose **Algorithm**, **Region priority**, and an optional **Seed**.
 
+Enhanced matching scores the palette that is already visible in 2D mode; it does not reduce that palette again. For detailed work, prepare the image in 2D first (for example, K-means with a weight of 128 and an Auto palette of 64 or 128 colors), then switch to Auto-paint. This keeps the 2D palette decision explicit, but more source colors make every optimizer tier slower.
+
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
 
 When a filament has been calibrated, Auto-paint uses its measured red, green, and blue TD values for both transition colors and transition thickness. Calibration can therefore change the generated stack height and swap plan as well as the preview color, making the print model more faithful to the measured filament.
@@ -102,16 +105,23 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 
 | Setting         | Meaning                                                      |
 | --------------- | ------------------------------------------------------------ |
-| Algorithm       | Auto, Exhaustive, Simulated Annealing, or Genetic Algorithm. |
+| Algorithm       | Fast, Balanced, Thorough, Deep, or Exact base order.        |
 | Region priority | Uniform, Center-weighted, or Edge-weighted matching.         |
 | Seed (optional) | Overrides the automatic stable seed for an intentional comparison. |
 
-Use **Auto (smart selection)** unless you have a reason to compare algorithms.
-Auto uses exact ordered-subset search through 6 filaments, beam search from 7 to 12,
-then variable-length simulated annealing for larger profiles. With Enhanced color
-matching, Kromacut can omit filaments that do not improve the printable stack. When
-Repeated swaps is enabled, it can also add up to four non-adjacent repeated filament
-occurrences when they improve the blend path.
+Start with **Balanced**. It uses a full deterministic beam search and is the best
+general-purpose choice. **Fast** uses a narrower beam for a quicker preview.
+**Thorough** adds deeper multi-start refinement, while **Deep** widens the beam and
+spends substantially more time exploring alternatives. Each higher tier keeps the
+best result from the tier below for the same seed.
+
+**Exact base order** checks every possible no-repeat filament order. It checks 109,600
+orders at eight filaments and 986,409 at nine, so larger profiles can take a long time.
+The search stays in the background worker and you can start another search to cancel it.
+When **Extra repeated swaps** is above Off, Exact still proves the base order but treats
+repeated occurrences as a separate refined search. Enhanced matching can omit filaments that do
+not improve the printable stack and add the selected number of non-adjacent repeated occurrences
+when they improve the blend path.
 
 **Region priority** changes which source colors the optimizer values most: **Center-weighted** gives more importance to colors that occur near the middle of the image, while **Edge-weighted** favors colors nearer its outer edges. It does not crop or change the image itself.
 
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index 509c897..fb07d8b 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -12,7 +12,12 @@
 
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import type { AutoPaintResult } from '../lib/autoPaint';
-import type { Filament, Swatch } from '../types';
+import type {
+    AutoPaintRepeatLimit,
+    AutoPaintTransitionOpacity,
+    Filament,
+    Swatch,
+} from '../types';
 import type {
     AutoPaintWorkerProgress,
     AutoPaintWorkerRequest,
@@ -27,8 +32,9 @@ export interface UseAutoPaintWorkerOptions {
     slicerFirstLayerHeight: number;
     autoPaintMaxHeight?: number;
     enhancedColorMatch: boolean;
-    allowRepeatedSwaps: boolean;
-    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough';
+    maxRepeatedSwaps: AutoPaintRepeatLimit;
+    transitionOpacity: AutoPaintTransitionOpacity;
+    optimizerAlgorithm: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
     optimizerSeed?: number;
     regionWeightingMode: 'uniform' | 'center' | 'edge';
 }
@@ -69,7 +75,8 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
@@ -238,9 +245,11 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
                     firstLayerHeight: slicerFirstLayerHeight,
                     maxHeight: autoPaintMaxHeight,
                     enhancedColorMatch,
-                    allowRepeatedSwaps,
+                    maxRepeatedSwaps,
                     optimizerOptions: {
                         algorithm: optimizerAlgorithm,
+                        maxExtraRepeats: maxRepeatedSwaps,
+                        transitionOpacity,
                         ...(optimizerSeed !== undefined && { seed: optimizerSeed }),
                     },
                 };
@@ -271,7 +280,8 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
-        allowRepeatedSwaps,
+        maxRepeatedSwaps,
+        transitionOpacity,
         optimizerAlgorithm,
         optimizerSeed,
         regionWeightingMode,
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 59dca1f..78c4b04 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -93,7 +93,7 @@ export interface AutoPaintResult {
     };
     // Optimizer metadata (for advanced optimizer only)
     optimizerMetadata?: {
-        algorithm: string; // resolved: 'exhaustive' | 'beam' | 'simulated-annealing' | 'balanced-hybrid'
+        algorithm: string; // concrete tier path, such as 'beam', 'deep-hybrid', or 'exact-base'
         score: number; // Quality score achieved
         iterations: number; // Iterations performed
         converged: boolean; // Whether algorithm converged
@@ -370,6 +370,24 @@ export function getOpacity(
  */
 const DELTA_E_THRESHOLD = 2.3; // "Just noticeable difference"
 
+/** Legacy compact transition endpoint: 80% opacity. The UI explicitly defaults to Detailed (90%). */
+export const DEFAULT_TRANSITION_OPACITY = 0.8;
+
+function normalizeTransitionOpacity(targetOpacity: number | undefined): number {
+    if (!Number.isFinite(targetOpacity)) return DEFAULT_TRANSITION_OPACITY;
+    return Math.max(0.5, Math.min(0.99, targetOpacity!));
+}
+
+function transitionThicknessMultiplier(targetOpacity: number): number {
+    // Keep the old compact 0.7×TD endpoint byte-for-byte stable. The detailed
+    // and maximum presets deliberately align with the familiar 1×TD and
+    // 1.3×TD (about 95%) optical landmarks.
+    if (Math.abs(targetOpacity - 0.8) < 1e-9) return 0.7;
+    if (Math.abs(targetOpacity - 0.9) < 1e-9) return 1;
+    if (Math.abs(targetOpacity - 0.95) < 1e-9) return 1.3;
+    return -Math.log10(1 - targetOpacity);
+}
+
 /**
  * Frontlit prints behave optically like a much shorter effective TD.
  * Scale user-entered TD values down for internal simulation.
@@ -421,7 +439,8 @@ export function calculateTransitionThickness(
     backgroundColor: RGB,
     filamentColor: RGB,
     filamentTD: number | CalibrationRgb,
-    layerHeight: number
+    layerHeight: number,
+    targetOpacity: number = DEFAULT_TRANSITION_OPACITY
 ): number {
     // Early exit if colors are already close
     if (deltaE(backgroundColor, filamentColor) < DELTA_E_THRESHOLD) {
@@ -436,14 +455,15 @@ export function calculateTransitionThickness(
         return layerHeight;
     }
 
-    // The cap determines the absolute maximum transition thickness.
-    // At 0.7×TD, opacity ≈ 80%. At 1×TD, opacity ≈ 90%.
-    // For transitions between adjacent colors in a sorted stack,
-    // DeltaE convergence typically fires well before this cap.
-    // We use 0.7×TD — if the color hasn't converged by ~80% opacity,
-    // additional thickness gives diminishing visual returns.
-    const OPACITY_CAP = 0.7;
-    const maxThickness = Math.max(layerHeight, Math.max(...channelTds) * OPACITY_CAP);
+    // The requested opacity determines the absolute maximum transition
+    // thickness. Perceptual convergence can still complete the transition
+    // earlier when the blended result is already close to the target color.
+    const resolvedOpacity = normalizeTransitionOpacity(targetOpacity);
+    const opacityThicknessMultiplier = transitionThicknessMultiplier(resolvedOpacity);
+    const maxThickness = Math.max(
+        layerHeight,
+        Math.max(...channelTds) * opacityThicknessMultiplier
+    );
 
     // Simulate adding layers until color converges or we hit the cap
     while (thickness < maxThickness) {
@@ -455,8 +475,9 @@ export function calculateTransitionThickness(
             break;
         }
 
-        // Also stop if opacity is already very high — diminishing returns
-        if (getOpacity(filamentTD, thickness) > 0.85) {
+        // Stop at the selected opacity endpoint when perceptual convergence
+        // has not already completed the transition.
+        if (getOpacity(filamentTD, thickness) >= resolvedOpacity) {
             break;
         }
     }
@@ -481,7 +502,8 @@ export function calculateIdealHeight(
     sortedFilaments: AutoPaintFilament[],
     layerHeight: number,
     baseThickness: number = 0.6,
-    transitionThicknessCache?: Map<string, number>
+    transitionThicknessCache?: Map<string, number>,
+    transitionOpacity: number = DEFAULT_TRANSITION_OPACITY
 ): { idealHeight: number; zones: TransitionZone[] } {
     if (sortedFilaments.length === 0) {
         return { idealHeight: baseThickness, zones: [] };
@@ -533,6 +555,7 @@ export function calculateIdealHeight(
                     : transitionTd
             ),
             layerHeight,
+            transitionOpacity,
         ].join(':');
         let transitionThickness = transitionThicknessCache?.get(transitionKey);
         if (transitionThickness === undefined) {
@@ -540,7 +563,8 @@ export function calculateIdealHeight(
                 currentBackgroundColor,
                 filamentRgb,
                 transitionTd,
-                layerHeight
+                layerHeight,
+                transitionOpacity
             );
             transitionThicknessCache?.set(transitionKey, transitionThickness);
         }
@@ -964,6 +988,7 @@ export function buildAchievableColorPalette(
     layerHeight: number,
     firstLayerHeight: number,
     maxHeight?: number,
+    transitionOpacity: number = DEFAULT_TRANSITION_OPACITY,
     transitionThicknessCache?: Map<string, number>
 ): Array<{ height: number; lab: Lab; rgb: RGB }> {
     if (sequence.length === 0) return [];
@@ -973,7 +998,8 @@ export function buildAchievableColorPalette(
         sequence,
         layerHeight,
         Math.max(firstLayerHeight, layerHeight),
-        transitionThicknessCache
+        transitionThicknessCache,
+        transitionOpacity
     );
 
     if (zones.length === 0) return [];
@@ -1100,6 +1126,10 @@ export function weightedErrorPercentile(
 const REALIZED_ERROR_TAIL_WEIGHT = 0.5;
 /** Percentile used for the realized-error tail term. */
 const REALIZED_ERROR_TAIL_PERCENTILE = 0.95;
+/** Detail coverage: targets within this realized error are treated as retained. */
+const DETAIL_COVERAGE_DE = 6;
+/** Prefer stacks that retain more weighted source-color detail. */
+const DETAIL_COVERAGE_PENALTY = 8;
 /** A printable palette entry counts as "used" if a target lands within this ΔE00. */
 const USEFUL_PALETTE_MATCH_DE = 8;
 
@@ -1138,6 +1168,7 @@ export function scoreSequenceAgainstImage(
     const errorSamples: Array<{ value: number; weight: number }> = [];
     const bestMatchHeights: number[] = [];
     const usedPaletteEntries = new Set<number>();
+    let detailCoveredWeight = 0;
 
     for (const entry of mapped) {
         const realizedDeltaE = realizedColorError(entry.mappedLab, entry.target);
@@ -1146,6 +1177,7 @@ export function scoreSequenceAgainstImage(
         totalWeight += weight;
         errorSamples.push({ value: realizedDeltaE, weight });
         bestMatchHeights.push(entry.projectedHeight);
+        if (realizedDeltaE <= DETAIL_COVERAGE_DE) detailCoveredWeight += weight;
         // Mark this palette entry as useful if its printable color is a decent match.
         if (realizedDeltaE < USEFUL_PALETTE_MATCH_DE) usedPaletteEntries.add(entry.paletteIndex);
     }
@@ -1155,6 +1187,7 @@ export function scoreSequenceAgainstImage(
     const weightedMean = weightedErrorSum / totalWeight;
     const weightedTail = weightedErrorPercentile(errorSamples, REALIZED_ERROR_TAIL_PERCENTILE);
     let score = weightedMean + REALIZED_ERROR_TAIL_WEIGHT * weightedTail;
+    score += (1 - detailCoveredWeight / totalWeight) * DETAIL_COVERAGE_PENALTY;
 
     // 2. Height spread penalty: penalize when distinct image colors
     //    collapse to the same height (leading to flat surfaces).
@@ -1220,6 +1253,26 @@ function findBestFilamentOrder(
 /**
  * Advanced optimizer path using the shared variable-length sequence search.
  */
+/**
+ * Convert the already-processed 2D palette into weighted optimizer targets
+ * without applying another palette-reduction pass.
+ */
+export function buildOptimizerImageTargets(
+    imageSwatches: Array<{ hex: string; count?: number }>
+): WeightedLab[] {
+    const totalWeight = imageSwatches.reduce(
+        (total, swatch) => total + Math.max(0, swatch.count ?? 1),
+        0
+    );
+
+    return imageSwatches
+        .map((swatch) => ({
+            ...rgbToLab(hexToRgb(swatch.hex)),
+            weight: Math.max(0, swatch.count ?? 1) / Math.max(1, totalWeight),
+        }))
+        .filter((target) => target.weight > 0);
+}
+
 function findBestFilamentOrderWithOptimizer(
     filaments: Filament[],
     imageSwatches: Array<{ hex: string; count?: number }>,
@@ -1229,8 +1282,7 @@ function findBestFilamentOrderWithOptimizer(
     maxHeight?: number,
     allowRepeatedSwaps: boolean = false
 ): { sortedFilaments: Filament[]; result: OptimizerResult } {
-    // Spatial weighting has already been folded into swatch counts by the caller.
-    const imageTargets = clusterImageColors(imageSwatches, 32, 5.0);
+    const imageTargets = buildOptimizerImageTargets(imageSwatches);
 
     // Build scoring context
     const context: ScoringContext = {
@@ -1238,6 +1290,7 @@ function findBestFilamentOrderWithOptimizer(
         layerHeight,
         firstLayerHeight,
         maxHeight,
+        transitionOpacity: optimizerOptions.transitionOpacity,
     };
 
     // Apply frontlit TD scale
@@ -1362,7 +1415,9 @@ export function generateAutoLayers(
     const { idealHeight, zones } = calculateIdealHeight(
         scaledFilaments,
         layerHeight,
-        Math.max(firstLayerHeight, layerHeight)
+        Math.max(firstLayerHeight, layerHeight),
+        undefined,
+        optimizerOptions?.transitionOpacity
     );
 
     // --- STEP 4: APPLY COMPRESSION ON THE PRINTABLE HEIGHT GRID ---
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index f43bbc4..627d8fe 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -22,7 +22,7 @@ import {
 // ============================================================================
 
 /** User-facing optimizer effort tiers (persisted and shown in the UI). */
-export type OptimizerTier = 'fast' | 'balanced' | 'thorough';
+export type OptimizerTier = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 
 /**
  * Values the optimizer accepts: the user-facing tiers plus explicit concrete
@@ -40,13 +40,16 @@ export function normalizeOptimizerTier(value: string | undefined | null): Optimi
         case 'fast':
         case 'balanced':
         case 'thorough':
+        case 'deep':
+        case 'exact':
             return value;
-        case 'exhaustive': // explicit exact search → closest tier is Thorough
+        case 'exhaustive': // explicit exact search → Exact base order
+            return 'exact';
         case 'genetic': // legacy "max effort" option
-            return 'thorough';
+            return 'deep';
         case 'beam':
-            return 'fast';
-        // 'auto', 'simulated-annealing', anything unknown → the smart default
+            return 'balanced';
+        // 'auto', 'simulated-annealing', anything unknown → the recommended default
         default:
             return 'balanced';
     }
@@ -54,7 +57,12 @@ export function normalizeOptimizerTier(value: string | undefined | null): Optimi
 
 export interface OptimizerOptions {
     algorithm: OptimizerAlgorithm;
+    /** Legacy compatibility flag; new callers should set maxExtraRepeats. */
     allowRepeatedSwaps?: boolean;
+    /** Maximum extra non-adjacent filament occurrences (0–12). */
+    maxExtraRepeats?: number;
+    /** Transition opacity target used by the shared printable-palette scorer. */
+    transitionOpacity?: number;
     seed?: number; // For deterministic results
     maxIterations?: number; // Algorithm-specific iteration limit
     temperature?: number; // Initial temperature for SA
@@ -81,6 +89,7 @@ export interface ScoringContext {
     layerHeight: number;
     firstLayerHeight: number;
     maxHeight?: number;
+    transitionOpacity?: number;
 }
 
 // ============================================================================
@@ -156,6 +165,8 @@ const globalCache = new OptimizerCache();
 function tuningFingerprint(options: OptimizerOptions) {
     return {
         allowRepeatedSwaps: options.allowRepeatedSwaps ?? false,
+        maxExtraRepeats: options.maxExtraRepeats ?? null,
+        transitionOpacity: options.transitionOpacity ?? null,
         maxIterations: options.maxIterations ?? null,
         temperature: options.temperature ?? null,
         coolingRate: options.coolingRate ?? null,
@@ -189,6 +200,7 @@ function canonicalOptimizerInput(
         layerHeight: context.layerHeight,
         firstLayerHeight: context.firstLayerHeight,
         maxHeight: context.maxHeight ?? null,
+        transitionOpacity: context.transitionOpacity ?? null,
         algorithm,
         seed: seed ?? null,
         tuning: tuningFingerprint(options),
@@ -225,6 +237,7 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
                 context.layerHeight,
                 context.firstLayerHeight,
                 context.maxHeight,
+                context.transitionOpacity,
                 transitionThicknessCache
             );
             paletteCache.set(sequenceKey, palette);
@@ -241,28 +254,51 @@ export function scoreFilamentSequence(filaments: Filament[], context: ScoringCon
 // Variable-length sequence helpers
 // ============================================================================
 
-const MAX_AUTO_EXHAUSTIVE_FILAMENTS = 6;
-const AUTO_BEAM_MAX_FILAMENTS = 12;
-const MAX_EXTRA_REPEATS = 4;
-const DEFAULT_BEAM_WIDTH = 100;
+const MAX_EXTRA_REPEATS = 12;
+const LEGACY_EXTRA_REPEATS = 4;
+const FAST_BEAM_WIDTH = 25;
+const BALANCED_BEAM_WIDTH = 100;
+const THOROUGH_BEAM_WIDTH = 100;
+const DEEP_BEAM_WIDTH = 250;
 
 type SequenceScorer = (filaments: Filament[]) => number;
 type ResolvedOptimizerAlgorithm =
     | 'exhaustive'
     | 'beam'
     | 'simulated-annealing'
-    | 'balanced-hybrid';
+    | 'narrow-beam'
+    | 'thorough-hybrid'
+    | 'deep-hybrid'
+    | 'exact-base';
 
 const SA_MIN_TEMPERATURE = 0.01;
 const SA_INITIAL_TEMPERATURE = 10.0;
 const SA_DEFAULT_COOLING_RATE = 0.995;
-// The balanced/thorough multi-start refines around good seeds, so it anneals at
-// a lower temperature scaled to the CIEDE2000 objective (scores ~5–30), where
+// The hybrid tiers refine around good seeds at a temperature scaled to the
+// CIEDE2000 objective (scores ~5–30), where
 // the legacy SA temperature of 10 would just wander away from the seed.
 const SA_HYBRID_TEMPERATURE = 2.0;
-// Thorough seeds the hybrid with the exact no-repeat optimum when the ordered
-// subset space is small enough to enumerate quickly (≈7 filaments → 13,699).
-const THOROUGH_EXACT_SUBSET_LIMIT = 20000;
+
+interface HybridSearchPlan {
+    beamWidth: number;
+    restarts: number;
+    minimumIterationsPerRestart: number;
+    iterationsPerFilament: number;
+}
+
+const THOROUGH_PLAN: HybridSearchPlan = {
+    beamWidth: THOROUGH_BEAM_WIDTH,
+    restarts: 12,
+    minimumIterationsPerRestart: 1_500,
+    iterationsPerFilament: 250,
+};
+
+const DEEP_PLAN: HybridSearchPlan = {
+    beamWidth: DEEP_BEAM_WIDTH,
+    restarts: 32,
+    minimumIterationsPerRestart: 4_000,
+    iterationsPerFilament: 500,
+};
 
 interface ScoredSequence {
     order: Filament[];
@@ -289,8 +325,15 @@ function isValidSequence(sequence: Filament[], allowRepeatedSwaps: boolean): boo
     );
 }
 
-function maxSequenceLength(filaments: Filament[], allowRepeatedSwaps: boolean): number {
-    return filaments.length + (allowRepeatedSwaps ? MAX_EXTRA_REPEATS : 0);
+function resolveMaxExtraRepeats(options: OptimizerOptions): number {
+    if (Number.isFinite(options.maxExtraRepeats)) {
+        return Math.max(0, Math.min(MAX_EXTRA_REPEATS, Math.floor(options.maxExtraRepeats!)));
+    }
+    return options.allowRepeatedSwaps ? LEGACY_EXTRA_REPEATS : 0;
+}
+
+function maxSequenceLength(filaments: Filament[], maxExtraRepeats: number): number {
+    return filaments.length + maxExtraRepeats;
 }
 
 function isBetterCandidate(
@@ -311,6 +354,22 @@ function reportProgress(
     options.onProgress?.(Math.min(iteration, total), Math.max(total, 1), bestScore);
 }
 
+function withProgressSpan(
+    options: OptimizerOptions,
+    start: number,
+    end: number
+): OptimizerOptions {
+    if (!options.onProgress) return { ...options, onProgress: undefined };
+
+    return {
+        ...options,
+        onProgress: (iteration, total, bestScore) => {
+            const phaseProgress = total > 0 ? Math.min(1, Math.max(0, iteration / total)) : 1;
+            options.onProgress?.(start + (end - start) * phaseProgress, 1, bestScore);
+        },
+    };
+}
+
 function orderedSubsetCount(filamentCount: number): number {
     let total = 0;
     let permutations = 1;
@@ -321,9 +380,14 @@ function orderedSubsetCount(filamentCount: number): number {
     return total;
 }
 
-function repeatedInsertionUpperBound(filamentCount: number): number {
+/** Number of no-repeat base sequences an Exact search would evaluate. */
+export function getExactBaseOrderCount(filamentCount: number): number {
+    return filamentCount > 0 ? orderedSubsetCount(filamentCount) : 0;
+}
+
+function repeatedInsertionUpperBound(filamentCount: number, maxExtraRepeats: number): number {
     let total = 0;
-    for (let extra = 0; extra < MAX_EXTRA_REPEATS; extra++) {
+    for (let extra = 0; extra < maxExtraRepeats; extra++) {
         total += filamentCount * (filamentCount + extra + 1);
     }
     return total;
@@ -332,9 +396,10 @@ function repeatedInsertionUpperBound(filamentCount: number): number {
 function expandWithRepeatedFilaments(
     initial: ScoredSequence,
     filaments: Filament[],
-    scoreSequence: SequenceScorer
+    scoreSequence: SequenceScorer,
+    maxExtraRepeats: number
 ): { best: ScoredSequence; iterations: number } {
-    const maxLength = maxSequenceLength(filaments, true);
+    const maxLength = maxSequenceLength(filaments, maxExtraRepeats);
     let best = initial;
     let iterations = 0;
 
@@ -384,10 +449,11 @@ function optimizeExhaustive(
         };
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
     const totalIterations =
         orderedSubsetCount(filaments.length) +
-        (allowRepeatedSwaps ? repeatedInsertionUpperBound(filaments.length) : 0);
+        (allowRepeatedSwaps ? repeatedInsertionUpperBound(filaments.length, maxExtraRepeats) : 0);
     let best: ScoredSequence | null = null;
     let iterations = 0;
     reportProgress(options, 0, totalIterations, Infinity);
@@ -420,7 +486,12 @@ function optimizeExhaustive(
         };
     }
 
-    const expanded = expandWithRepeatedFilaments(baseBest, filaments, scoreSequence);
+    const expanded = expandWithRepeatedFilaments(
+        baseBest,
+        filaments,
+        scoreSequence,
+        maxExtraRepeats
+    );
     return {
         order: expanded.best.order,
         score: expanded.best.score,
@@ -442,9 +513,10 @@ function optimizeBeamSearch(
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
-    const beamWidth = options.beamWidth ?? DEFAULT_BEAM_WIDTH;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
+    const beamWidth = options.beamWidth ?? BALANCED_BEAM_WIDTH;
     const totalIterations =
         filaments.length + (maximumLength - 1) * beamWidth * filaments.length;
     let iterations = 0;
@@ -520,11 +592,11 @@ function optimizeBeamSearch(
  */
 function randomInitialSequence(
     filaments: Filament[],
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom
 ): Filament[] {
     const shuffled = rng.shuffle(filaments);
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
     const initialLength = rng.nextInt(1, Math.min(filaments.length, maximumLength) + 1);
     return shuffled.slice(0, initialLength);
 }
@@ -539,10 +611,11 @@ function sequenceEquals(left: Filament[], right: Filament[]): boolean {
 function buildVariableLengthNeighbor(
     sequence: Filament[],
     filaments: Filament[],
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom
 ): Filament[] {
-    const maximumLength = maxSequenceLength(filaments, allowRepeatedSwaps);
+    const allowRepeatedSwaps = maxExtraRepeats > 0;
+    const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
     const availableMoves: Array<'swap' | 'relocate' | 'insert' | 'remove' | 'replace'> = [];
 
     if (sequence.length > 1) {
@@ -610,7 +683,7 @@ function runAnneal(
     initialOrder: Filament[],
     filaments: Filament[],
     scoreSequence: SequenceScorer,
-    allowRepeatedSwaps: boolean,
+    maxExtraRepeats: number,
     rng: SeededRandom,
     maxIterations: number,
     initialTemperature: number,
@@ -629,7 +702,7 @@ function runAnneal(
         const newOrder = buildVariableLengthNeighbor(
             currentOrder,
             filaments,
-            allowRepeatedSwaps,
+            maxExtraRepeats,
             rng
         );
         if (sequenceEquals(newOrder, currentOrder)) {
@@ -669,13 +742,13 @@ function optimizeSimulatedAnnealing(
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
     const rng = new SeededRandom(options.seed);
     const maxIterations = options.maxIterations ?? Math.max(1000, filaments.length * 100);
     const initialTemp = options.temperature ?? SA_INITIAL_TEMPERATURE;
     const coolingRate = options.coolingRate ?? SA_DEFAULT_COOLING_RATE;
 
-    const initialOrder = randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+    const initialOrder = randomInitialSequence(filaments, maxExtraRepeats, rng);
     reportProgress(options, 0, maxIterations, scoreSequence(initialOrder));
 
     let reported = 0;
@@ -683,7 +756,7 @@ function optimizeSimulatedAnnealing(
         initialOrder,
         filaments,
         scoreSequence,
-        allowRepeatedSwaps,
+        maxExtraRepeats,
         rng,
         maxIterations,
         initialTemp,
@@ -703,29 +776,26 @@ function optimizeSimulatedAnnealing(
 }
 
 /**
- * Balanced / Thorough hybrid: take beam search's deterministic best as a seed,
- * then run several deterministic annealing restarts (the first refines the beam
- * seed, the rest explore seeded-random starts) and keep the global best.
- *
- * The budget is a fixed iteration count, not a wall-clock deadline, so results
- * stay reproducible across machines (goldens, caching, A/B seeds depend on it).
+ * Refine a deterministic beam result with seeded multi-start annealing. A
+ * supplied baseline is retained throughout, so a deeper tier can never return
+ * a worse result than the tier it extends.
  */
-function optimizeBalanced(
+function optimizeHybrid(
     filaments: Filament[],
     scoreSequence: SequenceScorer,
     options: OptimizerOptions,
-    thorough: boolean
+    plan: HybridSearchPlan,
+    baseline?: OptimizerResult
 ): OptimizerResult {
     if (filaments.length <= 1) {
         return optimizeExhaustive(filaments, scoreSequence, options);
     }
 
-    const allowRepeatedSwaps = options.allowRepeatedSwaps ?? false;
+    const maxExtraRepeats = resolveMaxExtraRepeats(options);
     const rng = new SeededRandom(options.seed);
-    const restarts = thorough ? 12 : 5;
     const iterationsPerRestart =
         options.maxIterations ??
-        Math.max(thorough ? 1500 : 600, filaments.length * (thorough ? 250 : 120));
+        Math.max(plan.minimumIterationsPerRestart, filaments.length * plan.iterationsPerFilament);
     const initialTemp = options.temperature ?? SA_HYBRID_TEMPERATURE;
     // Cool from the initial temperature to the floor across one restart so each
     // restart spends its whole budget refining instead of freezing early.
@@ -733,38 +803,37 @@ function optimizeBalanced(
         options.coolingRate ??
         Math.pow(SA_MIN_TEMPERATURE / initialTemp, 1 / Math.max(1, iterationsPerRestart));
 
-    // 1. Seeds. Beam is always cheap and strong. Thorough additionally enumerates
-    //    the exact no-repeat optimum when the subset space is small enough, then
-    //    lets the hybrid explore repeats around it — so Thorough ≥ exact ≥ beam.
-    const beam = optimizeBeamSearch(filaments, scoreSequence, { ...options, onProgress: undefined });
+    // Beam provides a strong deterministic seed before the broader local search.
+    const beam = optimizeBeamSearch(filaments, scoreSequence, {
+        ...options,
+        beamWidth: options.beamWidth ?? plan.beamWidth,
+        onProgress: undefined,
+    });
     let best: ScoredSequence = { order: beam.order, score: beam.score };
     let iterations = beam.iterations;
 
-    if (thorough && orderedSubsetCount(filaments.length) <= THOROUGH_EXACT_SUBSET_LIMIT) {
-        const exact = optimizeExhaustive(filaments, scoreSequence, { ...options, onProgress: undefined });
-        iterations += exact.iterations;
-        if (isBetterCandidate({ order: exact.order, score: exact.score }, best)) {
-            best = { order: exact.order, score: exact.score };
-        }
+    if (baseline && isBetterCandidate({ order: baseline.order, score: baseline.score }, best)) {
+        best = { order: baseline.order, score: baseline.score };
     }
+    iterations += baseline?.iterations ?? 0;
 
-    const total = iterations + restarts * iterationsPerRestart;
+    const total = iterations + plan.restarts * iterationsPerRestart;
     let reported = iterations;
     reportProgress(options, reported, total, best.score);
 
-    // 2. Multi-start annealing: restart 0 refines the best seed; the rest explore
-    //    seeded-random starts. Keep the global best across all restarts.
-    for (let restart = 0; restart < restarts; restart++) {
+    // Restart 0 refines the strongest retained candidate; the rest explore
+    // seeded-random starts. Keep the global best across all restarts.
+    for (let restart = 0; restart < plan.restarts; restart++) {
         const initialOrder =
             restart === 0
                 ? best.order
-                : randomInitialSequence(filaments, allowRepeatedSwaps, rng);
+                : randomInitialSequence(filaments, maxExtraRepeats, rng);
 
         const outcome = runAnneal(
             initialOrder,
             filaments,
             scoreSequence,
-            allowRepeatedSwaps,
+            maxExtraRepeats,
             rng,
             iterationsPerRestart,
             initialTemp,
@@ -789,30 +858,84 @@ function optimizeBalanced(
     };
 }
 
+/** Deep is Thorough plus a wider, much larger hybrid pass. */
+function optimizeDeep(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    const thorough = optimizeHybrid(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0, 0.2),
+        THOROUGH_PLAN
+    );
+    return optimizeHybrid(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0.2, 1),
+        DEEP_PLAN,
+        thorough
+    );
+}
+
+/**
+ * Exact base-order search. Repeated swaps remain a separate larger space, so
+ * when they are enabled retain Deep's repeat-aware result alongside exact base
+ * enumeration and its greedy repeat refinement.
+ */
+function optimizeExactBase(
+    filaments: Filament[],
+    scoreSequence: SequenceScorer,
+    options: OptimizerOptions
+): OptimizerResult {
+    if (resolveMaxExtraRepeats(options) === 0) {
+        return optimizeExhaustive(filaments, scoreSequence, options);
+    }
+
+    const deep = optimizeDeep(filaments, scoreSequence, withProgressSpan(options, 0, 0.4));
+    const exact = optimizeExhaustive(
+        filaments,
+        scoreSequence,
+        withProgressSpan(options, 0.4, 1)
+    );
+    const exactCandidate = { order: exact.order, score: exact.score };
+    const deepCandidate = { order: deep.order, score: deep.score };
+    const best = isBetterCandidate(deepCandidate, exactCandidate) ? deepCandidate : exactCandidate;
+
+    return {
+        order: best.order,
+        score: best.score,
+        iterations: deep.iterations + exact.iterations,
+        converged: true,
+    };
+}
+
 function resolveAlgorithm(
     requested: OptimizerAlgorithm,
     filamentCount: number
 ): ResolvedOptimizerAlgorithm {
+    if (filamentCount <= 1) return 'exhaustive';
+
     switch (requested) {
         // Explicit concrete searches pass through unchanged.
         case 'exhaustive':
         case 'beam':
         case 'simulated-annealing':
             return requested;
-        // Fast: exact when cheap, else the deterministic beam baseline.
+        // Fast uses a deliberately narrow beam for rapid previews.
         case 'fast':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            if (filamentCount <= AUTO_BEAM_MAX_FILAMENTS) return 'beam';
-            return 'simulated-annealing';
-        // Balanced (default): exact for tiny profiles, beam-seeded multi-start otherwise.
+            return 'narrow-beam';
+        // Balanced is the full deterministic beam baseline.
         case 'balanced':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            return 'balanced-hybrid';
-        // Thorough: exact for tiny profiles, otherwise an exact-seeded larger
-        // hybrid (the hybrid itself enumerates when feasible — see optimizeBalanced).
+            return 'beam';
+        // Thorough and Deep are progressively broader deterministic hybrids.
         case 'thorough':
-            if (filamentCount <= MAX_AUTO_EXHAUSTIVE_FILAMENTS) return 'exhaustive';
-            return 'balanced-hybrid';
+            return 'thorough-hybrid';
+        case 'deep':
+            return 'deep-hybrid';
+        case 'exact':
+            return 'exact-base';
     }
 }
 
@@ -840,12 +963,11 @@ export function optimizeFilamentOrder(
     };
 
     const resolved = resolveAlgorithm(opts.algorithm, filaments.length);
-    const thorough = opts.algorithm === 'thorough';
 
-    // Key on the requested tier, not the resolved concrete: 'balanced' and
-    // 'thorough' both resolve to 'balanced-hybrid' but run different budgets and
-    // must not share a cache entry or default seed.
-    const defaultSeedInput = canonicalOptimizerInput(filaments, context, opts.algorithm, opts);
+    // Tiers share the same automatic seed so higher effort builds directly on
+    // comparable deterministic search paths. The cache key still includes the
+    // requested tier because their budgets and outputs can differ.
+    const defaultSeedInput = canonicalOptimizerInput(filaments, context, 'tier-comparison', opts);
     const seed = opts.seed ?? stableHash32(defaultSeedInput);
     opts.seed = seed;
     const cacheKey = canonicalOptimizerInput(filaments, context, opts.algorithm, opts, seed);
@@ -871,8 +993,20 @@ export function optimizeFilamentOrder(
         case 'simulated-annealing':
             result = optimizeSimulatedAnnealing(filaments, scoreSequence, opts);
             break;
-        case 'balanced-hybrid':
-            result = optimizeBalanced(filaments, scoreSequence, opts, thorough);
+        case 'narrow-beam':
+            result = optimizeBeamSearch(filaments, scoreSequence, {
+                ...opts,
+                beamWidth: opts.beamWidth ?? FAST_BEAM_WIDTH,
+            });
+            break;
+        case 'thorough-hybrid':
+            result = optimizeHybrid(filaments, scoreSequence, opts, THOROUGH_PLAN);
+            break;
+        case 'deep-hybrid':
+            result = optimizeDeep(filaments, scoreSequence, opts);
+            break;
+        case 'exact-base':
+            result = optimizeExactBase(filaments, scoreSequence, opts);
             break;
     }
 
diff --git a/src/types/index.ts b/src/types/index.ts
index 4ceb954..99cac53 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -1,6 +1,12 @@
 import type { AutoPaintResult } from '../lib/autoPaint';
 import type { CalibrationResult } from '../lib/calibration';
 
+export const AUTO_PAINT_REPEAT_LIMITS = [0, 2, 4, 6, 8, 12] as const;
+export type AutoPaintRepeatLimit = (typeof AUTO_PAINT_REPEAT_LIMITS)[number];
+
+export const AUTO_PAINT_TRANSITION_OPACITIES = [0.8, 0.9, 0.95] as const;
+export type AutoPaintTransitionOpacity = (typeof AUTO_PAINT_TRANSITION_OPACITIES)[number];
+
 export type Swatch = {
     hex: string;
     a: number;
@@ -43,13 +49,18 @@ export interface ThreeDControlsStateShape {
     paintMode: 'manual' | 'autopaint';
     // Enhanced color matching options
     enhancedColorMatch?: boolean;
+    /** Legacy persisted value. Migrate to maxRepeatedSwaps when loading. */
     allowRepeatedSwaps?: boolean;
+    /** Maximum extra non-adjacent filament occurrences the optimizer may add. */
+    maxRepeatedSwaps?: AutoPaintRepeatLimit;
+    /** Target transition opacity used to create the printable color ramp. */
+    transitionOpacity?: AutoPaintTransitionOpacity;
     heightDithering?: boolean;
     ditherLineWidth?: number;
     /** Flat Paint: build a flat, face-down slab (auto-paint only) */
     flatPaint?: boolean;
     // Optimizer options (effort tier; legacy values migrate on load)
-    optimizerAlgorithm?: 'fast' | 'balanced' | 'thorough';
+    optimizerAlgorithm?: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
     optimizerSeed?: number;
     regionWeightingMode?: 'uniform' | 'center' | 'edge';
     // Auto-paint computed state (only used when paintMode is 'autopaint')
diff --git a/src/workers/autoPaint.worker.ts b/src/workers/autoPaint.worker.ts
index 165c5bf..2f2c142 100644
--- a/src/workers/autoPaint.worker.ts
+++ b/src/workers/autoPaint.worker.ts
@@ -7,7 +7,7 @@
  */
 
 import { generateAutoLayers } from '../lib/autoPaint';
-import type { Filament } from '../types';
+import type { AutoPaintRepeatLimit, Filament } from '../types';
 import type { OptimizerOptions } from '../lib/optimizer';
 import type { AutoPaintResult } from '../lib/autoPaint';
 
@@ -21,7 +21,7 @@ export interface AutoPaintWorkerRequest {
     firstLayerHeight: number;
     maxHeight?: number;
     enhancedColorMatch?: boolean;
-    allowRepeatedSwaps?: boolean;
+    maxRepeatedSwaps?: AutoPaintRepeatLimit;
     optimizerOptions?: Partial<WorkerOptimizerOptions>;
 }
 
@@ -74,7 +74,7 @@ self.onmessage = (e: MessageEvent<AutoPaintWorkerRequest>) => {
             req.firstLayerHeight,
             req.maxHeight,
             req.enhancedColorMatch,
-            req.allowRepeatedSwaps,
+            (req.maxRepeatedSwaps ?? 0) > 0,
             {
                 ...req.optimizerOptions,
                 onProgress: reportProgress,
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 87b554f..914f056 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -321,42 +321,74 @@
   },
   "GH#27 / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "xud8mzr",
       "plvjtmc",
       "h8zuocq",
-      "y202l1e"
+      "y202l1e",
+      "plvjtmc",
+      "y202l1e",
+      "xud8mzr",
+      "y202l1e",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.56
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
+      {
+        "filamentId": "h8zuocq",
+        "startHeight": 0.16,
+        "endHeight": 0.48,
+        "idealThickness": 0.245,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.48,
+        "endHeight": 0.8,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 0.56,
-        "endHeight": 0.64,
+        "startHeight": 0.8,
+        "endHeight": 0.88,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.64,
-        "endHeight": 0.88,
-        "idealThickness": 0.245,
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 1.2,
+        "endHeight": 1.44,
+        "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 0.88,
-        "endHeight": 1.2,
+        "startHeight": 1.44,
+        "endHeight": 1.76,
         "idealThickness": 0.329,
         "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.76,
+        "endHeight": 1.84,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 1.2,
+    "totalHeight": 1.84,
     "compressionRatio": 1
   },
   "GH#27 / large-jpeg / enhanced=false / repeats=false": {
@@ -443,8 +475,8 @@
     "filamentOrder": [
       "plvjtmc",
       "h8zuocq",
-      "xud8mzr",
-      "y202l1e"
+      "y202l1e",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
@@ -462,18 +494,18 @@
         "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "y202l1e",
         "startHeight": 0.48,
-        "endHeight": 0.72,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.8,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "y202l1e",
-        "startHeight": 0.72,
+        "filamentId": "xud8mzr",
+        "startHeight": 0.8,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
       }
     ],
     "totalHeight": 1.04,
@@ -481,74 +513,74 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "h8zuocq",
-      "plvjtmc",
       "xud8mzr",
       "h8zuocq",
       "plvjtmc",
+      "y202l1e",
+      "plvjtmc",
       "h8zuocq",
-      "xud8mzr",
-      "y202l1e"
+      "plvjtmc",
+      "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "xud8mzr",
         "startHeight": 0,
-        "endHeight": 0.48,
-        "idealThickness": 0.45500000000000007,
-        "actualThickness": 0.48
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.48,
         "endHeight": 0.56,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.4810000000000001,
+        "actualThickness": 0.56
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "h8zuocq",
         "startHeight": 0.56,
         "endHeight": 0.8,
-        "idealThickness": 0.259,
+        "idealThickness": 0.24,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "plvjtmc",
         "startHeight": 0.8,
-        "endHeight": 1.04,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "y202l1e",
+        "startHeight": 0.88,
+        "endHeight": 1.2,
+        "idealThickness": 0.329,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
+        "startHeight": 1.2,
+        "endHeight": 1.28,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
         "filamentId": "h8zuocq",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
+        "startHeight": 1.28,
+        "endHeight": 1.52,
         "idealThickness": 0.245,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 1.36,
+        "filamentId": "plvjtmc",
+        "startHeight": 1.52,
         "endHeight": 1.6,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 1.6,
-        "endHeight": 2,
-        "idealThickness": 0.329,
-        "actualThickness": 0.4
+        "endHeight": 1.84,
+        "idealThickness": 0.259,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2,
+    "totalHeight": 1.84,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -697,104 +729,105 @@
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "98z555k",
-      "vsn9q6u",
       "plvjtmc",
+      "98z555k",
+      "upcjpfe",
       "azwg1yp",
       "xyyxysq",
-      "upcjpfe",
-      "w8cncoa"
+      "w8cncoa",
+      "p9c63ms",
+      "vsn9q6u"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.56,
-        "endHeight": 0.8,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "filamentId": "98z555k",
+        "startHeight": 0.16,
+        "endHeight": 0.48,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.8,
-        "endHeight": 0.88,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "upcjpfe",
+        "startHeight": 0.48,
+        "endHeight": 0.8,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.88,
-        "endHeight": 1.12,
+        "startHeight": 0.8,
+        "endHeight": 1.04,
         "idealThickness": 0.19599999999999998,
         "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
+        "startHeight": 1.04,
+        "endHeight": 1.36,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.76,
-        "endHeight": 2.24,
+        "startHeight": 1.36,
+        "endHeight": 1.84,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.84,
+        "endHeight": 2.24,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.24,
+        "endHeight": 2.48,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2.24,
+    "totalHeight": 2.48,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "98z555k",
       "vsn9q6u",
-      "plvjtmc",
-      "azwg1yp",
       "upcjpfe",
-      "vsn9q6u",
       "azwg1yp",
       "xyyxysq",
       "upcjpfe",
       "w8cncoa",
       "vsn9q6u",
-      "98z555k",
-      "vsn9q6u"
+      "plvjtmc",
+      "azwg1yp",
+      "upcjpfe",
+      "azwg1yp"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "98z555k",
         "startHeight": 0,
         "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
+        "idealThickness": 0.507,
         "actualThickness": 0.56
       },
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "vsn9q6u",
         "startHeight": 0.56,
-        "endHeight": 0.64,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "azwg1yp",
-        "startHeight": 0.64,
         "endHeight": 0.8,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
@@ -803,61 +836,68 @@
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.44,
-        "endHeight": 1.6,
+        "startHeight": 1.12,
+        "endHeight": 1.36,
         "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.6,
-        "endHeight": 2,
+        "startHeight": 1.36,
+        "endHeight": 1.68,
         "idealThickness": 0.357,
-        "actualThickness": 0.4
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2,
-        "endHeight": 2.32,
+        "startHeight": 1.68,
+        "endHeight": 2.08,
         "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "actualThickness": 0.4
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 2.32,
-        "endHeight": 2.72,
+        "startHeight": 2.08,
+        "endHeight": 2.48,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
+        "startHeight": 2.48,
+        "endHeight": 2.72,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "plvjtmc",
         "startHeight": 2.72,
+        "endHeight": 2.8,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "azwg1yp",
+        "startHeight": 2.8,
         "endHeight": 3.04,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "98z555k",
+        "filamentId": "upcjpfe",
         "startHeight": 3.04,
-        "endHeight": 3.28,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "endHeight": 3.36,
+        "idealThickness": 0.343,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 3.28,
+        "filamentId": "azwg1yp",
+        "startHeight": 3.36,
         "endHeight": 3.6,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.24
       }
     ],
     "totalHeight": 3.6,
@@ -1010,12 +1050,12 @@
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
       "w8cncoa",
-      "p9c63ms",
-      "xyyxysq",
-      "vsn9q6u",
+      "azwg1yp",
       "plvjtmc",
-      "98z555k",
-      "upcjpfe"
+      "vsn9q6u",
+      "xyyxysq",
+      "upcjpfe",
+      "98z555k"
     ],
     "transitionZones": [
       {
@@ -1026,145 +1066,153 @@
         "actualThickness": 0.88
       },
       {
-        "filamentId": "p9c63ms",
+        "filamentId": "azwg1yp",
         "startHeight": 0.88,
-        "endHeight": 1.28,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "endHeight": 1.04,
+        "idealThickness": 0.19599999999999998,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.28,
-        "endHeight": 1.6,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 1.04,
+        "endHeight": 1.12,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.6,
-        "endHeight": 1.92,
+        "startHeight": 1.12,
+        "endHeight": 1.44,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.92,
-        "endHeight": 2,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
-      },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 2,
-        "endHeight": 2.24,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "filamentId": "xyyxysq",
+        "startHeight": 1.44,
+        "endHeight": 1.76,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 2.24,
-        "endHeight": 2.56,
+        "startHeight": 1.76,
+        "endHeight": 2.08,
         "idealThickness": 0.343,
         "actualThickness": 0.32
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 2.08,
+        "endHeight": 2.4,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       }
     ],
-    "totalHeight": 2.56,
+    "totalHeight": 2.4,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "azwg1yp",
+      "upcjpfe",
       "vsn9q6u",
       "plvjtmc",
-      "upcjpfe",
       "98z555k",
       "upcjpfe",
+      "vsn9q6u",
+      "xyyxysq",
+      "vsn9q6u",
       "p9c63ms",
       "98z555k",
-      "upcjpfe",
-      "plvjtmc",
-      "vsn9q6u",
-      "xyyxysq"
+      "upcjpfe"
     ],
     "transitionZones": [
       {
-        "filamentId": "vsn9q6u",
+        "filamentId": "azwg1yp",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.49400000000000005,
-        "actualThickness": 0.56
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 0.56,
-        "endHeight": 0.64,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "endHeight": 0.4,
+        "idealThickness": 0.364,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.64,
-        "endHeight": 0.96,
+        "startHeight": 0.4,
+        "endHeight": 0.72,
         "idealThickness": 0.343,
         "actualThickness": 0.32
       },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 0.72,
+        "endHeight": 1.04,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 1.04,
+        "endHeight": 1.12,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
       {
         "filamentId": "98z555k",
-        "startHeight": 0.96,
-        "endHeight": 1.2,
+        "startHeight": 1.12,
+        "endHeight": 1.36,
         "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 1.2,
-        "endHeight": 1.6,
+        "startHeight": 1.36,
+        "endHeight": 1.68,
         "idealThickness": 0.343,
-        "actualThickness": 0.4
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 1.6,
+        "filamentId": "vsn9q6u",
+        "startHeight": 1.68,
         "endHeight": 2,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "98z555k",
+        "filamentId": "xyyxysq",
         "startHeight": 2,
-        "endHeight": 2.24,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "endHeight": 2.32,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 2.24,
-        "endHeight": 2.64,
-        "idealThickness": 0.343,
-        "actualThickness": 0.4
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.32,
+        "endHeight": 2.56,
+        "idealThickness": 0.26599999999999996,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.64,
-        "endHeight": 2.72,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "p9c63ms",
+        "startHeight": 2.56,
+        "endHeight": 3.04,
+        "idealThickness": 0.42000000000000004,
+        "actualThickness": 0.48
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.72,
-        "endHeight": 2.96,
-        "idealThickness": 0.26599999999999996,
+        "filamentId": "98z555k",
+        "startHeight": 3.04,
+        "endHeight": 3.28,
+        "idealThickness": 0.27299999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "xyyxysq",
-        "startHeight": 2.96,
-        "endHeight": 3.28,
-        "idealThickness": 0.357,
+        "filamentId": "upcjpfe",
+        "startHeight": 3.28,
+        "endHeight": 3.6,
+        "idealThickness": 0.343,
         "actualThickness": 0.32
       }
     ],
-    "totalHeight": 3.28,
+    "totalHeight": 3.6,
     "compressionRatio": 1
   }
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 9c5a192..e80e449 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -49,19 +49,52 @@ test('CIEDE2000 distance matches the published reference pair', async () => {
     assert.ok(Math.abs(distance - 2.0425) < 0.0001);
 });
 
-test('transition thickness stays printable and respects its TD cap', async () => {
+test('enhanced matching keeps every color from the processed 2D palette', async () => {
+    const { buildOptimizerImageTargets } = await loadAutoPaintModule();
+    const targets = buildOptimizerImageTargets([
+        { hex: '#ff0000', count: 6 },
+        { hex: '#00ff00', count: 3 },
+        { hex: '#0000ff', count: 1 },
+    ]);
+
+    assert.equal(targets.length, 3, 'the optimizer must not perform a second color reduction');
+    assertAlmostEqual(targets.reduce((sum, target) => sum + target.weight, 0), 1);
+    assertAlmostEqual(targets[0].weight, 0.6);
+    assertAlmostEqual(targets[1].weight, 0.3);
+    assertAlmostEqual(targets[2].weight, 0.1);
+});
+
+test('transition thickness follows the selected Beer-Lambert opacity endpoint', async () => {
     const { calculateTransitionThickness, hexToRgb } = await loadAutoPaintModule();
     const layerHeight = 0.1;
     const td = 1;
-    const thickness = calculateTransitionThickness(
+    const compact = calculateTransitionThickness(
         hexToRgb('#000000'),
         hexToRgb('#ffffff'),
         td,
-        layerHeight
+        layerHeight,
+        0.8
+    );
+    const detailed = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        td,
+        layerHeight,
+        0.9
+    );
+    const maximum = calculateTransitionThickness(
+        hexToRgb('#000000'),
+        hexToRgb('#ffffff'),
+        td,
+        layerHeight,
+        0.95
     );
 
-    assert.ok(thickness >= layerHeight, 'a transition must contain at least one layer');
-    assert.ok(thickness <= td * 0.7 + EPSILON, 'a transition must not exceed the TD cap');
+    assert.ok(compact >= layerHeight, 'a transition must contain at least one layer');
+    assert.ok(compact <= 0.7 * td + EPSILON);
+    assert.ok(detailed <= td + EPSILON);
+    assert.ok(maximum <= 1.3 * td + EPSILON);
+    assert.ok(compact <= detailed && detailed <= maximum, 'detail modes must not shorten the ramp');
 
     const nearIdenticalThickness = calculateTransitionThickness(
         hexToRgb('#112233'),
@@ -98,7 +131,7 @@ test('calibrated channel TDs determine transition thickness', async () => {
     );
     assert.ok(
         calibratedThickness <= 2 * 0.7 + EPSILON,
-        'the calibrated transition must respect the slowest-channel TD cap'
+        'the calibrated transition must respect the default slowest-channel TD cap'
     );
 });
 
diff --git a/tests/benchmark/autoPaintBench.ts b/tests/benchmark/autoPaintBench.ts
index 3adbb15..06a1284 100644
--- a/tests/benchmark/autoPaintBench.ts
+++ b/tests/benchmark/autoPaintBench.ts
@@ -5,7 +5,7 @@ import { createServer } from 'vite';
 import { autoPaintGoldenScenarios } from '../autoPaintGoldenFixtures.ts';
 
 type AutoPaintModule = typeof import('../../src/lib/autoPaint.ts');
-type Algorithm = 'fast' | 'balanced' | 'thorough';
+type Algorithm = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 type Lab = { L: number; a: number; b: number };
 type WeightedLab = Lab & { weight: number };
 type Sample = { value: number; weight: number };
@@ -88,7 +88,7 @@ const output: unknown[] = [];
 for (const scenario of autoPaintGoldenScenarios().filter(
     (scenario) => scenario.enhancedColorMatch && scenario.allowRepeatedSwaps
 )) {
-    const algorithms: Algorithm[] = ['fast', 'balanced', 'thorough'];
+    const algorithms: Algorithm[] = ['fast', 'balanced', 'thorough', 'deep', 'exact'];
     // Measure against the raw image colors (ground truth), not the optimizer's
     // clustered targets, so the benchmark is an independent yardstick.
     const targets: WeightedLab[] = scenario.imageSwatches.map((swatch) => {
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 4696c94..b92031b 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -49,7 +49,15 @@ async function loadViteModule<T>(modulePath: string): Promise<T> {
 
 test('each optimizer produces the same result for the same seed', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -71,7 +79,15 @@ test('each optimizer produces the same result for the same seed', async (t) => {
 
 test('optimizer progress is monotonic and completes for every algorithm', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const algorithm of algorithms) {
         await t.test(algorithm, () => {
@@ -92,6 +108,25 @@ test('optimizer progress is monotonic and completes for every algorithm', async
             );
         });
     }
+
+    const exactRepeatSamples: number[] = [];
+    optimizeFilamentOrder(filaments, context, {
+        algorithm: 'exact',
+        allowRepeatedSwaps: true,
+        seed: 42,
+        maxIterations: 20,
+        cachingEnabled: false,
+        onProgress: (iteration, total) =>
+            exactRepeatSamples.push(total > 0 ? iteration / total : 0),
+    });
+    assert.ok(exactRepeatSamples.length > 2, 'exact repeat refinement must report intermediate progress');
+    assert.equal(exactRepeatSamples.at(-1), 1);
+    assert.ok(
+        exactRepeatSamples.every(
+            (sample, index) => index === 0 || sample >= exactRepeatSamples[index - 1]
+        ),
+        'exact repeat refinement progress must never move backwards'
+    );
 });
 
 function withoutCacheState<T extends { cacheHit?: boolean }>(result: T): Omit<T, 'cacheHit'> {
@@ -281,7 +316,15 @@ test('repeats can close the RGB color path to reach the missing magenta blend',
 
 test('variable-length optimizers preserve sequence safety invariants', async (t) => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
-    const algorithms = ['exhaustive', 'simulated-annealing', 'fast', 'balanced', 'thorough'] as const;
+    const algorithms = [
+        'exhaustive',
+        'simulated-annealing',
+        'fast',
+        'balanced',
+        'thorough',
+        'deep',
+        'exact',
+    ] as const;
 
     for (const allowRepeatedSwaps of [false, true]) {
         for (const algorithm of algorithms) {
@@ -306,7 +349,27 @@ test('variable-length optimizers preserve sequence safety invariants', async (t)
     }
 });
 
-test('fast uses beam search for medium profiles while explicit exhaustive remains exact', async () => {
+test('maxExtraRepeats supports the full user-facing repeat-limit range', async () => {
+    const { optimizeFilamentOrder } = await loadOptimizerModule();
+
+    for (const maxExtraRepeats of [0, 2, 4, 6, 8, 12]) {
+        const result = optimizeFilamentOrder(filaments, context, {
+            algorithm: 'balanced',
+            maxExtraRepeats,
+            seed: 20260624,
+            cachingEnabled: false,
+        });
+        const ids = result.order.map((filament) => filament.id);
+
+        assert.ok(ids.length <= filaments.length + maxExtraRepeats);
+        assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]));
+        if (maxExtraRepeats === 0) {
+            assert.equal(new Set(ids).size, ids.length, 'Off must prohibit all repeated filaments');
+        }
+    }
+});
+
+test('fast uses a narrow beam while explicit exhaustive remains exact', async () => {
     const { optimizeFilamentOrder } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
@@ -326,7 +389,7 @@ test('fast uses beam search for medium profiles while explicit exhaustive remain
         cachingEnabled: false,
     });
 
-    assert.equal(fast.resolvedAlgorithm, 'beam');
+    assert.equal(fast.resolvedAlgorithm, 'narrow-beam');
     assert.equal(exhaustive.resolvedAlgorithm, 'exhaustive');
     assert.equal(
         exhaustive.iterations,
@@ -337,8 +400,12 @@ test('fast uses beam search for medium profiles while explicit exhaustive remain
     assert.equal(new Set(fast.order.map((filament) => filament.id)).size, fast.order.length);
 });
 
-test('balanced hybrid is deterministic, valid, and never worse than fast on a medium profile', async () => {
-    const { optimizeFilamentOrder } = await loadOptimizerModule();
+test('effort tiers are deterministic and preserve the previous tier best result', async () => {
+    const {
+        getExactBaseOrderCount,
+        normalizeOptimizerTier,
+        optimizeFilamentOrder,
+    } = await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
         { id: 'green', color: '#42a85f', td: 1.6 },
@@ -346,24 +413,62 @@ test('balanced hybrid is deterministic, valid, and never worse than fast on a me
         { id: 'purple', color: '#7545a8', td: 1.9 },
     ];
 
-    const options = { algorithm: 'balanced' as const, seed: 7, cachingEnabled: false };
-    const first = optimizeFilamentOrder(mediumProfile, context, options);
-    const second = optimizeFilamentOrder(mediumProfile, context, options);
+    const options = { seed: 7, cachingEnabled: false, maxIterations: 30 };
     const fast = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
         algorithm: 'fast',
-        seed: 7,
-        cachingEnabled: false,
+    });
+    const balanced = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'balanced',
+    });
+    const thorough = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'thorough',
+    });
+    const deep = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'deep',
+    });
+    const exact = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'exact',
+    });
+    const deepAgain = optimizeFilamentOrder(mediumProfile, context, {
+        ...options,
+        algorithm: 'deep',
     });
 
-    assert.equal(first.resolvedAlgorithm, 'balanced-hybrid');
-    assert.deepEqual(second, first, 'same seed must reproduce the same hybrid result');
+    assert.equal(fast.resolvedAlgorithm, 'narrow-beam');
+    assert.equal(balanced.resolvedAlgorithm, 'beam');
+    assert.equal(thorough.resolvedAlgorithm, 'thorough-hybrid');
+    assert.equal(deep.resolvedAlgorithm, 'deep-hybrid');
+    assert.equal(exact.resolvedAlgorithm, 'exact-base');
+    assert.deepEqual(deepAgain, deep, 'same seed must reproduce the Deep tier');
 
-    const ids = first.order.map((filament) => filament.id);
+    const ids = deep.order.map((filament) => filament.id);
     assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]), 'no adjacent duplicates');
     assert.equal(new Set(ids).size, ids.length, 'no repeats without allowRepeatedSwaps');
 
     assert.ok(
-        first.score <= fast.score + 1e-9,
-        `balanced (${first.score}) must not be worse than fast (${fast.score})`
+        balanced.score <= fast.score + 1e-9,
+        `balanced (${balanced.score}) must not be worse than fast (${fast.score})`
     );
+    assert.ok(
+        thorough.score <= balanced.score + 1e-9,
+        `thorough (${thorough.score}) must not be worse than balanced (${balanced.score})`
+    );
+    assert.ok(
+        deep.score <= thorough.score + 1e-9,
+        `deep (${deep.score}) must not be worse than thorough (${thorough.score})`
+    );
+    assert.ok(
+        exact.score <= deep.score + 1e-9,
+        `exact (${exact.score}) must not be worse than deep (${deep.score})`
+    );
+
+    assert.equal(getExactBaseOrderCount(8), 109_600);
+    assert.equal(getExactBaseOrderCount(9), 986_409);
+    assert.equal(normalizeOptimizerTier('exhaustive'), 'exact');
+    assert.equal(normalizeOptimizerTier('genetic'), 'deep');
 });

From e58a0d66c0bbe09dfedd9d03065eccff28977e61 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 24 Jun 2026 22:07:34 +0300
Subject: [PATCH 28/81] Use Stucki kernel for height dithering

Diffuse height-quantization error with the 12-neighbor, error-conserving
Stucki kernel instead of Floyd-Steinberg, spreading error over a wider
area for smoother tonal gradients and fewer directional artifacts.
Block-aware dot sizing, serpentine scan, and edge protection are
unchanged.
---
 CHANGELOG.md                  |  1 +
 README.md                     |  2 +-
 src/components/ThreeDView.tsx | 45 ++++++++++++++++++++++-------------
 3 files changed, 31 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ced4cb3..8e76dda 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -17,6 +17,7 @@ All notable changes to Kromacut are documented in this file.
 - **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
 - **Auto-paint detail controls** - Enhanced matching now scores every color from the already-processed 2D palette instead of applying a hidden second color reduction. Repeated swaps are now a selector with Off, 2, 4, 6, 8, and 12 extra occurrences; transition detail similarly exposes 80%, 90%, and 95% Beer-Lambert opacity endpoints so quality, stack height, and runtime are an intentional trade-off. Existing repeated-swap settings migrate to four extra occurrences.
+- **Height dithering kernel** - Height dithering now diffuses quantization error with the Stucki kernel (12 neighbors, error-conserving) instead of Floyd-Steinberg, spreading error over a wider area for smoother tonal gradients and finer apparent detail. Block-aware dot sizing and edge protection are unchanged.
 - **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
 - **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
 - **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
diff --git a/README.md b/README.md
index dacf53d..8c7c649 100644
--- a/README.md
+++ b/README.md
@@ -181,7 +181,7 @@ Region weighting is most useful when filament budget is limited and you want the
 | **Max Height** | Constrains the total model height (mm). When set below the auto-calculated ideal, zones are uniformly compressed. Leave blank or click `Auto` for the physics-derived default. |
 | **Enhanced color matching** | Optimizes the printable filament sequence rather than simply sorting by luminance. It may omit filaments that do not improve the result and evaluates the actual preview color-to-height path. |
 | **Extra repeated swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once. Choose Off, 2, 4, 6, 8, or 12 additional occurrences; more repeats may create useful blend paths but substantially expand the search. |
-| **Height dithering** | (Requires Enhanced color matching) Applies block-aware Floyd-Steinberg error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
+| **Height dithering** | (Requires Enhanced color matching) Applies block-aware Stucki error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
 | **Optimizer algorithm** | Choose Fast for a preview, Balanced for the recommended full beam, Thorough or Deep for more search effort, or Exact base order when you want every no-repeat base stack checked. |
diff --git a/src/components/ThreeDView.tsx b/src/components/ThreeDView.tsx
index 20fca07..0665f57 100644
--- a/src/components/ThreeDView.tsx
+++ b/src/components/ThreeDView.tsx
@@ -40,7 +40,7 @@ interface ThreeDViewProps {
     autoPaintTotalHeight?: number; // Total model height when auto-paint is enabled
     autoPaintFilamentOrder?: string[]; // Filament IDs in order (for cache invalidation)
     enhancedColorMatch?: boolean; // Use color-distance mapping instead of luminance
-    heightDithering?: boolean; // Floyd-Steinberg error diffusion on height map
+    heightDithering?: boolean; // Stucki error diffusion on height map
     ditherLineWidth?: number; // Minimum dot size in mm for dithering
     smoothMeshing?: boolean; // Smooth connected boundaries using welded grid topology
     isOrtho?: boolean;
@@ -1004,7 +1004,7 @@ export default function ThreeDView({
                         // --- Pass 2: Quantize heights (with optional dithering) ---
                         // The continuous height map has sub-layer precision, but
                         // the 3D model must use discrete layer heights.  When
-                        // heightDithering is ON, block-aware Floyd-Steinberg error
+                        // heightDithering is ON, block-aware Stucki error
                         // diffusion produces dots sized to the printer's line width
                         // so the dither pattern is actually printable.  Edges
                         // between different quantized heights are protected from
@@ -1058,7 +1058,7 @@ export default function ThreeDView({
                                 }
                             }
 
-                            // --- Step 2c: Block-aware Floyd-Steinberg ---
+                            // --- Step 2c: Block-aware Stucki error diffusion ---
                             // The block size ensures dither dots are at least as
                             // wide as the printer's line width (in pixels).
                             const blockSize = Math.max(1, Math.round(ditherLineWidth / pixelSize));
@@ -1086,7 +1086,25 @@ export default function ThreeDView({
                                 if (blockCnt[bi] > 0) blockAvg[bi] /= blockCnt[bi];
                             }
 
-                            // Dither at block level
+                            // Dither at block level using the Stucki kernel: a
+                            // wider, error-conserving diffusion than Floyd-
+                            // Steinberg for smoother tone and finer detail.
+                            // Offsets are scan-relative (dx along the serpentine
+                            // direction, dy downward); weights are pre-divided by 42.
+                            const STUCKI_KERNEL: ReadonlyArray<readonly [number, number, number]> = [
+                                [1, 0, 8 / 42],
+                                [2, 0, 4 / 42],
+                                [-2, 1, 2 / 42],
+                                [-1, 1, 4 / 42],
+                                [0, 1, 8 / 42],
+                                [1, 1, 4 / 42],
+                                [2, 1, 2 / 42],
+                                [-2, 2, 1 / 42],
+                                [-1, 2, 2 / 42],
+                                [0, 2, 4 / 42],
+                                [1, 2, 2 / 42],
+                                [2, 2, 1 / 42],
+                            ];
                             const errBuf = new Float64Array(bW * bH);
                             const blockSnapped = new Float32Array(bW * bH);
 
@@ -1125,18 +1143,13 @@ export default function ThreeDView({
 
                                     if (!blockHasEdge[bi]) {
                                         const err = blockAvg[bi] + errBuf[bi] - snapped;
-                                        const xFwd = ltr ? bx + 1 : bx - 1;
-                                        const xDiagFwd = ltr ? bx + 1 : bx - 1;
-                                        const xDiagBack = ltr ? bx - 1 : bx + 1;
-
-                                        if (xFwd >= 0 && xFwd < bW)
-                                            errBuf[by * bW + xFwd] += err * (7 / 16);
-                                        if (by + 1 < bH) {
-                                            if (xDiagBack >= 0 && xDiagBack < bW)
-                                                errBuf[(by + 1) * bW + xDiagBack] += err * (3 / 16);
-                                            errBuf[(by + 1) * bW + bx] += err * (5 / 16);
-                                            if (xDiagFwd >= 0 && xDiagFwd < bW)
-                                                errBuf[(by + 1) * bW + xDiagFwd] += err * (1 / 16);
+                                        const dir = ltr ? 1 : -1;
+                                        for (let k = 0; k < STUCKI_KERNEL.length; k++) {
+                                            const [dx, dy, weight] = STUCKI_KERNEL[k];
+                                            const tx = bx + dir * dx;
+                                            const ty = by + dy;
+                                            if (tx < 0 || tx >= bW || ty >= bH) continue;
+                                            errBuf[ty * bW + tx] += err * weight;
                                         }
                                     }
                                 }

From f3449dc6f9f0c957e023aab32e966243d7e016fb Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 10:34:17 +0300
Subject: [PATCH 29/81] Score auto-paint with the preview's printable-color
 mapping

The optimizer scored each image color by projecting onto the raw per-layer
Lab polyline, which could land a target on a one-layer transition sliver --
a color no pixel is ever assigned -- and then optimize that fiction (e.g.
treating a purple target as rendering blue). Collapse consecutive
same-color layers into flat-zone nodes the way the 3D preview does, so the
objective scores the colors the model actually builds. All goldens and
realized-error budgets pass unchanged.
---
 src/lib/autoPaint.ts | 121 ++++++++++++++++++++++++++++++++-----------
 1 file changed, 92 insertions(+), 29 deletions(-)

diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 78c4b04..bfb8c1a 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -1032,10 +1032,14 @@ export interface MappedTarget {
 }
 
 /**
- * Map each weighted image target onto the printable palette the way the preview
- * does: find the closest point on the palette's Lab polyline (Euclidean
- * projection), then snap to the printable layer at that height. Shared by the
- * optimizer objective and the benchmark so the two cannot drift.
+ * Map each weighted image target onto the printable palette exactly the way the
+ * 3D preview does, so the optimizer scores the colors the model actually shows.
+ *
+ * The preview collapses consecutive same-color layers into flat-zone nodes and
+ * projects each pixel onto that node/transition polyline. Scoring against the
+ * raw per-layer polyline instead let the optimizer land a target on a one-layer
+ * transition sliver — a color no pixel is ever assigned — and optimize that
+ * fiction. Mirroring the collapse keeps the objective and the build consistent.
  */
 export function mapTargetsToPrintablePalette(
     palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
@@ -1043,59 +1047,118 @@ export function mapTargetsToPrintablePalette(
 ): MappedTarget[] {
     if (palette.length === 0) return [];
 
+    // Collapse consecutive near-identical layers into flat-zone nodes (ΔE<0.5),
+    // matching ThreeDView. Each node keeps its height range and an averaged Lab.
+    const COLLAPSE_DE_SQ = 0.25; // 0.5^2
+    const nodes: Array<{ lab: Lab; minHeight: number; maxHeight: number; paletteIndex: number }> =
+        [];
+    let runStart = 0;
+    for (let i = 1; i <= palette.length; i++) {
+        let split = i === palette.length;
+        if (!split) {
+            const ref = palette[runStart].lab;
+            const cur = palette[i].lab;
+            const deSq = (cur.L - ref.L) ** 2 + (cur.a - ref.a) ** 2 + (cur.b - ref.b) ** 2;
+            split = deSq >= COLLAPSE_DE_SQ;
+        }
+        if (split) {
+            let sL = 0;
+            let sa = 0;
+            let sb = 0;
+            for (let j = runStart; j < i; j++) {
+                sL += palette[j].lab.L;
+                sa += palette[j].lab.a;
+                sb += palette[j].lab.b;
+            }
+            const n = i - runStart;
+            nodes.push({
+                lab: { L: sL / n, a: sa / n, b: sb / n },
+                minHeight: palette[runStart].height,
+                maxHeight: palette[i - 1].height,
+                paletteIndex: runStart,
+            });
+            runStart = i;
+        }
+    }
+
+    // Transition segments connect the end of one flat zone to the start of the
+    // next, tracing the blend path through the printable layers between them.
+    const segments = nodes.slice(0, -1).map((A, ni) => {
+        const B = nodes[ni + 1];
+        return {
+            aL: A.lab.L,
+            aa: A.lab.a,
+            ab: A.lab.b,
+            dL: B.lab.L - A.lab.L,
+            da: B.lab.a - A.lab.a,
+            db: B.lab.b - A.lab.b,
+            hStart: A.maxHeight,
+            hEnd: B.minHeight,
+        };
+    });
+
     return imageTargets.map((target) => {
         let minDistance = Infinity;
-        let bestHeight = palette[0].height;
+        let nodeMatch = 0;
+        let onSegment = false;
+        let segmentHeight = nodes[0].minHeight;
 
-        // Nearest printable color seeds the projection threshold.
-        for (let ri = 0; ri < palette.length; ri++) {
-            const de = optimizerColorDistance(palette[ri].lab, target);
+        // Nearest flat-zone node by color.
+        for (let ni = 0; ni < nodes.length; ni++) {
+            const de = optimizerColorDistance(nodes[ni].lab, target);
             if (de < minDistance) {
                 minDistance = de;
-                bestHeight = palette[ri].height;
-                if (de < 0.5) break;
+                nodeMatch = ni;
+                onSegment = false;
             }
         }
 
-        // Refine against the closest point on each polyline segment.
-        for (let ri = 0; ri < palette.length - 1; ri++) {
-            const start = palette[ri];
-            const end = palette[ri + 1];
-            const dL = end.lab.L - start.lab.L;
-            const da = end.lab.a - start.lab.a;
-            const db = end.lab.b - start.lab.b;
-            const lengthSquared = dL * dL + da * da + db * db;
+        // Refine against the closest point on each transition segment.
+        for (const seg of segments) {
+            const lengthSquared = seg.dL * seg.dL + seg.da * seg.da + seg.db * seg.db;
             if (lengthSquared < 0.01) continue;
-
             const t = Math.max(
                 0,
                 Math.min(
                     1,
-                    ((target.L - start.lab.L) * dL +
-                        (target.a - start.lab.a) * da +
-                        (target.b - start.lab.b) * db) /
+                    ((target.L - seg.aL) * seg.dL +
+                        (target.a - seg.aa) * seg.da +
+                        (target.b - seg.ab) * seg.db) /
                         lengthSquared
                 )
             );
             const projectedDistance = optimizerColorDistance(target, {
-                L: start.lab.L + t * dL,
-                a: start.lab.a + t * da,
-                b: start.lab.b + t * db,
+                L: seg.aL + t * seg.dL,
+                a: seg.aa + t * seg.da,
+                b: seg.ab + t * seg.db,
             });
             if (projectedDistance < minDistance) {
                 minDistance = projectedDistance;
-                bestHeight = start.height + t * (end.height - start.height);
+                onSegment = true;
+                segmentHeight = seg.hStart + t * (seg.hEnd - seg.hStart);
             }
         }
 
-        const mappedIdx = palette.findIndex((entry) => entry.height >= bestHeight);
-        const paletteIndex = mappedIdx >= 0 ? mappedIdx : palette.length - 1;
+        if (!onSegment) {
+            // Flat-zone match: the printed surface is this filament's solid
+            // color across the whole zone (sub-position within it is relief).
+            const node = nodes[nodeMatch];
+            return {
+                target,
+                paletteIndex: node.paletteIndex,
+                mappedLab: node.lab,
+                projectedHeight: (node.minHeight + node.maxHeight) / 2,
+            };
+        }
 
+        // Transition match: the printed color is the layer at that height.
+        const mappedIdx = palette.findIndex((entry) => entry.height >= segmentHeight);
+        const paletteIndex = mappedIdx >= 0 ? mappedIdx : palette.length - 1;
         return {
             target,
             paletteIndex,
             mappedLab: palette[paletteIndex].lab,
-            projectedHeight: bestHeight,
+            projectedHeight: segmentHeight,
         };
     });
 }

From 5b1b2680f2dea46372ab18a403082ed5753af4bf Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 11:30:07 +0300
Subject: [PATCH 30/81] Add Preserve color separation auto-paint mode

Assign each distinct image color to a distinct printable color so
perceptibly different colors are never collapsed onto one flat surface,
keeping gradient variation at a small per-color accuracy cost. The
injective, weight-ordered assignment runs in the shared printable-color
mapper used by both the optimizer score and the 3D preview, so the
optimized order and the built model stay consistent.

Opt-in toggle under Enhanced color matching, off by default; existing
behavior, goldens, and quality budgets are unchanged.
---
 CHANGELOG.md                      |  1 +
 src/App.tsx                       |  7 +++
 src/components/AutoPaintTab.tsx   | 28 ++++++++++++
 src/components/ThreeDControls.tsx |  9 +++-
 src/components/ThreeDView.tsx     | 51 ++++++++++++++++++++--
 src/hooks/useAutoPaintWorker.ts   |  4 ++
 src/lib/autoPaint.ts              | 72 +++++++++++++++++++++++++++++--
 src/lib/optimizer.ts              | 15 ++++++-
 src/types/index.ts                |  2 +
 9 files changed, 180 insertions(+), 9 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8e76dda..4d188fc 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
+- **Preserve color separation (Auto-paint)** - New opt-in toggle (Enhanced color matching) that assigns every distinct image color to a distinct printable color, so perceptibly different colors are never collapsed onto one flat surface — gradients keep their variation. It trades a small amount of per-color accuracy for that separation and is fully reachable whenever the stack exposes at least as many distinct printable colors as the image has (raise the height if not). The optimizer scores and the 3D preview build through the same shared mapper, so they stay consistent.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 - **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
 - **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures realized print error (CIEDE2000 mean, p95, and coverage) for both the uncompressed and the Max Height-compressed stack, plus the achievable palette floor, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles. It measures the printed result through the same canonical color-to-height mapper the optimizer scores with, instead of a separately-implemented projection.
diff --git a/src/App.tsx b/src/App.tsx
index 00641b7..2815858 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -84,6 +84,7 @@ type AutoPaintPersisted = Pick<
     | 'optimizerSeed'
     | 'regionWeightingMode'
     | 'enhancedColorMatch'
+    | 'preserveSeparation'
     | 'allowRepeatedSwaps'
     | 'maxRepeatedSwaps'
     | 'transitionOpacity'
@@ -126,6 +127,7 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
             optimizerSeed: parsed.optimizerSeed,
             regionWeightingMode: parsed.regionWeightingMode,
             enhancedColorMatch: parsed.enhancedColorMatch ?? false,
+            preserveSeparation: parsed.preserveSeparation ?? false,
             maxRepeatedSwaps: normalizeRepeatLimit(
                 parsed.maxRepeatedSwaps,
                 parsed.allowRepeatedSwaps
@@ -268,6 +270,8 @@ function App(): React.ReactElement | null {
                 regionWeightingMode:
                     autopaintHydrated.regionWeightingMode ?? prev.regionWeightingMode,
                 enhancedColorMatch: autopaintHydrated.enhancedColorMatch ?? prev.enhancedColorMatch,
+                preserveSeparation:
+                    autopaintHydrated.preserveSeparation ?? prev.preserveSeparation,
                 maxRepeatedSwaps:
                     autopaintHydrated.maxRepeatedSwaps ?? prev.maxRepeatedSwaps,
                 transitionOpacity: autopaintHydrated.transitionOpacity ?? prev.transitionOpacity,
@@ -289,6 +293,7 @@ function App(): React.ReactElement | null {
             optimizerSeed: threeDState.optimizerSeed,
             regionWeightingMode: threeDState.regionWeightingMode,
             enhancedColorMatch: threeDState.enhancedColorMatch,
+            preserveSeparation: threeDState.preserveSeparation,
             maxRepeatedSwaps: threeDState.maxRepeatedSwaps,
             transitionOpacity: threeDState.transitionOpacity,
             heightDithering: threeDState.heightDithering,
@@ -302,6 +307,7 @@ function App(): React.ReactElement | null {
         threeDState.optimizerSeed,
         threeDState.regionWeightingMode,
         threeDState.enhancedColorMatch,
+        threeDState.preserveSeparation,
         threeDState.maxRepeatedSwaps,
         threeDState.transitionOpacity,
         threeDState.heightDithering,
@@ -714,6 +720,7 @@ function App(): React.ReactElement | null {
                                                 builtModelState.autoPaintResult?.filamentOrder
                                             }
                                             enhancedColorMatch={builtModelState.enhancedColorMatch}
+                                            preserveSeparation={builtModelState.preserveSeparation}
                                             heightDithering={builtModelState.heightDithering}
                                             ditherLineWidth={builtModelState.ditherLineWidth}
                                             smoothMeshing={builtModelState.smoothMeshing}
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 862c9bb..fe07c40 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -159,6 +159,8 @@ interface AutoPaintTabProps {
     // Enhanced matching options
     enhancedColorMatch: boolean;
     setEnhancedColorMatch: (v: boolean) => void;
+    preserveSeparation: boolean;
+    setPreserveSeparation: (v: boolean) => void;
     maxRepeatedSwaps: AutoPaintRepeatLimit;
     setMaxRepeatedSwaps: (v: AutoPaintRepeatLimit) => void;
     transitionOpacity: AutoPaintTransitionOpacity;
@@ -219,6 +221,8 @@ export default function AutoPaintTab({
     imageSwatches,
     enhancedColorMatch,
     setEnhancedColorMatch,
+    preserveSeparation,
+    setPreserveSeparation,
     maxRepeatedSwaps,
     setMaxRepeatedSwaps,
     transitionOpacity,
@@ -689,6 +693,30 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                <div
+                                    className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
+                                >
+                                    <Label
+                                        htmlFor="preserve-separation"
+                                        className="text-xs font-medium text-foreground cursor-pointer"
+                                    >
+                                        Preserve color separation
+                                    </Label>
+                                    <Switch
+                                        id="preserve-separation"
+                                        data-testid="autopaint-preserve-separation"
+                                        checked={preserveSeparation}
+                                        onCheckedChange={setPreserveSeparation}
+                                        disabled={!enhancedColorMatch}
+                                    />
+                                </div>
+                                {preserveSeparation && enhancedColorMatch && (
+                                    <p className="text-[10px] text-muted-foreground pl-0.5">
+                                        Maps every image color to a distinct printable color so
+                                        gradients keep their variation, at a small cost to per-color
+                                        accuracy.
+                                    </p>
+                                )}
                                 <div
                                     className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 4367f7a..54afd2a 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -116,6 +116,7 @@ export default function ThreeDControls({
     const [paintMode, setPaintMode] = useState<'manual' | 'autopaint'>(initialPaintMode);
     const [autoPaintMaxHeight, setAutoPaintMaxHeight] = useState<number | undefined>(undefined);
     const [enhancedColorMatch, setEnhancedColorMatch] = useState(persisted?.enhancedColorMatch ?? false);
+    const [preserveSeparation, setPreserveSeparation] = useState(persisted?.preserveSeparation ?? false);
     const [maxRepeatedSwaps, setMaxRepeatedSwaps] = useState<AutoPaintRepeatLimit>(
         persisted?.maxRepeatedSwaps ?? (persisted?.allowRepeatedSwaps ? 4 : 0)
     );
@@ -166,6 +167,7 @@ export default function ThreeDControls({
             paintMode,
             filaments,
             enhancedColorMatch,
+            preserveSeparation,
             maxRepeatedSwaps,
             transitionOpacity,
             heightDithering,
@@ -177,7 +179,7 @@ export default function ThreeDControls({
             smoothMeshing,
         });
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [paintMode, filaments, enhancedColorMatch, maxRepeatedSwaps, transitionOpacity, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
+    }, [paintMode, filaments, enhancedColorMatch, preserveSeparation, maxRepeatedSwaps, transitionOpacity, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
 
     useEffect(() => {
         savePrintSettingsToStorage({ layerHeight, slicerFirstLayerHeight, pixelSize, smoothMeshing });
@@ -225,6 +227,7 @@ export default function ThreeDControls({
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
+        preserveSeparation,
         maxRepeatedSwaps,
         transitionOpacity,
         optimizerAlgorithm,
@@ -324,6 +327,7 @@ export default function ThreeDControls({
                 filaments,
                 paintMode,
                 enhancedColorMatch,
+                preserveSeparation,
                 maxRepeatedSwaps,
                 transitionOpacity,
                 heightDithering,
@@ -367,6 +371,7 @@ export default function ThreeDControls({
         filaments,
         paintMode,
         enhancedColorMatch,
+        preserveSeparation,
         maxRepeatedSwaps,
         transitionOpacity,
         heightDithering,
@@ -478,6 +483,8 @@ export default function ThreeDControls({
                     imageSwatches={filtered}
                     enhancedColorMatch={enhancedColorMatch}
                     setEnhancedColorMatch={handleEnhancedColorMatchChange}
+                    preserveSeparation={preserveSeparation}
+                    setPreserveSeparation={setPreserveSeparation}
                     maxRepeatedSwaps={maxRepeatedSwaps}
                     setMaxRepeatedSwaps={setMaxRepeatedSwaps}
                     transitionOpacity={transitionOpacity}
diff --git a/src/components/ThreeDView.tsx b/src/components/ThreeDView.tsx
index 0665f57..b530081 100644
--- a/src/components/ThreeDView.tsx
+++ b/src/components/ThreeDView.tsx
@@ -13,6 +13,7 @@ import {
 import { LAYER_ACTIVATION_EPSILON } from '../lib/layerActivation';
 import { normalizeHexColor as normalizeHexColorValue } from '../lib/colorUtils';
 import { buildFlatPaintLayout, heightMapToFlatPaintLayerCounts } from '../lib/flatPaint';
+import { mapTargetsToPrintablePalette, type WeightedLab } from '../lib/autoPaint';
 import {
     clampProgress,
     layeredBuildScanProgress,
@@ -40,6 +41,7 @@ interface ThreeDViewProps {
     autoPaintTotalHeight?: number; // Total model height when auto-paint is enabled
     autoPaintFilamentOrder?: string[]; // Filament IDs in order (for cache invalidation)
     enhancedColorMatch?: boolean; // Use color-distance mapping instead of luminance
+    preserveSeparation?: boolean; // Assign each image color to a distinct printable color
     heightDithering?: boolean; // Stucki error diffusion on height map
     ditherLineWidth?: number; // Minimum dot size in mm for dithering
     smoothMeshing?: boolean; // Smooth connected boundaries using welded grid topology
@@ -338,6 +340,7 @@ export default function ThreeDView({
     autoPaintTotalHeight,
     autoPaintFilamentOrder,
     enhancedColorMatch = false,
+    preserveSeparation = false,
     heightDithering = false,
     ditherLineWidth = 0.42,
     smoothMeshing = false,
@@ -616,6 +619,7 @@ export default function ThreeDView({
             autoPaintTotalHeight,
             autoPaintFilamentOrder, // Include filament order to detect optimizer changes
             enhancedColorMatch,
+            preserveSeparation,
             heightDithering,
             ditherLineWidth,
             smoothMeshing,
@@ -886,16 +890,29 @@ export default function ThreeDView({
                             });
                         }
 
-                        // Pre-scan image luminance range for flat-zone sub-detail
+                        // Pre-scan image luminance range for flat-zone sub-detail,
+                        // and (in separation mode) the distinct image colors.
                         let imgMinLum = 1,
                             imgMaxLum = 0;
+                        const sepColors = preserveSeparation
+                            ? new Map<number, { lab: { L: number; a: number; b: number }; weight: number }>()
+                            : null;
                         for (let py = minY; py < minY + boxH; py++) {
                             for (let px = minX; px < minX + boxW; px++) {
                                 const idx = (py * fullW + px) * 4;
                                 if (data[idx + 3] === 0) continue;
-                                const lum = getLuminance(data[idx], data[idx + 1], data[idx + 2]);
+                                const pr0 = data[idx],
+                                    pg0 = data[idx + 1],
+                                    pb0 = data[idx + 2];
+                                const lum = getLuminance(pr0, pg0, pb0);
                                 if (lum < imgMinLum) imgMinLum = lum;
                                 if (lum > imgMaxLum) imgMaxLum = lum;
+                                if (sepColors) {
+                                    const key = ((pr0 & 0xff) << 16) | ((pg0 & 0xff) << 8) | (pb0 & 0xff);
+                                    const existing = sepColors.get(key);
+                                    if (existing) existing.weight++;
+                                    else sepColors.set(key, { lab: toLab(pr0, pg0, pb0), weight: 1 });
+                                }
                             }
                         }
                         if (imgMaxLum <= imgMinLum) imgMaxLum = imgMinLum + 0.001;
@@ -904,11 +921,38 @@ export default function ThreeDView({
                         const maxModelH = cumulativeHeights[cumulativeHeights.length - 1] || 1;
                         const minModelH = cumulativeHeights[0] || 0;
 
+                        // Separation mode: assign each distinct image color to a
+                        // DISTINCT printable color through the shared mapper, so no
+                        // two image colors collapse onto the same surface color.
+                        const separationHeights = new Map<number, number>();
+                        if (sepColors && sepColors.size > 0) {
+                            const sepPalette = swatchEntries.map((entry, si) => {
+                                const [r, g, b] = hexToRGB(swatches[si].hex);
+                                return { height: entry.height, lab: entry.lab, rgb: { r, g, b } };
+                            });
+                            const keys = [...sepColors.keys()];
+                            const sepTargets: WeightedLab[] = keys.map((key) => {
+                                const c = sepColors.get(key)!;
+                                return { L: c.lab.L, a: c.lab.a, b: c.lab.b, weight: c.weight };
+                            });
+                            const mapped = mapTargetsToPrintablePalette(sepPalette, sepTargets, {
+                                preserveSeparation: true,
+                            });
+                            mapped.forEach((m, i) => {
+                                separationHeights.set(
+                                    keys[i],
+                                    Math.max(minModelH, Math.min(maxModelH, m.projectedHeight))
+                                );
+                            });
+                        }
+
                         // --- Pass 1: Compute continuous (un-snapped) heights ---
                         // We deliberately do NOT snap to the layer grid here.
                         // The RGB cache is still valid because it stores the ideal
                         // continuous height; dithering happens spatially in Pass 2.
-                        const colorHeightCache = new Map<number, number>();
+                        // Separation assignments seed the cache so each color's
+                        // pixels all land on its assigned printable height.
+                        const colorHeightCache = new Map<number, number>(separationHeights);
 
                         for (let py = minY; py < minY + boxH; py++) {
                             for (let px = minX; px < minX + boxW; px++) {
@@ -1882,6 +1926,7 @@ export default function ThreeDView({
         autoPaintTotalHeight,
         autoPaintFilamentOrder,
         enhancedColorMatch,
+        preserveSeparation,
         heightDithering,
         ditherLineWidth,
         smoothMeshing,
diff --git a/src/hooks/useAutoPaintWorker.ts b/src/hooks/useAutoPaintWorker.ts
index fb07d8b..7d79a3f 100644
--- a/src/hooks/useAutoPaintWorker.ts
+++ b/src/hooks/useAutoPaintWorker.ts
@@ -32,6 +32,7 @@ export interface UseAutoPaintWorkerOptions {
     slicerFirstLayerHeight: number;
     autoPaintMaxHeight?: number;
     enhancedColorMatch: boolean;
+    preserveSeparation: boolean;
     maxRepeatedSwaps: AutoPaintRepeatLimit;
     transitionOpacity: AutoPaintTransitionOpacity;
     optimizerAlgorithm: 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
@@ -75,6 +76,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
+        preserveSeparation,
         maxRepeatedSwaps,
         transitionOpacity,
         optimizerAlgorithm,
@@ -250,6 +252,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
                         algorithm: optimizerAlgorithm,
                         maxExtraRepeats: maxRepeatedSwaps,
                         transitionOpacity,
+                        preserveSeparation,
                         ...(optimizerSeed !== undefined && { seed: optimizerSeed }),
                     },
                 };
@@ -280,6 +283,7 @@ export function useAutoPaintWorker(opts: UseAutoPaintWorkerOptions): UseAutoPain
         slicerFirstLayerHeight,
         autoPaintMaxHeight,
         enhancedColorMatch,
+        preserveSeparation,
         maxRepeatedSwaps,
         transitionOpacity,
         optimizerAlgorithm,
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index bfb8c1a..15707cc 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -1041,12 +1041,77 @@ export interface MappedTarget {
  * transition sliver — a color no pixel is ever assigned — and optimize that
  * fiction. Mirroring the collapse keeps the objective and the build consistent.
  */
-export function mapTargetsToPrintablePalette(
+/** Minimum ΔE between two printable colors for them to count as "distinct". */
+const SEPARATION_MIN_DE = 2;
+
+/**
+ * Injective ("preserve color separation") mapping: assign each weighted image
+ * color to a DISTINCT printable color so perceptibly different image colors are
+ * never collapsed onto the same surface color. Dominant colors (higher weight)
+ * pick first, so large regions get the closest match and smaller ones absorb
+ * the shift needed to stay distinct. When there are more image colors than the
+ * curve exposes distinct printable colors, the surplus falls back to nearest
+ * (and may collide) — the only case that cannot be fully separated.
+ */
+function mapTargetsWithSeparation(
     palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
     imageTargets: WeightedLab[]
+): MappedTarget[] {
+    // Distinct printable colors, keeping a representative entry for each.
+    const distinct: Array<{ lab: Lab; height: number; paletteIndex: number }> = [];
+    for (let i = 0; i < palette.length; i++) {
+        const entry = palette[i];
+        if (distinct.every((k) => optimizerColorDistance(k.lab, entry.lab) >= SEPARATION_MIN_DE)) {
+            distinct.push({ lab: entry.lab, height: entry.height, paletteIndex: i });
+        }
+    }
+
+    const result = new Array<MappedTarget>(imageTargets.length);
+    const used = new Set<number>();
+    // Assign dominant colors first.
+    const order = imageTargets.map((_, i) => i).sort((a, b) => imageTargets[b].weight - imageTargets[a].weight);
+    for (const i of order) {
+        const target = imageTargets[i];
+        let bestJ = -1;
+        let bestDistance = Infinity;
+        let fallbackJ = 0;
+        let fallbackDistance = Infinity;
+        for (let j = 0; j < distinct.length; j++) {
+            const de = optimizerColorDistance(distinct[j].lab, target);
+            if (de < fallbackDistance) {
+                fallbackDistance = de;
+                fallbackJ = j;
+            }
+            if (!used.has(j) && de < bestDistance) {
+                bestDistance = de;
+                bestJ = j;
+            }
+        }
+        const j = bestJ >= 0 ? bestJ : fallbackJ; // surplus colors reuse nearest
+        if (bestJ >= 0) used.add(j);
+        result[i] = {
+            target,
+            paletteIndex: distinct[j].paletteIndex,
+            mappedLab: distinct[j].lab,
+            projectedHeight: distinct[j].height,
+        };
+    }
+    return result;
+}
+
+export function mapTargetsToPrintablePalette(
+    palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
+    imageTargets: WeightedLab[],
+    options: { preserveSeparation?: boolean } = {}
 ): MappedTarget[] {
     if (palette.length === 0) return [];
 
+    // Separation mode: assign each distinct image color to a DISTINCT printable
+    // color so perceptibly different colors never collapse to one flat surface.
+    if (options.preserveSeparation) {
+        return mapTargetsWithSeparation(palette, imageTargets);
+    }
+
     // Collapse consecutive near-identical layers into flat-zone nodes (ΔE<0.5),
     // matching ThreeDView. Each node keeps its height range and an averaged Lab.
     const COLLAPSE_DE_SQ = 0.25; // 0.5^2
@@ -1217,12 +1282,13 @@ const USEFUL_PALETTE_MATCH_DE = 8;
  */
 export function scoreSequenceAgainstImage(
     palette: Array<{ height: number; lab: Lab; rgb: RGB }>,
-    imageTargets: WeightedLab[]
+    imageTargets: WeightedLab[],
+    options: { preserveSeparation?: boolean } = {}
 ): number {
     if (palette.length === 0) return Infinity;
     if (imageTargets.length === 0) return Infinity;
 
-    const mapped = mapTargetsToPrintablePalette(palette, imageTargets);
+    const mapped = mapTargetsToPrintablePalette(palette, imageTargets, options);
 
     // 1. Weighted realized color error (CIEDE2000), with a p95 tail term so a
     //    few rare conspicuous colors cannot be sacrificed to lower the mean.
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 627d8fe..ae0042b 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -63,6 +63,8 @@ export interface OptimizerOptions {
     maxExtraRepeats?: number;
     /** Transition opacity target used by the shared printable-palette scorer. */
     transitionOpacity?: number;
+    /** Assign each image color to a distinct printable color (no collapse). */
+    preserveSeparation?: boolean;
     seed?: number; // For deterministic results
     maxIterations?: number; // Algorithm-specific iteration limit
     temperature?: number; // Initial temperature for SA
@@ -90,6 +92,7 @@ export interface ScoringContext {
     firstLayerHeight: number;
     maxHeight?: number;
     transitionOpacity?: number;
+    preserveSeparation?: boolean;
 }
 
 // ============================================================================
@@ -167,6 +170,7 @@ function tuningFingerprint(options: OptimizerOptions) {
         allowRepeatedSwaps: options.allowRepeatedSwaps ?? false,
         maxExtraRepeats: options.maxExtraRepeats ?? null,
         transitionOpacity: options.transitionOpacity ?? null,
+        preserveSeparation: options.preserveSeparation ?? false,
         maxIterations: options.maxIterations ?? null,
         temperature: options.temperature ?? null,
         coolingRate: options.coolingRate ?? null,
@@ -242,7 +246,9 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
             );
             paletteCache.set(sequenceKey, palette);
         }
-        return scoreSequenceAgainstImage(palette, context.imageColors);
+        return scoreSequenceAgainstImage(palette, context.imageColors, {
+            preserveSeparation: context.preserveSeparation,
+        });
     };
 }
 
@@ -981,7 +987,12 @@ export function optimizeFilamentOrder(
     }
 
     let result: OptimizerResult;
-    const scoreSequence = createSequenceScorer(context);
+    // The scoring mode lives in OptimizerOptions; mirror it into the context the
+    // scorer reads so callers only need to set it in one place.
+    const scoreSequence = createSequenceScorer({
+        ...context,
+        preserveSeparation: opts.preserveSeparation ?? context.preserveSeparation,
+    });
 
     switch (resolved) {
         case 'exhaustive':
diff --git a/src/types/index.ts b/src/types/index.ts
index 99cac53..71f418c 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -49,6 +49,8 @@ export interface ThreeDControlsStateShape {
     paintMode: 'manual' | 'autopaint';
     // Enhanced color matching options
     enhancedColorMatch?: boolean;
+    /** Assign each image color to a distinct printable color (no collapse). */
+    preserveSeparation?: boolean;
     /** Legacy persisted value. Migrate to maxRepeatedSwaps when loading. */
     allowRepeatedSwaps?: boolean;
     /** Maximum extra non-adjacent filament occurrences the optimizer may add. */

From 9b60948cdadb0f68b0fc3268417206949325c27c Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 11:37:20 +0300
Subject: [PATCH 31/81] Add 8-color frontlit-calibrated profile fixture

---
 .../8_Colors_Frontlit_Calibrated.kfil         | 49 +++++++++++++++++++
 1 file changed, 49 insertions(+)
 create mode 100644 tests/assets/filament-profiles/8_Colors_Frontlit_Calibrated.kfil

diff --git a/tests/assets/filament-profiles/8_Colors_Frontlit_Calibrated.kfil b/tests/assets/filament-profiles/8_Colors_Frontlit_Calibrated.kfil
new file mode 100644
index 0000000..de4e1fb
--- /dev/null
+++ b/tests/assets/filament-profiles/8_Colors_Frontlit_Calibrated.kfil
@@ -0,0 +1,49 @@
+{
+  "id": "c2e9e401-d1bf-49c8-9166-1bdc487ffd64",
+  "name": "8 Colors Calibrated New",
+  "version": 1,
+  "filaments": [
+    {
+      "id": "p9c63ms",
+      "color": "#ffffff",
+      "td": 6.4
+    },
+    {
+      "id": "plvjtmc",
+      "color": "#000000",
+      "td": 0.8
+    },
+    {
+      "id": "98z555k",
+      "color": "#ff5ec4",
+      "td": 5.6
+    },
+    {
+      "id": "w8cncoa",
+      "color": "#f7d000",
+      "td": 4.8
+    },
+    {
+      "id": "vsn9q6u",
+      "color": "#d83400",
+      "td": 5.6
+    },
+    {
+      "id": "azwg1yp",
+      "color": "#6300c5",
+      "td": 4
+    },
+    {
+      "id": "xyyxysq",
+      "color": "#00b8c4",
+      "td": 4
+    },
+    {
+      "id": "upcjpfe",
+      "color": "#04bb00",
+      "td": 4
+    }
+  ],
+  "createdAt": 1782329253358,
+  "updatedAt": 1782329253358
+}
\ No newline at end of file

From bd7d734d53ac520bbd224b10a83d63e596090675 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 12:01:40 +0300
Subject: [PATCH 32/81] Trim Auto-paint settings helper UI

---
 src/components/AutoPaintTab.tsx | 95 ++-------------------------------
 1 file changed, 3 insertions(+), 92 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index fe07c40..ae048f6 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -29,7 +29,6 @@ import type { AutoPaintResult, TransitionZone } from '../lib/autoPaint';
 import type { AutoPaintProfile } from '../lib/profileManager';
 import type { AutoPaintRepeatLimit, AutoPaintTransitionOpacity, Filament, Swatch } from '../types';
 import type { CalibrationResult } from '../lib/calibration';
-import { getExactBaseOrderCount } from '../lib/optimizer';
 import FilamentRow from './FilamentRow';
 import { FilamentCalibrationWizard } from './FilamentCalibrationWizard';
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
@@ -40,70 +39,31 @@ type OptimizerTierValue = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 interface OptimizerTierMeta {
     value: OptimizerTierValue;
     label: string;
-    blurb: string;
-    /** Relative output quality, 1–5, for the inline meter. */
-    quality: number;
-    /** Relative speed, 1–5, for the inline meter (5 = fastest). */
-    speed: number;
 }
 
 const OPTIMIZER_TIERS: readonly OptimizerTierMeta[] = [
     {
         value: 'fast',
         label: 'Fast',
-        blurb: 'Narrow beam search for a quick preview.',
-        quality: 2,
-        speed: 5,
     },
     {
         value: 'balanced',
         label: 'Balanced',
-        blurb: 'Full deterministic beam search; the recommended default.',
-        quality: 3,
-        speed: 4,
     },
     {
         value: 'thorough',
         label: 'Thorough',
-        blurb: 'Full beam plus deeper multi-start refinement.',
-        quality: 4,
-        speed: 3,
     },
     {
         value: 'deep',
         label: 'Deep',
-        blurb: 'Wide beam plus a much broader deterministic search.',
-        quality: 5,
-        speed: 2,
     },
     {
         value: 'exact',
         label: 'Exact base order',
-        blurb: 'Enumerates every no-repeat base order.',
-        quality: 5,
-        speed: 1,
     },
 ];
 
-/** Small 5-segment bar used to convey relative speed / quality of a tier. */
-function TierMeter({ label, value }: { label: string; value: number }): React.ReactElement {
-    return (
-        <span className="flex items-center gap-1">
-            <span className="text-muted-foreground">{label}</span>
-            <span className="flex gap-0.5">
-                {Array.from({ length: 5 }, (_, i) => (
-                    <span
-                        key={i}
-                        className={`h-2 w-1 rounded-sm ${
-                            i < value ? 'bg-primary' : 'bg-muted-foreground/25'
-                        }`}
-                    />
-                ))}
-            </span>
-        </span>
-    );
-}
-
 interface AutoPaintSliceData {
     virtualSwatches: Swatch[];
     colorSliceHeights: number[];
@@ -258,17 +218,6 @@ export default function AutoPaintTab({
     const [localOptimizerSeed, setLocalOptimizerSeed] = React.useState(
         optimizerSeed?.toString() ?? ''
     );
-    const exactBaseOrderCount = getExactBaseOrderCount(filaments.length);
-    const activeTier =
-        OPTIMIZER_TIERS.find((tier) => tier.value === optimizerAlgorithm) ?? OPTIMIZER_TIERS[1];
-    const optimizerTierDescription =
-        optimizerAlgorithm === 'exact'
-            ? `Checks all ${exactBaseOrderCount.toLocaleString()} no-repeat base orders.${
-                  filaments.length > 8
-                      ? ' Large profiles can take a long time; start another search to cancel.'
-                      : ''
-              }`
-            : activeTier.blurb;
 
     // Calibration wizard state
     const [calibratingFilamentId, setCalibratingFilamentId] = React.useState<string | null>(null);
@@ -312,9 +261,6 @@ export default function AutoPaintTab({
             <Card className="p-4 border border-border/50">
                 <div className="space-y-1">
                     <h3 className="text-sm font-semibold text-foreground">Auto-paint</h3>
-                    <p className="text-xs text-muted-foreground">
-                        Define filament colors and transmission distances for automatic painting
-                    </p>
                 </div>
                 <div className="h-px bg-border/50 my-4" />
 
@@ -710,13 +656,6 @@ export default function AutoPaintTab({
                                         disabled={!enhancedColorMatch}
                                     />
                                 </div>
-                                {preserveSeparation && enhancedColorMatch && (
-                                    <p className="text-[10px] text-muted-foreground pl-0.5">
-                                        Maps every image color to a distinct printable color so
-                                        gradients keep their variation, at a small cost to per-color
-                                        accuracy.
-                                    </p>
-                                )}
                                 <div
                                     className={`flex items-center justify-between transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                                 >
@@ -811,15 +750,9 @@ export default function AutoPaintTab({
                             className={`space-y-3 pt-2 transition-opacity ${enhancedColorMatch ? 'opacity-100' : 'opacity-40 pointer-events-none'}`}
                         >
                             <div className="h-px bg-border/50" />
-                            <div className="space-y-1">
-                                <Label className="text-xs font-semibold text-foreground">
-                                    Optimizer Settings
-                                </Label>
-                                <p className="text-[10px] text-muted-foreground">
-                                    Advanced filament ordering optimization (requires enhanced color
-                                    matching)
-                                </p>
-                            </div>
+                            <Label className="text-xs font-semibold text-foreground">
+                                Optimizer Settings
+                            </Label>
                             <div className="space-y-2">
                                 <div className="flex items-center gap-2">
                                     <Label
@@ -852,24 +785,6 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
-                                <div className="pl-[120px] space-y-1.5">
-                                    <div className="flex items-center gap-3 text-[10px]">
-                                        <TierMeter label="Quality" value={activeTier.quality} />
-                                        <TierMeter label="Speed" value={activeTier.speed} />
-                                    </div>
-                                    <p className="text-[10px] text-muted-foreground">
-                                        {optimizerTierDescription}
-                                        {optimizerAlgorithm === 'exact' && maxRepeatedSwaps > 0 && (
-                                            <span>
-                                                {' '}
-                                                The base order is exact; up to {
-                                                    maxRepeatedSwaps
-                                                }{' '}
-                                                repeated swaps are refined heuristically.
-                                            </span>
-                                        )}
-                                    </p>
-                                </div>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="region-weighting"
@@ -936,10 +851,6 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
-                                <p className="text-[10px] text-muted-foreground pl-[120px]">
-                                    Higher opacity retains a longer physical color ramp, improving
-                                    color resolution at the cost of height, swaps, and runtime.
-                                </p>
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="optimizer-seed"

From a3b73260a5abb6ec518a4fba34b20f49c3cbcd38 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 12:32:13 +0300
Subject: [PATCH 33/81] Clean up v3.2 changelog entries

---
 CHANGELOG.md | 28 ++++++++--------------------
 1 file changed, 8 insertions(+), 20 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4d188fc..d725241 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,36 +6,24 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Preserve color separation (Auto-paint)** - New opt-in toggle (Enhanced color matching) that assigns every distinct image color to a distinct printable color, so perceptibly different colors are never collapsed onto one flat surface — gradients keep their variation. It trades a small amount of per-color accuracy for that separation and is fully reachable whenever the stack exposes at least as many distinct printable colors as the image has (raise the height if not). The optimizer scores and the 3D preview build through the same shared mapper, so they stay consistent.
+- **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface.
+- **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
+- **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
-- **Auto-paint regression baseline** - Added focused layer-invariant coverage, per-algorithm seeded determinism checks, and 24 seeded stack snapshots across the 2-, 4-, and 8-filament profiles, both image fixtures, Enhanced matching states, and repeated-swap states.
-- **Auto-paint benchmark harness** - Added an on-demand JSON benchmark that measures realized print error (CIEDE2000 mean, p95, and coverage) for both the uncompressed and the Max Height-compressed stack, plus the achievable palette floor, stack cost, compression impact, runtime, and optimizer iterations across the saved fixture profiles. It measures the printed result through the same canonical color-to-height mapper the optimizer scores with, instead of a separately-implemented projection.
-- **Auto-paint quality budgets** - Added realized-ΔE00 budget tests (weighted mean, p95 tail, and ΔE00≤6 coverage) for the printable, max-height-capped stack on the representative fixture profiles, guarding against optimizer-objective regressions even when intentional ordering changes update the goldens.
-- **Auto-paint optimization progress** - Enhanced matching now reports an approximate completion percentage while its background search is running.
 
 ### Changed
 
 - **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
-- **Auto-paint optimizer objective** - Enhanced color matching now evaluates the same zone-compressed, layer-snapped color-to-height path used by the printable preview. All optimizer algorithms share that scorer, including Max Height constraints, so selected filament orders better match the finished model. Repeated optical calculations are memoized during searches.
-- **Auto-paint detail controls** - Enhanced matching now scores every color from the already-processed 2D palette instead of applying a hidden second color reduction. Repeated swaps are now a selector with Off, 2, 4, 6, 8, and 12 extra occurrences; transition detail similarly exposes 80%, 90%, and 95% Beer-Lambert opacity endpoints so quality, stack height, and runtime are an intentional trade-off. Existing repeated-swap settings migrate to four extra occurrences.
-- **Height dithering kernel** - Height dithering now diffuses quantization error with the Stucki kernel (12 neighbors, error-conserving) instead of Floyd-Steinberg, spreading error over a wider area for smoother tonal gradients and finer apparent detail. Block-aware dot sizing and edge protection are unchanged.
-- **Calibrated Auto-paint model** - Calibrated filaments now use their measured red, green, and blue TD values when simulating blends and calculating transition-zone thickness, so generated stack heights and swap plans reflect the measured optical model.
-- **Auto-paint transition compositing** - Each filament transition now starts from the preceding transition's actual blended end color, including after Max Height compression, instead of assuming a pure previous-filament color.
-- **Auto-paint optical blending** - Beer-Lambert color mixing now happens in linear-light sRGB before returning display colors, replacing gamma-space interpolation with a more physically coherent light model.
-- **Filament calibration model** - Calibration now fits both working and RGB-channel TD values using Auto-paint's linear-light optical model. Recalibrate profiles created with earlier releases before using them for new prints.
-- **Auto-paint optimizer metric** - The optimizer now scores realized print error in CIEDE2000 (ΔE2000) instead of CIE76, and adds a weighted p95 tail term so a few rare but conspicuous colors are not sacrificed to lower the average. Nearest-color and Lab-polyline projection stay in Euclidean CIE76, where they are geometrically valid and fast. Selected filament orders change for some Enhanced color-match profiles.
-- **Auto-paint optimizer tiers** - Enhanced matching now offers five reproducible effort tiers: **Fast** (narrow beam preview), **Balanced** (the full-beam default), **Thorough** (deeper hybrid refinement), **Deep** (a wider, much larger hybrid search), and **Exact base order** (all no-repeat orders). Each higher tier preserves the best result from the preceding tier for the same seed. Exact remains available for every profile and reports its candidate count; with repeated swaps it remains exact for the base order while refining repeats separately. Saved values migrate automatically: legacy Exhaustive becomes Exact, Genetic becomes Deep, and Auto or Simulated Annealing becomes Balanced.
+- **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
+- **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Legacy saved values migrate to the nearest current tier.
+- **Auto-paint optical model** - Beer-Lambert blending now runs in linear-light sRGB, and calibrated filaments use measured RGB-channel TDs for blend simulation and transition-zone thickness. Recalibrate profiles created with earlier releases before using them for new prints.
+- **Height dithering kernel** - Height dithering now uses an error-conserving Stucki kernel instead of Floyd-Steinberg, spreading quantization error over a wider area while keeping the existing block-aware dot sizing and edge protection.
 
 ### Fixed
 
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
-
-- **Auto-paint optimizer cache and default seed** - Cache entries now include all target-color weights, every target cluster, and optimizer tuning values. Blank seeds now derive a stable value from the active inputs, making identical runs repeatable and cacheable instead of randomly changing.
-
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
-
-- **Auto-paint layer cap** - Corrected the slice-data safety limit so exceptionally tall auto-paint stacks stop at 500 layers rather than returning 501.
-
+- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters and tuning inputs, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
 ## v3.1.0 - 2026-06-18

From ca4dc7cec67e7d27a7e873c6aec242242fb7d041 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 25 Jun 2026 12:42:09 +0300
Subject: [PATCH 34/81] Make auto-paint height modes exclusive

---
 CHANGELOG.md                      |  2 +-
 README.md                         |  3 ++-
 src/components/ThreeDControls.tsx | 26 ++++++++++++++++++++++----
 src/docs/3d-mode.md               |  3 +++
 src/docs/settings-and-controls.md |  1 +
 5 files changed, 29 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d725241..06b98c6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface.
+- **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
diff --git a/README.md b/README.md
index 8c7c649..92b0358 100644
--- a/README.md
+++ b/README.md
@@ -181,7 +181,8 @@ Region weighting is most useful when filament budget is limited and you want the
 | **Max Height** | Constrains the total model height (mm). When set below the auto-calculated ideal, zones are uniformly compressed. Leave blank or click `Auto` for the physics-derived default. |
 | **Enhanced color matching** | Optimizes the printable filament sequence rather than simply sorting by luminance. It may omit filaments that do not improve the result and evaluates the actual preview color-to-height path. |
 | **Extra repeated swaps** | (Requires Enhanced color matching) Lets the optimizer use a filament more than once. Choose Off, 2, 4, 6, 8, or 12 additional occurrences; more repeats may create useful blend paths but substantially expand the search. |
-| **Height dithering** | (Requires Enhanced color matching) Applies block-aware Stucki error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. |
+| **Preserve color separation** | (Requires Enhanced color matching) Keeps distinct 2D image colors assigned to distinct printable colors when the stack has enough printable colors. Mutually exclusive with Height dithering. |
+| **Height dithering** | (Requires Enhanced color matching) Applies block-aware Stucki error diffusion to the quantized height map. Instead of sharp stair-steps between layer heights, dithering produces a stippled gradient that simulates intermediate heights, resulting in smoother tonal transitions in the print. Edge pixels between different heights are protected from dithering to avoid staircase artifacts. Mutually exclusive with Preserve color separation. |
 | **Flat Paint (flat face-down print)** | Builds a uniform-thickness slab printed image-side down instead of a stepped relief. Each pixel column's layer order is reversed so the artwork sits against the build plate (already mirrored — don't mirror in the slicer) under a transparent carrier layer, and the back is filled with the foundation filament so every layer has the full footprint. The result has a smooth, glass-flat face — great for bookmarks and coasters. Requires a multi-material printer (AMS/toolchanger); export as 3MF, which contains one object per filament plus the clear carrier object. Flat Paint and Smooth Meshing toggle each other off because flat prints always use the full-footprint slab layout. |
 | **Dither line width** | (Requires Height dithering) Controls the minimum dot size for the dither pattern in mm. This should roughly match your printer's line/nozzle width so dither dots are actually printable. Default: `0.42 mm`. |
 | **Optimizer algorithm** | Choose Fast for a preview, Balanced for the recommended full beam, Thorough or Deep for more search effort, or Exact base order when you want every no-repeat base stack checked. |
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index 54afd2a..d29597b 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -116,14 +116,17 @@ export default function ThreeDControls({
     const [paintMode, setPaintMode] = useState<'manual' | 'autopaint'>(initialPaintMode);
     const [autoPaintMaxHeight, setAutoPaintMaxHeight] = useState<number | undefined>(undefined);
     const [enhancedColorMatch, setEnhancedColorMatch] = useState(persisted?.enhancedColorMatch ?? false);
-    const [preserveSeparation, setPreserveSeparation] = useState(persisted?.preserveSeparation ?? false);
+    const initialPreserveSeparation = persisted?.preserveSeparation ?? false;
+    const [preserveSeparation, setPreserveSeparation] = useState(initialPreserveSeparation);
     const [maxRepeatedSwaps, setMaxRepeatedSwaps] = useState<AutoPaintRepeatLimit>(
         persisted?.maxRepeatedSwaps ?? (persisted?.allowRepeatedSwaps ? 4 : 0)
     );
     const [transitionOpacity, setTransitionOpacity] = useState<AutoPaintTransitionOpacity>(
         persisted?.transitionOpacity ?? 0.9
     );
-    const [heightDithering, setHeightDithering] = useState(persisted?.heightDithering ?? false);
+    const [heightDithering, setHeightDithering] = useState(
+        initialPreserveSeparation ? false : (persisted?.heightDithering ?? false)
+    );
     const [ditherLineWidth, setDitherLineWidth] = useState(persisted?.ditherLineWidth ?? 0.42);
     const [flatPaint, setFlatPaint] = useState(initialFlatPaint);
 
@@ -143,10 +146,25 @@ export default function ThreeDControls({
     const handleEnhancedColorMatchChange = useCallback((v: boolean) => {
         setEnhancedColorMatch(v);
         if (!v) {
+            setPreserveSeparation(false);
+            setHeightDithering(false);
+        }
+    }, []);
+
+    const handlePreserveSeparationChange = useCallback((enabled: boolean) => {
+        setPreserveSeparation(enabled);
+        if (enabled) {
             setHeightDithering(false);
         }
     }, []);
 
+    const handleHeightDitheringChange = useCallback((enabled: boolean) => {
+        setHeightDithering(enabled);
+        if (enabled) {
+            setPreserveSeparation(false);
+        }
+    }, []);
+
     const flatPaintActive = paintMode === 'autopaint' && flatPaint;
     const effectiveSmoothMeshing = flatPaintActive ? false : smoothMeshing;
 
@@ -484,13 +502,13 @@ export default function ThreeDControls({
                     enhancedColorMatch={enhancedColorMatch}
                     setEnhancedColorMatch={handleEnhancedColorMatchChange}
                     preserveSeparation={preserveSeparation}
-                    setPreserveSeparation={setPreserveSeparation}
+                    setPreserveSeparation={handlePreserveSeparationChange}
                     maxRepeatedSwaps={maxRepeatedSwaps}
                     setMaxRepeatedSwaps={setMaxRepeatedSwaps}
                     transitionOpacity={transitionOpacity}
                     setTransitionOpacity={setTransitionOpacity}
                     heightDithering={heightDithering}
-                    setHeightDithering={setHeightDithering}
+                    setHeightDithering={handleHeightDitheringChange}
                     ditherLineWidth={ditherLineWidth}
                     setDitherLineWidth={setDitherLineWidth}
                     flatPaint={flatPaint}
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 540405d..5054c20 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -76,11 +76,14 @@ Enable **Enhanced color matching** when filament order matters and you want Krom
 Optional controls appear with enhanced matching:
 
 - **Extra repeated swaps** chooses whether a filament may reappear, and lets you allow 2, 4, 6, 8, or 12 extra occurrences. More repeats can create useful blend paths but expand the search space.
+- **Preserve color separation** keeps distinct 2D image colors assigned to distinct printable colors when the stack has enough printable colors.
 - **Transition detail** chooses the opacity endpoint for each physical color transition: Compact stops at 80% opacity, Detailed at 90%, and Maximum at 95%. Higher settings create taller stacks with more printable intermediate colors.
 - **Height dithering** uses printable height dots to smooth tonal transitions.
 - **Line width** should roughly match the printer line or nozzle width used for dither dots.
 - **Optimizer Settings** let you choose **Algorithm**, **Region priority**, and an optional **Seed**.
 
+Preserve color separation and **Height dithering** are mutually exclusive. Turning one on turns the other off because both modes change how source colors map onto printable layer heights.
+
 Enhanced matching scores the palette that is already visible in 2D mode; it does not reduce that palette again. For detailed work, prepare the image in 2D first (for example, K-means with a weight of 128 and an Auto palette of 64 or 128 colors), then switch to Auto-paint. This keeps the 2D palette decision explicit, but more source colors make every optimizer tier slower.
 
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index f6a235a..6c30813 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -45,6 +45,7 @@ Auto-paint settings are preserved across sessions, including:
 - Filaments.
 - Paint mode.
 - Enhanced color matching.
+- Preserve color separation.
 - Repeated swaps.
 - Height dithering and line width.
 - Flat Paint.

From 8499a0089348c55c753040d2af403b0a80308e70 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 28 Jun 2026 18:38:22 +0300
Subject: [PATCH 35/81] Precompute auto-paint region weights and calibrate
 foundation

- Add createCenterWeight/createEdgeWeight factories that hoist all
  size-dependent terms once, and have useSwatches build them per image
  so the per-pixel swatch scan no longer recomputes exp/hypot per pixel.
- Use the least-opaque calibrated channel TD for the foundation layer
  so all channels reach ~95% opacity when the base filament is calibrated.
- Drop the production-dead generate*WeightedMapSimple helpers and retarget
  the region-weight test at the new factories.
---
 src/hooks/useSwatches.ts      |  10 +++-
 src/lib/autoPaint.ts          |   8 ++-
 src/lib/regionWeighting.ts    | 108 ++++++++++++++++------------------
 tests/regionWeighting.test.ts |  15 +++--
 4 files changed, 72 insertions(+), 69 deletions(-)

diff --git a/src/hooks/useSwatches.ts b/src/hooks/useSwatches.ts
index a246084..ba16083 100644
--- a/src/hooks/useSwatches.ts
+++ b/src/hooks/useSwatches.ts
@@ -1,6 +1,6 @@
 import { useEffect, useRef, useState } from 'react';
 import { rgbToHsl } from '../lib/color';
-import { centerWeightAt, edgeWeightAt } from '../lib/regionWeighting';
+import { createCenterWeight, createEdgeWeight } from '../lib/regionWeighting';
 
 // Manages swatch computation with cancellation & immediate override
 export interface SwatchEntry {
@@ -61,6 +61,10 @@ export function useSwatches(imageSrc: string | null) {
                 const w = img.naturalWidth;
                 const h = img.naturalHeight;
                 setImageDimensions({ width: w, height: h, opaqueWidth: w, opaqueHeight: h });
+                // Precompute the size-dependent weighting terms once so the
+                // per-pixel scan below stays a couple of multiplies per call.
+                const centerWeightFor = createCenterWeight(w, h);
+                const edgeWeightFor = createEdgeWeight(w, h);
                 const TILE = 1024;
                 const map = new Map<
                     number,
@@ -107,8 +111,8 @@ export function useSwatches(imageSrc: string | null) {
                             const g = data[i + 1];
                             const b = data[i + 2];
                             const key = ((r << 24) | (g << 16) | (b << 8) | a) >>> 0;
-                            const centerWeight = centerWeightAt(px, py, w, h);
-                            const edgeWeight = edgeWeightAt(px, py, w, h);
+                            const centerWeight = centerWeightFor(px, py);
+                            const edgeWeight = edgeWeightFor(px, py);
                             const existing = map.get(key);
                             if (existing) {
                                 existing.count++;
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 15707cc..4e2ff39 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -519,7 +519,13 @@ export function calculateIdealHeight(
     //   0.05 = 10^(-thickness/TD)  →  thickness = TD × log10(20) ≈ TD × 1.3
     // Dark filaments have low TD (e.g. 0.5mm) → foundation ≈ 0.65mm
     const firstFilament = sortedFilaments[0];
-    const opacityThickness = firstFilament.td * 1.3; // 95% opaque
+    // Use the least-opaque (largest) calibrated channel TD when available so
+    // every channel reaches ~95% opacity; fall back to the scalar working TD.
+    const firstFilamentChannels = calibratedTdChannels(firstFilament);
+    const foundationTd = firstFilamentChannels
+        ? Math.max(...firstFilamentChannels)
+        : firstFilament.td;
+    const opacityThickness = foundationTd * 1.3; // 95% opaque
     // Ensure at least the base thickness (avoid unnecessary extra layers)
     const foundationThickness = Math.max(baseThickness, opacityThickness);
 
diff --git a/src/lib/regionWeighting.ts b/src/lib/regionWeighting.ts
index 37f9d45..5e8d8db 100644
--- a/src/lib/regionWeighting.ts
+++ b/src/lib/regionWeighting.ts
@@ -22,19 +22,8 @@ export interface RegionWeightOptions {
 
 const DEFAULT_CENTER_WEIGHT_STRENGTH = 0.5;
 
-function normalizedDistanceAt(x: number, y: number, width: number, height: number): number {
-    const centerX = width / 2;
-    const centerY = height / 2;
-    const maxDistance = Math.hypot(centerX, centerY);
-
-    if (maxDistance === 0) return 0;
-    return Math.hypot(x - centerX, y - centerY) / maxDistance;
-}
-
-function normalizedWeight(raw: number, min: number, max: number): number {
-    const range = max - min;
-    return range > 0 ? (raw - min) / range : 1;
-}
+/** A spatial weight lookup bound to a fixed image size. */
+export type SpatialWeight = (x: number, y: number) => number;
 
 function nearestCenterDistance(width: number, height: number): number {
     const nearestX = Math.abs(Math.floor(width / 2) - width / 2);
@@ -43,26 +32,65 @@ function nearestCenterDistance(width: number, height: number): number {
     return maxDistance > 0 ? Math.hypot(nearestX, nearestY) / maxDistance : 0;
 }
 
-/** Scalar equivalent of generateCenterWeightedMapSimple. */
-export function centerWeightAt(
-    x: number,
-    y: number,
+/**
+ * Build a center-priority weight function for a fixed image size. Every term
+ * that depends only on the size (fall-off denominator, normalization bounds,
+ * max distance) is computed once, so the returned closure is cheap enough to
+ * call for every pixel of a full-resolution image.
+ */
+export function createCenterWeight(
     width: number,
     height: number,
     strength: number = DEFAULT_CENTER_WEIGHT_STRENGTH
-): number {
+): SpatialWeight {
+    const centerX = width / 2;
+    const centerY = height / 2;
+    const maxDistance = Math.hypot(centerX, centerY);
     const denominator = 2 * (1 - strength);
-    const raw = Math.exp(-(normalizedDistanceAt(x, y, width, height) ** 2 / denominator));
     const min = Math.exp(-1 / denominator);
     const max = Math.exp(-(nearestCenterDistance(width, height) ** 2 / denominator));
+    const range = max - min;
 
-    return normalizedWeight(raw, min, max);
+    return (x, y) => {
+        const distance = maxDistance === 0 ? 0 : Math.hypot(x - centerX, y - centerY) / maxDistance;
+        const raw = Math.exp(-(distance ** 2 / denominator));
+        return range > 0 ? (raw - min) / range : 1;
+    };
 }
 
-/** Scalar equivalent of generateEdgeWeightedMapSimple. */
+/**
+ * Build an edge-priority weight function for a fixed image size. Mirrors
+ * createCenterWeight: the size-dependent normalization bounds are precomputed
+ * once so per-pixel calls stay cheap.
+ */
+export function createEdgeWeight(width: number, height: number): SpatialWeight {
+    const centerX = width / 2;
+    const centerY = height / 2;
+    const maxDistance = Math.hypot(centerX, centerY);
+    const min = nearestCenterDistance(width, height) ** 1.35;
+    const range = 1 - min;
+
+    return (x, y) => {
+        const distance = maxDistance === 0 ? 0 : Math.hypot(x - centerX, y - centerY) / maxDistance;
+        const raw = distance ** 1.35;
+        return range > 0 ? (raw - min) / range : 1;
+    };
+}
+
+/** Scalar center-priority weight. Prefer createCenterWeight for hot loops. */
+export function centerWeightAt(
+    x: number,
+    y: number,
+    width: number,
+    height: number,
+    strength: number = DEFAULT_CENTER_WEIGHT_STRENGTH
+): number {
+    return createCenterWeight(width, height, strength)(x, y);
+}
+
+/** Scalar edge-priority weight. Prefer createEdgeWeight for hot loops. */
 export function edgeWeightAt(x: number, y: number, width: number, height: number): number {
-    const raw = normalizedDistanceAt(x, y, width, height) ** 1.35;
-    return normalizedWeight(raw, nearestCenterDistance(width, height) ** 1.35, 1);
+    return createEdgeWeight(width, height)(x, y);
 }
 
 // ============================================================================
@@ -111,40 +139,6 @@ export function generateWeightMap(
     return weights;
 }
 
-/**
- * Generate center-weighted importance map using Gaussian fall-off.
- * Center of image has weight 1.0, edges fade based on strength parameter.
- */
-export function generateCenterWeightedMapSimple(
-    width: number,
-    height: number,
-    strength: number = 0.5
-): Float32Array {
-    const weights = new Float32Array(width * height);
-
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            weights[y * width + x] = centerWeightAt(x, y, width, height, strength);
-        }
-    }
-    return weights;
-}
-
-/**
- * Generate a simple edge-priority map from geometry only.
- * Weights increase toward the image borders and are normalized to 0-1.
- */
-export function generateEdgeWeightedMapSimple(width: number, height: number): Float32Array {
-    const weights = new Float32Array(width * height);
-
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            weights[y * width + x] = edgeWeightAt(x, y, width, height);
-        }
-    }
-    return weights;
-}
-
 /**
  * Generate center-weighted importance map using Gaussian fall-off.
  * Center of image has weight 1.0, edges fade based on strength parameter.
diff --git a/tests/regionWeighting.test.ts b/tests/regionWeighting.test.ts
index 0ea304f..1545620 100644
--- a/tests/regionWeighting.test.ts
+++ b/tests/regionWeighting.test.ts
@@ -6,9 +6,9 @@ import { createServer } from 'vite';
 
 import {
     centerWeightAt,
+    createCenterWeight,
+    createEdgeWeight,
     edgeWeightAt,
-    generateCenterWeightedMapSimple,
-    generateEdgeWeightedMapSimple,
 } from '../src/lib/regionWeighting.ts';
 
 type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
@@ -38,21 +38,20 @@ async function loadViteModule<T>(modulePath: string): Promise<T> {
     }
 }
 
-test('scalar region weights match the existing center and edge maps', () => {
+test('precomputed weight factories match the scalar helpers exactly', () => {
     for (const [width, height] of [
         [1, 1],
         [4, 4],
         [5, 3],
         [16, 9],
     ]) {
-        const center = generateCenterWeightedMapSimple(width, height);
-        const edge = generateEdgeWeightedMapSimple(width, height);
+        const center = createCenterWeight(width, height);
+        const edge = createEdgeWeight(width, height);
 
         for (let y = 0; y < height; y++) {
             for (let x = 0; x < width; x++) {
-                const index = y * width + x;
-                assert.ok(Math.abs(center[index] - centerWeightAt(x, y, width, height)) < 1e-6);
-                assert.ok(Math.abs(edge[index] - edgeWeightAt(x, y, width, height)) < 1e-6);
+                assert.ok(Math.abs(center(x, y) - centerWeightAt(x, y, width, height)) < 1e-12);
+                assert.ok(Math.abs(edge(x, y) - edgeWeightAt(x, y, width, height)) < 1e-12);
             }
         }
     }

From 8242167e616110424440af770f9bb3970de2fd82 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 29 Jun 2026 19:06:54 +0300
Subject: [PATCH 36/81] Drop the unused stored calibration transmission field

The TD fit derives transmission from each measurement's RGB via the
linear-light blend inverse, so the stored measurement.transmission field
was written (by the legacy pure-ratio rgbToTransmission model) but never
read. The validation it fed could never fail because rgbToTransmission
clamps its own output to [0,1].

Collapse to one transmission model:
- Remove the transmission field from CalibrationMeasurement.
- Remove rgbToTransmission and normalizeCalibrationMeasurements.
- Drop the can't-fail transmission bounds check from validateMeasurement.
- importCalibration now strips measurements to {layers, rgb}, dropping the
  legacy key from older exports.

No behavior or UI change: the field never affected the fit and was not
displayed. Old profiles still load.
---
 src/components/FilamentCalibrationWizard.tsx | 12 +---
 src/lib/calibration.ts                       | 59 ++++++--------------
 tests/calibration.test.ts                    |  8 ---
 3 files changed, 19 insertions(+), 60 deletions(-)

diff --git a/src/components/FilamentCalibrationWizard.tsx b/src/components/FilamentCalibrationWizard.tsx
index beb19bb..b757a1e 100644
--- a/src/components/FilamentCalibrationWizard.tsx
+++ b/src/components/FilamentCalibrationWizard.tsx
@@ -24,8 +24,6 @@ import { cn } from '@/lib/utils';
 import {
     calculateTDFromMeasurements,
     DEFAULT_WHITE_REFERENCE,
-    normalizeCalibrationMeasurements,
-    rgbToTransmission,
     getCalibrationInstructions,
     getRecommendedLayerCounts,
     canCalculateTD,
@@ -267,18 +265,16 @@ export function FilamentCalibrationWizard({
         const b = Math.max(0, Math.min(255, Number.parseInt(currentRGB.b, 10) || 0));
 
         const rgb: CalibrationRgb = [r, g, b];
-        const transmission = rgbToTransmission(rgb, whiteReference);
 
         const newMeasurement: CalibrationMeasurement = {
             layers,
             rgb,
-            transmission,
         };
 
         setMeasurements((prev) => [...prev, newMeasurement]);
         setCurrentLayers('');
         setCurrentRGB({ r: '', g: '', b: '' });
-    }, [currentLayers, currentRGB, whiteReference]);
+    }, [currentLayers, currentRGB]);
 
     const handleRemoveMeasurement = useCallback((index: number) => {
         setMeasurements((prev) => prev.filter((_, i) => i !== index));
@@ -292,10 +288,6 @@ export function FilamentCalibrationWizard({
         }
 
         try {
-            const normalizedMeasurements = normalizeCalibrationMeasurements(
-                measurements,
-                whiteReference
-            );
             const { td, tdSingleValue, confidence } = calculateTDFromMeasurements(
                 measurements,
                 calibrationLayerHeight,
@@ -305,7 +297,7 @@ export function FilamentCalibrationWizard({
 
             const calibrationResult: CalibrationResult = {
                 color: filamentColor,
-                measurements: normalizedMeasurements,
+                measurements,
                 whiteReference,
                 td,
                 tdSingleValue,
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index fabf992..889358e 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -19,14 +19,18 @@ import { blendSrgbChannel, srgbChannelToLinear } from './colorSpace';
 // ============================================================================
 
 /**
- * Single measurement point: layer count and measured transmission
+ * Single measurement point: layer count and measured RGB.
+ *
+ * Transmission is intentionally NOT stored. It is a derived quantity, and the
+ * TD fit recomputes it from `rgb` using the same linear-light blend model
+ * Auto-paint uses (see transmissionFromMeasuredBlend), so there is no second,
+ * divergent definition to keep in sync.
  */
 export type CalibrationRgb = [number, number, number];
 
 export interface CalibrationMeasurement {
     layers: number; // Number of layers printed
     rgb: CalibrationRgb; // Measured RGB value (0-255)
-    transmission: CalibrationRgb; // Normalized linear-light transmission (0-1)
 }
 
 /**
@@ -97,16 +101,6 @@ export function validateWhiteReference(whiteReference: CalibrationRgb): {
     return { valid: true };
 }
 
-export function normalizeCalibrationMeasurements(
-    measurements: CalibrationMeasurement[],
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
-): CalibrationMeasurement[] {
-    return measurements.map((measurement) => ({
-        ...measurement,
-        transmission: rgbToTransmission(measurement.rgb, whiteReference),
-    }));
-}
-
 const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value));
 
 function getBlendChannelWeights(
@@ -309,8 +303,7 @@ export function calculateTDFromMeasurements(
     }
 
     // Sort measurements by layer count
-    const normalizedMeasurements = normalizeCalibrationMeasurements(measurements, whiteReference);
-    const sorted = normalizedMeasurements.sort((a, b) => a.layers - b.layers);
+    const sorted = [...measurements].sort((a, b) => a.layers - b.layers);
 
     // Compute TD for each channel independently
     const tdChannels: [number, number, number] = [0, 0, 0];
@@ -408,22 +401,6 @@ function fitTDForChannel(
     return { td: tdFitted, confidence };
 }
 
-/**
- * Convert measured RGB values to normalized linear-light transmission values.
- * Uses a measured white reference so camera and backlight tint are normalized out.
- */
-export function rgbToTransmission(
-    rgb: CalibrationRgb,
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
-): CalibrationRgb {
-    const reference = sanitizeWhiteReference(whiteReference);
-    return [
-        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[0]) / srgbChannelToLinear(reference[0]))),
-        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[1]) / srgbChannelToLinear(reference[1]))),
-        Math.max(0, Math.min(1, srgbChannelToLinear(rgb[2]) / srgbChannelToLinear(reference[2]))),
-    ];
-}
-
 /**
  * Estimate expected RGB for a given layer count based on current TD estimate.
  * Useful for showing preview during calibration.
@@ -529,8 +506,7 @@ export function getConfidenceColor(confidence: number): string {
  * Validate a calibration measurement
  */
 export function validateMeasurement(
-    measurement: CalibrationMeasurement,
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
+    measurement: CalibrationMeasurement
 ): { valid: boolean; error?: string } {
     if (measurement.layers < 1 || measurement.layers > 50) {
         return { valid: false, error: 'Layer count must be between 1 and 50' };
@@ -541,11 +517,6 @@ export function validateMeasurement(
         return { valid: false, error: 'RGB values must be between 0 and 255' };
     }
 
-    const [tR, tG, tB] = rgbToTransmission(measurement.rgb, whiteReference);
-    if (tR < 0 || tR > 1 || tG < 0 || tG > 1 || tB < 0 || tB > 1) {
-        return { valid: false, error: 'Transmission values must be between 0 and 1' };
-    }
-
     return { valid: true };
 }
 
@@ -579,7 +550,7 @@ export function canCalculateTD(
 
     // Validate each measurement
     for (const measurement of measurements) {
-        const validation = validateMeasurement(measurement, whiteReference);
+        const validation = validateMeasurement(measurement);
         if (!validation.valid) {
             return { ready: false, reason: validation.error };
         }
@@ -665,12 +636,16 @@ export function importCalibration(json: string): CalibrationResult {
 
     const whiteReference = (parsed.whiteReference as CalibrationRgb | undefined) ?? undefined;
 
+    // Keep only the fields we model; this also drops the legacy `transmission`
+    // key that older exports stored alongside each measurement.
+    const measurements = (parsed.measurements as CalibrationMeasurement[]).map(({ layers, rgb }) => ({
+        layers,
+        rgb,
+    }));
+
     return {
         ...(parsed as CalibrationResult),
         whiteReference,
-        measurements: normalizeCalibrationMeasurements(
-            parsed.measurements as CalibrationMeasurement[],
-            whiteReference ?? DEFAULT_WHITE_REFERENCE
-        ),
+        measurements,
     };
 }
diff --git a/tests/calibration.test.ts b/tests/calibration.test.ts
index 1999f26..6306e8a 100644
--- a/tests/calibration.test.ts
+++ b/tests/calibration.test.ts
@@ -68,11 +68,6 @@ test('calibration predictions use Auto-paint’s linear-light transmission model
         Math.round(autoPaintBlend.g),
         Math.round(autoPaintBlend.b),
     ]);
-
-    const normalizedTransmission = calibration.rgbToTransmission(predicted);
-    for (const channel of normalizedTransmission) {
-        assertClose(channel, 0.5, 0.01, 'measurement transmission must be decoded in linear light');
-    }
 });
 
 test('calibration recovers channel TDs from linear-light patch measurements', async () => {
@@ -90,9 +85,6 @@ test('calibration recovers channel TDs from linear-light patch measurements', as
             knownTd,
             whiteReference
         ),
-        // The fit must derive transmission from the RGB observations, rather
-        // than trusting a cached value created with an earlier color model.
-        transmission: [0, 0, 0] as [number, number, number],
     }));
 
     const result = calibration.calculateTDFromMeasurements(

From cf1dbbdbb1efc9b0bbb3b3af18cb686180b9c36e Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 29 Jun 2026 19:26:58 +0300
Subject: [PATCH 37/81] Add reference to AGENTS.md in CLAUDE.md

---
 CLAUDE.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..eef4bd2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
\ No newline at end of file

From 354f736c9565c563a60018193915a0be60ecd5c6 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 2 Jul 2026 08:17:50 +0300
Subject: [PATCH 38/81] Replace photo calibration with frontlit opacity-read
 calibration

Scrap the backlit photo/RGB-sample calibration wizard for a camera-free
workflow: pick filaments, choose a base layer per filament (defaults to the
darkest), print a wedge over that base beside an opaque reference rail, and
read back the single layer count at which each filament reaches opacity. That
read converts to a frontlit Transmission Distance via a perceptual (CIEDE2000
just-noticeable-difference) opacity model - no camera, no color picking. The
recovered TD is a material property, so it transfers regardless of base color.

- calibration.ts: solveOpacityTransmission (per-color T* from the JND, over any
  base), computeFrontlitCalibration, deriveChannelTds, predictFrontlitColor.
- colorDifference.ts: standalone CIEDE2000 on triplets (avoids an autoPaint cycle).
- generateCalibrationPrint.ts: rounded-prism wedge + continuous edge rail +
  orientation foot; STL (single solid) and multi-material 3MF that maps parts to
  real profile-filament slots in profile order (no phantom base, arrangeable tiles).
- FilamentCalibrationDialog: select -> base -> print -> measure, with select-all
  and a live predicted-vs-reference preview.
- autoPaint uses measured frontlit TDs and drops FRONTLIT_TD_SCALE for calibrated
  filaments; Filament.calibration is now FrontlitCalibration.
- Remove the photo wizard, the old patch-STL generator, and the old test.
- Tests: frontlitCalibration (opacity/base round-trips) + calibrationPrint (STL/3MF
  structure); updated auto-paint/optimizer fixtures.
- Docs + changelog; design notes in .agents.

Breaking: old calibration data no longer maps and is dropped on load; recalibrate.
---
 .agents/calibration-improvements.md          |  238 ++++
 CHANGELOG.md                                 |    1 +
 src/components/AutoPaintTab.tsx              |   75 +-
 src/components/FilamentCalibrationDialog.tsx |  702 +++++++++++
 src/components/FilamentCalibrationWizard.tsx | 1085 ------------------
 src/components/FilamentRow.tsx               |   37 +-
 src/components/ThreeDControls.tsx            |    1 +
 src/docs/3d-mode.md                          |   13 +-
 src/docs/troubleshooting.md                  |    2 +-
 src/lib/autoPaint.ts                         |   26 +-
 src/lib/calibration.ts                       |  747 ++++--------
 src/lib/colorDifference.ts                   |  121 ++
 src/lib/generateCalibrationPatchesStl.ts     |   93 --
 src/lib/generateCalibrationPrint.ts          |  615 ++++++++++
 src/types/index.ts                           |    4 +-
 tests/autoPaint.test.ts                      |   14 +-
 tests/calibration.test.ts                    |  101 --
 tests/calibrationPrint.test.ts               |  111 ++
 tests/frontlitCalibration.test.ts            |  217 ++++
 tests/optimizer.test.ts                      |    7 +-
 20 files changed, 2287 insertions(+), 1923 deletions(-)
 create mode 100644 .agents/calibration-improvements.md
 create mode 100644 src/components/FilamentCalibrationDialog.tsx
 delete mode 100644 src/components/FilamentCalibrationWizard.tsx
 create mode 100644 src/lib/colorDifference.ts
 delete mode 100644 src/lib/generateCalibrationPatchesStl.ts
 create mode 100644 src/lib/generateCalibrationPrint.ts
 delete mode 100644 tests/calibration.test.ts
 create mode 100644 tests/calibrationPrint.test.ts
 create mode 100644 tests/frontlitCalibration.test.ts

diff --git a/.agents/calibration-improvements.md b/.agents/calibration-improvements.md
new file mode 100644
index 0000000..3927eb6
--- /dev/null
+++ b/.agents/calibration-improvements.md
@@ -0,0 +1,238 @@
+# Calibration redesign — print-and-read-back
+
+Status: design / detailed outline. Not implemented yet. Supersedes the earlier
+photo-based outline in this file.
+
+## Decision: scrap the photo-based calibration
+
+The current system ([`src/lib/calibration.ts`](../src/lib/calibration.ts),
+[`src/components/FilamentCalibrationWizard.tsx`](../src/components/FilamentCalibrationWizard.tsx))
+asks users to photograph backlit patches and sample RGB. It is being **removed**:
+
+- Hard to make accurate (lighting, white balance, monitor, single-pixel samples).
+- Bad UX (cameras, color pickers, manual RGB entry).
+- It measures *backlit* transmission, but prints are viewed *frontlit*, so the
+  result is then mangled by a magic constant
+  ([`FRONTLIT_TD_SCALE = 0.1`](../src/lib/autoPaint.ts#L395)).
+
+## New shape (the big outline, with decisions made)
+
+1. User selects one or more filaments from a profile and hits **Calibrate**.
+2. App generates a **calibration print** (STL *or* 3MF + instructions) to download.
+3. User prints it.
+4. User **reads numbers off the physical print** and types them back into the app.
+5. App fits a frontlit TD per filament and writes it onto the profile. Auto-paint
+   and the preview use it directly — no more `FRONTLIT_TD_SCALE`.
+
+Locked design decisions (from user):
+
+- **Read-back = read a number off the print.** No camera. The user's eye reads a
+  *threshold*, which is robust to lighting and monitor calibration (the exact
+  weaknesses that sank the photo flow).
+- **Base = fixed black.** Wedges print over a black base, matching the common
+  frontlit base. No base-color picker in v1.
+- **Format = user chooses** 3MF (multi-material, AMS-friendly) or STL (+ swap
+  instructions, universal).
+
+---
+
+## The core mechanism: opacity threshold vs. an adjacent reference
+
+The single most valuable, eye-readable quantity for a frontlit print is **how many
+layers it takes for the filament to fully hide the black base** (its opacity
+point). One number per filament pins the optical curve far better than the current
+global 0.1 fudge.
+
+Why this is robust where color-matching/photos are not: the user is not judging an
+absolute color against a monitor. They compare each wedge step to a **fully-opaque
+reference patch of the same filament printed right next to the wedge**, and report
+the first step that is *indistinguishable from the reference*. Relative
+"same/not-same" judgments against an adjacent physical reference are reliable under
+almost any lighting.
+
+```
+Filament A wedge (over black base):           Reference
+ layers: 1   2   3   4   5   6   7   8        (~20 layers,
+        [▓] [▒] [░] [.] [ ] [ ] [ ] [ ]   |   fully opaque)
+         black showing through ──► full color    [█]
+
+App asks: "Find the first patch that looks the same as the reference block."
+User types: 6
+```
+
+**One read only.** A second "mid-fade" read was considered and dropped: a partial-
+transmission point has no sharp visual cue — there's nothing to compare it against,
+so the eye can't place it accurately (the whole reason the opacity read works is the
+adjacent fully-opaque reference). The opacity threshold is the single number.
+
+### Print geometry (per filament)
+
+- A row of square patches, patch *i* = *i* layers of the filament, *i = 1..N*.
+- All patches sit on a shared **black base** (enough black layers to be opaque on
+  its own, e.g. 4–6).
+- One tall **reference patch** (same filament, ~20 layers / guaranteed opaque)
+  adjacent to the wedge.
+- Unambiguous orientation + indexing: leftmost patch = 1 layer; add an asymmetric
+  corner marker so the user can't read it backwards, and show the matching layout
+  diagram in the app. (Tiny embossed digits don't print reliably — rely on
+  position + the in-app legend, not printed numbers.)
+- Patch size ~12–15 mm so steps are easy to compare by eye.
+
+### From a number to a TD (the fit)
+
+- **Thickness must use the real layer-height model, not `layers × layerHeight`.**
+  Auto-paint's first printed layer is `printableFirstLayerHeight = max(layerHeight,
+  firstLayerHeight)`, every layer after is `layerHeight`
+  ([`autoPaint.ts`](../src/lib/autoPaint.ts#L648)). The calibration generator, the
+  TD fit, and auto-paint must all share this one conversion or the TD is biased.
+  - In the calibration print the color wedge sits **on top of the black base**, so
+    its layers are all regular `layerHeight`; the black base's bottom layer takes
+    the first-layer height (for printability, doesn't affect color thickness).
+  - `d_opaque = opacityLayers × layerHeight`. Store `firstLayerHeight` +
+    `layerHeight` with the calibration so the number stays interpretable if print
+    settings change later.
+- The read maps to TD through a **per-color "effective opacity transmission" `T*`**
+  derived from a perceptual just-noticeable-difference (JND), not a hand-picked
+  number. Two decoupled steps:
+  1. Solve `ΔE00(blendSrgbChannel(0, filament, T), filament) = JND` for `T*`.
+     Depends only on the filament's own swatch color + the JND (ΔE00 is monotonic
+     in T → unique; bisection). `T*` is *not* a function of TD.
+  2. `TD = -d_opaque / log10(T*)`.
+  This is the same `TD = -d/log10(T_opaque)` form as before, but `T_opaque = T*` is
+  *computed per filament* instead of guessed — so a bright filament (small `T*`)
+  gets a large TD and a dark one (large `T*`) a small TD automatically. The blend
+  and ΔE00 are the exact functions the optimizer already uses.
+- **JND is a standard human-vision constant** (CIEDE2000 JND ≈ 1; use ~1–2.5 to
+  absorb lighting/observer spread). It is NOT fit to any filament — per-filament
+  optics are captured by the read itself. Brand/batch/compound variation needs no
+  constant change; changing filament just means re-reading that filament.
+- Model boundary: single-TD Beer-Lambert assumes absorption, no scattering, so the
+  read pins the *endpoint* accurately but intermediate-layer color may drift — that
+  drift is Phase 2's job, not this fit's.
+- Confidence = simple function of whether the resulting TD lands in a plausible
+  range. No more per-channel least-squares from RGB samples.
+
+### Per-channel TD — derive RGB channel TDs from the single read
+
+Auto-paint consumes calibrated per-channel TDs
+([`USE_CALIBRATED_CHANNEL_TD`](../src/lib/autoPaint.ts#L396),
+`calibratedTdChannels`), so we keep that path alive by **computing the single TD
+and converting it to RGB channel TDs** using the filament's own swatch color.
+
+Physical basis: over a black base, the visible color settles channel-by-channel.
+The brightest channel is the *most transmissive* (largest TD) and therefore the
+**last** to reach full color — so the opacity the eye reads is governed by that
+channel. That makes the brightest channel the natural anchor for the measured TD.
+
+Proposed conversion (deterministic, reuses the existing heuristic shape from
+[`estimateTDFromColor`](../src/lib/colorUtils.ts#L39) = `1.0 + luminance*5.8`):
+
+1. Per channel, raw TD shape `rawTD_c = 1.0 + c_norm*5.8`, where `c_norm ∈ [0,1]`
+   is that channel of the filament swatch.
+2. Anchor on the brightest channel: `k = TD_measured / rawTD_{argmax c}`.
+3. `td_c = k * rawTD_c` for R, G, B. `tdSingleValue = TD_measured`.
+
+This preserves the color-driven per-channel *ratios* while pinning the overall
+magnitude to the measurement. The exact ratio model is a knob to validate against
+the 7-color frontlit set; the structure (single read → channels) is fixed.
+
+---
+
+## Generating the print
+
+Extend [`generateCalibrationPatchesStl.ts`](../src/lib/generateCalibrationPatchesStl.ts)
+(already builds patch rows) to add: the black base layers, the reference patch,
+the orientation marker, and a 3MF variant.
+
+- **3MF:** reuse the app's existing multi-material 3MF export path. Materials =
+  black base + each selected filament. Slicer auto-assigns; minimal instructions.
+- **STL:** geometry only + generated text instructions ("load black, print to
+  layer X; swap to filament A; …"). Universal, manual swaps.
+- **Multi-filament layout & swap burden:** one wedge+reference block per filament,
+  tiled in a grid. Single-extruder users would face many swaps for a combined
+  print (black + N colors). Decision: default to **one block per filament file**
+  for non-AMS (each = black + 1 color = a single swap), and offer a **combined
+  tiled file** for AMS/multi-material users. The "let the user choose format"
+  decision pairs naturally with a "combined vs per-filament" toggle.
+
+---
+
+## UX flow
+
+1. **Profile UI → Calibrate.** Multi-select filaments (checkboxes).
+2. **Configure:** layer height (from print settings), max layers N (default ~10–12),
+   patch size; base is black (fixed); pick 3MF/STL and combined/per-filament.
+3. **Generate & download** + show printable instructions (viewing conditions,
+   how to find the opacity patch vs the reference, orientation).
+4. **Enter results:** a list of the selected filaments, each with an "opacity
+   patch #" input (and optional second read). A live predicted swatch updates as
+   they type so they get immediate feedback.
+5. **Save:** frontlit TD written to each profile; preview + auto-paint update.
+
+---
+
+## Integration & data
+
+- [`src/lib/autoPaint.ts`](../src/lib/autoPaint.ts): **remove `FRONTLIT_TD_SCALE`**.
+  Measured TD is already frontlit-correct. For uncalibrated filaments, re-baseline
+  the default frontlit TD (today's `estimateTDFromColor` heuristic was implicitly a
+  backlit value scaled by 0.1 — that baseline must be re-derived).
+- [`src/types/index.ts`](../src/types/index.ts): replace the calibration shape.
+  New `FrontlitCalibration { opacityLayers, td: [r,g,b], tdSingleValue,
+  layerHeight, firstLayerHeight, basis: 'black-frontlit', printedAt, notes? }`.
+  Remove `measurements`, `whiteReference`, and all RGB-sample fields.
+
+### Breaking changes are fine — no deprecation, aggressive removal
+
+The user has OK'd breaking changes with **no migration notice**. So:
+- **Delete** `FilamentCalibrationWizard.tsx` entirely.
+- **Gut** `calibration.ts`: drop the Beer-Lambert RGB-sample fit, white-reference
+  handling, per-channel least-squares, confidence-from-CV, import/export of the old
+  shape. Keep/replace with just: the opacity→TD fit, the channel conversion, and
+  generator helpers.
+- Persistence ([`profileManager.ts`](../src/lib/profileManager.ts),
+  `useProfileManager.ts`, `.kfil`/`.kapp`, localStorage): old `CalibrationResult`
+  fields are simply **ignored/stripped on load** — no conversion, no notice. The
+  filament keeps its plain TD; calibration just reads as absent until recalibrated.
+- Rewrite `tests/calibration.test.ts`; drop fixtures tied to the old flow.
+- Audit other call sites of the removed exports (`predictTransmission`,
+  `calculateTDFromMeasurements`, `validateWhiteReference`, etc.) and delete dead UI.
+- Docs (`src/docs/*`) + `CHANGELOG.md`.
+
+---
+
+## Phase 2 — color accuracy (combos), still later
+
+Single-filament frontlit TD fixes "too many / too few layers" and most of the
+color drift, because the preview uses the same TD. Fine-grained accuracy of
+*stacked color blends* is a second pass: print a matrix of 2–3 color combinations,
+**pruned to only printable combos using the Phase-1 TDs** (no longer assuming a
+high TD ⇒ far fewer cells), and correct the blend predictor.
+
+Open question for Phase 2: keep it camera-free. On-screen color matching reintro-
+duces the monitor problem, so prefer ordinal/threshold-style reads here too (e.g.
+"at which layer does color A stop showing through color B") rather than absolute
+color matching. To be designed after Phase 1 lands.
+
+---
+
+## Decisions resolved
+
+- **Read-back:** single opacity-threshold number, read against an adjacent opaque
+  reference patch. No camera. (Mid-fade second read dropped — not eye-readable.)
+- **Base:** fixed black.
+- **Format:** user picks 3MF or STL; plus combined (AMS) vs per-filament files.
+- **Per-channel TD:** compute single TD → derive R/G/B channel TDs from the swatch
+  color (conversion above).
+- **Layer heights:** thickness uses the shared `max(layerHeight, firstLayerHeight)`
+  first-layer model; store both heights with the calibration.
+- **Migration:** none. Breaking change, old calibration silently stripped.
+
+## Still to pin
+
+- **JND value** (1 vs ~2.5): a viewing-robustness choice, *not* a filament fit.
+  Sanity-check against the 7-color frontlit set that the resulting prints look
+  right; do not derive it from those specific filaments.
+- Default max layers N and patch size for the wedge.
+- The per-channel ratio model (validate the `1.0 + c*5.8` shape frontlit).
+</content>
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06b98c6..d7fa4e1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the single layer count at which each filament's patch first matches the rail. Kromacut converts that read into a frontlit Transmission Distance (scalar plus per-channel) using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index ae048f6..3508e7c 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -13,6 +13,7 @@ import {
     Pencil,
     BadgeCheck,
     Loader2,
+    FlaskConical,
 } from 'lucide-react';
 import { Switch } from '@/components/ui/switch';
 import { Label } from '@/components/ui/label';
@@ -28,9 +29,8 @@ import { TabsContent } from '@/components/ui/tabs';
 import type { AutoPaintResult, TransitionZone } from '../lib/autoPaint';
 import type { AutoPaintProfile } from '../lib/profileManager';
 import type { AutoPaintRepeatLimit, AutoPaintTransitionOpacity, Filament, Swatch } from '../types';
-import type { CalibrationResult } from '../lib/calibration';
 import FilamentRow from './FilamentRow';
-import { FilamentCalibrationWizard } from './FilamentCalibrationWizard';
+import { FilamentCalibrationDialog, type CalibrationApplyUpdate } from './FilamentCalibrationDialog';
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
 import { useNextBestColorWorker } from '../hooks/useNextBestColorWorker';
 
@@ -111,6 +111,7 @@ interface AutoPaintTabProps {
     error?: string;
     calibrationLayerHeight: number;
     setCalibrationLayerHeight: (v: number) => void;
+    firstLayerHeight: number;
 
     // Image colors
     filteredCount: number;
@@ -177,6 +178,7 @@ export default function AutoPaintTab({
     progress = 0,
     error,
     calibrationLayerHeight,
+    firstLayerHeight,
     filteredCount,
     imageSwatches,
     enhancedColorMatch,
@@ -219,33 +221,31 @@ export default function AutoPaintTab({
         optimizerSeed?.toString() ?? ''
     );
 
-    // Calibration wizard state
+    // Calibration dialog state
     const [calibratingFilamentId, setCalibratingFilamentId] = React.useState<string | null>(null);
-    const [calibrationWizardOpen, setCalibrationWizardOpen] = React.useState(false);
+    const [calibrationDialogOpen, setCalibrationDialogOpen] = React.useState(false);
 
-    const calibratingFilament = filaments.find((f) => f.id === calibratingFilamentId);
-
-    const handleOpenCalibrationWizard = React.useCallback((id: string) => {
-        setCalibratingFilamentId(id);
-        setCalibrationWizardOpen(true);
+    const handleOpenCalibration = React.useCallback((id?: string) => {
+        setCalibratingFilamentId(id ?? null);
+        setCalibrationDialogOpen(true);
     }, []);
 
-    const handleCloseCalibrationWizard = React.useCallback(() => {
-        setCalibrationWizardOpen(false);
+    const handleCloseCalibration = React.useCallback(() => {
+        setCalibrationDialogOpen(false);
         // Clear the ID after a short delay to avoid visible state change
         setTimeout(() => setCalibratingFilamentId(null), 300);
     }, []);
 
-    const handleCalibrationComplete = React.useCallback(
-        (result: CalibrationResult) => {
-            if (calibratingFilamentId) {
-                updateFilament(calibratingFilamentId, {
-                    td: result.tdSingleValue,
-                    calibration: result,
+    const handleApplyCalibration = React.useCallback(
+        (updates: CalibrationApplyUpdate[]) => {
+            for (const update of updates) {
+                updateFilament(update.id, {
+                    td: update.td,
+                    calibration: update.calibration,
                 });
             }
         },
-        [calibratingFilamentId, updateFilament]
+        [updateFilament]
     );
 
     React.useEffect(() => {
@@ -469,7 +469,6 @@ export default function AutoPaintTab({
                                     filament={f}
                                     onUpdate={updateFilament}
                                     onRemove={removeFilament}
-                                    onCalibrate={handleOpenCalibrationWizard}
                                 />
                             ))}
                         </div>
@@ -484,6 +483,18 @@ export default function AutoPaintTab({
                         Add Filament
                     </Button>
 
+                    {filaments.length > 0 && (
+                        <Button
+                            variant="outline"
+                            size="sm"
+                            onClick={() => handleOpenCalibration()}
+                            className="w-full gap-1.5 h-8 cursor-pointer"
+                        >
+                            <FlaskConical className="w-3.5 h-3.5" />
+                            Calibrate Filaments
+                        </Button>
+                    )}
+
                     {/* Max Height Constraint */}
                     {filaments.length > 0 && (
                         <div className="space-y-2 pt-2">
@@ -1215,22 +1226,16 @@ export default function AutoPaintTab({
                 </div>
             </Card>
 
-            {/* Calibration Wizard */}
-            {calibratingFilament && (
-                <FilamentCalibrationWizard
-                    key={calibratingFilament.id}
-                    open={calibrationWizardOpen}
-                    onClose={handleCloseCalibrationWizard}
-                    onComplete={handleCalibrationComplete}
-                    filamentColor={calibratingFilament.color}
-                    filamentName={
-                        calibratingFilament.name || calibratingFilament.brand || 'Filament'
-                    }
-                    layerHeight={calibrationLayerHeight}
-                    existingMeasurements={calibratingFilament.calibration?.measurements}
-                    existingWhiteReference={calibratingFilament.calibration?.whiteReference}
-                />
-            )}
+            {/* Calibration Dialog */}
+            <FilamentCalibrationDialog
+                open={calibrationDialogOpen}
+                onClose={handleCloseCalibration}
+                filaments={filaments}
+                initialFilamentId={calibratingFilamentId}
+                layerHeight={calibrationLayerHeight}
+                firstLayerHeight={firstLayerHeight}
+                onApply={handleApplyCalibration}
+            />
         </TabsContent>
     );
 }
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
new file mode 100644
index 0000000..2e5b2b4
--- /dev/null
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -0,0 +1,702 @@
+/**
+ * Frontlit Filament Calibration Dialog
+ *
+ * Camera-free calibration: pick one or more filaments, choose the base layer each
+ * prints over (defaults to the darkest filament), download a calibration print
+ * (STL or multi-material 3MF), then report the single layer count at which each
+ * filament's wedge first matches its opaque reference rail. Each read is converted
+ * to a frontlit TD and saved to the filament profile.
+ */
+
+import { useCallback, useMemo, useState } from 'react';
+import {
+    AlertDialog,
+    AlertDialogContent,
+    AlertDialogDescription,
+    AlertDialogFooter,
+    AlertDialogHeader,
+    AlertDialogTitle,
+} from '@/components/ui/alert-dialog';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import { Card } from '@/components/ui/card';
+import {
+    Select,
+    SelectContent,
+    SelectItem,
+    SelectTrigger,
+    SelectValue,
+} from '@/components/ui/select';
+import { X, Download, Check, Minus, ArrowLeft, ArrowRight, FlaskConical } from 'lucide-react';
+import { cn } from '@/lib/utils';
+import type { Filament } from '../types';
+import {
+    computeFrontlitCalibration,
+    predictFrontlitColor,
+    getConfidenceLabel,
+    getConfidenceColor,
+    type FrontlitCalibration,
+} from '@/lib/calibration';
+import {
+    generateCalibrationStl,
+    generateCalibration3mf,
+    DEFAULT_CALIBRATION_PRINT_OPTIONS,
+    type CalibrationPrintOptions,
+    type CalibrationTile,
+} from '@/lib/generateCalibrationPrint';
+
+type Step = 'select' | 'base' | 'print' | 'measure';
+type PrintFormat = 'stl' | '3mf';
+
+export interface CalibrationApplyUpdate {
+    id: string;
+    td: number;
+    calibration: FrontlitCalibration;
+}
+
+interface FilamentCalibrationDialogProps {
+    open: boolean;
+    onClose: () => void;
+    filaments: Filament[];
+    initialFilamentId?: string | null;
+    layerHeight: number;
+    firstLayerHeight: number;
+    onApply: (updates: CalibrationApplyUpdate[]) => void;
+}
+
+const MIN_MAX_LAYERS = 4;
+const MAX_MAX_LAYERS = 40;
+
+function filamentLabel(filament: Filament): string {
+    return filament.name || filament.brand || `Filament ${filament.color}`;
+}
+
+function luminance(hex: string): number {
+    const h = hex.replace(/^#/, '');
+    if (h.length < 6) return 0;
+    const r = parseInt(h.slice(0, 2), 16);
+    const g = parseInt(h.slice(2, 4), 16);
+    const b = parseInt(h.slice(4, 6), 16);
+    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+
+function rgbCss(rgb: [number, number, number]): string {
+    return `rgb(${rgb[0]}, ${rgb[1]}, ${rgb[2]})`;
+}
+
+function downloadBlob(blob: Blob, filename: string) {
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    a.click();
+    URL.revokeObjectURL(url);
+}
+
+export function FilamentCalibrationDialog({
+    open,
+    onClose,
+    filaments,
+    initialFilamentId,
+    layerHeight,
+    firstLayerHeight,
+    onApply,
+}: FilamentCalibrationDialogProps) {
+    const [step, setStep] = useState<Step>('select');
+    const [selectedIds, setSelectedIds] = useState<Set<string>>(
+        () => new Set(initialFilamentId ? [initialFilamentId] : [])
+    );
+    const [maxLayers, setMaxLayers] = useState(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
+    const [calibrationLayerHeight, setCalibrationLayerHeight] = useState(layerHeight);
+    // Free-typing drafts for the numeric inputs; clamped to the committed value on blur.
+    const [maxLayersDraft, setMaxLayersDraft] = useState(() =>
+        String(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers)
+    );
+    const [layerHeightDraft, setLayerHeightDraft] = useState(() => String(layerHeight));
+    const [format, setFormat] = useState<PrintFormat>('stl');
+    const [reads, setReads] = useState<Record<string, string>>({});
+    // filament id -> chosen base filament id (defaults to the darkest filament).
+    const [baseChoices, setBaseChoices] = useState<Record<string, string>>({});
+
+    const darkestFilamentId = useMemo(() => {
+        if (filaments.length === 0) return undefined;
+        return filaments.reduce((darkest, f) =>
+            luminance(f.color) < luminance(darkest.color) ? f : darkest
+        ).id;
+    }, [filaments]);
+
+    const resolveBaseId = useCallback(
+        (filamentId: string): string => baseChoices[filamentId] ?? darkestFilamentId ?? filamentId,
+        [baseChoices, darkestFilamentId]
+    );
+
+    const resolveBaseColor = useCallback(
+        (filamentId: string): string => {
+            const base = filaments.find((f) => f.id === resolveBaseId(filamentId));
+            return base?.color ?? '#000000';
+        },
+        [filaments, resolveBaseId]
+    );
+
+    const setBaseChoice = useCallback((filamentId: string, baseId: string) => {
+        setBaseChoices((prev) => ({ ...prev, [filamentId]: baseId }));
+    }, []);
+
+    const commitLayerHeight = useCallback(() => {
+        const parsed = Number(layerHeightDraft);
+        const next = Number.isFinite(parsed)
+            ? Math.max(0.04, Math.min(0.4, parsed))
+            : calibrationLayerHeight;
+        setCalibrationLayerHeight(next);
+        setLayerHeightDraft(String(next));
+    }, [layerHeightDraft, calibrationLayerHeight]);
+
+    const commitMaxLayers = useCallback(() => {
+        const parsed = Math.round(Number(maxLayersDraft));
+        const next =
+            Number.isFinite(parsed) && parsed > 0
+                ? Math.max(MIN_MAX_LAYERS, Math.min(MAX_MAX_LAYERS, parsed))
+                : maxLayers;
+        setMaxLayers(next);
+        setMaxLayersDraft(String(next));
+    }, [maxLayersDraft, maxLayers]);
+
+    const selectedFilaments = useMemo(
+        () => filaments.filter((f) => selectedIds.has(f.id)),
+        [filaments, selectedIds]
+    );
+
+    const printOptions = useMemo<CalibrationPrintOptions>(
+        () => ({
+            ...DEFAULT_CALIBRATION_PRINT_OPTIONS,
+            layerHeight: calibrationLayerHeight,
+            firstLayerHeight,
+            maxLayers,
+        }),
+        [calibrationLayerHeight, firstLayerHeight, maxLayers]
+    );
+
+    const reset = useCallback(() => {
+        setStep('select');
+        setSelectedIds(new Set(initialFilamentId ? [initialFilamentId] : []));
+        setMaxLayers(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
+        setMaxLayersDraft(String(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers));
+        setCalibrationLayerHeight(layerHeight);
+        setLayerHeightDraft(String(layerHeight));
+        setFormat('stl');
+        setReads({});
+        setBaseChoices({});
+    }, [initialFilamentId, layerHeight]);
+
+    const handleClose = useCallback(() => {
+        onClose();
+        setTimeout(reset, 300);
+    }, [onClose, reset]);
+
+    const toggleFilament = useCallback((id: string) => {
+        setSelectedIds((prev) => {
+            const next = new Set(prev);
+            if (next.has(id)) next.delete(id);
+            else next.add(id);
+            return next;
+        });
+    }, []);
+
+    const toggleAll = useCallback(() => {
+        setSelectedIds((prev) =>
+            prev.size === filaments.length ? new Set() : new Set(filaments.map((f) => f.id))
+        );
+    }, [filaments]);
+
+    const handleDownload = useCallback(async () => {
+        const tiles: CalibrationTile[] = selectedFilaments.map((f) => ({
+            filamentId: f.id,
+            color: f.color,
+            baseFilamentId: resolveBaseId(f.id),
+            baseColor: resolveBaseColor(f.id),
+            name: filamentLabel(f),
+        }));
+        if (tiles.length === 0) return;
+
+        if (format === 'stl') {
+            // The wedge geometry is identical for every filament, so one STL is
+            // printed once per filament (swapping the color above the base).
+            const blob = generateCalibrationStl(printOptions);
+            downloadBlob(blob, `kromacut-calibration-${maxLayers}layers.stl`);
+        } else {
+            // Slots follow the full profile order so they map to the user's machine.
+            const profileFilaments = filaments.map((f) => ({
+                id: f.id,
+                color: f.color,
+                name: filamentLabel(f),
+            }));
+            const blob = await generateCalibration3mf(tiles, printOptions, profileFilaments);
+            downloadBlob(blob, `kromacut-calibration-${tiles.length}filaments.3mf`);
+        }
+    }, [selectedFilaments, filaments, format, printOptions, maxLayers, resolveBaseId, resolveBaseColor]);
+
+    const setRead = useCallback((id: string, value: string) => {
+        setReads((prev) => ({ ...prev, [id]: value }));
+    }, []);
+
+    // Per-filament calibration computed live from the entered reads.
+    const computed = useMemo(() => {
+        return selectedFilaments.map((filament) => {
+            const raw = reads[filament.id];
+            const opacityLayers = Number.parseInt(raw ?? '', 10);
+            if (!Number.isFinite(opacityLayers) || opacityLayers < 1) {
+                return { filament, result: null, opacityLayers: null };
+            }
+            const result = computeFrontlitCalibration({
+                filamentColor: filament.color,
+                opacityLayers,
+                layerHeight: calibrationLayerHeight,
+                firstLayerHeight,
+                baseColor: resolveBaseColor(filament.id),
+                maxLayers,
+            });
+            return { filament, result, opacityLayers };
+        });
+    }, [
+        selectedFilaments,
+        reads,
+        calibrationLayerHeight,
+        firstLayerHeight,
+        maxLayers,
+        resolveBaseColor,
+    ]);
+
+    const allReadsValid =
+        computed.length > 0 && computed.every((c) => c.result !== null && c.result.ok);
+
+    const handleSave = useCallback(() => {
+        const updates: CalibrationApplyUpdate[] = [];
+        for (const entry of computed) {
+            if (entry.result && entry.result.ok) {
+                updates.push({
+                    id: entry.filament.id,
+                    td: entry.result.calibration.tdSingleValue,
+                    calibration: entry.result.calibration,
+                });
+            }
+        }
+        if (updates.length > 0) onApply(updates);
+        handleClose();
+    }, [computed, onApply, handleClose]);
+
+    const renderSelect = () => (
+        <>
+            <AlertDialogHeader>
+                <AlertDialogTitle className="flex items-center gap-2">
+                    <FlaskConical className="h-5 w-5 text-primary" />
+                    Calibrate Filaments
+                </AlertDialogTitle>
+            </AlertDialogHeader>
+            <div className="space-y-4">
+                <p className="text-sm text-muted-foreground">
+                    Pick the filaments to calibrate. You&apos;ll print a small wedge for each over a
+                    base layer, then read back a single number — no camera, no color picking.
+                </p>
+                {filaments.length > 0 && (
+                    <button
+                        type="button"
+                        onClick={toggleAll}
+                        className="flex w-full items-center justify-between rounded-lg px-1 py-1"
+                    >
+                        <span className="flex items-center gap-2 text-sm font-medium text-foreground">
+                            <span
+                                className={cn(
+                                    'flex h-5 w-5 flex-none items-center justify-center rounded-md border',
+                                    selectedIds.size > 0
+                                        ? 'border-primary bg-primary text-primary-foreground'
+                                        : 'border-border'
+                                )}
+                            >
+                                {selectedIds.size === filaments.length ? (
+                                    <Check className="h-3.5 w-3.5" />
+                                ) : selectedIds.size > 0 ? (
+                                    <Minus className="h-3.5 w-3.5" />
+                                ) : null}
+                            </span>
+                            {selectedIds.size === filaments.length ? 'Deselect all' : 'Select all'}
+                        </span>
+                        <span className="text-xs text-muted-foreground">
+                            {selectedIds.size} of {filaments.length}
+                        </span>
+                    </button>
+                )}
+                <div className="max-h-[22rem] space-y-2 overflow-y-auto pr-1">
+                    {filaments.map((filament) => {
+                        const selected = selectedIds.has(filament.id);
+                        const isCalibrated = !!filament.calibration;
+                        return (
+                            <button
+                                key={filament.id}
+                                type="button"
+                                onClick={() => toggleFilament(filament.id)}
+                                className={cn(
+                                    'flex w-full items-center gap-3 rounded-xl border px-3 py-2.5 text-left transition-colors',
+                                    selected
+                                        ? 'border-primary/60 bg-primary/5'
+                                        : 'border-border/60 bg-card hover:border-border'
+                                )}
+                            >
+                                <span
+                                    className={cn(
+                                        'flex h-5 w-5 flex-none items-center justify-center rounded-md border',
+                                        selected
+                                            ? 'border-primary bg-primary text-primary-foreground'
+                                            : 'border-border'
+                                    )}
+                                >
+                                    {selected && <Check className="h-3.5 w-3.5" />}
+                                </span>
+                                <span
+                                    className="h-7 w-7 flex-none rounded-lg border border-border/70 shadow-inner"
+                                    style={{ backgroundColor: filament.color }}
+                                />
+                                <span className="min-w-0 flex-1">
+                                    <span className="block truncate text-sm font-medium text-foreground">
+                                        {filamentLabel(filament)}
+                                    </span>
+                                    <span className="block text-xs text-muted-foreground">
+                                        TD {filament.td.toFixed(2)}mm
+                                        {isCalibrated ? ' · calibrated' : ''}
+                                    </span>
+                                </span>
+                            </button>
+                        );
+                    })}
+                </div>
+            </div>
+            <AlertDialogFooter>
+                <Button variant="outline" onClick={handleClose}>
+                    Cancel
+                </Button>
+                <Button onClick={() => setStep('base')} disabled={selectedIds.size === 0}>
+                    Next: Base
+                    <ArrowRight className="ml-1 h-4 w-4" />
+                </Button>
+            </AlertDialogFooter>
+        </>
+    );
+
+    const renderBase = () => (
+        <>
+            <AlertDialogHeader>
+                <AlertDialogTitle>Pick Base Layers</AlertDialogTitle>
+            </AlertDialogHeader>
+            <div className="space-y-4">
+                <p className="text-sm text-muted-foreground">
+                    Each filament is calibrated over a base, defaulting to your darkest filament. A
+                    dark filament needs a lighter base (e.g. white) to read against — change its base
+                    here.
+                </p>
+                <div className="max-h-[24rem] space-y-2 overflow-y-auto pr-1">
+                    {selectedFilaments.map((filament) => {
+                        const baseId = baseChoices[filament.id] ?? darkestFilamentId ?? '';
+                        return (
+                            <Card key={filament.id} className="flex items-center gap-3 p-3">
+                                <span
+                                    className="h-7 w-7 flex-none rounded-lg border border-border/70 shadow-inner"
+                                    style={{ backgroundColor: filament.color }}
+                                />
+                                <div className="min-w-0 flex-1">
+                                    <div className="truncate text-sm font-medium text-foreground">
+                                        {filamentLabel(filament)}
+                                    </div>
+                                    <div className="text-[11px] text-muted-foreground">over base</div>
+                                </div>
+                                <Select
+                                    value={baseId}
+                                    onValueChange={(v) => setBaseChoice(filament.id, v)}
+                                >
+                                    <SelectTrigger className="h-9 w-48">
+                                        <SelectValue placeholder="Base filament" />
+                                    </SelectTrigger>
+                                    <SelectContent>
+                                        {filaments.map((bf) => (
+                                            <SelectItem key={bf.id} value={bf.id}>
+                                                <span className="flex items-center gap-2">
+                                                    <span
+                                                        className="h-4 w-4 flex-none rounded border border-border/70"
+                                                        style={{ backgroundColor: bf.color }}
+                                                    />
+                                                    <span className="truncate">
+                                                        {filamentLabel(bf)}
+                                                    </span>
+                                                </span>
+                                            </SelectItem>
+                                        ))}
+                                    </SelectContent>
+                                </Select>
+                            </Card>
+                        );
+                    })}
+                </div>
+            </div>
+            <AlertDialogFooter>
+                <Button variant="outline" onClick={() => setStep('select')}>
+                    <ArrowLeft className="mr-1 h-4 w-4" />
+                    Back
+                </Button>
+                <Button onClick={() => setStep('print')}>
+                    Next: Print
+                    <ArrowRight className="ml-1 h-4 w-4" />
+                </Button>
+            </AlertDialogFooter>
+        </>
+    );
+
+    const renderPrint = () => (
+        <>
+            <AlertDialogHeader>
+                <AlertDialogTitle>Print the Calibration Wedge</AlertDialogTitle>
+            </AlertDialogHeader>
+            <div className="space-y-4">
+                <Card className="space-y-4 p-4">
+                    <div className="grid gap-4 sm:grid-cols-2">
+                        <div className="space-y-1.5">
+                            <Label className="text-xs">Layer height (mm)</Label>
+                            <Input
+                                type="number"
+                                step="0.01"
+                                min="0.04"
+                                max="0.4"
+                                value={layerHeightDraft}
+                                onChange={(e) => setLayerHeightDraft(e.target.value)}
+                                onBlur={commitLayerHeight}
+                                onKeyDown={(e) => {
+                                    if (e.key === 'Enter') (e.target as HTMLInputElement).blur();
+                                }}
+                                className="h-8"
+                            />
+                            <p className="text-[11px] text-muted-foreground">
+                                Use the layer height you print your models at.
+                            </p>
+                        </div>
+                        <div className="space-y-1.5">
+                            <Label className="text-xs">Max layers (wedge length)</Label>
+                            <Input
+                                type="number"
+                                step="1"
+                                min={MIN_MAX_LAYERS}
+                                max={MAX_MAX_LAYERS}
+                                value={maxLayersDraft}
+                                onChange={(e) => setMaxLayersDraft(e.target.value)}
+                                onBlur={commitMaxLayers}
+                                onKeyDown={(e) => {
+                                    if (e.key === 'Enter') (e.target as HTMLInputElement).blur();
+                                }}
+                                className="h-8"
+                            />
+                            <p className="text-[11px] text-muted-foreground">
+                                The wedge runs 1…{maxLayers} layers. Raise it for very translucent
+                                filaments.
+                            </p>
+                        </div>
+                    </div>
+
+                    <div className="space-y-1.5">
+                        <Label className="text-xs">Format</Label>
+                        <div className="flex gap-2">
+                            <Button
+                                variant="outline"
+                                size="sm"
+                                onClick={() => setFormat('stl')}
+                                className={cn(format === 'stl' && 'border-primary/60 bg-primary/5')}
+                            >
+                                STL (any printer)
+                            </Button>
+                            <Button
+                                variant="outline"
+                                size="sm"
+                                onClick={() => setFormat('3mf')}
+                                className={cn(format === '3mf' && 'border-primary/60 bg-primary/5')}
+                            >
+                                3MF (multi-material)
+                            </Button>
+                        </div>
+                        <p className="text-[11px] text-muted-foreground">
+                            {format === 'stl'
+                                ? 'Single solid. Print it once per filament: base, then swap to the color above the base.'
+                                : 'Colors + bases baked in for AMS / multi-material — all selected filaments in one print.'}
+                        </p>
+                    </div>
+
+                    <Button onClick={handleDownload} className="w-full gap-2">
+                        <Download className="h-4 w-4" />
+                        Download {format.toUpperCase()}
+                    </Button>
+                </Card>
+
+                <Card className="space-y-2 bg-muted/20 p-4 text-sm">
+                    <p className="font-semibold">How to read it back</p>
+                    <ul className="list-disc space-y-1 pl-5 text-[13px] text-muted-foreground">
+                        <li>View the print flat under normal room light.</li>
+                        <li>
+                            The patches step from 1 layer (the tab end) up to {maxLayers}, with an
+                            opaque reference rail running along the back edge.
+                        </li>
+                        <li>
+                            Find the <span className="font-medium text-foreground">first patch</span>{' '}
+                            that looks identical to the rail beside it — that&apos;s its opacity layer.
+                        </li>
+                    </ul>
+                </Card>
+            </div>
+            <AlertDialogFooter>
+                <Button variant="outline" onClick={() => setStep('base')}>
+                    <ArrowLeft className="mr-1 h-4 w-4" />
+                    Back
+                </Button>
+                <Button onClick={() => setStep('measure')}>
+                    Next: Enter Results
+                    <ArrowRight className="ml-1 h-4 w-4" />
+                </Button>
+            </AlertDialogFooter>
+        </>
+    );
+
+    const renderMeasure = () => (
+        <>
+            <AlertDialogHeader>
+                <AlertDialogTitle>Enter Opacity Layers</AlertDialogTitle>
+            </AlertDialogHeader>
+            <div className="space-y-3">
+                <p className="text-sm text-muted-foreground">
+                    For each filament, enter the first patch number that matched its reference rail.
+                </p>
+                <div className="max-h-[26rem] space-y-2.5 overflow-y-auto pr-1">
+                    {computed.map(({ filament, result, opacityLayers }) => {
+                        const calibration = result && result.ok ? result.calibration : null;
+                        const errorText = result && !result.ok ? result.error : null;
+                        const predicted =
+                            calibration && opacityLayers
+                                ? predictFrontlitColor(
+                                      filament.color,
+                                      opacityLayers,
+                                      calibrationLayerHeight,
+                                      calibration.td,
+                                      resolveBaseColor(filament.id)
+                                  )
+                                : null;
+                        return (
+                            <Card key={filament.id} className="p-3">
+                                <div className="flex items-center gap-3">
+                                    <span
+                                        className="h-8 w-8 flex-none rounded-lg border border-border/70 shadow-inner"
+                                        style={{ backgroundColor: filament.color }}
+                                    />
+                                    <div className="min-w-0 flex-1">
+                                        <div className="truncate text-sm font-medium">
+                                            {filamentLabel(filament)}
+                                        </div>
+                                        <div className="text-[11px] text-muted-foreground">
+                                            {filament.color}
+                                        </div>
+                                    </div>
+                                    <div className="flex items-center gap-1.5">
+                                        <Input
+                                            type="number"
+                                            min={1}
+                                            max={maxLayers}
+                                            value={reads[filament.id] ?? ''}
+                                            onChange={(e) => setRead(filament.id, e.target.value)}
+                                            placeholder="layer"
+                                            className="h-8 w-20 text-sm"
+                                        />
+                                        <span className="text-[11px] text-muted-foreground">
+                                            / {maxLayers}
+                                        </span>
+                                    </div>
+                                </div>
+
+                                {calibration && (
+                                    <div className="mt-2.5 flex items-center justify-between gap-3 rounded-lg border border-border/50 bg-muted/20 px-3 py-2">
+                                        <div className="flex items-center gap-2">
+                                            <span className="text-[11px] text-muted-foreground">
+                                                Match
+                                            </span>
+                                            <span
+                                                className="h-6 w-6 rounded border border-border/70"
+                                                style={{ backgroundColor: filament.color }}
+                                                title="Reference (opaque)"
+                                            />
+                                            {predicted && (
+                                                <span
+                                                    className="h-6 w-6 rounded border border-border/70"
+                                                    style={{ backgroundColor: rgbCss(predicted) }}
+                                                    title="Predicted at this layer"
+                                                />
+                                            )}
+                                        </div>
+                                        <div className="text-right text-xs">
+                                            <div className="font-semibold">
+                                                TD {calibration.tdSingleValue.toFixed(2)}mm
+                                            </div>
+                                            <div
+                                                className={cn(
+                                                    'text-[11px] font-medium',
+                                                    getConfidenceColor(calibration.confidence)
+                                                )}
+                                            >
+                                                {getConfidenceLabel(calibration.confidence)}
+                                            </div>
+                                        </div>
+                                    </div>
+                                )}
+
+                                {errorText && (
+                                    <p className="mt-2 rounded-lg border border-amber-500/30 bg-amber-500/10 px-3 py-1.5 text-[11px] text-amber-600 dark:text-amber-400">
+                                        {errorText}
+                                    </p>
+                                )}
+                            </Card>
+                        );
+                    })}
+                </div>
+            </div>
+            <AlertDialogFooter>
+                <Button variant="outline" onClick={() => setStep('print')}>
+                    <ArrowLeft className="mr-1 h-4 w-4" />
+                    Back
+                </Button>
+                <Button onClick={handleSave} disabled={!allReadsValid}>
+                    <Check className="mr-1 h-4 w-4" />
+                    Save Calibration
+                </Button>
+            </AlertDialogFooter>
+        </>
+    );
+
+    return (
+        <AlertDialog
+            open={open}
+            onOpenChange={(isOpen) => {
+                if (!isOpen) handleClose();
+            }}
+        >
+            <AlertDialogContent className="fixed left-1/2 top-1/2 z-50 flex max-h-[90vh] w-[min(96vw,42rem)] max-w-[42rem] -translate-x-1/2 -translate-y-1/2 flex-col gap-4 overflow-y-auto rounded-lg border border-border bg-background p-6 shadow-lg">
+                <AlertDialogDescription className="sr-only">
+                    Frontlit filament calibration: generate a print and read back opacity layers to
+                    derive transmission distance.
+                </AlertDialogDescription>
+                <Button
+                    variant="ghost"
+                    size="icon"
+                    onClick={handleClose}
+                    className="absolute right-3 top-3 h-7 w-7 text-muted-foreground hover:text-foreground"
+                    aria-label="Close calibration dialog"
+                >
+                    <X className="h-4 w-4" />
+                </Button>
+                {step === 'select' && renderSelect()}
+                {step === 'base' && renderBase()}
+                {step === 'print' && renderPrint()}
+                {step === 'measure' && renderMeasure()}
+            </AlertDialogContent>
+        </AlertDialog>
+    );
+}
diff --git a/src/components/FilamentCalibrationWizard.tsx b/src/components/FilamentCalibrationWizard.tsx
deleted file mode 100644
index b757a1e..0000000
--- a/src/components/FilamentCalibrationWizard.tsx
+++ /dev/null
@@ -1,1085 +0,0 @@
-/**
- * Filament Calibration Wizard
- *
- * Multi-step wizard for calibrating filament Transmission Distance (TD) values.
- * Guides users through printing test patches, measuring RGB values, and computing
- * TD with confidence scoring.
- */
-
-import { useState, useCallback, useRef } from 'react';
-import {
-    AlertDialog,
-    AlertDialogContent,
-    AlertDialogDescription,
-    AlertDialogFooter,
-    AlertDialogHeader,
-    AlertDialogTitle,
-} from '@/components/ui/alert-dialog';
-import { Button } from '@/components/ui/button';
-import { Input } from '@/components/ui/input';
-import { Label } from '@/components/ui/label';
-import { Card } from '@/components/ui/card';
-import { X, Download, Upload } from 'lucide-react';
-import { cn } from '@/lib/utils';
-import {
-    calculateTDFromMeasurements,
-    DEFAULT_WHITE_REFERENCE,
-    getCalibrationInstructions,
-    getRecommendedLayerCounts,
-    canCalculateTD,
-    getConfidenceLabel,
-    getConfidenceColor,
-    RECOMMENDED_LAYER_COUNTS,
-    type CalibrationRgb,
-    type CalibrationMeasurement,
-    type CalibrationResult,
-} from '@/lib/calibration';
-import { generateCalibrationPatchesStl } from '@/lib/generateCalibrationPatchesStl';
-
-type WizardStep = 'intro' | 'print' | 'measure' | 'results';
-type SamplerTarget = 'white-reference' | 'measurement';
-
-type RgbInputState = { r: string; g: string; b: string };
-type SamplerPoint = { x: number; y: number };
-
-// The brush stays a consistent size on screen, then scales to the source image
-// so the outlined area is the exact area being averaged.
-const SAMPLER_BRUSH_RADIUS_PX = 16;
-const SAMPLER_BRUSH_DIAMETER_PX = SAMPLER_BRUSH_RADIUS_PX * 2;
-
-const buildRgbInputState = (rgb?: CalibrationRgb): RgbInputState => ({
-    r: String(rgb?.[0] ?? DEFAULT_WHITE_REFERENCE[0]),
-    g: String(rgb?.[1] ?? DEFAULT_WHITE_REFERENCE[1]),
-    b: String(rgb?.[2] ?? DEFAULT_WHITE_REFERENCE[2]),
-});
-
-const parseRgbInputState = (rgb: RgbInputState): CalibrationRgb => [
-    Math.max(0, Math.min(255, Number.parseInt(rgb.r, 10) || 0)),
-    Math.max(0, Math.min(255, Number.parseInt(rgb.g, 10) || 0)),
-    Math.max(0, Math.min(255, Number.parseInt(rgb.b, 10) || 0)),
-];
-
-const rgbToInputState = (rgb: CalibrationRgb): RgbInputState => ({
-    r: String(rgb[0]),
-    g: String(rgb[1]),
-    b: String(rgb[2]),
-});
-
-const formatRgb = (rgb: CalibrationRgb) => `RGB(${rgb[0]}, ${rgb[1]}, ${rgb[2]})`;
-
-function sampleAverageRgb(
-    ctx: CanvasRenderingContext2D,
-    centerX: number,
-    centerY: number,
-    radius: number
-): CalibrationRgb {
-    const roundedRadius = Math.max(1, Math.round(radius));
-    const startX = Math.max(0, centerX - roundedRadius);
-    const startY = Math.max(0, centerY - roundedRadius);
-    const endX = Math.min(ctx.canvas.width - 1, centerX + roundedRadius);
-    const endY = Math.min(ctx.canvas.height - 1, centerY + roundedRadius);
-    const width = endX - startX + 1;
-    const height = endY - startY + 1;
-    const imageData = ctx.getImageData(startX, startY, width, height).data;
-
-    let totalR = 0;
-    let totalG = 0;
-    let totalB = 0;
-    let samples = 0;
-
-    for (let y = startY; y <= endY; y++) {
-        for (let x = startX; x <= endX; x++) {
-            const distanceX = x - centerX;
-            const distanceY = y - centerY;
-            if (distanceX * distanceX + distanceY * distanceY > roundedRadius * roundedRadius) {
-                continue;
-            }
-
-            const pixelIndex = ((y - startY) * width + (x - startX)) * 4;
-            const alpha = imageData[pixelIndex + 3] / 255;
-            if (alpha <= 0) continue;
-            totalR += imageData[pixelIndex] * alpha;
-            totalG += imageData[pixelIndex + 1] * alpha;
-            totalB += imageData[pixelIndex + 2] * alpha;
-            samples += alpha;
-        }
-    }
-
-    if (samples <= 0) return [0, 0, 0];
-
-    return [
-        Math.round(totalR / samples),
-        Math.round(totalG / samples),
-        Math.round(totalB / samples),
-    ];
-}
-
-interface FilamentCalibrationWizardProps {
-    open: boolean;
-    onClose: () => void;
-    onComplete: (result: CalibrationResult) => void;
-    filamentColor: string;
-    filamentName?: string;
-    layerHeight: number;
-    existingMeasurements?: CalibrationMeasurement[];
-    existingWhiteReference?: CalibrationRgb;
-}
-
-export function FilamentCalibrationWizard({
-    open,
-    onClose,
-    onComplete,
-    filamentColor,
-    filamentName = 'Your filament',
-    layerHeight,
-    existingMeasurements = [],
-    existingWhiteReference,
-}: FilamentCalibrationWizardProps) {
-    const [step, setStep] = useState<WizardStep>('intro');
-    const [measurements, setMeasurements] = useState<CalibrationMeasurement[]>(
-        existingMeasurements
-    );
-    const [calibrationLayerHeight, setCalibrationLayerHeight] = useState(layerHeight);
-    const [whiteReferenceInput, setWhiteReferenceInput] = useState<RgbInputState>(() =>
-        buildRgbInputState(existingWhiteReference)
-    );
-    const [samplerTarget, setSamplerTarget] = useState<SamplerTarget>('measurement');
-    const [pickerImageSrc, setPickerImageSrc] = useState<string | null>(null);
-    const [pickerStatus, setPickerStatus] = useState<string | null>(null);
-    const [samplerPoint, setSamplerPoint] = useState<SamplerPoint | null>(null);
-    const [lastSamplePoint, setLastSamplePoint] = useState<SamplerPoint | null>(null);
-    const [currentLayers, setCurrentLayers] = useState<string>('');
-    const [currentRGB, setCurrentRGB] = useState({ r: '', g: '', b: '' });
-    const [result, setResult] = useState<CalibrationResult | null>(null);
-    const [errorMessage, setErrorMessage] = useState<string | null>(null);
-    const pickerFileInputRef = useRef<HTMLInputElement | null>(null);
-    const pickerImageRef = useRef<HTMLImageElement | null>(null);
-    const pickerCanvasRef = useRef<HTMLCanvasElement | null>(null);
-
-    const { recommended } = getRecommendedLayerCounts(measurements);
-    const whiteReference = parseRgbInputState(whiteReferenceInput);
-    const currentMeasurementRgb = parseRgbInputState(currentRGB);
-    const activeSamplerLabel =
-        samplerTarget === 'white-reference' ? 'White Reference' : 'Measurement RGB';
-    const activeSamplerRgb =
-        samplerTarget === 'white-reference' ? whiteReference : currentMeasurementRgb;
-
-    const handlePickerImageSelected = useCallback(
-        (event: React.ChangeEvent<HTMLInputElement>) => {
-            const file = event.target.files?.[0];
-            if (!file) return;
-
-            const reader = new FileReader();
-            reader.onload = () => {
-                setPickerImageSrc(typeof reader.result === 'string' ? reader.result : null);
-                setSamplerPoint(null);
-                setLastSamplePoint(null);
-                setPickerStatus(
-                    'Image loaded. Move the circular brush over a uniform area, then click to sample it.'
-                );
-            };
-            reader.readAsDataURL(file);
-            event.target.value = '';
-        },
-        []
-    );
-
-    const handlePickerImageLoad = useCallback(() => {
-        const image = pickerImageRef.current;
-        const canvas = pickerCanvasRef.current;
-        if (!image || !canvas) return;
-
-        canvas.width = image.naturalWidth;
-        canvas.height = image.naturalHeight;
-        const ctx = canvas.getContext('2d');
-        if (!ctx) return;
-
-        ctx.clearRect(0, 0, canvas.width, canvas.height);
-        ctx.drawImage(image, 0, 0);
-    }, []);
-
-    const getSamplerCoordinates = useCallback((event: React.MouseEvent<HTMLImageElement>) => {
-        const image = pickerImageRef.current;
-        const canvas = pickerCanvasRef.current;
-        if (!image || !canvas) return null;
-
-        const rect = image.getBoundingClientRect();
-        if (rect.width <= 0 || rect.height <= 0) return null;
-
-        const normalizedX = Math.max(0, Math.min(1, (event.clientX - rect.left) / rect.width));
-        const normalizedY = Math.max(0, Math.min(1, (event.clientY - rect.top) / rect.height));
-
-        return {
-            imageX: Math.min(canvas.width - 1, Math.floor(normalizedX * canvas.width)),
-            imageY: Math.min(canvas.height - 1, Math.floor(normalizedY * canvas.height)),
-            displayPoint: { x: normalizedX * 100, y: normalizedY * 100 },
-            imageRadius: Math.max(1, (SAMPLER_BRUSH_RADIUS_PX / rect.width) * canvas.width),
-        };
-    }, []);
-
-    const handleSamplerMove = useCallback(
-        (event: React.MouseEvent<HTMLImageElement>) => {
-            const coordinates = getSamplerCoordinates(event);
-            if (coordinates) setSamplerPoint(coordinates.displayPoint);
-        },
-        [getSamplerCoordinates]
-    );
-
-    const handleSamplerClick = useCallback(
-        (event: React.MouseEvent<HTMLImageElement>) => {
-            const canvas = pickerCanvasRef.current;
-            const coordinates = getSamplerCoordinates(event);
-            if (!canvas || !coordinates) return;
-
-            const ctx = canvas.getContext('2d');
-            if (!ctx) return;
-
-            const rgb = sampleAverageRgb(
-                ctx,
-                coordinates.imageX,
-                coordinates.imageY,
-                coordinates.imageRadius
-            );
-            setSamplerPoint(coordinates.displayPoint);
-            setLastSamplePoint(coordinates.displayPoint);
-
-            if (samplerTarget === 'white-reference') {
-                setWhiteReferenceInput(rgbToInputState(rgb));
-            } else {
-                setCurrentRGB(rgbToInputState(rgb));
-            }
-
-            setPickerStatus(
-                `Sampled RGB(${rgb[0]}, ${rgb[1]}, ${rgb[2]}) into ${
-                    samplerTarget === 'white-reference' ? 'white reference' : 'measurement RGB'
-                }.`
-            );
-        },
-        [getSamplerCoordinates, samplerTarget]
-    );
-
-    const handleAddMeasurement = useCallback(() => {
-        const layers = Math.max(1, Number.parseInt(currentLayers, 10) || 1);
-        const r = Math.max(0, Math.min(255, Number.parseInt(currentRGB.r, 10) || 0));
-        const g = Math.max(0, Math.min(255, Number.parseInt(currentRGB.g, 10) || 0));
-        const b = Math.max(0, Math.min(255, Number.parseInt(currentRGB.b, 10) || 0));
-
-        const rgb: CalibrationRgb = [r, g, b];
-
-        const newMeasurement: CalibrationMeasurement = {
-            layers,
-            rgb,
-        };
-
-        setMeasurements((prev) => [...prev, newMeasurement]);
-        setCurrentLayers('');
-        setCurrentRGB({ r: '', g: '', b: '' });
-    }, [currentLayers, currentRGB]);
-
-    const handleRemoveMeasurement = useCallback((index: number) => {
-        setMeasurements((prev) => prev.filter((_, i) => i !== index));
-    }, []);
-
-    const handleCalculate = useCallback(() => {
-        const { ready, reason } = canCalculateTD(measurements, whiteReference);
-        if (!ready) {
-            setErrorMessage(reason || 'Cannot calculate TD yet.');
-            return;
-        }
-
-        try {
-            const { td, tdSingleValue, confidence } = calculateTDFromMeasurements(
-                measurements,
-                calibrationLayerHeight,
-                whiteReference,
-                filamentColor
-            );
-
-            const calibrationResult: CalibrationResult = {
-                color: filamentColor,
-                measurements,
-                whiteReference,
-                td,
-                tdSingleValue,
-                confidence,
-                calibrationDate: new Date().toISOString(),
-                notes: `Calibrated for ${filamentName}`,
-            };
-
-            setResult(calibrationResult);
-            setStep('results');
-            setErrorMessage(null);
-        } catch (err) {
-            setErrorMessage(err instanceof Error ? err.message : 'Failed to calculate TD.');
-        }
-    }, [measurements, calibrationLayerHeight, filamentColor, filamentName, whiteReference]);
-
-    const handleComplete = useCallback(() => {
-        if (result) {
-            onComplete(result);
-            onClose();
-            // Reset state
-            setStep('intro');
-            setMeasurements(existingMeasurements);
-            setCalibrationLayerHeight(layerHeight);
-            setWhiteReferenceInput(buildRgbInputState(existingWhiteReference));
-            setSamplerTarget('measurement');
-            setPickerImageSrc(null);
-            setPickerStatus(null);
-            setSamplerPoint(null);
-            setLastSamplePoint(null);
-            setResult(null);
-            setErrorMessage(null);
-        }
-    }, [result, onComplete, onClose, existingMeasurements, existingWhiteReference, layerHeight]);
-
-    const handleCancel = useCallback(() => {
-        onClose();
-        // Reset state after a short delay to avoid visible state change before closing
-        setTimeout(() => {
-            setStep('intro');
-            setMeasurements(existingMeasurements);
-            setCalibrationLayerHeight(layerHeight);
-            setWhiteReferenceInput(buildRgbInputState(existingWhiteReference));
-            setSamplerTarget('measurement');
-            setPickerImageSrc(null);
-            setPickerStatus(null);
-            setSamplerPoint(null);
-            setLastSamplePoint(null);
-            setCurrentLayers('');
-            setCurrentRGB({ r: '', g: '', b: '' });
-            setResult(null);
-            setErrorMessage(null);
-        }, 300);
-    }, [onClose, existingMeasurements, existingWhiteReference, layerHeight]);
-
-    const renderIntro = () => (
-        <>
-            <AlertDialogHeader>
-                <AlertDialogTitle>Calibrate Filament TD</AlertDialogTitle>
-            </AlertDialogHeader>
-            <div className="space-y-2">
-                <p>
-                    Calibrating Transmission Distance (TD) will give you more accurate
-                    auto-paint results.
-                </p>
-                <p className="font-semibold">You will need:</p>
-                <ul className="list-disc list-inside space-y-1 text-sm">
-                    <li>{filamentName}</li>
-                    <li>A 3D printer</li>
-                    <li>A backlit white surface (phone screen works great)</li>
-                    <li>A color picker tool (digital or app)</li>
-                </ul>
-                <p className="text-sm text-muted-foreground mt-4">
-                    This process takes about 15-20 minutes including print time.
-                </p>
-            </div>
-            <AlertDialogFooter>
-                <Button variant="outline" onClick={handleCancel}>
-                    Cancel
-                </Button>
-                <Button onClick={() => setStep('print')}>Start Calibration</Button>
-            </AlertDialogFooter>
-        </>
-    );
-
-    const handleDownloadPatches = () => {
-        const blob = generateCalibrationPatchesStl(RECOMMENDED_LAYER_COUNTS, calibrationLayerHeight);
-        const url = URL.createObjectURL(blob);
-        const a = document.createElement('a');
-        a.href = url;
-        a.download = `calibration_patches_${calibrationLayerHeight.toFixed(2)}mm.stl`;
-        a.click();
-        URL.revokeObjectURL(url);
-    };
-
-    const renderPrintInstructions = () => {
-        const instructions = getCalibrationInstructions(calibrationLayerHeight);
-
-        return (
-            <>
-                <AlertDialogHeader>
-                    <AlertDialogTitle>Step 1: Print Test Patches</AlertDialogTitle>
-                </AlertDialogHeader>
-                <div className="space-y-3">
-                    <AlertDialogDescription asChild>
-                        <div className="space-y-2">
-                            {instructions.map((instruction, i) => (
-                                <p key={i} className="text-sm">
-                                    {i === 0 ? '📋' : i === instructions.length - 1 ? '📊' : '🔧'}{' '}
-                                    {instruction}
-                                </p>
-                            ))}
-                        </div>
-                    </AlertDialogDescription>
-
-                    <Card className="p-4 bg-muted">
-                        <p className="text-sm font-semibold mb-2">Print Settings:</p>
-                        <ul className="text-sm space-y-1">
-                            <li>
-                                <strong>Filament:</strong>{' '}
-                                <span
-                                    className="inline-block w-4 h-4 rounded border"
-                                    style={{ backgroundColor: filamentColor }}
-                                />{' '}
-                                {filamentName}
-                            </li>
-                            <li className="flex items-center gap-2">
-                                <strong>Layer Height:</strong>
-                                <Input
-                                    type="number"
-                                    value={calibrationLayerHeight}
-                                    onChange={(e) => setCalibrationLayerHeight(Number(e.target.value))}
-                                    step="0.01"
-                                    min="0.05"
-                                    max="0.4"
-                                    className="w-20 h-7 text-xs"
-                                />
-                                <span className="text-xs">mm</span>
-                            </li>
-                            <li>
-                                <strong>Infill:</strong> 100%
-                            </li>
-                            <li>
-                                <strong>Patch Size:</strong> 20mm × 20mm (or larger)
-                            </li>
-                            <li>
-                                <strong>Layer Counts:</strong> {recommended.join(', ')} layers
-                            </li>
-                        </ul>
-                        <Button
-                            variant="outline"
-                            size="sm"
-                            onClick={handleDownloadPatches}
-                            className="mt-3 w-full gap-2"
-                        >
-                            <Download className="w-4 h-4" />
-                            Download Test Patches STL
-                        </Button>
-                    </Card>
-
-                    <p className="text-xs text-muted-foreground">
-                        💡 Tip: Label each patch with its layer count using a marker.
-                    </p>
-                </div>
-                <AlertDialogFooter>
-                    <Button variant="outline" onClick={() => setStep('intro')}>
-                        Back
-                    </Button>
-                    <Button onClick={() => setStep('measure')}>Patches Printed</Button>
-                </AlertDialogFooter>
-            </>
-        );
-    };
-
-    const renderMeasurement = () => {
-        const { ready, reason } = canCalculateTD(measurements, whiteReference);
-
-        return (
-            <>
-                <AlertDialogHeader>
-                    <AlertDialogTitle>Step 2: Measure RGB Values</AlertDialogTitle>
-                </AlertDialogHeader>
-                <p className="text-sm mb-4">
-                    Keep the same backlit setup for every sample. Measure the empty backlight
-                    first, then capture each printed patch from the center.
-                </p>
-
-                <div className="space-y-5 py-4">
-                    <Card className="border-border/60 bg-muted/20 p-4 sm:p-5">
-                        <div className="space-y-4">
-                            <div className="flex flex-col gap-3 lg:flex-row lg:items-start lg:justify-between">
-                                <div className="space-y-1">
-                                    <Label className="text-sm">Image Sampler</Label>
-                                    <p className="text-xs leading-relaxed text-muted-foreground">
-                                        Upload a photo or screenshot, choose where clicks should go,
-                                        then use the circular brush to capture an averaged RGB sample.
-                                    </p>
-                                </div>
-                                <input
-                                    ref={pickerFileInputRef}
-                                    type="file"
-                                    accept="image/*"
-                                    className="hidden"
-                                    onChange={handlePickerImageSelected}
-                                />
-                                <Button
-                                    variant="outline"
-                                    size="sm"
-                                    className="gap-2 self-start"
-                                    onClick={() => pickerFileInputRef.current?.click()}
-                                >
-                                    <Upload className="w-4 h-4" />
-                                    Upload Image
-                                </Button>
-                            </div>
-
-                            <div className="rounded-xl border border-border/50 bg-background/60 p-3">
-                                <div className="flex flex-col gap-3 lg:flex-row lg:items-center lg:justify-between">
-                                    <div className="space-y-2">
-                                        <div className="text-[11px] font-semibold uppercase tracking-[0.14em] text-muted-foreground">
-                                            Sampling Target
-                                        </div>
-                                        <div className="flex flex-wrap gap-2">
-                                            <Button
-                                                variant="outline"
-                                                size="sm"
-                                                className={cn(
-                                                    'border-border/60',
-                                                    samplerTarget === 'measurement' &&
-                                                        'border-primary/50 bg-primary text-primary-foreground hover:bg-primary/90 hover:text-primary-foreground'
-                                                )}
-                                                onClick={() => setSamplerTarget('measurement')}
-                                            >
-                                                Fill Measurement RGB
-                                            </Button>
-                                            <Button
-                                                variant="outline"
-                                                size="sm"
-                                                className={cn(
-                                                    'border-border/60',
-                                                    samplerTarget === 'white-reference' &&
-                                                        'border-primary/50 bg-primary text-primary-foreground hover:bg-primary/90 hover:text-primary-foreground'
-                                                )}
-                                                onClick={() => setSamplerTarget('white-reference')}
-                                            >
-                                                Fill White Reference
-                                            </Button>
-                                        </div>
-                                    </div>
-
-                                    <div className="flex items-center gap-3 rounded-xl border border-border/60 bg-background px-3 py-2">
-                                        <div
-                                            className="h-10 w-10 min-h-10 min-w-10 flex-none rounded-lg border border-border/70 shadow-inner"
-                                            style={{
-                                                backgroundColor: `rgb(${activeSamplerRgb[0]}, ${activeSamplerRgb[1]}, ${activeSamplerRgb[2]})`,
-                                            }}
-                                        />
-                                        <div className="min-w-0">
-                                            <div className="text-[11px] font-semibold uppercase tracking-[0.12em] text-muted-foreground">
-                                                Active Preview
-                                            </div>
-                                            <div className="text-sm font-semibold text-foreground">
-                                                {activeSamplerLabel}
-                                            </div>
-                                            <div className="text-xs text-muted-foreground">
-                                                {formatRgb(activeSamplerRgb)}
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-                            </div>
-
-                            {pickerImageSrc ? (
-                                <div className="space-y-3">
-                                    <div className="relative overflow-hidden rounded-xl border border-border/60 bg-background shadow-sm">
-                                        <div className="relative mx-auto w-fit max-w-full">
-                                            <img
-                                                ref={pickerImageRef}
-                                                src={pickerImageSrc}
-                                                alt="Uploaded calibration sample"
-                                                className="block max-h-[28rem] max-w-full cursor-crosshair select-none object-contain"
-                                                onLoad={handlePickerImageLoad}
-                                                onMouseMove={handleSamplerMove}
-                                                onMouseLeave={() => setSamplerPoint(null)}
-                                                onClick={handleSamplerClick}
-                                                draggable={false}
-                                            />
-                                            {lastSamplePoint && (
-                                                <div
-                                                    aria-hidden="true"
-                                                    className="pointer-events-none absolute z-10 rounded-full border-2 border-dashed border-foreground/80 bg-background/10 shadow-sm"
-                                                    style={{
-                                                        width: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
-                                                        height: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
-                                                        left: `${lastSamplePoint.x}%`,
-                                                        top: `${lastSamplePoint.y}%`,
-                                                        transform: 'translate(-50%, -50%)',
-                                                    }}
-                                                />
-                                            )}
-                                            {samplerPoint && (
-                                                <div
-                                                    aria-hidden="true"
-                                                    className="pointer-events-none absolute z-20 rounded-full border-2 border-primary bg-primary/15 shadow-[0_0_0_1px_hsl(var(--background))]"
-                                                    style={{
-                                                        width: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
-                                                        height: `${SAMPLER_BRUSH_DIAMETER_PX}px`,
-                                                        left: `${samplerPoint.x}%`,
-                                                        top: `${samplerPoint.y}%`,
-                                                        transform: 'translate(-50%, -50%)',
-                                                    }}
-                                                />
-                                            )}
-                                        </div>
-                                        <div className="pointer-events-none absolute left-3 top-3 rounded-full border border-primary/25 bg-background/90 px-3 py-1 text-[11px] font-medium text-foreground shadow-sm backdrop-blur">
-                                            Circular brush averages into {activeSamplerLabel}
-                                        </div>
-                                    </div>
-                                    <div className="rounded-lg border border-primary/15 bg-primary/5 px-3 py-2 text-xs text-muted-foreground">
-                                        {pickerStatus ??
-                                            'Move the circular brush over a uniform area, then click to capture it.'}
-                                    </div>
-                                </div>
-                            ) : (
-                                <div className="rounded-xl border border-dashed border-border/60 bg-background/60 px-4 py-8 text-center">
-                                    <div className="mx-auto max-w-sm space-y-2">
-                                        <p className="text-sm font-medium text-foreground">
-                                            No image loaded yet
-                                        </p>
-                                        <p className="text-xs leading-relaxed text-muted-foreground">
-                                            Upload a calibration photo to sample directly from it, or
-                                            keep entering RGB values manually below.
-                                        </p>
-                                    </div>
-                                </div>
-                            )}
-
-                            <canvas ref={pickerCanvasRef} className="hidden" />
-                        </div>
-                    </Card>
-
-                    <div className="grid gap-4 lg:grid-cols-2">
-                        <Card className="border-border/60 bg-muted/25 p-4">
-                            <div className="space-y-4">
-                                <div className="flex items-start justify-between gap-3">
-                                    <div className="space-y-1">
-                                        <Label className="text-sm">White Reference</Label>
-                                        <p className="text-xs leading-relaxed text-muted-foreground">
-                                            Sample the empty backlight first so the calibration uses
-                                            your real light source instead of assuming pure white.
-                                        </p>
-                                    </div>
-                                    <div className="flex items-center gap-3 rounded-xl border border-border/60 bg-background px-3 py-2">
-                                        <div
-                                            className="h-10 w-10 min-h-10 min-w-10 flex-none rounded-lg border border-border/70 shadow-inner"
-                                            style={{
-                                                backgroundColor: `rgb(${whiteReference[0]}, ${whiteReference[1]}, ${whiteReference[2]})`,
-                                            }}
-                                        />
-                                        <div className="text-right">
-                                            <div className="text-[11px] font-semibold uppercase tracking-[0.12em] text-muted-foreground">
-                                                Current
-                                            </div>
-                                            <div className="text-xs font-medium text-foreground">
-                                                {formatRgb(whiteReference)}
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-
-                                <div className="grid grid-cols-3 gap-2">
-                                    <div>
-                                        <Label htmlFor="white-r" className="text-xs">
-                                            Ref R
-                                        </Label>
-                                        <Input
-                                            id="white-r"
-                                            type="number"
-                                            min="1"
-                                            max="255"
-                                            value={whiteReferenceInput.r}
-                                            onChange={(e) =>
-                                                setWhiteReferenceInput((prev) => ({
-                                                    ...prev,
-                                                    r: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="255"
-                                        />
-                                    </div>
-                                    <div>
-                                        <Label htmlFor="white-g" className="text-xs">
-                                            Ref G
-                                        </Label>
-                                        <Input
-                                            id="white-g"
-                                            type="number"
-                                            min="1"
-                                            max="255"
-                                            value={whiteReferenceInput.g}
-                                            onChange={(e) =>
-                                                setWhiteReferenceInput((prev) => ({
-                                                    ...prev,
-                                                    g: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="255"
-                                        />
-                                    </div>
-                                    <div>
-                                        <Label htmlFor="white-b" className="text-xs">
-                                            Ref B
-                                        </Label>
-                                        <Input
-                                            id="white-b"
-                                            type="number"
-                                            min="1"
-                                            max="255"
-                                            value={whiteReferenceInput.b}
-                                            onChange={(e) =>
-                                                setWhiteReferenceInput((prev) => ({
-                                                    ...prev,
-                                                    b: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="255"
-                                        />
-                                    </div>
-                                </div>
-
-                                <div className="flex items-center justify-between gap-3">
-                                    <div className="text-xs text-muted-foreground">
-                                        Tip: use the sampler with
-                                        {' '}
-                                        <span className="font-medium text-foreground">
-                                            Fill White Reference
-                                        </span>
-                                        {' '}
-                                        selected.
-                                    </div>
-                                    <Button
-                                        variant="ghost"
-                                        size="sm"
-                                        onClick={() =>
-                                            setWhiteReferenceInput(
-                                                buildRgbInputState(DEFAULT_WHITE_REFERENCE)
-                                            )
-                                        }
-                                    >
-                                        Use 255,255,255
-                                    </Button>
-                                </div>
-                            </div>
-                        </Card>
-
-                        <Card className="border-border/60 bg-muted/25 p-4">
-                            <div className="space-y-4">
-                                <div className="flex items-start justify-between gap-3">
-                                    <div className="space-y-1">
-                                        <Label className="text-sm">Add Measurement</Label>
-                                        <p className="text-xs leading-relaxed text-muted-foreground">
-                                            Enter the patch layer count, then fill or sample the RGB
-                                            value from the center of that patch.
-                                        </p>
-                                    </div>
-                                    <div className="flex items-center gap-3 rounded-xl border border-border/60 bg-background px-3 py-2">
-                                        <div
-                                            className="h-10 w-10 min-h-10 min-w-10 flex-none rounded-lg border border-border/70 shadow-inner"
-                                            style={{
-                                                backgroundColor: `rgb(${currentMeasurementRgb[0]}, ${currentMeasurementRgb[1]}, ${currentMeasurementRgb[2]})`,
-                                            }}
-                                        />
-                                        <div className="text-right">
-                                            <div className="text-[11px] font-semibold uppercase tracking-[0.12em] text-muted-foreground">
-                                                Draft Sample
-                                            </div>
-                                            <div className="text-xs font-medium text-foreground">
-                                                {formatRgb(currentMeasurementRgb)}
-                                            </div>
-                                        </div>
-                                    </div>
-                                </div>
-
-                                <div className="rounded-xl border border-border/50 bg-background/60 p-3">
-                                    <div className="flex flex-wrap items-center justify-between gap-2">
-                                        <div className="text-xs text-muted-foreground">
-                                            Sampler shortcut:
-                                            {' '}
-                                            <span className="font-medium text-foreground">
-                                                {samplerTarget === 'measurement'
-                                                    ? 'currently filling Measurement RGB'
-                                                    : 'switch sampler target to Measurement RGB'}
-                                            </span>
-                                        </div>
-                                        <div className="rounded-full bg-muted px-2.5 py-1 text-[11px] font-medium text-muted-foreground">
-                                            Layers {currentLayers || '2'}
-                                        </div>
-                                    </div>
-                                </div>
-
-                                <div className="grid grid-cols-2 gap-2 sm:grid-cols-4">
-                                    <div>
-                                        <Label htmlFor="layers" className="text-xs">
-                                            Layers
-                                        </Label>
-                                        <Input
-                                            id="layers"
-                                            type="number"
-                                            min="1"
-                                            max="50"
-                                            value={currentLayers}
-                                            onChange={(e) => setCurrentLayers(e.target.value)}
-                                            placeholder="2"
-                                        />
-                                    </div>
-                                    <div>
-                                        <Label htmlFor="r" className="text-xs">
-                                            R
-                                        </Label>
-                                        <Input
-                                            id="r"
-                                            type="number"
-                                            min="0"
-                                            max="255"
-                                            value={currentRGB.r}
-                                            onChange={(e) =>
-                                                setCurrentRGB((prev) => ({
-                                                    ...prev,
-                                                    r: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="0-255"
-                                        />
-                                    </div>
-                                    <div>
-                                        <Label htmlFor="g" className="text-xs">
-                                            G
-                                        </Label>
-                                        <Input
-                                            id="g"
-                                            type="number"
-                                            min="0"
-                                            max="255"
-                                            value={currentRGB.g}
-                                            onChange={(e) =>
-                                                setCurrentRGB((prev) => ({
-                                                    ...prev,
-                                                    g: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="0-255"
-                                        />
-                                    </div>
-                                    <div>
-                                        <Label htmlFor="b" className="text-xs">
-                                            B
-                                        </Label>
-                                        <Input
-                                            id="b"
-                                            type="number"
-                                            min="0"
-                                            max="255"
-                                            value={currentRGB.b}
-                                            onChange={(e) =>
-                                                setCurrentRGB((prev) => ({
-                                                    ...prev,
-                                                    b: e.target.value,
-                                                }))
-                                            }
-                                            placeholder="0-255"
-                                        />
-                                    </div>
-                                </div>
-
-                                <Button onClick={handleAddMeasurement} size="sm" className="w-full">
-                                    Add Measurement
-                                </Button>
-                            </div>
-                        </Card>
-                    </div>
-
-                    {measurements.length > 0 ? (
-                        <Card className="border-border/60 bg-muted/15 p-4">
-                            <div className="space-y-3">
-                                <div>
-                                    <Label className="text-sm">Saved Measurements</Label>
-                                    <p className="text-xs text-muted-foreground">
-                                        {measurements.length} captured so far. You need at least 3
-                                        to calculate TD.
-                                    </p>
-                                </div>
-                                <div className="max-h-48 space-y-2 overflow-y-auto pr-1">
-                                    {measurements.map((m, i) => (
-                                        <div
-                                            key={i}
-                                            className="flex items-center justify-between gap-3 rounded-xl border border-border/60 bg-background/80 px-3 py-2"
-                                        >
-                                            <div className="flex min-w-0 items-center gap-3">
-                                                <div className="rounded-full bg-muted px-2.5 py-1 text-[11px] font-semibold text-foreground">
-                                                    {m.layers} layers
-                                                </div>
-                                                <div
-                                                    className="h-8 w-8 rounded-lg border border-border/70 shadow-inner"
-                                                    style={{
-                                                        backgroundColor: `rgb(${m.rgb[0]}, ${m.rgb[1]}, ${m.rgb[2]})`,
-                                                    }}
-                                                />
-                                                <div className="min-w-0">
-                                                    <div className="text-sm font-medium text-foreground">
-                                                        {formatRgb(m.rgb)}
-                                                    </div>
-                                                    <div className="text-[11px] text-muted-foreground">
-                                                        Normalized from your white reference
-                                                    </div>
-                                                </div>
-                                            </div>
-                                            <Button
-                                                variant="ghost"
-                                                size="sm"
-                                                onClick={() => handleRemoveMeasurement(i)}
-                                            >
-                                                Remove
-                                            </Button>
-                                        </div>
-                                    ))}
-                                </div>
-                            </div>
-                        </Card>
-                    ) : (
-                        <Card className="border-dashed border-border/60 bg-muted/10 p-4">
-                            <div className="space-y-1 text-center">
-                                <p className="text-sm font-medium text-foreground">
-                                    No measurements added yet
-                                </p>
-                                <p className="text-xs text-muted-foreground">
-                                    Recommended patch counts:{' '}
-                                    <span className="font-medium text-foreground">
-                                        {recommended.join(', ')}
-                                    </span>
-                                </p>
-                            </div>
-                        </Card>
-                    )}
-
-                    {!ready && reason && (
-                        <div className="rounded-lg border border-amber-500/30 bg-amber-500/10 px-3 py-2 text-xs text-amber-600 dark:text-amber-400">
-                            {reason}
-                        </div>
-                    )}
-
-                    {errorMessage && (
-                        <div className="rounded-lg border border-destructive/30 bg-destructive/10 px-3 py-2 text-xs text-destructive">
-                            {errorMessage}
-                        </div>
-                    )}
-                </div>
-
-                <AlertDialogFooter>
-                    <Button variant="outline" onClick={() => setStep('print')}>
-                        Back
-                    </Button>
-                    <Button onClick={handleCalculate} disabled={!ready}>
-                        Calculate TD
-                    </Button>
-                </AlertDialogFooter>
-            </>
-        );
-    };
-
-    const renderResults = () => {
-        if (!result) return null;
-
-        const confidenceLabel = getConfidenceLabel(result.confidence);
-        const confidenceColor = getConfidenceColor(result.confidence);
-
-        return (
-            <>
-                <AlertDialogHeader>
-                    <AlertDialogTitle>Calibration Complete! 🎉</AlertDialogTitle>
-                </AlertDialogHeader>
-                <p className="text-sm mb-4">
-                    Your filament has been calibrated successfully.
-                </p>
-
-                <div className="space-y-4 py-4">
-                    <Card className="p-4 space-y-3">
-                        <div className="flex items-center justify-between">
-                            <div className="flex items-center gap-2">
-                                <div
-                                    className="w-8 h-8 rounded border"
-                                    style={{ backgroundColor: filamentColor }}
-                                />
-                                <div>
-                                    <p className="font-semibold">{filamentName}</p>
-                                    <p className="text-xs text-muted-foreground">
-                                        {result.measurements.length} measurements
-                                    </p>
-                                </div>
-                            </div>
-                            <div className="text-right">
-                                <p className="text-2xl font-bold">
-                                    {result.tdSingleValue.toFixed(2)}mm
-                                </p>
-                                <p className="text-xs text-muted-foreground">Auto-paint working TD</p>
-                            </div>
-                        </div>
-
-                        <div className="grid grid-cols-3 gap-2 text-xs">
-                            <div className="text-center p-2 bg-red-100 dark:bg-red-900/20 rounded">
-                                <p className="font-semibold">R: {result.td[0].toFixed(2)}mm</p>
-                            </div>
-                            <div className="text-center p-2 bg-green-100 dark:bg-green-900/20 rounded">
-                                <p className="font-semibold">G: {result.td[1].toFixed(2)}mm</p>
-                            </div>
-                            <div className="text-center p-2 bg-blue-100 dark:bg-blue-900/20 rounded">
-                                <p className="font-semibold">B: {result.td[2].toFixed(2)}mm</p>
-                            </div>
-                        </div>
-
-                        {result.whiteReference && (
-                            <div className="flex items-center justify-between pt-2 border-t text-sm">
-                                <span>White reference:</span>
-                                <span className="font-mono text-xs">
-                                    RGB({result.whiteReference[0]}, {result.whiteReference[1]},{' '}
-                                    {result.whiteReference[2]})
-                                </span>
-                            </div>
-                        )}
-
-                        <div className="flex items-center justify-between pt-2 border-t">
-                            <span className="text-sm">Confidence:</span>
-                            <span className={`text-sm font-semibold ${confidenceColor}`}>
-                                {confidenceLabel} ({(result.confidence * 100).toFixed(0)}%)
-                            </span>
-                        </div>
-
-                        <p className="text-xs text-muted-foreground">
-                            This value blends the measured patch fit with the filament color
-                            heuristic when the photo data is noisy or weakly informative.
-                        </p>
-                    </Card>
-
-                    <p className="text-xs text-muted-foreground">
-                        💡 This calibration will be saved with your filament profile and improve
-                        auto-paint accuracy.
-                    </p>
-                </div>
-
-                <AlertDialogFooter>
-                    <Button variant="outline" onClick={handleCancel}>
-                        Discard
-                    </Button>
-                    <Button onClick={handleComplete}>Save Calibration</Button>
-                </AlertDialogFooter>
-            </>
-        );
-    };
-
-    return (
-        <AlertDialog open={open} onOpenChange={(isOpen) => {
-            if (!isOpen) {
-                onClose();
-            }
-        }}>
-            <AlertDialogContent className="fixed left-1/2 top-1/2 z-50 flex max-h-[90vh] w-[min(96vw,82rem)] max-w-[82rem] -translate-x-1/2 -translate-y-1/2 flex-col gap-4 overflow-y-auto rounded-lg border border-border bg-background p-6 shadow-lg">
-                <AlertDialogDescription className="sr-only">
-                    Filament calibration wizard for measuring transmission distance (TD) values to improve auto-paint results
-                </AlertDialogDescription>
-                <Button
-                    variant="ghost"
-                    size="icon"
-                    onClick={handleCancel}
-                    className="absolute right-3 top-3 h-7 w-7 text-muted-foreground hover:text-foreground"
-                    aria-label="Close calibration wizard"
-                >
-                    <X className="h-4 w-4" />
-                </Button>
-                {step === 'intro' && renderIntro()}
-                {step === 'print' && renderPrintInstructions()}
-                {step === 'measure' && renderMeasurement()}
-                {step === 'results' && renderResults()}
-            </AlertDialogContent>
-        </AlertDialog>
-    );
-}
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index 0ae437d..6ae3b83 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -1,7 +1,7 @@
 import React, { useEffect, useState } from 'react';
 import { Input } from '@/components/ui/input';
 import { Button } from '@/components/ui/button';
-import { Trash2, Wand2, FlaskConical, BadgeCheck } from 'lucide-react';
+import { Trash2, Wand2, BadgeCheck } from 'lucide-react';
 import { HexColorPicker } from 'react-colorful';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import type { Filament } from '../types';
@@ -12,14 +12,12 @@ interface FilamentRowProps {
     filament: Filament;
     onUpdate: (id: string, updates: Partial<Omit<Filament, 'id'>>) => void;
     onRemove: (id: string) => void;
-    onCalibrate?: (id: string) => void; // Optional calibration callback
 }
 
 const FilamentRow = React.memo(function FilamentRow({
     filament,
     onUpdate,
     onRemove,
-    onCalibrate,
 }: FilamentRowProps) {
     // Local state for the input value to allow free typing
     const [localTd, setLocalTd] = useState<string>(filament.td.toString());
@@ -177,31 +175,14 @@ const FilamentRow = React.memo(function FilamentRow({
                 <Wand2 className="w-4 h-4" />
             </Button>
 
-            {/* Calibration Button & Badge */}
-            {onCalibrate && (
-                <div className="flex items-center gap-1">
-                    {isCalibrated && (
-                        <div
-                            className={`flex h-8 items-center gap-1 px-2 rounded-md bg-muted/50 ${confidenceColorClass}`}
-                            title={`Confidence: ${confidenceLabel} (${(confidence * 100).toFixed(0)}%)`}
-                        >
-                            <BadgeCheck className="w-3 h-3" />
-                            <span className="text-[10px] font-medium">{confidenceLabel}</span>
-                        </div>
-                    )}
-                    <Button
-                        variant="ghost"
-                        size="icon"
-                        onClick={() => onCalibrate(filament.id)}
-                        className={`h-8 w-8 cursor-pointer ${
-                            isCalibrated
-                                ? 'text-muted-foreground hover:text-blue-600 hover:bg-blue-600/10'
-                                : 'text-muted-foreground hover:text-purple-600 hover:bg-purple-600/10'
-                        }`}
-                        title={isCalibrated ? 'Recalibrate filament' : 'Calibrate filament for accurate TD'}
-                    >
-                        <FlaskConical className="w-4 h-4" />
-                    </Button>
+            {/* Calibration Badge */}
+            {isCalibrated && (
+                <div
+                    className={`flex h-8 items-center gap-1 px-2 rounded-md bg-muted/50 ${confidenceColorClass}`}
+                    title={`Calibrated · Confidence: ${confidenceLabel} (${(confidence * 100).toFixed(0)}%)`}
+                >
+                    <BadgeCheck className="w-3 h-3" />
+                    <span className="text-[10px] font-medium">{confidenceLabel}</span>
                 </div>
             )}
 
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index d29597b..fa11b1c 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -497,6 +497,7 @@ export default function ThreeDControls({
                     error={autoPaintError}
                     calibrationLayerHeight={calibrationLayerHeight}
                     setCalibrationLayerHeight={setCalibrationLayerHeight}
+                    firstLayerHeight={slicerFirstLayerHeight}
                     filteredCount={filtered.length}
                     imageSwatches={filtered}
                     enhancedColorMatch={enhancedColorMatch}
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 5054c20..f26d349 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -42,17 +42,18 @@ Auto-paint uses real filament colors and **Transmission Distance (TD)** values.
 - Filament color.
 - TD value.
 
-Use the wand button to auto-estimate TD from color, or use the calibration button to measure TD from printed test patches.
+Use the wand button to auto-estimate TD from color, or calibrate to measure TD from a printed wedge.
 
 ## Calibrating Filament TD
 
-Click the calibration button on a filament row to open **Calibrate Filament TD**. The wizard has three parts:
+Calibration is camera-free: you print a small wedge and read back a single number. Click the calibration button on a filament row, or **Calibrate Filaments** below the filament list, to open the dialog. It has four steps:
 
-1. **Step 1: Print Test Patches** lists the filament, layer height, 100% infill, patch size, and layer counts. Use **Download Test Patches STL** if you want Kromacut to generate the patch model.
-2. **Step 2: Measure RGB Values** lets you enter measurements manually or upload a photo with **Image Sampler**. Use **Fill White Reference** on the empty backlight first, then use **Fill Measurement RGB** for each printed patch. The visible circular brush averages the pixels inside it, so place it over a uniform patch area and away from edges or glare.
-3. **Calibration Complete** shows the fitted TD value, RGB channel estimates, white reference, and confidence. Click **Save Calibration** to apply it to the filament.
+1. **Select** the filaments you want to calibrate.
+2. **Base layers** — choose the base filament each one prints over. It defaults to your darkest filament (matching how frontlit prints are viewed), and the base comes from your real profile filaments, so no extra "phantom" filament is added to the print. A dark filament has too little contrast with a dark base, so switch its base to a lighter one (e.g. white) here.
+3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer — print it once per filament, base then your color above the base) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). Each filament prints as a row of patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
+4. **Enter Results** by reporting, for each filament, the **first patch that looks identical to the reference rail** beside it — that is its opacity layer. Kromacut converts that number into a frontlit TD (with per-channel values), shows a predicted-vs-reference swatch, the TD, and a confidence rating. Click **Save Calibration** to apply it.
 
-Use at least three saved measurements before calculating TD. More measurements usually improve confidence if the lighting and sampling setup stays consistent.
+Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured TD is a material property, so it transfers to your real prints regardless of which base you calibrated against.
 
 ## Filament Profiles
 
diff --git a/src/docs/troubleshooting.md b/src/docs/troubleshooting.md
index 5a95206..86d82cf 100644
--- a/src/docs/troubleshooting.md
+++ b/src/docs/troubleshooting.md
@@ -45,7 +45,7 @@ Common causes:
 - The optimizer needs **Enhanced color matching** enabled.
 - The important subject is in the center or edges but **Region priority** is set to **Uniform**.
 
-Use the calibration wizard and check **Result Confidence** for clues.
+Calibrate your filaments and check **Result Confidence** for clues.
 
 ## The 3D Build Is Slow
 
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 4e2ff39..1d59f05 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -389,8 +389,10 @@ function transitionThicknessMultiplier(targetOpacity: number): number {
 }
 
 /**
- * Frontlit prints behave optically like a much shorter effective TD.
- * Scale user-entered TD values down for internal simulation.
+ * Fallback for UNCALIBRATED filaments only: frontlit prints behave optically like
+ * a much shorter effective TD, so a generic user-entered TD is scaled down for
+ * internal simulation. Calibrated filaments carry measured frontlit TDs and skip
+ * this — the frontlit calibration flow exists to replace this approximation.
  */
 const FRONTLIT_TD_SCALE = 0.1;
 const USE_CALIBRATED_CHANNEL_TD = true;
@@ -407,21 +409,13 @@ function calibratedTdChannels(filament: AutoPaintFilament): CalibrationRgb | und
 }
 
 function scaleFilamentForFrontlight(filament: Filament): Filament {
-    const scaledTd = filament.td * FRONTLIT_TD_SCALE;
-    if (!filament.calibration) {
-        return { ...filament, td: scaledTd };
+    // Calibrated filaments already carry measured frontlit TDs (scalar + per
+    // channel), so they pass through unchanged. Only uncalibrated filaments get
+    // the generic frontlit approximation.
+    if (filament.calibration) {
+        return filament;
     }
-
-    const calibration = filament.calibration;
-    return {
-        ...filament,
-        td: scaledTd,
-        calibration: {
-            ...calibration,
-            td: calibration.td.map((td) => td * FRONTLIT_TD_SCALE) as CalibrationRgb,
-            tdSingleValue: calibration.tdSingleValue * FRONTLIT_TD_SCALE,
-        },
-    };
+    return { ...filament, td: filament.td * FRONTLIT_TD_SCALE };
 }
 
 /**
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index 889358e..c8023a2 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -1,486 +1,287 @@
-import { estimateTDFromColor } from './colorUtils';
-import { blendSrgbChannel, srgbChannelToLinear } from './colorSpace';
-
 /**
- * Filament Calibration System
+ * Frontlit filament calibration.
  *
- * Implements TD (Transmission Distance) calibration workflow where users measure
- * light transmission through stacked filament layers to derive accurate TD values.
+ * Camera-free workflow: the user prints a wedge of 1..N filament layers over a
+ * black base plus a fully-opaque reference patch, then reports the single layer
+ * count at which the wedge first becomes indistinguishable from the reference.
+ * That one integer is converted to a frontlit Transmission Distance (TD) here.
  *
- * Calibration process:
- * 1. User prints test patches at different layer counts (e.g., 2, 4, 6, 8, 10 layers)
- * 2. User photographs patches on backlit surface and samples RGB values
- * 3. Algorithm fits a linear-light Beer-Lambert curve to derive TD for each color channel
- * 4. Confidence score computed based on fit quality and measurement consistency
+ * The "indistinguishable" judgment is a perceptual just-noticeable difference, so
+ * opacity is defined the same way: the transmission `T*` at which the over-black
+ * blend sits exactly `jnd` ΔE00 from the opaque filament color. `T*` depends only
+ * on the filament color and the JND (not on TD), so it is a per-color "effective
+ * opacity transmission" — `TD = -d_opaque / log10(T*)` recovers the Beer-Lambert
+ * form with a principled, color-aware constant instead of a hand-picked number.
  */
 
+import { blendSrgbChannel } from './colorSpace';
+import { deltaE2000 } from './colorDifference';
+
 // ============================================================================
-// Type Definitions
+// Types
 // ============================================================================
 
-/**
- * Single measurement point: layer count and measured RGB.
- *
- * Transmission is intentionally NOT stored. It is a derived quantity, and the
- * TD fit recomputes it from `rgb` using the same linear-light blend model
- * Auto-paint uses (see transmissionFromMeasuredBlend), so there is no second,
- * divergent definition to keep in sync.
- */
 export type CalibrationRgb = [number, number, number];
 
-export interface CalibrationMeasurement {
-    layers: number; // Number of layers printed
-    rgb: CalibrationRgb; // Measured RGB value (0-255)
+export interface FrontlitCalibration {
+    /** Layer count at which the wedge first matched the opaque reference. */
+    opacityLayers: number;
+    /** Layer height the calibration print used (mm). */
+    layerHeight: number;
+    /** First-layer height the calibration print used (mm). */
+    firstLayerHeight: number;
+    /** Per-channel frontlit TD derived from the read (mm). */
+    td: CalibrationRgb;
+    /** Scalar working TD used by auto-paint (mm). */
+    tdSingleValue: number;
+    /** JND used for the opacity solve. */
+    jnd: number;
+    /** Base color the wedge was calibrated over (hex). */
+    baseColor?: string;
+    /** 0-1 quality score. */
+    confidence: number;
+    /** Calibration basis, fixed for now. */
+    basis: 'black-frontlit';
+    /** ISO timestamp. */
+    calibrationDate: string;
+    notes?: string;
 }
 
-/**
- * Complete calibration result for a filament
- */
-export interface CalibrationResult {
-    color: string; // Hex color
-    measurements: CalibrationMeasurement[];
-    whiteReference?: CalibrationRgb; // Measured backlight RGB used to normalize transmission
-    td: CalibrationRgb; // Fitted TD for R, G, B channels (mm)
-    tdSingleValue: number; // Auto-paint working TD derived from the measured samples (mm)
-    confidence: number; // 0-1 score based on fit quality
-    calibrationDate: string; // ISO timestamp
-    notes?: string; // Optional user notes
-}
+export type FrontlitCalibrationResult =
+    | { ok: true; calibration: FrontlitCalibration }
+    | { ok: false; error: string };
 
-/**
- * Calibration wizard state
- */
-export interface CalibrationState {
+export interface FrontlitCalibrationInput {
     filamentColor: string;
-    measurements: CalibrationMeasurement[];
-    whiteReference: CalibrationRgb;
-    currentStep: 'intro' | 'print' | 'measure' | 'results';
-    layerHeight: number; // mm per layer
+    opacityLayers: number;
+    layerHeight: number;
+    firstLayerHeight: number;
+    /** Base color the wedge prints over (hex). Defaults to black. */
+    baseColor?: string;
+    /** Highest layer count printed on the wedge; used to flag clipped reads. */
+    maxLayers?: number;
+    jnd?: number;
+    notes?: string;
 }
 
 // ============================================================================
 // Constants
 // ============================================================================
 
-export const RECOMMENDED_LAYER_COUNTS = [2, 4, 6, 8, 10];
-export const DEFAULT_WHITE_REFERENCE: CalibrationRgb = [255, 255, 255];
-const MIN_MEASUREMENTS = 3;
-const CONFIDENCE_THRESHOLD_EXCELLENT = 0.9;
-const CONFIDENCE_THRESHOLD_GOOD = 0.7;
-const WORKING_TD_MIN = 0.4;
-const WORKING_TD_MAX = 12.0;
-const WORKING_TD_GRID_STEPS = 240;
-const MIN_CHANNEL_CONTRAST = 12;
-
-const clampRgbChannel = (value: number, min: number) => {
-    if (!Number.isFinite(value)) return min;
-    return Math.min(255, Math.max(min, Math.round(value)));
-};
-
-function sanitizeWhiteReference(
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
-): CalibrationRgb {
-    return [
-        clampRgbChannel(whiteReference[0], 1),
-        clampRgbChannel(whiteReference[1], 1),
-        clampRgbChannel(whiteReference[2], 1),
-    ];
-}
+/** Default base the calibration wedge prints on (black). */
+export const FRONTLIT_BASE: CalibrationRgb = [0, 0, 0];
+export const FRONTLIT_BASE_HEX = '#000000';
 
-export function validateWhiteReference(whiteReference: CalibrationRgb): {
-    valid: boolean;
-    error?: string;
-} {
-    const [r, g, b] = whiteReference;
-    if (r < 1 || r > 255 || g < 1 || g > 255 || b < 1 || b > 255) {
-        return {
-            valid: false,
-            error: 'White reference RGB values must be between 1 and 255',
-        };
-    }
-    return { valid: true };
-}
+/**
+ * Perceptual just-noticeable difference (CIEDE2000) defining "indistinguishable
+ * from the opaque reference patch." ~1 is the textbook JND; 2 is forgiving for
+ * real room-light viewing. This is a human-vision constant, NOT fit to any
+ * filament — per-filament optics come from the read. Tune against physical
+ * frontlit prints.
+ */
+export const OPACITY_JND = 2.0;
 
-const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value));
+const FRONTLIT_TD_MIN = 0.05;
+const FRONTLIT_TD_MAX = 12.0;
 
-function getBlendChannelWeights(
-    filamentRgb: CalibrationRgb,
-    whiteReference: CalibrationRgb
-): CalibrationRgb {
-    const rawWeights: CalibrationRgb = [0, 1, 2].map((channel) => {
-        const contrast = Math.abs(whiteReference[channel] - filamentRgb[channel]);
-        return contrast >= MIN_CHANNEL_CONTRAST ? contrast : contrast * 0.25;
-    }) as CalibrationRgb;
-    const total = rawWeights.reduce((sum, weight) => sum + weight, 0);
+const CONFIDENCE_THRESHOLD_EXCELLENT = 0.9;
+const CONFIDENCE_THRESHOLD_GOOD = 0.7;
 
-    if (total <= 1e-6) {
-        return [1 / 3, 1 / 3, 1 / 3];
-    }
+const clamp = (value: number, min: number, max: number) => Math.min(max, Math.max(min, value));
 
-    return rawWeights.map((weight) => weight / total) as CalibrationRgb;
+function hexToRgb(hex: string): CalibrationRgb | null {
+    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+    return result
+        ? [parseInt(result[1], 16), parseInt(result[2], 16), parseInt(result[3], 16)]
+        : null;
 }
 
-function predictWorkingBlendRgb(
+// ============================================================================
+// Opacity-read calibration
+// ============================================================================
+
+function blendOverBase(
     filamentRgb: CalibrationRgb,
-    whiteReference: CalibrationRgb,
-    td: number,
-    thickness: number
+    transmission: number,
+    base: CalibrationRgb = FRONTLIT_BASE
 ): CalibrationRgb {
-    const transmission = Math.pow(10, -thickness / td);
     return [
-        Math.round(blendSrgbChannel(whiteReference[0], filamentRgb[0], transmission)),
-        Math.round(blendSrgbChannel(whiteReference[1], filamentRgb[1], transmission)),
-        Math.round(blendSrgbChannel(whiteReference[2], filamentRgb[2], transmission)),
+        blendSrgbChannel(base[0], filamentRgb[0], transmission),
+        blendSrgbChannel(base[1], filamentRgb[1], transmission),
+        blendSrgbChannel(base[2], filamentRgb[2], transmission),
     ];
 }
 
-function transmissionFromMeasuredBlend(
-    measured: number,
-    filament: number,
-    background: number
-): number | undefined {
-    const filamentLinear = srgbChannelToLinear(filament);
-    const backgroundLinear = srgbChannelToLinear(background);
-    const contrast = backgroundLinear - filamentLinear;
-
-    if (Math.abs(contrast) < 1e-6) return undefined;
-
-    const transmission = (srgbChannelToLinear(measured) - filamentLinear) / contrast;
-    return transmission > 0 && transmission < 1 ? transmission : undefined;
-}
-
-function evaluateWorkingTdFit(
-    measurements: CalibrationMeasurement[],
-    layerHeight: number,
-    filamentRgb: CalibrationRgb,
-    whiteReference: CalibrationRgb,
-    channelWeights: CalibrationRgb,
-    td: number
-): number {
-    let weightedSquaredError = 0;
-
-    for (const measurement of measurements) {
-        const thickness = measurement.layers * layerHeight;
-        const predicted = predictWorkingBlendRgb(filamentRgb, whiteReference, td, thickness);
-
-        weightedSquaredError +=
-            channelWeights[0] * Math.pow(predicted[0] - measurement.rgb[0], 2) +
-            channelWeights[1] * Math.pow(predicted[1] - measurement.rgb[1], 2) +
-            channelWeights[2] * Math.pow(predicted[2] - measurement.rgb[2], 2);
-    }
-
-    return weightedSquaredError / measurements.length;
-}
-
-function fitWorkingTdFromMeasurements(
-    measurements: CalibrationMeasurement[],
-    layerHeight: number,
+/**
+ * Solve for the transmission `T*` at which the over-base blend is exactly `jnd`
+ * ΔE00 from the opaque filament color. ΔE00 grows monotonically with T (more
+ * base shows through), so a bisection converges to a unique value.
+ *
+ * Returns undefined when even full background (T=1, pure base) is within the JND
+ * of the filament — i.e. the filament has too little contrast with the base to be
+ * opacity-calibrated (e.g. a black filament over a black base; switch to a lighter
+ * base).
+ */
+export function solveOpacityTransmission(
     filamentColor: string,
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
-): { td: number; confidence: number } {
-    const filamentRgb = hexToRgb(filamentColor);
-    if (!filamentRgb) {
-        return { td: estimateTDFromColor(filamentColor), confidence: 0.1 };
-    }
-
-    const reference = sanitizeWhiteReference(whiteReference);
-    const channelWeights = getBlendChannelWeights(filamentRgb, reference);
-    const heuristicTd = estimateTDFromColor(filamentColor);
-    const logMin = Math.log(WORKING_TD_MIN);
-    const logMax = Math.log(WORKING_TD_MAX);
+    jnd = OPACITY_JND,
+    baseColor: string = FRONTLIT_BASE_HEX
+): number | undefined {
+    const rgb = hexToRgb(filamentColor);
+    const base = hexToRgb(baseColor) ?? FRONTLIT_BASE;
+    if (!rgb) return undefined;
 
-    let bestTd = heuristicTd;
-    let bestError = Number.POSITIVE_INFINITY;
+    const deltaAt = (t: number) => deltaE2000(blendOverBase(rgb, t, base), rgb);
 
-    for (let i = 0; i < WORKING_TD_GRID_STEPS; i++) {
-        const t = i / (WORKING_TD_GRID_STEPS - 1);
-        const candidateTd = Math.exp(logMin + (logMax - logMin) * t);
-        const error = evaluateWorkingTdFit(
-            measurements,
-            layerHeight,
-            filamentRgb,
-            reference,
-            channelWeights,
-            candidateTd
-        );
-
-        if (error < bestError) {
-            bestError = error;
-            bestTd = candidateTd;
-        }
-    }
+    // Not enough contrast with the base to ever reach the JND.
+    if (deltaAt(1) < jnd) return undefined;
 
-    let refineMin = Math.max(WORKING_TD_MIN, bestTd / 1.8);
-    let refineMax = Math.min(WORKING_TD_MAX, bestTd * 1.8);
-
-    for (let pass = 0; pass < 2; pass++) {
-        let passBestTd = bestTd;
-        let passBestError = bestError;
-
-        for (let i = 0; i < WORKING_TD_GRID_STEPS; i++) {
-            const t = i / (WORKING_TD_GRID_STEPS - 1);
-            const candidateTd = refineMin + (refineMax - refineMin) * t;
-            const error = evaluateWorkingTdFit(
-                measurements,
-                layerHeight,
-                filamentRgb,
-                reference,
-                channelWeights,
-                candidateTd
-            );
-
-            if (error < passBestError) {
-                passBestError = error;
-                passBestTd = candidateTd;
-            }
-        }
-
-        bestTd = passBestTd;
-        bestError = passBestError;
-        refineMin = Math.max(WORKING_TD_MIN, bestTd / 1.35);
-        refineMax = Math.min(WORKING_TD_MAX, bestTd * 1.35);
+    let lo = 0; // ΔE = 0 at T=0 (pure filament)
+    let hi = 1; // ΔE maximal at T=1 (pure base)
+    for (let i = 0; i < 48; i++) {
+        const mid = (lo + hi) / 2;
+        if (deltaAt(mid) < jnd) lo = mid;
+        else hi = mid;
     }
-
-    const weightedRmse = Math.sqrt(bestError);
-    const averageContrast =
-        (Math.abs(reference[0] - filamentRgb[0]) +
-            Math.abs(reference[1] - filamentRgb[1]) +
-            Math.abs(reference[2] - filamentRgb[2])) /
-        3;
-    const contrastStrength = clamp(averageContrast / 255, 0, 1);
-    const measurementCoverage = clamp(
-        (measurements.length - MIN_MEASUREMENTS) / (RECOMMENDED_LAYER_COUNTS.length - MIN_MEASUREMENTS),
-        0,
-        1
-    );
-    const fitConfidence = clamp(1 - weightedRmse / 28, 0, 1);
-    const agreement =
-        Math.min(bestTd, heuristicTd) / Math.max(bestTd, heuristicTd, WORKING_TD_MIN);
-    const measurementInfluence = clamp(
-        fitConfidence *
-            (0.3 + 0.7 * contrastStrength) *
-            (0.6 + 0.4 * measurementCoverage) *
-            (0.35 + 0.65 * Math.sqrt(agreement)),
-        0,
-        0.9
-    );
-
-    const blendedTd = clamp(
-        heuristicTd + (bestTd - heuristicTd) * measurementInfluence,
-        WORKING_TD_MIN,
-        WORKING_TD_MAX
-    );
-    const confidence = clamp(0.25 + 0.75 * Math.max(fitConfidence, measurementInfluence), 0.1, 1);
-
-    return { td: blendedTd, confidence };
+    return (lo + hi) / 2;
 }
 
-// ============================================================================
-// Core Calibration Algorithm
-// ============================================================================
-
 /**
- * Calculate TD from calibration measurements using Beer-Lambert law.
- *
- * Beer-Lambert: T = 10^(-d/TD)
- * Where T = transmission, d = distance (layers × layer_height), TD = transmission distance
- *
- * Solving for TD: TD = -d / log10(T)
- *
- * For each channel, we compute TD from each measurement pair, then
- * use weighted least-squares to fit a robust average.
+ * Derive per-channel TDs from the single measured TD, modulated by the filament
+ * color. Uses a `1 + value*5.8` shape per channel (the per-channel form of the
+ * estimateTDFromColor luminance heuristic): a brighter channel is more
+ * transmissive (larger TD). The brightest channel — which governs the opacity
+ * the eye reads — is anchored to `tdSingle`, so darker (more absorptive) channels
+ * scale down from there.
  */
-export function calculateTDFromMeasurements(
-    measurements: CalibrationMeasurement[],
-    layerHeight: number,
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE,
-    filamentColor: string = '#808080'
-): { td: [number, number, number]; tdSingleValue: number; confidence: number } {
-    if (measurements.length < MIN_MEASUREMENTS) {
-        throw new Error(
-            `Need at least ${MIN_MEASUREMENTS} measurements, got ${measurements.length}`
-        );
-    }
-
-    // Sort measurements by layer count
-    const sorted = [...measurements].sort((a, b) => a.layers - b.layers);
-
-    // Compute TD for each channel independently
-    const tdChannels: [number, number, number] = [0, 0, 0];
-    const confidences: [number, number, number] = [0, 0, 0];
-
-    const filamentRgb = hexToRgb(filamentColor) ?? [128, 128, 128];
-    const reference = sanitizeWhiteReference(whiteReference);
+export function deriveChannelTds(filamentColor: string, tdSingle: number): CalibrationRgb {
+    const rgb = hexToRgb(filamentColor) ?? [128, 128, 128];
+    const raw = rgb.map((c) => 1 + (c / 255) * 5.8) as CalibrationRgb;
+    const anchor = Math.max(raw[0], raw[1], raw[2]);
+    const k = tdSingle / anchor;
+    return raw.map((value) => clamp(k * value, FRONTLIT_TD_MIN, FRONTLIT_TD_MAX)) as CalibrationRgb;
+}
 
-    for (let channel = 0; channel < 3; channel++) {
-        const { td, confidence } = fitTDForChannel(
-            sorted,
-            channel,
-            layerHeight,
-            filamentRgb,
-            reference
-        );
-        tdChannels[channel] = td;
-        confidences[channel] = confidence;
+function frontlitConfidence(opacityLayers: number, tdSingle: number, maxLayers?: number): number {
+    let confidence = 0.9;
+    // Reads pinned at either extreme of the wedge are less trustworthy: the true
+    // opacity point may lie outside the printed range.
+    if (opacityLayers <= 1) confidence -= 0.3;
+    if (maxLayers !== undefined && opacityLayers >= maxLayers) confidence -= 0.3;
+    // A TD against either clamp edge means the read fell outside the model's band.
+    if (tdSingle <= FRONTLIT_TD_MIN * 1.5 || tdSingle >= FRONTLIT_TD_MAX * 0.9) {
+        confidence -= 0.2;
     }
-
-    const workingFit = fitWorkingTdFromMeasurements(
-        sorted,
-        layerHeight,
-        filamentColor,
-        whiteReference
-    );
-    const tdSingleValue = workingFit.td;
-
-    // Overall confidence combines the per-channel fit stability with the
-    // working-TD fit quality used by auto-paint.
-    const confidence = (Math.min(...confidences) + workingFit.confidence) / 2;
-
-    return { td: tdChannels, tdSingleValue, confidence };
+    return clamp(confidence, 0.1, 1);
 }
 
 /**
- * Fit TD for a single color channel using weighted least-squares
+ * Convert a single opacity-layer read into a frontlit calibration.
+ *
+ * The color wedge prints on top of the black base, so every color layer is a
+ * regular layer — `d_opaque = opacityLayers * layerHeight`. `firstLayerHeight`
+ * is stored (it governs the black base bottom layer and keeps auto-paint's
+ * thickness model consistent) but does not enter the color thickness.
  */
-function fitTDForChannel(
-    measurements: CalibrationMeasurement[],
-    channel: number,
-    layerHeight: number,
-    filamentRgb: CalibrationRgb,
-    whiteReference: CalibrationRgb
-): { td: number; confidence: number } {
-    // Compute TD from each measurement
-    const tdEstimates: Array<{ td: number; thickness: number; transmission: number }> = [];
-
-    for (const measurement of measurements) {
-        const transmission = transmissionFromMeasuredBlend(
-            measurement.rgb[channel],
-            filamentRgb[channel],
-            whiteReference[channel]
-        );
-        if (transmission === undefined) continue; // Skip invalid or zero-contrast measurements
-
-        const thickness = measurement.layers * layerHeight;
-        const td = -thickness / Math.log10(transmission);
-
-        if (td > 0 && td < 100) {
-            // Sanity check: TD should be 0.5-20mm typically
-            tdEstimates.push({ td, thickness, transmission });
-        }
+export function computeFrontlitCalibration(
+    input: FrontlitCalibrationInput
+): FrontlitCalibrationResult {
+    const { filamentColor, opacityLayers, layerHeight, firstLayerHeight } = input;
+    const jnd = input.jnd ?? OPACITY_JND;
+    const baseColor = input.baseColor ?? FRONTLIT_BASE_HEX;
+
+    if (!Number.isFinite(opacityLayers) || opacityLayers < 1) {
+        return { ok: false, error: 'Opacity layer count must be at least 1.' };
     }
-
-    if (tdEstimates.length === 0) {
-        // Fallback: return default TD with low confidence
-        return { td: 2.0, confidence: 0.1 };
+    if (!Number.isFinite(layerHeight) || layerHeight <= 0) {
+        return { ok: false, error: 'Layer height must be a positive number.' };
     }
 
-    // Weighted average: measurements with moderate transmission (0.2-0.8) get higher weight
-    let weightedSum = 0;
-    let totalWeight = 0;
-
-    for (const { td, transmission } of tdEstimates) {
-        // Weight function: peaks at T=0.5, but preserve a small contribution
-        // from valid measurements near either endpoint.
-        const weight = Math.max(0.05, 1 - Math.abs(transmission - 0.5) * 2);
-        weightedSum += td * weight;
-        totalWeight += weight;
+    const tStar = solveOpacityTransmission(filamentColor, jnd, baseColor);
+    if (tStar === undefined || tStar <= 0 || tStar >= 1) {
+        return {
+            ok: false,
+            error: 'Too little contrast with the base to calibrate. Pick a lighter base (e.g. white) for this filament.',
+        };
     }
 
-    const tdFitted = weightedSum / totalWeight;
+    const dOpaque = opacityLayers * layerHeight;
+    const tdSingleValue = clamp(-dOpaque / Math.log10(tStar), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX);
+    const td = deriveChannelTds(filamentColor, tdSingleValue);
+    const confidence = frontlitConfidence(opacityLayers, tdSingleValue, input.maxLayers);
 
-    // Calculate confidence based on consistency of estimates
-    const variance =
-        tdEstimates.reduce((sum, { td }) => sum + Math.pow(td - tdFitted, 2), 0) /
-        tdEstimates.length;
-    const stdDev = Math.sqrt(variance);
-    const coefficientOfVariation = stdDev / tdFitted;
-
-    // Confidence: 1.0 if CV < 0.1, decreases linearly to 0.5 at CV = 0.4
-    const confidence = Math.max(0.5, 1.0 - coefficientOfVariation * 2.5);
-
-    return { td: tdFitted, confidence };
+    return {
+        ok: true,
+        calibration: {
+            opacityLayers,
+            layerHeight,
+            firstLayerHeight,
+            td,
+            tdSingleValue,
+            jnd,
+            baseColor,
+            confidence,
+            basis: 'black-frontlit',
+            calibrationDate: new Date().toISOString(),
+            notes: input.notes,
+        },
+    };
 }
 
 /**
- * Estimate expected RGB for a given layer count based on current TD estimate.
- * Useful for showing preview during calibration.
+ * Predict the displayed color of `layers` of filament over the base, using
+ * per-channel TDs. Mirrors the auto-paint blend so calibration previews match.
  */
-export function predictTransmission(
+export function predictFrontlitColor(
     filamentColor: string,
     layers: number,
     layerHeight: number,
-    td: [number, number, number],
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
+    td: CalibrationRgb,
+    baseColor: string = FRONTLIT_BASE_HEX
 ): CalibrationRgb {
-    const thickness = layers * layerHeight;
-
-    // Parse filament color
     const rgb = hexToRgb(filamentColor);
-    if (!rgb) return [128, 128, 128];
-
-    // Beer-Lambert: T = 10^(-d/TD)
-    const transmission: [number, number, number] = [
-        Math.pow(10, -thickness / td[0]),
-        Math.pow(10, -thickness / td[1]),
-        Math.pow(10, -thickness / td[2]),
-    ];
+    const base = hexToRgb(baseColor) ?? FRONTLIT_BASE;
+    if (!rgb) return [...base] as CalibrationRgb;
 
-    const reference = sanitizeWhiteReference(whiteReference);
-
-    // Simulate the same linear-light blend Auto-paint uses: the filament is
-    // the foreground and the measured backlight is the background.
-    return [
-        Math.round(blendSrgbChannel(reference[0], rgb[0], transmission[0])),
-        Math.round(blendSrgbChannel(reference[1], rgb[1], transmission[1])),
-        Math.round(blendSrgbChannel(reference[2], rgb[2], transmission[2])),
-    ];
+    const thickness = layers * layerHeight;
+    return [0, 1, 2].map((channel) => {
+        const transmission = Math.pow(10, -thickness / td[channel]);
+        return Math.round(blendSrgbChannel(base[channel], rgb[channel], transmission));
+    }) as CalibrationRgb;
 }
 
 // ============================================================================
-// Confidence Scoring
+// Confidence scoring (consumed by auto-paint + filament UI)
 // ============================================================================
 
 /**
- * Compute confidence score for a filament profile.
- * Takes into account:
- * - Whether calibration data exists
- * - Quality of calibration fit
- * - Age of calibration
- * - Number of measurements
+ * Compute confidence for a filament profile: calibration quality with an age
+ * decay, or a TD-plausibility heuristic when uncalibrated.
  */
 export function computeProfileConfidence(profile: {
-    calibration?: CalibrationResult;
+    calibration?: FrontlitCalibration;
     transmissionDistance: number;
 }): number {
     if (!profile.calibration) {
-        // No calibration data: base confidence on TD value
-        // Lower TD = more typical for lithophanes = higher confidence
         const td = profile.transmissionDistance;
-        if (td >= 1.0 && td <= 5.0) return 0.5; // Reasonable estimate
-        if (td >= 0.5 && td <= 10.0) return 0.3; // Plausible but uncertain
-        return 0.1; // Likely a guess
+        if (td >= 1.0 && td <= 5.0) return 0.5;
+        if (td >= 0.5 && td <= 10.0) return 0.3;
+        return 0.1;
     }
 
     const cal = profile.calibration;
     let confidence = cal.confidence;
 
-    // Penalize old calibrations (>6 months)
     const ageMs = Date.now() - new Date(cal.calibrationDate).getTime();
     const ageMonths = ageMs / (1000 * 60 * 60 * 24 * 30);
     if (ageMonths > 6) {
-        confidence *= Math.max(0.7, 1 - (ageMonths - 6) / 24); // Decay over 2 years
+        confidence *= Math.max(0.7, 1 - (ageMonths - 6) / 24); // decay over 2 years
     }
 
-    // Bonus for more measurements
-    const measurementBonus = Math.min(0.1, cal.measurements.length * 0.02);
-    confidence = Math.min(1.0, confidence + measurementBonus);
-
-    return confidence;
+    return clamp(confidence, 0, 1);
 }
 
-/**
- * Get confidence label for UI display
- */
+/** Confidence label for UI display. */
 export function getConfidenceLabel(confidence: number): string {
     if (confidence >= CONFIDENCE_THRESHOLD_EXCELLENT) return 'Excellent';
     if (confidence >= CONFIDENCE_THRESHOLD_GOOD) return 'Good';
@@ -488,164 +289,10 @@ export function getConfidenceLabel(confidence: number): string {
     return 'Low';
 }
 
-/**
- * Get confidence color for UI display (Tailwind classes)
- */
+/** Confidence color (Tailwind classes) for UI display. */
 export function getConfidenceColor(confidence: number): string {
     if (confidence >= CONFIDENCE_THRESHOLD_EXCELLENT) return 'text-green-600';
     if (confidence >= CONFIDENCE_THRESHOLD_GOOD) return 'text-blue-600';
     if (confidence >= 0.5) return 'text-yellow-600';
     return 'text-red-600';
 }
-
-// ============================================================================
-// Validation Helpers
-// ============================================================================
-
-/**
- * Validate a calibration measurement
- */
-export function validateMeasurement(
-    measurement: CalibrationMeasurement
-): { valid: boolean; error?: string } {
-    if (measurement.layers < 1 || measurement.layers > 50) {
-        return { valid: false, error: 'Layer count must be between 1 and 50' };
-    }
-
-    const [r, g, b] = measurement.rgb;
-    if (r < 0 || r > 255 || g < 0 || g > 255 || b < 0 || b > 255) {
-        return { valid: false, error: 'RGB values must be between 0 and 255' };
-    }
-
-    return { valid: true };
-}
-
-/**
- * Check if measurements are ready for TD calculation
- */
-export function canCalculateTD(
-    measurements: CalibrationMeasurement[],
-    whiteReference: CalibrationRgb = DEFAULT_WHITE_REFERENCE
-): {
-    ready: boolean;
-    reason?: string;
-} {
-    const whiteReferenceValidation = validateWhiteReference(whiteReference);
-    if (!whiteReferenceValidation.valid) {
-        return { ready: false, reason: whiteReferenceValidation.error };
-    }
-
-    if (measurements.length < MIN_MEASUREMENTS) {
-        return {
-            ready: false,
-            reason: `Need at least ${MIN_MEASUREMENTS} measurements (have ${measurements.length})`,
-        };
-    }
-
-    // Check for duplicate layer counts
-    const layerCounts = new Set(measurements.map((m) => m.layers));
-    if (layerCounts.size < measurements.length) {
-        return { ready: false, reason: 'Duplicate layer counts detected' };
-    }
-
-    // Validate each measurement
-    for (const measurement of measurements) {
-        const validation = validateMeasurement(measurement);
-        if (!validation.valid) {
-            return { ready: false, reason: validation.error };
-        }
-    }
-
-    return { ready: true };
-}
-
-/**
- * Get recommended layer counts that haven't been measured yet
- */
-export function getRecommendedLayerCounts(
-    existing: CalibrationMeasurement[]
-): { recommended: number[]; measured: number[] } {
-    const measured = existing.map((m) => m.layers);
-    const recommended = RECOMMENDED_LAYER_COUNTS.filter((count) => !measured.includes(count));
-    return { recommended, measured };
-}
-
-// ============================================================================
-// Utility Functions
-// ============================================================================
-
-/**
- * Parse hex color to RGB
- */
-function hexToRgb(hex: string): [number, number, number] | null {
-    const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
-    return result
-        ? [parseInt(result[1], 16), parseInt(result[2], 16), parseInt(result[3], 16)]
-        : null;
-}
-
-/**
- * Generate calibration instructions for user
- */
-export function getCalibrationInstructions(layerHeight: number): string[] {
-    return [
-        `Print test patches with ${RECOMMENDED_LAYER_COUNTS.join(', ')} layers each.`,
-        `Use your filament color with 100% infill.`,
-        `Layer height: ${layerHeight.toFixed(2)}mm.`,
-        `Place patches on a backlit white surface (e.g., phone screen at max brightness).`,
-        `Measure the bare backlight first and enter that RGB as the white reference.`,
-        `Photograph patches under consistent lighting.`,
-        `Use color picker tool to sample RGB values from center of each patch.`,
-        `Enter measurements in the calibration wizard.`,
-    ];
-}
-
-/**
- * Export calibration result to JSON for sharing
- */
-export function exportCalibration(result: CalibrationResult): string {
-    return JSON.stringify(result, null, 2);
-}
-
-/**
- * Import calibration result from JSON
- */
-export function importCalibration(json: string): CalibrationResult {
-    const parsed = JSON.parse(json);
-
-    // Validation
-    if (
-        typeof parsed.color !== 'string' ||
-        !Array.isArray(parsed.measurements) ||
-        !Array.isArray(parsed.td) ||
-        typeof parsed.tdSingleValue !== 'number' ||
-        typeof parsed.confidence !== 'number'
-    ) {
-        throw new Error('Invalid calibration data format');
-    }
-
-    if (parsed.whiteReference !== undefined) {
-        if (
-            !Array.isArray(parsed.whiteReference) ||
-            parsed.whiteReference.length !== 3 ||
-            !validateWhiteReference(parsed.whiteReference as CalibrationRgb).valid
-        ) {
-            throw new Error('Invalid calibration white reference');
-        }
-    }
-
-    const whiteReference = (parsed.whiteReference as CalibrationRgb | undefined) ?? undefined;
-
-    // Keep only the fields we model; this also drops the legacy `transmission`
-    // key that older exports stored alongside each measurement.
-    const measurements = (parsed.measurements as CalibrationMeasurement[]).map(({ layers, rgb }) => ({
-        layers,
-        rgb,
-    }));
-
-    return {
-        ...(parsed as CalibrationResult),
-        whiteReference,
-        measurements,
-    };
-}
diff --git a/src/lib/colorDifference.ts b/src/lib/colorDifference.ts
new file mode 100644
index 0000000..af31fc7
--- /dev/null
+++ b/src/lib/colorDifference.ts
@@ -0,0 +1,121 @@
+/**
+ * Standalone perceptual color difference (CIEDE2000) on sRGB triplets.
+ *
+ * This is a leaf module that depends only on Math. Calibration math needs ΔE00
+ * but cannot import it from `autoPaint.ts` — `autoPaint` already imports from
+ * `calibration`, so the reverse would be a cycle. Keeping the implementation
+ * here lets the optical/calibration code share one perceptual metric without
+ * pulling in the heavy auto-paint module.
+ *
+ * NOTE: `autoPaint.ts` and `nextBestColor.ts` still carry their own rgbToLab /
+ * CIEDE2000 copies. Consolidating all of them onto this leaf is a worthwhile
+ * follow-up cleanup, intentionally left out of the calibration redesign to keep
+ * the optimizer hot path untouched.
+ */
+
+export type Lab = { L: number; a: number; b: number };
+export type Rgb = [number, number, number];
+
+/** Convert an sRGB triplet (0-255) to CIE Lab (D65). */
+export function rgbToLab([r, g, b]: Rgb): Lab {
+    let rl = r / 255;
+    let gl = g / 255;
+    let bl = b / 255;
+
+    rl = rl > 0.04045 ? Math.pow((rl + 0.055) / 1.055, 2.4) : rl / 12.92;
+    gl = gl > 0.04045 ? Math.pow((gl + 0.055) / 1.055, 2.4) : gl / 12.92;
+    bl = bl > 0.04045 ? Math.pow((bl + 0.055) / 1.055, 2.4) : bl / 12.92;
+
+    rl *= 100;
+    gl *= 100;
+    bl *= 100;
+
+    const x = rl * 0.4124564 + gl * 0.3575761 + bl * 0.1804375;
+    const y = rl * 0.2126729 + gl * 0.7151522 + bl * 0.072175;
+    const z = rl * 0.0193339 + gl * 0.119192 + bl * 0.9503041;
+
+    const refX = 95.047;
+    const refY = 100.0;
+    const refZ = 108.883;
+
+    let xr = x / refX;
+    let yr = y / refY;
+    let zr = z / refZ;
+
+    const epsilon = 0.008856;
+    const kappa = 903.3;
+
+    xr = xr > epsilon ? Math.cbrt(xr) : (kappa * xr + 16) / 116;
+    yr = yr > epsilon ? Math.cbrt(yr) : (kappa * yr + 16) / 116;
+    zr = zr > epsilon ? Math.cbrt(zr) : (kappa * zr + 16) / 116;
+
+    return {
+        L: 116 * yr - 16,
+        a: 500 * (xr - yr),
+        b: 200 * (yr - zr),
+    };
+}
+
+/** CIEDE2000 color difference between two Lab values. */
+export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
+    const chroma1 = Math.hypot(lab1.a, lab1.b);
+    const chroma2 = Math.hypot(lab2.a, lab2.b);
+    const averageChroma = (chroma1 + chroma2) / 2;
+    const g = 0.5 * (1 - Math.sqrt(averageChroma ** 7 / (averageChroma ** 7 + 25 ** 7)));
+    const a1 = (1 + g) * lab1.a;
+    const a2 = (1 + g) * lab2.a;
+    const adjustedChroma1 = Math.hypot(a1, lab1.b);
+    const adjustedChroma2 = Math.hypot(a2, lab2.b);
+    const hue = (a: number, b: number) => ((Math.atan2(b, a) * 180) / Math.PI + 360) % 360;
+    const hue1 = hue(a1, lab1.b);
+    const hue2 = hue(a2, lab2.b);
+    const deltaL = lab2.L - lab1.L;
+    const deltaChroma = adjustedChroma2 - adjustedChroma1;
+    const hueDifference =
+        adjustedChroma1 * adjustedChroma2 === 0
+            ? 0
+            : Math.abs(hue2 - hue1) <= 180
+              ? hue2 - hue1
+              : hue2 <= hue1
+                ? hue2 - hue1 + 360
+                : hue2 - hue1 - 360;
+    const deltaHue =
+        2 *
+        Math.sqrt(adjustedChroma1 * adjustedChroma2) *
+        Math.sin(((hueDifference / 2) * Math.PI) / 180);
+    const meanL = (lab1.L + lab2.L) / 2;
+    const meanChroma = (adjustedChroma1 + adjustedChroma2) / 2;
+    const meanHue =
+        adjustedChroma1 * adjustedChroma2 === 0
+            ? hue1 + hue2
+            : Math.abs(hue1 - hue2) <= 180
+              ? (hue1 + hue2) / 2
+              : hue1 + hue2 < 360
+                ? (hue1 + hue2 + 360) / 2
+                : (hue1 + hue2 - 360) / 2;
+    const hueWeight =
+        1 -
+        0.17 * Math.cos(((meanHue - 30) * Math.PI) / 180) +
+        0.24 * Math.cos((2 * meanHue * Math.PI) / 180) +
+        0.32 * Math.cos(((3 * meanHue + 6) * Math.PI) / 180) -
+        0.2 * Math.cos(((4 * meanHue - 63) * Math.PI) / 180);
+    const lightnessScale = 1 + (0.015 * (meanL - 50) ** 2) / Math.sqrt(20 + (meanL - 50) ** 2);
+    const chromaScale = 1 + 0.045 * meanChroma;
+    const hueScale = 1 + 0.015 * meanChroma * hueWeight;
+    const rotation =
+        -2 *
+        Math.sqrt(meanChroma ** 7 / (meanChroma ** 7 + 25 ** 7)) *
+        Math.sin(((60 * Math.exp(-(((meanHue - 275) / 25) ** 2))) * Math.PI) / 180);
+
+    return Math.sqrt(
+        (deltaL / lightnessScale) ** 2 +
+            (deltaChroma / chromaScale) ** 2 +
+            (deltaHue / hueScale) ** 2 +
+            rotation * (deltaChroma / chromaScale) * (deltaHue / hueScale)
+    );
+}
+
+/** CIEDE2000 color difference between two sRGB triplets (0-255). */
+export function deltaE2000(a: Rgb, b: Rgb): number {
+    return deltaE2000Lab(rgbToLab(a), rgbToLab(b));
+}
diff --git a/src/lib/generateCalibrationPatchesStl.ts b/src/lib/generateCalibrationPatchesStl.ts
deleted file mode 100644
index 3455a66..0000000
--- a/src/lib/generateCalibrationPatchesStl.ts
+++ /dev/null
@@ -1,93 +0,0 @@
-/**
- * Generates a binary STL blob containing a row of flat square test patches,
- * one per layer count. Each patch is 20×20mm with height = layerCount × layerHeight.
- * Patches are arranged along the X axis with 5mm gaps.
- *
- * No Three.js dependency — writes binary STL directly.
- */
-
-const PATCH_SIZE = 20; // mm
-
-/** Write a float32 little-endian at byte offset */
-function setF32(view: DataView, offset: number, value: number) {
-    view.setFloat32(offset, value, true);
-}
-
-/** Write one STL triangle (50 bytes) */
-function writeTriangle(
-    view: DataView,
-    offset: number,
-    nx: number, ny: number, nz: number,
-    ax: number, ay: number, az: number,
-    bx: number, by: number, bz: number,
-    cx: number, cy: number, cz: number,
-) {
-    setF32(view, offset,      nx); setF32(view, offset + 4,  ny); setF32(view, offset + 8,  nz);
-    setF32(view, offset + 12, ax); setF32(view, offset + 16, ay); setF32(view, offset + 20, az);
-    setF32(view, offset + 24, bx); setF32(view, offset + 28, by); setF32(view, offset + 32, bz);
-    setF32(view, offset + 36, cx); setF32(view, offset + 40, cy); setF32(view, offset + 44, cz);
-    view.setUint16(offset + 48, 0, true);
-}
-
-/**
- * Write all 12 triangles for a box.
- * Corner at (x0, 0, z0), size (w, d, h). Z is the build direction.
- */
-function writeBox(view: DataView, offset: number, x0: number, w: number, h: number, d: number, z0 = 0): number {
-    const x1 = x0 + w, y1 = d, z1 = z0 + h;
-
-    // Bottom (Z=z0, normal -Z)
-    offset = writeFace(view, offset,  0,  0, -1,   x0,0,z0,  x1,y1,z0, x1,0,z0);
-    offset = writeFace(view, offset,  0,  0, -1,   x0,0,z0,  x0,y1,z0, x1,y1,z0);
-    // Top (Z=z1, normal +Z)
-    offset = writeFace(view, offset,  0,  0,  1,   x0,0,z1,  x1,0,z1,  x1,y1,z1);
-    offset = writeFace(view, offset,  0,  0,  1,   x0,0,z1,  x1,y1,z1, x0,y1,z1);
-    // Front (Y=0, normal -Y)
-    offset = writeFace(view, offset,  0, -1,  0,   x0,0,z0,  x1,0,z0,  x1,0,z1);
-    offset = writeFace(view, offset,  0, -1,  0,   x0,0,z0,  x1,0,z1,  x0,0,z1);
-    // Back (Y=d, normal +Y)
-    offset = writeFace(view, offset,  0,  1,  0,   x0,y1,z0, x1,y1,z1, x1,y1,z0);
-    offset = writeFace(view, offset,  0,  1,  0,   x0,y1,z0, x0,y1,z1, x1,y1,z1);
-    // Left (X=x0, normal -X)
-    offset = writeFace(view, offset, -1,  0,  0,   x0,0,z0,  x0,0,z1,  x0,y1,z1);
-    offset = writeFace(view, offset, -1,  0,  0,   x0,0,z0,  x0,y1,z1, x0,y1,z0);
-    // Right (X=x1, normal +X)
-    offset = writeFace(view, offset,  1,  0,  0,   x1,0,z0,  x1,y1,z0, x1,y1,z1);
-    offset = writeFace(view, offset,  1,  0,  0,   x1,0,z0,  x1,y1,z1, x1,0,z1);
-
-    return offset;
-}
-
-function writeFace(
-    view: DataView, offset: number,
-    nx: number, ny: number, nz: number,
-    ax: number, ay: number, az: number,
-    bx: number, by: number, bz: number,
-    cx: number, cy: number, cz: number,
-): number {
-    writeTriangle(view, offset, nx, ny, nz, ax, ay, az, bx, by, bz, cx, cy, cz);
-    return offset + 50;
-}
-
-export function generateCalibrationPatchesStl(
-    layerCounts: number[],
-    layerHeight: number,
-): Blob {
-    const TRIS_PER_BOX = 12;
-    const totalTris = layerCounts.length * TRIS_PER_BOX;
-    const buffer = new ArrayBuffer(80 + 4 + totalTris * 50);
-    const view = new DataView(buffer);
-
-    const header = 'Kromacut Calibration Patches';
-    for (let i = 0; i < header.length && i < 80; i++) view.setUint8(i, header.charCodeAt(i));
-    view.setUint32(80, totalTris, true);
-
-    let offset = 84;
-    layerCounts.forEach((count, i) => {
-        const x0 = i * PATCH_SIZE;
-        const patchHeight = count * layerHeight;
-        offset = writeBox(view, offset, x0, PATCH_SIZE, patchHeight, PATCH_SIZE);
-    });
-
-    return new Blob([buffer], { type: 'model/stl' });
-}
diff --git a/src/lib/generateCalibrationPrint.ts b/src/lib/generateCalibrationPrint.ts
new file mode 100644
index 0000000..6a87a0c
--- /dev/null
+++ b/src/lib/generateCalibrationPrint.ts
@@ -0,0 +1,615 @@
+/**
+ * Frontlit calibration print generator.
+ *
+ * Each filament gets a tile: a base, a wedge of 1..N filament layers across the
+ * base, and a continuous opaque reference rail along the edge. The user finds the
+ * first wedge patch that looks identical to the rail and reports that layer count
+ * (see calibration.ts -> computeFrontlitCalibration). A foot marks the 1-layer end
+ * so orientation is unambiguous. The base color is chosen per filament (defaults
+ * to the darkest filament; dark filaments use a lighter base for contrast).
+ *
+ * Two output formats:
+ *  - STL: one tile, single solid. The base/wedge split is by height, so a single
+ *    filament change (base -> color, above the base) prints it on any machine.
+ *  - 3MF: one or more tiles, each as a base object + a color object, with parts
+ *    assigned to real profile-filament slots (no invented base), for AMS printers.
+ *
+ * No Three.js dependency.
+ */
+
+import JSZip from 'jszip';
+import { normalizeHexColor } from './colorUtils';
+import { MINIMAL_PROJECT_SETTINGS, KROMACUT_CONFIG } from './slicerDefaults';
+
+export interface CalibrationTile {
+    filamentId: string;
+    /** Filament display color (hex). */
+    color: string;
+    /** Profile filament id used as this wedge's base. */
+    baseFilamentId: string;
+    /** Base filament display color (hex), for fallback. */
+    baseColor: string;
+    /** Human label for instructions / file names. */
+    name: string;
+}
+
+/** Ordered profile filament, so 3MF slots line up with the user's AMS/machine. */
+export interface CalibrationProfileFilament {
+    id: string;
+    color: string;
+    name: string;
+}
+
+export interface CalibrationPrintOptions {
+    layerHeight: number;
+    firstLayerHeight: number;
+    /** Wedge runs 1..maxLayers. */
+    maxLayers: number;
+    /** Black base thickness, in layers. Just enough to be opaque + provide a base. */
+    baseLayers: number;
+    /** Patch footprint (mm). */
+    patchSize: number;
+    /** Gap between patches (mm). */
+    gap: number;
+}
+
+export const DEFAULT_CALIBRATION_PRINT_OPTIONS: CalibrationPrintOptions = {
+    layerHeight: 0.08,
+    firstLayerHeight: 0.2,
+    maxLayers: 12,
+    baseLayers: 5,
+    patchSize: 10,
+    gap: 0.8,
+};
+
+/** Which of the four vertical corners are rounded. Omitted corners default to rounded. */
+type CornerRounding = { bl?: boolean; br?: boolean; tr?: boolean; tl?: boolean };
+
+interface Box {
+    x0: number;
+    y0: number;
+    z0: number;
+    w: number;
+    d: number;
+    h: number;
+    round?: CornerRounding;
+}
+
+interface TileGeometry {
+    baseBoxes: Box[];
+    colorBoxes: Box[];
+}
+
+/**
+ * Thickness of the black base in mm. The slicer applies its own first-layer
+ * height when printing, so this is just `baseLayers` worth of regular layers —
+ * enough to be opaque black under the wedge, no thicker.
+ */
+function baseHeight(options: CalibrationPrintOptions): number {
+    return options.baseLayers * options.layerHeight;
+}
+
+/** Width of the opaque reference rail along the wedge edge (mm). */
+const REFERENCE_RAIL_WIDTH = 2;
+/** Layers the reference rail adds beyond the tallest patch so it reads as opaque. */
+const REFERENCE_MARGIN_LAYERS = 4;
+
+/**
+ * Build the box list for one tile at the given X origin. The color wedge sits on
+ * top of the black base, so every color layer is a regular layer. A continuous
+ * opaque reference rail runs along the back edge and the patches butt directly
+ * against it: each printed layer is then a single connected comb (rail spine +
+ * the patches reaching that height) instead of many separate islands, which cuts
+ * travel — and it puts each patch flush against the rail for easy comparison.
+ */
+function buildTileGeometry(options: CalibrationPrintOptions, originX = 0): TileGeometry {
+    const { layerHeight, maxLayers, patchSize, gap } = options;
+    const railLayers = maxLayers + REFERENCE_MARGIN_LAYERS;
+    const baseH = baseHeight(options);
+    const pad = gap;
+    const columnWidth = patchSize + gap;
+    const wedgeSpan = maxLayers * columnWidth - gap; // first patch left to last patch right
+    const railGap = 0; // patches touch the rail so each layer prints as one comb
+    const baseWidth = wedgeSpan + 2 * pad;
+    const baseDepth = patchSize + railGap + REFERENCE_RAIL_WIDTH + 2 * pad;
+
+    const baseBoxes: Box[] = [
+        { x0: originX, y0: 0, z0: 0, w: baseWidth, d: baseDepth, h: baseH },
+    ];
+
+    // Orientation foot: extends the front-left of the base forward to mark the
+    // 1-layer end. It overlaps into the base (one fused solid, not a separate
+    // bump) and only its front corners are rounded, so it reads as part of the
+    // base outline and prints more cleanly.
+    const tabDepth = pad * 1.5;
+    baseBoxes.push({
+        x0: originX,
+        y0: -tabDepth,
+        z0: 0,
+        // Reach to the middle of the first inter-patch gap.
+        w: pad + patchSize + gap / 2,
+        d: tabDepth + CORNER_RADIUS + 0.5, // overlap past the base's rounded corner
+        h: baseH,
+        round: { tr: false, tl: false }, // square the base-side corners
+    });
+
+    const colorBoxes: Box[] = [];
+    for (let layers = 1; layers <= maxLayers; layers++) {
+        colorBoxes.push({
+            x0: originX + pad + (layers - 1) * columnWidth,
+            y0: pad,
+            z0: baseH,
+            w: patchSize,
+            d: patchSize,
+            h: layers * layerHeight,
+            // Square the back corners (toward the rail) for a flush junction.
+            round: { tr: false, tl: false },
+        });
+    }
+    // Opaque reference rail along the back edge, spanning the full wedge length.
+    colorBoxes.push({
+        x0: originX + pad,
+        y0: pad + patchSize + railGap,
+        z0: baseH,
+        w: wedgeSpan,
+        d: REFERENCE_RAIL_WIDTH,
+        h: railLayers * layerHeight,
+        // Square the front corners (toward the patches) to meet them cleanly.
+        round: { bl: false, br: false },
+    });
+
+    return { baseBoxes, colorBoxes };
+}
+
+// ============================================================================
+// Binary STL
+// ============================================================================
+
+function setF32(view: DataView, offset: number, value: number) {
+    view.setFloat32(offset, value, true);
+}
+
+function writeTriangle(
+    view: DataView,
+    offset: number,
+    n: [number, number, number],
+    a: [number, number, number],
+    b: [number, number, number],
+    c: [number, number, number]
+): number {
+    setF32(view, offset, n[0]);
+    setF32(view, offset + 4, n[1]);
+    setF32(view, offset + 8, n[2]);
+    setF32(view, offset + 12, a[0]);
+    setF32(view, offset + 16, a[1]);
+    setF32(view, offset + 20, a[2]);
+    setF32(view, offset + 24, b[0]);
+    setF32(view, offset + 28, b[1]);
+    setF32(view, offset + 32, b[2]);
+    setF32(view, offset + 36, c[0]);
+    setF32(view, offset + 40, c[1]);
+    setF32(view, offset + 44, c[2]);
+    view.setUint16(offset + 48, 0, true);
+    return offset + 50;
+}
+
+const CORNER_RADIUS = 1.2; // mm — rounding applied to the vertical edges of every box.
+const CORNER_SEGMENTS = 5;
+
+/** CCW (viewed from +Z) outline of a rounded rectangle; sharp corners emit a single point. */
+function roundedRectOutline(
+    x0: number,
+    y0: number,
+    x1: number,
+    y1: number,
+    r: number,
+    segments: number,
+    round: Required<CornerRounding>
+): Array<[number, number]> {
+    const pts: Array<[number, number]> = [];
+    const corner = (
+        cx: number,
+        cy: number,
+        startDeg: number,
+        endDeg: number,
+        isRound: boolean,
+        sharpX: number,
+        sharpY: number
+    ) => {
+        if (!isRound) {
+            pts.push([sharpX, sharpY]);
+            return;
+        }
+        for (let i = 0; i <= segments; i++) {
+            const a = ((startDeg + (endDeg - startDeg) * (i / segments)) * Math.PI) / 180;
+            pts.push([cx + r * Math.cos(a), cy + r * Math.sin(a)]);
+        }
+    };
+    corner(x1 - r, y0 + r, 270, 360, round.br, x1, y0); // bottom-right
+    corner(x1 - r, y1 - r, 0, 90, round.tr, x1, y1); // top-right
+    corner(x0 + r, y1 - r, 90, 180, round.tl, x0, y1); // top-left
+    corner(x0 + r, y0 + r, 180, 270, round.bl, x0, y0); // bottom-left
+    return pts;
+}
+
+function appendSharpBox(mesh: IndexedMesh, box: Box) {
+    const base = mesh.vertices.length / 3;
+    const { x0, y0, z0, w, d, h } = box;
+    const x1 = x0 + w;
+    const y1 = y0 + d;
+    const z1 = z0 + h;
+    const corners = [
+        [x0, y0, z0], [x1, y0, z0], [x1, y1, z0], [x0, y1, z0],
+        [x0, y0, z1], [x1, y0, z1], [x1, y1, z1], [x0, y1, z1],
+    ];
+    for (const c of corners) mesh.vertices.push(c[0], c[1], c[2]);
+    const tris = [
+        [0, 2, 1], [0, 3, 2], [4, 5, 6], [4, 6, 7],
+        [0, 1, 5], [0, 5, 4], [2, 3, 7], [2, 7, 6],
+        [0, 7, 3], [0, 4, 7], [1, 2, 6], [1, 6, 5],
+    ];
+    for (const [a, b, c] of tris) mesh.triangles.push(base + a, base + b, base + c);
+}
+
+/** Append a watertight prism with rounded vertical edges (or a sharp box if too thin). */
+function appendPrism(mesh: IndexedMesh, box: Box) {
+    const { x0, y0, z0, w, d, h, round } = box;
+    const r = Math.min(CORNER_RADIUS, w / 2 - 0.01, d / 2 - 0.01);
+    if (r < 0.1) {
+        appendSharpBox(mesh, box);
+        return;
+    }
+
+    const x1 = x0 + w;
+    const y1 = y0 + d;
+    const z1 = z0 + h;
+    const rounding: Required<CornerRounding> = {
+        bl: round?.bl ?? true,
+        br: round?.br ?? true,
+        tr: round?.tr ?? true,
+        tl: round?.tl ?? true,
+    };
+    const outline = roundedRectOutline(x0, y0, x1, y1, r, CORNER_SEGMENTS, rounding);
+    const n = outline.length;
+    const base = mesh.vertices.length / 3;
+
+    for (const [px, py] of outline) mesh.vertices.push(px, py, z1); // top ring
+    for (const [px, py] of outline) mesh.vertices.push(px, py, z0); // bottom ring
+    let cx = 0;
+    let cy = 0;
+    for (const [px, py] of outline) {
+        cx += px;
+        cy += py;
+    }
+    cx /= n;
+    cy /= n;
+    const topCenter = base + 2 * n;
+    const bottomCenter = base + 2 * n + 1;
+    mesh.vertices.push(cx, cy, z1);
+    mesh.vertices.push(cx, cy, z0);
+
+    for (let i = 0; i < n; i++) {
+        const j = (i + 1) % n;
+        const top = base + i;
+        const topNext = base + j;
+        const bottom = base + n + i;
+        const bottomNext = base + n + j;
+        mesh.triangles.push(topCenter, top, topNext); // top cap (+Z)
+        mesh.triangles.push(bottomCenter, bottomNext, bottom); // bottom cap (-Z)
+        mesh.triangles.push(top, bottom, topNext); // wall (outward)
+        mesh.triangles.push(topNext, bottom, bottomNext);
+    }
+}
+
+function faceNormal(
+    a: [number, number, number],
+    b: [number, number, number],
+    c: [number, number, number]
+): [number, number, number] {
+    const ux = b[0] - a[0];
+    const uy = b[1] - a[1];
+    const uz = b[2] - a[2];
+    const vx = c[0] - a[0];
+    const vy = c[1] - a[1];
+    const vz = c[2] - a[2];
+    const nx = uy * vz - uz * vy;
+    const ny = uz * vx - ux * vz;
+    const nz = ux * vy - uy * vx;
+    const len = Math.hypot(nx, ny, nz) || 1;
+    return [nx / len, ny / len, nz / len];
+}
+
+/** Single-filament calibration tile as a binary STL solid. */
+export function generateCalibrationStl(options: CalibrationPrintOptions): Blob {
+    const { baseBoxes, colorBoxes } = buildTileGeometry(options);
+    const mesh: IndexedMesh = { vertices: [], triangles: [] };
+    for (const box of [...baseBoxes, ...colorBoxes]) appendPrism(mesh, box);
+
+    const triCount = mesh.triangles.length / 3;
+    const buffer = new ArrayBuffer(80 + 4 + triCount * 50);
+    const view = new DataView(buffer);
+    const header = 'Kromacut Frontlit Calibration';
+    for (let i = 0; i < header.length && i < 80; i++) view.setUint8(i, header.charCodeAt(i));
+    view.setUint32(80, triCount, true);
+
+    let offset = 84;
+    for (let t = 0; t < mesh.triangles.length; t += 3) {
+        const ia = mesh.triangles[t] * 3;
+        const ib = mesh.triangles[t + 1] * 3;
+        const ic = mesh.triangles[t + 2] * 3;
+        const a: [number, number, number] = [
+            mesh.vertices[ia],
+            mesh.vertices[ia + 1],
+            mesh.vertices[ia + 2],
+        ];
+        const b: [number, number, number] = [
+            mesh.vertices[ib],
+            mesh.vertices[ib + 1],
+            mesh.vertices[ib + 2],
+        ];
+        const c: [number, number, number] = [
+            mesh.vertices[ic],
+            mesh.vertices[ic + 1],
+            mesh.vertices[ic + 2],
+        ];
+        offset = writeTriangle(view, offset, faceNormal(a, b, c), a, b, c);
+    }
+
+    return new Blob([buffer], { type: 'model/stl' });
+}
+
+// ============================================================================
+// 3MF (multi-material)
+// ============================================================================
+
+interface IndexedMesh {
+    vertices: number[]; // flat x,y,z
+    triangles: number[]; // flat v1,v2,v3
+}
+
+function meshXml(mesh: IndexedMesh): string {
+    const verts: string[] = ['<vertices>'];
+    for (let i = 0; i < mesh.vertices.length; i += 3) {
+        verts.push(
+            `<vertex x="${mesh.vertices[i].toFixed(4)}" y="${mesh.vertices[i + 1].toFixed(4)}" z="${mesh.vertices[i + 2].toFixed(4)}"/>`
+        );
+    }
+    verts.push('</vertices>');
+    const tris: string[] = ['<triangles>'];
+    for (let i = 0; i < mesh.triangles.length; i += 3) {
+        tris.push(
+            `<triangle v1="${mesh.triangles[i]}" v2="${mesh.triangles[i + 1]}" v3="${mesh.triangles[i + 2]}"/>`
+        );
+    }
+    tris.push('</triangles>');
+    return `<mesh>${verts.join('')}${tris.join('')}</mesh>`;
+}
+
+function generateUUID(): string {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+
+/** Translate every mesh in XY so the combined layout is centered on the origin. */
+function centerMeshesXY(meshes: IndexedMesh[]) {
+    let minX = Infinity;
+    let maxX = -Infinity;
+    let minY = Infinity;
+    let maxY = -Infinity;
+    for (const mesh of meshes) {
+        for (let i = 0; i < mesh.vertices.length; i += 3) {
+            const x = mesh.vertices[i];
+            const y = mesh.vertices[i + 1];
+            if (x < minX) minX = x;
+            if (x > maxX) maxX = x;
+            if (y < minY) minY = y;
+            if (y > maxY) maxY = y;
+        }
+    }
+    if (!Number.isFinite(minX)) return;
+    const cx = (minX + maxX) / 2;
+    const cy = (minY + maxY) / 2;
+    for (const mesh of meshes) {
+        for (let i = 0; i < mesh.vertices.length; i += 3) {
+            mesh.vertices[i] -= cx;
+            mesh.vertices[i + 1] -= cy;
+        }
+    }
+}
+
+/**
+ * Combined multi-material 3MF for one or more tiles laid out along X.
+ *
+ * Each filament is its own independently-arrangeable object, with its black base
+ * and colored wedge as two grouped parts inside it. Keeping base + color as parts
+ * of one object (rather than separate objects) avoids the "objects at multiple
+ * heights" merge prompt, while keeping the tiles as separate objects lets the
+ * slicer auto-arrange them and print by color. An embedded Bambu/Orca project
+ * (`model_settings.config` + `project_settings.config`) assigns the base to
+ * extruder 1 and each filament to its own extruder with the matching colour — that
+ * is what colours the parts rather than leaving them all white.
+ */
+export async function generateCalibration3mf(
+    tiles: CalibrationTile[],
+    options: CalibrationPrintOptions,
+    profileFilaments: CalibrationProfileFilament[]
+): Promise<Blob> {
+    const baseMatId = 1;
+
+    // Slots follow the profile order so they line up with the user's AMS/machine
+    // (slot 1 = profile filament 1, etc.) — this keeps the base off slot 1, which
+    // slicers reserve for the machine's active filament, and uses real filaments
+    // rather than an invented phantom base.
+    const slotForId = new Map<string, number>(); // filament id -> 1-based slot
+    const slotColors: string[] = [];
+    const slotNames: string[] = [];
+    const ensureSlot = (id: string, hex: string, name: string): number => {
+        let slot = slotForId.get(id);
+        if (slot === undefined) {
+            slot = slotColors.length + 1; // 1-based
+            slotForId.set(id, slot);
+            slotColors.push(normalizeHexColor(hex, '#808080'));
+            slotNames.push(name);
+        }
+        return slot;
+    };
+    for (const f of profileFilaments) ensureSlot(f.id, f.color, f.name);
+    // Defensive: register any tile filament missing from the profile list.
+    for (const tile of tiles) {
+        ensureSlot(tile.baseFilamentId, tile.baseColor, 'Base');
+        ensureSlot(tile.filamentId, tile.color, tile.name);
+    }
+
+    const baseMaterialsXml = slotColors
+        .map((hex, i) => `<base name="${escapeXml(slotNames[i])}" displaycolor="${to3mfColor(hex)}"/>`)
+        .join('');
+
+    // Initial Y spacing so the tile objects don't overlap before auto-arrange.
+    const rowPitch = options.patchSize + options.gap * 3.5 + 4;
+
+    let nextId = 2; // 1 is the basematerials group
+    const objects: string[] = [];
+    const buildItems: string[] = [];
+    const settingObjects: string[] = [];
+    const instances: string[] = [];
+
+    tiles.forEach((tile, index) => {
+        const { baseBoxes, colorBoxes } = buildTileGeometry(options, 0);
+        const baseMesh: IndexedMesh = { vertices: [], triangles: [] };
+        for (const box of baseBoxes) appendPrism(baseMesh, box);
+        const colorMesh: IndexedMesh = { vertices: [], triangles: [] };
+        for (const box of colorBoxes) appendPrism(colorMesh, box);
+        // Center each tile on its own origin so the build-item transform places it.
+        centerMeshesXY([baseMesh, colorMesh]);
+
+        const baseSlot = ensureSlot(tile.baseFilamentId, tile.baseColor, 'Base');
+        const colorSlot = ensureSlot(tile.filamentId, tile.color, tile.name);
+        const baseObjId = nextId++;
+        const colorObjId = nextId++;
+        const tileObjId = nextId++;
+
+        objects.push(
+            `<object id="${baseObjId}" p:UUID="${generateUUID()}" type="model" pid="${baseMatId}" pindex="${baseSlot - 1}" name="Base">${meshXml(baseMesh)}</object>`
+        );
+        objects.push(
+            `<object id="${colorObjId}" p:UUID="${generateUUID()}" type="model" pid="${baseMatId}" pindex="${colorSlot - 1}" name="${escapeXml(tile.name)}">${meshXml(colorMesh)}</object>`
+        );
+        // Each filament is its own object; its base + color are grouped as parts so
+        // there is no "objects at multiple heights" merge prompt, while the tiles
+        // stay separate objects the slicer can auto-arrange and sequence.
+        objects.push(
+            `<object id="${tileObjId}" p:UUID="${generateUUID()}" type="model" name="${escapeXml(tile.name)}"><components>` +
+                `<component objectid="${baseObjId}" p:UUID="${generateUUID()}"/>` +
+                `<component objectid="${colorObjId}" p:UUID="${generateUUID()}"/>` +
+                `</components></object>`
+        );
+
+        const ty = (index * rowPitch).toFixed(3);
+        buildItems.push(
+            `<item objectid="${tileObjId}" p:UUID="${generateUUID()}" transform="1 0 0 0 1 0 0 0 1 0 ${ty} 0"/>`
+        );
+
+        settingObjects.push(
+            ` <object id="${tileObjId}">\n` +
+                `  <metadata key="name" value="${escapeXml(tile.name)}"/>\n` +
+                `  <metadata key="extruder" value="${colorSlot}"/>\n` +
+                `  <part id="${baseObjId}" subtype="normal_part">\n` +
+                `   <metadata key="name" value="Base"/>\n` +
+                `   <metadata key="extruder" value="${baseSlot}"/>\n` +
+                `  </part>\n` +
+                `  <part id="${colorObjId}" subtype="normal_part">\n` +
+                `   <metadata key="name" value="${escapeXml(tile.name)}"/>\n` +
+                `   <metadata key="extruder" value="${colorSlot}"/>\n` +
+                `  </part>\n` +
+                ` </object>\n`
+        );
+        instances.push(
+            `  <model_instance>\n` +
+                `   <metadata key="object_id" value="${tileObjId}"/>\n` +
+                `   <metadata key="instance_id" value="0"/>\n` +
+                `  </model_instance>\n`
+        );
+    });
+
+    const model =
+        `<?xml version="1.0" encoding="UTF-8"?>\n` +
+        `<model unit="millimeter" xml:lang="en-US" xmlns="http://schemas.microsoft.com/3dmanufacturing/core/2015/02" xmlns:slic3rpe="http://schemas.slic3r.org/3mf/2017/06" xmlns:BambuStudio="http://schemas.bambulab.com/package/2021" xmlns:p="http://schemas.microsoft.com/3dmanufacturing/production/2015/06" requiredextensions="p">` +
+        `<metadata name="BambuStudio:3mfVersion">1</metadata>` +
+        `<resources>` +
+        `<basematerials id="${baseMatId}">${baseMaterialsXml}</basematerials>` +
+        objects.join('') +
+        `</resources>` +
+        `<build p:UUID="${generateUUID()}">${buildItems.join('')}</build>` +
+        `</model>`;
+
+    // Per-object/part extruder assignment (Bambu/Orca/Creality read this for
+    // colors). No <assemble> block: the tiles stay independent, arrangeable objects.
+    const modelSettings =
+        `<?xml version="1.0" encoding="UTF-8"?>\n<config>\n` +
+        settingObjects.join('') +
+        ` <plate>\n` +
+        `  <metadata key="plater_id" value="1"/>\n` +
+        `  <metadata key="plater_name" value=""/>\n` +
+        `  <metadata key="locked" value="false"/>\n` +
+        instances.join('') +
+        ` </plate>\n` +
+        `</config>`;
+
+    // Embedded slicer project: defines the filament list + colours the parts use.
+    const filamentColours = slotColors;
+    const filamentCount = filamentColours.length;
+    const expand = <T,>(value: T, count: number): T[] => Array(count).fill(value);
+    const projectSettings = {
+        ...MINIMAL_PROJECT_SETTINGS,
+        layer_height: options.layerHeight.toString(),
+        initial_layer_print_height: Math.max(options.layerHeight, options.firstLayerHeight).toString(),
+        filament_colour: filamentColours,
+        filament_type: expand('PLA', filamentCount),
+        filament_settings_id: expand('Generic PLA @Kromacut 0.4 nozzle', filamentCount),
+        filament_vendor: expand('Generic', filamentCount),
+    };
+
+    const zip = new JSZip();
+    zip.file(
+        '[Content_Types].xml',
+        `<?xml version="1.0" encoding="UTF-8"?>\n` +
+            `<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">` +
+            `<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>` +
+            `<Default Extension="model" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/>` +
+            `<Default Extension="config" ContentType="application/vnd.ms-package.3dmanufacturing-3dmodel+xml"/>` +
+            `</Types>`
+    );
+    zip.file(
+        '_rels/.rels',
+        `<?xml version="1.0" encoding="UTF-8"?>\n` +
+            `<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">` +
+            `<Relationship Target="/3D/3dmodel.model" Id="rel0" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/>` +
+            `<Relationship Target="/Metadata/model_settings.config" Id="rel1" Type="http://schemas.microsoft.com/3dmanufacturing/2013/01/3dmodel"/>` +
+            `</Relationships>`
+    );
+    zip.file('3D/3dmodel.model', model);
+    zip.file('Metadata/model_settings.config', modelSettings);
+    zip.file('Metadata/project_settings.config', JSON.stringify(projectSettings, null, 4));
+    zip.file('Metadata/kromacut.config', KROMACUT_CONFIG);
+
+    return zip.generateAsync({ type: 'blob', mimeType: 'model/3mf' });
+}
+
+function escapeXml(value: string): string {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+
+function to3mfColor(hex: string): string {
+    const normalized = normalizeHexColor(hex, '#808080');
+    return `${normalized.toUpperCase()}FF`;
+}
diff --git a/src/types/index.ts b/src/types/index.ts
index 71f418c..ce31f97 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -1,5 +1,5 @@
 import type { AutoPaintResult } from '../lib/autoPaint';
-import type { CalibrationResult } from '../lib/calibration';
+import type { FrontlitCalibration } from '../lib/calibration';
 
 export const AUTO_PAINT_REPEAT_LIMITS = [0, 2, 4, 6, 8, 12] as const;
 export type AutoPaintRepeatLimit = (typeof AUTO_PAINT_REPEAT_LIMITS)[number];
@@ -31,7 +31,7 @@ export interface Filament {
     id: string;
     color: string;
     td: number;
-    calibration?: CalibrationResult;
+    calibration?: FrontlitCalibration;
     name?: string;
     brand?: string;
 }
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index e80e449..d4576a7 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -147,11 +147,14 @@ test('transition-thickness cache distinguishes calibrated channel TDs', async ()
         {
             ...baseStack[1],
             calibration: {
-                color: '#ffffff',
-                measurements: [],
+                opacityLayers: 6,
+                layerHeight: 0.1,
+                firstLayerHeight: 0.2,
                 td: [0.5, 1, 2] as [number, number, number],
                 tdSingleValue: 1,
+                jnd: 2,
                 confidence: 1,
+                basis: 'black-frontlit' as const,
                 calibrationDate: '2026-01-01T00:00:00.000Z',
             },
         },
@@ -212,11 +215,14 @@ test('calibrated channel TDs flow through generated auto-paint preview slices',
         {
             ...baseFilaments[1],
             calibration: {
-                color: '#ffffff',
-                measurements: [],
+                opacityLayers: 6,
+                layerHeight: 0.1,
+                firstLayerHeight: 0.2,
                 td: [8, 16, 32] as [number, number, number],
                 tdSingleValue: 16,
+                jnd: 2,
                 confidence: 1,
+                basis: 'black-frontlit' as const,
                 calibrationDate: '2026-01-01T00:00:00.000Z',
             },
         },
diff --git a/tests/calibration.test.ts b/tests/calibration.test.ts
deleted file mode 100644
index 6306e8a..0000000
--- a/tests/calibration.test.ts
+++ /dev/null
@@ -1,101 +0,0 @@
-import assert from 'node:assert/strict';
-import { resolve } from 'node:path';
-import test from 'node:test';
-import { createServer } from 'vite';
-
-type CalibrationModule = typeof import('../src/lib/calibration.ts');
-type AutoPaintModule = typeof import('../src/lib/autoPaint.ts');
-
-let calibrationModule: Promise<CalibrationModule> | null = null;
-let autoPaintModule: Promise<AutoPaintModule> | null = null;
-
-async function loadViteModule<T>(modulePath: string): Promise<T> {
-    const server = await createServer({
-        appType: 'custom',
-        cacheDir: 'dist/.vite-test-cache',
-        configFile: false,
-        logLevel: 'error',
-        optimizeDeps: { noDiscovery: true },
-        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
-        root: process.cwd(),
-        server: { hmr: false, middlewareMode: true },
-    });
-
-    try {
-        return (await server.ssrLoadModule(modulePath)) as T;
-    } finally {
-        await server.close();
-    }
-}
-
-async function loadCalibrationModule(): Promise<CalibrationModule> {
-    calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts');
-    return calibrationModule;
-}
-
-async function loadAutoPaintModule(): Promise<AutoPaintModule> {
-    autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
-    return autoPaintModule;
-}
-
-function assertClose(actual: number, expected: number, tolerance: number, message?: string) {
-    assert.ok(
-        Math.abs(actual - expected) <= tolerance,
-        message ?? `expected ${actual} to be within ${tolerance} of ${expected}`
-    );
-}
-
-test('calibration predictions use Auto-paint’s linear-light transmission model', async () => {
-    const calibration = await loadCalibrationModule();
-    const autoPaint = await loadAutoPaintModule();
-    const halfTransmissionThickness = Math.log10(2);
-    const predicted = calibration.predictTransmission(
-        '#000000',
-        1,
-        halfTransmissionThickness,
-        [1, 1, 1]
-    );
-    const autoPaintBlend = autoPaint.blendColors(
-        { r: 255, g: 255, b: 255 },
-        { r: 0, g: 0, b: 0 },
-        1,
-        halfTransmissionThickness
-    );
-
-    assert.deepEqual(predicted, [188, 188, 188]);
-    assert.deepEqual(predicted, [
-        Math.round(autoPaintBlend.r),
-        Math.round(autoPaintBlend.g),
-        Math.round(autoPaintBlend.b),
-    ]);
-});
-
-test('calibration recovers channel TDs from linear-light patch measurements', async () => {
-    const calibration = await loadCalibrationModule();
-    const layerHeight = 0.1;
-    const filamentColor = '#204080';
-    const whiteReference: [number, number, number] = [230, 240, 255];
-    const knownTd: [number, number, number] = [1.4, 2, 3.2];
-    const measurements = [2, 4, 6, 8, 10].map((layers) => ({
-        layers,
-        rgb: calibration.predictTransmission(
-            filamentColor,
-            layers,
-            layerHeight,
-            knownTd,
-            whiteReference
-        ),
-    }));
-
-    const result = calibration.calculateTDFromMeasurements(
-        measurements,
-        layerHeight,
-        whiteReference,
-        filamentColor
-    );
-
-    for (let channel = 0; channel < knownTd.length; channel++) {
-        assertClose(result.td[channel], knownTd[channel], 0.03);
-    }
-    assert.ok(result.confidence > 0.7);
-});
diff --git a/tests/calibrationPrint.test.ts b/tests/calibrationPrint.test.ts
new file mode 100644
index 0000000..5cbd92f
--- /dev/null
+++ b/tests/calibrationPrint.test.ts
@@ -0,0 +1,111 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+import JSZip from 'jszip';
+
+type GeneratorModule = typeof import('../src/lib/generateCalibrationPrint.ts');
+
+let generatorModule: Promise<GeneratorModule> | null = null;
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+const loadGenerator = () =>
+    (generatorModule ??= loadViteModule<GeneratorModule>('/src/lib/generateCalibrationPrint.ts'));
+
+const baseOptions = {
+    layerHeight: 0.08,
+    firstLayerHeight: 0.2,
+    maxLayers: 10,
+    baseLayers: 5,
+    patchSize: 12,
+    gap: 1.5,
+};
+
+test('generateCalibrationStl writes one box per base/wedge/reference patch', async () => {
+    const { generateCalibrationStl } = await loadGenerator();
+    const blob = generateCalibrationStl(baseOptions);
+    const buffer = await blob.arrayBuffer();
+    const view = new DataView(buffer);
+
+    // Base slab + orientation tab + (maxLayers wedge patches) + 1 rail, each a
+    // rounded prism (some corners squared), so per-box triangle counts vary. Every
+    // prism contributes caps + walls in multiples of 4; check structural integrity.
+    const triangleCount = view.getUint32(80, true);
+    assert.ok(triangleCount > (2 + baseOptions.maxLayers + 1) * 12, 'non-trivial mesh');
+    assert.equal(triangleCount % 4, 0, 'prisms contribute triangles in multiples of 4');
+    assert.equal(buffer.byteLength, 84 + triangleCount * 50);
+});
+
+test('generateCalibration3mf builds slots in profile order and colors the parts', async () => {
+    const { generateCalibration3mf } = await loadGenerator();
+    // Profile order matches the user's machine: white in slot 1, black in slot 2.
+    const profileFilaments = [
+        { id: 'w', color: '#ffffff', name: 'White' },
+        { id: 'k', color: '#000000', name: 'Black' },
+        { id: 'a', color: '#ff0000', name: 'Red' },
+        { id: 'b', color: '#00aa55', name: 'Green' },
+    ];
+    // Calibrate red + green over a black base (white is uncalibrated but still a slot).
+    const tiles = [
+        { filamentId: 'a', color: '#ff0000', baseFilamentId: 'k', baseColor: '#000000', name: 'Red' },
+        { filamentId: 'b', color: '#00aa55', baseFilamentId: 'k', baseColor: '#000000', name: 'Green' },
+    ];
+    const blob = await generateCalibration3mf(tiles, baseOptions, profileFilaments);
+    const zip = await JSZip.loadAsync(await blob.arrayBuffer());
+
+    const model = await zip.file('3D/3dmodel.model')?.async('string');
+    assert.ok(model, 'model XML present');
+    assert.ok(zip.file('[Content_Types].xml'), 'content types present');
+    assert.ok(zip.file('_rels/.rels'), 'relationships present');
+
+    // One material per profile filament (no invented phantom base).
+    const baseCount = (model!.match(/<base /g) ?? []).length;
+    assert.equal(baseCount, profileFilaments.length);
+
+    // Each filament tile = base object + color object + grouping object.
+    const objectCount = (model!.match(/<object /g) ?? []).length;
+    assert.equal(objectCount, tiles.length * 3);
+
+    // One arrangeable build item per filament (so auto-arrange / print-by-color
+    // work), each grouping its base + color as two components.
+    const itemCount = (model!.match(/<item /g) ?? []).length;
+    assert.equal(itemCount, tiles.length);
+    const componentCount = (model!.match(/<component /g) ?? []).length;
+    assert.equal(componentCount, tiles.length * 2);
+
+    // Embedded slicer project provides the colors (extruder assignment + filament
+    // list), which is what actually colors the parts in Bambu/Orca/Creality.
+    const modelSettings = await zip.file('Metadata/model_settings.config')?.async('string');
+    assert.ok(modelSettings, 'model_settings.config present');
+    const partCount = (modelSettings!.match(/<part /g) ?? []).length;
+    assert.equal(partCount, tiles.length * 2); // base + color part per filament
+    assert.ok(modelSettings!.includes('key="extruder" value="2"'));
+    // No assemble block — tiles must remain independent, arrangeable objects.
+    assert.ok(!modelSettings!.includes('<assemble'));
+
+    const projectRaw = await zip.file('Metadata/project_settings.config')?.async('string');
+    assert.ok(projectRaw, 'project_settings.config present');
+    const project = JSON.parse(projectRaw!);
+    // Slots follow profile order, so slot 1 is white (not the base) — keeping the
+    // black base off the machine's reserved slot 1.
+    assert.deepEqual(project.filament_colour, ['#FFFFFF', '#000000', '#FF0000', '#00AA55']);
+    assert.equal(project.filament_colour[0], '#FFFFFF');
+    assert.equal(project.filament_type.length, profileFilaments.length);
+});
diff --git a/tests/frontlitCalibration.test.ts b/tests/frontlitCalibration.test.ts
new file mode 100644
index 0000000..07494bd
--- /dev/null
+++ b/tests/frontlitCalibration.test.ts
@@ -0,0 +1,217 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+type CalibrationModule = typeof import('../src/lib/calibration.ts');
+type ColorDifferenceModule = typeof import('../src/lib/colorDifference.ts');
+type ColorSpaceModule = typeof import('../src/lib/colorSpace.ts');
+
+let calibrationModule: Promise<CalibrationModule> | null = null;
+let colorDifferenceModule: Promise<ColorDifferenceModule> | null = null;
+let colorSpaceModule: Promise<ColorSpaceModule> | null = null;
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+const loadCalibration = () =>
+    (calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts'));
+const loadColorDifference = () =>
+    (colorDifferenceModule ??= loadViteModule<ColorDifferenceModule>('/src/lib/colorDifference.ts'));
+const loadColorSpace = () =>
+    (colorSpaceModule ??= loadViteModule<ColorSpaceModule>('/src/lib/colorSpace.ts'));
+
+function hexToRgb(hex: string): [number, number, number] {
+    const h = hex.replace(/^#/, '');
+    return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16)];
+}
+
+/**
+ * Simulate the physical opacity read for a filament that perfectly follows a
+ * single-TD Beer-Lambert model: the smallest integer layer count whose over-black
+ * blend is within `jnd` of the opaque filament color. Mirrors what a user would
+ * report off the printed wedge.
+ */
+async function simulateOpacityRead(
+    filamentColor: string,
+    tdTrue: number,
+    layerHeight: number,
+    jnd: number,
+    maxLayers = 200,
+    baseColor = '#000000'
+): Promise<number> {
+    const { blendSrgbChannel } = await loadColorSpace();
+    const { deltaE2000 } = await loadColorDifference();
+    const rgb = hexToRgb(filamentColor);
+    const base = hexToRgb(baseColor);
+
+    for (let layers = 1; layers <= maxLayers; layers++) {
+        const t = Math.pow(10, -(layers * layerHeight) / tdTrue);
+        const blended: [number, number, number] = [
+            blendSrgbChannel(base[0], rgb[0], t),
+            blendSrgbChannel(base[1], rgb[1], t),
+            blendSrgbChannel(base[2], rgb[2], t),
+        ];
+        if (deltaE2000(blended, rgb) <= jnd) return layers;
+    }
+    return maxLayers;
+}
+
+test('solveOpacityTransmission tolerates more background for darker (lower-contrast) colors', async () => {
+    const { solveOpacityTransmission, OPACITY_JND } = await loadCalibration();
+
+    const tWhite = solveOpacityTransmission('#ffffff', OPACITY_JND);
+    const tDarkGray = solveOpacityTransmission('#282828', OPACITY_JND);
+
+    assert.ok(tWhite !== undefined && tDarkGray !== undefined);
+    // A bright color reaches the JND with only a sliver of background; a dark,
+    // low-contrast color stays within the JND even with much more black showing.
+    assert.ok(tWhite! < tDarkGray!, `expected T*(white)=${tWhite} < T*(darkgray)=${tDarkGray}`);
+    assert.ok(tWhite! > 0 && tWhite! < 1);
+    assert.ok(tDarkGray! > 0 && tDarkGray! < 1);
+});
+
+test('solveOpacityTransmission returns undefined for colors that cannot beat the black base', async () => {
+    const { solveOpacityTransmission } = await loadCalibration();
+    assert.equal(solveOpacityTransmission('#000000'), undefined);
+    assert.equal(solveOpacityTransmission('#020202'), undefined);
+});
+
+test('computeFrontlitCalibration recovers the true TD from a synthetic read (round-trip)', async () => {
+    const { computeFrontlitCalibration, OPACITY_JND } = await loadCalibration();
+    const layerHeight = 0.04;
+
+    const cases: Array<{ color: string; tdTrue: number }> = [
+        { color: '#ffd400', tdTrue: 0.5 },
+        { color: '#c08040', tdTrue: 0.35 },
+        { color: '#3050c0', tdTrue: 0.28 },
+        { color: '#a0a0a0', tdTrue: 0.45 },
+    ];
+
+    for (const { color, tdTrue } of cases) {
+        const opacityLayers = await simulateOpacityRead(color, tdTrue, layerHeight, OPACITY_JND);
+        const result = computeFrontlitCalibration({
+            filamentColor: color,
+            opacityLayers,
+            layerHeight,
+            firstLayerHeight: 0.2,
+        });
+
+        assert.ok(result.ok, `expected ${color} to calibrate`);
+        if (!result.ok) return;
+
+        const recovered = result.calibration.tdSingleValue;
+        const relError = Math.abs(recovered - tdTrue) / tdTrue;
+        // Integer-layer quantization is the only error source; keep well inside it.
+        assert.ok(
+            relError < 0.2,
+            `${color}: recovered TD ${recovered.toFixed(3)} vs true ${tdTrue} (relErr ${(relError * 100).toFixed(1)}%, read ${opacityLayers} layers)`
+        );
+    }
+});
+
+test('computeFrontlitCalibration: more layers to opacity means a larger TD for the same color', async () => {
+    const { computeFrontlitCalibration } = await loadCalibration();
+    const base = {
+        filamentColor: '#3050c0',
+        layerHeight: 0.04,
+        firstLayerHeight: 0.2,
+    };
+
+    const few = computeFrontlitCalibration({ ...base, opacityLayers: 4 });
+    const many = computeFrontlitCalibration({ ...base, opacityLayers: 12 });
+
+    assert.ok(few.ok && many.ok);
+    if (!few.ok || !many.ok) return;
+    assert.ok(
+        many.calibration.tdSingleValue > few.calibration.tdSingleValue,
+        `expected TD(12 layers) > TD(4 layers)`
+    );
+});
+
+test('deriveChannelTds anchors the brightest channel and shortens absorptive ones', async () => {
+    const { deriveChannelTds } = await loadCalibration();
+    const tdSingle = 0.4;
+
+    const red = deriveChannelTds('#ff0000', tdSingle);
+    // Red channel governs opacity for a red filament: anchored to the single TD.
+    assert.ok(Math.abs(red[0] - tdSingle) < 1e-6, `red anchor ${red[0]} != ${tdSingle}`);
+    assert.ok(red[0] > red[1], 'red TD should exceed green TD');
+    assert.ok(red[0] > red[2], 'red TD should exceed blue TD');
+
+    // A neutral gray gives three equal channel TDs at the single value.
+    const gray = deriveChannelTds('#808080', tdSingle);
+    assert.ok(Math.abs(gray[0] - gray[1]) < 1e-6 && Math.abs(gray[1] - gray[2]) < 1e-6);
+    assert.ok(Math.abs(gray[0] - tdSingle) < 1e-6);
+});
+
+test('a lighter base lets a near-black filament calibrate (round-trip over white)', async () => {
+    const { computeFrontlitCalibration, solveOpacityTransmission, OPACITY_JND } =
+        await loadCalibration();
+
+    // Black over a black base has no contrast; over white it does.
+    assert.equal(solveOpacityTransmission('#000000', OPACITY_JND, '#000000'), undefined);
+    const tWhite = solveOpacityTransmission('#000000', OPACITY_JND, '#ffffff');
+    assert.ok(tWhite !== undefined && tWhite > 0 && tWhite < 1);
+
+    // Round-trip a dark filament over a white base.
+    const color = '#101418';
+    const tdTrue = 0.25;
+    const layerHeight = 0.04;
+    const opacityLayers = await simulateOpacityRead(
+        color,
+        tdTrue,
+        layerHeight,
+        OPACITY_JND,
+        200,
+        '#ffffff'
+    );
+    const result = computeFrontlitCalibration({
+        filamentColor: color,
+        opacityLayers,
+        layerHeight,
+        firstLayerHeight: 0.2,
+        baseColor: '#ffffff',
+    });
+    assert.ok(result.ok, 'dark filament calibrates over a white base');
+    if (!result.ok) return;
+    assert.equal(result.calibration.baseColor, '#ffffff');
+    const relErr = Math.abs(result.calibration.tdSingleValue - tdTrue) / tdTrue;
+    assert.ok(relErr < 0.2, `recovered ${result.calibration.tdSingleValue} vs ${tdTrue}`);
+});
+
+test('computeFrontlitCalibration rejects invalid reads and uncalibratable colors', async () => {
+    const { computeFrontlitCalibration } = await loadCalibration();
+
+    const badLayers = computeFrontlitCalibration({
+        filamentColor: '#3050c0',
+        opacityLayers: 0,
+        layerHeight: 0.04,
+        firstLayerHeight: 0.2,
+    });
+    assert.equal(badLayers.ok, false);
+
+    const blackFilament = computeFrontlitCalibration({
+        filamentColor: '#000000',
+        opacityLayers: 5,
+        layerHeight: 0.04,
+        firstLayerHeight: 0.2,
+    });
+    assert.equal(blackFilament.ok, false);
+});
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index b92031b..f207f7d 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -186,11 +186,14 @@ test('cache keys include all weighted clusters and optimizer tuning', async () =
             ? {
                   ...filament,
                   calibration: {
-                      color: filament.color,
-                      measurements: [],
+                      opacityLayers: 6,
+                      layerHeight: 0.1,
+                      firstLayerHeight: 0.2,
                       td: [1.2, 1.8, 2.4] as [number, number, number],
                       tdSingleValue: filament.td,
+                      jnd: 2,
                       confidence: 1,
+                      basis: 'black-frontlit' as const,
                       calibrationDate: '2026-01-01T00:00:00.000Z',
                   },
               }

From bd4fa71940a263318afa09128750542e6db41bfc Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 2 Jul 2026 08:18:04 +0300
Subject: [PATCH 39/81] Remove the Load TD Test header button

Drop the header shortcut and its wiring (Header prop, App handler, Image icon
import) and update the docs/README references to load via upload or drag-and-drop.
The tdTest.png asset stays as an example image.
---
 README.md                         |  6 +++---
 src/App.tsx                       | 10 ----------
 src/components/Header.tsx         | 13 +------------
 src/docs/loading-images.md        |  6 +-----
 src/docs/overview.md              |  2 +-
 src/docs/quick-start.md           |  2 +-
 src/docs/settings-and-controls.md | 11 +++++------
 7 files changed, 12 insertions(+), 38 deletions(-)

diff --git a/README.md b/README.md
index 92b0358..9004c14 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,7 @@ A quick look at what Kromacut produces from a source image to a printable model:
 | Sliced by Colors | Real Print |
 | <img src="content/fuji3dsliced.png" alt="Fuji Sliced" width="600" /> | <img src="content/printed.jpg" alt="Printed Result" width="600" /> |
 
-Another minimal test you can try yourself in the app header: the Transmission Distance (TD) test image.
+Another minimal test you can try yourself: the included Transmission Distance (TD) test image (`src/assets/tdTest.png`).
 
 | TD Test |
 |---|
@@ -280,12 +280,12 @@ See the [Auto-paint section](#auto-paint) above for full details.
 ### TD test image (for manual mode experimentation)
 
 - This repository includes a small test image `tdTest.png` (found in `src/assets/tdTest.png`).
-- The app header includes a `Load TD Test` button that will load that image into the preview so you can quickly experiment with manual layer ordering and per-color slice heights.
+- Load it into the preview with the toolbar upload button or drag-and-drop so you can quickly experiment with manual layer ordering and per-color slice heights.
 - This is primarily useful for testing manual mode workflows or understanding how layer heights affect perceived color.
 
 Quick manual workflow experiment:
 
-1. Click `Load TD Test` in the app header.
+1. Load `tdTest.png` (upload button or drag-and-drop).
 2. Reduce colors to your desired number.
 3. Switch to Manual mode (3D Controls → Manual tab).
 4. Adjust per-color slice heights and ordering.
diff --git a/src/App.tsx b/src/App.tsx
index 2815858..d5381a0 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -9,7 +9,6 @@ import {
 } from './types';
 import ThreeDView from './components/ThreeDView';
 import logo from './assets/logo.png';
-import tdTestImg from './assets/tdTest.png';
 import CanvasPreview from './components/CanvasPreview';
 import type { CanvasPreviewHandle } from './components/CanvasPreview';
 import { SwatchesPanel } from './components/SwatchesPanel';
@@ -478,15 +477,6 @@ function App(): React.ReactElement | null {
                 docsOpen={docsOpen}
                 onBackToApp={backToApp}
                 onToggleDocs={toggleDocs}
-                onLoadTest={() => {
-                    invalidate();
-                    setImage(tdTestImg, true);
-                    setMode('2d');
-                    if (parseDocsLocation(window.location)) {
-                        window.history.pushState(null, '', '/');
-                    }
-                    setDocsOpen(false);
-                }}
             />
             {docsOpen && (
                 <div className="flex flex-1 min-h-0 w-full">
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 50a6a93..b89741d 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -6,7 +6,6 @@ import {
     BookOpen,
     CheckCircle2,
     Download,
-    Image,
     Heart,
     Loader2,
     Moon,
@@ -44,7 +43,6 @@ import githubIcon from '../assets/github.svg';
 import redditIcon from '../assets/reddit.svg';
 
 interface Props {
-    onLoadTest: () => void;
     docsOpen: boolean;
     onBackToApp: () => void;
     onToggleDocs: () => void;
@@ -53,7 +51,7 @@ interface Props {
 const appVersion = __APP_VERSION__;
 type UpdateCheckStatus = 'idle' | 'checking' | 'available' | 'current' | 'error';
 
-export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onToggleDocs }) => {
+export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs }) => {
     const [themeMode, setThemeMode] = React.useState<ThemeMode>(() => getStoredThemeMode());
     const [settingsOpen, setSettingsOpen] = React.useState(false);
     const [checkOnStartup, setCheckOnStartup] = React.useState(() => getUpdateCheckOnStartup());
@@ -189,15 +187,6 @@ export const Header: React.FC<Props> = ({ onLoadTest, docsOpen, onBackToApp, onT
                     )}
                     <span className="max-sm:hidden">{docsOpen ? 'Back to app' : 'Docs'}</span>
                 </Button>
-                <Button
-                    size="sm"
-                    onClick={onLoadTest}
-                    title="Load TD Test"
-                    className="bg-primary hover:bg-primary/90 text-primary-foreground font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
-                >
-                    <Image className="w-4 h-4" />
-                    <span className="max-sm:hidden">Load TD Test</span>
-                </Button>
                 <Button
                     size="sm"
                     asChild
diff --git a/src/docs/loading-images.md b/src/docs/loading-images.md
index 161fdde..6b2ba7b 100644
--- a/src/docs/loading-images.md
+++ b/src/docs/loading-images.md
@@ -7,16 +7,12 @@ description: Import, crop, pan, zoom, and manage the source image.
 
 # Loading Images
 
-Kromacut starts with one image. You can use your own image or the built-in TD test image.
+Kromacut starts with one image. You can use your own image or the app logo it loads by default.
 
 ## Choose A Source
 
 Use any normal image file Kromacut can open in the web app or standalone desktop build. The preview toolbar includes a file upload button, and the preview area accepts drag and drop while you are in **2D** mode.
 
-The header also includes **Load TD Test**. It loads a small bundled image for experimenting with Transmission Distance and layer ordering.
-
-![TD test image](td-test.png 'Bundled TD test image')
-
 ## Preview Controls
 
 The 2D preview is intentionally pixel-crisp so the reduced image shows exact color regions.
diff --git a/src/docs/overview.md b/src/docs/overview.md
index d95c892..b937591 100644
--- a/src/docs/overview.md
+++ b/src/docs/overview.md
@@ -36,7 +36,7 @@ Manual mode starts from the image colors shown in the **Image colors** panel. Au
 
 The workspace has three main areas:
 
-- The header contains **Load TD Test**, theme controls, and community links.
+- The header contains docs, theme controls, and community links.
 - The left panel contains the current mode controls.
     - In **2D**, it shows adjustments, dedither, quantization, custom palettes, and detected image colors.
     - In **3D**, it shows print settings, Manual controls, Auto-paint controls, and print instructions.
diff --git a/src/docs/quick-start.md b/src/docs/quick-start.md
index e782c3a..dac5869 100644
--- a/src/docs/quick-start.md
+++ b/src/docs/quick-start.md
@@ -11,7 +11,7 @@ This guide walks through a typical project from image loading to export.
 
 ## Load Or Import An Image
 
-Use the upload button in the preview toolbar, drag an image into the 2D preview, or click **Load TD Test** in the header for a built-in practice image.
+Use the upload button in the preview toolbar or drag an image into the 2D preview.
 
 After loading, use the mouse wheel to zoom and drag the preview to pan. If the image has transparency, the checkerboard button can make transparent areas easier to see.
 
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index 6c30813..dcbef3d 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -11,12 +11,11 @@ This page collects controls that affect the whole app or are easy to miss.
 
 ## Header Controls
 
-| Control      | What it does                                              |
-| ------------ | --------------------------------------------------------- |
-| Load TD Test | Loads the bundled TD test image into the current project. |
-| Docs         | Opens this documentation page.                            |
-| Discord      | Opens the community link.                                 |
-| GitHub       | Opens the project page.                                   |
+| Control | What it does                   |
+| ------- | ------------------------------ |
+| Docs    | Opens this documentation page. |
+| Discord | Opens the community link.      |
+| GitHub  | Opens the project page.        |
 | Support me   | Opens the support link.                                   |
 | Settings     | Opens the settings dialog, including theme and desktop update controls. |
 

From ad6567b42a6d6257dcabadcb6118889c61d6477f Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 2 Jul 2026 08:55:56 +0300
Subject: [PATCH 40/81] Fix frontlit calibration review issues

---
 CHANGELOG.md                                 |   3 +-
 src/App.tsx                                  |  10 +-
 src/components/AutoPaintTab.tsx              |   1 +
 src/components/FilamentCalibrationDialog.tsx |  79 +++++++++--
 src/components/FilamentRow.tsx               |  30 +++-
 src/docs/3d-mode.md                          |   2 +-
 src/lib/autoPaint.ts                         |  12 +-
 src/lib/calibration.ts                       |  75 +++++++++-
 src/lib/generateCalibrationPrint.ts          |  16 ++-
 src/lib/profileManager.ts                    |  66 +++++++--
 tests/autoPaint.test.ts                      |  40 +++++-
 tests/calibrationPrint.test.ts               |  16 +++
 tests/frontlitCalibration.test.ts            |  37 +++++
 tests/optimizer.test.ts                      |   3 +-
 tests/profileManager.test.ts                 | 137 ++++++++++++++++++-
 15 files changed, 474 insertions(+), 53 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d7fa4e1..29ed358 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the single layer count at which each filament's patch first matches the rail. Kromacut converts that read into a frontlit Transmission Distance (scalar plus per-channel) using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed; recalibrate any previously calibrated filaments.
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the single layer count at which each filament's patch first matches the rail. Kromacut converts that read into a frontlit Transmission Distance (scalar plus per-channel) using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
@@ -14,7 +14,6 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
-- **Calibration image sampler** - The sampler now shows a circular brush over the exact image area it averages, plus a marker for the last captured sample, making it easier to avoid patch edges and glare.
 - **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
 - **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Legacy saved values migrate to the nearest current tier.
 - **Auto-paint optical model** - Beer-Lambert blending now runs in linear-light sRGB, and calibrated filaments use measured RGB-channel TDs for blend simulation and transition-zone thickness. Recalibrate profiles created with earlier releases before using them for new prints.
diff --git a/src/App.tsx b/src/App.tsx
index d5381a0..aa58ad1 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -43,6 +43,7 @@ import { defaultDocSlug } from './docs';
 import { loadCameraMode, saveCameraMode } from './lib/cameraPrefs';
 import { buildDocsPath, parseDocsLocation } from './lib/docs/navigation';
 import { applyHomeSeo } from './lib/seo';
+import { sanitizeProfileFilament } from './lib/profileManager';
 import {
     AlertDialog,
     AlertDialogContent,
@@ -112,6 +113,13 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const parsed = JSON.parse(raw) as any;
         if (!parsed || !Array.isArray(parsed.filaments)) return null;
+        const filaments = parsed.filaments
+            .map((filament: unknown) => sanitizeProfileFilament(filament))
+            .filter(
+                (filament: ReturnType<typeof sanitizeProfileFilament>): filament is NonNullable<
+                    ReturnType<typeof sanitizeProfileFilament>
+                > => filament !== null
+            );
         // Migrate legacy `autoPaintEnabled` boolean → `paintMode`
         const paintMode: 'manual' | 'autopaint' =
             parsed.paintMode === 'autopaint' || parsed.paintMode === 'manual'
@@ -120,7 +128,7 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
                   ? 'autopaint'
                   : 'manual';
         return {
-            filaments: parsed.filaments,
+            filaments,
             paintMode,
             optimizerAlgorithm: normalizeOptimizerTier(parsed.optimizerAlgorithm),
             optimizerSeed: parsed.optimizerSeed,
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 3508e7c..c231a34 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -469,6 +469,7 @@ export default function AutoPaintTab({
                                     filament={f}
                                     onUpdate={updateFilament}
                                     onRemove={removeFilament}
+                                    onCalibrate={handleOpenCalibration}
                                 />
                             ))}
                         </div>
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 2e5b2b4..678fee1 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -8,7 +8,7 @@
  * to a frontlit TD and saved to the filament profile.
  */
 
-import { useCallback, useMemo, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import {
     AlertDialog,
     AlertDialogContent,
@@ -41,6 +41,7 @@ import {
 import {
     generateCalibrationStl,
     generateCalibration3mf,
+    calibrationBaseHeight,
     DEFAULT_CALIBRATION_PRINT_OPTIONS,
     type CalibrationPrintOptions,
     type CalibrationTile,
@@ -94,6 +95,10 @@ function downloadBlob(blob: Blob, filename: string) {
     URL.revokeObjectURL(url);
 }
 
+function formatMm(value: number): string {
+    return `${value.toFixed(2)} mm`;
+}
+
 export function FilamentCalibrationDialog({
     open,
     onClose,
@@ -103,10 +108,16 @@ export function FilamentCalibrationDialog({
     firstLayerHeight,
     onApply,
 }: FilamentCalibrationDialogProps) {
+    const initialSelection = useCallback(() => {
+        const id =
+            initialFilamentId && filaments.some((filament) => filament.id === initialFilamentId)
+                ? initialFilamentId
+                : null;
+        return new Set(id ? [id] : []);
+    }, [filaments, initialFilamentId]);
+
     const [step, setStep] = useState<Step>('select');
-    const [selectedIds, setSelectedIds] = useState<Set<string>>(
-        () => new Set(initialFilamentId ? [initialFilamentId] : [])
-    );
+    const [selectedIds, setSelectedIds] = useState<Set<string>>(() => initialSelection());
     const [maxLayers, setMaxLayers] = useState(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
     const [calibrationLayerHeight, setCalibrationLayerHeight] = useState(layerHeight);
     // Free-typing drafts for the numeric inputs; clamped to the committed value on blur.
@@ -118,6 +129,7 @@ export function FilamentCalibrationDialog({
     const [reads, setReads] = useState<Record<string, string>>({});
     // filament id -> chosen base filament id (defaults to the darkest filament).
     const [baseChoices, setBaseChoices] = useState<Record<string, string>>({});
+    const wasOpenRef = useRef(open);
 
     const darkestFilamentId = useMemo(() => {
         if (filaments.length === 0) return undefined;
@@ -126,6 +138,11 @@ export function FilamentCalibrationDialog({
         ).id;
     }, [filaments]);
 
+    const filamentById = useMemo(
+        () => new Map(filaments.map((filament) => [filament.id, filament])),
+        [filaments]
+    );
+
     const resolveBaseId = useCallback(
         (filamentId: string): string => baseChoices[filamentId] ?? darkestFilamentId ?? filamentId,
         [baseChoices, darkestFilamentId]
@@ -133,10 +150,18 @@ export function FilamentCalibrationDialog({
 
     const resolveBaseColor = useCallback(
         (filamentId: string): string => {
-            const base = filaments.find((f) => f.id === resolveBaseId(filamentId));
+            const base = filamentById.get(resolveBaseId(filamentId));
             return base?.color ?? '#000000';
         },
-        [filaments, resolveBaseId]
+        [filamentById, resolveBaseId]
+    );
+
+    const resolveBaseLabel = useCallback(
+        (filamentId: string): string => {
+            const base = filamentById.get(resolveBaseId(filamentId));
+            return base ? filamentLabel(base) : 'Base';
+        },
+        [filamentById, resolveBaseId]
     );
 
     const setBaseChoice = useCallback((filamentId: string, baseId: string) => {
@@ -176,10 +201,12 @@ export function FilamentCalibrationDialog({
         }),
         [calibrationLayerHeight, firstLayerHeight, maxLayers]
     );
+    const firstLayerPrintHeight = Math.max(calibrationLayerHeight, firstLayerHeight);
+    const swapZ = calibrationBaseHeight(printOptions);
 
     const reset = useCallback(() => {
         setStep('select');
-        setSelectedIds(new Set(initialFilamentId ? [initialFilamentId] : []));
+        setSelectedIds(initialSelection());
         setMaxLayers(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
         setMaxLayersDraft(String(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers));
         setCalibrationLayerHeight(layerHeight);
@@ -187,7 +214,12 @@ export function FilamentCalibrationDialog({
         setFormat('stl');
         setReads({});
         setBaseChoices({});
-    }, [initialFilamentId, layerHeight]);
+    }, [initialSelection, layerHeight]);
+
+    useEffect(() => {
+        if (open && !wasOpenRef.current) reset();
+        wasOpenRef.current = open;
+    }, [open, reset]);
 
     const handleClose = useCallback(() => {
         onClose();
@@ -520,11 +552,40 @@ export function FilamentCalibrationDialog({
                         </div>
                         <p className="text-[11px] text-muted-foreground">
                             {format === 'stl'
-                                ? 'Single solid. Print it once per filament: base, then swap to the color above the base.'
+                                ? 'Single solid. Print one copy per selected filament using the matching base and swap line below.'
                                 : 'Colors + bases baked in for AMS / multi-material — all selected filaments in one print.'}
                         </p>
                     </div>
 
+                    {format === 'stl' && (
+                        <div className="space-y-2 rounded-md border border-border/60 bg-background/70 p-3 text-[12px]">
+                            <p className="text-muted-foreground">
+                                Slice at layer height {formatMm(calibrationLayerHeight)} and first
+                                layer {formatMm(firstLayerPrintHeight)}.
+                            </p>
+                            <div className="max-h-32 space-y-1 overflow-y-auto pr-1">
+                                {selectedFilaments.map((filament) => (
+                                    <div
+                                        key={filament.id}
+                                        className="flex items-start gap-2 text-foreground"
+                                    >
+                                        <span
+                                            className="mt-0.5 h-3 w-3 flex-none rounded-sm border border-border/70"
+                                            style={{ backgroundColor: filament.color }}
+                                        />
+                                        <span className="min-w-0">
+                                            <span className="font-medium">
+                                                {filamentLabel(filament)}
+                                            </span>
+                                            : base = {resolveBaseLabel(filament.id)}, swap after
+                                            layer {printOptions.baseLayers} / Z {formatMm(swapZ)}.
+                                        </span>
+                                    </div>
+                                ))}
+                            </div>
+                        </div>
+                    )}
+
                     <Button onClick={handleDownload} className="w-full gap-2">
                         <Download className="h-4 w-4" />
                         Download {format.toUpperCase()}
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index 6ae3b83..86523e3 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -1,23 +1,30 @@
 import React, { useEffect, useState } from 'react';
 import { Input } from '@/components/ui/input';
 import { Button } from '@/components/ui/button';
-import { Trash2, Wand2, BadgeCheck } from 'lucide-react';
+import { Trash2, Wand2, BadgeCheck, FlaskConical } from 'lucide-react';
 import { HexColorPicker } from 'react-colorful';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import type { Filament } from '../types';
 import { estimateTDFromColor } from '../lib/colorUtils';
-import { computeProfileConfidence, getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
+import {
+    computeProfileConfidence,
+    getConfidenceLabel,
+    getConfidenceColor,
+    sanitizeFrontlitCalibration,
+} from '../lib/calibration';
 
 interface FilamentRowProps {
     filament: Filament;
     onUpdate: (id: string, updates: Partial<Omit<Filament, 'id'>>) => void;
     onRemove: (id: string) => void;
+    onCalibrate?: (id: string) => void;
 }
 
 const FilamentRow = React.memo(function FilamentRow({
     filament,
     onUpdate,
     onRemove,
+    onCalibrate,
 }: FilamentRowProps) {
     // Local state for the input value to allow free typing
     const [localTd, setLocalTd] = useState<string>(filament.td.toString());
@@ -29,9 +36,10 @@ const FilamentRow = React.memo(function FilamentRow({
     );
 
     // Calculate confidence for this filament
+    const sanitizedCalibration = sanitizeFrontlitCalibration(filament.calibration);
     const calibrationMatchesTd =
-        !!filament.calibration && Math.abs(filament.td - filament.calibration.tdSingleValue) < 0.05;
-    const activeCalibration = calibrationMatchesTd ? filament.calibration : undefined;
+        !!sanitizedCalibration && Math.abs(filament.td - sanitizedCalibration.tdSingleValue) < 0.05;
+    const activeCalibration = calibrationMatchesTd ? sanitizedCalibration : undefined;
 
     const confidence = computeProfileConfidence({
         calibration: activeCalibration,
@@ -175,6 +183,18 @@ const FilamentRow = React.memo(function FilamentRow({
                 <Wand2 className="w-4 h-4" />
             </Button>
 
+            {onCalibrate && (
+                <Button
+                    variant="ghost"
+                    size="icon"
+                    onClick={() => onCalibrate(filament.id)}
+                    className="h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer"
+                    title="Calibrate filament"
+                >
+                    <FlaskConical className="w-4 h-4" />
+                </Button>
+            )}
+
             {/* Calibration Badge */}
             {isCalibrated && (
                 <div
@@ -200,4 +220,4 @@ const FilamentRow = React.memo(function FilamentRow({
     );
 });
 
-export default FilamentRow;
\ No newline at end of file
+export default FilamentRow;
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index f26d349..ab20b0c 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -50,7 +50,7 @@ Calibration is camera-free: you print a small wedge and read back a single numbe
 
 1. **Select** the filaments you want to calibrate.
 2. **Base layers** — choose the base filament each one prints over. It defaults to your darkest filament (matching how frontlit prints are viewed), and the base comes from your real profile filaments, so no extra "phantom" filament is added to the print. A dark filament has too little contrast with a dark base, so switch its base to a lighter one (e.g. white) here.
-3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer — print it once per filament, base then your color above the base) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). Each filament prints as a row of patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
+3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). For STL, use the shown layer height and first-layer height, print one copy per selected filament, load the listed base filament, then swap after the shown layer/Z height to the filament being calibrated. Each filament prints as a row of patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
 4. **Enter Results** by reporting, for each filament, the **first patch that looks identical to the reference rail** beside it — that is its opacity layer. Kromacut converts that number into a frontlit TD (with per-channel values), shows a predicted-vs-reference swatch, the TD, and a confidence rating. Click **Save Calibration** to apply it.
 
 Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured TD is a material property, so it transfers to your real prints regardless of which base you calibrated against.
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 1d59f05..8315ecb 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -15,7 +15,11 @@ import {
     type OptimizerResult,
     type ScoringContext,
 } from './optimizer';
-import { computeProfileConfidence, type CalibrationRgb } from './calibration';
+import {
+    computeProfileConfidence,
+    sanitizeFrontlitCalibration,
+    type CalibrationRgb,
+} from './calibration';
 import { blendSrgbChannel } from './colorSpace';
 
 export { LAYER_ACTIVATION_EPSILON } from './layerActivation';
@@ -401,7 +405,7 @@ type AutoPaintFilament = Pick<Filament, 'id' | 'color' | 'td' | 'calibration'>;
 
 function calibratedTdChannels(filament: AutoPaintFilament): CalibrationRgb | undefined {
     if (!USE_CALIBRATED_CHANNEL_TD) return undefined;
-    const channels = filament.calibration?.td;
+    const channels = sanitizeFrontlitCalibration(filament.calibration)?.td;
     if (!channels || channels.some((td) => !Number.isFinite(td) || td <= 0)) {
         return undefined;
     }
@@ -412,10 +416,10 @@ function scaleFilamentForFrontlight(filament: Filament): Filament {
     // Calibrated filaments already carry measured frontlit TDs (scalar + per
     // channel), so they pass through unchanged. Only uncalibrated filaments get
     // the generic frontlit approximation.
-    if (filament.calibration) {
+    if (sanitizeFrontlitCalibration(filament.calibration)) {
         return filament;
     }
-    return { ...filament, td: filament.td * FRONTLIT_TD_SCALE };
+    return { ...filament, td: filament.td * FRONTLIT_TD_SCALE, calibration: undefined };
 }
 
 /**
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index c8023a2..b674a2c 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -37,11 +37,11 @@ export interface FrontlitCalibration {
     /** JND used for the opacity solve. */
     jnd: number;
     /** Base color the wedge was calibrated over (hex). */
-    baseColor?: string;
+    baseColor: string;
     /** 0-1 quality score. */
     confidence: number;
-    /** Calibration basis, fixed for now. */
-    basis: 'black-frontlit';
+    /** Calibration method. `baseColor` records the actual base used. */
+    basis: 'frontlit';
     /** ISO timestamp. */
     calibrationDate: string;
     notes?: string;
@@ -96,6 +96,67 @@ function hexToRgb(hex: string): CalibrationRgb | null {
         : null;
 }
 
+const isFinitePositive = (value: unknown): value is number =>
+    typeof value === 'number' && Number.isFinite(value) && value > 0;
+
+function sanitizeCalibrationRgb(value: unknown): CalibrationRgb | undefined {
+    if (!Array.isArray(value) || value.length !== 3) return undefined;
+    const [r, g, b] = value;
+    if (!isFinitePositive(r) || !isFinitePositive(g) || !isFinitePositive(b)) return undefined;
+    return [r, g, b];
+}
+
+/**
+ * Accept only the camera-free frontlit calibration shape. Older backlit photo
+ * calibrations are intentionally stripped on load rather than migrated.
+ */
+export function sanitizeFrontlitCalibration(value: unknown): FrontlitCalibration | undefined {
+    if (!value || typeof value !== 'object') return undefined;
+    const candidate = value as Record<string, unknown>;
+    if (candidate.basis !== 'frontlit') return undefined;
+    if (
+        typeof candidate.opacityLayers !== 'number' ||
+        !Number.isFinite(candidate.opacityLayers) ||
+        candidate.opacityLayers < 1
+    ) {
+        return undefined;
+    }
+    if (!isFinitePositive(candidate.layerHeight)) return undefined;
+    if (!isFinitePositive(candidate.firstLayerHeight)) return undefined;
+    if (!isFinitePositive(candidate.tdSingleValue)) return undefined;
+    if (!isFinitePositive(candidate.jnd)) return undefined;
+    if (typeof candidate.baseColor !== 'string' || !hexToRgb(candidate.baseColor)) {
+        return undefined;
+    }
+    if (typeof candidate.confidence !== 'number' || !Number.isFinite(candidate.confidence)) {
+        return undefined;
+    }
+    if (
+        typeof candidate.calibrationDate !== 'string' ||
+        !Number.isFinite(new Date(candidate.calibrationDate).getTime())
+    ) {
+        return undefined;
+    }
+
+    const td = sanitizeCalibrationRgb(candidate.td);
+    if (!td) return undefined;
+
+    const sanitized: FrontlitCalibration = {
+        opacityLayers: candidate.opacityLayers,
+        layerHeight: candidate.layerHeight,
+        firstLayerHeight: candidate.firstLayerHeight,
+        td,
+        tdSingleValue: candidate.tdSingleValue,
+        jnd: candidate.jnd,
+        baseColor: candidate.baseColor,
+        confidence: clamp(candidate.confidence, 0, 1),
+        basis: 'frontlit',
+        calibrationDate: candidate.calibrationDate,
+    };
+    if (typeof candidate.notes === 'string') sanitized.notes = candidate.notes;
+    return sanitized;
+}
+
 // ============================================================================
 // Opacity-read calibration
 // ============================================================================
@@ -221,7 +282,7 @@ export function computeFrontlitCalibration(
             jnd,
             baseColor,
             confidence,
-            basis: 'black-frontlit',
+            basis: 'frontlit',
             calibrationDate: new Date().toISOString(),
             notes: input.notes,
         },
@@ -259,17 +320,17 @@ export function predictFrontlitColor(
  * decay, or a TD-plausibility heuristic when uncalibrated.
  */
 export function computeProfileConfidence(profile: {
-    calibration?: FrontlitCalibration;
+    calibration?: unknown;
     transmissionDistance: number;
 }): number {
-    if (!profile.calibration) {
+    const cal = sanitizeFrontlitCalibration(profile.calibration);
+    if (!cal) {
         const td = profile.transmissionDistance;
         if (td >= 1.0 && td <= 5.0) return 0.5;
         if (td >= 0.5 && td <= 10.0) return 0.3;
         return 0.1;
     }
 
-    const cal = profile.calibration;
     let confidence = cal.confidence;
 
     const ageMs = Date.now() - new Date(cal.calibrationDate).getTime();
diff --git a/src/lib/generateCalibrationPrint.ts b/src/lib/generateCalibrationPrint.ts
index 6a87a0c..f859832 100644
--- a/src/lib/generateCalibrationPrint.ts
+++ b/src/lib/generateCalibrationPrint.ts
@@ -81,12 +81,16 @@ interface TileGeometry {
 }
 
 /**
- * Thickness of the black base in mm. The slicer applies its own first-layer
- * height when printing, so this is just `baseLayers` worth of regular layers —
- * enough to be opaque black under the wedge, no thicker.
+ * Thickness of the base in mm. The first printed layer uses the slicer's first
+ * layer height, then the remaining base layers use the regular layer height.
+ * This keeps the base top and every wedge/rail top on the slicer's Z grid.
  */
-function baseHeight(options: CalibrationPrintOptions): number {
-    return options.baseLayers * options.layerHeight;
+export function calibrationBaseHeight(
+    options: Pick<CalibrationPrintOptions, 'baseLayers' | 'layerHeight' | 'firstLayerHeight'>
+): number {
+    if (!Number.isFinite(options.baseLayers) || options.baseLayers <= 0) return 0;
+    const firstLayer = Math.max(options.layerHeight, options.firstLayerHeight);
+    return firstLayer + Math.max(0, options.baseLayers - 1) * options.layerHeight;
 }
 
 /** Width of the opaque reference rail along the wedge edge (mm). */
@@ -105,7 +109,7 @@ const REFERENCE_MARGIN_LAYERS = 4;
 function buildTileGeometry(options: CalibrationPrintOptions, originX = 0): TileGeometry {
     const { layerHeight, maxLayers, patchSize, gap } = options;
     const railLayers = maxLayers + REFERENCE_MARGIN_LAYERS;
-    const baseH = baseHeight(options);
+    const baseH = calibrationBaseHeight(options);
     const pad = gap;
     const columnWidth = patchSize + gap;
     const wedgeSpan = maxLayers * columnWidth - gap; // first patch left to last patch right
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index d6bcf3d..0ae8adb 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -1,4 +1,5 @@
 import type { Filament } from '../types';
+import { sanitizeFrontlitCalibration } from './calibration';
 
 export interface AutoPaintProfile {
     id: string;
@@ -14,16 +15,66 @@ export const CURRENT_PROFILE_VERSION = 1;
 const PROFILES_STORAGE_KEY = 'kromacut.autopaint.profiles';
 const LAST_PROFILE_KEY = 'kromacut.autopaint.lastProfileId';
 
+function isRecord(value: unknown): value is Record<string, unknown> {
+    return !!value && typeof value === 'object';
+}
+
+export function sanitizeProfileFilament(value: unknown): Filament | null {
+    if (!isRecord(value)) return null;
+    if (
+        typeof value.id !== 'string' ||
+        typeof value.color !== 'string' ||
+        typeof value.td !== 'number' ||
+        !Number.isFinite(value.td)
+    ) {
+        return null;
+    }
+
+    const filament: Filament = {
+        id: value.id,
+        color: value.color,
+        td: value.td,
+    };
+    if (typeof value.name === 'string') filament.name = value.name;
+    if (typeof value.brand === 'string') filament.brand = value.brand;
+
+    const calibration = sanitizeFrontlitCalibration(value.calibration);
+    if (calibration) filament.calibration = calibration;
+    return filament;
+}
+
+function sanitizeProfile(value: unknown): AutoPaintProfile | null {
+    if (!isRecord(value)) return null;
+    if (
+        typeof value.id !== 'string' ||
+        typeof value.name !== 'string' ||
+        !Array.isArray(value.filaments)
+    ) {
+        return null;
+    }
+
+    const now = Date.now();
+    return {
+        id: value.id,
+        name: value.name,
+        version: typeof value.version === 'number' ? value.version : CURRENT_PROFILE_VERSION,
+        filaments: value.filaments
+            .map((filament) => sanitizeProfileFilament(filament))
+            .filter((filament): filament is Filament => filament !== null),
+        createdAt: typeof value.createdAt === 'number' ? value.createdAt : now,
+        updatedAt: typeof value.updatedAt === 'number' ? value.updatedAt : now,
+    };
+}
+
 export function loadProfiles(): AutoPaintProfile[] {
     try {
         const raw = localStorage.getItem(PROFILES_STORAGE_KEY);
         if (!raw) return [];
         const parsed = JSON.parse(raw) as AutoPaintProfile[];
         if (!Array.isArray(parsed)) return [];
-        return parsed.filter(
-            (p) =>
-                typeof p.id === 'string' && typeof p.name === 'string' && Array.isArray(p.filaments)
-        );
+        return parsed
+            .map((profile) => sanitizeProfile(profile))
+            .filter((profile): profile is AutoPaintProfile => profile !== null);
     } catch {
         return [];
     }
@@ -162,10 +213,9 @@ export function importProfiles(
         // Validate required fields
         if (!raw || typeof raw.name !== 'string' || !Array.isArray(raw.filaments)) continue;
 
-        const validFilaments = raw.filaments.filter(
-            (f) =>
-                typeof f.id === 'string' && typeof f.color === 'string' && typeof f.td === 'number'
-        );
+        const validFilaments = raw.filaments
+            .map((filament) => sanitizeProfileFilament(filament))
+            .filter((filament): filament is Filament => filament !== null);
 
         const now = Date.now();
         const profile: AutoPaintProfile = {
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index d4576a7..5130694 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -153,8 +153,9 @@ test('transition-thickness cache distinguishes calibrated channel TDs', async ()
                 td: [0.5, 1, 2] as [number, number, number],
                 tdSingleValue: 1,
                 jnd: 2,
+                baseColor: '#000000',
                 confidence: 1,
-                basis: 'black-frontlit' as const,
+                basis: 'frontlit' as const,
                 calibrationDate: '2026-01-01T00:00:00.000Z',
             },
         },
@@ -186,6 +187,40 @@ test('calibrated per-channel TDs tint blends without changing scalar TD behavior
     );
 });
 
+test('legacy photo calibrations are ignored and use the frontlit fallback scale', async () => {
+    const { generateAutoLayers } = await loadAutoPaintModule();
+    const filaments = [
+        { id: 'black', color: '#000000', td: 1 },
+        { id: 'white', color: '#ffffff', td: 16 },
+    ];
+    const legacyFilaments = [
+        filaments[0],
+        {
+            ...filaments[1],
+            calibration: {
+                measurements: [{ color: '#ffffff', rgb: [245, 245, 245], thickness: 0.4 }],
+                whiteReference: [255, 255, 255],
+                td: [8, 16, 32],
+                tdSingleValue: 16,
+                confidence: 1,
+                calibrationDate: '2025-01-01T00:00:00.000Z',
+            },
+        },
+    ] as unknown as Parameters<typeof generateAutoLayers>[0];
+    const swatches = [
+        { hex: '#000000', count: 1 },
+        { hex: '#ffffff', count: 1 },
+    ];
+
+    const baseline = generateAutoLayers(filaments, swatches, 0.1, 0.2, undefined, false);
+    const legacy = generateAutoLayers(legacyFilaments, swatches, 0.1, 0.2, undefined, false);
+
+    assert.deepEqual(legacy.layers, baseline.layers);
+    assert.deepEqual(legacy.transitionZones, baseline.transitionZones);
+    assert.equal(legacy.totalHeight, baseline.totalHeight);
+    assert.equal(legacy.confidenceFactors.calibrationQuality, baseline.confidenceFactors.calibrationQuality);
+});
+
 test('Beer-Lambert blends operate in linear light before returning sRGB', async () => {
     const { blendColors } = await loadAutoPaintModule();
     const halfTransmissionThickness = Math.log10(2);
@@ -221,8 +256,9 @@ test('calibrated channel TDs flow through generated auto-paint preview slices',
                 td: [8, 16, 32] as [number, number, number],
                 tdSingleValue: 16,
                 jnd: 2,
+                baseColor: '#000000',
                 confidence: 1,
-                basis: 'black-frontlit' as const,
+                basis: 'frontlit' as const,
                 calibrationDate: '2026-01-01T00:00:00.000Z',
             },
         },
diff --git a/tests/calibrationPrint.test.ts b/tests/calibrationPrint.test.ts
index 5cbd92f..23ca587 100644
--- a/tests/calibrationPrint.test.ts
+++ b/tests/calibrationPrint.test.ts
@@ -53,6 +53,22 @@ test('generateCalibrationStl writes one box per base/wedge/reference patch', asy
     assert.equal(buffer.byteLength, 84 + triangleCount * 50);
 });
 
+test('calibration base and patch tops align to the first-layer-aware slicer grid', async () => {
+    const { calibrationBaseHeight } = await loadGenerator();
+    const baseH = calibrationBaseHeight(baseOptions);
+    const firstLayerTop = Math.max(baseOptions.layerHeight, baseOptions.firstLayerHeight);
+
+    assert.equal(baseH, 0.52);
+    for (let layers = 0; layers <= baseOptions.maxLayers; layers++) {
+        const top = baseH + layers * baseOptions.layerHeight;
+        const gridSteps = (top - firstLayerTop) / baseOptions.layerHeight;
+        assert.ok(
+            Math.abs(gridSteps - Math.round(gridSteps)) < 1e-9,
+            `top ${top} must land on the slicer grid`
+        );
+    }
+});
+
 test('generateCalibration3mf builds slots in profile order and colors the parts', async () => {
     const { generateCalibration3mf } = await loadGenerator();
     // Profile order matches the user's machine: white in slot 1, black in slot 2.
diff --git a/tests/frontlitCalibration.test.ts b/tests/frontlitCalibration.test.ts
index 07494bd..6c87a60 100644
--- a/tests/frontlitCalibration.test.ts
+++ b/tests/frontlitCalibration.test.ts
@@ -192,10 +192,47 @@ test('a lighter base lets a near-black filament calibrate (round-trip over white
     assert.ok(result.ok, 'dark filament calibrates over a white base');
     if (!result.ok) return;
     assert.equal(result.calibration.baseColor, '#ffffff');
+    assert.equal(result.calibration.basis, 'frontlit');
     const relErr = Math.abs(result.calibration.tdSingleValue - tdTrue) / tdTrue;
     assert.ok(relErr < 0.2, `recovered ${result.calibration.tdSingleValue} vs ${tdTrue}`);
 });
 
+test('sanitizeFrontlitCalibration accepts only the new frontlit calibration shape', async () => {
+    const { computeFrontlitCalibration, sanitizeFrontlitCalibration } = await loadCalibration();
+    const result = computeFrontlitCalibration({
+        filamentColor: '#ffffff',
+        opacityLayers: 6,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.2,
+    });
+    assert.ok(result.ok);
+    if (!result.ok) return;
+
+    const sanitized = sanitizeFrontlitCalibration(result.calibration);
+    assert.ok(sanitized);
+    assert.equal(sanitized.basis, 'frontlit');
+    assert.deepEqual(sanitized.td, result.calibration.td);
+    assert.equal(sanitized.tdSingleValue, result.calibration.tdSingleValue);
+    assert.equal(
+        sanitizeFrontlitCalibration({
+            measurements: [],
+            whiteReference: [255, 255, 255],
+            td: [2, 3, 4],
+            tdSingleValue: 3,
+            confidence: 0.9,
+            calibrationDate: '2025-01-01T00:00:00.000Z',
+        }),
+        undefined
+    );
+    assert.equal(
+        sanitizeFrontlitCalibration({
+            ...result.calibration,
+            basis: 'black-frontlit',
+        }),
+        undefined
+    );
+});
+
 test('computeFrontlitCalibration rejects invalid reads and uncalibratable colors', async () => {
     const { computeFrontlitCalibration } = await loadCalibration();
 
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index f207f7d..1440206 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -192,8 +192,9 @@ test('cache keys include all weighted clusters and optimizer tuning', async () =
                       td: [1.2, 1.8, 2.4] as [number, number, number],
                       tdSingleValue: filament.td,
                       jnd: 2,
+                      baseColor: '#000000',
                       confidence: 1,
-                      basis: 'black-frontlit' as const,
+                      basis: 'frontlit' as const,
                       calibrationDate: '2026-01-01T00:00:00.000Z',
                   },
               }
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 2d941a5..81e5e26 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -1,17 +1,65 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import { createServer } from 'vite';
 
-import {
-    profileFileName,
-    renameProfile,
-    type AutoPaintProfile,
-} from '../src/lib/profileManager.ts';
+import type { AutoPaintProfile } from '../src/lib/profileManager.ts';
 
-test('auto-paint profile exports use kfil filenames', () => {
+type ProfileManagerModule = typeof import('../src/lib/profileManager.ts');
+
+let profileManagerModule: Promise<ProfileManagerModule> | null = null;
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+const loadProfileManager = () =>
+    (profileManagerModule ??= loadViteModule<ProfileManagerModule>('/src/lib/profileManager.ts'));
+
+const oldPhotoCalibration = {
+    measurements: [{ color: '#ffffff', rgb: [245, 240, 230], thickness: 0.4 }],
+    whiteReference: [255, 255, 255],
+    td: [2.5, 3.5, 4.5],
+    tdSingleValue: 3.5,
+    confidence: 0.92,
+    calibrationDate: '2025-01-01T00:00:00.000Z',
+};
+
+function createMemoryStorage() {
+    const values = new Map<string, string>();
+    return {
+        getItem: (key: string) => (values.has(key) ? values.get(key)! : null),
+        setItem: (key: string, value: string) => {
+            values.set(key, value);
+        },
+        removeItem: (key: string) => {
+            values.delete(key);
+        },
+    };
+}
+
+test('auto-paint profile exports use kfil filenames', async () => {
+    const { profileFileName } = await loadProfileManager();
     assert.equal(profileFileName('PLA Basic White'), 'PLA_Basic_White.kfil');
 });
 
-test('auto-paint profiles can be renamed without changing filament data', () => {
+test('auto-paint profiles can be renamed without changing filament data', async () => {
+    const { renameProfile } = await loadProfileManager();
     const profiles: AutoPaintProfile[] = [
         {
             id: 'profile-1',
@@ -29,3 +77,78 @@ test('auto-paint profiles can be renamed without changing filament data', () =>
     assert.deepEqual(renamed[0].filaments, profiles[0].filaments);
     assert.ok(renamed[0].updatedAt >= profiles[0].updatedAt);
 });
+
+test('profile imports strip legacy photo calibration objects', async () => {
+    const { importProfiles } = await loadProfileManager();
+    const incoming = [
+        {
+            id: 'profile-old',
+            name: 'Legacy Profile',
+            version: 1,
+            createdAt: 1,
+            updatedAt: 1,
+            filaments: [
+                {
+                    id: 'filament-old',
+                    color: '#ffffff',
+                    td: 3.5,
+                    calibration: oldPhotoCalibration,
+                },
+            ],
+        },
+    ] as unknown as AutoPaintProfile[];
+
+    const result = importProfiles([], incoming);
+
+    assert.equal(result.imported.length, 1);
+    assert.equal(result.imported[0].filaments[0].calibration, undefined);
+});
+
+test('stored auto-paint profiles strip legacy photo calibration objects on load', async () => {
+    const { loadProfiles } = await loadProfileManager();
+    const existingStorage = Reflect.get(globalThis, 'localStorage') as
+        | ReturnType<typeof createMemoryStorage>
+        | undefined;
+    const storage = existingStorage ?? createMemoryStorage();
+    if (!existingStorage) {
+        Object.defineProperty(globalThis, 'localStorage', {
+            configurable: true,
+            value: storage,
+        });
+    }
+
+    const previousProfiles = storage.getItem('kromacut.autopaint.profiles');
+    storage.setItem(
+        'kromacut.autopaint.profiles',
+        JSON.stringify([
+            {
+                id: 'profile-stored',
+                name: 'Stored Legacy Profile',
+                version: 1,
+                createdAt: 1,
+                updatedAt: 1,
+                filaments: [
+                    {
+                        id: 'filament-stored',
+                        color: '#ffffff',
+                        td: 3.5,
+                        calibration: oldPhotoCalibration,
+                    },
+                ],
+            },
+        ])
+    );
+
+    try {
+        const loaded = loadProfiles();
+        assert.equal(loaded.length, 1);
+        assert.equal(loaded[0].filaments[0].calibration, undefined);
+    } finally {
+        if (previousProfiles === null) {
+            storage.removeItem('kromacut.autopaint.profiles');
+        } else {
+            storage.setItem('kromacut.autopaint.profiles', previousProfiles);
+        }
+        if (!existingStorage) Reflect.deleteProperty(globalThis, 'localStorage');
+    }
+});

From 8d0a2a76f98e192eadc175146262c0e7f02760fe Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 2 Jul 2026 11:09:08 +0300
Subject: [PATCH 41/81] Add multi-base color calibration

---
 CHANGELOG.md                                 |   2 +-
 src/components/FilamentCalibrationDialog.tsx | 624 ++++++++++++++-----
 src/docs/3d-mode.md                          |  16 +-
 src/lib/calibration.ts                       | 523 +++++++++++++++-
 tests/frontlitCalibration.test.ts            | 185 +++++-
 5 files changed, 1183 insertions(+), 167 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 29ed358..ac338f4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the single layer count at which each filament's patch first matches the rail. Kromacut converts that read into a frontlit Transmission Distance (scalar plus per-channel) using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 678fee1..fdda748 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -22,21 +22,30 @@ import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
 import { Card } from '@/components/ui/card';
 import {
-    Select,
-    SelectContent,
-    SelectItem,
-    SelectTrigger,
-    SelectValue,
-} from '@/components/ui/select';
-import { X, Download, Check, Minus, ArrowLeft, ArrowRight, FlaskConical } from 'lucide-react';
+    X,
+    Download,
+    Check,
+    Minus,
+    ArrowLeft,
+    ArrowRight,
+    FlaskConical,
+    AlertTriangle,
+} from 'lucide-react';
 import { cn } from '@/lib/utils';
 import type { Filament } from '../types';
 import {
     computeFrontlitCalibration,
+    computeFrontlitCalibrationSession,
+    deriveChannelTds,
     predictFrontlitColor,
+    predictOpacityLayersForTds,
+    sanitizeFrontlitCalibration,
+    solveOpacityTransmission,
     getConfidenceLabel,
     getConfidenceColor,
+    OPACITY_JND,
     type FrontlitCalibration,
+    type FrontlitCalibrationRead,
 } from '@/lib/calibration';
 import {
     generateCalibrationStl,
@@ -49,6 +58,7 @@ import {
 
 type Step = 'select' | 'base' | 'print' | 'measure';
 type PrintFormat = 'stl' | '3mf';
+type CalibrationMode = 'quick' | 'accurate';
 
 export interface CalibrationApplyUpdate {
     id: string;
@@ -68,6 +78,7 @@ interface FilamentCalibrationDialogProps {
 
 const MIN_MAX_LAYERS = 4;
 const MAX_MAX_LAYERS = 40;
+const MAX_BASES_PER_FILAMENT = 3;
 
 function filamentLabel(filament: Filament): string {
     return filament.name || filament.brand || `Filament ${filament.color}`;
@@ -86,6 +97,43 @@ function rgbCss(rgb: [number, number, number]): string {
     return `rgb(${rgb[0]}, ${rgb[1]}, ${rgb[2]})`;
 }
 
+function hexToRgbTuple(hex: string): [number, number, number] {
+    const h = hex.replace(/^#/, '');
+    return [
+        parseInt(h.slice(0, 2), 16) || 0,
+        parseInt(h.slice(2, 4), 16) || 0,
+        parseInt(h.slice(4, 6), 16) || 0,
+    ];
+}
+
+function readKey(filamentId: string, baseId: string): string {
+    return `${filamentId}::${baseId}`;
+}
+
+function parseLayerInput(value: string | undefined): number | null {
+    const parsed = Number.parseInt(value ?? '', 10);
+    return Number.isFinite(parsed) && parsed >= 1 ? parsed : null;
+}
+
+function governingChannel(
+    filamentColor: string,
+    baseColor: string,
+    td: [number, number, number]
+): number {
+    const filament = hexToRgbTuple(filamentColor);
+    const base = hexToRgbTuple(baseColor);
+    let best = 0;
+    let bestScore = -Infinity;
+    for (let channel = 0; channel < 3; channel++) {
+        const score = Math.abs(filament[channel] - base[channel]) * td[channel];
+        if (score > bestScore) {
+            best = channel;
+            bestScore = score;
+        }
+    }
+    return best;
+}
+
 function downloadBlob(blob: Blob, filename: string) {
     const url = URL.createObjectURL(blob);
     const a = document.createElement('a');
@@ -126,9 +174,12 @@ export function FilamentCalibrationDialog({
     );
     const [layerHeightDraft, setLayerHeightDraft] = useState(() => String(layerHeight));
     const [format, setFormat] = useState<PrintFormat>('stl');
+    const [mode, setMode] = useState<CalibrationMode>('quick');
     const [reads, setReads] = useState<Record<string, string>>({});
-    // filament id -> chosen base filament id (defaults to the darkest filament).
-    const [baseChoices, setBaseChoices] = useState<Record<string, string>>({});
+    const [mergeReads, setMergeReads] = useState<Record<string, string>>({});
+    const [isSaving, setIsSaving] = useState(false);
+    // filament id -> chosen base filament ids (defaults are auto-picked).
+    const [baseChoices, setBaseChoices] = useState<Record<string, string[]>>({});
     const wasOpenRef = useRef(open);
 
     const darkestFilamentId = useMemo(() => {
@@ -138,35 +189,130 @@ export function FilamentCalibrationDialog({
         ).id;
     }, [filaments]);
 
+    const lightestFilamentId = useMemo(() => {
+        if (filaments.length === 0) return undefined;
+        return filaments.reduce((lightest, f) =>
+            luminance(f.color) > luminance(lightest.color) ? f : lightest
+        ).id;
+    }, [filaments]);
+
     const filamentById = useMemo(
         () => new Map(filaments.map((filament) => [filament.id, filament])),
         [filaments]
     );
 
-    const resolveBaseId = useCallback(
-        (filamentId: string): string => baseChoices[filamentId] ?? darkestFilamentId ?? filamentId,
-        [baseChoices, darkestFilamentId]
-    );
+    const estimateChannelTds = useCallback((filament: Filament): [number, number, number] => {
+        const calibration = sanitizeFrontlitCalibration(filament.calibration);
+        if (calibration) return calibration.td;
+        return deriveChannelTds(filament.color, Math.max(0.05, filament.td * 0.1));
+    }, []);
+
+    const recommendedBaseIds = useCallback(
+        (filament: Filament): string[] => {
+            const targetCount = mode === 'accurate' ? 2 : 1;
+            const td = estimateChannelTds(filament);
+            const candidates = filaments
+                .map((base) => {
+                    if (!solveOpacityTransmission(filament.color, OPACITY_JND, base.color)) {
+                        return null;
+                    }
+                    const predicted = predictOpacityLayersForTds(
+                        filament.color,
+                        td,
+                        calibrationLayerHeight,
+                        OPACITY_JND,
+                        base.color,
+                        maxLayers
+                    );
+                    if (predicted === undefined) return null;
+                    const useful = predicted > 1 && predicted <= maxLayers;
+                    return {
+                        base,
+                        predicted,
+                        useful,
+                        channel: governingChannel(filament.color, base.color, td),
+                    };
+                })
+                .filter(
+                    (candidate): candidate is NonNullable<typeof candidate> => candidate !== null
+                );
 
-    const resolveBaseColor = useCallback(
-        (filamentId: string): string => {
-            const base = filamentById.get(resolveBaseId(filamentId));
-            return base?.color ?? '#000000';
+            const useful = candidates.filter((candidate) => candidate.useful);
+            const pool = useful.length > 0 ? useful : candidates;
+            if (pool.length === 0) {
+                return [lightestFilamentId ?? darkestFilamentId ?? filament.id];
+            }
+
+            const selected: typeof pool = [];
+            const anchor =
+                pool.find((candidate) => candidate.base.id === darkestFilamentId) ??
+                [...pool].sort((a, b) => luminance(a.base.color) - luminance(b.base.color))[0];
+            selected.push(anchor);
+
+            while (selected.length < targetCount && selected.length < pool.length) {
+                const covered = new Set(selected.map((candidate) => candidate.channel));
+                const next = pool
+                    .filter(
+                        (candidate) => !selected.some((item) => item.base.id === candidate.base.id)
+                    )
+                    .sort((a, b) => {
+                        const aDiversity = covered.has(a.channel) ? 0 : 1;
+                        const bDiversity = covered.has(b.channel) ? 0 : 1;
+                        const aMidness =
+                            1 - Math.abs(a.predicted - maxLayers / 2) / Math.max(1, maxLayers / 2);
+                        const bMidness =
+                            1 - Math.abs(b.predicted - maxLayers / 2) / Math.max(1, maxLayers / 2);
+                        return bDiversity * 10 + bMidness - (aDiversity * 10 + aMidness);
+                    })[0];
+                if (!next) break;
+                selected.push(next);
+            }
+
+            return selected.map((candidate) => candidate.base.id);
         },
-        [filamentById, resolveBaseId]
+        [
+            calibrationLayerHeight,
+            darkestFilamentId,
+            estimateChannelTds,
+            filaments,
+            lightestFilamentId,
+            maxLayers,
+            mode,
+        ]
     );
 
-    const resolveBaseLabel = useCallback(
-        (filamentId: string): string => {
-            const base = filamentById.get(resolveBaseId(filamentId));
-            return base ? filamentLabel(base) : 'Base';
+    const resolveBaseIds = useCallback(
+        (filamentId: string): string[] => {
+            const filament = filamentById.get(filamentId);
+            if (!filament) return [];
+            const explicit = baseChoices[filamentId]?.filter((id) => filamentById.has(id));
+            if (explicit && explicit.length > 0) return explicit;
+            return recommendedBaseIds(filament).filter((id) => filamentById.has(id));
         },
-        [filamentById, resolveBaseId]
+        [baseChoices, filamentById, recommendedBaseIds]
     );
 
-    const setBaseChoice = useCallback((filamentId: string, baseId: string) => {
-        setBaseChoices((prev) => ({ ...prev, [filamentId]: baseId }));
-    }, []);
+    const toggleBaseChoice = useCallback(
+        (filamentId: string, baseId: string) => {
+            const current = resolveBaseIds(filamentId);
+            if (mode === 'quick') {
+                setBaseChoices((prev) => ({ ...prev, [filamentId]: [baseId] }));
+                return;
+            }
+
+            let next: string[];
+            if (current.includes(baseId)) {
+                next = current.length > 1 ? current.filter((id) => id !== baseId) : current;
+            } else {
+                next =
+                    current.length >= MAX_BASES_PER_FILAMENT
+                        ? [...current.slice(1), baseId]
+                        : [...current, baseId];
+            }
+            setBaseChoices((prev) => ({ ...prev, [filamentId]: next }));
+        },
+        [mode, resolveBaseIds]
+    );
 
     const commitLayerHeight = useCallback(() => {
         const parsed = Number(layerHeightDraft);
@@ -192,6 +338,22 @@ export function FilamentCalibrationDialog({
         [filaments, selectedIds]
     );
 
+    const calibrationTargets = useMemo(() => {
+        return selectedFilaments.flatMap((filament) =>
+            resolveBaseIds(filament.id)
+                .map((baseId) => {
+                    const base = filamentById.get(baseId);
+                    if (!base) return null;
+                    return {
+                        key: readKey(filament.id, base.id),
+                        filament,
+                        base,
+                    };
+                })
+                .filter((target): target is NonNullable<typeof target> => target !== null)
+        );
+    }, [filamentById, resolveBaseIds, selectedFilaments]);
+
     const printOptions = useMemo<CalibrationPrintOptions>(
         () => ({
             ...DEFAULT_CALIBRATION_PRINT_OPTIONS,
@@ -212,7 +374,10 @@ export function FilamentCalibrationDialog({
         setCalibrationLayerHeight(layerHeight);
         setLayerHeightDraft(String(layerHeight));
         setFormat('stl');
+        setMode('quick');
         setReads({});
+        setMergeReads({});
+        setIsSaving(false);
         setBaseChoices({});
     }, [initialSelection, layerHeight]);
 
@@ -242,12 +407,12 @@ export function FilamentCalibrationDialog({
     }, [filaments]);
 
     const handleDownload = useCallback(async () => {
-        const tiles: CalibrationTile[] = selectedFilaments.map((f) => ({
-            filamentId: f.id,
-            color: f.color,
-            baseFilamentId: resolveBaseId(f.id),
-            baseColor: resolveBaseColor(f.id),
-            name: filamentLabel(f),
+        const tiles: CalibrationTile[] = calibrationTargets.map(({ filament, base }) => ({
+            filamentId: filament.id,
+            color: filament.color,
+            baseFilamentId: base.id,
+            baseColor: base.color,
+            name: `${filamentLabel(filament)} over ${filamentLabel(base)}`,
         }));
         if (tiles.length === 0) return;
 
@@ -264,58 +429,116 @@ export function FilamentCalibrationDialog({
                 name: filamentLabel(f),
             }));
             const blob = await generateCalibration3mf(tiles, printOptions, profileFilaments);
-            downloadBlob(blob, `kromacut-calibration-${tiles.length}filaments.3mf`);
+            downloadBlob(blob, `kromacut-calibration-${tiles.length}reads.3mf`);
         }
-    }, [selectedFilaments, filaments, format, printOptions, maxLayers, resolveBaseId, resolveBaseColor]);
+    }, [calibrationTargets, filaments, format, printOptions, maxLayers]);
 
-    const setRead = useCallback((id: string, value: string) => {
-        setReads((prev) => ({ ...prev, [id]: value }));
+    const setRead = useCallback((key: string, value: string) => {
+        setReads((prev) => ({ ...prev, [key]: value }));
+    }, []);
+
+    const setMergeRead = useCallback((key: string, value: string) => {
+        setMergeReads((prev) => ({ ...prev, [key]: value }));
     }, []);
 
     // Per-filament calibration computed live from the entered reads.
     const computed = useMemo(() => {
-        return selectedFilaments.map((filament) => {
-            const raw = reads[filament.id];
-            const opacityLayers = Number.parseInt(raw ?? '', 10);
-            if (!Number.isFinite(opacityLayers) || opacityLayers < 1) {
-                return { filament, result: null, opacityLayers: null };
+        const entries = selectedFilaments.map((filament) => {
+            const targets = calibrationTargets.filter(
+                (target) => target.filament.id === filament.id
+            );
+            const readValues: FrontlitCalibrationRead[] = [];
+            let complete = targets.length > 0;
+            for (const target of targets) {
+                const opacityLayers = parseLayerInput(reads[target.key]);
+                if (opacityLayers === null) {
+                    complete = false;
+                    continue;
+                }
+                readValues.push({
+                    baseColor: target.base.color,
+                    opacityLayers,
+                });
             }
-            const result = computeFrontlitCalibration({
-                filamentColor: filament.color,
-                opacityLayers,
-                layerHeight: calibrationLayerHeight,
-                firstLayerHeight,
-                baseColor: resolveBaseColor(filament.id),
-                maxLayers,
-            });
-            return { filament, result, opacityLayers };
+            const input = complete
+                ? {
+                      filamentColor: filament.color,
+                      opacityLayers: readValues[0]?.opacityLayers,
+                      layerHeight: calibrationLayerHeight,
+                      firstLayerHeight,
+                      baseColor: readValues[0]?.baseColor,
+                      reads: readValues,
+                      maxLayers,
+                  }
+                : null;
+            return {
+                filament,
+                targets,
+                input,
+                result: input ? computeFrontlitCalibration(input) : null,
+                jndSource: null as 'default' | 'session-fit' | null,
+            };
         });
+        return entries;
     }, [
         selectedFilaments,
+        calibrationTargets,
         reads,
         calibrationLayerHeight,
         firstLayerHeight,
         maxLayers,
-        resolveBaseColor,
     ]);
 
     const allReadsValid =
         computed.length > 0 && computed.every((c) => c.result !== null && c.result.ok);
 
     const handleSave = useCallback(() => {
-        const updates: CalibrationApplyUpdate[] = [];
-        for (const entry of computed) {
-            if (entry.result && entry.result.ok) {
-                updates.push({
-                    id: entry.filament.id,
-                    td: entry.result.calibration.tdSingleValue,
-                    calibration: entry.result.calibration,
-                });
-            }
-        }
-        if (updates.length > 0) onApply(updates);
-        handleClose();
-    }, [computed, onApply, handleClose]);
+        if (isSaving) return;
+        setIsSaving(true);
+        const saveEntries = computed.filter((entry) => entry.input && entry.result?.ok);
+        window.requestAnimationFrame(() => {
+            window.setTimeout(() => {
+                try {
+                    const session = computeFrontlitCalibrationSession({
+                        filaments: saveEntries.map((entry) => {
+                            const readsWithMerge: FrontlitCalibrationRead[] = entry.targets.map(
+                                (target) => {
+                                    const opacityLayers = parseLayerInput(reads[target.key])!;
+                                    const mergeLayers = parseLayerInput(mergeReads[target.key]);
+                                    return {
+                                        baseColor: target.base.color,
+                                        opacityLayers,
+                                        mergeLayers: mergeLayers ?? undefined,
+                                    };
+                                }
+                            );
+                            return {
+                                ...entry.input!,
+                                reads: readsWithMerge,
+                                opacityLayers: readsWithMerge[0]?.opacityLayers,
+                                baseColor: readsWithMerge[0]?.baseColor,
+                            };
+                        }),
+                        maxLayers,
+                    });
+                    const updates: CalibrationApplyUpdate[] = [];
+                    session.results.forEach((result, index) => {
+                        if (!result.ok) return;
+                        const entry = saveEntries[index];
+                        updates.push({
+                            id: entry.filament.id,
+                            td: result.calibration.tdSingleValue,
+                            calibration: result.calibration,
+                        });
+                    });
+                    if (updates.length > 0) onApply(updates);
+                    handleClose();
+                } finally {
+                    setIsSaving(false);
+                }
+            });
+        });
+    }, [computed, reads, mergeReads, maxLayers, onApply, handleClose, isSaving]);
 
     const renderSelect = () => (
         <>
@@ -421,48 +644,85 @@ export function FilamentCalibrationDialog({
             </AlertDialogHeader>
             <div className="space-y-4">
                 <p className="text-sm text-muted-foreground">
-                    Each filament is calibrated over a base, defaulting to your darkest filament. A
-                    dark filament needs a lighter base (e.g. white) to read against — change its base
-                    here.
+                    Quick mode uses one base per filament. Accurate mode repeats the same read over
+                    multiple bases so Kromacut can measure RGB TDs directly.
                 </p>
+                <div className="grid grid-cols-2 gap-2">
+                    <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => {
+                            setMode('quick');
+                            setBaseChoices({});
+                        }}
+                        className={cn(mode === 'quick' && 'border-primary/60 bg-primary/5')}
+                    >
+                        Quick
+                    </Button>
+                    <Button
+                        variant="outline"
+                        size="sm"
+                        onClick={() => {
+                            setMode('accurate');
+                            setBaseChoices({});
+                        }}
+                        className={cn(mode === 'accurate' && 'border-primary/60 bg-primary/5')}
+                    >
+                        Accurate
+                    </Button>
+                </div>
                 <div className="max-h-[24rem] space-y-2 overflow-y-auto pr-1">
                     {selectedFilaments.map((filament) => {
-                        const baseId = baseChoices[filament.id] ?? darkestFilamentId ?? '';
+                        const baseIds = resolveBaseIds(filament.id);
                         return (
-                            <Card key={filament.id} className="flex items-center gap-3 p-3">
-                                <span
-                                    className="h-7 w-7 flex-none rounded-lg border border-border/70 shadow-inner"
-                                    style={{ backgroundColor: filament.color }}
-                                />
-                                <div className="min-w-0 flex-1">
-                                    <div className="truncate text-sm font-medium text-foreground">
-                                        {filamentLabel(filament)}
+                            <Card key={filament.id} className="space-y-3 p-3">
+                                <div className="flex items-center gap-3">
+                                    <span
+                                        className="h-7 w-7 flex-none rounded-lg border border-border/70 shadow-inner"
+                                        style={{ backgroundColor: filament.color }}
+                                    />
+                                    <div className="min-w-0 flex-1">
+                                        <div className="truncate text-sm font-medium text-foreground">
+                                            {filamentLabel(filament)}
+                                        </div>
+                                        <div className="text-[11px] text-muted-foreground">
+                                            {mode === 'accurate'
+                                                ? `${baseIds.length} base reads selected`
+                                                : '1 base read selected'}
+                                        </div>
                                     </div>
-                                    <div className="text-[11px] text-muted-foreground">over base</div>
                                 </div>
-                                <Select
-                                    value={baseId}
-                                    onValueChange={(v) => setBaseChoice(filament.id, v)}
-                                >
-                                    <SelectTrigger className="h-9 w-48">
-                                        <SelectValue placeholder="Base filament" />
-                                    </SelectTrigger>
-                                    <SelectContent>
-                                        {filaments.map((bf) => (
-                                            <SelectItem key={bf.id} value={bf.id}>
-                                                <span className="flex items-center gap-2">
-                                                    <span
-                                                        className="h-4 w-4 flex-none rounded border border-border/70"
-                                                        style={{ backgroundColor: bf.color }}
-                                                    />
-                                                    <span className="truncate">
-                                                        {filamentLabel(bf)}
-                                                    </span>
+                                <div className="grid grid-cols-2 gap-1.5 sm:grid-cols-3">
+                                    {filaments.map((base) => {
+                                        const selected = baseIds.includes(base.id);
+                                        return (
+                                            <button
+                                                key={base.id}
+                                                type="button"
+                                                onClick={() =>
+                                                    toggleBaseChoice(filament.id, base.id)
+                                                }
+                                                className={cn(
+                                                    'flex min-w-0 items-center gap-2 rounded-md border px-2 py-1.5 text-left text-xs transition-colors',
+                                                    selected
+                                                        ? 'border-primary/60 bg-primary/5 text-foreground'
+                                                        : 'border-border/60 bg-background hover:border-border'
+                                                )}
+                                            >
+                                                <span
+                                                    className="h-4 w-4 flex-none rounded border border-border/70"
+                                                    style={{ backgroundColor: base.color }}
+                                                />
+                                                <span className="min-w-0 flex-1 truncate">
+                                                    {filamentLabel(base)}
                                                 </span>
-                                            </SelectItem>
-                                        ))}
-                                    </SelectContent>
-                                </Select>
+                                                {selected && (
+                                                    <Check className="h-3.5 w-3.5 flex-none" />
+                                                )}
+                                            </button>
+                                        );
+                                    })}
+                                </div>
                             </Card>
                         );
                     })}
@@ -552,8 +812,8 @@ export function FilamentCalibrationDialog({
                         </div>
                         <p className="text-[11px] text-muted-foreground">
                             {format === 'stl'
-                                ? 'Single solid. Print one copy per selected filament using the matching base and swap line below.'
-                                : 'Colors + bases baked in for AMS / multi-material — all selected filaments in one print.'}
+                                ? 'Single solid. Print one copy for each filament/base read using the matching swap line below.'
+                                : 'Colors + bases baked in for AMS / multi-material - all selected reads in one print.'}
                         </p>
                     </div>
 
@@ -564,9 +824,9 @@ export function FilamentCalibrationDialog({
                                 layer {formatMm(firstLayerPrintHeight)}.
                             </p>
                             <div className="max-h-32 space-y-1 overflow-y-auto pr-1">
-                                {selectedFilaments.map((filament) => (
+                                {calibrationTargets.map(({ key, filament, base }) => (
                                     <div
-                                        key={filament.id}
+                                        key={key}
                                         className="flex items-start gap-2 text-foreground"
                                     >
                                         <span
@@ -576,9 +836,9 @@ export function FilamentCalibrationDialog({
                                         <span className="min-w-0">
                                             <span className="font-medium">
                                                 {filamentLabel(filament)}
-                                            </span>
-                                            : base = {resolveBaseLabel(filament.id)}, swap after
-                                            layer {printOptions.baseLayers} / Z {formatMm(swapZ)}.
+                                            </span>{' '}
+                                            over {filamentLabel(base)}: swap after layer{' '}
+                                            {printOptions.baseLayers} / Z {formatMm(swapZ)}.
                                         </span>
                                     </div>
                                 ))}
@@ -601,8 +861,9 @@ export function FilamentCalibrationDialog({
                             opaque reference rail running along the back edge.
                         </li>
                         <li>
-                            Find the <span className="font-medium text-foreground">first patch</span>{' '}
-                            that looks identical to the rail beside it — that&apos;s its opacity layer.
+                            Find the{' '}
+                            <span className="font-medium text-foreground">first patch</span> that
+                            looks identical to the rail beside it — that&apos;s its opacity layer.
                         </li>
                     </ul>
                 </Card>
@@ -627,22 +888,12 @@ export function FilamentCalibrationDialog({
             </AlertDialogHeader>
             <div className="space-y-3">
                 <p className="text-sm text-muted-foreground">
-                    For each filament, enter the first patch number that matched its reference rail.
+                    Enter the first patch number that matched the rail for each filament/base print.
                 </p>
                 <div className="max-h-[26rem] space-y-2.5 overflow-y-auto pr-1">
-                    {computed.map(({ filament, result, opacityLayers }) => {
+                    {computed.map(({ filament, targets, result, jndSource }) => {
                         const calibration = result && result.ok ? result.calibration : null;
                         const errorText = result && !result.ok ? result.error : null;
-                        const predicted =
-                            calibration && opacityLayers
-                                ? predictFrontlitColor(
-                                      filament.color,
-                                      opacityLayers,
-                                      calibrationLayerHeight,
-                                      calibration.td,
-                                      resolveBaseColor(filament.id)
-                                  )
-                                : null;
                         return (
                             <Card key={filament.id} className="p-3">
                                 <div className="flex items-center gap-3">
@@ -658,40 +909,127 @@ export function FilamentCalibrationDialog({
                                             {filament.color}
                                         </div>
                                     </div>
-                                    <div className="flex items-center gap-1.5">
-                                        <Input
-                                            type="number"
-                                            min={1}
-                                            max={maxLayers}
-                                            value={reads[filament.id] ?? ''}
-                                            onChange={(e) => setRead(filament.id, e.target.value)}
-                                            placeholder="layer"
-                                            className="h-8 w-20 text-sm"
-                                        />
-                                        <span className="text-[11px] text-muted-foreground">
-                                            / {maxLayers}
-                                        </span>
+                                    <div className="text-right text-[11px] text-muted-foreground">
+                                        {targets.length} read{targets.length === 1 ? '' : 's'}
                                     </div>
                                 </div>
 
+                                <div className="mt-3 space-y-2">
+                                    <div className="hidden grid-cols-[1fr_auto_auto] gap-2 px-2 text-[10px] font-medium uppercase tracking-wide text-muted-foreground sm:grid">
+                                        <span>Base</span>
+                                        <span className="w-[6.5rem]">Match</span>
+                                        <span className="w-[6.5rem]">Merge</span>
+                                    </div>
+                                    {targets.map((target) => {
+                                        const opacityLayers = parseLayerInput(reads[target.key]);
+                                        const mergeLayers = parseLayerInput(mergeReads[target.key]);
+                                        const mergeAfterMatch =
+                                            mergeLayers !== null &&
+                                            opacityLayers !== null &&
+                                            mergeLayers > opacityLayers;
+                                        const predicted =
+                                            calibration && opacityLayers
+                                                ? predictFrontlitColor(
+                                                      filament.color,
+                                                      opacityLayers,
+                                                      calibrationLayerHeight,
+                                                      calibration.td,
+                                                      target.base.color
+                                                  )
+                                                : null;
+                                        return (
+                                            <div
+                                                key={target.key}
+                                                className="grid gap-2 rounded-md border border-border/50 bg-background/70 p-2 sm:grid-cols-[1fr_auto_auto]"
+                                            >
+                                                <div className="flex min-w-0 items-center gap-2">
+                                                    <span
+                                                        className="h-5 w-5 flex-none rounded border border-border/70"
+                                                        style={{
+                                                            backgroundColor: target.base.color,
+                                                        }}
+                                                        title="Base"
+                                                    />
+                                                    <span className="min-w-0 truncate text-xs">
+                                                        over {filamentLabel(target.base)}
+                                                    </span>
+                                                </div>
+                                                <div className="flex items-center gap-1.5">
+                                                    <Input
+                                                        type="number"
+                                                        min={1}
+                                                        max={maxLayers}
+                                                        value={reads[target.key] ?? ''}
+                                                        onChange={(e) =>
+                                                            setRead(target.key, e.target.value)
+                                                        }
+                                                        placeholder="match"
+                                                        title="First patch that matches the reference rail"
+                                                        className="h-8 w-20 text-sm"
+                                                    />
+                                                    <span className="text-[11px] text-muted-foreground">
+                                                        / {maxLayers}
+                                                    </span>
+                                                </div>
+                                                <div className="flex items-center gap-1.5">
+                                                    <Input
+                                                        type="number"
+                                                        min={1}
+                                                        max={maxLayers}
+                                                        value={mergeReads[target.key] ?? ''}
+                                                        onChange={(e) =>
+                                                            setMergeRead(target.key, e.target.value)
+                                                        }
+                                                        placeholder="merge"
+                                                        title="Optional: last patch that still looks different from the patch before it"
+                                                        className={cn(
+                                                            'h-8 w-20 text-sm',
+                                                            mergeAfterMatch &&
+                                                                'border-amber-500/70 bg-amber-500/10'
+                                                        )}
+                                                    />
+                                                    {mergeAfterMatch && (
+                                                        <span
+                                                            title="Merge read is usually before or equal to the rail-match read"
+                                                            aria-label="Merge read is later than match read"
+                                                        >
+                                                            <AlertTriangle className="h-3.5 w-3.5 flex-none text-amber-600" />
+                                                        </span>
+                                                    )}
+                                                    {predicted && (
+                                                        <span
+                                                            className="h-6 w-6 rounded border border-border/70"
+                                                            style={{
+                                                                backgroundColor: rgbCss(predicted),
+                                                            }}
+                                                            title="Predicted at this read"
+                                                        />
+                                                    )}
+                                                </div>
+                                            </div>
+                                        );
+                                    })}
+                                </div>
+
                                 {calibration && (
                                     <div className="mt-2.5 flex items-center justify-between gap-3 rounded-lg border border-border/50 bg-muted/20 px-3 py-2">
                                         <div className="flex items-center gap-2">
                                             <span className="text-[11px] text-muted-foreground">
-                                                Match
+                                                Fit
                                             </span>
                                             <span
                                                 className="h-6 w-6 rounded border border-border/70"
                                                 style={{ backgroundColor: filament.color }}
                                                 title="Reference (opaque)"
                                             />
-                                            {predicted && (
-                                                <span
-                                                    className="h-6 w-6 rounded border border-border/70"
-                                                    style={{ backgroundColor: rgbCss(predicted) }}
-                                                    title="Predicted at this layer"
-                                                />
-                                            )}
+                                            <span className="text-[11px] text-muted-foreground">
+                                                {calibration.channelSource === 'measured'
+                                                    ? 'measured RGB TDs'
+                                                    : 'heuristic RGB TDs'}
+                                                {jndSource === 'session-fit'
+                                                    ? ' / session JND'
+                                                    : ''}
+                                            </span>
                                         </div>
                                         <div className="text-right text-xs">
                                             <div className="font-semibold">
@@ -724,9 +1062,9 @@ export function FilamentCalibrationDialog({
                     <ArrowLeft className="mr-1 h-4 w-4" />
                     Back
                 </Button>
-                <Button onClick={handleSave} disabled={!allReadsValid}>
+                <Button onClick={handleSave} disabled={!allReadsValid || isSaving}>
                     <Check className="mr-1 h-4 w-4" />
-                    Save Calibration
+                    {isSaving ? 'Fitting...' : 'Save Calibration'}
                 </Button>
             </AlertDialogFooter>
         </>
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index ab20b0c..b479393 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -46,12 +46,12 @@ Use the wand button to auto-estimate TD from color, or calibrate to measure TD f
 
 ## Calibrating Filament TD
 
-Calibration is camera-free: you print a small wedge and read back a single number. Click the calibration button on a filament row, or **Calibrate Filaments** below the filament list, to open the dialog. It has four steps:
+Calibration is camera-free: you print a small wedge and read back one or more opacity numbers. Click the calibration button on a filament row, or **Calibrate Filaments** below the filament list, to open the dialog. It has four steps:
 
 1. **Select** the filaments you want to calibrate.
-2. **Base layers** — choose the base filament each one prints over. It defaults to your darkest filament (matching how frontlit prints are viewed), and the base comes from your real profile filaments, so no extra "phantom" filament is added to the print. A dark filament has too little contrast with a dark base, so switch its base to a lighter one (e.g. white) here.
-3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). For STL, use the shown layer height and first-layer height, print one copy per selected filament, load the listed base filament, then swap after the shown layer/Z height to the filament being calibrated. Each filament prints as a row of patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
-4. **Enter Results** by reporting, for each filament, the **first patch that looks identical to the reference rail** beside it — that is its opacity layer. Kromacut converts that number into a frontlit TD (with per-channel values), shows a predicted-vs-reference swatch, the TD, and a confidence rating. Click **Save Calibration** to apply it.
+2. **Base layers** - choose **Quick** for one base read, or **Accurate** for two or three base reads per filament. Kromacut auto-picks useful bases from your real profile filaments, and you can override them with the base swatches.
+3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). For STL, use the shown layer height and first-layer height, print one copy for each filament/base read, load the listed base filament, then swap after the shown layer/Z height to the filament being calibrated. Each print has patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
+4. **Enter Results** by reporting, for each filament/base row, the **first patch that looks identical to the reference rail** beside it. Kromacut uses one read for quick scalar calibration, or combines multi-base reads to measure per-channel TDs and, when the session has enough data, fit the shared JND. The optional merge field records where adjacent steps stop looking different; it is stored as model-checking evidence and does not block saving.
 
 Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured TD is a material property, so it transfers to your real prints regardless of which base you calibrated against.
 
@@ -107,10 +107,10 @@ Flat Paint and **Smooth Meshing** are mutually exclusive. Turning one on turns t
 
 ## Optimizer Settings
 
-| Setting         | Meaning                                                      |
-| --------------- | ------------------------------------------------------------ |
-| Algorithm       | Fast, Balanced, Thorough, Deep, or Exact base order.        |
-| Region priority | Uniform, Center-weighted, or Edge-weighted matching.         |
+| Setting         | Meaning                                                            |
+| --------------- | ------------------------------------------------------------------ |
+| Algorithm       | Fast, Balanced, Thorough, Deep, or Exact base order.               |
+| Region priority | Uniform, Center-weighted, or Edge-weighted matching.               |
 | Seed (optional) | Overrides the automatic stable seed for an intentional comparison. |
 
 Start with **Balanced**. It uses a full deterministic beam search and is the best
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index b674a2c..ace74bf 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -23,6 +23,13 @@ import { deltaE2000 } from './colorDifference';
 
 export type CalibrationRgb = [number, number, number];
 
+export interface FrontlitCalibrationRead {
+    baseColor: string;
+    opacityLayers: number;
+    /** Optional adjacent-step merge point, stored as model-form evidence. */
+    mergeLayers?: number;
+}
+
 export interface FrontlitCalibration {
     /** Layer count at which the wedge first matched the opaque reference. */
     opacityLayers: number;
@@ -44,6 +51,12 @@ export interface FrontlitCalibration {
     basis: 'frontlit';
     /** ISO timestamp. */
     calibrationDate: string;
+    /** All opacity reads used by a multi-base fit. Absent means Phase-1 single read. */
+    reads?: FrontlitCalibrationRead[];
+    /** Whether RGB TD ratios came from the color heuristic or a multi-base fit. */
+    channelSource?: 'heuristic' | 'measured';
+    /** Whether the JND was the default constant or fitted across the session. */
+    jndSource?: 'default' | 'session-fit';
     notes?: string;
 }
 
@@ -53,17 +66,33 @@ export type FrontlitCalibrationResult =
 
 export interface FrontlitCalibrationInput {
     filamentColor: string;
-    opacityLayers: number;
+    opacityLayers?: number;
     layerHeight: number;
     firstLayerHeight: number;
     /** Base color the wedge prints over (hex). Defaults to black. */
     baseColor?: string;
+    /** Multi-base reads for the same filament. The first read is the compatibility anchor. */
+    reads?: FrontlitCalibrationRead[];
     /** Highest layer count printed on the wedge; used to flag clipped reads. */
     maxLayers?: number;
     jnd?: number;
+    jndSource?: 'default' | 'session-fit';
     notes?: string;
 }
 
+export interface FrontlitCalibrationSessionInput {
+    filaments: FrontlitCalibrationInput[];
+    /** Highest layer count printed on the wedge; used for JND fit bounds and confidence. */
+    maxLayers?: number;
+}
+
+export interface FrontlitCalibrationSessionResult {
+    jnd: number;
+    jndSource: 'default' | 'session-fit';
+    results: FrontlitCalibrationResult[];
+    residual: number;
+}
+
 // ============================================================================
 // Constants
 // ============================================================================
@@ -83,6 +112,9 @@ export const OPACITY_JND = 2.0;
 
 const FRONTLIT_TD_MIN = 0.05;
 const FRONTLIT_TD_MAX = 12.0;
+const JND_FIT_MIN = 1.0;
+const JND_FIT_MAX = 3.0;
+const DEFAULT_PREDICT_MAX_LAYERS = 240;
 
 const CONFIDENCE_THRESHOLD_EXCELLENT = 0.9;
 const CONFIDENCE_THRESHOLD_GOOD = 0.7;
@@ -99,6 +131,8 @@ function hexToRgb(hex: string): CalibrationRgb | null {
 const isFinitePositive = (value: unknown): value is number =>
     typeof value === 'number' && Number.isFinite(value) && value > 0;
 
+type ReadResidualMode = 'interval' | 'center';
+
 function sanitizeCalibrationRgb(value: unknown): CalibrationRgb | undefined {
     if (!Array.isArray(value) || value.length !== 3) return undefined;
     const [r, g, b] = value;
@@ -106,6 +140,35 @@ function sanitizeCalibrationRgb(value: unknown): CalibrationRgb | undefined {
     return [r, g, b];
 }
 
+function sanitizeCalibrationRead(value: unknown): FrontlitCalibrationRead | undefined {
+    if (!value || typeof value !== 'object') return undefined;
+    const candidate = value as Record<string, unknown>;
+    if (
+        typeof candidate.baseColor !== 'string' ||
+        !hexToRgb(candidate.baseColor) ||
+        typeof candidate.opacityLayers !== 'number' ||
+        !Number.isFinite(candidate.opacityLayers) ||
+        candidate.opacityLayers < 1
+    ) {
+        return undefined;
+    }
+    const read: FrontlitCalibrationRead = {
+        baseColor: candidate.baseColor,
+        opacityLayers: candidate.opacityLayers,
+    };
+    if (candidate.mergeLayers !== undefined) {
+        if (
+            typeof candidate.mergeLayers !== 'number' ||
+            !Number.isFinite(candidate.mergeLayers) ||
+            candidate.mergeLayers < 1
+        ) {
+            return undefined;
+        }
+        read.mergeLayers = candidate.mergeLayers;
+    }
+    return read;
+}
+
 /**
  * Accept only the camera-free frontlit calibration shape. Older backlit photo
  * calibrations are intentionally stripped on load rather than migrated.
@@ -153,6 +216,23 @@ export function sanitizeFrontlitCalibration(value: unknown): FrontlitCalibration
         basis: 'frontlit',
         calibrationDate: candidate.calibrationDate,
     };
+    if (candidate.reads !== undefined) {
+        if (!Array.isArray(candidate.reads)) return undefined;
+        const reads = candidate.reads.map(sanitizeCalibrationRead);
+        if (reads.some((read) => !read)) return undefined;
+        sanitized.reads = reads as FrontlitCalibrationRead[];
+        if (sanitized.reads.length === 0) return undefined;
+    }
+    if (candidate.channelSource === 'heuristic' || candidate.channelSource === 'measured') {
+        sanitized.channelSource = candidate.channelSource;
+    } else if (candidate.channelSource !== undefined) {
+        return undefined;
+    }
+    if (candidate.jndSource === 'default' || candidate.jndSource === 'session-fit') {
+        sanitized.jndSource = candidate.jndSource;
+    } else if (candidate.jndSource !== undefined) {
+        return undefined;
+    }
     if (typeof candidate.notes === 'string') sanitized.notes = candidate.notes;
     return sanitized;
 }
@@ -173,6 +253,219 @@ function blendOverBase(
     ];
 }
 
+function blendOverBaseWithTds(
+    filamentRgb: CalibrationRgb,
+    td: CalibrationRgb,
+    thickness: number,
+    base: CalibrationRgb
+): CalibrationRgb {
+    return [0, 1, 2].map((channel) => {
+        const transmission = Math.pow(10, -thickness / td[channel]);
+        return blendSrgbChannel(base[channel], filamentRgb[channel], transmission);
+    }) as CalibrationRgb;
+}
+
+function opacityLayerThreshold(
+    filamentRgb: CalibrationRgb,
+    td: CalibrationRgb,
+    layerHeight: number,
+    jnd: number,
+    base: CalibrationRgb,
+    maxLayers = DEFAULT_PREDICT_MAX_LAYERS
+): number | undefined {
+    const deltaAt = (thickness: number) =>
+        deltaE2000(blendOverBaseWithTds(filamentRgb, td, thickness, base), filamentRgb);
+
+    if (deltaAt(0) < jnd) return undefined;
+
+    let hi = Math.max(layerHeight, maxLayers * layerHeight);
+    let guard = 0;
+    while (deltaAt(hi) > jnd && guard < 8) {
+        hi *= 1.8;
+        guard++;
+    }
+    if (deltaAt(hi) > jnd) return maxLayers + 1;
+
+    let lo = 0;
+    for (let i = 0; i < 36; i++) {
+        const mid = (lo + hi) / 2;
+        if (deltaAt(mid) > jnd) lo = mid;
+        else hi = mid;
+    }
+    return hi / layerHeight;
+}
+
+function quantizedReadResidual(predictedThreshold: number, observedLayers: number): number {
+    const lowerExclusive = Math.max(0, observedLayers - 1);
+    if (predictedThreshold > lowerExclusive && predictedThreshold <= observedLayers) return 0;
+    if (predictedThreshold <= lowerExclusive) return lowerExclusive - predictedThreshold;
+    return predictedThreshold - observedLayers;
+}
+
+function predictedReadResidual(
+    filamentRgb: CalibrationRgb,
+    td: CalibrationRgb,
+    read: FrontlitCalibrationRead,
+    layerHeight: number,
+    jnd: number,
+    maxLayers?: number,
+    mode: ReadResidualMode = 'interval'
+): number {
+    const base = hexToRgb(read.baseColor);
+    if (!base) return 50;
+    const predicted = opacityLayerThreshold(
+        filamentRgb,
+        td,
+        layerHeight,
+        jnd,
+        base,
+        Math.max(maxLayers ?? 0, read.opacityLayers + 24, DEFAULT_PREDICT_MAX_LAYERS)
+    );
+    if (predicted === undefined) return 50;
+    if (mode === 'center') return predicted - (read.opacityLayers - 0.5);
+    return quantizedReadResidual(predicted, read.opacityLayers);
+}
+
+function scalarTdFromRead(
+    filamentColor: string,
+    read: FrontlitCalibrationRead,
+    layerHeight: number,
+    jnd: number
+): number | undefined {
+    const tStar = solveOpacityTransmission(filamentColor, jnd, read.baseColor);
+    if (tStar === undefined || tStar <= 0 || tStar >= 1) return undefined;
+    return clamp(
+        -(read.opacityLayers * layerHeight) / Math.log10(tStar),
+        FRONTLIT_TD_MIN,
+        FRONTLIT_TD_MAX
+    );
+}
+
+interface ChannelFit {
+    td: CalibrationRgb;
+    residual: number;
+    dataResidual: number;
+    rmsLayers: number;
+    prior: CalibrationRgb;
+    tdSingleValue: number;
+}
+
+function fitChannelTdsForReads(
+    filamentColor: string,
+    reads: FrontlitCalibrationRead[],
+    layerHeight: number,
+    jnd: number,
+    maxLayers?: number,
+    residualMode: ReadResidualMode = 'interval'
+): ChannelFit | undefined {
+    const filamentRgb = hexToRgb(filamentColor);
+    if (!filamentRgb || reads.length === 0) return undefined;
+
+    const anchorScalar = scalarTdFromRead(filamentColor, reads[0], layerHeight, jnd);
+    if (!anchorScalar) return undefined;
+    const prior = deriveChannelTds(filamentColor, anchorScalar);
+    if (reads.length === 1) {
+        const dataResidual =
+            predictedReadResidual(
+                filamentRgb,
+                prior,
+                reads[0],
+                layerHeight,
+                jnd,
+                maxLayers,
+                residualMode
+            ) ** 2;
+        return {
+            td: prior,
+            residual: dataResidual,
+            dataResidual,
+            rmsLayers: Math.sqrt(dataResidual),
+            prior,
+            tdSingleValue: anchorScalar,
+        };
+    }
+
+    const regularizationWeight = reads.length <= 2 ? 0.08 : 0.035;
+    const score = (td: CalibrationRgb) => {
+        let dataResidual = 0;
+        for (const read of reads) {
+            const r = predictedReadResidual(
+                filamentRgb,
+                td,
+                read,
+                layerHeight,
+                jnd,
+                maxLayers,
+                residualMode
+            );
+            dataResidual += r * r;
+        }
+        const reg =
+            regularizationWeight *
+            td.reduce((sum, value, index) => {
+                const ratio = Math.log2(value / prior[index]);
+                return sum + ratio * ratio;
+            }, 0);
+        return { total: dataResidual + reg, dataResidual };
+    };
+
+    let bestTd = prior;
+    let best = score(bestTd);
+    const coarseOffsets = [-1.2, -0.6, 0, 0.6, 1.2];
+    for (const r of coarseOffsets) {
+        for (const g of coarseOffsets) {
+            for (const b of coarseOffsets) {
+                const candidate: CalibrationRgb = [
+                    clamp(prior[0] * Math.exp(r), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                    clamp(prior[1] * Math.exp(g), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                    clamp(prior[2] * Math.exp(b), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                ];
+                const candidateScore = score(candidate);
+                if (candidateScore.total < best.total) {
+                    bestTd = candidate;
+                    best = candidateScore;
+                }
+            }
+        }
+    }
+
+    for (let step = 0.45; step >= 0.035; step *= 0.55) {
+        let improved = true;
+        let passes = 0;
+        while (improved && passes < 6) {
+            improved = false;
+            passes++;
+            for (const r of [-step, 0, step]) {
+                for (const g of [-step, 0, step]) {
+                    for (const b of [-step, 0, step]) {
+                        if (r === 0 && g === 0 && b === 0) continue;
+                        const candidate: CalibrationRgb = [
+                            clamp(bestTd[0] * Math.exp(r), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                            clamp(bestTd[1] * Math.exp(g), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                            clamp(bestTd[2] * Math.exp(b), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX),
+                        ];
+                        const candidateScore = score(candidate);
+                        if (candidateScore.total + 1e-9 < best.total) {
+                            bestTd = candidate;
+                            best = candidateScore;
+                            improved = true;
+                        }
+                    }
+                }
+            }
+        }
+    }
+
+    return {
+        td: bestTd,
+        residual: best.total,
+        dataResidual: best.dataResidual,
+        rmsLayers: Math.sqrt(best.dataResidual / reads.length),
+        prior,
+        tdSingleValue: Math.max(...bestTd),
+    };
+}
+
 /**
  * Solve for the transmission `T*` at which the over-base blend is exactly `jnd`
  * ΔE00 from the opaque filament color. ΔE00 grows monotonically with T (more
@@ -207,6 +500,28 @@ export function solveOpacityTransmission(
     return (lo + hi) / 2;
 }
 
+/**
+ * Predict the first wedge patch that should match the reference rail for a set
+ * of per-channel TDs. Returns maxLayers + 1 when it would not converge within
+ * the printed wedge.
+ */
+export function predictOpacityLayersForTds(
+    filamentColor: string,
+    td: CalibrationRgb,
+    layerHeight: number,
+    jnd = OPACITY_JND,
+    baseColor: string = FRONTLIT_BASE_HEX,
+    maxLayers = DEFAULT_PREDICT_MAX_LAYERS
+): number | undefined {
+    const filamentRgb = hexToRgb(filamentColor);
+    const base = hexToRgb(baseColor);
+    if (!filamentRgb || !base) return undefined;
+    const threshold = opacityLayerThreshold(filamentRgb, td, layerHeight, jnd, base, maxLayers);
+    if (threshold === undefined) return undefined;
+    if (threshold > maxLayers) return maxLayers + 1;
+    return Math.max(1, Math.ceil(threshold - 1e-9));
+}
+
 /**
  * Derive per-channel TDs from the single measured TD, modulated by the filament
  * color. Uses a `1 + value*5.8` shape per channel (the per-channel form of the
@@ -236,6 +551,62 @@ function frontlitConfidence(opacityLayers: number, tdSingle: number, maxLayers?:
     return clamp(confidence, 0.1, 1);
 }
 
+function multiReadConfidence(
+    reads: FrontlitCalibrationRead[],
+    fit: ChannelFit,
+    maxLayers?: number
+): number {
+    let confidence = reads.length > 1 ? 0.96 : 0.9;
+    for (const read of reads) {
+        if (read.opacityLayers <= 1) confidence -= 0.12;
+        if (maxLayers !== undefined && read.opacityLayers >= maxLayers) confidence -= 0.12;
+    }
+    if (fit.td.some((td) => td <= FRONTLIT_TD_MIN * 1.5 || td >= FRONTLIT_TD_MAX * 0.9)) {
+        confidence -= 0.16;
+    }
+    if (reads.length > 1) {
+        confidence -= clamp(fit.rmsLayers * 0.16, 0, 0.35);
+    }
+    return clamp(confidence, 0.1, 1);
+}
+
+function normalizeInputReads(
+    input: FrontlitCalibrationInput
+): { ok: true; reads: FrontlitCalibrationRead[] } | { ok: false; error: string } {
+    const rawReads =
+        input.reads && input.reads.length > 0
+            ? input.reads
+            : input.opacityLayers !== undefined
+              ? [
+                    {
+                        baseColor: input.baseColor ?? FRONTLIT_BASE_HEX,
+                        opacityLayers: input.opacityLayers,
+                    },
+                ]
+              : [];
+
+    if (rawReads.length === 0) {
+        return { ok: false, error: 'Enter at least one opacity read.' };
+    }
+
+    const reads: FrontlitCalibrationRead[] = [];
+    for (const raw of rawReads) {
+        const read = sanitizeCalibrationRead(raw);
+        if (!read) {
+            return {
+                ok: false,
+                error: 'Each opacity read needs a valid base color and layer count.',
+            };
+        }
+        reads.push(read);
+    }
+    return { ok: true, reads };
+}
+
+function appendCalibrationNote(existing: string | undefined, note: string): string {
+    return existing ? `${existing} ${note}` : note;
+}
+
 /**
  * Convert a single opacity-layer read into a frontlit calibration.
  *
@@ -247,9 +618,14 @@ function frontlitConfidence(opacityLayers: number, tdSingle: number, maxLayers?:
 export function computeFrontlitCalibration(
     input: FrontlitCalibrationInput
 ): FrontlitCalibrationResult {
-    const { filamentColor, opacityLayers, layerHeight, firstLayerHeight } = input;
+    const { filamentColor, layerHeight, firstLayerHeight } = input;
     const jnd = input.jnd ?? OPACITY_JND;
-    const baseColor = input.baseColor ?? FRONTLIT_BASE_HEX;
+    const normalized = normalizeInputReads(input);
+    if (!normalized.ok) return normalized;
+    const { reads } = normalized;
+    const anchorRead = reads[0];
+    const opacityLayers = anchorRead.opacityLayers;
+    const baseColor = anchorRead.baseColor;
 
     if (!Number.isFinite(opacityLayers) || opacityLayers < 1) {
         return { ok: false, error: 'Opacity layer count must be at least 1.' };
@@ -257,19 +633,38 @@ export function computeFrontlitCalibration(
     if (!Number.isFinite(layerHeight) || layerHeight <= 0) {
         return { ok: false, error: 'Layer height must be a positive number.' };
     }
+    if (!Number.isFinite(firstLayerHeight) || firstLayerHeight <= 0) {
+        return { ok: false, error: 'First-layer height must be a positive number.' };
+    }
 
-    const tStar = solveOpacityTransmission(filamentColor, jnd, baseColor);
-    if (tStar === undefined || tStar <= 0 || tStar >= 1) {
-        return {
-            ok: false,
-            error: 'Too little contrast with the base to calibrate. Pick a lighter base (e.g. white) for this filament.',
-        };
+    for (const read of reads) {
+        const tStar = solveOpacityTransmission(filamentColor, jnd, read.baseColor);
+        if (tStar === undefined || tStar <= 0 || tStar >= 1) {
+            return {
+                ok: false,
+                error: 'Too little contrast with one selected base to calibrate. Pick a base with stronger contrast for this filament.',
+            };
+        }
     }
 
-    const dOpaque = opacityLayers * layerHeight;
-    const tdSingleValue = clamp(-dOpaque / Math.log10(tStar), FRONTLIT_TD_MIN, FRONTLIT_TD_MAX);
-    const td = deriveChannelTds(filamentColor, tdSingleValue);
-    const confidence = frontlitConfidence(opacityLayers, tdSingleValue, input.maxLayers);
+    const fit = fitChannelTdsForReads(filamentColor, reads, layerHeight, jnd, input.maxLayers);
+    if (!fit) {
+        return { ok: false, error: 'Could not fit a calibration from these reads.' };
+    }
+    const channelSource = reads.length > 1 ? 'measured' : 'heuristic';
+    const td = fit.td;
+    const tdSingleValue = fit.tdSingleValue;
+    const confidence =
+        reads.length > 1
+            ? multiReadConfidence(reads, fit, input.maxLayers)
+            : frontlitConfidence(opacityLayers, tdSingleValue, input.maxLayers);
+    let notes = input.notes;
+    if (reads.length > 1 && fit.rmsLayers > 0.75) {
+        notes = appendCalibrationNote(
+            notes,
+            `Multi-base reads disagree by about ${fit.rmsLayers.toFixed(1)} layers under the best fit.`
+        );
+    }
 
     return {
         ok: true,
@@ -284,11 +679,111 @@ export function computeFrontlitCalibration(
             confidence,
             basis: 'frontlit',
             calibrationDate: new Date().toISOString(),
-            notes: input.notes,
+            reads:
+                reads.length > 1 || reads.some((read) => read.mergeLayers !== undefined)
+                    ? reads
+                    : undefined,
+            channelSource,
+            jndSource: input.jndSource ?? 'default',
+            notes,
         },
     };
 }
 
+function calibrationFitResidualForJnd(input: FrontlitCalibrationInput, jnd: number): number {
+    const normalized = normalizeInputReads(input);
+    if (!normalized.ok || normalized.reads.length < 2) return 0;
+    const fit = fitChannelTdsForReads(
+        input.filamentColor,
+        normalized.reads,
+        input.layerHeight,
+        jnd,
+        input.maxLayers,
+        'center'
+    );
+    return fit ? fit.dataResidual : 1_000;
+}
+
+function fitSessionJnd(
+    inputs: FrontlitCalibrationInput[],
+    maxLayers?: number
+): { jnd: number; residual: number } | undefined {
+    const eligible = inputs.filter((input) => {
+        const normalized = normalizeInputReads({
+            ...input,
+            maxLayers: input.maxLayers ?? maxLayers,
+        });
+        return normalized.ok && normalized.reads.length >= 2;
+    });
+    if (eligible.length < 2) return undefined;
+
+    const evaluate = (jnd: number) =>
+        eligible.reduce(
+            (sum, input) =>
+                sum +
+                calibrationFitResidualForJnd(
+                    { ...input, maxLayers: input.maxLayers ?? maxLayers },
+                    jnd
+                ),
+            0
+        );
+
+    let bestJnd = OPACITY_JND;
+    let bestResidual = evaluate(OPACITY_JND);
+    for (let jnd = JND_FIT_MIN; jnd <= JND_FIT_MAX + 1e-9; jnd += 0.2) {
+        const rounded = Number(jnd.toFixed(2));
+        const residual = evaluate(rounded);
+        if (residual < bestResidual) {
+            bestJnd = rounded;
+            bestResidual = residual;
+        }
+    }
+    const fineStart = Math.max(JND_FIT_MIN, bestJnd - 0.16);
+    const fineEnd = Math.min(JND_FIT_MAX, bestJnd + 0.16);
+    for (let jnd = fineStart; jnd <= fineEnd + 1e-9; jnd += 0.04) {
+        const rounded = Number(jnd.toFixed(2));
+        const residual = evaluate(rounded);
+        if (residual < bestResidual) {
+            bestJnd = rounded;
+            bestResidual = residual;
+        }
+    }
+
+    const defaultResidual = evaluate(OPACITY_JND);
+    const improvement = defaultResidual - bestResidual;
+    if (improvement < Math.max(0.1, eligible.length * 0.04)) return undefined;
+    if (bestJnd <= JND_FIT_MIN + 1e-9 || bestJnd >= JND_FIT_MAX - 1e-9) return undefined;
+    return { jnd: bestJnd, residual: bestResidual };
+}
+
+export function computeFrontlitCalibrationSession(
+    input: FrontlitCalibrationSessionInput
+): FrontlitCalibrationSessionResult {
+    const jndFit = fitSessionJnd(input.filaments, input.maxLayers);
+    const jnd = jndFit?.jnd ?? OPACITY_JND;
+    const jndSource = jndFit ? 'session-fit' : 'default';
+    const results = input.filaments.map((filament) =>
+        computeFrontlitCalibration({
+            ...filament,
+            maxLayers: filament.maxLayers ?? input.maxLayers,
+            jnd,
+            jndSource,
+        })
+    );
+    const residual =
+        jndFit?.residual ??
+        input.filaments.reduce(
+            (sum, filament) =>
+                sum +
+                calibrationFitResidualForJnd(
+                    { ...filament, maxLayers: filament.maxLayers ?? input.maxLayers },
+                    jnd
+                ),
+            0
+        );
+    return { jnd, jndSource, results, residual };
+}
+
 /**
  * Predict the displayed color of `layers` of filament over the base, using
  * per-channel TDs. Mirrors the auto-paint blend so calibration previews match.
diff --git a/tests/frontlitCalibration.test.ts b/tests/frontlitCalibration.test.ts
index 6c87a60..c5feee1 100644
--- a/tests/frontlitCalibration.test.ts
+++ b/tests/frontlitCalibration.test.ts
@@ -33,7 +33,9 @@ async function loadViteModule<T>(modulePath: string): Promise<T> {
 const loadCalibration = () =>
     (calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts'));
 const loadColorDifference = () =>
-    (colorDifferenceModule ??= loadViteModule<ColorDifferenceModule>('/src/lib/colorDifference.ts'));
+    (colorDifferenceModule ??= loadViteModule<ColorDifferenceModule>(
+        '/src/lib/colorDifference.ts'
+    ));
 const loadColorSpace = () =>
     (colorSpaceModule ??= loadViteModule<ColorSpaceModule>('/src/lib/colorSpace.ts'));
 
@@ -73,6 +75,31 @@ async function simulateOpacityRead(
     return maxLayers;
 }
 
+async function simulateOpacityReadWithTds(
+    filamentColor: string,
+    tdTrue: [number, number, number],
+    layerHeight: number,
+    jnd: number,
+    maxLayers = 200,
+    baseColor = '#000000'
+): Promise<number> {
+    const { blendSrgbChannel } = await loadColorSpace();
+    const { deltaE2000 } = await loadColorDifference();
+    const rgb = hexToRgb(filamentColor);
+    const base = hexToRgb(baseColor);
+
+    for (let layers = 1; layers <= maxLayers; layers++) {
+        const thickness = layers * layerHeight;
+        const blended: [number, number, number] = [
+            blendSrgbChannel(base[0], rgb[0], Math.pow(10, -thickness / tdTrue[0])),
+            blendSrgbChannel(base[1], rgb[1], Math.pow(10, -thickness / tdTrue[1])),
+            blendSrgbChannel(base[2], rgb[2], Math.pow(10, -thickness / tdTrue[2])),
+        ];
+        if (deltaE2000(blended, rgb) <= jnd) return layers;
+    }
+    return maxLayers;
+}
+
 test('solveOpacityTransmission tolerates more background for darker (lower-contrast) colors', async () => {
     const { solveOpacityTransmission, OPACITY_JND } = await loadCalibration();
 
@@ -197,6 +224,154 @@ test('a lighter base lets a near-black filament calibrate (round-trip over white
     assert.ok(relErr < 0.2, `recovered ${result.calibration.tdSingleValue} vs ${tdTrue}`);
 });
 
+test('multi-base calibration fits measured per-channel TDs and stores reads', async () => {
+    const { computeFrontlitCalibration, OPACITY_JND, predictOpacityLayersForTds } =
+        await loadCalibration();
+    const layerHeight = 0.04;
+    const color = '#ffd43b';
+    const trueTd: [number, number, number] = [0.42, 0.55, 0.18];
+    const bases = ['#000000', '#2030ff', '#7a0030'];
+    const reads = await Promise.all(
+        bases.map(async (baseColor) => ({
+            baseColor,
+            opacityLayers: await simulateOpacityReadWithTds(
+                color,
+                trueTd,
+                layerHeight,
+                OPACITY_JND,
+                120,
+                baseColor
+            ),
+        }))
+    );
+
+    const result = computeFrontlitCalibration({
+        filamentColor: color,
+        layerHeight,
+        firstLayerHeight: 0.2,
+        reads,
+        maxLayers: 120,
+    });
+
+    assert.ok(result.ok, 'multi-base calibration should fit');
+    if (!result.ok) return;
+    assert.equal(result.calibration.channelSource, 'measured');
+    assert.equal(result.calibration.reads?.length, reads.length);
+    assert.equal(result.calibration.baseColor, reads[0].baseColor);
+
+    for (const read of reads) {
+        const predicted = predictOpacityLayersForTds(
+            color,
+            result.calibration.td,
+            layerHeight,
+            OPACITY_JND,
+            read.baseColor,
+            120
+        );
+        assert.ok(predicted !== undefined);
+        assert.ok(
+            Math.abs(predicted! - read.opacityLayers) <= 1,
+            `base ${read.baseColor}: predicted ${predicted}, observed ${read.opacityLayers}`
+        );
+    }
+});
+
+test('session JND fit recovers an identifiable synthetic multi-filament session', async () => {
+    const { computeFrontlitCalibrationSession } = await loadCalibration();
+    const layerHeight = 0.035;
+    const trueJnd = 1.1;
+    const cases: Array<{
+        color: string;
+        td: [number, number, number];
+        bases: string[];
+    }> = [
+        { color: '#ffd43b', td: [0.42, 0.55, 0.18], bases: ['#000000', '#2030ff', '#7a0030'] },
+        { color: '#2f7cff', td: [0.18, 0.32, 0.62], bases: ['#000000', '#ffea00', '#7a2000'] },
+        { color: '#f5f5f5', td: [0.46, 0.48, 0.5], bases: ['#000000', '#003060', '#602000'] },
+    ];
+
+    const filaments = await Promise.all(
+        cases.map(async ({ color, td, bases }) => ({
+            filamentColor: color,
+            layerHeight,
+            firstLayerHeight: 0.2,
+            maxLayers: 140,
+            reads: await Promise.all(
+                bases.map(async (baseColor) => ({
+                    baseColor,
+                    opacityLayers: await simulateOpacityReadWithTds(
+                        color,
+                        td,
+                        layerHeight,
+                        trueJnd,
+                        140,
+                        baseColor
+                    ),
+                }))
+            ),
+        }))
+    );
+
+    const session = computeFrontlitCalibrationSession({ filaments, maxLayers: 140 });
+    assert.equal(session.jndSource, 'session-fit');
+    assert.ok(Math.abs(session.jnd - trueJnd) <= 0.25, `fit JND ${session.jnd}`);
+    assert.ok(session.results.every((result) => result.ok));
+});
+
+test('session JND fit falls back when the synthetic JND is outside the accepted band', async () => {
+    const { computeFrontlitCalibrationSession, OPACITY_JND } = await loadCalibration();
+    // These reads come from a synthetic session generated with a JND above the
+    // accepted [1, 3] band. Do not record a session-fit JND for that case.
+    const session = computeFrontlitCalibrationSession({
+        filaments: [
+            {
+                filamentColor: '#ffd43b',
+                layerHeight: 0.035,
+                firstLayerHeight: 0.2,
+                maxLayers: 140,
+                reads: [
+                    { baseColor: '#000000', opacityLayers: 8 },
+                    { baseColor: '#2030ff', opacityLayers: 8 },
+                ],
+            },
+            {
+                filamentColor: '#2f7cff',
+                layerHeight: 0.035,
+                firstLayerHeight: 0.2,
+                maxLayers: 140,
+                reads: [
+                    { baseColor: '#000000', opacityLayers: 6 },
+                    { baseColor: '#ffea00', opacityLayers: 8 },
+                ],
+            },
+        ],
+        maxLayers: 140,
+    });
+    assert.equal(session.jndSource, 'default');
+    assert.equal(session.jnd, OPACITY_JND);
+});
+
+test('session JND fit falls back to the default for too little multi-base data', async () => {
+    const { computeFrontlitCalibrationSession, OPACITY_JND } = await loadCalibration();
+    const session = computeFrontlitCalibrationSession({
+        filaments: [
+            {
+                filamentColor: '#ffd43b',
+                layerHeight: 0.04,
+                firstLayerHeight: 0.2,
+                reads: [
+                    { baseColor: '#000000', opacityLayers: 8 },
+                    { baseColor: '#2030ff', opacityLayers: 5 },
+                ],
+            },
+        ],
+        maxLayers: 40,
+    });
+
+    assert.equal(session.jndSource, 'default');
+    assert.equal(session.jnd, OPACITY_JND);
+});
+
 test('sanitizeFrontlitCalibration accepts only the new frontlit calibration shape', async () => {
     const { computeFrontlitCalibration, sanitizeFrontlitCalibration } = await loadCalibration();
     const result = computeFrontlitCalibration({
@@ -211,6 +386,7 @@ test('sanitizeFrontlitCalibration accepts only the new frontlit calibration shap
     const sanitized = sanitizeFrontlitCalibration(result.calibration);
     assert.ok(sanitized);
     assert.equal(sanitized.basis, 'frontlit');
+    assert.equal(sanitized.channelSource, 'heuristic');
     assert.deepEqual(sanitized.td, result.calibration.td);
     assert.equal(sanitized.tdSingleValue, result.calibration.tdSingleValue);
     assert.equal(
@@ -231,6 +407,13 @@ test('sanitizeFrontlitCalibration accepts only the new frontlit calibration shap
         }),
         undefined
     );
+    assert.equal(
+        sanitizeFrontlitCalibration({
+            ...result.calibration,
+            reads: [{ baseColor: '#000000', opacityLayers: 5, mergeLayers: 0 }],
+        }),
+        undefined
+    );
 });
 
 test('computeFrontlitCalibration rejects invalid reads and uncalibratable colors', async () => {

From 607b550cb35f80da762852990c2b36e1abc389e1 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Fri, 3 Jul 2026 14:27:44 +0300
Subject: [PATCH 42/81] Migrate TD to hiding distance with single-meaning
 storage

Filament `td` now always stores the frontlit hiding distance in mm - the
depth at which a filament visually hides what's beneath it - for calibrated
and uncalibrated filaments alike (profile schema v2). Uncalibrated values
from older profiles, .kfil/.kapp files, and saved app state convert
automatically (x0.1, once, version-gated) on load or import; the runtime
frontlit scaling layer is removed, which also fixes calibrated filaments
being double-scaled in the recommended-height estimate. The x0.1 factor was
validated by the physical calibration of an 8-filament set, whose profile
and first-print findings are recorded in tests/assets and .agents.

Every filament now blends with per-channel hiding distances - measured when
calibrated, derived from the swatch color otherwise - so uncalibrated
previews and stacks are color-shaped instead of channel-uniform. The
filament row shows HD with per-channel tooltips, a convert-from-TD entry
(conventional backlit/lithophane TD is roughly 10x the hiding distance),
and a wand estimate re-baselined to the new scale.

The next-filament suggestion blends in linear light to match the optical
pipeline and recommends hiding distances on the stored scale (previously a
calibrated neighbor's value would be re-scaled into a 10x-too-opaque
filament).

Tests: v1->v2 migration across all three load paths, double-import
idempotence, channel derivation, estimator rescale, linear-light blend spot
checks, and a calibrated-profile baseline captured before the migration
proving byte-identical auto-paint output after it. Goldens regenerated for
the uncalibrated channel change. Docs, changelog, README, and AGENTS.md
updated to the new terminology.

Breaking: profile schema v2 - older files are converted on load/import
with no notice; exports are v2.
---
 .agents/calibration-improvements.md           |  20 +-
 .agents/calibration-phase1-review-issues.md   | 174 ++++++
 .agents/calibration-phase2-color.md           | 228 +++++++
 .agents/calibration-phase2-review-issues.md   | 119 ++++
 .agents/hiding-distance-migration.md          | 207 +++++++
 .agents/next-best-color-td-fix.md             | 174 ++++++
 .../2026-07-02-logo-test/findings.md          |  89 +++
 .../2026-07-02-logo-test/image.png            | Bin 0 -> 68424 bytes
 .../2026-07-02-logo-test/print-photo.jpg      | Bin 0 -> 496982 bytes
 .gitignore                                    |   3 +
 AGENTS.md                                     |   9 +-
 CHANGELOG.md                                  |   1 +
 README.md                                     |   4 +-
 src/App.tsx                                   |  20 +-
 src/components/AutoPaintTab.tsx               |   4 +-
 src/components/FilamentCalibrationDialog.tsx  |  37 +-
 src/components/FilamentRow.tsx                | 100 +++-
 src/docs/3d-mode.md                           |  14 +-
 src/docs/faq.md                               |  12 +-
 src/docs/overview.md                          |   6 +-
 src/docs/quick-start.md                       |   6 +-
 src/docs/settings-and-controls.md             |   2 +-
 src/docs/troubleshooting.md                   |   2 +-
 src/hooks/useFilaments.ts                     |   4 +-
 src/lib/autoPaint.ts                          |  71 +--
 src/lib/calibration.ts                        |  38 +-
 src/lib/colorUtils.ts                         |  25 +-
 src/lib/nextBestColor.ts                      |  36 +-
 src/lib/profileManager.ts                     |  53 +-
 tests/assets/auto-paint-goldens.json          | 560 +++++++++---------
 .../assets/autopaint-calibrated-baseline.json | 123 ++++
 .../8_Colors_Calibrated_New.kfil              | 287 +++++++++
 tests/autoPaint.test.ts                       |  54 +-
 tests/autoPaintGoldenFixtures.ts              |  24 +-
 tests/export3mf.test.ts                       |   7 +-
 tests/hidingDistance.test.ts                  | 120 ++++
 tests/nextBestColor.test.ts                   |  53 +-
 tests/profileManager.test.ts                  | 138 +++++
 38 files changed, 2367 insertions(+), 457 deletions(-)
 create mode 100644 .agents/calibration-phase1-review-issues.md
 create mode 100644 .agents/calibration-phase2-color.md
 create mode 100644 .agents/calibration-phase2-review-issues.md
 create mode 100644 .agents/hiding-distance-migration.md
 create mode 100644 .agents/next-best-color-td-fix.md
 create mode 100644 .agents/print-findings/2026-07-02-logo-test/findings.md
 create mode 100644 .agents/print-findings/2026-07-02-logo-test/image.png
 create mode 100644 .agents/print-findings/2026-07-02-logo-test/print-photo.jpg
 create mode 100644 tests/assets/autopaint-calibrated-baseline.json
 create mode 100644 tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil
 create mode 100644 tests/hidingDistance.test.ts

diff --git a/.agents/calibration-improvements.md b/.agents/calibration-improvements.md
index 3927eb6..fab283c 100644
--- a/.agents/calibration-improvements.md
+++ b/.agents/calibration-improvements.md
@@ -201,18 +201,14 @@ The user has OK'd breaking changes with **no migration notice**. So:
 
 ---
 
-## Phase 2 — color accuracy (combos), still later
-
-Single-filament frontlit TD fixes "too many / too few layers" and most of the
-color drift, because the preview uses the same TD. Fine-grained accuracy of
-*stacked color blends* is a second pass: print a matrix of 2–3 color combinations,
-**pruned to only printable combos using the Phase-1 TDs** (no longer assuming a
-high TD ⇒ far fewer cells), and correct the blend predictor.
-
-Open question for Phase 2: keep it camera-free. On-screen color matching reintro-
-duces the monitor problem, so prefer ordinal/threshold-style reads here too (e.g.
-"at which layer does color A stop showing through color B") rather than absolute
-color matching. To be designed after Phase 1 lands.
+## Phase 2 — color accuracy (combos)
+
+Designed in [calibration-phase2-color.md](calibration-phase2-color.md): the Phase-1
+opacity read repeated over 2–3 different colored bases per filament measures the
+per-channel TDs directly (replacing the `1 + c*5.8` heuristic ratios), and the
+cross-base consistency of those reads pins the JND as one global fitted constant.
+Camera-free, same tile geometry, same "match the rail" judgment; pruned to
+printable combos using the Phase-1 TDs as originally intended.
 
 ---
 
diff --git a/.agents/calibration-phase1-review-issues.md b/.agents/calibration-phase1-review-issues.md
new file mode 100644
index 0000000..2e3a6b7
--- /dev/null
+++ b/.agents/calibration-phase1-review-issues.md
@@ -0,0 +1,174 @@
+# Phase 1 review — issues to fix before Phase 2
+
+> **Status: ALL RESOLVED (2026-07-02).** All six issues below were fixed in the
+> follow-up changes (calibration sanitizer + load-path stripping, first-layer-aware
+> base height, STL swap instructions, `basis: 'frontlit'` rename, per-row calibrate
+> button with reset-on-open, changelog cleanup). Verified: 224 tests pass, tsc and
+> eslint clean. Kept for history; Phase 2 is unblocked.
+
+Review of commits `354f736` (frontlit opacity-read calibration) and `bd4fa71` (Load TD
+Test button removal) against the plan in
+[calibration-improvements.md](calibration-improvements.md). The core fit
+(`solveOpacityTransmission`, `computeFrontlitCalibration`, `deriveChannelTds`), the
+dialog flow, the 3MF slot mapping, and the round-trip tests all match the plan and are
+in good shape. The issues below are ordered by severity; #1 and #2 are blockers for
+calling Phase 1 done.
+
+---
+
+## 1. HIGH — Old persisted calibrations are not stripped on load, and now bypass the frontlit scale
+
+The plan requires: "old `CalibrationResult` fields are simply **ignored/stripped on
+load**." That stripping was never implemented — the commit touched no persistence code.
+
+Three load paths pass `filament.calibration` through untyped/unvalidated:
+
+- `loadProfiles()` — [profileManager.ts:17-30](../src/lib/profileManager.ts#L17-L30)
+  (localStorage `kromacut.autopaint.profiles`)
+- `importProfiles()` filament validation — [profileManager.ts:165-168](../src/lib/profileManager.ts#L165-L168)
+  (`.kfil` / profile JSON import; only checks `id`/`color`/`td`)
+- `loadAutoPaintPersisted()` — [App.tsx:108-142](../src/App.tsx#L108-L142)
+  (localStorage `kromacut.autopaint.v1`, `parsed.filaments` used as-is)
+
+Why this is actively harmful, not just cosmetic: the old `CalibrationResult` shape
+(`{ measurements, whiteReference, td: [r,g,b], tdSingleValue, confidence,
+calibrationDate }`) survives a JSON round-trip and **structurally satisfies the two
+runtime checks that matter**:
+
+- `scaleFilamentForFrontlight()` ([autoPaint.ts:411-419](../src/lib/autoPaint.ts#L411-L419))
+  skips the `FRONTLIT_TD_SCALE = 0.1` fallback for any truthy `calibration`.
+- `calibratedTdChannels()` ([autoPaint.ts:402-409](../src/lib/autoPaint.ts#L402-L409))
+  only checks that `calibration.td` is a finite-positive array — which the old backlit
+  fit also produced.
+
+So a user with an old photo calibration gets their **backlit** TDs (~2–6 mm, which the
+old pipeline multiplied by 0.1) fed into the simulation as if they were measured
+frontlit TDs — roughly 10× too transmissive, silently, producing drastically wrong
+layer stacks. The changelog says "recalibrate any previously calibrated filaments" but
+nothing in code enforces or even detects it. `computeProfileConfidence()` and the
+FilamentRow "calibrated" badge also accept the old object (it has `confidence` +
+`calibrationDate`, and the old flow also set `td = tdSingleValue`, so the
+`calibrationMatchesTd` guard passes).
+
+**Fix:** add a single validator (e.g. in `calibration.ts`:
+`sanitizeFrontlitCalibration(value: unknown): FrontlitCalibration | undefined`) that
+accepts an object only if it matches the new shape — cheapest reliable discriminators
+are `basis === 'black-frontlit'` plus finite `opacityLayers >= 1` (old shape has
+neither) — and returns `undefined` otherwise. Apply it to `filament.calibration` in all
+three load paths above. A defensive `basis`/`opacityLayers` check inside
+`calibratedTdChannels`/`scaleFilamentForFrontlight` is cheap extra insurance since
+worker inputs come from persisted state. Add a regression test: a profile JSON carrying
+an old-shape calibration loads with `calibration === undefined` and the filament falls
+back to the `FRONTLIT_TD_SCALE` path.
+
+---
+
+## 2. HIGH — Calibration print geometry ignores first-layer height, so patch layer counts are wrong when sliced
+
+`baseHeight()` ([generateCalibrationPrint.ts:88-90](../src/lib/generateCalibrationPrint.ts#L88-L90))
+is `baseLayers × layerHeight`, with a comment claiming "The slicer applies its own
+first-layer height when printing, so this is just baseLayers worth of regular layers."
+That reasoning is inverted: because the slicer's first layer is taller, the Z grid is
+`firstLayer + n × layerHeight`, and a base built from regular layers only does NOT land
+on that grid.
+
+Defaults make it concrete: `layerHeight 0.08`, `firstLayerHeight 0.2` (and the embedded
+3MF project sets `initial_layer_print_height = max(layerHeight, firstLayerHeight)` =
+0.2, [generateCalibrationPrint.ts:571](../src/lib/generateCalibrationPrint.ts#L571)).
+Slicer layer tops: 0.2, 0.28, 0.36, 0.44, … Base top: 5 × 0.08 = **0.40 mm — mid-layer**.
+Every wedge patch top (0.40 + i × 0.08) is then also mid-layer. The slicer will
+realize each patch with a color layer count that differs from the nominal patch number
+(off by one, or with a partial base/color boundary layer), so the number the user reads
+back does not correspond to `opacityLayers × layerHeight` of filament — the exact bias
+the plan warned about ("Thickness must use the real layer-height model, not
+`layers × layerHeight`").
+
+**Fix:** make the base absorb the first layer:
+`baseHeight = max(layerHeight, firstLayerHeight) + (baseLayers − 1) × layerHeight`.
+Then the base top and every patch/rail top land exactly on the slicer grid (0.2 + 4×0.08
+= 0.52; patches at 0.52 + i×0.08 ✓), and each color patch is exactly `i` regular
+layers, which is what `computeFrontlitCalibration` assumes. Update the stale comment,
+the `calibrationPrint.test.ts` expectations, and add an assertion that the base top and
+patch tops are integer multiples of `layerHeight` above `max(layerHeight,
+firstLayerHeight)`. Note the wedge/rail math itself needs no change — only the base
+thickness.
+
+This matters for both formats: the 3MF embeds the matching first-layer height itself;
+for STL the dialog should tell the user which layer height AND first-layer height to
+slice with (see #3).
+
+---
+
+## 3. MEDIUM — STL flow lacks concrete per-filament print/swap instructions
+
+The plan specifies generated text instructions for STL ("load black, print to layer X;
+swap to filament A"). What shipped is one generic sentence ("base, then swap to the
+color above the base" — [FilamentCalibrationDialog.tsx:523](../src/components/FilamentCalibrationDialog.tsx#L523)).
+Two concrete gaps:
+
+- **No per-filament base reminder.** The Base step lets the user pick a different base
+  per filament, and the TD fit uses that choice (`resolveBaseColor` →
+  `computeFrontlitCalibration.baseColor`). At print time nothing shows which base goes
+  with which filament; printing over the wrong base silently produces a wrong fit.
+- **No exact swap point.** After fixing #2 the swap is well-defined: pause/swap after
+  layer `baseLayers`, i.e. at Z = `max(layerHeight, firstLayerHeight) +
+  (baseLayers − 1) × layerHeight`. Show the layer number and Z, plus "slice at layer
+  height H, first layer F" so the user's slicer settings match the geometry.
+
+A per-filament line in the Print step ("Red: base = Black, swap after layer 5 /
+Z 0.52 mm") is enough; a downloadable .txt is optional polish.
+
+---
+
+## 4. MEDIUM — `basis: 'black-frontlit'` is hardcoded even for non-black bases
+
+`computeFrontlitCalibration` always stores `basis: 'black-frontlit'`
+([calibration.ts:224](../src/lib/calibration.ts#L224)) while also storing the actual
+`baseColor`, which the base-picker feature lets be white or anything else. A
+calibration over white then carries a self-contradictory record. This is a persisted
+user-data field in a brand-new format — rename it **now**, before it ships, rather than
+migrating later. Suggestion: `basis: 'frontlit'` with `baseColor` as the sole source of
+truth (keep `baseColor` required rather than optional). If #1's sanitizer keys on
+`basis`, update both together.
+
+---
+
+## 5. LOW — `initialFilamentId` preselect is dead and would be stale if wired
+
+The only caller is `handleOpenCalibration()` with no id
+([AutoPaintTab.tsx:490](../src/components/AutoPaintTab.tsx#L490)), so per-filament
+preselect never happens. Even if an id were passed, the dialog captures
+`initialFilamentId` in a `useState` initializer at mount
+([FilamentCalibrationDialog.tsx:107-109](../src/components/FilamentCalibrationDialog.tsx#L107-L109))
+and only re-reads it in `reset()`, which runs via a 300 ms `setTimeout` holding a
+possibly stale closure — racing AutoPaintTab's own 300 ms reset of
+`calibratingFilamentId` to null. Either delete the prop and the AutoPaintTab id
+plumbing, or fix properly (sync selection in an effect when `open` flips true).
+
+---
+
+## 6. LOW — Stale changelog entry for the deleted photo sampler
+
+`CHANGELOG.md` unreleased "Changed" still lists **"Calibration image sampler"**
+(circular brush overlay) — a refinement to the photo wizard that this same unreleased
+version deleted. Per AGENTS.md changelog guidance (entries classify against the last
+release), remove that bullet; the frontlit-calibration "Added" bullet already covers
+the replacement.
+
+---
+
+## Reviewed and explicitly OK (no action)
+
+- Fit math: `T*` bisection over any base, `TD = -d/log10(T*)`, brightest-channel anchor
+  in `deriveChannelTds` — all match the plan; round-trip tests recover synthetic TDs
+  within integer-read quantization.
+- The base-picker (vs the plan's fixed black base) is a sound generalization — the solve
+  handles arbitrary bases and errors out on low contrast with a helpful message.
+- Keeping `FRONTLIT_TD_SCALE` as the *uncalibrated-only* fallback rather than deleting
+  it outright is a reasonable reading of the plan's "re-baseline the default."
+- Overlapping closed shells in the STL (orientation foot into base, patches butting the
+  rail): slicers union coincident shells within one solid; fine for a standalone
+  calibration part.
+- 3MF slot mapping to real profile filaments in profile order, no phantom base, no
+  `<assemble>` block — matches the refined design and is test-covered.
+- All 219 tests pass on the current branch.
diff --git a/.agents/calibration-phase2-color.md b/.agents/calibration-phase2-color.md
new file mode 100644
index 0000000..0d11b15
--- /dev/null
+++ b/.agents/calibration-phase2-color.md
@@ -0,0 +1,228 @@
+# Calibration Phase 2 — color accuracy via multi-base opacity reads
+
+Status: core implementation complete; metamer-pair validation strip still open. Builds directly on the Phase 1
+frontlit calibration (see [calibration-improvements.md](calibration-improvements.md),
+implemented in `354f736` + the review fixes).
+
+## Goal
+
+Phase 1 pins each filament's overall optical magnitude (scalar frontlit TD) from a
+single opacity read over one base. Two things remain heuristic:
+
+1. **Per-channel TD ratios** — currently derived from the swatch color via the
+   `1 + c/255 × 5.8` shape ([`deriveChannelTds`](../src/lib/calibration.ts)), anchored
+   to the measured scalar. The ratios were never measured; they drive every stacked
+   color blend the optimizer and preview compute, so they are the dominant remaining
+   error source for intermediate/blended colors.
+2. **The JND constant** — [`OPACITY_JND = 2.0`](../src/lib/calibration.ts) defines
+   "indistinguishable from the reference rail" and sets the global TD scale
+   (`TD = -d/log10(T*)` where `T*` depends on the JND). It was never validated against
+   physical prints (the Phase-1 "Still to pin" item).
+
+Phase 2 measures both, stays **camera-free**, and changes **only the calibration
+side** — the optimizer and preview already consume per-channel TDs
+(`calibration.td`), so better numbers flow through with zero pipeline changes.
+
+## Core mechanism: the Phase-1 read, repeated over different colored bases
+
+Phase 1 already generalized the opacity read to arbitrary bases (base-picker +
+`solveOpacityTransmission(color, jnd, baseColor)`). Phase 2's entire measurement is:
+**read the same filament over 2–3 different bases.**
+
+Why this measures per-channel TDs: the opacity read is governed by the _slowest_
+channel to converge, and which channel that is depends on the base.
+
+- Yellow over **black**: R and G must build up from 0 → governed by td_r, td_g.
+- Yellow over **blue**: the blue channel must attenuate 255 → ~0 → governed by td_b.
+- Each additional base with a different channel signature adds an independent
+  constraint on the (td_r, td_g, td_b) triple.
+
+No new read type, no new geometry, no new judgment for the user's eye — still
+"first patch that matches the rail beside it," which is the whole reason the
+Phase-1 flow is robust.
+
+### The fit
+
+Per filament, given reads `{(base_i, n_i)}` at layer height `h`:
+
+- Model: per-channel transmission `T_c(d) = 10^(-d / td_c)`; blended color =
+  `blendSrgbChannel(base_c, filament_c, T_c(d))` per channel (the exact functions the
+  optimizer uses).
+- Predicted read for a candidate `(td_r, td_g, td_b)`:
+  `n̂_i = min { n : ΔE00(blend(base_i, A, T(n·h)), A) ≤ JND }`.
+- Fit: minimize `Σ_i (n̂_i − n_i)²` (or a smooth surrogate on log-TD) over the
+  channel TDs, **regularized toward the Phase-1 anchor structure** (brightest-channel
+  anchor + heuristic ratios as the prior) so 2 reads still give a stable answer.
+  Deterministic — coarse grid + local refinement, no randomness.
+- With **1 read** (Phase-1 case) the fit degenerates to exactly the current
+  `deriveChannelTds` behavior. Phase 2 is a strict superset; single-base calibration
+  keeps working unchanged.
+
+Integer reads quantize each constraint, so prefer overdetermination (3 bases) over
+exact solving, and keep `maxLayers` large enough that reads land mid-wedge (the
+confidence logic already penalizes clipped reads).
+
+### Optional secondary read: the adjacent-step merge point (the Phase-3 detector)
+
+On the same wedge, the user can optionally also report **the last patch that still
+looks different from its neighbor** (walking up the wedge, the point where adjacent
+steps become indistinguishable). Still a same/not-same judgment between two
+physically adjacent patches — same trust model as the rail read. Observed in
+practice on the first physical Phase-1 print: large visible steps in the first few
+layers, then diminishing returns well before the rail match.
+
+Why it matters: the exponential model makes a _fixed quantitative prediction_ about
+where this merge point sits relative to the rail-match point. Per channel,
+step-to-step change ∝ `r^n(1−r)` while distance-to-rail ∝ `r^n` (with
+`r = 10^(-h/td)`), so neighbors merge when the remaining gap to the rail is still
+≈ `JND/(1−r)` — e.g. ~3× JND at h=0.08, TD≈0.5. Diminishing returns per layer is
+therefore **expected** and does not by itself indicate scattering.
+
+What _would_ indicate scattering (a longer-than-exponential tail): merge points
+landing systematically earlier — relative to the rail match — than the fitted
+exponential predicts, consistently across filaments. The merge read costs nothing
+extra to print, is optional at entry (never blocks saving a calibration), and is
+stored alongside the opacity reads purely as model-form evidence. It can also serve
+as a soft extra constraint in the TD fit when present.
+
+### JND: fit it from the same data instead of hand-tuning
+
+For one filament read over two bases, the implied TDs must agree — and
+`T*(A over B1)` vs `T*(A over B2)` respond _differently_ to the JND (the ΔE00
+geometry along each blend path differs), so cross-base consistency identifies it.
+
+- Treat JND as **one global parameter shared across all filaments and reads** in a
+  calibration session (it is a human-vision constant, never per-filament — same
+  principle as Phase 1).
+- Fit: outer 1-D search of JND over a sane band **[1.0, 3.0]**, minimizing the total
+  cross-base fit residual from the per-filament fits above; many (filament × base)
+  reads vs. one parameter → well overdetermined.
+- Fallback: if the session has too few multi-base reads or the residual curve is
+  flat, keep `OPACITY_JND = 2.0` and report that in the UI/notes. Never silently fit
+  JND from a single filament.
+- Once fitted, store the session JND and use it for subsequent single-read
+  calibrations too.
+
+This absorbs the unfinished Phase-1 validation task ("sanity-check JND against the
+7-color frontlit set"): the first real Phase-2 calibration session of that filament
+set _is_ the JND measurement.
+
+## Combo pruning (which bases to print each filament over)
+
+Auto-pick 2–3 bases per filament from the user's own profile filaments, pruned with
+the Phase-1 TDs exactly as the original plan intended:
+
+- Drop pairs where `solveOpacityTransmission` returns undefined (no contrast → no
+  read possible; already handled/errored in Phase 1).
+- Drop pairs whose **predicted** read (from current TDs) is 1 (base hidden
+  immediately — zero information) or > maxLayers (never converges in the wedge).
+- Among survivors, greedily pick bases maximizing channel diversity: score each
+  candidate base by how differently it weights the three channels for this filament
+  (e.g., which channel the predicted read is governed by), and pick a set covering
+  different governing channels. Black (or the darkest filament) stays in the set as
+  the anchor read.
+- The user can override the auto-picked set (same Select UI as Phase 1's base step,
+  now multi-select per filament).
+
+Note: bases only contribute their _surface color_ (they print opaque), so an
+uncalibrated filament can serve as a base — no calibration-order dependency.
+
+## Print & UX
+
+- **Geometry:** unchanged tile generator. Phase 2 print = one tile per
+  (filament, base) pair instead of one per filament. Combined 3MF tiles or one STL
+  printed per pair (still exactly one swap each); the per-filament swap-instruction
+  list from the review fixes extends naturally ("Yellow over Blue: base = Blue, swap
+  after layer 5 / Z 0.52 mm").
+- **Dialog:** same four steps. Base step gains multi-select; Measure step shows one
+  read row per (filament, base) with the same live predicted swatch. A "quick"
+  single-base mode (= Phase 1 behavior) remains the default for one-off filaments;
+  "accurate" multi-base mode is the Phase 2 addition.
+- Keep the read count honest: 5 filaments × 3 bases = 15 reads is the practical
+  ceiling for one session; default to 2 bases (anchor + one contrast base) and let
+  the user opt into 3.
+
+## Data shape
+
+Extend `FrontlitCalibration` **backward-compatibly** (the sanitizer from the review
+fixes must keep accepting Phase-1 records):
+
+```ts
+interface FrontlitCalibration {
+    // existing Phase-1 fields unchanged; opacityLayers/baseColor describe the
+    // anchor read for compatibility
+    ...
+    /** All reads used for the fit (anchor read included). Absent = Phase-1 single read.
+     *  mergeLayers = optional adjacent-step merge point (Phase-3 evidence). */
+    reads?: Array<{ baseColor: string; opacityLayers: number; mergeLayers?: number }>;
+    /** 'heuristic' (Phase-1 ratio model) or 'measured' (multi-base fit). */
+    channelSource?: 'heuristic' | 'measured';
+    /** JND actually used; already stored. Add where it came from. */
+    jndSource?: 'default' | 'session-fit';
+}
+```
+
+Sanitizer: `reads`, `channelSource`, `jndSource` optional; validate elements if
+present. No migration needed — Phase-1 records read as anchor-only.
+
+Confidence: multi-base calibrations with consistent reads score higher; a filament
+whose reads _disagree_ badly under the best fit gets flagged (that disagreement is
+also the scattering signal — see below).
+
+## Phase 3 gate (scattering) — decided by Phase-2 data, not folded in
+
+Phase 3 = upgrading the blend model from single-exponential absorption to something
+scattering-aware (Kubelka-Munk style). **Deliberately NOT included in Phase 2**:
+
+- It adds ~2 parameters per channel per filament; fitting that from a handful of
+  integer reads is ill-conditioned without evidence the extra form is needed.
+- The blend function sits on the optimizer hot path; KM composition is more
+  expensive — only pay if the data demands it.
+- A model-form change shifts every stack prediction (goldens, previews, existing
+  calibrations churn). Do it once, with evidence, not speculatively.
+
+Phase 2 instead **collects the decision data as a byproduct**:
+
+1. Cross-base fit residuals: multi-base reads that no per-channel TD triple can
+   reconcile (beyond integer quantization) → absorption model at its limit. Surface
+   as reduced confidence + a note, per filament.
+2. Adjacent-step merge reads (above) landing systematically earlier than the fitted
+   exponential predicts → long-tail/scattering signature.
+3. Metamer-pair validation disagreements concentrated on stacks involving specific
+   filaments (white/pastel filaments are the likely offenders — TiO2 is nearly pure
+   scattering).
+
+Gate: if ≥2 of these signals agree across the 7-color set, design Phase 3 (likely a
+single scattering-fraction parameter per filament, not full per-channel KM, fitted
+from the same reads). If not, Phase 3 is unnecessary and the exponential stands.
+
+## Explicitly out of scope (v1 of Phase 2)
+
+- **Scattering model itself** — detection only, per the gate above.
+- **Camera/photo anything.** Still banned.
+- **On-screen color matching.** Still banned (monitor problem).
+
+## Validation & acceptance
+
+- **Synthetic round-trips:** generate reads from a known (td_r, td_g, td_b) + JND,
+  run the fit, recover within integer-read quantization (mirrors the Phase-1 test
+  style in `tests/frontlitCalibration.test.ts`).
+- **JND identifiability test:** synthetic multi-filament session with a known JND;
+  the outer fit recovers it; a flat-residual session falls back to 2.0.
+- **Physical acceptance — metamer pairs:** after calibrating the 7-color set, have
+  the app print a small strip of stack _pairs_ the model predicts to be
+  indistinguishable (e.g., "2 layers A over B" next to "1 layer A' over B'" with
+  predicted ΔE00 < JND) plus a few pairs predicted clearly different. Count
+  agreements by eye. This is a yes/no ordinal judgment (camera-free, monitor-free)
+  and directly tests what auto-paint relies on: stacked-blend predictions.
+
+## Open questions / to pin during implementation
+
+- Default bases per filament: 2 vs 3 (read burden vs. fit conditioning).
+- Fit details: exact objective surrogate, regularization weight toward the
+  heuristic prior, grid resolution. Must stay deterministic.
+- Whether the session-fitted JND should retroactively rescale existing Phase-1
+  calibrations (they stored their JND, so it's computable — probably yes, with the
+  stored `jnd` recording what was actually used).
+- Where the metamer-pair validation strip lives in the UI (part of the calibration
+  dialog vs. a separate "verify calibration" action).
diff --git a/.agents/calibration-phase2-review-issues.md b/.agents/calibration-phase2-review-issues.md
new file mode 100644
index 0000000..f7bc5d7
--- /dev/null
+++ b/.agents/calibration-phase2-review-issues.md
@@ -0,0 +1,119 @@
+# Phase 2 review — issues to fix
+
+> **Status: RESOLVED (2026-07-02).** All four items fixed: the session JND fit moved
+> out of the per-keystroke path into `handleSave` (live typing now costs ~60 ms per
+> filament; merge reads no longer retrigger computation), the dead ternary is gone,
+> the measure step gained Base/Match/Merge column headers, tooltips, and an amber
+> warning when merge > match, and the design doc tracks the metamer strip as open.
+> Verified: 227 tests, tsc, eslint green.
+>
+> **Residual follow-ups — RESOLVED (2026-07-02):**
+> 1. ~~Synchronous save freeze~~ — Save now sets an `isSaving` "Fitting…" state,
+>    disables the button, and defers the session fit past a paint
+>    (`requestAnimationFrame` + `setTimeout`), resetting state in `finally`.
+> 2. ~~Band-edge JND acceptance~~ — `fitSessionJnd` rejects solutions at
+>    `JND_FIT_MIN`/`JND_FIT_MAX` and falls back to the default JND; covered by a
+>    regression test with an out-of-band synthetic session.
+> 3. Cosmetic dead "session JND" badge branch in the live measure view — accepted
+>    as-is (the badge still applies to saved calibrations).
+>
+> Verified after the fixes: 228 tests, tsc, eslint green.
+
+Review of the uncommitted Phase 2 implementation (multi-base opacity reads, measured
+per-channel TDs, session JND fit) against
+[calibration-phase2-color.md](calibration-phase2-color.md).
+
+**Overall: the implementation is faithful to the design and the math is right.**
+Multi-base reads fit measured channel TDs with the heuristic as prior (single-read
+degenerates exactly to Phase-1 behavior); the JND session fit uses a center-mode
+residual for identifiability, requires ≥2 multi-base filaments, and has a
+flat-residual fallback to 2.0; reads/channelSource/jndSource persist
+backward-compatibly through the sanitizer; base auto-picking prunes by predicted
+read usefulness and channel diversity; merge reads are stored as evidence only.
+Tests cover the multi-base round-trip, JND recovery (within 0.25 of a synthetic
+truth), and the fallback. 227 tests, tsc, eslint all green.
+
+One significant issue and a few small ones:
+
+---
+
+## 1. HIGH (UX/perf) — the session fit freezes the UI for seconds on every keystroke
+
+`computed` in
+[FilamentCalibrationDialog.tsx](../src/components/FilamentCalibrationDialog.tsx)
+calls `computeFrontlitCalibrationSession` synchronously inside a `useMemo` whose
+deps include `reads` and `mergeReads` — i.e. it re-runs on **every keystroke** in
+the measure step. Once ≥2 filaments have complete multi-base reads, that call
+includes `fitSessionJnd`: ~20 JND candidates × (full channel-TD fit per eligible
+filament), where one fit is ~500 score evaluations × reads × a 36-iteration ΔE00
+bisection.
+
+Measured: the synthetic session test (3 filaments × 3 reads) takes **4.3 s** in
+node; a realistic 3×2 session is on the order of 1.5–3 s. The freeze lands at the
+worst moment — while the user is typing the *last* reads (and typing a merge value,
+which doesn't even affect the fit, retriggers the whole thing). AGENTS.md:
+long-running work must keep the UI responsive.
+
+Suggested fixes, in order of preference (can combine):
+
+1. **Don't refit on keystrokes.** Debounce the session computation (~400 ms) AND
+   exclude `mergeReads` from the fit input entirely (merge values are stored at
+   save time; they have zero effect on the fit — build them into the reads array
+   only in `handleSave`).
+2. **Move the session fit off the main thread** using the existing worker pattern
+   (`useAutoPaintWorker` precedent) if debouncing alone still feels janky.
+3. **Cheapen the fit**: cache `opacityLayerThreshold` results keyed by
+   (td-triple, base, jnd) across the JND grid; cut the bisection to ~20 iterations
+   (layer-resolution accuracy needs far less than 2^-36); skip re-running the
+   per-filament *display* fit when only the JND search is exploring.
+
+A pragmatic minimal version: keep per-filament fits live (each ~25–75 ms, fine),
+but run the **JND session fit only on demand** — when the user leaves the last
+input / presses Save, with the badge updating from "default JND" to "session JND"
+at that point. Everything stays deterministic.
+
+## 2. LOW — pointless ternary in `computeFrontlitCalibration`
+
+[calibration.ts](../src/lib/calibration.ts):
+`const tdSingleValue = reads.length > 1 ? fit.tdSingleValue : fit.tdSingleValue;`
+— both branches are identical. Replace with `const tdSingleValue = fit.tdSingleValue;`.
+
+## 3. LOW (UX) — the "merge" input is unexplained in the dialog
+
+The measure row shows two bare number inputs with placeholders "match" and
+"merge". The docs explain the merge read, but the dialog doesn't — a first-time
+user won't know what to type there or that it's optional. Add a `title` tooltip
+(e.g. "Optional: first patch that looks the same as the patch before it") and/or a
+tiny column-header row above the inputs. Also consider a soft validation hint when
+`mergeLayers > opacityLayers` (physically odd: neighbors can't merge after the
+rail match) — accept it, but flag it visually.
+
+## 4. NOTE (not a defect) — metamer-pair validation strip not included
+
+The design's physical acceptance artifact (printable strips of stacks predicted
+indistinguishable vs. clearly different) is not in this change. Fine to land
+Phase 2 without it, but it is the third Phase-3 gate signal, so it should be
+tracked as the remaining open piece of Phase 2 rather than dropped.
+
+---
+
+## Reviewed and explicitly OK
+
+- Single-read path returns exactly the Phase-1 result (prior = heuristic channel
+  TDs anchored to the T* scalar); no behavior change for quick mode.
+- `tdSingleValue = max(channel TDs)` for multi-read fits — consistent with the
+  brightest-channel-anchor convention.
+- JND fit: center-mode residual (interval mode would be flat within quantization
+  intervals → unidentifiable); ≥2 eligible filaments required; improvement
+  threshold before accepting; deterministic coarse+fine grid in [1.0, 3.0].
+- Session JND, when fitted, is applied to the same session's single-read filaments
+  too, and recorded via `jndSource: 'session-fit'` — matches the design.
+- Sanitizer extensions are strict (bad `reads`/`channelSource`/`jndSource` reject
+  the whole record) and Phase-1 records without `reads` still pass.
+- Base auto-pick: prunes no-contrast and predicted-read-1 / >maxLayers pairs,
+  anchors on the darkest useful base, prefers channel diversity then mid-wedge
+  predicted reads; accurate mode defaults to 2 bases, capped at 3.
+- Disagreeing multi-base reads (rms > 0.75 layers) reduce confidence and append a
+  note — the Phase-3 residual signal is surfaced as designed.
+- Uncalibrated filaments' predictions for pruning use `td × 0.1` mirroring
+  `FRONTLIT_TD_SCALE` — consistent with auto-paint's fallback.
diff --git a/.agents/hiding-distance-migration.md b/.agents/hiding-distance-migration.md
new file mode 100644
index 0000000..b4fea21
--- /dev/null
+++ b/.agents/hiding-distance-migration.md
@@ -0,0 +1,207 @@
+# Hiding Distance — rename, single-meaning storage, and per-channel model
+
+> **Status: IMPLEMENTED (2026-07-03, by Claude).** All sections landed, including the
+> folded-in nextBestColor work (§4). Verified: 240 tests (12 new), tsc, eslint green;
+> 24 auto-paint goldens regenerated; the calibrated-path regression guard
+> (`tests/assets/autopaint-calibrated-baseline.json`, captured pre-change) proves
+> byte-identical output for the 8-color calibrated profile. Implementation notes vs
+> plan: `effectiveFrontlitTd` was unnecessary (single-meaning storage covers it);
+> `.kapp` test fixtures stay authentic v1 files with migration applied in the
+> fixture readers; the `profileManager→calibration→colorSpace/colorDifference/colorUtils`
+> import chain gained explicit `.ts` extensions for plain-node test/script loading;
+> one nextBestColor ranking test updated (linear light legitimately changes the
+> winning candidate, and its old assertion contradicted its own comment).
+>
+> **Post-implementation self-review (2026-07-03)** found and fixed two issues:
+> (1) the ×0.1 migration now rounds to 4 decimals — raw doubles like
+> `1.1 × 0.1 = 0.11000000000000001` would have shown verbatim in the HD input;
+> (2) migration gates re-keyed to fixed version constants (`TD_MIGRATION_VERSION`
+> in profileManager, `>=` schema check in App.tsx) so a future v3 bump cannot
+> re-apply the ×0.1 to v2 data. Goldens regenerated once more after the rounding
+> change (a 1e-18 td delta had flipped one optimizer scenario). Final state:
+> 240 tests, tsc, eslint green.
+
+Status: implemented.
+**Supersedes** [next-best-color-td-fix.md](next-best-color-td-fix.md) (never started —
+its defects are either auto-resolved by this migration or folded in below).
+
+## Decisions (user-approved)
+
+- **Name:** "Hiding Distance" (HD), unit mm — the depth of material at which a
+  filament visually hides what's beneath it. Display/docs rename only; the storage
+  field stays `td` (`.kfil` compat is a user-data boundary per AGENTS.md).
+- **Storage becomes single-meaning:** `filament.td` always stores the *frontlit*
+  hiding distance, for calibrated and uncalibrated filaments alike. The current
+  dual meaning (backlit-community scale for uncalibrated, frontlit for calibrated,
+  reconciled by a runtime ×0.1) is the root cause of the nextBestColor bug class
+  and dies here.
+- **Conventional TD entry:** users can still type a spool-sheet / MakerWorld-test
+  TD; the UI converts it (× `FRONTLIT_TD_SCALE = 0.1`) at entry. The factor is
+  empirically validated: the user's physical calibration of 8 filaments measured
+  HD ≈ old backlit TD × 0.1 across the set.
+- **Uncalibrated filaments get heuristic per-channel HDs** (approved sub-decision).
+  Today they blend channel-uniform (`[td,td,td]`); the `deriveChannelTds` color
+  heuristic is only used inside calibration fitting. After this change every
+  filament blends with channel HDs — measured (calibrated) or derived from the
+  swatch color (uncalibrated). This is the biggest behavior change in the bundle:
+  uncalibrated blend outputs change and goldens must be regenerated.
+
+## 1. Data migration (the critical part — treat as a persistence boundary)
+
+New semantic: `td` = frontlit HD. Old uncalibrated values (~1–6) must be scaled
+×0.1 exactly once.
+
+- Bump `CURRENT_PROFILE_VERSION` 1 → 2 in
+  [profileManager.ts](../src/lib/profileManager.ts). Migration rule applied on
+  every load/import when `version < 2` (or missing):
+  - filament **without** valid calibration → `td *= FRONTLIT_TD_SCALE`
+  - filament **with** calibration → `td = calibration.tdSingleValue` (defensive
+    re-sync; already equal in practice)
+  - stamp `version: 2`.
+- Apply in **all three load paths** (same trio as the legacy-calibration
+  stripping): `loadProfiles` (localStorage `kromacut.autopaint.profiles`),
+  `importProfiles` (`.kfil` files in the wild are version 1 — must convert on
+  import), and `loadAutoPaintPersisted` in [App.tsx](../src/App.tsx).
+  - ⚠️ `kromacut.autopaint.v1` has **no version field**. Add one to the persisted
+    shape (e.g. `schemaVersion: 2`); absent ⇒ old ⇒ migrate filaments as above,
+    then persist with the marker. Do not key the migration off heuristics like
+    "td looks big".
+- New exports write `version: 2`. Importing a v2 file must NOT re-scale
+  (regression test: double-import idempotence).
+- Do not clamp or "sanitize" values during migration beyond the existing filament
+  validation — convert as-is.
+
+## 2. Runtime model — delete the ×0.1 layer, add channel HDs everywhere
+
+- **Move `FRONTLIT_TD_SCALE` to [calibration.ts](../src/lib/calibration.ts)** and
+  export it; it survives only as (a) the entry-conversion factor and (b) the
+  migration factor. Delete `scaleFilamentForFrontlight` from
+  [autoPaint.ts](../src/lib/autoPaint.ts) and both call sites (~lines 1430, 1545)
+  — post-migration, `td` is already frontlit.
+- **`autoPaint.ts:1633`** (`totalTD = Σ f.td × FRONTLIT_TD_SCALE`): note this
+  currently scales raw tds of ALL filaments — for calibrated filaments that is a
+  latent double-scaling bug today. Replace with `Σ f.td` (now uniformly HD) and
+  check what consumes it for a behavior impact note.
+- **Shared channel helper** in calibration.ts:
+
+  ```ts
+  /** Per-channel hiding distances: measured when calibrated, else derived
+   *  from the swatch color around the scalar HD. */
+  export function channelHds(filament: { color: string; td: number; calibration?: unknown }): CalibrationRgb {
+      return sanitizeFrontlitCalibration(filament.calibration)?.td
+          ?? deriveChannelTds(filament.color, filament.td);
+  }
+  ```
+
+  Replace `calibratedTdChannels` (autoPaint.ts:406) with it; drop the
+  `USE_CALIBRATED_CHANNEL_TD` flag. Audit that every blend/transition consumer
+  (`blendColors`, `calculateTransitionThickness`, transition zones, optimizer
+  scoring context, worker payloads, optimizer cache keys) now receives channel
+  HDs for uncalibrated filaments too. Cache keys already include color+td, so
+  derived channels are covered.
+- **`estimateTDFromColor`** ([colorUtils.ts:39](../src/lib/colorUtils.ts#L39)):
+  re-baseline to return HD directly — `(1.0 + luminance × 5.8) × FRONTLIT_TD_SCALE`
+  (≈0.10–0.68). Rename to `estimateHidingDistanceFromColor` (keep an alias export
+  only if call-site churn is a concern; prefer full rename, it's internal).
+  Call sites: FilamentRow wand (:176), `useFilaments.ts:19` default for new
+  filaments.
+- **`computeProfileConfidence`** uncalibrated plausibility bands rescale ×0.1:
+  `1.0–5.0 → 0.10–0.50` (0.5 score), `0.5–10 → 0.05–1.0` (0.3 score).
+- **FilamentCalibrationDialog `estimateChannelTds`** (:207): the `filament.td * 0.1`
+  becomes just `filament.td` (or the shared `channelHds` helper — preferred).
+- **Calibration flow itself is unchanged** — it already produces and stores HD.
+
+## 3. UI
+
+- **Label rename:** "TD" → "HD" wherever shown (FilamentRow input suffix,
+  calibration dialog select list + fit card "TD 0.51mm" → "HD 0.51 mm",
+  next-best-color suggestion card). Tooltip on the input: "Hiding distance (mm):
+  depth at which this filament hides what's beneath it. Measured by calibration,
+  or estimated from color."
+- **Input range:** current blur clamp is `0.1–100` — black's measured 0.05 can't
+  even be typed. New clamp ~`0.01–2.0`, step 0.01.
+- **"From TD" conversion affordance** on the filament row (small button or popover
+  next to the HD input): user enters a conventional/backlit TD value, field stores
+  `value × FRONTLIT_TD_SCALE`, marked uncalibrated (clears calibration like any
+  manual edit). Label it plainly, e.g. "Convert from TD (lithophane/backlit
+  value)". This is the community-facing bridge — keep it discoverable.
+- **Per-channel visibility (read-only):** show `R/G/B` HD values (2 decimals, mm)
+  — for calibrated filaments on the existing calibration badge tooltip labeled
+  "measured"; for uncalibrated on the HD input tooltip labeled "estimated from
+  color". No editing of channels (manual scalar edits already clear calibration —
+  keep that semantics).
+- New-filament default (`useFilaments.ts`) comes out on HD scale automatically via
+  the re-baselined estimator.
+
+## 4. nextBestColor (folded in from the superseded plan)
+
+Post-migration, its raw `f.td` usage becomes correct automatically (the old plan's
+defects #1 and #2 vanish). Remaining work:
+
+- `recommendedTd` (:386) needs **no conversion** — it borrows the neighbor's td,
+  which is now HD, and the added filament's uncalibrated path expects HD. Just
+  verify and update the card label.
+- **Blend in linear light**: `blendRgb` (:107) lerps gamma sRGB; rework to lerp in
+  linear light matching `blendSrgbChannel` semantics (linearise/delinearise
+  helpers already exist in-file), and fix the stale "matches autoPaint's
+  blendColors" comment.
+- Keep scalar-HD curves (no per-channel in this heuristic — planning tool, keep it
+  light). No changes to candidate generation/scoring/ranking.
+
+## 5. Tests
+
+- **Migration:** v1 profile (uncalibrated td 4.0) loads as 0.40; calibrated
+  filament untouched; v2 double-import idempotent; `kromacut.autopaint.v1` without
+  the schema marker migrates once; mixed profile correct. Extend
+  `tests/profileManager.test.ts`.
+- **Calibrated-path regression (the key acceptance guard):** auto-paint output for
+  an all-calibrated profile (use
+  `tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`) must be
+  **identical before and after this change** — calibrated filaments' channel HDs
+  and scalars are untouched by the migration.
+- **Uncalibrated behavior change:** goldens change intentionally (channel HDs +
+  no more runtime scaling — net optics identical in magnitude but now
+  color-shaped). Regenerate via `npm run test:autopaint:update`; re-check
+  `autoPaintQuality` budgets still pass.
+- **Estimator rescale:** `estimateHidingDistanceFromColor('#ffffff') ≈ 0.68`,
+  `('#000000') = 0.1`.
+- **channelHds helper:** calibrated → measured triple; uncalibrated → derived
+  triple anchored at the scalar.
+- **nextBestColor:** new `tests/nextBestColor.test.ts` — linear-light blend spot
+  check (50% transmission of white over black ≈ linear midpoint ~188 sRGB, not
+  128); suggestion for the calibrated fixture returns `candidate.td` on HD scale
+  (~0.3–0.6); recommendedTd ≈ nearest neighbor's td.
+
+## 6. Docs & changelog
+
+- `src/docs/` (`3d-mode.md` filament/TD sections + calibration walkthrough,
+  `settings-and-controls.md`, `troubleshooting.md`, `quick-start.md` — grep for
+  "TD" and "Transmission Distance"): rename to Hiding Distance with a one-line
+  bridge ("previously shown as TD; conventional lithophane TD values can be
+  entered via Convert from TD — they're ≈10× the hiding distance").
+- `CHANGELOG.md` (unreleased): under **Changed**, one bullet covering: the rename,
+  the single-meaning storage + automatic one-time conversion of existing profiles
+  and `.kfil` imports (call out `version: 2`), the Convert-from-TD entry, and
+  per-channel blending for uncalibrated filaments. The latent
+  calibrated-double-scaling fix at autoPaint.ts:1633 goes under **Fixed** only if
+  it changed released behavior — it's within the unreleased calibration work, so
+  fold it in.
+- AGENTS.md "Domain Notes" TD bullet: update the terminology so future agents
+  aren't taught the old dual meaning.
+
+## Acceptance
+
+- Old `.kfil` (v1, uncalibrated td 4.0) imports as HD 0.40; exporting produces v2;
+  re-importing that is a no-op.
+- `8_Colors_Calibrated_New` profile: identical auto-paint output pre/post change.
+- New filament defaults, wand estimates, and next-best suggestions all land in
+  ~0.1–0.7 HD range.
+- UI shows "HD"; typing a conventional TD via the converter stores value×0.1.
+- Full suite + regenerated goldens + tsc + lint green.
+
+## Out of scope
+
+- Renaming the `td` storage field or `FrontlitCalibration.td` (data compat).
+- Editable per-channel values.
+- Per-channel curves in nextBestColor.
+- Any calibration-flow changes (it already produces HD).
diff --git a/.agents/next-best-color-td-fix.md b/.agents/next-best-color-td-fix.md
new file mode 100644
index 0000000..949e7ad
--- /dev/null
+++ b/.agents/next-best-color-td-fix.md
@@ -0,0 +1,174 @@
+# Fix next-best-color TD scale handling (post-calibration cleanup)
+
+> **SUPERSEDED (2026-07-02) — do not implement.** Execution never started; this
+> plan is replaced by [hiding-distance-migration.md](hiding-distance-migration.md),
+> which makes `filament.td` single-meaning (always frontlit hiding distance). That
+> migration auto-resolves defects #1 and #2 below, and its §4 carries over the
+> remaining work (linear-light blend + tests). Kept for the defect analysis.
+
+Status: superseded.
+
+## Context
+
+`src/lib/nextBestColor.ts` (the "Suggest next filament" heuristic, run in
+`nextBestColor.worker.ts`) predates the frontlit calibration work and still treats
+`filament.td` as one homogeneous quantity. Since Phase 1/2, `td` means two
+different things:
+
+- **Uncalibrated filament:** backlit-community-scale TD (what users type from spool
+  sheets / TD test prints, ~1–6 mm). Auto-paint multiplies it by
+  `FRONTLIT_TD_SCALE = 0.1` before simulating (`scaleFilamentForFrontlight`,
+  [autoPaint.ts:415](../src/lib/autoPaint.ts#L415)).
+- **Calibrated filament:** measured *frontlit* blending distance (~0.2–0.6 mm),
+  consumed as-is.
+
+`nextBestColor` receives **raw** profile filaments and never distinguishes the two.
+Verified against the user's real calibrated profile
+(`tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`, frontlit TDs
+0.37–0.56 mm).
+
+## The three defects
+
+### 1. Simulation mixes incommensurate TD scales
+
+`blendRgb`/`buildBlendCurve` use raw `f.td`
+([nextBestColor.ts:205](../src/lib/nextBestColor.ts#L205), :221–222, :323–324).
+
+- All-calibrated profile: curves are frontlit-consistent by accident (raw = frontlit). OK.
+- All-uncalibrated profile: curves are ~10× too transmissive vs. what auto-paint
+  will actually do (pre-existing bug, predates calibration).
+- **Mixed profile: nonsense** — a calibrated 0.4 mm filament and an uncalibrated
+  4.0 mm filament are blended on the same curves as if commensurate.
+
+### 2. `recommendedTd` output is on the wrong scale for calibrated profiles
+
+The suggestion borrows the nearest filament's raw `td`
+([nextBestColor.ts:379-386](../src/lib/nextBestColor.ts#L379-L386)) and
+AutoPaintTab adds the suggested filament **uncalibrated** with that value
+([AutoPaintTab.tsx:1204](../src/components/AutoPaintTab.tsx#L1204)). The pipeline
+then multiplies it by 0.1:
+
+- Nearest filament uncalibrated (td 4.0) → suggestion 4.0 → effective 0.40 ✓
+- Nearest filament calibrated (td 0.40) → suggestion 0.40 → **effective 0.04 mm,
+  ~10× too opaque**. This is the broken case for every calibrated profile — the
+  user's new normal.
+
+### 3. Blend runs in gamma space; auto-paint blends in linear light
+
+`blendRgb` ([nextBestColor.ts:107-111](../src/lib/nextBestColor.ts#L107-L111))
+lerps raw sRGB values. Its comment claims it "matches autoPaint's blendColors",
+but auto-paint moved to linear-light compositing (`blendSrgbChannel` in
+[colorSpace.ts:30](../src/lib/colorSpace.ts#L30)) in this release cycle. The
+comment is stale and the curves are systematically darker mid-blend than the real
+pipeline's.
+
+## Fix
+
+### A. Single source of truth for the effective frontlit TD
+
+Move the constant + add a helper in **`src/lib/calibration.ts`** (a leaf module the
+worker can import without dragging in autoPaint's optimizer — the reason
+nextBestColor inlines its color math):
+
+```ts
+export const FRONTLIT_TD_SCALE = 0.1;
+
+/** Scalar frontlit TD for simulation: measured value if calibrated, else the
+ *  backlit-scale user entry scaled down. Mirrors auto-paint's
+ *  scaleFilamentForFrontlight. */
+export function effectiveFrontlitTd(filament: {
+    td: number;
+    calibration?: unknown;
+}): number {
+    return sanitizeFrontlitCalibration(filament.calibration)
+        ? filament.td
+        : filament.td * FRONTLIT_TD_SCALE;
+}
+```
+
+Update `autoPaint.ts` to import `FRONTLIT_TD_SCALE` from calibration.ts (delete its
+local copy; keep `scaleFilamentForFrontlight`'s behavior identical — it can use the
+helper for the scalar). No behavior change in auto-paint; regression-covered by the
+existing legacy-calibration test.
+
+### B. Normalize TDs at the top of `nextBestColor`
+
+```ts
+const filamentTds: number[] = filaments.map((f) => effectiveFrontlitTd(f));
+```
+
+Everything downstream (pair curves, `estimatedTd`, candidate curves, winner
+curves) then runs on commensurate frontlit values. Note `buildBlendCurve`'s span
+(`3 × fgTd`) becomes ~1.2 mm instead of ~12 mm for uncalibrated filaments — that is
+the fix working, not a regression.
+
+### C. Emit `recommendedTd` on the uncalibrated (backlit) scale
+
+The suggested filament is added *uncalibrated*, so its stored td must be what the
+×0.1 path expects. Convert the borrowed effective value back:
+
+```ts
+const recommendedTd = effectiveFrontlitTd(filaments[nearestFilamentIdx]) / FRONTLIT_TD_SCALE;
+```
+
+(≡ unchanged value when borrowing from an uncalibrated filament; ×10 when borrowing
+from a calibrated one.) Keep borrowing from the nearest filament by ΔE — it
+captures material similarity; `estimateTDFromColor` remains the wand's job.
+
+### D. Blend in linear light
+
+Rework `blendRgb` to lerp in linear light and return sRGB, matching
+`blendSrgbChannel` semantics. The linearise/delinearise helpers already exist in
+this file (used by `rgbToLab`/`labToHex`) — reuse them rather than importing
+colorSpace, to keep the worker bundle self-contained (or import from
+`colorSpace.ts` if the bundle impact is nil — implementer's choice; colorSpace is
+tiny and React-free). Fix the stale comment either way.
+
+Scalar-TD-only curves remain fine for this heuristic (see non-goals).
+
+## Tests
+
+There is currently no `nextBestColor` test. Add `tests/nextBestColor.test.ts`
+(vite-ssr loader pattern like `frontlitCalibration.test.ts`) covering at least:
+
+1. **Scale normalization:** two profiles describing the *same physical filaments* —
+   one uncalibrated (td 4.0), one calibrated (td 0.40 + valid `FrontlitCalibration`
+   with matching channel TDs) — produce the **same suggestion hex** for the same
+   swatches (curves identical after normalization).
+2. **Recommended TD scale:** with a calibrated profile, the returned
+   `candidate.td` is on the backlit scale (≈ borrowed frontlit value ÷ 0.1), so
+   that `effectiveFrontlitTd({ td: candidate.td })` ≈ the neighbor's measured
+   frontlit TD.
+3. **Linear-light blend:** `blendRgb`-equivalent output matches
+   `blendSrgbChannel` for a couple of spot values (e.g. 50% transmission of white
+   over black ≈ linear-light midpoint ~188, not gamma midpoint 128).
+
+The `8_Colors_Calibrated_New.kfil` fixture can serve as realistic calibrated input
+for test 1/2 if convenient.
+
+## Docs & changelog
+
+- `CHANGELOG.md` (unreleased): under **Fixed** — suggestion TD now accounts for
+  calibrated (frontlit) profiles instead of recommending a 10×-too-opaque value;
+  suggestion blending matches the linear-light optical model. Per AGENTS.md, if it
+  reads better, fold into the existing next-best-color bullet's section instead of
+  a standalone entry (the feature shipped in v3.1.0, so **Fixed** is correct).
+- `src/docs/*`: only if any doc states how the recommended TD is derived (check
+  `3d-mode.md`'s suggestion paragraph); the user-visible behavior ("recommended
+  starting TD") is unchanged in kind.
+
+## Non-goals (explicitly out of scope)
+
+- **No renaming of TD anywhere** (UI labels, fields, docs). The
+  "blending distance" naming discussion is a separate, user-gated task.
+- No per-channel TD curves in the suggestion heuristic — scalar effective TD is
+  sufficient for inventory planning; keep the module light.
+- No changes to candidate generation, scoring weights, or ranking.
+- No changes to auto-paint behavior — step A must be a pure refactor there.
+
+## Acceptance
+
+- `npm test` green (including the new nextBestColor tests), `npx tsc -b` and
+  `npm run lint` clean.
+- Manual sanity: with `8_Colors_Calibrated_New` loaded, "Suggest next filament"
+  returns a candidate whose TD is ~3–6 (backlit scale), not ~0.4.
diff --git a/.agents/print-findings/2026-07-02-logo-test/findings.md b/.agents/print-findings/2026-07-02-logo-test/findings.md
new file mode 100644
index 0000000..6113e2f
--- /dev/null
+++ b/.agents/print-findings/2026-07-02-logo-test/findings.md
@@ -0,0 +1,89 @@
+# Print findings — Kromacut logo test (2026-07-02)
+
+![alt text](image.png)
+![alt text](print-photo.jpg)
+
+First real auto-paint print with the measured frontlit calibration
+(`tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`, 8 filaments,
+accurate-mode 2-base reads, JND 2.0 default).
+
+Images: `image.png` — the app's 3D preview projection; `print-photo.jpg` — photo
+of the physical print on a dark mat (downscaled from the 22 MB camera original,
+which stays untracked next to it).
+
+Print setup: normal mode (NOT flat paint — no transparent carrier; the grey rim
+in the photo is a border/brim, not a carrier). Transition opacity: default
+(0.8 unless changed). Layer height 0.08 mm.
+
+## Overall verdict
+
+- **Hue placement is accurate across the whole wheel** — green→yellow→orange→red
+  transitions and the purple family land where the preview says. The calibrated
+  endpoints are doing their job.
+- **Systematic desaturation/wash:** the print is uniformly lighter and less
+  saturated than the preview, worst in dark saturated colors (cyan → pale blue,
+  violet → lavender, red → orange-ish).
+
+## Specific failures (user-observed)
+
+1. **Orange over pink did not shift toward red** as the preview predicted — it
+   stayed orange.
+2. **First layer of cyan over purple is not the predicted darker blue** — it
+   reads as light, washed purplish.
+
+## Analysis
+
+### Weak-channel TDs are heuristic floors, not measurements (primary suspect)
+
+Both failures are thin layers over a saturated, differently-hued base, failing
+the same way: the model predicts the top filament's complementary channel kills
+the base almost instantly; physically it does not.
+
+- Cyan `#00b8c4` fitted `td = [0.068, 0.354, 0.373]`. `td_R = 0.068 mm` ⇒ one
+  0.08 mm layer transmits only ~7% red ⇒ purple's red should die ⇒ dark blue.
+  Reality: red survives ⇒ true `td_R` is substantially larger.
+- That 0.068 was never measured: cyan's swatch R = 0, so the `1 + c×5.8`
+  heuristic pins the channel at its floor, and the black + white base reads
+  constrain it weakly — the fit's regularization left it at the prior. Same for
+  orange `#d83400`'s G/B channels (0.137 / 0.103) interacting with pink.
+- **Actionable:** recalibrate with complementary-hue bases that stress the weak
+  channel directly — cyan over a red/orange base (pins `td_R`), orange over a
+  cyan/blue base (pins `td_G`/`td_B`). Accurate mode's manual base override
+  supports this today. More generally: the auto base picker prefers channel
+  diversity but chose black+white here; consider whether it should specifically
+  seek a base that is bright in the filament's darkest channel.
+
+### Partial-opacity stacks (contributing, magnitude unknown)
+
+Auto-paint stops stacks at the transition-opacity target (default 0.8), so
+regions show ~20% of the underlying stack. The calibration pins the opacity
+*endpoint*; the *interior* of the curve is assumed exponential per channel. If
+real filaments scatter, partial stacks pick up unmodeled white backscatter →
+wash. Cheap probe: reprint a section at transition opacity 0.95 and compare
+saturation gain against the preview's own change.
+
+### Emissive display vs reflective print (irreducible)
+
+The preview on a dark background on a monitor emits saturated light a reflective
+object cannot return; deep blues/cyans suffer most. Even a perfect model looks
+more vivid on screen. Sets a ceiling on "matching the preview".
+
+## Phase-3 gate ledger (scattering evidence)
+
+Signal 3 (stack prediction failures): **one entry, partially implicating.** The
+wash direction (extra lightness, weak complementary-channel kill in thin layers)
+is consistent with scattering, but confounded with the heuristic-floor channel
+TDs, which absorption-model recalibration with better bases may fix. Signals 1
+(fit residuals) and 2 (merge reads) from the calibration session remain
+negative. **Gate still not triggered** — retest after complementary-base
+recalibration.
+
+## Follow-ups (in order)
+
+1. Recalibrate cyan (red base) and orange (cyan/blue base); reprint the affected
+   regions or small stack patches; recheck failures 1 and 2.
+2. Transition-opacity 0.95 comparison print for the wash magnitude question.
+3. Build the metamer-pair validation strip (still-open Phase 2 item) — it tests
+   exactly these cross-color stack predictions in a controlled way.
+4. If failures persist with well-pinned channels → real Phase-3 (scattering)
+   evidence; revisit the gate.
diff --git a/.agents/print-findings/2026-07-02-logo-test/image.png b/.agents/print-findings/2026-07-02-logo-test/image.png
new file mode 100644
index 0000000000000000000000000000000000000000..ea2b7cbea2d69fd0bce6cefa4422b6df781d7f49
GIT binary patch
literal 68424
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
U+a0v7;11SxB`w8rc~kWN0UJ6N6#xJL

literal 0
HcmV?d00001

diff --git a/.agents/print-findings/2026-07-02-logo-test/print-photo.jpg b/.agents/print-findings/2026-07-02-logo-test/print-photo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..7eaf0312d6f427394d164c74439e3777d7d7a46d
GIT binary patch
literal 496982
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%0A-oDsRHG7^<{6<PgS_Max
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

literal 0
HcmV?d00001

diff --git a/.gitignore b/.gitignore
index 4cbec2b..44757d0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -32,3 +32,6 @@ test-results/
 src-tauri/target/
 src-tauri/gen/
 src-tauri/WixTools/
+
+# Full-size camera originals in print findings (compressed copies are committed)
+.agents/print-findings/**/DSC*.JPG
diff --git a/AGENTS.md b/AGENTS.md
index 0379664..8e52645 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,9 +13,12 @@ geometry, slicer behavior, and print instructions at the same time.
 
 ## Domain Notes
 
-- **Transmission Distance (TD):** Used by auto-paint to model light through thin filament layers
-  with Beer-Lambert-style optical simulation. TD is not just a display value; changing how it is
-  stored or rounded can change generated layer stacks.
+- **Hiding Distance (HD):** Used by auto-paint to model light through thin filament layers with
+  Beer-Lambert-style optical simulation. `filament.td` stores the frontlit hiding distance in mm
+  (profile schema v2); the field keeps its historical `td` name for data compatibility. Conventional
+  backlit/lithophane Transmission Distance values are an *input format* only — converted ×0.1
+  (`FRONTLIT_TD_SCALE`) at entry or during the one-time v1→v2 migration, never stored. HD is not
+  just a display value; changing how it is stored or rounded can change generated layer stacks.
 - **Auto-paint layers:** Auto-paint chooses physical filament stacks for target image colors. The
   worker path exists so optimizer choices such as exhaustive, simulated annealing, and genetic
   search do not freeze the UI.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ac338f4..b34f856 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
+- **Hiding Distance replaces TD** - Filament opacity is now expressed as a frontlit **Hiding Distance (HD)** in millimetres: the depth at which a filament visually hides what's beneath it, matching how prints are actually viewed. Stored values become single-meaning (profile schema v2): uncalibrated values from older profiles, `.kfil`/`.kapp` files, and saved app state are converted automatically (×0.1, one time) on load or import, and the old internal frontlit scaling layer is removed — this also fixes calibrated filaments being double-scaled in the recommended-height estimate. A convert button on each filament row accepts conventional backlit/lithophane TD values (≈10× the HD) and converts them on entry, the wand estimate now produces HD directly, and per-channel values are visible in tooltips. Uncalibrated filaments now blend with per-channel hiding distances estimated from their color (previously channel-uniform), so uncalibrated previews and stacks are more color-faithful; the next-filament suggestion simulates blends in linear light and recommends HDs on the stored scale.
 - **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
 - **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Legacy saved values migrate to the nearest current tier.
 - **Auto-paint optical model** - Beer-Lambert blending now runs in linear-light sRGB, and calibrated filaments use measured RGB-channel TDs for blend simulation and transition-zone thickness. Recalibrate profiles created with earlier releases before using them for new prints.
diff --git a/README.md b/README.md
index 9004c14..1c3ae97 100644
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ Open-source HueForge-style tool for converting images into stacked, color-layere
 
 Kromacut is a browser-first app that converts images into multi-color lithophane 3D prints. It offers two powerful workflows:
 
-**Auto-paint mode** — Define your actual filaments (color + Transmission Distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, five deterministic optimizer effort tiers, and region weighting for spatial priority.
+**Auto-paint mode** — Define your actual filaments (color + hiding distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, five deterministic optimizer effort tiers, and region weighting for spatial priority.
 
 **Manual mode** — Reduce images to a small palette, manually tweak per-color layer heights and ordering, and fine-tune every aspect of the stack with complete control.
 
@@ -44,7 +44,7 @@ Another minimal test you can try yourself: the included Transmission Distance (T
 - 3D model export to binary STL or 3MF (Preview) suitable for multi-material slicers.
 - Plain-text 3D print instructions that describe layer heights and exact layers where filament swaps are required.
 - Copy-to-clipboard button for the print instructions (produces a clean, copyable plain-text plan).
-- **Filament calibration wizard** — Accurately determine Transmission Distance (TD) values through measured samples with confidence scoring.
+- **Filament calibration** — Accurately measure frontlit hiding distances from a camera-free printed wedge, with per-channel values and confidence scoring.
 - **Advanced optimizer** — Five deterministic effort tiers search for optimal filament ordering, from quick previews to exact base-order enumeration.
 - **Region weighting** — Prioritize accuracy in specific image areas (center, edges) during auto-paint optimization.
 
diff --git a/src/App.tsx b/src/App.tsx
index aa58ad1..c2c3187 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -43,7 +43,7 @@ import { defaultDocSlug } from './docs';
 import { loadCameraMode, saveCameraMode } from './lib/cameraPrefs';
 import { buildDocsPath, parseDocsLocation } from './lib/docs/navigation';
 import { applyHomeSeo } from './lib/seo';
-import { sanitizeProfileFilament } from './lib/profileManager';
+import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
 import {
     AlertDialog,
     AlertDialogContent,
@@ -93,6 +93,11 @@ type AutoPaintPersisted = Pick<
     | 'flatPaint'
 >;
 
+// Schema v2: filament `td` values store frontlit hiding distances. State
+// persisted without this marker predates the change and carries uncalibrated
+// tds on the conventional backlit scale, which must be migrated once on load.
+const AUTOPAINT_SCHEMA_VERSION = 2;
+
 function isOneOf<T extends readonly number[]>(value: unknown, values: T): value is T[number] {
     return typeof value === 'number' && values.includes(value as T[number]);
 }
@@ -113,13 +118,19 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const parsed = JSON.parse(raw) as any;
         if (!parsed || !Array.isArray(parsed.filaments)) return null;
-        const filaments = parsed.filaments
+        const sanitized = parsed.filaments
             .map((filament: unknown) => sanitizeProfileFilament(filament))
             .filter(
                 (filament: ReturnType<typeof sanitizeProfileFilament>): filament is NonNullable<
                     ReturnType<typeof sanitizeProfileFilament>
                 > => filament !== null
             );
+        const persistedSchema =
+            typeof parsed.schemaVersion === 'number' ? parsed.schemaVersion : 1;
+        const filaments =
+            persistedSchema >= AUTOPAINT_SCHEMA_VERSION
+                ? sanitized
+                : sanitized.map(migrateLegacyFilamentTd);
         // Migrate legacy `autoPaintEnabled` boolean → `paintMode`
         const paintMode: 'manual' | 'autopaint' =
             parsed.paintMode === 'autopaint' || parsed.paintMode === 'manual'
@@ -151,7 +162,10 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
 
 const saveAutoPaintPersisted = (value: AutoPaintPersisted) => {
     try {
-        localStorage.setItem(AUTOPAINT_STORAGE_KEY, JSON.stringify(value));
+        localStorage.setItem(
+            AUTOPAINT_STORAGE_KEY,
+            JSON.stringify({ schemaVersion: AUTOPAINT_SCHEMA_VERSION, ...value })
+        );
     } catch {
         // ignore storage errors
     }
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index c231a34..d5ad631 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -1165,8 +1165,8 @@ export default function AutoPaintTab({
                                         </span>
                                     </div>
                                     <div className="grid grid-cols-3 gap-1.5 text-[10px] text-muted-foreground">
-                                        <span title="Recommended starting transmittance-distance value, borrowed from the nearest existing filament by color distance (ΔE).">
-                                            TD:{' '}
+                                        <span title="Recommended starting hiding distance (mm), borrowed from the nearest existing filament by color distance (ΔE).">
+                                            HD:{' '}
                                             <span className="font-semibold text-foreground">
                                                 {nextBestResult.candidate.td.toFixed(2)}
                                             </span>
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index fdda748..cdacec1 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -34,12 +34,11 @@ import {
 import { cn } from '@/lib/utils';
 import type { Filament } from '../types';
 import {
+    channelHds,
     computeFrontlitCalibration,
     computeFrontlitCalibrationSession,
-    deriveChannelTds,
     predictFrontlitColor,
     predictOpacityLayersForTds,
-    sanitizeFrontlitCalibration,
     solveOpacityTransmission,
     getConfidenceLabel,
     getConfidenceColor,
@@ -201,11 +200,11 @@ export function FilamentCalibrationDialog({
         [filaments]
     );
 
-    const estimateChannelTds = useCallback((filament: Filament): [number, number, number] => {
-        const calibration = sanitizeFrontlitCalibration(filament.calibration);
-        if (calibration) return calibration.td;
-        return deriveChannelTds(filament.color, Math.max(0.05, filament.td * 0.1));
-    }, []);
+    const estimateChannelTds = useCallback(
+        // `td` already stores the frontlit hiding distance (schema v2).
+        (filament: Filament): [number, number, number] => channelHds(filament),
+        []
+    );
 
     const recommendedBaseIds = useCallback(
         (filament: Filament): string[] => {
@@ -616,7 +615,7 @@ export function FilamentCalibrationDialog({
                                         {filamentLabel(filament)}
                                     </span>
                                     <span className="block text-xs text-muted-foreground">
-                                        TD {filament.td.toFixed(2)}mm
+                                        HD {filament.td.toFixed(2)} mm
                                         {isCalibrated ? ' · calibrated' : ''}
                                     </span>
                                 </span>
@@ -645,7 +644,7 @@ export function FilamentCalibrationDialog({
             <div className="space-y-4">
                 <p className="text-sm text-muted-foreground">
                     Quick mode uses one base per filament. Accurate mode repeats the same read over
-                    multiple bases so Kromacut can measure RGB TDs directly.
+                    multiple bases so Kromacut can measure RGB hiding distances directly.
                 </p>
                 <div className="grid grid-cols-2 gap-2">
                     <Button
@@ -890,6 +889,16 @@ export function FilamentCalibrationDialog({
                 <p className="text-sm text-muted-foreground">
                     Enter the first patch number that matched the rail for each filament/base print.
                 </p>
+                <div className="grid gap-1 rounded-md border border-border/50 bg-muted/20 px-3 py-2 text-[11px] text-muted-foreground sm:grid-cols-2">
+                    <div>
+                        <span className="font-semibold text-foreground">Match:</span> first patch
+                        that matches the rail.
+                    </div>
+                    <div>
+                        <span className="font-semibold text-foreground">Merge:</span> optional last
+                        patch still different from the previous patch.
+                    </div>
+                </div>
                 <div className="max-h-[26rem] space-y-2.5 overflow-y-auto pr-1">
                     {computed.map(({ filament, targets, result, jndSource }) => {
                         const calibration = result && result.ok ? result.calibration : null;
@@ -917,8 +926,8 @@ export function FilamentCalibrationDialog({
                                 <div className="mt-3 space-y-2">
                                     <div className="hidden grid-cols-[1fr_auto_auto] gap-2 px-2 text-[10px] font-medium uppercase tracking-wide text-muted-foreground sm:grid">
                                         <span>Base</span>
-                                        <span className="w-[6.5rem]">Match</span>
-                                        <span className="w-[6.5rem]">Merge</span>
+                                        <span className="w-[6.5rem]">Match rail</span>
+                                        <span className="w-[6.5rem]">Merge steps</span>
                                     </div>
                                     {targets.map((target) => {
                                         const opacityLayers = parseLayerInput(reads[target.key]);
@@ -1024,8 +1033,8 @@ export function FilamentCalibrationDialog({
                                             />
                                             <span className="text-[11px] text-muted-foreground">
                                                 {calibration.channelSource === 'measured'
-                                                    ? 'measured RGB TDs'
-                                                    : 'heuristic RGB TDs'}
+                                                    ? 'measured RGB HDs'
+                                                    : 'heuristic RGB HDs'}
                                                 {jndSource === 'session-fit'
                                                     ? ' / session JND'
                                                     : ''}
@@ -1033,7 +1042,7 @@ export function FilamentCalibrationDialog({
                                         </div>
                                         <div className="text-right text-xs">
                                             <div className="font-semibold">
-                                                TD {calibration.tdSingleValue.toFixed(2)}mm
+                                                HD {calibration.tdSingleValue.toFixed(2)} mm
                                             </div>
                                             <div
                                                 className={cn(
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index 86523e3..d0ccc63 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -1,18 +1,23 @@
 import React, { useEffect, useState } from 'react';
 import { Input } from '@/components/ui/input';
 import { Button } from '@/components/ui/button';
-import { Trash2, Wand2, BadgeCheck, FlaskConical } from 'lucide-react';
+import { Trash2, Wand2, BadgeCheck, FlaskConical, ArrowRightLeft } from 'lucide-react';
 import { HexColorPicker } from 'react-colorful';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import type { Filament } from '../types';
-import { estimateTDFromColor } from '../lib/colorUtils';
+import { estimateHidingDistanceFromColor } from '../lib/colorUtils';
 import {
+    channelHds,
     computeProfileConfidence,
     getConfidenceLabel,
     getConfidenceColor,
     sanitizeFrontlitCalibration,
+    FRONTLIT_TD_SCALE,
 } from '../lib/calibration';
 
+const HD_MIN = 0.01;
+const HD_MAX = 2;
+
 interface FilamentRowProps {
     filament: Filament;
     onUpdate: (id: string, updates: Partial<Omit<Filament, 'id'>>) => void;
@@ -49,6 +54,14 @@ const FilamentRow = React.memo(function FilamentRow({
     const confidenceColorClass = getConfidenceColor(confidence);
     const isCalibrated = !!activeCalibration;
 
+    // Per-channel hiding distances: measured (calibrated) or derived from color.
+    const channels = channelHds(filament);
+    const channelText = `R ${channels[0].toFixed(2)} / G ${channels[1].toFixed(2)} / B ${channels[2].toFixed(2)} mm`;
+
+    // "Convert from TD" popover state (conventional backlit/lithophane value).
+    const [convertDraft, setConvertDraft] = useState('');
+    const [convertOpen, setConvertOpen] = useState(false);
+
     // Sync local TD state if prop changes externally
     useEffect(() => {
         setLocalTd(filament.td.toString());
@@ -99,11 +112,24 @@ const FilamentRow = React.memo(function FilamentRow({
             setLocalTd(filament.td.toString());
             return;
         }
-        val = Math.min(100, Math.max(0.1, val));
+        val = Math.min(HD_MAX, Math.max(HD_MIN, val));
         onUpdate(filament.id, { td: val, calibration: undefined });
         setLocalTd(val.toString());
     };
 
+    const handleConvertFromTd = () => {
+        const val = parseFloat(convertDraft);
+        if (isNaN(val) || val <= 0) return;
+        const hd = Math.min(
+            HD_MAX,
+            Math.max(HD_MIN, Math.round(val * FRONTLIT_TD_SCALE * 100) / 100)
+        );
+        setLocalTd(hd.toString());
+        onUpdate(filament.id, { td: hd, calibration: undefined });
+        setConvertDraft('');
+        setConvertOpen(false);
+    };
+
     const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
         if (e.key === 'Enter') {
             handleBlur();
@@ -150,13 +176,16 @@ const FilamentRow = React.memo(function FilamentRow({
                 className="h-8 text-sm flex-1 min-w-0"
             />
 
-            {/* Transmission Distance Input */}
-            <div className="relative w-20 flex-shrink-0">
+            {/* Hiding Distance Input */}
+            <div
+                className="relative w-20 flex-shrink-0"
+                title={`Hiding distance (mm): depth at which this filament hides what's beneath it.\n${isCalibrated ? 'Measured' : 'Estimated from color'} per-channel: ${channelText}`}
+            >
                 <Input
                     type="number"
-                    min={0.1}
-                    max={100}
-                    step={0.1}
+                    min={HD_MIN}
+                    max={HD_MAX}
+                    step={0.01}
                     value={localTd}
                     onChange={(e) => setLocalTd(e.target.value)}
                     onBlur={handleBlur}
@@ -164,21 +193,62 @@ const FilamentRow = React.memo(function FilamentRow({
                     className="h-8 text-sm pr-8"
                 />
                 <div className="absolute right-2 top-1/2 -translate-y-1/2 text-xs text-muted-foreground pointer-events-none">
-                    TD
+                    HD
                 </div>
             </div>
 
-            {/* Auto-compute TD Button */}
+            {/* Convert from conventional (backlit/lithophane) TD */}
+            <Popover open={convertOpen} onOpenChange={setConvertOpen}>
+                <PopoverTrigger asChild>
+                    <Button
+                        variant="ghost"
+                        size="icon"
+                        className="h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer"
+                        title="Convert from TD (lithophane/backlit value)"
+                    >
+                        <ArrowRightLeft className="w-4 h-4" />
+                    </Button>
+                </PopoverTrigger>
+                <PopoverContent className="w-64 p-3" align="start">
+                    <div className="space-y-2">
+                        <h4 className="text-sm font-medium">Convert from TD</h4>
+                        <p className="text-[11px] text-muted-foreground">
+                            Enter a conventional Transmission Distance (spool sheet or lithophane
+                            TD test). It converts to a frontlit hiding distance (≈ TD × 0.1).
+                        </p>
+                        <div className="flex gap-2">
+                            <Input
+                                type="number"
+                                min={0.1}
+                                max={20}
+                                step={0.1}
+                                value={convertDraft}
+                                onChange={(e) => setConvertDraft(e.target.value)}
+                                onKeyDown={(e) => {
+                                    if (e.key === 'Enter') handleConvertFromTd();
+                                }}
+                                placeholder="e.g. 4.0"
+                                className="h-8 text-sm"
+                            />
+                            <Button size="sm" className="h-8" onClick={handleConvertFromTd}>
+                                Convert
+                            </Button>
+                        </div>
+                    </div>
+                </PopoverContent>
+            </Popover>
+
+            {/* Auto-estimate HD Button */}
             <Button
                 variant="ghost"
                 size="icon"
                 onClick={() => {
-                    const estimatedTd = estimateTDFromColor(localColor);
-                    setLocalTd(estimatedTd.toString());
-                    onUpdate(filament.id, { td: estimatedTd, calibration: undefined });
+                    const estimated = estimateHidingDistanceFromColor(localColor);
+                    setLocalTd(estimated.toString());
+                    onUpdate(filament.id, { td: estimated, calibration: undefined });
                 }}
                 className="h-8 w-8 text-muted-foreground hover:text-amber-600 hover:bg-amber-600/10 cursor-pointer"
-                title="Auto-estimate TD from color"
+                title="Auto-estimate hiding distance from color"
             >
                 <Wand2 className="w-4 h-4" />
             </Button>
@@ -199,7 +269,7 @@ const FilamentRow = React.memo(function FilamentRow({
             {isCalibrated && (
                 <div
                     className={`flex h-8 items-center gap-1 px-2 rounded-md bg-muted/50 ${confidenceColorClass}`}
-                    title={`Calibrated · Confidence: ${confidenceLabel} (${(confidence * 100).toFixed(0)}%)`}
+                    title={`Calibrated · Confidence: ${confidenceLabel} (${(confidence * 100).toFixed(0)}%)\nMeasured HD per-channel: ${channelText}`}
                 >
                     <BadgeCheck className="w-3 h-3" />
                     <span className="text-[10px] font-medium">{confidenceLabel}</span>
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index b479393..2b4ca35 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -36,24 +36,24 @@ The first color is the starting color. Later colors become swap steps. For best
 
 ## Auto-paint
 
-Auto-paint uses real filament colors and **Transmission Distance (TD)** values. Add each filament you plan to use, then set:
+Auto-paint uses real filament colors and **Hiding Distance (HD)** values — the depth of material, in millimetres, at which a filament visually hides what's beneath it. Add each filament you plan to use, then set:
 
 - Filament name.
 - Filament color.
-- TD value.
+- HD value.
 
-Use the wand button to auto-estimate TD from color, or calibrate to measure TD from a printed wedge.
+Use the wand button to auto-estimate the hiding distance from color, calibrate to measure it from a printed wedge, or use the convert button to enter a conventional Transmission Distance (the lithophane/backlit TD from a spool sheet or TD test print) — a conventional TD is roughly 10× the hiding distance, and Kromacut converts it for you.
 
-## Calibrating Filament TD
+## Calibrating Filament Hiding Distance
 
 Calibration is camera-free: you print a small wedge and read back one or more opacity numbers. Click the calibration button on a filament row, or **Calibrate Filaments** below the filament list, to open the dialog. It has four steps:
 
 1. **Select** the filaments you want to calibrate.
 2. **Base layers** - choose **Quick** for one base read, or **Accurate** for two or three base reads per filament. Kromacut auto-picks useful bases from your real profile filaments, and you can override them with the base swatches.
 3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). For STL, use the shown layer height and first-layer height, print one copy for each filament/base read, load the listed base filament, then swap after the shown layer/Z height to the filament being calibrated. Each print has patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
-4. **Enter Results** by reporting, for each filament/base row, the **first patch that looks identical to the reference rail** beside it. Kromacut uses one read for quick scalar calibration, or combines multi-base reads to measure per-channel TDs and, when the session has enough data, fit the shared JND. The optional merge field records where adjacent steps stop looking different; it is stored as model-checking evidence and does not block saving.
+4. **Enter Results** by reporting, for each filament/base row, the **first patch that looks identical to the reference rail** beside it. Kromacut uses one read for quick scalar calibration, or combines multi-base reads to measure per-channel hiding distances and, when the session has enough data, fit the shared JND. The optional merge field records where adjacent steps stop looking different; it is stored as model-checking evidence and does not block saving.
 
-Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured TD is a material property, so it transfers to your real prints regardless of which base you calibrated against.
+Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured hiding distance is a material property, so it transfers to your real prints regardless of which base you calibrated against.
 
 ## Filament Profiles
 
@@ -89,7 +89,7 @@ Enhanced matching scores the palette that is already visible in 2D mode; it does
 
 While Kromacut is optimizing a filament order, the panel shows an approximate completion percentage. Starting a new calculation cancels the older one, so the percentage always belongs to the current settings.
 
-When a filament has been calibrated, Auto-paint uses its measured red, green, and blue TD values for both transition colors and transition thickness. Calibration can therefore change the generated stack height and swap plan as well as the preview color, making the print model more faithful to the measured filament.
+When a filament has been calibrated, Auto-paint uses its measured red, green, and blue hiding distances for both transition colors and transition thickness. Uncalibrated filaments use per-channel values estimated from their color around the scalar HD. Calibration can therefore change the generated stack height and swap plan as well as the preview color, making the print model more faithful to the measured filament.
 
 ## Flat Paint
 
diff --git a/src/docs/faq.md b/src/docs/faq.md
index b325b61..1d3560d 100644
--- a/src/docs/faq.md
+++ b/src/docs/faq.md
@@ -7,21 +7,23 @@ description: Short answers to common Kromacut questions.
 
 # FAQ
 
-## What Is Transmission Distance?
+## What Is Hiding Distance?
 
-Transmission Distance, or **TD**, describes how much light passes through a filament at a given thickness. Auto-paint uses TD to estimate how stacked filament layers will look.
+Hiding Distance, or **HD**, is the depth of material (in mm) at which a filament visually hides whatever is beneath it when viewed front-lit — the way finished prints are actually seen. Auto-paint uses HD to estimate how stacked filament layers will look.
 
-Lower TD usually means a darker or more opaque filament. Higher TD usually means a lighter or more translucent filament.
+Lower HD means a more opaque filament that covers in fewer layers. Higher HD means a more translucent filament that needs more depth.
+
+HD replaces the Transmission Distance (TD) shown in earlier versions. Conventional TD describes backlit transmission (as measured by lithophane TD test prints) and is roughly 10× the hiding distance; you can still enter a conventional TD via the convert button on a filament row and Kromacut converts it for you.
 
 ## Should I Use Manual Or Auto-paint?
 
 Use **Manual** when you want direct artistic control over color order and layer heights.
 
-Use **Auto-paint** when you have real filament colors and TD values and want Kromacut to plan the stack automatically.
+Use **Auto-paint** when you have real filament colors and hiding distance values and want Kromacut to plan the stack automatically.
 
 ## Do I Need To Calibrate Filaments?
 
-You can start with estimated TD values. You can also check whether the filament maker, seller, or community has published Transmission Distance values for the exact filament you own.
+You can start with estimated hiding distances. You can also check whether the filament maker, seller, or community has published Transmission Distance values for the exact filament you own — enter those through the convert button and Kromacut turns them into hiding distances.
 
 Calibration usually improves Auto-paint results, especially when published values are unavailable or the result still looks wrong. Calibration is most useful when:
 
diff --git a/src/docs/overview.md b/src/docs/overview.md
index b937591..f1c7424 100644
--- a/src/docs/overview.md
+++ b/src/docs/overview.md
@@ -28,9 +28,9 @@ Kromacut has two printing workflows in 3D mode.
 | Workflow   | Use it when                                            | What you control                                                                  |
 | ---------- | ------------------------------------------------------ | --------------------------------------------------------------------------------- |
 | Manual     | You want direct control over each image color.         | Color order, per-color slice heights, print settings, and swaps.                  |
-| Auto-paint | You want Kromacut to plan the physical filament stack. | Filament colors, Transmission Distance values, max height, and optimizer options. |
+| Auto-paint | You want Kromacut to plan the physical filament stack. | Filament colors, hiding distance values, max height, and optimizer options. |
 
-Manual mode starts from the image colors shown in the **Image colors** panel. Auto-paint starts from your real filaments and their **TD** values, then generates printable layers for the image.
+Manual mode starts from the image colors shown in the **Image colors** panel. Auto-paint starts from your real filaments and their **hiding distance (HD)** values, then generates printable layers for the image.
 
 ## What You See In The App
 
@@ -46,7 +46,7 @@ The workspace has three main areas:
 
 ## Good First Project
 
-Start with a high-contrast image that has a clear subject and limited background detail. Reduce it to 4 to 16 colors, then use Manual mode if you already know your layer order or Auto-paint if you have calibrated filament TD values.
+Start with a high-contrast image that has a clear subject and limited background detail. Reduce it to 4 to 16 colors, then use Manual mode if you already know your layer order or Auto-paint if you have calibrated filament hiding distances.
 
 ---
 
diff --git a/src/docs/quick-start.md b/src/docs/quick-start.md
index dac5869..f8d0c22 100644
--- a/src/docs/quick-start.md
+++ b/src/docs/quick-start.md
@@ -55,17 +55,17 @@ Click **3D**. Set the print basics first:
 
 Use **Manual** when you want direct control over the reduced image colors. Manual mode uses the swatches from **Image colors**: drag colors into the print order you want, then use each row slider to decide how much height that color contributes. This is a good first choice when you already know the layer order you want or you are matching a small, simple palette.
 
-Use **Auto-paint** when you want Kromacut to plan the physical filament stack for you. Auto-paint starts from your real filaments instead of the reduced image swatches, then uses each filament's color and **Transmission Distance (TD)** to estimate how stacked layers will look.
+Use **Auto-paint** when you want Kromacut to plan the physical filament stack for you. Auto-paint starts from your real filaments instead of the reduced image swatches, then uses each filament's color and **Hiding Distance (HD)** — the depth at which it hides what's beneath — to estimate how stacked layers will look.
 
 For a first Auto-paint run:
 
 1. Add the filaments you actually plan to print with.
 2. Set each filament color as accurately as you can.
-3. Set each filament's **TD**. The wand estimate is fine for experimenting, but calibrated TD values usually give better results.
+3. Set each filament's **HD**. The wand estimate is fine for experimenting, and you can convert a conventional TD value (≈10× the HD); calibrated hiding distances usually give the best results.
 4. Leave **Max Height** on **Auto** at first.
 5. Enable **Enhanced color matching** if the first result misses important colors or you want the optimizer to search for a better filament order.
 
-After Auto-paint computes a stack, check the transition zones and confidence details before exporting. Low confidence usually means the filament set is missing a useful color, the TD values need calibration, or the max height is too restrictive.
+After Auto-paint computes a stack, check the transition zones and confidence details before exporting. Low confidence usually means the filament set is missing a useful color, the hiding distances need calibration, or the max height is too restrictive.
 
 ## Generate And Export
 
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index dcbef3d..e655dab 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -61,7 +61,7 @@ Use custom palettes when you want the reduced image to match a known filament se
 
 ## Filament Profile Files
 
-Auto-paint filament profiles use `.kfil`. Older `.kapp` profile files can still be imported. Profile files contain filament colors, names, TD values, and calibration data when available.
+Auto-paint filament profiles use `.kfil`. Older `.kapp` profile files can still be imported. Profile files contain filament colors, names, hiding distance values, and calibration data when available. Profiles saved by older versions stored uncalibrated values on the conventional TD scale; they are converted automatically (×0.1) when loaded or imported.
 
 Use profile import and export to move calibrated filaments between browsers or share them with another Kromacut user.
 
diff --git a/src/docs/troubleshooting.md b/src/docs/troubleshooting.md
index 86d82cf..e153943 100644
--- a/src/docs/troubleshooting.md
+++ b/src/docs/troubleshooting.md
@@ -39,7 +39,7 @@ Use **Dedither** after reducing colors. If the image still has too many isolated
 
 Common causes:
 
-- Filament TD values are estimates instead of calibrated values.
+- Filament hiding distances are estimates instead of calibrated values.
 - The filament set does not cover the image colors well.
 - **Max Height** is compressing transition zones too much.
 - The optimizer needs **Enhanced color matching** enabled.
diff --git a/src/hooks/useFilaments.ts b/src/hooks/useFilaments.ts
index e6f3810..3b0f759 100644
--- a/src/hooks/useFilaments.ts
+++ b/src/hooks/useFilaments.ts
@@ -1,6 +1,6 @@
 import { useCallback, useState } from 'react';
 import type { Filament } from '../types';
-import { estimateTDFromColor } from '../lib/colorUtils';
+import { estimateHidingDistanceFromColor } from '../lib/colorUtils';
 
 export interface UseFilamentsOptions {
     initial?: Filament[];
@@ -16,7 +16,7 @@ export function useFilaments(options: UseFilamentsOptions = {}) {
             {
                 id: Math.random().toString(36).substring(2, 9),
                 color: defaultColor,
-                td: estimateTDFromColor(defaultColor),
+                td: estimateHidingDistanceFromColor(defaultColor),
             },
         ]);
     }, []);
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 8315ecb..dbc5cc9 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -16,8 +16,8 @@ import {
     type ScoringContext,
 } from './optimizer';
 import {
+    channelHds,
     computeProfileConfidence,
-    sanitizeFrontlitCalibration,
     type CalibrationRgb,
 } from './calibration';
 import { blendSrgbChannel } from './colorSpace';
@@ -392,36 +392,13 @@ function transitionThicknessMultiplier(targetOpacity: number): number {
     return -Math.log10(1 - targetOpacity);
 }
 
-/**
- * Fallback for UNCALIBRATED filaments only: frontlit prints behave optically like
- * a much shorter effective TD, so a generic user-entered TD is scaled down for
- * internal simulation. Calibrated filaments carry measured frontlit TDs and skip
- * this — the frontlit calibration flow exists to replace this approximation.
- */
-const FRONTLIT_TD_SCALE = 0.1;
-const USE_CALIBRATED_CHANNEL_TD = true;
+// `filament.td` stores the frontlit hiding distance directly (profile schema v2)
+// for calibrated and uncalibrated filaments alike, so no runtime scaling is
+// needed. Per-channel values come from `channelHds`: measured when calibrated,
+// derived from the swatch color otherwise.
 
 type AutoPaintFilament = Pick<Filament, 'id' | 'color' | 'td' | 'calibration'>;
 
-function calibratedTdChannels(filament: AutoPaintFilament): CalibrationRgb | undefined {
-    if (!USE_CALIBRATED_CHANNEL_TD) return undefined;
-    const channels = sanitizeFrontlitCalibration(filament.calibration)?.td;
-    if (!channels || channels.some((td) => !Number.isFinite(td) || td <= 0)) {
-        return undefined;
-    }
-    return channels;
-}
-
-function scaleFilamentForFrontlight(filament: Filament): Filament {
-    // Calibrated filaments already carry measured frontlit TDs (scalar + per
-    // channel), so they pass through unchanged. Only uncalibrated filaments get
-    // the generic frontlit approximation.
-    if (sanitizeFrontlitCalibration(filament.calibration)) {
-        return filament;
-    }
-    return { ...filament, td: filament.td * FRONTLIT_TD_SCALE, calibration: undefined };
-}
-
 /**
  * Simulate adding filament layers until the blended color matches the
  * target pure filament color (DeltaE < threshold), or until the filament
@@ -517,12 +494,9 @@ export function calculateIdealHeight(
     //   0.05 = 10^(-thickness/TD)  →  thickness = TD × log10(20) ≈ TD × 1.3
     // Dark filaments have low TD (e.g. 0.5mm) → foundation ≈ 0.65mm
     const firstFilament = sortedFilaments[0];
-    // Use the least-opaque (largest) calibrated channel TD when available so
-    // every channel reaches ~95% opacity; fall back to the scalar working TD.
-    const firstFilamentChannels = calibratedTdChannels(firstFilament);
-    const foundationTd = firstFilamentChannels
-        ? Math.max(...firstFilamentChannels)
-        : firstFilament.td;
+    // Use the least-opaque (largest) channel hiding distance so every channel
+    // reaches ~95% opacity.
+    const foundationTd = Math.max(...channelHds(firstFilament));
     const opacityThickness = foundationTd * 1.3; // 95% opaque
     // Ensure at least the base thickness (avoid unnecessary extra layers)
     const foundationThickness = Math.max(baseThickness, opacityThickness);
@@ -531,7 +505,7 @@ export function calculateIdealHeight(
         filamentId: firstFilament.id,
         filamentColor: firstFilament.color,
         filamentTd: firstFilament.td,
-        filamentTdChannels: calibratedTdChannels(firstFilament),
+        filamentTdChannels: channelHds(firstFilament),
         startHeight: 0,
         endHeight: foundationThickness,
         idealThickness: foundationThickness,
@@ -543,7 +517,7 @@ export function calculateIdealHeight(
     for (let i = 1; i < sortedFilaments.length; i++) {
         const filament = sortedFilaments[i];
         const filamentRgb = hexToRgb(filament.color);
-        const transitionTd = calibratedTdChannels(filament) ?? filament.td;
+        const transitionTd = channelHds(filament);
 
         // Calculate how thick this zone needs to be
         const transitionKey = [
@@ -553,11 +527,7 @@ export function calculateIdealHeight(
             filamentRgb.r,
             filamentRgb.g,
             filamentRgb.b,
-            ...(
-                typeof transitionTd === 'number'
-                    ? [transitionTd]
-                    : transitionTd
-            ),
+            ...transitionTd,
             layerHeight,
             transitionOpacity,
         ].join(':');
@@ -577,7 +547,7 @@ export function calculateIdealHeight(
             filamentId: filament.id,
             filamentColor: filament.color,
             filamentTd: filament.td,
-            filamentTdChannels: calibratedTdChannels(filament),
+            filamentTdChannels: channelHds(filament),
             startHeight: currentHeight,
             endHeight: currentHeight + transitionThickness,
             idealThickness: transitionThickness,
@@ -1426,16 +1396,12 @@ function findBestFilamentOrderWithOptimizer(
         transitionOpacity: optimizerOptions.transitionOpacity,
     };
 
-    // Apply frontlit TD scale
-    const scaledFilaments = filaments.map(scaleFilamentForFrontlight);
-
-    // Run optimizer
-    const result = optimizeFilamentOrder(scaledFilaments, context, {
+    // Run optimizer (tds are hiding distances; no scaling needed)
+    const result = optimizeFilamentOrder(filaments, context, {
         ...optimizerOptions,
         allowRepeatedSwaps,
     });
 
-    // Map back to original filaments (unscaled TDs)
     const sortedFilaments = result.order.map((sf) =>
         filaments.find((f) => f.id === sf.id)
     ).filter((f): f is Filament => f !== undefined);
@@ -1541,12 +1507,9 @@ export function generateAutoLayers(
         });
     }
 
-    // Apply frontlit TD scale for internal simulation
-    const scaledFilaments = sortedFilaments.map(scaleFilamentForFrontlight);
-
     // --- STEP 3: CALCULATE IDEAL HEIGHT WITH TRANSITION ZONES ---
     const { idealHeight, zones } = calculateIdealHeight(
-        scaledFilaments,
+        sortedFilaments,
         layerHeight,
         Math.max(firstLayerHeight, layerHeight),
         undefined,
@@ -1629,8 +1592,8 @@ export function calculateRecommendedHeight(
 ): number {
     if (filaments.length === 0) return 2.0;
 
-    // Sum of TDs gives a rough estimate of total transition space needed
-    const totalTD = filaments.reduce((sum, f) => sum + f.td * FRONTLIT_TD_SCALE, 0);
+    // Sum of hiding distances gives a rough estimate of transition space needed
+    const totalTD = filaments.reduce((sum, f) => sum + f.td, 0);
 
     // Typically need about 0.8x to 1.2x the sum of TDs
     const estimated = totalTD * 0.9;
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index ace74bf..62b0153 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -14,8 +14,8 @@
  * form with a principled, color-aware constant instead of a hand-picked number.
  */
 
-import { blendSrgbChannel } from './colorSpace';
-import { deltaE2000 } from './colorDifference';
+import { blendSrgbChannel } from './colorSpace.ts';
+import { deltaE2000 } from './colorDifference.ts';
 
 // ============================================================================
 // Types
@@ -110,6 +110,16 @@ export const FRONTLIT_BASE_HEX = '#000000';
  */
 export const OPACITY_JND = 2.0;
 
+/**
+ * Conversion factor between conventional (backlit/lithophane) Transmission
+ * Distance values and the frontlit hiding distance the app stores and
+ * simulates with. Used only when converting user-entered conventional TD
+ * values and when migrating pre-v2 persisted profiles; the runtime pipeline
+ * consumes hiding distances directly. Empirically validated: measured hiding
+ * distances of a physical 8-filament set landed at ≈ backlit TD × 0.1.
+ */
+export const FRONTLIT_TD_SCALE = 0.1;
+
 const FRONTLIT_TD_MIN = 0.05;
 const FRONTLIT_TD_MAX = 12.0;
 const JND_FIT_MIN = 1.0;
@@ -525,7 +535,7 @@ export function predictOpacityLayersForTds(
 /**
  * Derive per-channel TDs from the single measured TD, modulated by the filament
  * color. Uses a `1 + value*5.8` shape per channel (the per-channel form of the
- * estimateTDFromColor luminance heuristic): a brighter channel is more
+ * estimateHidingDistanceFromColor luminance heuristic): a brighter channel is more
  * transmissive (larger TD). The brightest channel — which governs the opacity
  * the eye reads — is anchored to `tdSingle`, so darker (more absorptive) channels
  * scale down from there.
@@ -538,6 +548,23 @@ export function deriveChannelTds(filamentColor: string, tdSingle: number): Calib
     return raw.map((value) => clamp(k * value, FRONTLIT_TD_MIN, FRONTLIT_TD_MAX)) as CalibrationRgb;
 }
 
+/**
+ * Per-channel hiding distances for a filament: the measured triple when a valid
+ * frontlit calibration exists, otherwise derived from the swatch color around
+ * the scalar hiding distance. Every blend consumer should go through this so
+ * calibrated and uncalibrated filaments share one channel model.
+ */
+export function channelHds(filament: {
+    color: string;
+    td: number;
+    calibration?: unknown;
+}): CalibrationRgb {
+    return (
+        sanitizeFrontlitCalibration(filament.calibration)?.td ??
+        deriveChannelTds(filament.color, filament.td)
+    );
+}
+
 function frontlitConfidence(opacityLayers: number, tdSingle: number, maxLayers?: number): number {
     let confidence = 0.9;
     // Reads pinned at either extreme of the wedge are less trustworthy: the true
@@ -820,9 +847,10 @@ export function computeProfileConfidence(profile: {
 }): number {
     const cal = sanitizeFrontlitCalibration(profile.calibration);
     if (!cal) {
+        // Plausibility bands for an uncalibrated hiding distance (mm, frontlit).
         const td = profile.transmissionDistance;
-        if (td >= 1.0 && td <= 5.0) return 0.5;
-        if (td >= 0.5 && td <= 10.0) return 0.3;
+        if (td >= 0.1 && td <= 0.5) return 0.5;
+        if (td >= 0.05 && td <= 1.0) return 0.3;
         return 0.1;
     }
 
diff --git a/src/lib/colorUtils.ts b/src/lib/colorUtils.ts
index 74b4c29..7a5526e 100644
--- a/src/lib/colorUtils.ts
+++ b/src/lib/colorUtils.ts
@@ -2,6 +2,8 @@
  * Shared color utility functions.
  */
 
+import { FRONTLIT_TD_SCALE } from './calibration.ts';
+
 /**
  * Normalize a hex color to canonical `#RRGGBB` uppercase form.
  * Accepts values with or without the leading '#'; anything that is not a
@@ -26,17 +28,19 @@ export function hexLuminance(hex: string): number {
 }
 
 /**
- * Estimate Transmission Distance (TD) from a hex color.
+ * Estimate the frontlit hiding distance (mm) from a hex color.
  *
- * TD is related to how much light passes through the filament:
- * - Darker / more opaque colors usually have lower TD
- * - Lighter / more translucent colors usually have higher TD
- * - Saturation and hue can shift TD slightly around the luminance baseline
+ * Hiding distance is the depth of material at which a filament visually hides
+ * what's beneath it:
+ * - Darker / more opaque colors hide sooner (smaller value)
+ * - Lighter / more translucent colors need more depth (larger value)
+ * - Saturation and hue shift the estimate slightly around the luminance baseline
  *
- * This heuristic is intentionally conservative and should be replaced by
+ * The heuristic shape is the historical backlit-TD estimate rescaled by
+ * FRONTLIT_TD_SCALE; it is intentionally conservative and should be replaced by
  * measured calibration data whenever possible.
  */
-export function estimateTDFromColor(hex: string): number {
+export function estimateHidingDistanceFromColor(hex: string): number {
     const h = hex.replace(/^#/, '');
     const r = parseInt(h.slice(0, 2), 16) / 255;
     const g = parseInt(h.slice(2, 4), 16) / 255;
@@ -100,9 +104,10 @@ export function estimateTDFromColor(hex: string): number {
         estimatedTD = 0.8 + luminance * 2.7; // Range: ~0.8-1.2mm
     }
 
-    // Clamp to realistic range for PLA filaments
+    // Clamp to realistic range for PLA filaments (still on the legacy TD scale)
     estimatedTD = Math.max(0.6, Math.min(8.5, estimatedTD));
 
-    // Round to 1 decimal place
-    return Math.round(estimatedTD * 10) / 10;
+    // Convert the legacy backlit-TD shape to a frontlit hiding distance and
+    // round to 2 decimals (values live in roughly 0.06–0.85 mm).
+    return Math.round(estimatedTD * FRONTLIT_TD_SCALE * 100) / 100;
 }
\ No newline at end of file
diff --git a/src/lib/nextBestColor.ts b/src/lib/nextBestColor.ts
index c9485cb..d793d9f 100644
--- a/src/lib/nextBestColor.ts
+++ b/src/lib/nextBestColor.ts
@@ -103,11 +103,34 @@ export function hexToLab(hex: string): Lab {
 
 export { labToHex };
 
-// Beer-Lambert layer blend: matches autoPaint's blendColors (operates in sRGB [0-255]).
-function blendRgb(bg: RGB, fg: RGB, td: number, thickness: number): RGB {
+// sRGB [0-255] channel <-> linear light, matching colorSpace.ts semantics.
+function srgbChannelToLinear(channel: number): number {
+    const s = Math.max(0, Math.min(255, channel)) / 255;
+    return s <= SRGB_LINEARISE_THRESHOLD
+        ? s / SRGB_LINEARISE_SCALE
+        : Math.pow((s + SRGB_LINEARISE_OFFSET) / SRGB_LINEARISE_DENOM, SRGB_LINEARISE_GAMMA);
+}
+
+function linearChannelToSrgb(channel: number): number {
+    const c = Math.max(0, Math.min(1, channel));
+    const normalized =
+        c <= SRGB_LINEAR_THRESHOLD
+            ? c * SRGB_LINEARISE_SCALE
+            : SRGB_LINEARISE_DENOM * Math.pow(c, 1 / SRGB_LINEARISE_GAMMA) - SRGB_LINEARISE_OFFSET;
+    return normalized * 255;
+}
+
+// Beer-Lambert layer blend in linear light: matches autoPaint's blendColors /
+// colorSpace.blendSrgbChannel (composite the transmissive foreground over the
+// background in linear light, then re-encode to sRGB).
+export function blendRgb(bg: RGB, fg: RGB, td: number, thickness: number): RGB {
     if (td <= 0 || thickness <= 0) return bg;
     const t = Math.pow(0.1, thickness / td);
-    return { r: fg.r + (bg.r - fg.r) * t, g: fg.g + (bg.g - fg.g) * t, b: fg.b + (bg.b - fg.b) * t };
+    const blendChannel = (bgC: number, fgC: number) =>
+        linearChannelToSrgb(
+            srgbChannelToLinear(fgC) * (1 - t) + srgbChannelToLinear(bgC) * t
+        );
+    return { r: blendChannel(bg.r, fg.r), g: blendChannel(bg.g, fg.g), b: blendChannel(bg.b, fg.b) };
 }
 
 const BLEND_CURVE_STEPS = 16;
@@ -154,7 +177,7 @@ const EXTRAP_BLEND_RATIOS = [0.3, 0.5, 0.7];
 
 export interface ColorCandidate {
     hex: string;
-    /** Recommended starting TD, derived from the nearest existing filament by ΔE. */
+    /** Recommended starting hiding distance (mm), borrowed from the nearest existing filament by ΔE. */
     td: number;
     /**
      * % reduction in blend-aware weighted-average ΔE vs current filament set.
@@ -376,7 +399,8 @@ export function nextBestColor(
         if (newReachable < effectiveReachable[i]) pixelsCaptured += counts[i];
     }
 
-    // TD: borrow from nearest existing filament by ΔE.
+    // Hiding distance: borrow from the nearest existing filament by ΔE. `td` is
+    // already the frontlit hiding distance (schema v2), so no scale conversion.
     let nearestFilamentIdx = 0;
     let nearestDE = Infinity;
     for (let fi = 0; fi < filamentLabs.length; fi++) {
@@ -394,7 +418,7 @@ export function nextBestColor(
         `${pool.length} candidates (${scores.length} scored)`
     );
     console.log(`  Baseline avg ΔE:  ${baselineAvgDeltaE.toFixed(2)}  (blend-aware)`);
-    console.log(`  Suggestion:       ${winner.hex.toUpperCase()}  TD ${recommendedTd.toFixed(2)}`);
+    console.log(`  Suggestion:       ${winner.hex.toUpperCase()}  HD ${recommendedTd.toFixed(2)}`);
     console.log(
         `  Accuracy gain:    +${improvementPct.toFixed(1)}%  ` +
         `(${pixelsCaptured.toLocaleString()} px / ` +
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 0ae8adb..2906c13 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -1,5 +1,5 @@
 import type { Filament } from '../types';
-import { sanitizeFrontlitCalibration } from './calibration';
+import { FRONTLIT_TD_SCALE, sanitizeFrontlitCalibration } from './calibration.ts';
 
 export interface AutoPaintProfile {
     id: string;
@@ -10,7 +10,19 @@ export interface AutoPaintProfile {
     updatedAt: number;
 }
 
-export const CURRENT_PROFILE_VERSION = 1;
+/**
+ * Profile schema versions:
+ * - v1: uncalibrated `td` stored on the conventional backlit TD scale (~1–6 mm)
+ *   and scaled ×0.1 at simulation time.
+ * - v2: `td` always stores the frontlit hiding distance (mm) directly, for
+ *   calibrated and uncalibrated filaments alike.
+ */
+export const CURRENT_PROFILE_VERSION = 2;
+
+/** Schema version that introduced hiding-distance td storage. The td migration
+ *  applies to profiles below this version only — never re-gate it on
+ *  CURRENT_PROFILE_VERSION, or a future bump would re-scale v2 profiles. */
+const TD_MIGRATION_VERSION = 2;
 
 const PROFILES_STORAGE_KEY = 'kromacut.autopaint.profiles';
 const LAST_PROFILE_KEY = 'kromacut.autopaint.lastProfileId';
@@ -43,6 +55,29 @@ export function sanitizeProfileFilament(value: unknown): Filament | null {
     return filament;
 }
 
+/**
+ * Convert a schema-v1 filament to v2 semantics: uncalibrated tds move from the
+ * conventional backlit TD scale to the frontlit hiding distance (×0.1);
+ * calibrated filaments re-sync to their measured scalar. Must run exactly once
+ * per filament, gated by the stored schema version.
+ */
+export function migrateLegacyFilamentTd(filament: Filament): Filament {
+    const calibration = sanitizeFrontlitCalibration(filament.calibration);
+    if (calibration) {
+        return { ...filament, td: calibration.tdSingleValue };
+    }
+    // Round away binary-float noise from the ×0.1 (e.g. 1.1 → 0.11000000000000001);
+    // 4 decimals is far below the optical resolution of any read.
+    return { ...filament, td: Math.round(filament.td * FRONTLIT_TD_SCALE * 1e4) / 1e4 };
+}
+
+function sanitizeProfileFilaments(value: unknown[], version: number): Filament[] {
+    const filaments = value
+        .map((filament) => sanitizeProfileFilament(filament))
+        .filter((filament): filament is Filament => filament !== null);
+    return version < TD_MIGRATION_VERSION ? filaments.map(migrateLegacyFilamentTd) : filaments;
+}
+
 function sanitizeProfile(value: unknown): AutoPaintProfile | null {
     if (!isRecord(value)) return null;
     if (
@@ -53,14 +88,13 @@ function sanitizeProfile(value: unknown): AutoPaintProfile | null {
         return null;
     }
 
+    const version = typeof value.version === 'number' ? value.version : 1;
     const now = Date.now();
     return {
         id: value.id,
         name: value.name,
-        version: typeof value.version === 'number' ? value.version : CURRENT_PROFILE_VERSION,
-        filaments: value.filaments
-            .map((filament) => sanitizeProfileFilament(filament))
-            .filter((filament): filament is Filament => filament !== null),
+        version: CURRENT_PROFILE_VERSION,
+        filaments: sanitizeProfileFilaments(value.filaments, version),
         createdAt: typeof value.createdAt === 'number' ? value.createdAt : now,
         updatedAt: typeof value.updatedAt === 'number' ? value.updatedAt : now,
     };
@@ -213,15 +247,14 @@ export function importProfiles(
         // Validate required fields
         if (!raw || typeof raw.name !== 'string' || !Array.isArray(raw.filaments)) continue;
 
-        const validFilaments = raw.filaments
-            .map((filament) => sanitizeProfileFilament(filament))
-            .filter((filament): filament is Filament => filament !== null);
+        const rawVersion = typeof raw.version === 'number' ? raw.version : 1;
+        const validFilaments = sanitizeProfileFilaments(raw.filaments, rawVersion);
 
         const now = Date.now();
         const profile: AutoPaintProfile = {
             id: raw.id && typeof raw.id === 'string' ? raw.id : crypto.randomUUID(),
             name: raw.name,
-            version: typeof raw.version === 'number' ? raw.version : CURRENT_PROFILE_VERSION,
+            version: CURRENT_PROFILE_VERSION,
             filaments: validFilaments,
             createdAt: typeof raw.createdAt === 'number' ? raw.createdAt : now,
             updatedAt: now,
diff --git a/tests/assets/auto-paint-goldens.json b/tests/assets/auto-paint-goldens.json
index 914f056..6419461 100644
--- a/tests/assets/auto-paint-goldens.json
+++ b/tests/assets/auto-paint-goldens.json
@@ -16,7 +16,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       }
     ],
@@ -40,7 +40,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       }
     ],
@@ -64,7 +64,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       }
     ],
@@ -73,6 +73,8 @@
   },
   "B&W / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms",
       "plvjtmc",
       "p9c63ms"
     ],
@@ -88,11 +90,25 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
+      },
+      {
+        "filamentId": "plvjtmc",
+        "startHeight": 0.64,
+        "endHeight": 0.72,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 0.72,
+        "endHeight": 1.12,
+        "idealThickness": 0.42,
+        "actualThickness": 0.4
       }
     ],
-    "totalHeight": 0.64,
+    "totalHeight": 1.12,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=false / repeats=false": {
@@ -112,7 +128,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       }
     ],
@@ -136,7 +152,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       }
     ],
@@ -145,26 +161,26 @@
   },
   "B&W / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "plvjtmc",
-      "p9c63ms"
+      "p9c63ms",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "plvjtmc",
+        "filamentId": "p9c63ms",
         "startHeight": 0,
-        "endHeight": 0.16,
-        "idealThickness": 0.16,
-        "actualThickness": 0.16
+        "endHeight": 0.8,
+        "idealThickness": 0.78,
+        "actualThickness": 0.8
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 0.16,
-        "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.48
+        "filamentId": "plvjtmc",
+        "startHeight": 0.8,
+        "endHeight": 0.88,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 0.64,
+    "totalHeight": 0.88,
     "compressionRatio": 1
   },
   "B&W / large-jpeg / enhanced=true / repeats=true": {
@@ -185,7 +201,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 0.16,
         "endHeight": 0.64,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.48
       },
       {
@@ -218,7 +234,7 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
@@ -232,7 +248,7 @@
         "filamentId": "y202l1e",
         "startHeight": 0.72,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       }
     ],
@@ -258,7 +274,7 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
@@ -272,7 +288,7 @@
         "filamentId": "y202l1e",
         "startHeight": 0.72,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       }
     ],
@@ -291,7 +307,7 @@
         "filamentId": "xud8mzr",
         "startHeight": 0,
         "endHeight": 0.56,
-        "idealThickness": 0.4810000000000001,
+        "idealThickness": 0.481,
         "actualThickness": 0.56
       },
       {
@@ -305,14 +321,14 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.64,
         "endHeight": 0.88,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
         "startHeight": 0.88,
         "endHeight": 1.2,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       }
     ],
@@ -326,9 +342,9 @@
       "y202l1e",
       "plvjtmc",
       "y202l1e",
+      "plvjtmc",
       "xud8mzr",
-      "y202l1e",
-      "plvjtmc"
+      "y202l1e"
     ],
     "transitionZones": [
       {
@@ -342,14 +358,14 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
         "filamentId": "y202l1e",
         "startHeight": 0.48,
         "endHeight": 0.8,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       },
       {
@@ -363,29 +379,29 @@
         "filamentId": "y202l1e",
         "startHeight": 0.88,
         "endHeight": 1.2,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "plvjtmc",
         "startHeight": 1.2,
-        "endHeight": 1.44,
+        "endHeight": 1.28,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
+      },
+      {
+        "filamentId": "xud8mzr",
+        "startHeight": 1.28,
+        "endHeight": 1.52,
         "idealThickness": 0.259,
         "actualThickness": 0.24
       },
       {
         "filamentId": "y202l1e",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.76,
+        "startHeight": 1.52,
         "endHeight": 1.84,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "idealThickness": 0.32899999999999996,
+        "actualThickness": 0.32
       }
     ],
     "totalHeight": 1.84,
@@ -410,7 +426,7 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
@@ -424,7 +440,7 @@
         "filamentId": "y202l1e",
         "startHeight": 0.72,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       }
     ],
@@ -450,7 +466,7 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
@@ -464,7 +480,7 @@
         "filamentId": "y202l1e",
         "startHeight": 0.72,
         "endHeight": 1.04,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       }
     ],
@@ -475,8 +491,8 @@
     "filamentOrder": [
       "plvjtmc",
       "h8zuocq",
-      "y202l1e",
-      "xud8mzr"
+      "xud8mzr",
+      "y202l1e"
     ],
     "transitionZones": [
       {
@@ -490,22 +506,22 @@
         "filamentId": "h8zuocq",
         "startHeight": 0.16,
         "endHeight": 0.48,
-        "idealThickness": 0.245,
+        "idealThickness": 0.24499999999999997,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "y202l1e",
+        "filamentId": "xud8mzr",
         "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.329,
-        "actualThickness": 0.32
+        "endHeight": 0.72,
+        "idealThickness": 0.24,
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "xud8mzr",
-        "startHeight": 0.8,
+        "filamentId": "y202l1e",
+        "startHeight": 0.72,
         "endHeight": 1.04,
-        "idealThickness": 0.259,
-        "actualThickness": 0.24
+        "idealThickness": 0.32899999999999996,
+        "actualThickness": 0.32
       }
     ],
     "totalHeight": 1.04,
@@ -513,29 +529,29 @@
   },
   "GH#27 / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "xud8mzr",
       "h8zuocq",
-      "plvjtmc",
       "y202l1e",
       "plvjtmc",
-      "h8zuocq",
+      "y202l1e",
       "plvjtmc",
+      "xud8mzr",
+      "y202l1e",
       "xud8mzr"
     ],
     "transitionZones": [
       {
-        "filamentId": "xud8mzr",
+        "filamentId": "h8zuocq",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.4810000000000001,
-        "actualThickness": 0.56
+        "endHeight": 0.48,
+        "idealThickness": 0.45499999999999996,
+        "actualThickness": 0.48
       },
       {
-        "filamentId": "h8zuocq",
-        "startHeight": 0.56,
+        "filamentId": "y202l1e",
+        "startHeight": 0.48,
         "endHeight": 0.8,
-        "idealThickness": 0.24,
-        "actualThickness": 0.24
+        "idealThickness": 0.32899999999999996,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "plvjtmc",
@@ -548,7 +564,7 @@
         "filamentId": "y202l1e",
         "startHeight": 0.88,
         "endHeight": 1.2,
-        "idealThickness": 0.329,
+        "idealThickness": 0.32899999999999996,
         "actualThickness": 0.32
       },
       {
@@ -559,28 +575,28 @@
         "actualThickness": 0.08
       },
       {
-        "filamentId": "h8zuocq",
+        "filamentId": "xud8mzr",
         "startHeight": 1.28,
-        "endHeight": 1.52,
-        "idealThickness": 0.245,
-        "actualThickness": 0.24
+        "endHeight": 1.6,
+        "idealThickness": 0.259,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.52,
-        "endHeight": 1.6,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "y202l1e",
+        "startHeight": 1.6,
+        "endHeight": 1.92,
+        "idealThickness": 0.32899999999999996,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "xud8mzr",
-        "startHeight": 1.6,
-        "endHeight": 1.84,
+        "startHeight": 1.92,
+        "endHeight": 2.16,
         "idealThickness": 0.259,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 1.84,
+    "totalHeight": 2.16,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=false / repeats=false": {
@@ -606,7 +622,7 @@
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
         "endHeight": 0.4,
-        "idealThickness": 0.19599999999999998,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
@@ -627,7 +643,7 @@
         "filamentId": "upcjpfe",
         "startHeight": 0.96,
         "endHeight": 1.28,
-        "idealThickness": 0.343,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
       {
@@ -648,7 +664,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 2.08,
         "endHeight": 2.48,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.4
       }
     ],
@@ -678,7 +694,7 @@
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
         "endHeight": 0.4,
-        "idealThickness": 0.19599999999999998,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
@@ -699,7 +715,7 @@
         "filamentId": "upcjpfe",
         "startHeight": 0.96,
         "endHeight": 1.28,
-        "idealThickness": 0.343,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
       {
@@ -720,7 +736,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 2.08,
         "endHeight": 2.48,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.4
       }
     ],
@@ -730,11 +746,10 @@
   "Current 8 Colors / logo-png / enhanced=true / repeats=false": {
     "filamentOrder": [
       "plvjtmc",
-      "98z555k",
-      "upcjpfe",
       "azwg1yp",
       "xyyxysq",
       "w8cncoa",
+      "98z555k",
       "p9c63ms",
       "vsn9q6u"
     ],
@@ -746,161 +761,154 @@
         "idealThickness": 0.16,
         "actualThickness": 0.16
       },
-      {
-        "filamentId": "98z555k",
-        "startHeight": 0.16,
-        "endHeight": 0.48,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.48,
-        "endHeight": 0.8,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.8,
-        "endHeight": 1.04,
-        "idealThickness": 0.19599999999999998,
+        "startHeight": 0.16,
+        "endHeight": 0.4,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.04,
-        "endHeight": 1.36,
+        "startHeight": 0.4,
+        "endHeight": 0.72,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 1.36,
-        "endHeight": 1.84,
+        "startHeight": 0.72,
+        "endHeight": 1.2,
         "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
       },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 1.2,
+        "endHeight": 1.44,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
+      },
       {
         "filamentId": "p9c63ms",
-        "startHeight": 1.84,
-        "endHeight": 2.24,
-        "idealThickness": 0.42000000000000004,
-        "actualThickness": 0.4
+        "startHeight": 1.44,
+        "endHeight": 1.92,
+        "idealThickness": 0.42,
+        "actualThickness": 0.48
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.24,
-        "endHeight": 2.48,
+        "startHeight": 1.92,
+        "endHeight": 2.16,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 2.48,
+    "totalHeight": 2.16,
     "compressionRatio": 1
   },
   "Current 8 Colors / logo-png / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "98z555k",
-      "vsn9q6u",
-      "upcjpfe",
+      "plvjtmc",
       "azwg1yp",
       "xyyxysq",
-      "upcjpfe",
       "w8cncoa",
       "vsn9q6u",
-      "plvjtmc",
+      "98z555k",
       "azwg1yp",
       "upcjpfe",
+      "xyyxysq",
+      "98z555k",
+      "vsn9q6u",
       "azwg1yp"
     ],
     "transitionZones": [
       {
-        "filamentId": "98z555k",
+        "filamentId": "plvjtmc",
         "startHeight": 0,
-        "endHeight": 0.56,
-        "idealThickness": 0.507,
-        "actualThickness": 0.56
-      },
-      {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.56,
-        "endHeight": 0.8,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 0.8,
-        "endHeight": 1.12,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "endHeight": 0.16,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
-        "idealThickness": 0.19599999999999998,
+        "startHeight": 0.16,
+        "endHeight": 0.4,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 1.36,
-        "endHeight": 1.68,
+        "startHeight": 0.4,
+        "endHeight": 0.72,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.68,
-        "endHeight": 2.08,
-        "idealThickness": 0.343,
-        "actualThickness": 0.4
-      },
       {
         "filamentId": "w8cncoa",
-        "startHeight": 2.08,
-        "endHeight": 2.48,
+        "startHeight": 0.72,
+        "endHeight": 1.2,
         "idealThickness": 0.44099999999999995,
-        "actualThickness": 0.4
+        "actualThickness": 0.48
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 2.48,
-        "endHeight": 2.72,
+        "startHeight": 1.2,
+        "endHeight": 1.44,
         "idealThickness": 0.26599999999999996,
         "actualThickness": 0.24
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 2.72,
-        "endHeight": 2.8,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "98z555k",
+        "startHeight": 1.44,
+        "endHeight": 1.76,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.32
       },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 2.8,
-        "endHeight": 3.04,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.24
+        "startHeight": 1.76,
+        "endHeight": 1.92,
+        "idealThickness": 0.196,
+        "actualThickness": 0.16
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 3.04,
-        "endHeight": 3.36,
-        "idealThickness": 0.343,
+        "startHeight": 1.92,
+        "endHeight": 2.24,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
+      {
+        "filamentId": "xyyxysq",
+        "startHeight": 2.24,
+        "endHeight": 2.64,
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "98z555k",
+        "startHeight": 2.64,
+        "endHeight": 2.88,
+        "idealThickness": 0.27299999999999996,
+        "actualThickness": 0.24
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "startHeight": 2.88,
+        "endHeight": 3.04,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
+      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 3.36,
-        "endHeight": 3.6,
-        "idealThickness": 0.19599999999999998,
+        "startHeight": 3.04,
+        "endHeight": 3.28,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       }
     ],
-    "totalHeight": 3.6,
+    "totalHeight": 3.28,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=false / repeats=false": {
@@ -926,7 +934,7 @@
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
         "endHeight": 0.4,
-        "idealThickness": 0.19599999999999998,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
@@ -947,7 +955,7 @@
         "filamentId": "upcjpfe",
         "startHeight": 0.96,
         "endHeight": 1.28,
-        "idealThickness": 0.343,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
       {
@@ -968,7 +976,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 2.08,
         "endHeight": 2.48,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.4
       }
     ],
@@ -998,7 +1006,7 @@
         "filamentId": "azwg1yp",
         "startHeight": 0.16,
         "endHeight": 0.4,
-        "idealThickness": 0.19599999999999998,
+        "idealThickness": 0.196,
         "actualThickness": 0.24
       },
       {
@@ -1019,7 +1027,7 @@
         "filamentId": "upcjpfe",
         "startHeight": 0.96,
         "endHeight": 1.28,
-        "idealThickness": 0.343,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
       {
@@ -1040,7 +1048,7 @@
         "filamentId": "p9c63ms",
         "startHeight": 2.08,
         "endHeight": 2.48,
-        "idealThickness": 0.42000000000000004,
+        "idealThickness": 0.42,
         "actualThickness": 0.4
       }
     ],
@@ -1049,170 +1057,154 @@
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=false": {
     "filamentOrder": [
-      "w8cncoa",
       "azwg1yp",
-      "plvjtmc",
-      "vsn9q6u",
       "xyyxysq",
-      "upcjpfe",
-      "98z555k"
+      "vsn9q6u",
+      "p9c63ms",
+      "plvjtmc"
     ],
     "transitionZones": [
-      {
-        "filamentId": "w8cncoa",
-        "startHeight": 0,
-        "endHeight": 0.88,
-        "idealThickness": 0.8190000000000001,
-        "actualThickness": 0.88
-      },
       {
         "filamentId": "azwg1yp",
-        "startHeight": 0.88,
-        "endHeight": 1.04,
-        "idealThickness": 0.19599999999999998,
-        "actualThickness": 0.16
+        "startHeight": 0,
+        "endHeight": 0.4,
+        "idealThickness": 0.36400000000000005,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
-        "idealThickness": 0.08,
-        "actualThickness": 0.08
+        "filamentId": "xyyxysq",
+        "startHeight": 0.4,
+        "endHeight": 0.8,
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "vsn9q6u",
-        "startHeight": 1.12,
-        "endHeight": 1.44,
+        "startHeight": 0.8,
+        "endHeight": 1.04,
         "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
-      },
-      {
-        "filamentId": "xyyxysq",
-        "startHeight": 1.44,
-        "endHeight": 1.76,
-        "idealThickness": 0.357,
-        "actualThickness": 0.32
+        "actualThickness": 0.24
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.76,
-        "endHeight": 2.08,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "p9c63ms",
+        "startHeight": 1.04,
+        "endHeight": 1.44,
+        "idealThickness": 0.42,
+        "actualThickness": 0.4
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 2.08,
-        "endHeight": 2.4,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 1.44,
+        "endHeight": 1.52,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 2.4,
+    "totalHeight": 1.52,
     "compressionRatio": 1
   },
   "Current 8 Colors / large-jpeg / enhanced=true / repeats=true": {
     "filamentOrder": [
-      "azwg1yp",
-      "upcjpfe",
-      "vsn9q6u",
-      "plvjtmc",
       "98z555k",
       "upcjpfe",
-      "vsn9q6u",
       "xyyxysq",
-      "vsn9q6u",
       "p9c63ms",
-      "98z555k",
-      "upcjpfe"
+      "plvjtmc",
+      "xyyxysq",
+      "plvjtmc",
+      "p9c63ms",
+      "xyyxysq",
+      "azwg1yp",
+      "w8cncoa",
+      "plvjtmc"
     ],
     "transitionZones": [
       {
-        "filamentId": "azwg1yp",
+        "filamentId": "98z555k",
         "startHeight": 0,
-        "endHeight": 0.4,
-        "idealThickness": 0.364,
-        "actualThickness": 0.4
+        "endHeight": 0.56,
+        "idealThickness": 0.507,
+        "actualThickness": 0.56
       },
       {
         "filamentId": "upcjpfe",
-        "startHeight": 0.4,
-        "endHeight": 0.72,
-        "idealThickness": 0.343,
+        "startHeight": 0.56,
+        "endHeight": 0.88,
+        "idealThickness": 0.34299999999999997,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 0.72,
-        "endHeight": 1.04,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "filamentId": "xyyxysq",
+        "startHeight": 0.88,
+        "endHeight": 1.28,
+        "idealThickness": 0.357,
+        "actualThickness": 0.4
+      },
+      {
+        "filamentId": "p9c63ms",
+        "startHeight": 1.28,
+        "endHeight": 1.68,
+        "idealThickness": 0.42,
+        "actualThickness": 0.4
       },
       {
         "filamentId": "plvjtmc",
-        "startHeight": 1.04,
-        "endHeight": 1.12,
+        "startHeight": 1.68,
+        "endHeight": 1.76,
         "idealThickness": 0.08,
         "actualThickness": 0.08
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 1.12,
-        "endHeight": 1.36,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
+        "filamentId": "xyyxysq",
+        "startHeight": 1.76,
+        "endHeight": 2.08,
+        "idealThickness": 0.357,
+        "actualThickness": 0.32
       },
       {
-        "filamentId": "upcjpfe",
-        "startHeight": 1.36,
-        "endHeight": 1.68,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 2.08,
+        "endHeight": 2.16,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 1.68,
-        "endHeight": 2,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.32
+        "filamentId": "p9c63ms",
+        "startHeight": 2.16,
+        "endHeight": 2.64,
+        "idealThickness": 0.42,
+        "actualThickness": 0.48
       },
       {
         "filamentId": "xyyxysq",
-        "startHeight": 2,
-        "endHeight": 2.32,
+        "startHeight": 2.64,
+        "endHeight": 2.96,
         "idealThickness": 0.357,
         "actualThickness": 0.32
       },
       {
-        "filamentId": "vsn9q6u",
-        "startHeight": 2.32,
-        "endHeight": 2.56,
-        "idealThickness": 0.26599999999999996,
-        "actualThickness": 0.24
+        "filamentId": "azwg1yp",
+        "startHeight": 2.96,
+        "endHeight": 3.12,
+        "idealThickness": 0.16,
+        "actualThickness": 0.16
       },
       {
-        "filamentId": "p9c63ms",
-        "startHeight": 2.56,
-        "endHeight": 3.04,
-        "idealThickness": 0.42000000000000004,
+        "filamentId": "w8cncoa",
+        "startHeight": 3.12,
+        "endHeight": 3.6,
+        "idealThickness": 0.44099999999999995,
         "actualThickness": 0.48
       },
       {
-        "filamentId": "98z555k",
-        "startHeight": 3.04,
-        "endHeight": 3.28,
-        "idealThickness": 0.27299999999999996,
-        "actualThickness": 0.24
-      },
-      {
-        "filamentId": "upcjpfe",
-        "startHeight": 3.28,
-        "endHeight": 3.6,
-        "idealThickness": 0.343,
-        "actualThickness": 0.32
+        "filamentId": "plvjtmc",
+        "startHeight": 3.6,
+        "endHeight": 3.68,
+        "idealThickness": 0.08,
+        "actualThickness": 0.08
       }
     ],
-    "totalHeight": 3.6,
+    "totalHeight": 3.68,
     "compressionRatio": 1
   }
 }
diff --git a/tests/assets/autopaint-calibrated-baseline.json b/tests/assets/autopaint-calibrated-baseline.json
new file mode 100644
index 0000000..965e636
--- /dev/null
+++ b/tests/assets/autopaint-calibrated-baseline.json
@@ -0,0 +1,123 @@
+{
+  "standard": {
+    "totalHeight": 2.4,
+    "idealHeight": 2.3681866826143154,
+    "filamentOrder": [
+      "plvjtmc",
+      "azwg1yp",
+      "vsn9q6u",
+      "upcjpfe",
+      "98z555k",
+      "xyyxysq",
+      "w8cncoa",
+      "p9c63ms"
+    ],
+    "layers": [
+      {
+        "filamentId": "plvjtmc",
+        "filamentColor": "#000000",
+        "startHeight": 0,
+        "endHeight": 0.16
+      },
+      {
+        "filamentId": "azwg1yp",
+        "filamentColor": "#6300c5",
+        "startHeight": 0.16,
+        "endHeight": 0.48
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "filamentColor": "#d83400",
+        "startHeight": 0.48,
+        "endHeight": 0.88
+      },
+      {
+        "filamentId": "upcjpfe",
+        "filamentColor": "#04bb00",
+        "startHeight": 0.88,
+        "endHeight": 1.12
+      },
+      {
+        "filamentId": "98z555k",
+        "filamentColor": "#ff5ec4",
+        "startHeight": 1.12,
+        "endHeight": 1.52
+      },
+      {
+        "filamentId": "xyyxysq",
+        "filamentColor": "#00b8c4",
+        "startHeight": 1.52,
+        "endHeight": 1.76
+      },
+      {
+        "filamentId": "w8cncoa",
+        "filamentColor": "#f7d000",
+        "startHeight": 1.76,
+        "endHeight": 2.08
+      },
+      {
+        "filamentId": "p9c63ms",
+        "filamentColor": "#ffffff",
+        "startHeight": 2.08,
+        "endHeight": 2.4
+      }
+    ]
+  },
+  "enhancedFast": {
+    "totalHeight": 2.08,
+    "idealHeight": 2.01150600769796,
+    "filamentOrder": [
+      "plvjtmc",
+      "p9c63ms",
+      "vsn9q6u",
+      "w8cncoa",
+      "98z555k",
+      "xyyxysq",
+      "azwg1yp"
+    ],
+    "layers": [
+      {
+        "filamentId": "plvjtmc",
+        "filamentColor": "#000000",
+        "startHeight": 0,
+        "endHeight": 0.16
+      },
+      {
+        "filamentId": "p9c63ms",
+        "filamentColor": "#ffffff",
+        "startHeight": 0.16,
+        "endHeight": 0.56
+      },
+      {
+        "filamentId": "vsn9q6u",
+        "filamentColor": "#d83400",
+        "startHeight": 0.56,
+        "endHeight": 0.88
+      },
+      {
+        "filamentId": "w8cncoa",
+        "filamentColor": "#f7d000",
+        "startHeight": 0.88,
+        "endHeight": 1.2
+      },
+      {
+        "filamentId": "98z555k",
+        "filamentColor": "#ff5ec4",
+        "startHeight": 1.2,
+        "endHeight": 1.52
+      },
+      {
+        "filamentId": "xyyxysq",
+        "filamentColor": "#00b8c4",
+        "startHeight": 1.52,
+        "endHeight": 1.84
+      },
+      {
+        "filamentId": "azwg1yp",
+        "filamentColor": "#6300c5",
+        "startHeight": 1.84,
+        "endHeight": 2.08
+      }
+    ]
+  }
+}
\ No newline at end of file
diff --git a/tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil b/tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil
new file mode 100644
index 0000000..61f5083
--- /dev/null
+++ b/tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil
@@ -0,0 +1,287 @@
+{
+  "id": "c2e9e401-d1bf-49c8-9166-1bdc487ffd64",
+  "name": "8 Colors Calibrated New",
+  "version": 1,
+  "filaments": [
+    {
+      "id": "p9c63ms",
+      "color": "#ffffff",
+      "td": 0.5077096875055095,
+      "calibration": {
+        "opacityLayers": 7,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.4908894086367234,
+          0.5077096875055095,
+          0.49943726291595697
+        ],
+        "tdSingleValue": 0.5077096875055095,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.9587611519194583,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.797Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 7,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#00b8c4",
+            "opacityLayers": 7,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "plvjtmc",
+      "color": "#000000",
+      "td": 0.05,
+      "calibration": {
+        "opacityLayers": 1,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.05,
+          0.05,
+          0.05
+        ],
+        "tdSingleValue": 0.05,
+        "jnd": 2,
+        "baseColor": "#6300c5",
+        "confidence": 0.467990454631796,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.806Z",
+        "reads": [
+          {
+            "baseColor": "#6300c5",
+            "opacityLayers": 1
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 1
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "98z555k",
+      "color": "#ff5ec4",
+      "td": 0.519286177194662,
+      "calibration": {
+        "opacityLayers": 7,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.519286177194662,
+          0.23963829238245016,
+          0.41680651754298187
+        ],
+        "tdSingleValue": 0.519286177194662,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.96,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.819Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 7,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "w8cncoa",
+      "color": "#f7d000",
+      "td": 0.44542466216175114,
+      "calibration": {
+        "opacityLayers": 6,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.44542466216175114,
+          0.3595734312582509,
+          0.0673046271932013
+        ],
+        "tdSingleValue": 0.44542466216175114,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7999999999999999,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.838Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 6,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 4,
+            "mergeLayers": 3
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "vsn9q6u",
+      "color": "#d83400",
+      "td": 0.5646261641279794,
+      "calibration": {
+        "opacityLayers": 8,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.5646261641279794,
+          0.13741866688897755,
+          0.10291354194296926
+        ],
+        "tdSingleValue": 0.5646261641279794,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.9557348503300864,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.855Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 8,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#f7d000",
+            "opacityLayers": 4,
+            "mergeLayers": 3
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "azwg1yp",
+      "color": "#6300c5",
+      "td": 0.3743629711219067,
+      "calibration": {
+        "opacityLayers": 4,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.22211060078297443,
+          0.06830463482833873,
+          0.3743629711219067
+        ],
+        "tdSingleValue": 0.3743629711219067,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7999999999999999,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.868Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 4,
+            "mergeLayers": 3
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "xyyxysq",
+      "color": "#00b8c4",
+      "td": 0.3725880555637347,
+      "calibration": {
+        "opacityLayers": 5,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.06826408547833909,
+          0.353955975762588,
+          0.3725880555637347
+        ],
+        "tdSingleValue": 0.3725880555637347,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7999999999999999,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.880Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    },
+    {
+      "id": "upcjpfe",
+      "color": "#04bb00",
+      "td": 0.37055468605919367,
+      "calibration": {
+        "opacityLayers": 5,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.1553450909824613,
+          0.37055468605919367,
+          0.07053705952903433
+        ],
+        "tdSingleValue": 0.37055468605919367,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7946766727762713,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.898Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          },
+          {
+            "baseColor": "#f7d000",
+            "opacityLayers": 4,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default"
+      }
+    }
+  ],
+  "createdAt": 1783004932247,
+  "updatedAt": 1783004932247
+}
\ No newline at end of file
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 5130694..0a52dac 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -187,7 +187,7 @@ test('calibrated per-channel TDs tint blends without changing scalar TD behavior
     );
 });
 
-test('legacy photo calibrations are ignored and use the frontlit fallback scale', async () => {
+test('legacy photo calibrations are ignored and blend like uncalibrated filaments', async () => {
     const { generateAutoLayers } = await loadAutoPaintModule();
     const filaments = [
         { id: 'black', color: '#000000', td: 1 },
@@ -512,8 +512,10 @@ test('auto-paint caps and optimizer palettes use the same discrete printable sta
         'an impossible cap must not be rounded up past the requested maximum'
     );
 
+    // tds are hiding distances consumed as-is; the optimizer and the preview
+    // now share the exact same filament inputs with no internal scaling.
     const palette = buildAchievableColorPalette(
-        filaments.map((filament) => ({ ...filament, td: filament.td * 0.1 })),
+        filaments,
         layerHeight,
         firstLayerHeight,
         maxHeight
@@ -612,3 +614,51 @@ test('auto-paint slice data never returns more than 500 layers', async () => {
     assert.ok(slices.colorSliceHeights.length <= 500);
     assert.equal(slices.colorSliceHeights.length, 500);
 });
+
+test('calibrated profiles produce identical output across the hiding-distance migration', async () => {
+    // Baseline captured immediately before the schema-v2 (hiding distance)
+    // migration with the same inputs: the calibrated path must be unaffected
+    // by removing the runtime frontlit scaling.
+    const { generateAutoLayers } = await loadAutoPaintModule();
+    const { readFileSync } = await import('node:fs');
+    const profile = JSON.parse(
+        readFileSync(
+            resolve(process.cwd(), 'tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil'),
+            'utf8'
+        )
+    ) as { filaments: Array<{ id: string; color: string; td: number }> };
+    const baseline = JSON.parse(
+        readFileSync(resolve(process.cwd(), 'tests/assets/autopaint-calibrated-baseline.json'), 'utf8')
+    );
+    const swatches = [
+        { hex: '#000000', count: 120 },
+        { hex: '#ffffff', count: 80 },
+        { hex: '#d83400', count: 60 },
+        { hex: '#00b8c4', count: 50 },
+        { hex: '#6300c5', count: 40 },
+        { hex: '#f7d000', count: 30 },
+    ];
+    const normalize = (result: {
+        totalHeight: number;
+        idealHeight: number;
+        filamentOrder: string[];
+        layers: unknown[];
+    }) =>
+        JSON.parse(
+            JSON.stringify({
+                totalHeight: result.totalHeight,
+                idealHeight: result.idealHeight,
+                filamentOrder: result.filamentOrder,
+                layers: result.layers,
+            })
+        );
+
+    const standard = generateAutoLayers(profile.filaments, swatches, 0.08, 0.16, undefined, false);
+    assert.deepEqual(normalize(standard), baseline.standard);
+
+    const enhanced = generateAutoLayers(profile.filaments, swatches, 0.08, 0.16, undefined, true, false, {
+        algorithm: 'fast',
+        seed: 42,
+    });
+    assert.deepEqual(normalize(enhanced), baseline.enhancedFast);
+});
diff --git a/tests/autoPaintGoldenFixtures.ts b/tests/autoPaintGoldenFixtures.ts
index 371c331..4fcf653 100644
--- a/tests/autoPaintGoldenFixtures.ts
+++ b/tests/autoPaintGoldenFixtures.ts
@@ -1,6 +1,10 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 
+import {
+    CURRENT_PROFILE_VERSION,
+    migrateLegacyFilamentTd,
+} from '../src/lib/profileManager.ts';
 import {
     colorSwatchesFromJpegBlocks,
     logoFixturePath,
@@ -34,19 +38,27 @@ const SWATCH_CAP = 2 ** 14;
 
 function readProfile(fileName: string, expectedFilamentCount: number): FilamentProfileFixture {
     const profilePath = resolve(testAssetsRoot, 'filament-profiles', fileName);
-    const parsed = JSON.parse(readFileSync(profilePath, 'utf8')) as Partial<FilamentProfileFixture>;
+    const parsed = JSON.parse(readFileSync(profilePath, 'utf8')) as Partial<FilamentProfileFixture> & {
+        version?: number;
+    };
 
     if (!parsed.name || !parsed.filaments || parsed.filaments.length !== expectedFilamentCount) {
         throw new Error(`Unexpected auto-paint profile fixture: ${fileName}`);
     }
 
+    // Fixture .kapp files are authentic schema-v1 exports; run them through the
+    // real td migration so scenarios use hiding distances like live profiles.
+    const version = typeof parsed.version === 'number' ? parsed.version : 1;
     return {
         name: parsed.name,
-        filaments: parsed.filaments.map((filament) => ({
-            id: filament.id,
-            color: filament.color,
-            td: filament.td,
-        })),
+        filaments: parsed.filaments.map((filament) => {
+            const shaped = {
+                id: filament.id,
+                color: filament.color,
+                td: filament.td,
+            };
+            return version < CURRENT_PROFILE_VERSION ? migrateLegacyFilamentTd(shaped) : shaped;
+        }),
     };
 }
 
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index df2c1c6..0a24f02 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -115,9 +115,12 @@ function loadFilamentProfileFixture(
 ): FilamentProfileFixture {
     const raw = JSON.parse(
         readFileSync(resolve(filamentProfilesRoot, fileName), 'utf8')
-    ) as Partial<FilamentProfileFixture>;
+    ) as Partial<FilamentProfileFixture> & { version?: number };
     const name = raw.name;
     const filaments = raw.filaments;
+    // .kapp fixtures are schema-v1 exports: uncalibrated tds are on the legacy
+    // backlit scale and convert to hiding distances (×0.1) like live imports.
+    const legacyTdScale = (raw.version ?? 1) < 2 ? 0.1 : 1;
 
     if (typeof name !== 'string') {
         assert.fail(`${fileName} should include a profile name`);
@@ -141,7 +144,7 @@ function loadFilamentProfileFixture(
             return {
                 id: filament.id,
                 color: normalizeFixtureHex(filament.color, `${fileName} filament ${index}`),
-                td: filament.td,
+                td: filament.td * legacyTdScale,
             };
         }),
     };
diff --git a/tests/hidingDistance.test.ts b/tests/hidingDistance.test.ts
new file mode 100644
index 0000000..b23eca8
--- /dev/null
+++ b/tests/hidingDistance.test.ts
@@ -0,0 +1,120 @@
+import assert from 'node:assert/strict';
+import { resolve } from 'node:path';
+import test from 'node:test';
+import { createServer } from 'vite';
+
+import type { Filament } from '../src/types/index.ts';
+
+type ColorUtilsModule = typeof import('../src/lib/colorUtils.ts');
+type CalibrationModule = typeof import('../src/lib/calibration.ts');
+type ProfileManagerModule = typeof import('../src/lib/profileManager.ts');
+
+let colorUtilsModule: Promise<ColorUtilsModule> | null = null;
+let calibrationModule: Promise<CalibrationModule> | null = null;
+let profileManagerModule: Promise<ProfileManagerModule> | null = null;
+
+async function loadViteModule<T>(modulePath: string): Promise<T> {
+    const server = await createServer({
+        appType: 'custom',
+        cacheDir: 'dist/.vite-test-cache',
+        configFile: false,
+        logLevel: 'error',
+        optimizeDeps: { noDiscovery: true },
+        resolve: { alias: { '@': resolve(process.cwd(), 'src') } },
+        root: process.cwd(),
+        server: { hmr: false, middlewareMode: true },
+    });
+    try {
+        return (await server.ssrLoadModule(modulePath)) as T;
+    } finally {
+        await server.close();
+    }
+}
+
+const loadColorUtils = () =>
+    (colorUtilsModule ??= loadViteModule<ColorUtilsModule>('/src/lib/colorUtils.ts'));
+const loadCalibration = () =>
+    (calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts'));
+const loadProfileManager = () =>
+    (profileManagerModule ??= loadViteModule<ProfileManagerModule>('/src/lib/profileManager.ts'));
+
+test('estimateHidingDistanceFromColor returns frontlit-scale values', async () => {
+    const { estimateHidingDistanceFromColor } = await loadColorUtils();
+    // Legacy backlit-TD shape × FRONTLIT_TD_SCALE, rounded to 2 decimals.
+    assert.equal(estimateHidingDistanceFromColor('#ffffff'), 0.71);
+    assert.equal(estimateHidingDistanceFromColor('#000000'), 0.08);
+
+    for (const hex of ['#ff0000', '#00b8c4', '#808080', '#f7d000']) {
+        const hd = estimateHidingDistanceFromColor(hex);
+        assert.ok(hd >= 0.06 && hd <= 0.85, `${hex}: ${hd} out of the HD range`);
+    }
+});
+
+test('channelHds returns measured channels for calibrated filaments', async () => {
+    const { channelHds } = await loadCalibration();
+    const filament: Filament = {
+        id: 'cal',
+        color: '#00b8c4',
+        td: 0.37,
+        calibration: {
+            opacityLayers: 5,
+            layerHeight: 0.08,
+            firstLayerHeight: 0.16,
+            td: [0.068, 0.354, 0.373],
+            tdSingleValue: 0.373,
+            jnd: 2,
+            baseColor: '#000000',
+            confidence: 0.8,
+            basis: 'frontlit',
+            calibrationDate: '2026-07-02T00:00:00.000Z',
+        },
+    };
+    assert.deepEqual(channelHds(filament), [0.068, 0.354, 0.373]);
+});
+
+test('channelHds derives color-shaped channels for uncalibrated filaments', async () => {
+    const { channelHds, deriveChannelTds } = await loadCalibration();
+    const filament: Filament = { id: 'uncal', color: '#ff0000', td: 0.4 };
+    const channels = channelHds(filament);
+    assert.deepEqual(channels, deriveChannelTds('#ff0000', 0.4));
+    // Brightest channel anchors at the scalar; dark channels shrink.
+    assert.ok(Math.abs(channels[0] - 0.4) < 1e-9, 'red channel anchors the scalar HD');
+    assert.ok(channels[1] < channels[0] && channels[2] < channels[0]);
+});
+
+test('channelHds ignores invalid calibration shapes and falls back to derivation', async () => {
+    const { channelHds, deriveChannelTds } = await loadCalibration();
+    const filament = {
+        id: 'legacy',
+        color: '#ff0000',
+        td: 0.4,
+        calibration: { measurements: [], td: [2, 3, 4], tdSingleValue: 3 },
+    } as unknown as Filament;
+    assert.deepEqual(channelHds(filament), deriveChannelTds('#ff0000', 0.4));
+});
+
+test('migrateLegacyFilamentTd scales uncalibrated tds and re-syncs calibrated ones', async () => {
+    const { migrateLegacyFilamentTd } = await loadProfileManager();
+    const { FRONTLIT_TD_SCALE } = await loadCalibration();
+    const uncalibrated: Filament = { id: 'a', color: '#ffffff', td: 4.0 };
+    assert.ok(Math.abs(migrateLegacyFilamentTd(uncalibrated).td - 4.0 * FRONTLIT_TD_SCALE) < 1e-12);
+
+    const calibrated: Filament = {
+        id: 'b',
+        color: '#ffffff',
+        td: 0.51,
+        calibration: {
+            opacityLayers: 7,
+            layerHeight: 0.08,
+            firstLayerHeight: 0.16,
+            td: [0.49, 0.51, 0.5],
+            tdSingleValue: 0.51,
+            jnd: 2,
+            baseColor: '#000000',
+            confidence: 0.9,
+            basis: 'frontlit',
+            calibrationDate: '2026-07-02T00:00:00.000Z',
+        },
+    };
+    assert.equal(migrateLegacyFilamentTd(calibrated).td, 0.51);
+});
diff --git a/tests/nextBestColor.test.ts b/tests/nextBestColor.test.ts
index 580d26d..aea8369 100644
--- a/tests/nextBestColor.test.ts
+++ b/tests/nextBestColor.test.ts
@@ -67,10 +67,11 @@ test('identifies the most impactful missing color', () => {
 });
 
 test('blend-aware: far candidate wins when its segment covers the common color territory', () => {
-    // With only BLACK and an achromatic image, near-white creates a segment
-    // (#eeeeee↔BLACK) that spans the full L-axis, passing through #888888's Lab
-    // position — so adding it captures those pixels via blending.  Blend-aware
-    // scoring correctly prefers the longer segment even at count=1.
+    // With only BLACK and an achromatic image, a lighter-grey candidate creates
+    // a segment toward BLACK that passes through #888888's Lab position — so
+    // adding it captures the common mid-grey pixels via blending while also
+    // reaching toward the rare near-white. Under linear-light blending the
+    // extrapolated light grey wins over picking #888888 directly.
     const r = nextBestColor(
         [BLACK],
         [
@@ -79,7 +80,9 @@ test('blend-aware: far candidate wins when its segment covers the common color t
         ]
     );
     assert.ok(r.candidate !== null);
-    assert.equal(r.candidate.hex, '#888888');
+    assert.equal(r.candidate.hex, '#c9c9c9');
+    // The winner's blend segment must capture the common mid-grey pixels.
+    assert.ok(r.candidate.pixelsCaptured >= 1000);
 });
 
 test('pixel count weighting: common color beats rare one when blend segments diverge', () => {
@@ -314,3 +317,43 @@ test('baselineAvgDeltaE is 0 when all swatches exactly match filaments', () => {
     const r = nextBestColor([RED], [{ hex: '#ff0000', count: 50 }]);
     assert.ok(r.baselineAvgDeltaE < 1, `expected near 0, got ${r.baselineAvgDeltaE}`);
 });
+
+// ---------------------------------------------------------------------------
+// Hiding-distance semantics + linear-light blending
+// ---------------------------------------------------------------------------
+
+test('blendRgb composites in linear light like blendSrgbChannel', async () => {
+    const { blendRgb } = await import('../src/lib/nextBestColor.ts');
+    // 50% transmission of white background through a black layer: the
+    // linear-light midpoint re-encodes to ~188 sRGB, not the gamma midpoint 128.
+    const halfTransmissionThickness = Math.log10(2); // t = 10^(-th/td) = 0.5 at td=1
+    const blended = blendRgb(
+        { r: 255, g: 255, b: 255 },
+        { r: 0, g: 0, b: 0 },
+        1,
+        halfTransmissionThickness
+    );
+    assert.ok(Math.abs(blended.r - 188) < 1.5, `expected ~188, got ${blended.r}`);
+    assert.ok(Math.abs(blended.g - blended.r) < 1e-9 && Math.abs(blended.b - blended.r) < 1e-9);
+});
+
+test('recommended hiding distance is borrowed on the stored (frontlit) scale', () => {
+    // Calibrated-profile-like HD values (~0.3–0.6 mm). The suggestion must come
+    // back on the same scale so the added filament simulates correctly.
+    const filaments: Filament[] = [
+        { id: 'black', color: '#000000', td: 0.05 },
+        { id: 'white', color: '#ffffff', td: 0.51 },
+        { id: 'red', color: '#d83400', td: 0.56 },
+    ];
+    const r = nextBestColor(filaments, [
+        { hex: '#000000', count: 100 },
+        { hex: '#00b8c4', count: 400 },
+    ]);
+    assert.ok(r.candidate !== null, 'expected a candidate');
+    const tds = filaments.map((f) => f.td);
+    assert.ok(
+        tds.includes(r.candidate!.td),
+        `candidate td ${r.candidate!.td} must be borrowed from an existing filament`
+    );
+    assert.ok(r.candidate!.td <= 2, 'td must be on the hiding-distance scale');
+});
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 81e5e26..474f602 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -152,3 +152,141 @@ test('stored auto-paint profiles strip legacy photo calibration objects on load'
         if (!existingStorage) Reflect.deleteProperty(globalThis, 'localStorage');
     }
 });
+
+test('v1 profile imports migrate uncalibrated tds to hiding distances', async () => {
+    const { importProfiles, CURRENT_PROFILE_VERSION } = await loadProfileManager();
+    const incoming = [
+        {
+            id: 'profile-v1',
+            name: 'Legacy Scale Profile',
+            version: 1,
+            createdAt: 1,
+            updatedAt: 1,
+            filaments: [
+                { id: 'f-uncal', color: '#ffffff', td: 4.0 },
+            ],
+        },
+    ] as unknown as AutoPaintProfile[];
+
+    const result = importProfiles([], incoming);
+    assert.equal(result.imported.length, 1);
+    assert.equal(result.imported[0].version, CURRENT_PROFILE_VERSION);
+    assert.ok(Math.abs(result.imported[0].filaments[0].td - 0.4) < 1e-12);
+});
+
+test('v1 profile imports re-sync calibrated tds to the measured scalar', async () => {
+    const { importProfiles } = await loadProfileManager();
+    const calibration = {
+        opacityLayers: 6,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+        td: [0.4, 0.45, 0.5],
+        tdSingleValue: 0.5,
+        jnd: 2,
+        baseColor: '#000000',
+        confidence: 0.9,
+        basis: 'frontlit',
+        calibrationDate: '2026-07-01T00:00:00.000Z',
+    };
+    const incoming = [
+        {
+            id: 'profile-v1-cal',
+            name: 'Legacy Calibrated Profile',
+            version: 1,
+            createdAt: 1,
+            updatedAt: 1,
+            filaments: [{ id: 'f-cal', color: '#ffffff', td: 0.5, calibration }],
+        },
+    ] as unknown as AutoPaintProfile[];
+
+    const result = importProfiles([], incoming);
+    assert.equal(result.imported.length, 1);
+    // Calibrated filaments never get the ×0.1 conversion; td stays the measured scalar.
+    assert.equal(result.imported[0].filaments[0].td, 0.5);
+    assert.ok(result.imported[0].filaments[0].calibration);
+});
+
+test('v2 profile imports are not re-scaled (double-import idempotence)', async () => {
+    const { importProfiles, exportProfileBlob, parseProfileFile, CURRENT_PROFILE_VERSION } =
+        await loadProfileManager();
+    const incoming = [
+        {
+            id: 'profile-v2',
+            name: 'HD Profile',
+            version: CURRENT_PROFILE_VERSION,
+            createdAt: 1,
+            updatedAt: 1,
+            filaments: [{ id: 'f-hd', color: '#ffffff', td: 0.4 }],
+        },
+    ] as unknown as AutoPaintProfile[];
+
+    const first = importProfiles([], incoming);
+    assert.equal(first.imported[0].filaments[0].td, 0.4);
+
+    // Export → parse → re-import must be a no-op on td values.
+    const blob = exportProfileBlob(first.imported[0]);
+    const json = await blob.text();
+    const reparsed = parseProfileFile(json);
+    assert.ok(reparsed);
+    const second = importProfiles([], reparsed!);
+    // Same id → overwrite path; td unchanged.
+    assert.equal(second.profiles.length, 1);
+    const stored = second.profiles.find((p) => p.id === 'profile-v2');
+    assert.ok(stored);
+    assert.equal(stored!.filaments[0].td, 0.4);
+});
+
+test('stored v1 profiles migrate tds once on load', async () => {
+    const { loadProfiles, CURRENT_PROFILE_VERSION } = await loadProfileManager();
+    const existingStorage = Reflect.get(globalThis, 'localStorage') as
+        | ReturnType<typeof createMemoryStorage>
+        | undefined;
+    const storage = existingStorage ?? createMemoryStorage();
+    if (!existingStorage) {
+        Object.defineProperty(globalThis, 'localStorage', {
+            configurable: true,
+            value: storage,
+        });
+    }
+
+    const previousProfiles = storage.getItem('kromacut.autopaint.profiles');
+    storage.setItem(
+        'kromacut.autopaint.profiles',
+        JSON.stringify([
+            {
+                id: 'stored-v1',
+                name: 'Stored Legacy Scale',
+                version: 1,
+                createdAt: 1,
+                updatedAt: 1,
+                filaments: [{ id: 'f1', color: '#f7d000', td: 6.3 }],
+            },
+            {
+                id: 'stored-v2',
+                name: 'Stored HD',
+                version: CURRENT_PROFILE_VERSION,
+                createdAt: 1,
+                updatedAt: 1,
+                filaments: [{ id: 'f2', color: '#f7d000', td: 0.63 }],
+            },
+        ])
+    );
+
+    try {
+        const loaded = loadProfiles();
+        assert.equal(loaded.length, 2);
+        const v1 = loaded.find((p) => p.id === 'stored-v1');
+        const v2 = loaded.find((p) => p.id === 'stored-v2');
+        assert.ok(v1 && v2);
+        assert.ok(Math.abs(v1!.filaments[0].td - 0.63) < 1e-12, 'v1 td migrates ×0.1');
+        assert.equal(v2!.filaments[0].td, 0.63, 'v2 td untouched');
+        assert.equal(v1!.version, CURRENT_PROFILE_VERSION);
+    } finally {
+        if (previousProfiles === null) {
+            storage.removeItem('kromacut.autopaint.profiles');
+        } else {
+            storage.setItem('kromacut.autopaint.profiles', previousProfiles);
+        }
+        if (!existingStorage) Reflect.deleteProperty(globalThis, 'localStorage');
+    }
+});

From 5aa9c780f870a71e7602b460a856b35ee616b1d3 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 09:47:42 +0300
Subject: [PATCH 43/81] Remove the per-row calibrate button

The flask button on each filament row duplicated the Calibrate Filaments
button below the list. Drop it along with the now-unused initialFilamentId
preselect plumbing in AutoPaintTab and the calibration dialog; the dialog
always opens on an empty selection.
---
 src/components/AutoPaintTab.tsx              |  8 +-------
 src/components/FilamentCalibrationDialog.tsx | 16 +++-------------
 src/components/FilamentRow.tsx               | 16 +---------------
 src/docs/3d-mode.md                          |  2 +-
 4 files changed, 6 insertions(+), 36 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index d5ad631..49d032f 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -222,18 +222,14 @@ export default function AutoPaintTab({
     );
 
     // Calibration dialog state
-    const [calibratingFilamentId, setCalibratingFilamentId] = React.useState<string | null>(null);
     const [calibrationDialogOpen, setCalibrationDialogOpen] = React.useState(false);
 
-    const handleOpenCalibration = React.useCallback((id?: string) => {
-        setCalibratingFilamentId(id ?? null);
+    const handleOpenCalibration = React.useCallback(() => {
         setCalibrationDialogOpen(true);
     }, []);
 
     const handleCloseCalibration = React.useCallback(() => {
         setCalibrationDialogOpen(false);
-        // Clear the ID after a short delay to avoid visible state change
-        setTimeout(() => setCalibratingFilamentId(null), 300);
     }, []);
 
     const handleApplyCalibration = React.useCallback(
@@ -469,7 +465,6 @@ export default function AutoPaintTab({
                                     filament={f}
                                     onUpdate={updateFilament}
                                     onRemove={removeFilament}
-                                    onCalibrate={handleOpenCalibration}
                                 />
                             ))}
                         </div>
@@ -1232,7 +1227,6 @@ export default function AutoPaintTab({
                 open={calibrationDialogOpen}
                 onClose={handleCloseCalibration}
                 filaments={filaments}
-                initialFilamentId={calibratingFilamentId}
                 layerHeight={calibrationLayerHeight}
                 firstLayerHeight={firstLayerHeight}
                 onApply={handleApplyCalibration}
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index cdacec1..df4a492 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -69,7 +69,6 @@ interface FilamentCalibrationDialogProps {
     open: boolean;
     onClose: () => void;
     filaments: Filament[];
-    initialFilamentId?: string | null;
     layerHeight: number;
     firstLayerHeight: number;
     onApply: (updates: CalibrationApplyUpdate[]) => void;
@@ -150,21 +149,12 @@ export function FilamentCalibrationDialog({
     open,
     onClose,
     filaments,
-    initialFilamentId,
     layerHeight,
     firstLayerHeight,
     onApply,
 }: FilamentCalibrationDialogProps) {
-    const initialSelection = useCallback(() => {
-        const id =
-            initialFilamentId && filaments.some((filament) => filament.id === initialFilamentId)
-                ? initialFilamentId
-                : null;
-        return new Set(id ? [id] : []);
-    }, [filaments, initialFilamentId]);
-
     const [step, setStep] = useState<Step>('select');
-    const [selectedIds, setSelectedIds] = useState<Set<string>>(() => initialSelection());
+    const [selectedIds, setSelectedIds] = useState<Set<string>>(() => new Set());
     const [maxLayers, setMaxLayers] = useState(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
     const [calibrationLayerHeight, setCalibrationLayerHeight] = useState(layerHeight);
     // Free-typing drafts for the numeric inputs; clamped to the committed value on blur.
@@ -367,7 +357,7 @@ export function FilamentCalibrationDialog({
 
     const reset = useCallback(() => {
         setStep('select');
-        setSelectedIds(initialSelection());
+        setSelectedIds(new Set());
         setMaxLayers(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers);
         setMaxLayersDraft(String(DEFAULT_CALIBRATION_PRINT_OPTIONS.maxLayers));
         setCalibrationLayerHeight(layerHeight);
@@ -378,7 +368,7 @@ export function FilamentCalibrationDialog({
         setMergeReads({});
         setIsSaving(false);
         setBaseChoices({});
-    }, [initialSelection, layerHeight]);
+    }, [layerHeight]);
 
     useEffect(() => {
         if (open && !wasOpenRef.current) reset();
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index d0ccc63..5855ce2 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -1,7 +1,7 @@
 import React, { useEffect, useState } from 'react';
 import { Input } from '@/components/ui/input';
 import { Button } from '@/components/ui/button';
-import { Trash2, Wand2, BadgeCheck, FlaskConical, ArrowRightLeft } from 'lucide-react';
+import { Trash2, Wand2, BadgeCheck, ArrowRightLeft } from 'lucide-react';
 import { HexColorPicker } from 'react-colorful';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import type { Filament } from '../types';
@@ -22,14 +22,12 @@ interface FilamentRowProps {
     filament: Filament;
     onUpdate: (id: string, updates: Partial<Omit<Filament, 'id'>>) => void;
     onRemove: (id: string) => void;
-    onCalibrate?: (id: string) => void;
 }
 
 const FilamentRow = React.memo(function FilamentRow({
     filament,
     onUpdate,
     onRemove,
-    onCalibrate,
 }: FilamentRowProps) {
     // Local state for the input value to allow free typing
     const [localTd, setLocalTd] = useState<string>(filament.td.toString());
@@ -253,18 +251,6 @@ const FilamentRow = React.memo(function FilamentRow({
                 <Wand2 className="w-4 h-4" />
             </Button>
 
-            {onCalibrate && (
-                <Button
-                    variant="ghost"
-                    size="icon"
-                    onClick={() => onCalibrate(filament.id)}
-                    className="h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer"
-                    title="Calibrate filament"
-                >
-                    <FlaskConical className="w-4 h-4" />
-                </Button>
-            )}
-
             {/* Calibration Badge */}
             {isCalibrated && (
                 <div
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 2b4ca35..fe89d22 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -46,7 +46,7 @@ Use the wand button to auto-estimate the hiding distance from color, calibrate t
 
 ## Calibrating Filament Hiding Distance
 
-Calibration is camera-free: you print a small wedge and read back one or more opacity numbers. Click the calibration button on a filament row, or **Calibrate Filaments** below the filament list, to open the dialog. It has four steps:
+Calibration is camera-free: you print a small wedge and read back one or more opacity numbers. Click **Calibrate Filaments** below the filament list to open the dialog. It has four steps:
 
 1. **Select** the filaments you want to calibrate.
 2. **Base layers** - choose **Quick** for one base read, or **Accurate** for two or three base reads per filament. Kromacut auto-picks useful bases from your real profile filaments, and you can override them with the base swatches.

From 85c8d73d943375354f67a73a9873661992e110a4 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 10:03:53 +0300
Subject: [PATCH 44/81] Polish the auto-paint filament list UI

- Filament rows reveal their secondary actions (convert-from-TD, wand
  estimate) on hover/focus instead of showing two icon buttons per row;
  open popovers keep their trigger visible.
- Every row gets a fixed-width calibration status chip: the colored
  confidence label when calibrated, a dashed "Estimate" chip with a
  per-channel tooltip when not, so mixed profiles stay column-aligned.
- Add Filament and Calibrate Filaments share one line.
- The profile action strip keeps a stable width (delete is always rendered,
  disabled without an active profile) and gains subtle group separators.
---
 src/components/AutoPaintTab.tsx | 61 ++++++++++++++++++---------------
 src/components/FilamentRow.tsx  | 28 ++++++++++-----
 2 files changed, 53 insertions(+), 36 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 49d032f..a37ed89 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -399,6 +399,8 @@ export default function AutoPaintTab({
                             </PopoverContent>
                         </Popover>
 
+                        <div className="w-px h-5 bg-border/70 flex-shrink-0" />
+
                         {/* Import */}
                         <input
                             ref={importInputRef}
@@ -430,18 +432,19 @@ export default function AutoPaintTab({
                             <Download className="w-4 h-4" />
                         </Button>
 
-                        {/* Delete */}
-                        {activeProfileId && (
-                            <Button
-                                variant="ghost"
-                                size="icon"
-                                className="h-8 w-8 text-muted-foreground hover:text-destructive hover:bg-destructive/10 cursor-pointer flex-shrink-0"
-                                title="Delete selected profile"
-                                onClick={() => handleDeleteProfile(activeProfileId)}
-                            >
-                                <Trash2 className="w-4 h-4" />
-                            </Button>
-                        )}
+                        <div className="w-px h-5 bg-border/70 flex-shrink-0" />
+
+                        {/* Delete — always rendered so the strip width stays stable */}
+                        <Button
+                            variant="ghost"
+                            size="icon"
+                            className="h-8 w-8 text-muted-foreground hover:text-destructive hover:bg-destructive/10 cursor-pointer flex-shrink-0 disabled:opacity-40 disabled:cursor-not-allowed"
+                            title="Delete selected profile"
+                            disabled={!activeProfileId}
+                            onClick={() => activeProfileId && handleDeleteProfile(activeProfileId)}
+                        >
+                            <Trash2 className="w-4 h-4" />
+                        </Button>
                     </div>
 
                     {/* Import feedback */}
@@ -469,27 +472,29 @@ export default function AutoPaintTab({
                             ))}
                         </div>
                     )}
-                    <Button
-                        variant="outline"
-                        size="sm"
-                        onClick={addFilament}
-                        className="w-full text-xs gap-1.5 h-8 border-dashed border-border hover:border-primary/50 hover:bg-primary/5 text-muted-foreground hover:text-primary cursor-pointer"
-                    >
-                        <Plus className="w-3.5 h-3.5" />
-                        Add Filament
-                    </Button>
-
-                    {filaments.length > 0 && (
+                    <div className={filaments.length > 0 ? 'grid grid-cols-2 gap-2' : ''}>
                         <Button
                             variant="outline"
                             size="sm"
-                            onClick={() => handleOpenCalibration()}
-                            className="w-full gap-1.5 h-8 cursor-pointer"
+                            onClick={addFilament}
+                            className="w-full text-xs gap-1.5 h-8 border-dashed border-border hover:border-primary/50 hover:bg-primary/5 text-muted-foreground hover:text-primary cursor-pointer"
                         >
-                            <FlaskConical className="w-3.5 h-3.5" />
-                            Calibrate Filaments
+                            <Plus className="w-3.5 h-3.5" />
+                            Add Filament
                         </Button>
-                    )}
+
+                        {filaments.length > 0 && (
+                            <Button
+                                variant="outline"
+                                size="sm"
+                                onClick={() => handleOpenCalibration()}
+                                className="w-full text-xs gap-1.5 h-8 cursor-pointer"
+                            >
+                                <FlaskConical className="w-3.5 h-3.5" />
+                                Calibrate Filaments
+                            </Button>
+                        )}
+                    </div>
 
                     {/* Max Height Constraint */}
                     {filaments.length > 0 && (
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index 5855ce2..a004759 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -135,8 +135,13 @@ const FilamentRow = React.memo(function FilamentRow({
         }
     };
 
+    // Secondary actions stay hidden until the row is hovered or focused; an
+    // open popover keeps its trigger visible via the radix data-state attribute.
+    const revealOnHover =
+        'opacity-0 group-hover:opacity-100 group-focus-within:opacity-100 data-[state=open]:opacity-100 transition-opacity';
+
     return (
-        <div className="flex items-center gap-2 p-2 rounded-md border border-border/40 bg-card hover:border-border/80 transition-colors">
+        <div className="group flex items-center gap-2 p-2 rounded-md border border-border/40 bg-card hover:border-border/80 transition-colors">
             {/* Color Picker Popover */}
             <Popover>
                 <PopoverTrigger asChild>
@@ -201,7 +206,7 @@ const FilamentRow = React.memo(function FilamentRow({
                     <Button
                         variant="ghost"
                         size="icon"
-                        className="h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer"
+                        className={`h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer ${revealOnHover}`}
                         title="Convert from TD (lithophane/backlit value)"
                     >
                         <ArrowRightLeft className="w-4 h-4" />
@@ -245,20 +250,27 @@ const FilamentRow = React.memo(function FilamentRow({
                     setLocalTd(estimated.toString());
                     onUpdate(filament.id, { td: estimated, calibration: undefined });
                 }}
-                className="h-8 w-8 text-muted-foreground hover:text-amber-600 hover:bg-amber-600/10 cursor-pointer"
+                className={`h-8 w-8 text-muted-foreground hover:text-amber-600 hover:bg-amber-600/10 cursor-pointer ${revealOnHover}`}
                 title="Auto-estimate hiding distance from color"
             >
                 <Wand2 className="w-4 h-4" />
             </Button>
 
-            {/* Calibration Badge */}
-            {isCalibrated && (
+            {/* Calibration status — fixed-width slot so rows stay aligned */}
+            {isCalibrated ? (
                 <div
-                    className={`flex h-8 items-center gap-1 px-2 rounded-md bg-muted/50 ${confidenceColorClass}`}
+                    className={`flex h-8 w-[4.75rem] flex-shrink-0 items-center justify-center gap-1 rounded-md bg-muted/50 ${confidenceColorClass}`}
                     title={`Calibrated · Confidence: ${confidenceLabel} (${(confidence * 100).toFixed(0)}%)\nMeasured HD per-channel: ${channelText}`}
                 >
-                    <BadgeCheck className="w-3 h-3" />
-                    <span className="text-[10px] font-medium">{confidenceLabel}</span>
+                    <BadgeCheck className="w-3 h-3 flex-shrink-0" />
+                    <span className="text-[10px] font-medium truncate">{confidenceLabel}</span>
+                </div>
+            ) : (
+                <div
+                    className="flex h-8 w-[4.75rem] flex-shrink-0 items-center justify-center rounded-md border border-dashed border-border/60 text-muted-foreground/70"
+                    title={`Not calibrated — hiding distance is estimated or entered manually.\nEstimated HD per-channel: ${channelText}`}
+                >
+                    <span className="text-[10px] font-medium">Estimate</span>
                 </div>
             )}
 

From c8bb0ae18543101c61ae70b5a9b1b72d312da381 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 10:06:00 +0300
Subject: [PATCH 45/81] Keep filament row action buttons always visible

The hover-reveal made the convert and wand buttons hard to discover;
show them permanently, keeping the aligned status chips.
---
 src/components/FilamentRow.tsx | 11 +++--------
 1 file changed, 3 insertions(+), 8 deletions(-)

diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index a004759..f685683 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -135,13 +135,8 @@ const FilamentRow = React.memo(function FilamentRow({
         }
     };
 
-    // Secondary actions stay hidden until the row is hovered or focused; an
-    // open popover keeps its trigger visible via the radix data-state attribute.
-    const revealOnHover =
-        'opacity-0 group-hover:opacity-100 group-focus-within:opacity-100 data-[state=open]:opacity-100 transition-opacity';
-
     return (
-        <div className="group flex items-center gap-2 p-2 rounded-md border border-border/40 bg-card hover:border-border/80 transition-colors">
+        <div className="flex items-center gap-2 p-2 rounded-md border border-border/40 bg-card hover:border-border/80 transition-colors">
             {/* Color Picker Popover */}
             <Popover>
                 <PopoverTrigger asChild>
@@ -206,7 +201,7 @@ const FilamentRow = React.memo(function FilamentRow({
                     <Button
                         variant="ghost"
                         size="icon"
-                        className={`h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer ${revealOnHover}`}
+                        className="h-8 w-8 text-muted-foreground hover:text-primary hover:bg-primary/10 cursor-pointer"
                         title="Convert from TD (lithophane/backlit value)"
                     >
                         <ArrowRightLeft className="w-4 h-4" />
@@ -250,7 +245,7 @@ const FilamentRow = React.memo(function FilamentRow({
                     setLocalTd(estimated.toString());
                     onUpdate(filament.id, { td: estimated, calibration: undefined });
                 }}
-                className={`h-8 w-8 text-muted-foreground hover:text-amber-600 hover:bg-amber-600/10 cursor-pointer ${revealOnHover}`}
+                className="h-8 w-8 text-muted-foreground hover:text-amber-600 hover:bg-amber-600/10 cursor-pointer"
                 title="Auto-estimate hiding distance from color"
             >
                 <Wand2 className="w-4 h-4" />

From dd897e6c6c1894a53d50f598866a25b31cda88fd Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 10:11:23 +0300
Subject: [PATCH 46/81] Polish the auto-paint results UI

- Add a proportional stack bar above the transition-zone list: segments
  sized by zone thickness in their filament colors (left = build plate),
  with per-segment range tooltips and plate/top axis labels.
- Compact zone rows to a single line each - color dot and hex on the left,
  right-aligned start->end range and delta in tabular numerals - so a full
  stack fits without scrolling; compressed zones keep their amber highlight
  with the ideal thickness moved into a tooltip.
- Confidence tiles (Calibration/Coverage/Compression) gain slim progress
  bars colored by their confidence band, via a shared ConfidenceStat tile
  that replaces the triplicated markup.
- Cache-hit/Converged indicators move inline with the Optimizer
  Performance header instead of dangling below the grid.
---
 src/components/AutoPaintTab.tsx | 172 +++++++++++++++++---------------
 1 file changed, 92 insertions(+), 80 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index a37ed89..14cd498 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -34,6 +34,25 @@ import { FilamentCalibrationDialog, type CalibrationApplyUpdate } from './Filame
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
 import { useNextBestColorWorker } from '../hooks/useNextBestColorWorker';
 
+/** Percentage stat tile with a slim progress bar, colored by confidence band. */
+function ConfidenceStat({ label, value }: { label: string; value: number }) {
+    const pct = Math.round(value * 100);
+    return (
+        <div className="text-center p-2 rounded bg-background">
+            <div className="text-muted-foreground mb-1">{label}</div>
+            <div className={`font-semibold ${getConfidenceColor(value)}`}>
+                {pct}%
+                <div className="mt-1 h-1 rounded-full bg-muted overflow-hidden">
+                    <div
+                        className="h-full rounded-full bg-current"
+                        style={{ width: `${Math.max(4, Math.min(100, pct))}%` }}
+                    />
+                </div>
+            </div>
+        </div>
+    );
+}
+
 type OptimizerTierValue = 'fast' | 'balanced' | 'thorough' | 'deep' | 'exact';
 
 interface OptimizerTierMeta {
@@ -931,7 +950,31 @@ export default function AutoPaintTab({
                                         )}
                                     </div>
                                 </div>
-                                <div className="space-y-1.5 max-h-48 overflow-y-auto pr-1">
+
+                                {/* Proportional stack bar: left = build plate, right = top */}
+                                <div className="space-y-1">
+                                    <div className="flex h-4 w-full overflow-hidden rounded-md border border-border/60">
+                                        {autoPaintResult.transitionZones.map(
+                                            (zone: TransitionZone, idx: number) => (
+                                                <div
+                                                    key={`bar-${idx}`}
+                                                    className="h-full"
+                                                    style={{
+                                                        width: `${(zone.actualThickness / autoPaintResult.totalHeight) * 100}%`,
+                                                        backgroundColor: zone.filamentColor,
+                                                    }}
+                                                    title={`${zone.filamentColor} · ${zone.startHeight.toFixed(2)}–${zone.endHeight.toFixed(2)} mm · Δ${zone.actualThickness.toFixed(2)} mm`}
+                                                />
+                                            )
+                                        )}
+                                    </div>
+                                    <div className="flex justify-between text-[9px] text-muted-foreground/70">
+                                        <span>0 mm (plate)</span>
+                                        <span>{autoPaintResult.totalHeight.toFixed(2)} mm (top)</span>
+                                    </div>
+                                </div>
+
+                                <div className="space-y-1 max-h-48 overflow-y-auto pr-1">
                                     {autoPaintResult.transitionZones.map(
                                         (zone: TransitionZone, idx: number) => {
                                             const isCompressed =
@@ -941,46 +984,38 @@ export default function AutoPaintTab({
                                             return (
                                                 <div
                                                     key={`zone-${idx}`}
-                                                    className={`flex items-center gap-2 p-2 rounded-md border ${
+                                                    className={`flex items-center gap-2 px-2 py-1 rounded-md border ${
                                                         isCompressed
                                                             ? 'bg-amber-500/5 border-amber-500/30'
                                                             : 'bg-muted/30 border-border/30'
                                                     }`}
+                                                    title={
+                                                        isCompressed
+                                                            ? `Compressed to fit Max Height — ideal thickness ${zone.idealThickness.toFixed(2)} mm`
+                                                            : undefined
+                                                    }
                                                 >
                                                     <span
-                                                        className="w-5 h-5 rounded-full border border-border flex-shrink-0 shadow-sm"
+                                                        className="w-3.5 h-3.5 rounded-full border border-border flex-shrink-0 shadow-sm"
                                                         style={{
                                                             backgroundColor: zone.filamentColor,
                                                         }}
                                                     />
-                                                    <div className="flex-1 min-w-0">
-                                                        <div className="flex items-center gap-1.5">
-                                                            <span className="text-[10px] font-mono text-foreground">
-                                                                {zone.filamentColor}
-                                                            </span>
-                                                            {isCompressed && (
-                                                                <span className="text-[9px] px-1 py-0.5 rounded bg-amber-500/20 text-amber-600 font-medium">
-                                                                    compressed
-                                                                </span>
-                                                            )}
-                                                        </div>
-                                                        <div className="text-[9px] text-muted-foreground">
-                                                            {zone.startHeight.toFixed(2)}mm →{' '}
-                                                            {zone.endHeight.toFixed(2)}mm
-                                                            <span className="ml-1 text-primary font-medium">
-                                                                (Δ
-                                                                {zone.actualThickness.toFixed(2)}
-                                                                mm)
-                                                            </span>
-                                                            {isCompressed && (
-                                                                <span className="ml-1 text-amber-600/70">
-                                                                    ideal:{' '}
-                                                                    {zone.idealThickness.toFixed(2)}
-                                                                    mm
-                                                                </span>
-                                                            )}
-                                                        </div>
-                                                    </div>
+                                                    <span className="text-[10px] font-mono text-foreground">
+                                                        {zone.filamentColor}
+                                                    </span>
+                                                    {isCompressed && (
+                                                        <span className="text-[9px] px-1 py-0.5 rounded bg-amber-500/20 text-amber-600 font-medium">
+                                                            compressed
+                                                        </span>
+                                                    )}
+                                                    <span className="ml-auto text-[10px] text-muted-foreground tabular-nums">
+                                                        {zone.startHeight.toFixed(2)} →{' '}
+                                                        {zone.endHeight.toFixed(2)} mm
+                                                    </span>
+                                                    <span className="text-[10px] text-primary font-medium tabular-nums w-14 text-right">
+                                                        Δ{zone.actualThickness.toFixed(2)}
+                                                    </span>
                                                 </div>
                                             );
                                         }
@@ -1022,41 +1057,18 @@ export default function AutoPaintTab({
                                 </span>
                             </div>
                             <div className="grid grid-cols-3 gap-2 text-[10px]">
-                                <div className="text-center p-2 rounded bg-background">
-                                    <div className="text-muted-foreground mb-1">Calibration</div>
-                                    <div
-                                        className={`font-semibold ${getConfidenceColor(autoPaintResult.confidenceFactors.calibrationQuality)}`}
-                                    >
-                                        {(
-                                            autoPaintResult.confidenceFactors.calibrationQuality *
-                                            100
-                                        ).toFixed(0)}
-                                        %
-                                    </div>
-                                </div>
-                                <div className="text-center p-2 rounded bg-background">
-                                    <div className="text-muted-foreground mb-1">Coverage</div>
-                                    <div
-                                        className={`font-semibold ${getConfidenceColor(autoPaintResult.confidenceFactors.filamentCoverage)}`}
-                                    >
-                                        {(
-                                            autoPaintResult.confidenceFactors.filamentCoverage * 100
-                                        ).toFixed(0)}
-                                        %
-                                    </div>
-                                </div>
-                                <div className="text-center p-2 rounded bg-background">
-                                    <div className="text-muted-foreground mb-1">Compression</div>
-                                    <div
-                                        className={`font-semibold ${getConfidenceColor(autoPaintResult.confidenceFactors.compressionImpact)}`}
-                                    >
-                                        {(
-                                            autoPaintResult.confidenceFactors.compressionImpact *
-                                            100
-                                        ).toFixed(0)}
-                                        %
-                                    </div>
-                                </div>
+                                <ConfidenceStat
+                                    label="Calibration"
+                                    value={autoPaintResult.confidenceFactors.calibrationQuality}
+                                />
+                                <ConfidenceStat
+                                    label="Coverage"
+                                    value={autoPaintResult.confidenceFactors.filamentCoverage}
+                                />
+                                <ConfidenceStat
+                                    label="Compression"
+                                    value={autoPaintResult.confidenceFactors.compressionImpact}
+                                />
                             </div>
                             {autoPaintResult.confidence < 0.7 && (
                                 <p className="text-[10px] text-amber-600 dark:text-amber-400">
@@ -1072,6 +1084,20 @@ export default function AutoPaintTab({
                                         <span className="text-xs font-semibold text-foreground">
                                             Optimizer Performance
                                         </span>
+                                        <span className="ml-auto flex items-center gap-3 text-[10px] text-muted-foreground">
+                                            {autoPaintResult.optimizerMetadata.cacheHit && (
+                                                <span className="inline-flex items-center gap-1">
+                                                    <span className="inline-block w-2 h-2 rounded-full bg-green-500" />
+                                                    Cache hit
+                                                </span>
+                                            )}
+                                            {autoPaintResult.optimizerMetadata.converged && (
+                                                <span className="inline-flex items-center gap-1">
+                                                    <span className="inline-block w-2 h-2 rounded-full bg-blue-500" />
+                                                    Converged
+                                                </span>
+                                            )}
+                                        </span>
                                     </div>
                                     <div className="grid grid-cols-3 gap-2 text-[10px]">
                                         <div className="text-center p-2 rounded bg-background">
@@ -1102,20 +1128,6 @@ export default function AutoPaintTab({
                                             </div>
                                         </div>
                                     </div>
-                                    <div className="flex items-center gap-3 text-[10px] text-muted-foreground">
-                                        {autoPaintResult.optimizerMetadata.cacheHit && (
-                                            <span className="inline-flex items-center gap-1">
-                                                <span className="inline-block w-2 h-2 rounded-full bg-green-500" />
-                                                Cache hit
-                                            </span>
-                                        )}
-                                        {autoPaintResult.optimizerMetadata.converged && (
-                                            <span className="inline-flex items-center gap-1">
-                                                <span className="inline-block w-2 h-2 rounded-full bg-blue-500" />
-                                                Converged
-                                            </span>
-                                        )}
-                                    </div>
                                 </div>
                             )}
                         </div>

From 0290459ad82500f4aeed2fb69579b15a74d6c6c5 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 10:16:15 +0300
Subject: [PATCH 47/81] Drop decorative icons from the auto-paint results
 section

Remove the sparkles/badge icons from the Transition Zones, Result
Confidence, and Optimizer Performance headers, the lightbulb emoji from the
calibration tip, and the sparkles from the Suggest next filament button
(the loading spinner stays). Cache-hit/Converged colored dots become quiet
bordered text chips, and the overall Result Confidence gains a progress bar
matching the per-factor tiles.
---
 src/components/AutoPaintTab.tsx | 35 +++++++++++++++------------------
 1 file changed, 16 insertions(+), 19 deletions(-)

diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 14cd498..a0dcf98 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -5,13 +5,11 @@ import { Button } from '@/components/ui/button';
 import {
     Plus,
     Trash2,
-    Sparkles,
     Save,
     Download,
     Upload,
     FilePlus,
     Pencil,
-    BadgeCheck,
     Loader2,
     FlaskConical,
 } from 'lucide-react';
@@ -931,7 +929,6 @@ export default function AutoPaintTab({
                             <div className="h-px bg-border/50 my-4" />
                             <div className="space-y-2">
                                 <div className="flex items-center gap-2">
-                                    <Sparkles className="w-4 h-4 text-amber-500" />
                                     <span className="text-xs font-semibold text-foreground">
                                         Transition Zones
                                     </span>
@@ -1043,12 +1040,7 @@ export default function AutoPaintTab({
                     {autoPaintResult && (
                         <div className="mt-4 p-3 rounded-md border border-border/50 bg-muted/30 space-y-2">
                             <div className="flex items-center justify-between">
-                                <div className="flex items-center gap-2">
-                                    <BadgeCheck
-                                        className={`w-4 h-4 ${getConfidenceColor(autoPaintResult.confidence)}`}
-                                    />
-                                    <span className="text-xs font-semibold">Result Confidence</span>
-                                </div>
+                                <span className="text-xs font-semibold">Result Confidence</span>
                                 <span
                                     className={`text-sm font-bold ${getConfidenceColor(autoPaintResult.confidence)}`}
                                 >
@@ -1056,6 +1048,16 @@ export default function AutoPaintTab({
                                     {(autoPaintResult.confidence * 100).toFixed(0)}%)
                                 </span>
                             </div>
+                            <div className={getConfidenceColor(autoPaintResult.confidence)}>
+                                <div className="h-1 rounded-full bg-muted overflow-hidden">
+                                    <div
+                                        className="h-full rounded-full bg-current"
+                                        style={{
+                                            width: `${Math.max(4, Math.min(100, Math.round(autoPaintResult.confidence * 100)))}%`,
+                                        }}
+                                    />
+                                </div>
+                            </div>
                             <div className="grid grid-cols-3 gap-2 text-[10px]">
                                 <ConfidenceStat
                                     label="Calibration"
@@ -1072,7 +1074,7 @@ export default function AutoPaintTab({
                             </div>
                             {autoPaintResult.confidence < 0.7 && (
                                 <p className="text-[10px] text-amber-600 dark:text-amber-400">
-                                    💡 Tip: Calibrate your filaments for better accuracy
+                                    Tip: calibrate your filaments for better accuracy.
                                 </p>
                             )}
                             {/* Optimizer Metadata */}
@@ -1080,20 +1082,17 @@ export default function AutoPaintTab({
                                 <div className="space-y-1.5 pt-2">
                                     <div className="h-px bg-border/50" />
                                     <div className="flex items-center gap-1.5">
-                                        <Sparkles className="w-3.5 h-3.5 text-blue-500" />
                                         <span className="text-xs font-semibold text-foreground">
                                             Optimizer Performance
                                         </span>
-                                        <span className="ml-auto flex items-center gap-3 text-[10px] text-muted-foreground">
+                                        <span className="ml-auto flex items-center gap-1.5 text-[9px] text-muted-foreground">
                                             {autoPaintResult.optimizerMetadata.cacheHit && (
-                                                <span className="inline-flex items-center gap-1">
-                                                    <span className="inline-block w-2 h-2 rounded-full bg-green-500" />
+                                                <span className="px-1.5 py-0.5 rounded border border-border/60 bg-background/50">
                                                     Cache hit
                                                 </span>
                                             )}
                                             {autoPaintResult.optimizerMetadata.converged && (
-                                                <span className="inline-flex items-center gap-1">
-                                                    <span className="inline-block w-2 h-2 rounded-full bg-blue-500" />
+                                                <span className="px-1.5 py-0.5 rounded border border-border/60 bg-background/50">
                                                     Converged
                                                 </span>
                                             )}
@@ -1143,10 +1142,8 @@ export default function AutoPaintTab({
                                 disabled={isNextBestComputing}
                                 onClick={() => requestNextBestSuggestion(filaments, imageSwatches)}
                             >
-                                {isNextBestComputing ? (
+                                {isNextBestComputing && (
                                     <Loader2 className="w-3 h-3 mr-1.5 animate-spin" />
-                                ) : (
-                                    <Sparkles className="w-3 h-3 mr-1.5" />
                                 )}
                                 {isNextBestComputing
                                     ? 'Finding suggestion...'

From 8c0d04eeabd7e96427413170d04bf0eba3b0a081 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 15:13:52 +0300
Subject: [PATCH 48/81] Share the session JND fit between calibration preview
 and save

The measure step previewed hiding distances with the default JND while
Save refit a session-wide JND, so Accurate mode could save different
values than it displayed (and the "session JND" badge was unreachable).
The session fit now runs once in a debounced background pass after the
entered reads settle, with a "Fitting session JND" indicator; the live
per-filament previews consume the cached fit and Save reuses it (falling
back to a fresh session fit only when nothing is cached), so saved values
always match the preview.

Also rewrite the remaining stale README sections that still taught
backlit-scale TD entry and the removed photo calibration wizard: the
Auto-paint core concepts, quick-start steps, calibration walkthrough, and
the HueForge TD section now describe hiding distances with conventional
TD as a converted input (~10x the HD).
---
 .agents/calibration-phase2-review-issues.md  |   8 +-
 README.md                                    |  48 +++---
 src/components/FilamentCalibrationDialog.tsx | 156 +++++++++++++++----
 3 files changed, 153 insertions(+), 59 deletions(-)

diff --git a/.agents/calibration-phase2-review-issues.md b/.agents/calibration-phase2-review-issues.md
index f7bc5d7..eca7dcc 100644
--- a/.agents/calibration-phase2-review-issues.md
+++ b/.agents/calibration-phase2-review-issues.md
@@ -14,8 +14,12 @@
 > 2. ~~Band-edge JND acceptance~~ — `fitSessionJnd` rejects solutions at
 >    `JND_FIT_MIN`/`JND_FIT_MAX` and falls back to the default JND; covered by a
 >    regression test with an out-of-band synthetic session.
-> 3. Cosmetic dead "session JND" badge branch in the live measure view — accepted
->    as-is (the badge still applies to saved calibrations).
+> 3. ~~Cosmetic dead "session JND" badge branch in the live measure view~~ —
+>    later upgraded by a codex PR review (preview and save could disagree when
+>    the session fit fired) and fixed properly: the session JND is now fitted
+>    once in a debounced background pass after the reads settle, the live
+>    preview consumes it (badge reachable again), and Save reuses the cached
+>    fit so saved values always equal previewed values.
 >
 > Verified after the fixes: 228 tests, tsc, eslint green.
 
diff --git a/README.md b/README.md
index 1c3ae97..c907955 100644
--- a/README.md
+++ b/README.md
@@ -64,8 +64,8 @@ Another minimal test you can try yourself: the included Transmission Distance (T
 1. Upload or drag an image into the preview area.
 2. Switch to the **Auto-paint** tab in the 3D controls panel.
 3. Click **Add Filament** and configure your filaments:
-   - Use the **calibration wizard** (calibrate icon) to measure accurate TD values, or
-   - Enter TD values manually.
+   - Use **Calibrate Filaments** to measure accurate hiding distances from a small printed wedge, or
+   - Enter hiding distances manually (the convert button accepts conventional backlit TD values).
 4. Enable **Enhanced color matching** for optimal results; start with the **Balanced** optimizer tier.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize important areas.
 6. Use the **layer-by-layer preview slider** to verify transitions.
@@ -107,34 +107,34 @@ This is especially useful for complex multi-color prints where you need to under
 
 ## Auto-paint
 
-Auto-paint is an automated layer-generation mode that replaces the manual palette/swatch workflow. Instead of reducing an image to a fixed number of colors and manually tuning per-color slice heights, you define a set of **filaments** (each with a color and a Transmission Distance) and let the algorithm compute the optimal layer stack automatically.
+Auto-paint is an automated layer-generation mode that replaces the manual palette/swatch workflow. Instead of reducing an image to a fixed number of colors and manually tuning per-color slice heights, you define a set of **filaments** (each with a color and a hiding distance) and let the algorithm compute the optimal layer stack automatically.
 
 ### Core concepts
 
-- **Filaments**: Each filament has a hex color and a **Transmission Distance (TD)** value (in mm). TD describes how translucent the filament is — at a thickness equal to TD, only ~10% of light passes through. Dark/opaque filaments have low TD (e.g. 0.5 mm); light/translucent filaments have high TD (e.g. 6+ mm). When you add a filament without specifying a TD, Kromacut estimates one from the color's luminance and saturation.
-- **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / TD)`. It blends in linear-light sRGB before converting back for display and color matching, which better models the color you see from thin semi-transparent layers.
-- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or reaches the selected opacity endpoint. **Compact** uses 80% opacity, **Detailed** uses 90% (one TD), and **Maximum** uses 95% (the same endpoint as the foundation layer). Higher endpoints retain more printable intermediate colors but create taller stacks.
+- **Filaments**: Each filament has a hex color and a **Hiding Distance (HD)** value (in mm) — the depth of material at which the filament visually hides what's beneath it when viewed front-lit, the way finished prints are actually seen. Dark/opaque filaments hide quickly (e.g. 0.05–0.1 mm); light/translucent filaments need more depth (e.g. 0.5–0.7 mm). When you add a filament without specifying an HD, Kromacut estimates one from the color's luminance and saturation. If you have a conventional (backlit/lithophane) Transmission Distance from a spool sheet or TD test print, the convert button on the filament row turns it into a hiding distance (a conventional TD is roughly 10× the HD).
+- **Beer-Lambert optical blending**: The algorithm simulates how light transmits through stacked filament layers using the Beer-Lambert law: `transmission = 10^(-thickness / HD)`. It blends in linear-light sRGB before converting back for display and color matching, which better models the color you see from thin semi-transparent layers.
+- **Transition zones**: Each filament in the stack needs enough vertical space to visually transition from the color below it to its own pure color. The algorithm simulates adding layers one at a time until the blended color converges (DeltaE < 2.3 — the "just noticeable difference" threshold) or reaches the selected opacity endpoint. **Compact** uses 80% opacity, **Detailed** uses 90% (one HD), and **Maximum** uses 95% (the same endpoint as the foundation layer). Higher endpoints retain more printable intermediate colors but create taller stacks.
 - **Luminance-to-height mapping**: Once the transition zones are computed, each pixel's brightness is mapped to a target height in the model. Dark pixels get the minimum height (base layer only), bright pixels get the full height (all layers), and mid-tones fall proportionally in between. This produces the characteristic lithophane-style relief where image brightness = model thickness.
 
 ### How it works (step by step)
 
-1. **Define filaments** — Add your filament colors and Transmission Distances in the Auto-paint tab. Use the color picker and TD input for each filament row.
+1. **Define filaments** — Add your filament colors and hiding distances in the Auto-paint tab. Use the color picker and HD input for each filament row (or convert a conventional TD value).
 2. **Filament ordering** — By default filaments are sorted by luminance (darkest on the bottom, lightest on top). With **Enhanced color matching** enabled, the algorithm evaluates orderings to find the one that best reproduces the image's color palette.
-3. **Transition zone calculation** — For each consecutive pair of filaments, the algorithm simulates Beer-Lambert blending layer-by-layer until the color converges. The first (darkest) filament gets a foundation zone thick enough to be ~95% opaque (`TD × 1.3`).
+3. **Transition zone calculation** — For each consecutive pair of filaments, the algorithm simulates Beer-Lambert blending layer-by-layer until the color converges. The first (darkest) filament gets a foundation zone thick enough to be ~95% opaque (`HD × 1.3`).
 4. **Height compression** — If the ideal height exceeds a user-set **Max Height**, all zones are uniformly compressed. The UI shows which zones are compressed and by how much.
 5. **Virtual swatch generation** — The transition zones are sampled at each layer-height increment to produce a sequence of blended colors (virtual swatches). These drive the 3D preview and the height map, where each pixel maps to the layer whose blended color best matches.
 
 ### Filament Calibration
 
-Each filament row in the Auto-paint tab includes a **calibration wizard** to help you determine accurate Transmission Distance values:
+Kromacut measures hiding distances with a camera-free printed wedge — no light meter, no photos, no color picking:
 
-1. **Click the calibrate icon** next to any filament to open the calibration wizard.
-2. **Print test samples** — The wizard guides you through printing 3-5 samples of different thicknesses (e.g., 0.3mm, 0.6mm, 1.0mm, 1.5mm, 2.0mm).
-3. **Measure luminance** — Use a light meter or camera to measure how much light passes through each sample, or visually compare against reference colors.
-4. **Automatic TD calculation** — The wizard performs exponential regression on your measurements to compute the optimal TD value with a confidence score (High/Medium/Low/Very Low).
+1. **Click Calibrate Filaments** below the filament list and select the filaments to calibrate.
+2. **Pick bases** — Quick mode uses one base read per filament; Accurate mode repeats the read over two or three bases so Kromacut can measure per-channel (RGB) hiding distances directly.
+3. **Print the wedge** — Download an STL (any printer, one filament swap) or a multi-material 3MF (AMS-ready). Each filament prints as a row of patches from 1 layer up beside a fully opaque reference rail.
+4. **Read back one number** — For each print, report the first patch that looks identical to the reference rail. Kromacut converts the reads into measured hiding distances with a confidence score.
 5. **Save profile** — Keep calibrated filaments in a reusable profile for future projects.
 
-Calibrated filaments display a confidence badge next to their TD value. Higher confidence = more accurate optical simulation = better print results. Auto-paint uses calibrated red, green, and blue TD values for both preview blending and transition-zone thickness, so calibration can change the generated stack height and swap plan.
+Calibrated filaments display a confidence badge next to their HD value. Higher confidence = more accurate optical simulation = better print results. Auto-paint uses calibrated red, green, and blue hiding distances for both preview blending and transition-zone thickness, so calibration can change the generated stack height and swap plan.
 
 ### Advanced Optimizer
 
@@ -224,7 +224,7 @@ The result card shows:
 |---|---|
 | **Hex** | Suggested filament color. |
 | **Est. ΔE** | Estimated reduction in blend-aware average ΔE if this filament is added. A rough relative estimate — not a calibration confidence rating. |
-| **TD** | Recommended starting Transmission Distance, borrowed from the nearest existing filament by color distance. Adjust after printing a test patch. |
+| **HD** | Recommended starting hiding distance, borrowed from the nearest existing filament by color distance. Adjust after printing a test patch. |
 | **Captures** | Percentage of image pixels whose blend-aware color error would improve with this filament. |
 | **Isolation** | How far this color sits from existing filaments in perceptual color space (0–1). Higher means it fills a more distinct gap; lower means it overlaps territory already covered by blending. |
 
@@ -236,8 +236,8 @@ Click **Add to filaments** to insert the suggestion directly into the filament l
 
 1. Load an image into Kromacut.
 2. Switch to the **Auto-paint** tab (inside the 3D controls panel).
-3. Click **Add Filament** and configure each filament's color and TD to match your real filament stock.
-   - **Tip:** Use the calibration wizard (calibrate icon on each row) to measure accurate TD values.
+3. Click **Add Filament** and configure each filament's color and hiding distance to match your real filament stock.
+   - **Tip:** Use **Calibrate Filaments** to measure accurate hiding distances from a printed wedge.
 4. (Optional) Enable **Enhanced color matching** for better results with complex images. Start with the **Balanced** optimizer tier, then use Thorough, Deep, or Exact base order when you want to spend more search effort.
 5. (Optional) Set **Region weighting** to Center or Edge to prioritize accuracy in visually important areas.
 6. The 3D preview updates automatically. Adjust **Max Height** if the model is too tall.
@@ -252,17 +252,19 @@ Kromacut now supports exporting directly to `.3mf` format. This file format pres
 
 <img src="content/3mf_export.png" alt="3MF Export" width="600" />
 
-## Transmission Distance (TD) — what it is and how to use it here
+## Hiding Distance (HD) and Transmission Distance (TD)
 
-Transmission Distance (TD) is the concept HueForge uses to produce perceptual intermediate shades by stacking translucent filament layers: instead of relying purely on opaque color pigments, TD models how light transmits through thin layers of filament and how stacking different colors (and varying thickness) produces new perceived colors. For a full conceptual description see the HueForge blog: https://shop.thehueforge.com/blogs/news/what-is-hueforge
+Stacking thin translucent filament layers produces perceptual intermediate shades — the idea HueForge popularized with Transmission Distance: https://shop.thehueforge.com/blogs/news/what-is-hueforge
+
+Kromacut models the same physics but stores a **Hiding Distance (HD)**: the depth at which a filament visually hides what's beneath it under front lighting, which is how finished prints are viewed. A conventional TD (measured with a backlit lithophane-style test print) is roughly **10× the hiding distance**; the convert button on each filament row accepts a conventional TD and converts it for you.
 
 ### Two workflow modes in Kromacut:
 
-**1. Auto-paint mode (Automatic TD processing)** — The recommended approach for TD-based prints:
+**1. Auto-paint mode (Automatic optical blending)** — The recommended approach for layered-color prints:
 
 - **Automatic Beer-Lambert blending** — Kromacut simulates light transmission through stacked filament layers using physically accurate optical models.
-- **Filament-based workflow** — Define your actual filaments (color + TD values) and let the algorithm compute optimal layer stacks automatically.
-- **Calibration wizard** — Measure accurate TD values from physical test prints for each filament.
+- **Filament-based workflow** — Define your actual filaments (color + hiding distances) and let the algorithm compute optimal layer stacks automatically.
+- **Camera-free calibration** — Print a small wedge and read back the layer count where it turns opaque; Kromacut fits measured per-channel hiding distances from the reads.
 - **Advanced optimizer** — Deterministic effort tiers search for the best filament ordering for complex images, from quick beam previews to exact base-order enumeration.
 - **Transition zones** — Automatically calculated vertical zones where each filament blends from the color below to its own pure color.
 
@@ -275,7 +277,7 @@ See the [Auto-paint section](#auto-paint) above for full details.
 - Small adjustments to `base slice height`, per-color slice heights, and `layerHeight` change the produced layer numbers and perceived blends.
 - Iterate with actual filament on small test prints — translucency and perceived mix depend heavily on filament brand, color, and print settings.
 
-**Recommendation:** Use Auto-paint mode for TD-based prints. It handles the complex Beer-Lambert physics and optimization automatically, producing better results than manual approximation.
+**Recommendation:** Use Auto-paint mode for layered-color prints. It handles the complex Beer-Lambert physics and optimization automatically, producing better results than manual approximation.
 
 ### TD test image (for manual mode experimentation)
 
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index df4a492..57543c0 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -430,9 +430,10 @@ export function FilamentCalibrationDialog({
         setMergeReads((prev) => ({ ...prev, [key]: value }));
     }, []);
 
-    // Per-filament calibration computed live from the entered reads.
-    const computed = useMemo(() => {
-        const entries = selectedFilaments.map((filament) => {
+    // Complete read inputs per filament (merge reads excluded — they never
+    // affect the fit, only the saved record).
+    const readInputs = useMemo(() => {
+        return selectedFilaments.map((filament) => {
             const targets = calibrationTargets.filter(
                 (target) => target.filament.id === filament.id
             );
@@ -460,15 +461,8 @@ export function FilamentCalibrationDialog({
                       maxLayers,
                   }
                 : null;
-            return {
-                filament,
-                targets,
-                input,
-                result: input ? computeFrontlitCalibration(input) : null,
-                jndSource: null as 'default' | 'session-fit' | null,
-            };
+            return { filament, targets, input };
         });
-        return entries;
     }, [
         selectedFilaments,
         calibrationTargets,
@@ -478,6 +472,83 @@ export function FilamentCalibrationDialog({
         maxLayers,
     ]);
 
+    // Session JND fit, computed once in the background when the entered reads
+    // settle. Preview and Save both consume this cached result so the values
+    // shown are exactly the values saved.
+    const sessionKey = useMemo(
+        () => JSON.stringify(readInputs.map((entry) => entry.input)),
+        [readInputs]
+    );
+    const [sessionJndFit, setSessionJndFit] = useState<{
+        key: string;
+        jnd: number;
+        jndSource: 'default' | 'session-fit';
+    } | null>(null);
+    const [isFittingJnd, setIsFittingJnd] = useState(false);
+    const latestSessionKeyRef = useRef(sessionKey);
+    latestSessionKeyRef.current = sessionKey;
+
+    useEffect(() => {
+        const ready = readInputs
+            .map((entry) => entry.input)
+            .filter((input): input is NonNullable<typeof input> => input !== null);
+        // The JND search needs at least two multi-base filaments; anything less
+        // always resolves to the default JND, so skip the expensive fit.
+        const multiBase = ready.filter((input) => (input.reads?.length ?? 0) >= 2);
+        if (readInputs.some((entry) => entry.input === null) || multiBase.length < 2) {
+            setSessionJndFit(null);
+            return;
+        }
+        if (sessionJndFit?.key === sessionKey) return;
+
+        const key = sessionKey;
+        const timer = window.setTimeout(() => {
+            if (latestSessionKeyRef.current !== key) return;
+            setIsFittingJnd(true);
+            // Defer past a paint so the "fitting" state renders before the
+            // multi-second search blocks the main thread.
+            window.requestAnimationFrame(() => {
+                window.setTimeout(() => {
+                    try {
+                        if (latestSessionKeyRef.current !== key) return;
+                        const session = computeFrontlitCalibrationSession({
+                            filaments: ready,
+                            maxLayers,
+                        });
+                        setSessionJndFit({
+                            key,
+                            jnd: session.jnd,
+                            jndSource: session.jndSource,
+                        });
+                    } finally {
+                        setIsFittingJnd(false);
+                    }
+                });
+            });
+        }, 800);
+        return () => window.clearTimeout(timer);
+    }, [readInputs, sessionKey, sessionJndFit, maxLayers]);
+
+    const activeJndFit = sessionJndFit?.key === sessionKey ? sessionJndFit : null;
+
+    // Per-filament calibration computed live from the entered reads, using the
+    // fitted session JND once it is available.
+    const computed = useMemo(() => {
+        return readInputs.map(({ filament, targets, input }) => ({
+            filament,
+            targets,
+            input,
+            result: input
+                ? computeFrontlitCalibration({
+                      ...input,
+                      jnd: activeJndFit?.jnd,
+                      jndSource: activeJndFit?.jndSource,
+                  })
+                : null,
+            jndSource: activeJndFit?.jndSource ?? null,
+        }));
+    }, [readInputs, activeJndFit]);
+
     const allReadsValid =
         computed.length > 0 && computed.every((c) => c.result !== null && c.result.ok);
 
@@ -488,30 +559,42 @@ export function FilamentCalibrationDialog({
         window.requestAnimationFrame(() => {
             window.setTimeout(() => {
                 try {
-                    const session = computeFrontlitCalibrationSession({
-                        filaments: saveEntries.map((entry) => {
-                            const readsWithMerge: FrontlitCalibrationRead[] = entry.targets.map(
-                                (target) => {
-                                    const opacityLayers = parseLayerInput(reads[target.key])!;
-                                    const mergeLayers = parseLayerInput(mergeReads[target.key]);
-                                    return {
-                                        baseColor: target.base.color,
-                                        opacityLayers,
-                                        mergeLayers: mergeLayers ?? undefined,
-                                    };
-                                }
-                            );
-                            return {
-                                ...entry.input!,
-                                reads: readsWithMerge,
-                                opacityLayers: readsWithMerge[0]?.opacityLayers,
-                                baseColor: readsWithMerge[0]?.baseColor,
-                            };
-                        }),
-                        maxLayers,
+                    const saveInputs = saveEntries.map((entry) => {
+                        const readsWithMerge: FrontlitCalibrationRead[] = entry.targets.map(
+                            (target) => {
+                                const opacityLayers = parseLayerInput(reads[target.key])!;
+                                const mergeLayers = parseLayerInput(mergeReads[target.key]);
+                                return {
+                                    baseColor: target.base.color,
+                                    opacityLayers,
+                                    mergeLayers: mergeLayers ?? undefined,
+                                };
+                            }
+                        );
+                        return {
+                            ...entry.input!,
+                            reads: readsWithMerge,
+                            opacityLayers: readsWithMerge[0]?.opacityLayers,
+                            baseColor: readsWithMerge[0]?.baseColor,
+                        };
                     });
+                    // Reuse the previewed session fit so saved values match the
+                    // preview exactly; fall back to a fresh session when no fit
+                    // is cached (e.g. quick mode).
+                    const results = activeJndFit
+                        ? saveInputs.map((input) =>
+                              computeFrontlitCalibration({
+                                  ...input,
+                                  jnd: activeJndFit.jnd,
+                                  jndSource: activeJndFit.jndSource,
+                              })
+                          )
+                        : computeFrontlitCalibrationSession({
+                              filaments: saveInputs,
+                              maxLayers,
+                          }).results;
                     const updates: CalibrationApplyUpdate[] = [];
-                    session.results.forEach((result, index) => {
+                    results.forEach((result, index) => {
                         if (!result.ok) return;
                         const entry = saveEntries[index];
                         updates.push({
@@ -527,7 +610,7 @@ export function FilamentCalibrationDialog({
                 }
             });
         });
-    }, [computed, reads, mergeReads, maxLayers, onApply, handleClose, isSaving]);
+    }, [computed, activeJndFit, reads, mergeReads, maxLayers, onApply, handleClose, isSaving]);
 
     const renderSelect = () => (
         <>
@@ -878,6 +961,11 @@ export function FilamentCalibrationDialog({
             <div className="space-y-3">
                 <p className="text-sm text-muted-foreground">
                     Enter the first patch number that matched the rail for each filament/base print.
+                    {isFittingJnd && (
+                        <span className="ml-1.5 text-[11px] text-primary">
+                            Fitting session JND…
+                        </span>
+                    )}
                 </p>
                 <div className="grid gap-1 rounded-md border border-border/50 bg-muted/20 px-3 py-2 text-[11px] text-muted-foreground sm:grid-cols-2">
                     <div>

From e9e89fbf6c4a240807d1297fea05de6f44be813d Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 16:09:10 +0300
Subject: [PATCH 49/81] Document that re-calibrating a filament replaces its
 stored value

---
 src/docs/3d-mode.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index fe89d22..e6cb25d 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -55,6 +55,8 @@ Calibration is camera-free: you print a small wedge and read back one or more op
 
 Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured hiding distance is a material property, so it transfers to your real prints regardless of which base you calibrated against.
 
+Each filament stores a single calibration. Calibrating a filament again **replaces** its previous value rather than averaging into it, and only the reads you enter in the current run are saved — so to combine several bases into one measurement, select them together in a single **Accurate** run instead of calibrating the same filament twice. Calibrating a different filament only updates that filament and leaves your other calibrations untouched.
+
 ## Filament Profiles
 
 Auto-paint profiles store reusable filament sets.

From e7109082e88b6dad13c5d5670072e0fd19e18c5a Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 16:15:56 +0300
Subject: [PATCH 50/81] Block calibration save while the session JND fit is
 pending

A user could enter the last read and click Save before the debounced
session fit landed, saving values fitted with a JND the preview never
showed. Save is now disabled (labelled Fitting...) from the moment an
eligible session fit is pending until it lands, and the save fallback
computes with the default JND exactly like the preview - so saved values
equal previewed values in every path, not just when the cache is warm.

Also codify the calibration STL contract: the file deliberately contains
multiple independently watertight shells that slicers union into one
printable part (a true CSG fusion of the rounded prisms is not worth the
complexity; the output is print-validated). Module docs, dialog copy, and
the test name now say so instead of claiming a single fused solid.
---
 src/components/FilamentCalibrationDialog.tsx | 75 ++++++++++++--------
 src/lib/generateCalibrationPrint.ts          |  7 +-
 tests/calibrationPrint.test.ts               |  4 +-
 3 files changed, 56 insertions(+), 30 deletions(-)

diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 57543c0..f506371 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -488,18 +488,26 @@ export function FilamentCalibrationDialog({
     const latestSessionKeyRef = useRef(sessionKey);
     latestSessionKeyRef.current = sessionKey;
 
+    // The JND search needs at least two multi-base filaments with complete
+    // reads; anything less always resolves to the default JND.
+    const sessionFitEligible = useMemo(() => {
+        if (readInputs.length === 0) return false;
+        if (readInputs.some((entry) => entry.input === null)) return false;
+        const multiBase = readInputs.filter(
+            (entry) => (entry.input?.reads?.length ?? 0) >= 2
+        );
+        return multiBase.length >= 2;
+    }, [readInputs]);
+
     useEffect(() => {
-        const ready = readInputs
-            .map((entry) => entry.input)
-            .filter((input): input is NonNullable<typeof input> => input !== null);
-        // The JND search needs at least two multi-base filaments; anything less
-        // always resolves to the default JND, so skip the expensive fit.
-        const multiBase = ready.filter((input) => (input.reads?.length ?? 0) >= 2);
-        if (readInputs.some((entry) => entry.input === null) || multiBase.length < 2) {
+        if (!sessionFitEligible) {
             setSessionJndFit(null);
             return;
         }
         if (sessionJndFit?.key === sessionKey) return;
+        const ready = readInputs
+            .map((entry) => entry.input)
+            .filter((input): input is NonNullable<typeof input> => input !== null);
 
         const key = sessionKey;
         const timer = window.setTimeout(() => {
@@ -527,9 +535,12 @@ export function FilamentCalibrationDialog({
             });
         }, 800);
         return () => window.clearTimeout(timer);
-    }, [readInputs, sessionKey, sessionJndFit, maxLayers]);
+    }, [readInputs, sessionFitEligible, sessionKey, sessionJndFit, maxLayers]);
 
     const activeJndFit = sessionJndFit?.key === sessionKey ? sessionJndFit : null;
+    // True while an eligible session fit hasn't landed yet (debounce + search).
+    // Save is blocked during this window so saved values always match preview.
+    const sessionFitPending = sessionFitEligible && activeJndFit === null;
 
     // Per-filament calibration computed live from the entered reads, using the
     // fitted session JND once it is available.
@@ -553,7 +564,7 @@ export function FilamentCalibrationDialog({
         computed.length > 0 && computed.every((c) => c.result !== null && c.result.ok);
 
     const handleSave = useCallback(() => {
-        if (isSaving) return;
+        if (isSaving || sessionFitPending) return;
         setIsSaving(true);
         const saveEntries = computed.filter((entry) => entry.input && entry.result?.ok);
         window.requestAnimationFrame(() => {
@@ -578,21 +589,17 @@ export function FilamentCalibrationDialog({
                             baseColor: readsWithMerge[0]?.baseColor,
                         };
                     });
-                    // Reuse the previewed session fit so saved values match the
-                    // preview exactly; fall back to a fresh session when no fit
-                    // is cached (e.g. quick mode).
-                    const results = activeJndFit
-                        ? saveInputs.map((input) =>
-                              computeFrontlitCalibration({
-                                  ...input,
-                                  jnd: activeJndFit.jnd,
-                                  jndSource: activeJndFit.jndSource,
-                              })
-                          )
-                        : computeFrontlitCalibrationSession({
-                              filaments: saveInputs,
-                              maxLayers,
-                          }).results;
+                    // Compute exactly what the preview showed: the cached session
+                    // JND when one exists, otherwise the default JND (the only
+                    // no-cache case left is a non-eligible session, e.g. quick
+                    // mode — Save is disabled while an eligible fit is pending).
+                    const results = saveInputs.map((input) =>
+                        computeFrontlitCalibration({
+                            ...input,
+                            jnd: activeJndFit?.jnd,
+                            jndSource: activeJndFit?.jndSource,
+                        })
+                    );
                     const updates: CalibrationApplyUpdate[] = [];
                     results.forEach((result, index) => {
                         if (!result.ok) return;
@@ -610,7 +617,16 @@ export function FilamentCalibrationDialog({
                 }
             });
         });
-    }, [computed, activeJndFit, reads, mergeReads, maxLayers, onApply, handleClose, isSaving]);
+    }, [
+        computed,
+        activeJndFit,
+        sessionFitPending,
+        reads,
+        mergeReads,
+        onApply,
+        handleClose,
+        isSaving,
+    ]);
 
     const renderSelect = () => (
         <>
@@ -884,7 +900,7 @@ export function FilamentCalibrationDialog({
                         </div>
                         <p className="text-[11px] text-muted-foreground">
                             {format === 'stl'
-                                ? 'Single solid. Print one copy for each filament/base read using the matching swap line below.'
+                                ? 'One printable tile. Print one copy for each filament/base read using the matching swap line below.'
                                 : 'Colors + bases baked in for AMS / multi-material - all selected reads in one print.'}
                         </p>
                     </div>
@@ -1149,9 +1165,12 @@ export function FilamentCalibrationDialog({
                     <ArrowLeft className="mr-1 h-4 w-4" />
                     Back
                 </Button>
-                <Button onClick={handleSave} disabled={!allReadsValid || isSaving}>
+                <Button
+                    onClick={handleSave}
+                    disabled={!allReadsValid || isSaving || sessionFitPending}
+                >
                     <Check className="mr-1 h-4 w-4" />
-                    {isSaving ? 'Fitting...' : 'Save Calibration'}
+                    {isSaving || sessionFitPending ? 'Fitting...' : 'Save Calibration'}
                 </Button>
             </AlertDialogFooter>
         </>
diff --git a/src/lib/generateCalibrationPrint.ts b/src/lib/generateCalibrationPrint.ts
index f859832..b5df49f 100644
--- a/src/lib/generateCalibrationPrint.ts
+++ b/src/lib/generateCalibrationPrint.ts
@@ -9,7 +9,12 @@
  * to the darkest filament; dark filaments use a lighter base for contrast).
  *
  * Two output formats:
- *  - STL: one tile, single solid. The base/wedge split is by height, so a single
+ *  - STL: one tile per file, emitted as multiple independently watertight
+ *    shells (base slab, orientation foot, each patch, the rail) that touch or
+ *    overlap. Slicers union coincident/overlapping closed shells on import, so
+ *    the tile prints as one part; this multi-shell contract is deliberate (a
+ *    true CSG fusion of the rounded prisms is not worth the complexity and the
+ *    output is print-validated). The base/wedge split is by height, so a single
  *    filament change (base -> color, above the base) prints it on any machine.
  *  - 3MF: one or more tiles, each as a base object + a color object, with parts
  *    assigned to real profile-filament slots (no invented base), for AMS printers.
diff --git a/tests/calibrationPrint.test.ts b/tests/calibrationPrint.test.ts
index 23ca587..8a81807 100644
--- a/tests/calibrationPrint.test.ts
+++ b/tests/calibrationPrint.test.ts
@@ -38,7 +38,9 @@ const baseOptions = {
     gap: 1.5,
 };
 
-test('generateCalibrationStl writes one box per base/wedge/reference patch', async () => {
+// Contract: the STL is a set of independently watertight shells (one per box)
+// that touch/overlap; slicers union them into one printable part on import.
+test('generateCalibrationStl writes one closed shell per base/wedge/reference patch', async () => {
     const { generateCalibrationStl } = await loadGenerator();
     const blob = generateCalibrationStl(baseOptions);
     const buffer = await blob.arrayBuffer();

From fad7c60cc4b59ef60dafe4f8106f584d9e885c4b Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 4 Jul 2026 22:52:04 +0300
Subject: [PATCH 51/81] Deactivate a filament's calibration when its color is
 edited

Calibrated per-channel hiding distances are specific to the material and
color they were measured for, but channelHds and the calibration badge only
checked the scalar HD - so editing a filament's swatch kept the stale
calibration active and auto-paint silently optimized with measurements from
the previous color.

FrontlitCalibration now records the calibrated swatch color, and a new
activeFrontlitCalibration() treats a calibration as active only while the
filament still has that color. channelHds, the FilamentRow badge, and the
auto-paint calibration-quality metric all go through it, so a color edit
falls back to color-estimated HDs and the badge shows "Estimate". The
change is non-destructive: reverting the color reactivates the stored
calibration. Legacy records without a stored color are backfilled with the
current color on load (protection going forward) and otherwise treated as
matching. Adds unit coverage for deactivate/reactivate, the load backfill,
and the color stamp; live-verified through the dialog.
---
 CHANGELOG.md                   |  2 +-
 src/components/FilamentRow.tsx | 12 +++----
 src/lib/autoPaint.ts           |  5 ++-
 src/lib/calibration.ts         | 41 ++++++++++++++++++++-
 src/lib/profileManager.ts      | 11 +++++-
 tests/hidingDistance.test.ts   | 66 ++++++++++++++++++++++++++++++++++
 tests/profileManager.test.ts   | 34 ++++++++++++++++++
 7 files changed, 161 insertions(+), 10 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b34f856..4b59933 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (single-solid STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index f685683..83adabc 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -7,11 +7,11 @@ import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover
 import type { Filament } from '../types';
 import { estimateHidingDistanceFromColor } from '../lib/colorUtils';
 import {
+    activeFrontlitCalibration,
     channelHds,
     computeProfileConfidence,
     getConfidenceLabel,
     getConfidenceColor,
-    sanitizeFrontlitCalibration,
     FRONTLIT_TD_SCALE,
 } from '../lib/calibration';
 
@@ -38,11 +38,11 @@ const FilamentRow = React.memo(function FilamentRow({
         filament.name ?? `Filament ${filament.color}`
     );
 
-    // Calculate confidence for this filament
-    const sanitizedCalibration = sanitizeFrontlitCalibration(filament.calibration);
-    const calibrationMatchesTd =
-        !!sanitizedCalibration && Math.abs(filament.td - sanitizedCalibration.tdSingleValue) < 0.05;
-    const activeCalibration = calibrationMatchesTd ? sanitizedCalibration : undefined;
+    // Calculate confidence for this filament. A calibration only counts while
+    // the swatch still matches the color it was measured for; editing the color
+    // deactivates it (and channelHds falls back to color-derived HDs), so the
+    // badge and the optical model stay consistent.
+    const activeCalibration = activeFrontlitCalibration(filament);
 
     const confidence = computeProfileConfidence({
         calibration: activeCalibration,
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index dbc5cc9..79fa2a8 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -16,6 +16,7 @@ import {
     type ScoringContext,
 } from './optimizer';
 import {
+    activeFrontlitCalibration,
     channelHds,
     computeProfileConfidence,
     type CalibrationRgb,
@@ -1698,7 +1699,9 @@ function calculateAutoConfidence(
     if (filaments.length > 0) {
         const confidences = filaments.map((f) =>
             computeProfileConfidence({
-                calibration: f.calibration,
+                // Only count a calibration whose swatch still matches its color;
+                // a color-edited filament falls back to the uncalibrated baseline.
+                calibration: activeFrontlitCalibration(f),
                 transmissionDistance: f.td,
             })
         );
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index 62b0153..a5d3bea 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -57,6 +57,14 @@ export interface FrontlitCalibration {
     channelSource?: 'heuristic' | 'measured';
     /** Whether the JND was the default constant or fitted across the session. */
     jndSource?: 'default' | 'session-fit';
+    /**
+     * Swatch color (hex) the wedge was calibrated for. A calibration only
+     * applies while the filament still has this color — editing the swatch
+     * deactivates it (see activeFrontlitCalibration) instead of silently
+     * blending with measurements from a different material. Absent on records
+     * saved before the field existed; those are backfilled on load.
+     */
+    filamentColor?: string;
     notes?: string;
 }
 
@@ -243,10 +251,40 @@ export function sanitizeFrontlitCalibration(value: unknown): FrontlitCalibration
     } else if (candidate.jndSource !== undefined) {
         return undefined;
     }
+    if (candidate.filamentColor !== undefined) {
+        if (typeof candidate.filamentColor !== 'string' || !hexToRgb(candidate.filamentColor)) {
+            return undefined;
+        }
+        sanitized.filamentColor = candidate.filamentColor;
+    }
     if (typeof candidate.notes === 'string') sanitized.notes = candidate.notes;
     return sanitized;
 }
 
+/**
+ * The calibration that currently applies to a filament: a valid frontlit
+ * record whose calibrated swatch color still matches the filament's color.
+ * Editing the swatch deactivates the calibration (measurements belong to the
+ * previous material) and reverting the color reactivates it. Records without
+ * a stored color (pre-field) are treated as matching.
+ */
+export function activeFrontlitCalibration(filament: {
+    color: string;
+    calibration?: unknown;
+}): FrontlitCalibration | undefined {
+    const calibration = sanitizeFrontlitCalibration(filament.calibration);
+    if (!calibration) return undefined;
+    if (calibration.filamentColor === undefined) return calibration;
+    const calibrated = hexToRgb(calibration.filamentColor);
+    const current = hexToRgb(filament.color);
+    if (!calibrated || !current) return undefined;
+    return calibrated[0] === current[0] &&
+        calibrated[1] === current[1] &&
+        calibrated[2] === current[2]
+        ? calibration
+        : undefined;
+}
+
 // ============================================================================
 // Opacity-read calibration
 // ============================================================================
@@ -560,7 +598,7 @@ export function channelHds(filament: {
     calibration?: unknown;
 }): CalibrationRgb {
     return (
-        sanitizeFrontlitCalibration(filament.calibration)?.td ??
+        activeFrontlitCalibration(filament)?.td ??
         deriveChannelTds(filament.color, filament.td)
     );
 }
@@ -712,6 +750,7 @@ export function computeFrontlitCalibration(
                     : undefined,
             channelSource,
             jndSource: input.jndSource ?? 'default',
+            filamentColor,
             notes,
         },
     };
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 2906c13..437b5a8 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -51,7 +51,16 @@ export function sanitizeProfileFilament(value: unknown): Filament | null {
     if (typeof value.brand === 'string') filament.brand = value.brand;
 
     const calibration = sanitizeFrontlitCalibration(value.calibration);
-    if (calibration) filament.calibration = calibration;
+    if (calibration) {
+        // Backfill the calibrated color for records saved before the field
+        // existed: on load the current color IS the color it was calibrated for
+        // (no edit has happened yet), so this activates color-mismatch
+        // protection for legacy calibrations without discarding them.
+        filament.calibration =
+            calibration.filamentColor === undefined
+                ? { ...calibration, filamentColor: filament.color }
+                : calibration;
+    }
     return filament;
 }
 
diff --git a/tests/hidingDistance.test.ts b/tests/hidingDistance.test.ts
index b23eca8..d24d386 100644
--- a/tests/hidingDistance.test.ts
+++ b/tests/hidingDistance.test.ts
@@ -93,6 +93,72 @@ test('channelHds ignores invalid calibration shapes and falls back to derivation
     assert.deepEqual(channelHds(filament), deriveChannelTds('#ff0000', 0.4));
 });
 
+test('editing the swatch color deactivates a calibration', async () => {
+    const { channelHds, activeFrontlitCalibration, deriveChannelTds } = await loadCalibration();
+    const calibration = {
+        opacityLayers: 5,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+        td: [0.068, 0.354, 0.373] as [number, number, number],
+        tdSingleValue: 0.373,
+        jnd: 2,
+        baseColor: '#000000',
+        confidence: 0.8,
+        basis: 'frontlit' as const,
+        calibrationDate: '2026-07-02T00:00:00.000Z',
+        filamentColor: '#00b8c4',
+    };
+    // Same color → calibration active, measured channels used.
+    const matched: Filament = { id: 'f', color: '#00b8c4', td: 0.373, calibration };
+    assert.ok(activeFrontlitCalibration(matched));
+    assert.deepEqual(channelHds(matched), [0.068, 0.354, 0.373]);
+
+    // Color edited → calibration deactivated, falls back to color-derived HDs.
+    const edited: Filament = { ...matched, color: '#ff0000' };
+    assert.equal(activeFrontlitCalibration(edited), undefined);
+    assert.deepEqual(channelHds(edited), deriveChannelTds('#ff0000', 0.373));
+
+    // Reverting the color reactivates the stored calibration (non-destructive).
+    const reverted: Filament = { ...edited, color: '#00b8c4' };
+    assert.ok(activeFrontlitCalibration(reverted));
+    assert.deepEqual(channelHds(reverted), [0.068, 0.354, 0.373]);
+});
+
+test('a calibration without a stored color still applies (legacy compatibility)', async () => {
+    const { activeFrontlitCalibration } = await loadCalibration();
+    const filament = {
+        id: 'legacy',
+        color: '#00b8c4',
+        td: 0.373,
+        calibration: {
+            opacityLayers: 5,
+            layerHeight: 0.08,
+            firstLayerHeight: 0.16,
+            td: [0.068, 0.354, 0.373],
+            tdSingleValue: 0.373,
+            jnd: 2,
+            baseColor: '#000000',
+            confidence: 0.8,
+            basis: 'frontlit',
+            calibrationDate: '2026-07-02T00:00:00.000Z',
+        },
+    } as unknown as Filament;
+    assert.ok(activeFrontlitCalibration(filament));
+});
+
+test('computeFrontlitCalibration stamps the calibrated swatch color', async () => {
+    const { computeFrontlitCalibration } = await loadCalibration();
+    const result = computeFrontlitCalibration({
+        filamentColor: '#ffd400',
+        opacityLayers: 6,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+    });
+    assert.ok(result.ok);
+    if (!result.ok) return;
+    assert.equal(result.calibration.filamentColor, '#ffd400');
+});
+
 test('migrateLegacyFilamentTd scales uncalibrated tds and re-syncs calibrated ones', async () => {
     const { migrateLegacyFilamentTd } = await loadProfileManager();
     const { FRONTLIT_TD_SCALE } = await loadCalibration();
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 474f602..498f069 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -290,3 +290,37 @@ test('stored v1 profiles migrate tds once on load', async () => {
         if (!existingStorage) Reflect.deleteProperty(globalThis, 'localStorage');
     }
 });
+
+test('loading a calibrated filament backfills the calibrated swatch color', async () => {
+    const { sanitizeProfileFilament } = await loadProfileManager();
+    const frontlitCalibration = {
+        opacityLayers: 7,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+        td: [0.49, 0.51, 0.5],
+        tdSingleValue: 0.51,
+        jnd: 2,
+        baseColor: '#000000',
+        confidence: 0.9,
+        basis: 'frontlit',
+        calibrationDate: '2026-07-02T00:00:00.000Z',
+    };
+    // Legacy record (no filamentColor) → backfilled with the current color.
+    const legacy = sanitizeProfileFilament({
+        id: 'f',
+        color: '#ffffff',
+        td: 0.51,
+        calibration: frontlitCalibration,
+    });
+    assert.ok(legacy?.calibration);
+    assert.equal(legacy!.calibration!.filamentColor, '#ffffff');
+
+    // Existing filamentColor is preserved, not overwritten by the current color.
+    const stamped = sanitizeProfileFilament({
+        id: 'g',
+        color: '#111111',
+        td: 0.51,
+        calibration: { ...frontlitCalibration, filamentColor: '#ffffff' },
+    });
+    assert.equal(stamped!.calibration!.filamentColor, '#ffffff');
+});

From 2b2286a224cf918f2c07d263c47e29aeeaa7e573 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sun, 5 Jul 2026 23:14:30 -0500
Subject: [PATCH 52/81] Add TileSettings and GridSettings interfaces for
 multi-image tile configuration

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/types/tileSettings.ts | 216 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 216 insertions(+)
 create mode 100644 src/types/tileSettings.ts

diff --git a/src/types/tileSettings.ts b/src/types/tileSettings.ts
new file mode 100644
index 0000000..8177a34
--- /dev/null
+++ b/src/types/tileSettings.ts
@@ -0,0 +1,216 @@
+// Shared settings type for multi-image tiles (issue #35) and single-image mode.
+// See tmp_multi_modularization.plan.txt, Step 1: single-image mode is modeled as
+// "one tile whose override is always empty" against a global TileSettings.
+//
+// Field placement follows the "Seems good"-approved UI proposal on issue #35:
+// only panel 2 (Borders) is explicitly "per-tile overridable like everything
+// else" (plus panel 6's per-tile skip/force-include override), so those are
+// the only fields on TileSettings. Panels 1/3/4/5/7/8 (Split, Border fit,
+// Labels, Colors, Outer border, Plate check) describe the whole assembled
+// grid, not any one tile's content, so they live on the separate,
+// non-inheritable GridSettings.
+//
+// Below, definitions are grouped by UI-proposal panel (1-8 in order), each
+// panel's sub-settings in the sequence they're used, followed by the two
+// aggregate containers (TileSettings, GridSettings) and resolveSettings.
+import type { Adjustments } from '../lib/applyAdjustments';
+import type { ThreeDControlsStateShape } from './index';
+
+// Panel 1 (Split): explicit M x N, or a target tile size in mm/px (the other
+// unit is always echoed back so the mapping stays visible).
+export interface SplitSettings {
+    rows?: number;
+    columns?: number;
+    tileSizeMm?: number;
+    tileSizePx?: number;
+    unit?: 'mm' | 'px';
+}
+
+// Panel 2 (Borders): Top/Left/Right/Bottom, each independently overridable
+// per tile, distinct from the whole-assembly BorderSettings (panel 7) below.
+
+// Where a border edge's height boundary falls, for sources that need one
+// ('filament' always washes out layers below a height; 'layer-color' samples
+// whatever color is already painted at a height instead of specifying one).
+export type BorderColorHeight =
+    | { mode: 'median' }
+    | { mode: 'mm'; valueMm: number }
+    | { mode: 'percent'; valuePercent: number };
+
+// A discriminated union because each color source needs different follow-up
+// params: a flat hex needs nothing else; a filament choice needs a height to
+// paint up to plus how many layers below it to wash out; sampling the
+// existing layer color needs only the height to sample at.
+export type EdgeBorderColor =
+    | {
+        source: 'hex'; // hex always adds layers above the border, so no height param is needed.
+        color: string // flat hex color, e.g. '#ff00ff' or '#f0f'
+    }
+    | {
+        source: 'filament';
+        filamentId: string; // filament ID to use for the border color, e.g. 'PLA:Black' or ''
+        heightMm: number;
+        // how many layers below the border to wash out (0 = none, 1 = one layer, etc.).
+        // if washout layers is > 1, and height mm <  the height of the print, we'll display a warning that there will
+        // need to be two swaps per layer for n layers while the border is being printed.
+        washoutLayers: number
+    }
+    | { source: 'layer-color'; height: BorderColorHeight }; // simply use the color of the existing layer at this height, no new color is added.
+
+export interface EdgeBorderSettings {
+    thicknessMm: number; // thickness of the border in millimeters, can be 0 to disable the border on that edge.
+    color?: EdgeBorderColor; // if not specified, defaults to black.
+}
+
+export interface TileBorderSettings {
+    top?: EdgeBorderSettings;
+    left?: EdgeBorderSettings;
+    right?: EdgeBorderSettings;
+    bottom?: EdgeBorderSettings;
+}
+
+// Panel 3 (Border fit): how adjacent tile edges key together physically.
+// A discriminated union because each joint style has its own shape params
+// (e.g. a T-pattern's joint thickness has no equivalent on a flush butt joint).
+// Non-flush members are all required (no partial/inherit within a joint) —
+// `fitShrink` is a percentage in [0, 99.99] shrinking the mating surfaces for
+// print-fit clearance.
+export type BorderFit =
+    | { type: 'flush' }
+    | {
+          type: 't-pattern';
+          jointThicknessMm: number; //total mm normal of the edge for the tab to fit into. The tabs will go in n/2 mm in, and n/2 mm out, so the total thickness is n mm.
+          tabWidthMm: number; // width of a single tab that sticks out of the edge.
+          repeat: boolean; // whether the tabs repeat along the edge or not. If true, the tabWidth will be repeated along the edge, with a gap in between each tab. If false, there will be a single tab in the middle of the edge.
+          fitShrink: number; // percentage in [0, 99.99] shrinking the mating surfaces for print-fit clearance. typical value will be `nozzle_dia/image_width_mm * 100`.
+      }
+    | {
+        type: 'sawtooth';
+        toothWidthmm: number; // width of a single tooth that sticks out of the edge, tip to tip.
+        toothDepthmm: number; // depth of a single tooth that sticks out of the edge, tip to base.
+        fitShrink: number  // percentage in [0, 99.99] shrinking the mating surfaces for print-fit clearance. typical value will be `nozzle_dia/image_width_mm * 100`.
+    }
+    | {
+          type: 'jigsaw';
+          jointThicknessMm: number; // total mm normal of the edge for the tab to fit into. The tabs will go in n/2 mm in, and n/2 mm out, so the total thickness is n mm.
+          tabWidthMm: number; // width of a single tab that sticks out of the edge, tip to tip.
+          fitShrink: number; // percentage in [0, 99.99] shrinking the mating surfaces for print-fit clearance. typical value will be `nozzle_dia/image_width_mm * 100`.
+      };
+
+// Panel 4 (Labels): orientation/ordering marks, hidden once assembled.
+// Position of the mark on the tile face, as a 3x3 grid of anchors.
+export type LabelAlignment =
+    | 'top-left'
+    | 'top'
+    | 'top-right'
+    | 'left'
+    | 'center'
+    | 'right'
+    | 'bottom-left'
+    | 'bottom'
+    | 'bottom-right';
+
+// A discriminated union because 'none' carries no mark params, while every
+// other style shares the same depth/size/placement shape.
+export type LabelStyle =
+    | { type: 'none' }
+    | {
+          type: 'orientation-arrow';
+          depth: number; // how many mm the arrow is inset from the tile base.
+          totalWidth: number; // how many mm the arrow is wide (tip-to-tip).
+          alignment: LabelAlignment;
+      }
+    | {
+          type: 'sequence-index';
+          depth: number; // how many mm the number is inset from the tile base.
+          totalWidth: number; // how many mm the number is wide (tip-to-tip).
+          alignment: LabelAlignment;
+      }
+    | {
+          type: 'row-column';
+          depth: number; // how many mm the coordinates are inset from the tile base.
+          totalWidth: number; // how many mm the coordinates are wide (tip-to-tip).
+          alignment: LabelAlignment;
+      };
+
+// Panel 5 (Colors): 'global' quantizes one palette across the whole image so
+// tiles reassemble seamlessly; 'local' lets each tile get its own best-fit
+// palette (fewer filament swaps per plate, at the cost of seams).
+export type ColorMode = 'global' | 'local';
+
+export type QuantizeAlgorithm = 'posterize' | 'median-cut' | 'kmeans' | 'octree' | 'wu' | 'none';
+
+export interface QuantizeSettings {
+    algorithm?: QuantizeAlgorithm;
+    weight?: number;
+    finalColors?: number;
+    selectedPalette?: string;
+}
+
+// Panel 6 (Skip tiles): background-only tiles below this content threshold
+// are dropped from export by default (per-tile TileSettings.skip overrides this).
+export interface SkipTilesSettings {
+    enabled?: boolean;
+    contentThresholdPercent?: number;
+}
+
+// Panel 7 ("Outer border"): outer-border/frame settings, usable from
+// single-image mode too: "trace the outer edge of whatever geometry is
+// given" (one model in single-image mode, the assembled grid in multi-image
+// mode). [Issue #45] This is that same edge/frame tool. Shares
+// EdgeBorderColor with panel 2 — same hex/filament/layer-color choice.
+export interface BorderSettings {
+    enabled?: boolean;
+    color?: EdgeBorderColor;
+    thicknessMm?: number;
+    heightBehavior?: 'full' | 'fixed' | 'top-bottom';
+    fixedHeightMm?: number;
+}
+
+// Panel 8 (Plate check): target plate size every tile (borders/joints
+// included) is validated against before export. A discriminated union so
+// 'none' (no check) can't carry dimensions, and 'validate' can't omit them.
+export type PlateSizeSettings = { mode: 'none' } | { mode: 'validate'; widthMm: number; heightMm: number };
+
+export interface TileSettings {
+    /** Core (no panel): per-tile image adjustments. */
+    adjustments?: Partial<Adjustments>;
+    /** Core (no panel): per-tile 3D/print controls. */
+    threeD?: Partial<ThreeDControlsStateShape>;
+    /** Panel 2: per-edge borders against this tile's neighbors. */
+    tileBorder?: TileBorderSettings;
+    /** Panel 6: force-include/exclude this tile, overriding the grid's content threshold. */
+    skip?: boolean;
+}
+
+/** Whole-assembly settings with no per-tile inherit concept — one value per grid space. */
+export interface GridSettings {
+    /** Panel 1. */
+    split?: SplitSettings;
+    /** Panel 3. */
+    borderFit?: BorderFit;
+    /** Panel 4. */
+    labelStyle?: LabelStyle;
+    /** Panel 5. */
+    colorMode?: ColorMode;
+    /** Panel 5. */
+    quantize?: QuantizeSettings;
+    /** Panel 6 (grid-level threshold; TileSettings.skip is the per-tile override). */
+    skipTiles?: SkipTilesSettings;
+    /** Panel 7. */
+    outerBorder?: BorderSettings;
+    /** Panel 8. */
+    plateSize?: PlateSizeSettings;
+}
+
+/**
+ * Naive stub merge: override wins per top-level key, override's absence
+ * falls back to global. Real null/inherit semantics (deep per-field merge)
+ * land later; this is intentionally shallow for Step 1's stub form.
+ */
+export function resolveSettings(
+    global: TileSettings,
+    override: Partial<TileSettings>
+): TileSettings {
+    return { ...global, ...override };
+}

From 369d53034509e2e51899c175bd7ce14dcb706438 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 6 Jul 2026 19:10:04 +0300
Subject: [PATCH 53/81] Fix filament calibration confidence updates

---
 CHANGELOG.md                   |  1 +
 src/components/FilamentRow.tsx |  5 +++--
 src/lib/autoPaint.ts           | 23 +++++++-------------
 src/lib/filamentUpdates.ts     | 27 +++++++++++++++++++++++
 tests/autoPaint.test.ts        | 38 +++++++++++++++++++++++++++++++++
 tests/hidingDistance.test.ts   | 39 ++++++++++++++++++++++++++++++++++
 6 files changed, 116 insertions(+), 17 deletions(-)
 create mode 100644 src/lib/filamentUpdates.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7fdba36..46e3cd1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -24,6 +24,7 @@ All notable changes to Kromacut are documented in this file.
 
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
+- **Auto-paint calibration confidence** - Color edits that deactivate a calibration now re-anchor the filament's estimated hiding distance to the new color without deleting the stored calibration, and result confidence now scores the filament sequence actually printed after variable-length optimization omits unused filaments.
 - **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters and tuning inputs, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
diff --git a/src/components/FilamentRow.tsx b/src/components/FilamentRow.tsx
index 83adabc..0eeeaf0 100644
--- a/src/components/FilamentRow.tsx
+++ b/src/components/FilamentRow.tsx
@@ -6,6 +6,7 @@ import { HexColorPicker } from 'react-colorful';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
 import type { Filament } from '../types';
 import { estimateHidingDistanceFromColor } from '../lib/colorUtils';
+import { colorEditUpdateForFilament } from '../lib/filamentUpdates';
 import {
     activeFrontlitCalibration,
     channelHds,
@@ -87,11 +88,11 @@ const FilamentRow = React.memo(function FilamentRow({
     useEffect(() => {
         const timer = setTimeout(() => {
             if (localColor !== filament.color) {
-                onUpdate(filament.id, { color: localColor });
+                onUpdate(filament.id, colorEditUpdateForFilament(filament, localColor));
             }
         }, 200);
         return () => clearTimeout(timer);
-    }, [localColor, filament.id, filament.color, onUpdate]);
+    }, [localColor, filament, onUpdate]);
 
     const handleNameBlur = () => {
         const trimmed = localName.trim();
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 79fa2a8..93ad108 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -1549,12 +1549,7 @@ export function generateAutoLayers(
         .filter((filament): filament is Filament => filament !== undefined);
 
     // --- STEP 6: CALCULATE CONFIDENCE METRICS ---
-    const confidence = calculateAutoConfidence(
-        filaments,
-        imageSwatches,
-        printedFilaments,
-        compressionRatio
-    );
+    const confidence = calculateAutoConfidence(imageSwatches, printedFilaments, compressionRatio);
 
     const result: AutoPaintResult = {
         layers,
@@ -1673,16 +1668,14 @@ export function autoPaintToSliceHeights(
  * 2. Filament Coverage: How well the filament colors cover the image palette
  * 3. Compression Impact: How much the result was compressed from ideal
  *
- * @param filaments - Input filaments with their TDs
  * @param imageSwatches - Image color palette
- * @param sortedFilaments - Filaments in their optimal order
+ * @param printedFilaments - Filaments in the actual generated stack
  * @param compressionRatio - How much compression was applied (1.0 = none)
  * @returns Confidence score and detailed factors
  */
 function calculateAutoConfidence(
-    filaments: Filament[],
     imageSwatches: Array<{ hex: string; count?: number }>,
-    sortedFilaments: Filament[],
+    printedFilaments: Filament[],
     compressionRatio: number
 ): {
     confidence: number;
@@ -1696,8 +1689,8 @@ function calculateAutoConfidence(
     // Average confidence of all filament calibrations using actual calibration data
     let calibrationQuality = 0.5; // Default baseline for uncalibrated filaments
     
-    if (filaments.length > 0) {
-        const confidences = filaments.map((f) =>
+    if (printedFilaments.length > 0) {
+        const confidences = printedFilaments.map((f) =>
             computeProfileConfidence({
                 // Only count a calibration whose swatch still matches its color;
                 // a color-edited filament falls back to the uncalibrated baseline.
@@ -1714,8 +1707,8 @@ function calculateAutoConfidence(
     // Secondary: filament count caps the maximum achievable coverage.
     let filamentCoverage = 0.5; // Baseline
 
-    if (filaments.length > 0 && imageSwatches.length > 0) {
-        const filamentColors = sortedFilaments.map((f) => rgbToLab(hexToRgb(f.color)));
+    if (printedFilaments.length > 0 && imageSwatches.length > 0) {
+        const filamentColors = printedFilaments.map((f) => rgbToLab(hexToRgb(f.color)));
 
         // For each image color, find nearest filament color (weighted by pixel count)
         let totalDeltaE = 0;
@@ -1744,7 +1737,7 @@ function calculateAutoConfidence(
 
         // Cap by filament count — even perfect color matches are limited by
         // how many distinct layers can be stacked
-        const filamentCount = filaments.length;
+        const filamentCount = printedFilaments.length;
         let countCap = 1.0;
         if (filamentCount === 1) countCap = 0.5;
         else if (filamentCount === 2) countCap = 0.7;
diff --git a/src/lib/filamentUpdates.ts b/src/lib/filamentUpdates.ts
new file mode 100644
index 0000000..399e450
--- /dev/null
+++ b/src/lib/filamentUpdates.ts
@@ -0,0 +1,27 @@
+import type { Filament } from '../types';
+import { sanitizeFrontlitCalibration } from './calibration';
+import { estimateHidingDistanceFromColor, normalizeHexColor } from './colorUtils';
+
+/**
+ * Preserve a stored calibration while keeping the scalar HD aligned with the
+ * color currently being edited. A reverted color reuses the measured scalar;
+ * a different color falls back to the color-derived estimate.
+ */
+export function colorEditUpdateForFilament(
+    filament: Filament,
+    color: string
+): Partial<Omit<Filament, 'id'>> {
+    const update: Partial<Omit<Filament, 'id'>> = { color };
+    const calibration = sanitizeFrontlitCalibration(filament.calibration);
+    if (!calibration) return update;
+
+    const nextColor = normalizeHexColor(color, '');
+    const calibratedColor = normalizeHexColor(calibration.filamentColor ?? filament.color, '');
+    if (!nextColor || !calibratedColor) return update;
+
+    update.td =
+        nextColor === calibratedColor
+            ? calibration.tdSingleValue
+            : estimateHidingDistanceFromColor(nextColor);
+    return update;
+}
diff --git a/tests/autoPaint.test.ts b/tests/autoPaint.test.ts
index 0a52dac..4a24d9e 100644
--- a/tests/autoPaint.test.ts
+++ b/tests/autoPaint.test.ts
@@ -575,6 +575,44 @@ test('enhanced repeated-swap search keeps the printable red-to-pink transition',
     );
 });
 
+test('auto-paint confidence scores only the printed optimized sequence', async () => {
+    const { generateAutoLayers } = await loadAutoPaintModule();
+    const calibratedWhite = {
+        id: 'white',
+        color: '#ffffff',
+        td: 0.51,
+        calibration: {
+            opacityLayers: 7,
+            layerHeight: 0.08,
+            firstLayerHeight: 0.16,
+            td: [0.49, 0.51, 0.5] as [number, number, number],
+            tdSingleValue: 0.51,
+            jnd: 2,
+            baseColor: '#000000',
+            confidence: 1,
+            basis: 'frontlit' as const,
+            calibrationDate: new Date().toISOString(),
+            filamentColor: '#ffffff',
+        },
+    };
+    const unusedNearWhite = { id: 'near-white', color: '#fefefe', td: 0.5 };
+
+    const result = generateAutoLayers(
+        [calibratedWhite, unusedNearWhite],
+        [{ hex: '#ffffff', count: 100 }],
+        0.08,
+        0.16,
+        undefined,
+        true,
+        false,
+        { algorithm: 'exhaustive', seed: 9 }
+    );
+
+    assert.deepEqual(result.filamentOrder, ['white']);
+    assert.equal(result.confidenceFactors.calibrationQuality, 1);
+    assert.equal(result.confidenceFactors.filamentCoverage, 0.5);
+});
+
 test('auto-paint slice data never returns more than 500 layers', async () => {
     const { autoPaintToSliceHeights } = await loadAutoPaintModule();
     const tallResult = {
diff --git a/tests/hidingDistance.test.ts b/tests/hidingDistance.test.ts
index d24d386..b1cbc0a 100644
--- a/tests/hidingDistance.test.ts
+++ b/tests/hidingDistance.test.ts
@@ -7,10 +7,12 @@ import type { Filament } from '../src/types/index.ts';
 
 type ColorUtilsModule = typeof import('../src/lib/colorUtils.ts');
 type CalibrationModule = typeof import('../src/lib/calibration.ts');
+type FilamentUpdatesModule = typeof import('../src/lib/filamentUpdates.ts');
 type ProfileManagerModule = typeof import('../src/lib/profileManager.ts');
 
 let colorUtilsModule: Promise<ColorUtilsModule> | null = null;
 let calibrationModule: Promise<CalibrationModule> | null = null;
+let filamentUpdatesModule: Promise<FilamentUpdatesModule> | null = null;
 let profileManagerModule: Promise<ProfileManagerModule> | null = null;
 
 async function loadViteModule<T>(modulePath: string): Promise<T> {
@@ -35,6 +37,8 @@ const loadColorUtils = () =>
     (colorUtilsModule ??= loadViteModule<ColorUtilsModule>('/src/lib/colorUtils.ts'));
 const loadCalibration = () =>
     (calibrationModule ??= loadViteModule<CalibrationModule>('/src/lib/calibration.ts'));
+const loadFilamentUpdates = () =>
+    (filamentUpdatesModule ??= loadViteModule<FilamentUpdatesModule>('/src/lib/filamentUpdates.ts'));
 const loadProfileManager = () =>
     (profileManagerModule ??= loadViteModule<ProfileManagerModule>('/src/lib/profileManager.ts'));
 
@@ -124,6 +128,41 @@ test('editing the swatch color deactivates a calibration', async () => {
     assert.deepEqual(channelHds(reverted), [0.068, 0.354, 0.373]);
 });
 
+test('color edits preserve calibration but re-anchor inactive scalar HDs', async () => {
+    const { estimateHidingDistanceFromColor } = await loadColorUtils();
+    const { colorEditUpdateForFilament } = await loadFilamentUpdates();
+    const calibration = {
+        opacityLayers: 7,
+        layerHeight: 0.08,
+        firstLayerHeight: 0.16,
+        td: [0.49, 0.51, 0.5] as [number, number, number],
+        tdSingleValue: 0.51,
+        jnd: 2,
+        baseColor: '#000000',
+        confidence: 0.9,
+        basis: 'frontlit' as const,
+        calibrationDate: '2026-07-02T00:00:00.000Z',
+        filamentColor: '#ffffff',
+    };
+    const filament: Filament = {
+        id: 'white',
+        color: '#ffffff',
+        td: 0.51,
+        calibration,
+    };
+
+    const edited = colorEditUpdateForFilament(filament, '#000000');
+    assert.equal(edited.color, '#000000');
+    assert.equal(edited.td, estimateHidingDistanceFromColor('#000000'));
+    assert.equal('calibration' in edited, false, 'the stored calibration should remain reversible');
+
+    const reverted = colorEditUpdateForFilament(
+        { ...filament, color: '#000000', td: edited.td as number },
+        '#ffffff'
+    );
+    assert.equal(reverted.td, calibration.tdSingleValue);
+});
+
 test('a calibration without a stored color still applies (legacy compatibility)', async () => {
     const { activeFrontlitCalibration } = await loadCalibration();
     const filament = {

From 1782d2c00557dd8640e14bc107e7300f0c435cce Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 6 Jul 2026 19:36:19 +0300
Subject: [PATCH 54/81] test: add calibrated frontlit profile fixture

---
 CHANGELOG.md                                  |   1 +
 .../8_Colors_Calibrated_Frontlit.kfil         | 303 ++++++++++++++++++
 tests/profileManager.test.ts                  |  38 +++
 3 files changed, 342 insertions(+)
 create mode 100644 tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 46e3cd1..c20bfb8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -10,6 +10,7 @@ All notable changes to Kromacut are documented in this file.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
+- **Filament profile import fixture** - Added a schema-v2 frontlit-calibrated 8-color `.kfil` fixture with import coverage to guard against accidental hiding-distance rescaling.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
diff --git a/tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil b/tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil
new file mode 100644
index 0000000..daf203f
--- /dev/null
+++ b/tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil
@@ -0,0 +1,303 @@
+{
+  "id": "c2e9e401-d1bf-49c8-9166-1bdc487ffd64",
+  "name": "8 Colors Calibrated Frontlit",
+  "version": 2,
+  "filaments": [
+    {
+      "id": "p9c63ms",
+      "color": "#ffffff",
+      "td": 0.5077096875055095,
+      "calibration": {
+        "opacityLayers": 7,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.4908894086367234,
+          0.5077096875055095,
+          0.49943726291595697
+        ],
+        "tdSingleValue": 0.5077096875055095,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.9587611519194583,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.797Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 7,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#00b8c4",
+            "opacityLayers": 7,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#ffffff"
+      }
+    },
+    {
+      "id": "plvjtmc",
+      "color": "#000000",
+      "td": 0.05,
+      "calibration": {
+        "opacityLayers": 1,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.05,
+          0.05,
+          0.05
+        ],
+        "tdSingleValue": 0.05,
+        "jnd": 2,
+        "baseColor": "#6300c5",
+        "confidence": 0.467990454631796,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.806Z",
+        "reads": [
+          {
+            "baseColor": "#6300c5",
+            "opacityLayers": 1
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 1
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#000000"
+      }
+    },
+    {
+      "id": "98z555k",
+      "color": "#ff7eb4",
+      "td": 0.519286177194662,
+      "calibration": {
+        "opacityLayers": 7,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.519286177194662,
+          0.23963829238245016,
+          0.41680651754298187
+        ],
+        "tdSingleValue": 0.519286177194662,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.96,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.819Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 7,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#ff7eb4"
+      }
+    },
+    {
+      "id": "w8cncoa",
+      "color": "#f7d000",
+      "td": 0.44542466216175114,
+      "calibration": {
+        "opacityLayers": 6,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.44542466216175114,
+          0.3595734312582509,
+          0.0673046271932013
+        ],
+        "tdSingleValue": 0.44542466216175114,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7999999999999999,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.838Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 6,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 4,
+            "mergeLayers": 3
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#f7d000"
+      }
+    },
+    {
+      "id": "vsn9q6u",
+      "color": "#d83400",
+      "td": 0.39476260956525944,
+      "calibration": {
+        "opacityLayers": 6,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.39476260956525944,
+          0.11055878203215688,
+          0.06967022943285602
+        ],
+        "tdSingleValue": 0.39476260956525944,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7812423269108548,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-04T15:13:24.473Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 6,
+            "mergeLayers": 5
+          },
+          {
+            "baseColor": "#f7d000",
+            "opacityLayers": 3,
+            "mergeLayers": 2
+          },
+          {
+            "baseColor": "#ff5ec4",
+            "opacityLayers": 3,
+            "mergeLayers": 2
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#d83400"
+      }
+    },
+    {
+      "id": "azwg1yp",
+      "color": "#6300c5",
+      "td": 0.3743629711219067,
+      "calibration": {
+        "opacityLayers": 4,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.22211060078297443,
+          0.06830463482833873,
+          0.3743629711219067
+        ],
+        "tdSingleValue": 0.3743629711219067,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7999999999999999,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.868Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 4,
+            "mergeLayers": 3
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#6300c5"
+      }
+    },
+    {
+      "id": "xyyxysq",
+      "color": "#00b8c4",
+      "td": 0.2715230168634275,
+      "calibration": {
+        "opacityLayers": 6,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.0819169025740069,
+          0.2715230168634275,
+          0.13120519312247034
+        ],
+        "tdSingleValue": 0.2715230168634275,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.8804030538435403,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-04T15:13:24.508Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 6,
+            "mergeLayers": 4
+          },
+          {
+            "baseColor": "#ffffff",
+            "opacityLayers": 4
+          },
+          {
+            "baseColor": "#6300c5",
+            "opacityLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#00b8c4"
+      }
+    },
+    {
+      "id": "upcjpfe",
+      "color": "#04bb00",
+      "td": 0.37055468605919367,
+      "calibration": {
+        "opacityLayers": 5,
+        "layerHeight": 0.08,
+        "firstLayerHeight": 0.16,
+        "td": [
+          0.1553450909824613,
+          0.37055468605919367,
+          0.07053705952903433
+        ],
+        "tdSingleValue": 0.37055468605919367,
+        "jnd": 2,
+        "baseColor": "#000000",
+        "confidence": 0.7946766727762713,
+        "basis": "frontlit",
+        "calibrationDate": "2026-07-02T15:07:54.898Z",
+        "reads": [
+          {
+            "baseColor": "#000000",
+            "opacityLayers": 5,
+            "mergeLayers": 4
+          },
+          {
+            "baseColor": "#f7d000",
+            "opacityLayers": 4,
+            "mergeLayers": 4
+          }
+        ],
+        "channelSource": "measured",
+        "jndSource": "default",
+        "filamentColor": "#04bb00"
+      }
+    }
+  ],
+  "createdAt": 1783281850273,
+  "updatedAt": 1783281850273
+}
\ No newline at end of file
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index c4d1f4b..dbdb5f8 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -1,5 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { createServer } from 'vite';
 
@@ -374,6 +375,43 @@ test('v2 profile imports are not re-scaled (double-import idempotence)', async (
     assert.equal(stored!.filaments[0].td, 0.4);
 });
 
+test('calibrated frontlit fixture imports without rescaling measured hiding distances', async () => {
+    const { importProfiles, parseProfileFile, CURRENT_PROFILE_VERSION } = await loadProfileManager();
+    const raw = readFileSync(
+        resolve(
+            process.cwd(),
+            'tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil'
+        ),
+        'utf8'
+    );
+    const parsed = parseProfileFile(raw);
+
+    assert.ok(parsed);
+    assert.equal(parsed.length, 1);
+
+    const source = parsed[0];
+    assert.equal(source.name, '8 Colors Calibrated Frontlit');
+    assert.equal(source.version, CURRENT_PROFILE_VERSION);
+    assert.equal(source.filaments.length, 8);
+
+    const sourceTds = source.filaments.map((filament) => filament.td);
+    const result = importProfiles([], parsed);
+
+    assert.equal(result.imported.length, 1);
+    assert.equal(result.imported[0].version, CURRENT_PROFILE_VERSION);
+    assert.deepEqual(
+        result.imported[0].filaments.map((filament) => filament.td),
+        sourceTds
+    );
+
+    for (const filament of result.imported[0].filaments) {
+        assert.ok(filament.calibration);
+        assert.equal(filament.calibration.basis, 'frontlit');
+        assert.equal(filament.calibration.tdSingleValue, filament.td);
+        assert.equal(filament.calibration.filamentColor, filament.color);
+    }
+});
+
 test('stored v1 profiles migrate tds once on load', async () => {
     const { loadProfiles, CURRENT_PROFILE_VERSION } = await loadProfileManager();
     const existingStorage = Reflect.get(globalThis, 'localStorage') as

From 0b76801858f0cce5e2e35f86730f9df502d11d6d Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 6 Jul 2026 21:31:41 +0300
Subject: [PATCH 55/81] update gitingore

---
 .agents/calibration-improvements.md           | 234 ------------------
 .agents/calibration-phase1-review-issues.md   | 174 -------------
 .agents/calibration-phase2-color.md           | 228 -----------------
 .agents/calibration-phase2-review-issues.md   | 123 ---------
 .agents/hiding-distance-migration.md          | 207 ----------------
 .agents/next-best-color-td-fix.md             | 174 -------------
 .../2026-07-02-logo-test/findings.md          |  89 -------
 .../2026-07-02-logo-test/image.png            | Bin 68424 -> 0 bytes
 .../2026-07-02-logo-test/print-photo.jpg      | Bin 496982 -> 0 bytes
 .gitignore                                    |   4 +-
 10 files changed, 2 insertions(+), 1231 deletions(-)
 delete mode 100644 .agents/calibration-improvements.md
 delete mode 100644 .agents/calibration-phase1-review-issues.md
 delete mode 100644 .agents/calibration-phase2-color.md
 delete mode 100644 .agents/calibration-phase2-review-issues.md
 delete mode 100644 .agents/hiding-distance-migration.md
 delete mode 100644 .agents/next-best-color-td-fix.md
 delete mode 100644 .agents/print-findings/2026-07-02-logo-test/findings.md
 delete mode 100644 .agents/print-findings/2026-07-02-logo-test/image.png
 delete mode 100644 .agents/print-findings/2026-07-02-logo-test/print-photo.jpg

diff --git a/.agents/calibration-improvements.md b/.agents/calibration-improvements.md
deleted file mode 100644
index fab283c..0000000
--- a/.agents/calibration-improvements.md
+++ /dev/null
@@ -1,234 +0,0 @@
-# Calibration redesign — print-and-read-back
-
-Status: design / detailed outline. Not implemented yet. Supersedes the earlier
-photo-based outline in this file.
-
-## Decision: scrap the photo-based calibration
-
-The current system ([`src/lib/calibration.ts`](../src/lib/calibration.ts),
-[`src/components/FilamentCalibrationWizard.tsx`](../src/components/FilamentCalibrationWizard.tsx))
-asks users to photograph backlit patches and sample RGB. It is being **removed**:
-
-- Hard to make accurate (lighting, white balance, monitor, single-pixel samples).
-- Bad UX (cameras, color pickers, manual RGB entry).
-- It measures *backlit* transmission, but prints are viewed *frontlit*, so the
-  result is then mangled by a magic constant
-  ([`FRONTLIT_TD_SCALE = 0.1`](../src/lib/autoPaint.ts#L395)).
-
-## New shape (the big outline, with decisions made)
-
-1. User selects one or more filaments from a profile and hits **Calibrate**.
-2. App generates a **calibration print** (STL *or* 3MF + instructions) to download.
-3. User prints it.
-4. User **reads numbers off the physical print** and types them back into the app.
-5. App fits a frontlit TD per filament and writes it onto the profile. Auto-paint
-   and the preview use it directly — no more `FRONTLIT_TD_SCALE`.
-
-Locked design decisions (from user):
-
-- **Read-back = read a number off the print.** No camera. The user's eye reads a
-  *threshold*, which is robust to lighting and monitor calibration (the exact
-  weaknesses that sank the photo flow).
-- **Base = fixed black.** Wedges print over a black base, matching the common
-  frontlit base. No base-color picker in v1.
-- **Format = user chooses** 3MF (multi-material, AMS-friendly) or STL (+ swap
-  instructions, universal).
-
----
-
-## The core mechanism: opacity threshold vs. an adjacent reference
-
-The single most valuable, eye-readable quantity for a frontlit print is **how many
-layers it takes for the filament to fully hide the black base** (its opacity
-point). One number per filament pins the optical curve far better than the current
-global 0.1 fudge.
-
-Why this is robust where color-matching/photos are not: the user is not judging an
-absolute color against a monitor. They compare each wedge step to a **fully-opaque
-reference patch of the same filament printed right next to the wedge**, and report
-the first step that is *indistinguishable from the reference*. Relative
-"same/not-same" judgments against an adjacent physical reference are reliable under
-almost any lighting.
-
-```
-Filament A wedge (over black base):           Reference
- layers: 1   2   3   4   5   6   7   8        (~20 layers,
-        [▓] [▒] [░] [.] [ ] [ ] [ ] [ ]   |   fully opaque)
-         black showing through ──► full color    [█]
-
-App asks: "Find the first patch that looks the same as the reference block."
-User types: 6
-```
-
-**One read only.** A second "mid-fade" read was considered and dropped: a partial-
-transmission point has no sharp visual cue — there's nothing to compare it against,
-so the eye can't place it accurately (the whole reason the opacity read works is the
-adjacent fully-opaque reference). The opacity threshold is the single number.
-
-### Print geometry (per filament)
-
-- A row of square patches, patch *i* = *i* layers of the filament, *i = 1..N*.
-- All patches sit on a shared **black base** (enough black layers to be opaque on
-  its own, e.g. 4–6).
-- One tall **reference patch** (same filament, ~20 layers / guaranteed opaque)
-  adjacent to the wedge.
-- Unambiguous orientation + indexing: leftmost patch = 1 layer; add an asymmetric
-  corner marker so the user can't read it backwards, and show the matching layout
-  diagram in the app. (Tiny embossed digits don't print reliably — rely on
-  position + the in-app legend, not printed numbers.)
-- Patch size ~12–15 mm so steps are easy to compare by eye.
-
-### From a number to a TD (the fit)
-
-- **Thickness must use the real layer-height model, not `layers × layerHeight`.**
-  Auto-paint's first printed layer is `printableFirstLayerHeight = max(layerHeight,
-  firstLayerHeight)`, every layer after is `layerHeight`
-  ([`autoPaint.ts`](../src/lib/autoPaint.ts#L648)). The calibration generator, the
-  TD fit, and auto-paint must all share this one conversion or the TD is biased.
-  - In the calibration print the color wedge sits **on top of the black base**, so
-    its layers are all regular `layerHeight`; the black base's bottom layer takes
-    the first-layer height (for printability, doesn't affect color thickness).
-  - `d_opaque = opacityLayers × layerHeight`. Store `firstLayerHeight` +
-    `layerHeight` with the calibration so the number stays interpretable if print
-    settings change later.
-- The read maps to TD through a **per-color "effective opacity transmission" `T*`**
-  derived from a perceptual just-noticeable-difference (JND), not a hand-picked
-  number. Two decoupled steps:
-  1. Solve `ΔE00(blendSrgbChannel(0, filament, T), filament) = JND` for `T*`.
-     Depends only on the filament's own swatch color + the JND (ΔE00 is monotonic
-     in T → unique; bisection). `T*` is *not* a function of TD.
-  2. `TD = -d_opaque / log10(T*)`.
-  This is the same `TD = -d/log10(T_opaque)` form as before, but `T_opaque = T*` is
-  *computed per filament* instead of guessed — so a bright filament (small `T*`)
-  gets a large TD and a dark one (large `T*`) a small TD automatically. The blend
-  and ΔE00 are the exact functions the optimizer already uses.
-- **JND is a standard human-vision constant** (CIEDE2000 JND ≈ 1; use ~1–2.5 to
-  absorb lighting/observer spread). It is NOT fit to any filament — per-filament
-  optics are captured by the read itself. Brand/batch/compound variation needs no
-  constant change; changing filament just means re-reading that filament.
-- Model boundary: single-TD Beer-Lambert assumes absorption, no scattering, so the
-  read pins the *endpoint* accurately but intermediate-layer color may drift — that
-  drift is Phase 2's job, not this fit's.
-- Confidence = simple function of whether the resulting TD lands in a plausible
-  range. No more per-channel least-squares from RGB samples.
-
-### Per-channel TD — derive RGB channel TDs from the single read
-
-Auto-paint consumes calibrated per-channel TDs
-([`USE_CALIBRATED_CHANNEL_TD`](../src/lib/autoPaint.ts#L396),
-`calibratedTdChannels`), so we keep that path alive by **computing the single TD
-and converting it to RGB channel TDs** using the filament's own swatch color.
-
-Physical basis: over a black base, the visible color settles channel-by-channel.
-The brightest channel is the *most transmissive* (largest TD) and therefore the
-**last** to reach full color — so the opacity the eye reads is governed by that
-channel. That makes the brightest channel the natural anchor for the measured TD.
-
-Proposed conversion (deterministic, reuses the existing heuristic shape from
-[`estimateTDFromColor`](../src/lib/colorUtils.ts#L39) = `1.0 + luminance*5.8`):
-
-1. Per channel, raw TD shape `rawTD_c = 1.0 + c_norm*5.8`, where `c_norm ∈ [0,1]`
-   is that channel of the filament swatch.
-2. Anchor on the brightest channel: `k = TD_measured / rawTD_{argmax c}`.
-3. `td_c = k * rawTD_c` for R, G, B. `tdSingleValue = TD_measured`.
-
-This preserves the color-driven per-channel *ratios* while pinning the overall
-magnitude to the measurement. The exact ratio model is a knob to validate against
-the 7-color frontlit set; the structure (single read → channels) is fixed.
-
----
-
-## Generating the print
-
-Extend [`generateCalibrationPatchesStl.ts`](../src/lib/generateCalibrationPatchesStl.ts)
-(already builds patch rows) to add: the black base layers, the reference patch,
-the orientation marker, and a 3MF variant.
-
-- **3MF:** reuse the app's existing multi-material 3MF export path. Materials =
-  black base + each selected filament. Slicer auto-assigns; minimal instructions.
-- **STL:** geometry only + generated text instructions ("load black, print to
-  layer X; swap to filament A; …"). Universal, manual swaps.
-- **Multi-filament layout & swap burden:** one wedge+reference block per filament,
-  tiled in a grid. Single-extruder users would face many swaps for a combined
-  print (black + N colors). Decision: default to **one block per filament file**
-  for non-AMS (each = black + 1 color = a single swap), and offer a **combined
-  tiled file** for AMS/multi-material users. The "let the user choose format"
-  decision pairs naturally with a "combined vs per-filament" toggle.
-
----
-
-## UX flow
-
-1. **Profile UI → Calibrate.** Multi-select filaments (checkboxes).
-2. **Configure:** layer height (from print settings), max layers N (default ~10–12),
-   patch size; base is black (fixed); pick 3MF/STL and combined/per-filament.
-3. **Generate & download** + show printable instructions (viewing conditions,
-   how to find the opacity patch vs the reference, orientation).
-4. **Enter results:** a list of the selected filaments, each with an "opacity
-   patch #" input (and optional second read). A live predicted swatch updates as
-   they type so they get immediate feedback.
-5. **Save:** frontlit TD written to each profile; preview + auto-paint update.
-
----
-
-## Integration & data
-
-- [`src/lib/autoPaint.ts`](../src/lib/autoPaint.ts): **remove `FRONTLIT_TD_SCALE`**.
-  Measured TD is already frontlit-correct. For uncalibrated filaments, re-baseline
-  the default frontlit TD (today's `estimateTDFromColor` heuristic was implicitly a
-  backlit value scaled by 0.1 — that baseline must be re-derived).
-- [`src/types/index.ts`](../src/types/index.ts): replace the calibration shape.
-  New `FrontlitCalibration { opacityLayers, td: [r,g,b], tdSingleValue,
-  layerHeight, firstLayerHeight, basis: 'black-frontlit', printedAt, notes? }`.
-  Remove `measurements`, `whiteReference`, and all RGB-sample fields.
-
-### Breaking changes are fine — no deprecation, aggressive removal
-
-The user has OK'd breaking changes with **no migration notice**. So:
-- **Delete** `FilamentCalibrationWizard.tsx` entirely.
-- **Gut** `calibration.ts`: drop the Beer-Lambert RGB-sample fit, white-reference
-  handling, per-channel least-squares, confidence-from-CV, import/export of the old
-  shape. Keep/replace with just: the opacity→TD fit, the channel conversion, and
-  generator helpers.
-- Persistence ([`profileManager.ts`](../src/lib/profileManager.ts),
-  `useProfileManager.ts`, `.kfil`/`.kapp`, localStorage): old `CalibrationResult`
-  fields are simply **ignored/stripped on load** — no conversion, no notice. The
-  filament keeps its plain TD; calibration just reads as absent until recalibrated.
-- Rewrite `tests/calibration.test.ts`; drop fixtures tied to the old flow.
-- Audit other call sites of the removed exports (`predictTransmission`,
-  `calculateTDFromMeasurements`, `validateWhiteReference`, etc.) and delete dead UI.
-- Docs (`src/docs/*`) + `CHANGELOG.md`.
-
----
-
-## Phase 2 — color accuracy (combos)
-
-Designed in [calibration-phase2-color.md](calibration-phase2-color.md): the Phase-1
-opacity read repeated over 2–3 different colored bases per filament measures the
-per-channel TDs directly (replacing the `1 + c*5.8` heuristic ratios), and the
-cross-base consistency of those reads pins the JND as one global fitted constant.
-Camera-free, same tile geometry, same "match the rail" judgment; pruned to
-printable combos using the Phase-1 TDs as originally intended.
-
----
-
-## Decisions resolved
-
-- **Read-back:** single opacity-threshold number, read against an adjacent opaque
-  reference patch. No camera. (Mid-fade second read dropped — not eye-readable.)
-- **Base:** fixed black.
-- **Format:** user picks 3MF or STL; plus combined (AMS) vs per-filament files.
-- **Per-channel TD:** compute single TD → derive R/G/B channel TDs from the swatch
-  color (conversion above).
-- **Layer heights:** thickness uses the shared `max(layerHeight, firstLayerHeight)`
-  first-layer model; store both heights with the calibration.
-- **Migration:** none. Breaking change, old calibration silently stripped.
-
-## Still to pin
-
-- **JND value** (1 vs ~2.5): a viewing-robustness choice, *not* a filament fit.
-  Sanity-check against the 7-color frontlit set that the resulting prints look
-  right; do not derive it from those specific filaments.
-- Default max layers N and patch size for the wedge.
-- The per-channel ratio model (validate the `1.0 + c*5.8` shape frontlit).
-</content>
diff --git a/.agents/calibration-phase1-review-issues.md b/.agents/calibration-phase1-review-issues.md
deleted file mode 100644
index 2e3a6b7..0000000
--- a/.agents/calibration-phase1-review-issues.md
+++ /dev/null
@@ -1,174 +0,0 @@
-# Phase 1 review — issues to fix before Phase 2
-
-> **Status: ALL RESOLVED (2026-07-02).** All six issues below were fixed in the
-> follow-up changes (calibration sanitizer + load-path stripping, first-layer-aware
-> base height, STL swap instructions, `basis: 'frontlit'` rename, per-row calibrate
-> button with reset-on-open, changelog cleanup). Verified: 224 tests pass, tsc and
-> eslint clean. Kept for history; Phase 2 is unblocked.
-
-Review of commits `354f736` (frontlit opacity-read calibration) and `bd4fa71` (Load TD
-Test button removal) against the plan in
-[calibration-improvements.md](calibration-improvements.md). The core fit
-(`solveOpacityTransmission`, `computeFrontlitCalibration`, `deriveChannelTds`), the
-dialog flow, the 3MF slot mapping, and the round-trip tests all match the plan and are
-in good shape. The issues below are ordered by severity; #1 and #2 are blockers for
-calling Phase 1 done.
-
----
-
-## 1. HIGH — Old persisted calibrations are not stripped on load, and now bypass the frontlit scale
-
-The plan requires: "old `CalibrationResult` fields are simply **ignored/stripped on
-load**." That stripping was never implemented — the commit touched no persistence code.
-
-Three load paths pass `filament.calibration` through untyped/unvalidated:
-
-- `loadProfiles()` — [profileManager.ts:17-30](../src/lib/profileManager.ts#L17-L30)
-  (localStorage `kromacut.autopaint.profiles`)
-- `importProfiles()` filament validation — [profileManager.ts:165-168](../src/lib/profileManager.ts#L165-L168)
-  (`.kfil` / profile JSON import; only checks `id`/`color`/`td`)
-- `loadAutoPaintPersisted()` — [App.tsx:108-142](../src/App.tsx#L108-L142)
-  (localStorage `kromacut.autopaint.v1`, `parsed.filaments` used as-is)
-
-Why this is actively harmful, not just cosmetic: the old `CalibrationResult` shape
-(`{ measurements, whiteReference, td: [r,g,b], tdSingleValue, confidence,
-calibrationDate }`) survives a JSON round-trip and **structurally satisfies the two
-runtime checks that matter**:
-
-- `scaleFilamentForFrontlight()` ([autoPaint.ts:411-419](../src/lib/autoPaint.ts#L411-L419))
-  skips the `FRONTLIT_TD_SCALE = 0.1` fallback for any truthy `calibration`.
-- `calibratedTdChannels()` ([autoPaint.ts:402-409](../src/lib/autoPaint.ts#L402-L409))
-  only checks that `calibration.td` is a finite-positive array — which the old backlit
-  fit also produced.
-
-So a user with an old photo calibration gets their **backlit** TDs (~2–6 mm, which the
-old pipeline multiplied by 0.1) fed into the simulation as if they were measured
-frontlit TDs — roughly 10× too transmissive, silently, producing drastically wrong
-layer stacks. The changelog says "recalibrate any previously calibrated filaments" but
-nothing in code enforces or even detects it. `computeProfileConfidence()` and the
-FilamentRow "calibrated" badge also accept the old object (it has `confidence` +
-`calibrationDate`, and the old flow also set `td = tdSingleValue`, so the
-`calibrationMatchesTd` guard passes).
-
-**Fix:** add a single validator (e.g. in `calibration.ts`:
-`sanitizeFrontlitCalibration(value: unknown): FrontlitCalibration | undefined`) that
-accepts an object only if it matches the new shape — cheapest reliable discriminators
-are `basis === 'black-frontlit'` plus finite `opacityLayers >= 1` (old shape has
-neither) — and returns `undefined` otherwise. Apply it to `filament.calibration` in all
-three load paths above. A defensive `basis`/`opacityLayers` check inside
-`calibratedTdChannels`/`scaleFilamentForFrontlight` is cheap extra insurance since
-worker inputs come from persisted state. Add a regression test: a profile JSON carrying
-an old-shape calibration loads with `calibration === undefined` and the filament falls
-back to the `FRONTLIT_TD_SCALE` path.
-
----
-
-## 2. HIGH — Calibration print geometry ignores first-layer height, so patch layer counts are wrong when sliced
-
-`baseHeight()` ([generateCalibrationPrint.ts:88-90](../src/lib/generateCalibrationPrint.ts#L88-L90))
-is `baseLayers × layerHeight`, with a comment claiming "The slicer applies its own
-first-layer height when printing, so this is just baseLayers worth of regular layers."
-That reasoning is inverted: because the slicer's first layer is taller, the Z grid is
-`firstLayer + n × layerHeight`, and a base built from regular layers only does NOT land
-on that grid.
-
-Defaults make it concrete: `layerHeight 0.08`, `firstLayerHeight 0.2` (and the embedded
-3MF project sets `initial_layer_print_height = max(layerHeight, firstLayerHeight)` =
-0.2, [generateCalibrationPrint.ts:571](../src/lib/generateCalibrationPrint.ts#L571)).
-Slicer layer tops: 0.2, 0.28, 0.36, 0.44, … Base top: 5 × 0.08 = **0.40 mm — mid-layer**.
-Every wedge patch top (0.40 + i × 0.08) is then also mid-layer. The slicer will
-realize each patch with a color layer count that differs from the nominal patch number
-(off by one, or with a partial base/color boundary layer), so the number the user reads
-back does not correspond to `opacityLayers × layerHeight` of filament — the exact bias
-the plan warned about ("Thickness must use the real layer-height model, not
-`layers × layerHeight`").
-
-**Fix:** make the base absorb the first layer:
-`baseHeight = max(layerHeight, firstLayerHeight) + (baseLayers − 1) × layerHeight`.
-Then the base top and every patch/rail top land exactly on the slicer grid (0.2 + 4×0.08
-= 0.52; patches at 0.52 + i×0.08 ✓), and each color patch is exactly `i` regular
-layers, which is what `computeFrontlitCalibration` assumes. Update the stale comment,
-the `calibrationPrint.test.ts` expectations, and add an assertion that the base top and
-patch tops are integer multiples of `layerHeight` above `max(layerHeight,
-firstLayerHeight)`. Note the wedge/rail math itself needs no change — only the base
-thickness.
-
-This matters for both formats: the 3MF embeds the matching first-layer height itself;
-for STL the dialog should tell the user which layer height AND first-layer height to
-slice with (see #3).
-
----
-
-## 3. MEDIUM — STL flow lacks concrete per-filament print/swap instructions
-
-The plan specifies generated text instructions for STL ("load black, print to layer X;
-swap to filament A"). What shipped is one generic sentence ("base, then swap to the
-color above the base" — [FilamentCalibrationDialog.tsx:523](../src/components/FilamentCalibrationDialog.tsx#L523)).
-Two concrete gaps:
-
-- **No per-filament base reminder.** The Base step lets the user pick a different base
-  per filament, and the TD fit uses that choice (`resolveBaseColor` →
-  `computeFrontlitCalibration.baseColor`). At print time nothing shows which base goes
-  with which filament; printing over the wrong base silently produces a wrong fit.
-- **No exact swap point.** After fixing #2 the swap is well-defined: pause/swap after
-  layer `baseLayers`, i.e. at Z = `max(layerHeight, firstLayerHeight) +
-  (baseLayers − 1) × layerHeight`. Show the layer number and Z, plus "slice at layer
-  height H, first layer F" so the user's slicer settings match the geometry.
-
-A per-filament line in the Print step ("Red: base = Black, swap after layer 5 /
-Z 0.52 mm") is enough; a downloadable .txt is optional polish.
-
----
-
-## 4. MEDIUM — `basis: 'black-frontlit'` is hardcoded even for non-black bases
-
-`computeFrontlitCalibration` always stores `basis: 'black-frontlit'`
-([calibration.ts:224](../src/lib/calibration.ts#L224)) while also storing the actual
-`baseColor`, which the base-picker feature lets be white or anything else. A
-calibration over white then carries a self-contradictory record. This is a persisted
-user-data field in a brand-new format — rename it **now**, before it ships, rather than
-migrating later. Suggestion: `basis: 'frontlit'` with `baseColor` as the sole source of
-truth (keep `baseColor` required rather than optional). If #1's sanitizer keys on
-`basis`, update both together.
-
----
-
-## 5. LOW — `initialFilamentId` preselect is dead and would be stale if wired
-
-The only caller is `handleOpenCalibration()` with no id
-([AutoPaintTab.tsx:490](../src/components/AutoPaintTab.tsx#L490)), so per-filament
-preselect never happens. Even if an id were passed, the dialog captures
-`initialFilamentId` in a `useState` initializer at mount
-([FilamentCalibrationDialog.tsx:107-109](../src/components/FilamentCalibrationDialog.tsx#L107-L109))
-and only re-reads it in `reset()`, which runs via a 300 ms `setTimeout` holding a
-possibly stale closure — racing AutoPaintTab's own 300 ms reset of
-`calibratingFilamentId` to null. Either delete the prop and the AutoPaintTab id
-plumbing, or fix properly (sync selection in an effect when `open` flips true).
-
----
-
-## 6. LOW — Stale changelog entry for the deleted photo sampler
-
-`CHANGELOG.md` unreleased "Changed" still lists **"Calibration image sampler"**
-(circular brush overlay) — a refinement to the photo wizard that this same unreleased
-version deleted. Per AGENTS.md changelog guidance (entries classify against the last
-release), remove that bullet; the frontlit-calibration "Added" bullet already covers
-the replacement.
-
----
-
-## Reviewed and explicitly OK (no action)
-
-- Fit math: `T*` bisection over any base, `TD = -d/log10(T*)`, brightest-channel anchor
-  in `deriveChannelTds` — all match the plan; round-trip tests recover synthetic TDs
-  within integer-read quantization.
-- The base-picker (vs the plan's fixed black base) is a sound generalization — the solve
-  handles arbitrary bases and errors out on low contrast with a helpful message.
-- Keeping `FRONTLIT_TD_SCALE` as the *uncalibrated-only* fallback rather than deleting
-  it outright is a reasonable reading of the plan's "re-baseline the default."
-- Overlapping closed shells in the STL (orientation foot into base, patches butting the
-  rail): slicers union coincident shells within one solid; fine for a standalone
-  calibration part.
-- 3MF slot mapping to real profile filaments in profile order, no phantom base, no
-  `<assemble>` block — matches the refined design and is test-covered.
-- All 219 tests pass on the current branch.
diff --git a/.agents/calibration-phase2-color.md b/.agents/calibration-phase2-color.md
deleted file mode 100644
index 0d11b15..0000000
--- a/.agents/calibration-phase2-color.md
+++ /dev/null
@@ -1,228 +0,0 @@
-# Calibration Phase 2 — color accuracy via multi-base opacity reads
-
-Status: core implementation complete; metamer-pair validation strip still open. Builds directly on the Phase 1
-frontlit calibration (see [calibration-improvements.md](calibration-improvements.md),
-implemented in `354f736` + the review fixes).
-
-## Goal
-
-Phase 1 pins each filament's overall optical magnitude (scalar frontlit TD) from a
-single opacity read over one base. Two things remain heuristic:
-
-1. **Per-channel TD ratios** — currently derived from the swatch color via the
-   `1 + c/255 × 5.8` shape ([`deriveChannelTds`](../src/lib/calibration.ts)), anchored
-   to the measured scalar. The ratios were never measured; they drive every stacked
-   color blend the optimizer and preview compute, so they are the dominant remaining
-   error source for intermediate/blended colors.
-2. **The JND constant** — [`OPACITY_JND = 2.0`](../src/lib/calibration.ts) defines
-   "indistinguishable from the reference rail" and sets the global TD scale
-   (`TD = -d/log10(T*)` where `T*` depends on the JND). It was never validated against
-   physical prints (the Phase-1 "Still to pin" item).
-
-Phase 2 measures both, stays **camera-free**, and changes **only the calibration
-side** — the optimizer and preview already consume per-channel TDs
-(`calibration.td`), so better numbers flow through with zero pipeline changes.
-
-## Core mechanism: the Phase-1 read, repeated over different colored bases
-
-Phase 1 already generalized the opacity read to arbitrary bases (base-picker +
-`solveOpacityTransmission(color, jnd, baseColor)`). Phase 2's entire measurement is:
-**read the same filament over 2–3 different bases.**
-
-Why this measures per-channel TDs: the opacity read is governed by the _slowest_
-channel to converge, and which channel that is depends on the base.
-
-- Yellow over **black**: R and G must build up from 0 → governed by td_r, td_g.
-- Yellow over **blue**: the blue channel must attenuate 255 → ~0 → governed by td_b.
-- Each additional base with a different channel signature adds an independent
-  constraint on the (td_r, td_g, td_b) triple.
-
-No new read type, no new geometry, no new judgment for the user's eye — still
-"first patch that matches the rail beside it," which is the whole reason the
-Phase-1 flow is robust.
-
-### The fit
-
-Per filament, given reads `{(base_i, n_i)}` at layer height `h`:
-
-- Model: per-channel transmission `T_c(d) = 10^(-d / td_c)`; blended color =
-  `blendSrgbChannel(base_c, filament_c, T_c(d))` per channel (the exact functions the
-  optimizer uses).
-- Predicted read for a candidate `(td_r, td_g, td_b)`:
-  `n̂_i = min { n : ΔE00(blend(base_i, A, T(n·h)), A) ≤ JND }`.
-- Fit: minimize `Σ_i (n̂_i − n_i)²` (or a smooth surrogate on log-TD) over the
-  channel TDs, **regularized toward the Phase-1 anchor structure** (brightest-channel
-  anchor + heuristic ratios as the prior) so 2 reads still give a stable answer.
-  Deterministic — coarse grid + local refinement, no randomness.
-- With **1 read** (Phase-1 case) the fit degenerates to exactly the current
-  `deriveChannelTds` behavior. Phase 2 is a strict superset; single-base calibration
-  keeps working unchanged.
-
-Integer reads quantize each constraint, so prefer overdetermination (3 bases) over
-exact solving, and keep `maxLayers` large enough that reads land mid-wedge (the
-confidence logic already penalizes clipped reads).
-
-### Optional secondary read: the adjacent-step merge point (the Phase-3 detector)
-
-On the same wedge, the user can optionally also report **the last patch that still
-looks different from its neighbor** (walking up the wedge, the point where adjacent
-steps become indistinguishable). Still a same/not-same judgment between two
-physically adjacent patches — same trust model as the rail read. Observed in
-practice on the first physical Phase-1 print: large visible steps in the first few
-layers, then diminishing returns well before the rail match.
-
-Why it matters: the exponential model makes a _fixed quantitative prediction_ about
-where this merge point sits relative to the rail-match point. Per channel,
-step-to-step change ∝ `r^n(1−r)` while distance-to-rail ∝ `r^n` (with
-`r = 10^(-h/td)`), so neighbors merge when the remaining gap to the rail is still
-≈ `JND/(1−r)` — e.g. ~3× JND at h=0.08, TD≈0.5. Diminishing returns per layer is
-therefore **expected** and does not by itself indicate scattering.
-
-What _would_ indicate scattering (a longer-than-exponential tail): merge points
-landing systematically earlier — relative to the rail match — than the fitted
-exponential predicts, consistently across filaments. The merge read costs nothing
-extra to print, is optional at entry (never blocks saving a calibration), and is
-stored alongside the opacity reads purely as model-form evidence. It can also serve
-as a soft extra constraint in the TD fit when present.
-
-### JND: fit it from the same data instead of hand-tuning
-
-For one filament read over two bases, the implied TDs must agree — and
-`T*(A over B1)` vs `T*(A over B2)` respond _differently_ to the JND (the ΔE00
-geometry along each blend path differs), so cross-base consistency identifies it.
-
-- Treat JND as **one global parameter shared across all filaments and reads** in a
-  calibration session (it is a human-vision constant, never per-filament — same
-  principle as Phase 1).
-- Fit: outer 1-D search of JND over a sane band **[1.0, 3.0]**, minimizing the total
-  cross-base fit residual from the per-filament fits above; many (filament × base)
-  reads vs. one parameter → well overdetermined.
-- Fallback: if the session has too few multi-base reads or the residual curve is
-  flat, keep `OPACITY_JND = 2.0` and report that in the UI/notes. Never silently fit
-  JND from a single filament.
-- Once fitted, store the session JND and use it for subsequent single-read
-  calibrations too.
-
-This absorbs the unfinished Phase-1 validation task ("sanity-check JND against the
-7-color frontlit set"): the first real Phase-2 calibration session of that filament
-set _is_ the JND measurement.
-
-## Combo pruning (which bases to print each filament over)
-
-Auto-pick 2–3 bases per filament from the user's own profile filaments, pruned with
-the Phase-1 TDs exactly as the original plan intended:
-
-- Drop pairs where `solveOpacityTransmission` returns undefined (no contrast → no
-  read possible; already handled/errored in Phase 1).
-- Drop pairs whose **predicted** read (from current TDs) is 1 (base hidden
-  immediately — zero information) or > maxLayers (never converges in the wedge).
-- Among survivors, greedily pick bases maximizing channel diversity: score each
-  candidate base by how differently it weights the three channels for this filament
-  (e.g., which channel the predicted read is governed by), and pick a set covering
-  different governing channels. Black (or the darkest filament) stays in the set as
-  the anchor read.
-- The user can override the auto-picked set (same Select UI as Phase 1's base step,
-  now multi-select per filament).
-
-Note: bases only contribute their _surface color_ (they print opaque), so an
-uncalibrated filament can serve as a base — no calibration-order dependency.
-
-## Print & UX
-
-- **Geometry:** unchanged tile generator. Phase 2 print = one tile per
-  (filament, base) pair instead of one per filament. Combined 3MF tiles or one STL
-  printed per pair (still exactly one swap each); the per-filament swap-instruction
-  list from the review fixes extends naturally ("Yellow over Blue: base = Blue, swap
-  after layer 5 / Z 0.52 mm").
-- **Dialog:** same four steps. Base step gains multi-select; Measure step shows one
-  read row per (filament, base) with the same live predicted swatch. A "quick"
-  single-base mode (= Phase 1 behavior) remains the default for one-off filaments;
-  "accurate" multi-base mode is the Phase 2 addition.
-- Keep the read count honest: 5 filaments × 3 bases = 15 reads is the practical
-  ceiling for one session; default to 2 bases (anchor + one contrast base) and let
-  the user opt into 3.
-
-## Data shape
-
-Extend `FrontlitCalibration` **backward-compatibly** (the sanitizer from the review
-fixes must keep accepting Phase-1 records):
-
-```ts
-interface FrontlitCalibration {
-    // existing Phase-1 fields unchanged; opacityLayers/baseColor describe the
-    // anchor read for compatibility
-    ...
-    /** All reads used for the fit (anchor read included). Absent = Phase-1 single read.
-     *  mergeLayers = optional adjacent-step merge point (Phase-3 evidence). */
-    reads?: Array<{ baseColor: string; opacityLayers: number; mergeLayers?: number }>;
-    /** 'heuristic' (Phase-1 ratio model) or 'measured' (multi-base fit). */
-    channelSource?: 'heuristic' | 'measured';
-    /** JND actually used; already stored. Add where it came from. */
-    jndSource?: 'default' | 'session-fit';
-}
-```
-
-Sanitizer: `reads`, `channelSource`, `jndSource` optional; validate elements if
-present. No migration needed — Phase-1 records read as anchor-only.
-
-Confidence: multi-base calibrations with consistent reads score higher; a filament
-whose reads _disagree_ badly under the best fit gets flagged (that disagreement is
-also the scattering signal — see below).
-
-## Phase 3 gate (scattering) — decided by Phase-2 data, not folded in
-
-Phase 3 = upgrading the blend model from single-exponential absorption to something
-scattering-aware (Kubelka-Munk style). **Deliberately NOT included in Phase 2**:
-
-- It adds ~2 parameters per channel per filament; fitting that from a handful of
-  integer reads is ill-conditioned without evidence the extra form is needed.
-- The blend function sits on the optimizer hot path; KM composition is more
-  expensive — only pay if the data demands it.
-- A model-form change shifts every stack prediction (goldens, previews, existing
-  calibrations churn). Do it once, with evidence, not speculatively.
-
-Phase 2 instead **collects the decision data as a byproduct**:
-
-1. Cross-base fit residuals: multi-base reads that no per-channel TD triple can
-   reconcile (beyond integer quantization) → absorption model at its limit. Surface
-   as reduced confidence + a note, per filament.
-2. Adjacent-step merge reads (above) landing systematically earlier than the fitted
-   exponential predicts → long-tail/scattering signature.
-3. Metamer-pair validation disagreements concentrated on stacks involving specific
-   filaments (white/pastel filaments are the likely offenders — TiO2 is nearly pure
-   scattering).
-
-Gate: if ≥2 of these signals agree across the 7-color set, design Phase 3 (likely a
-single scattering-fraction parameter per filament, not full per-channel KM, fitted
-from the same reads). If not, Phase 3 is unnecessary and the exponential stands.
-
-## Explicitly out of scope (v1 of Phase 2)
-
-- **Scattering model itself** — detection only, per the gate above.
-- **Camera/photo anything.** Still banned.
-- **On-screen color matching.** Still banned (monitor problem).
-
-## Validation & acceptance
-
-- **Synthetic round-trips:** generate reads from a known (td_r, td_g, td_b) + JND,
-  run the fit, recover within integer-read quantization (mirrors the Phase-1 test
-  style in `tests/frontlitCalibration.test.ts`).
-- **JND identifiability test:** synthetic multi-filament session with a known JND;
-  the outer fit recovers it; a flat-residual session falls back to 2.0.
-- **Physical acceptance — metamer pairs:** after calibrating the 7-color set, have
-  the app print a small strip of stack _pairs_ the model predicts to be
-  indistinguishable (e.g., "2 layers A over B" next to "1 layer A' over B'" with
-  predicted ΔE00 < JND) plus a few pairs predicted clearly different. Count
-  agreements by eye. This is a yes/no ordinal judgment (camera-free, monitor-free)
-  and directly tests what auto-paint relies on: stacked-blend predictions.
-
-## Open questions / to pin during implementation
-
-- Default bases per filament: 2 vs 3 (read burden vs. fit conditioning).
-- Fit details: exact objective surrogate, regularization weight toward the
-  heuristic prior, grid resolution. Must stay deterministic.
-- Whether the session-fitted JND should retroactively rescale existing Phase-1
-  calibrations (they stored their JND, so it's computable — probably yes, with the
-  stored `jnd` recording what was actually used).
-- Where the metamer-pair validation strip lives in the UI (part of the calibration
-  dialog vs. a separate "verify calibration" action).
diff --git a/.agents/calibration-phase2-review-issues.md b/.agents/calibration-phase2-review-issues.md
deleted file mode 100644
index eca7dcc..0000000
--- a/.agents/calibration-phase2-review-issues.md
+++ /dev/null
@@ -1,123 +0,0 @@
-# Phase 2 review — issues to fix
-
-> **Status: RESOLVED (2026-07-02).** All four items fixed: the session JND fit moved
-> out of the per-keystroke path into `handleSave` (live typing now costs ~60 ms per
-> filament; merge reads no longer retrigger computation), the dead ternary is gone,
-> the measure step gained Base/Match/Merge column headers, tooltips, and an amber
-> warning when merge > match, and the design doc tracks the metamer strip as open.
-> Verified: 227 tests, tsc, eslint green.
->
-> **Residual follow-ups — RESOLVED (2026-07-02):**
-> 1. ~~Synchronous save freeze~~ — Save now sets an `isSaving` "Fitting…" state,
->    disables the button, and defers the session fit past a paint
->    (`requestAnimationFrame` + `setTimeout`), resetting state in `finally`.
-> 2. ~~Band-edge JND acceptance~~ — `fitSessionJnd` rejects solutions at
->    `JND_FIT_MIN`/`JND_FIT_MAX` and falls back to the default JND; covered by a
->    regression test with an out-of-band synthetic session.
-> 3. ~~Cosmetic dead "session JND" badge branch in the live measure view~~ —
->    later upgraded by a codex PR review (preview and save could disagree when
->    the session fit fired) and fixed properly: the session JND is now fitted
->    once in a debounced background pass after the reads settle, the live
->    preview consumes it (badge reachable again), and Save reuses the cached
->    fit so saved values always equal previewed values.
->
-> Verified after the fixes: 228 tests, tsc, eslint green.
-
-Review of the uncommitted Phase 2 implementation (multi-base opacity reads, measured
-per-channel TDs, session JND fit) against
-[calibration-phase2-color.md](calibration-phase2-color.md).
-
-**Overall: the implementation is faithful to the design and the math is right.**
-Multi-base reads fit measured channel TDs with the heuristic as prior (single-read
-degenerates exactly to Phase-1 behavior); the JND session fit uses a center-mode
-residual for identifiability, requires ≥2 multi-base filaments, and has a
-flat-residual fallback to 2.0; reads/channelSource/jndSource persist
-backward-compatibly through the sanitizer; base auto-picking prunes by predicted
-read usefulness and channel diversity; merge reads are stored as evidence only.
-Tests cover the multi-base round-trip, JND recovery (within 0.25 of a synthetic
-truth), and the fallback. 227 tests, tsc, eslint all green.
-
-One significant issue and a few small ones:
-
----
-
-## 1. HIGH (UX/perf) — the session fit freezes the UI for seconds on every keystroke
-
-`computed` in
-[FilamentCalibrationDialog.tsx](../src/components/FilamentCalibrationDialog.tsx)
-calls `computeFrontlitCalibrationSession` synchronously inside a `useMemo` whose
-deps include `reads` and `mergeReads` — i.e. it re-runs on **every keystroke** in
-the measure step. Once ≥2 filaments have complete multi-base reads, that call
-includes `fitSessionJnd`: ~20 JND candidates × (full channel-TD fit per eligible
-filament), where one fit is ~500 score evaluations × reads × a 36-iteration ΔE00
-bisection.
-
-Measured: the synthetic session test (3 filaments × 3 reads) takes **4.3 s** in
-node; a realistic 3×2 session is on the order of 1.5–3 s. The freeze lands at the
-worst moment — while the user is typing the *last* reads (and typing a merge value,
-which doesn't even affect the fit, retriggers the whole thing). AGENTS.md:
-long-running work must keep the UI responsive.
-
-Suggested fixes, in order of preference (can combine):
-
-1. **Don't refit on keystrokes.** Debounce the session computation (~400 ms) AND
-   exclude `mergeReads` from the fit input entirely (merge values are stored at
-   save time; they have zero effect on the fit — build them into the reads array
-   only in `handleSave`).
-2. **Move the session fit off the main thread** using the existing worker pattern
-   (`useAutoPaintWorker` precedent) if debouncing alone still feels janky.
-3. **Cheapen the fit**: cache `opacityLayerThreshold` results keyed by
-   (td-triple, base, jnd) across the JND grid; cut the bisection to ~20 iterations
-   (layer-resolution accuracy needs far less than 2^-36); skip re-running the
-   per-filament *display* fit when only the JND search is exploring.
-
-A pragmatic minimal version: keep per-filament fits live (each ~25–75 ms, fine),
-but run the **JND session fit only on demand** — when the user leaves the last
-input / presses Save, with the badge updating from "default JND" to "session JND"
-at that point. Everything stays deterministic.
-
-## 2. LOW — pointless ternary in `computeFrontlitCalibration`
-
-[calibration.ts](../src/lib/calibration.ts):
-`const tdSingleValue = reads.length > 1 ? fit.tdSingleValue : fit.tdSingleValue;`
-— both branches are identical. Replace with `const tdSingleValue = fit.tdSingleValue;`.
-
-## 3. LOW (UX) — the "merge" input is unexplained in the dialog
-
-The measure row shows two bare number inputs with placeholders "match" and
-"merge". The docs explain the merge read, but the dialog doesn't — a first-time
-user won't know what to type there or that it's optional. Add a `title` tooltip
-(e.g. "Optional: first patch that looks the same as the patch before it") and/or a
-tiny column-header row above the inputs. Also consider a soft validation hint when
-`mergeLayers > opacityLayers` (physically odd: neighbors can't merge after the
-rail match) — accept it, but flag it visually.
-
-## 4. NOTE (not a defect) — metamer-pair validation strip not included
-
-The design's physical acceptance artifact (printable strips of stacks predicted
-indistinguishable vs. clearly different) is not in this change. Fine to land
-Phase 2 without it, but it is the third Phase-3 gate signal, so it should be
-tracked as the remaining open piece of Phase 2 rather than dropped.
-
----
-
-## Reviewed and explicitly OK
-
-- Single-read path returns exactly the Phase-1 result (prior = heuristic channel
-  TDs anchored to the T* scalar); no behavior change for quick mode.
-- `tdSingleValue = max(channel TDs)` for multi-read fits — consistent with the
-  brightest-channel-anchor convention.
-- JND fit: center-mode residual (interval mode would be flat within quantization
-  intervals → unidentifiable); ≥2 eligible filaments required; improvement
-  threshold before accepting; deterministic coarse+fine grid in [1.0, 3.0].
-- Session JND, when fitted, is applied to the same session's single-read filaments
-  too, and recorded via `jndSource: 'session-fit'` — matches the design.
-- Sanitizer extensions are strict (bad `reads`/`channelSource`/`jndSource` reject
-  the whole record) and Phase-1 records without `reads` still pass.
-- Base auto-pick: prunes no-contrast and predicted-read-1 / >maxLayers pairs,
-  anchors on the darkest useful base, prefers channel diversity then mid-wedge
-  predicted reads; accurate mode defaults to 2 bases, capped at 3.
-- Disagreeing multi-base reads (rms > 0.75 layers) reduce confidence and append a
-  note — the Phase-3 residual signal is surfaced as designed.
-- Uncalibrated filaments' predictions for pruning use `td × 0.1` mirroring
-  `FRONTLIT_TD_SCALE` — consistent with auto-paint's fallback.
diff --git a/.agents/hiding-distance-migration.md b/.agents/hiding-distance-migration.md
deleted file mode 100644
index b4fea21..0000000
--- a/.agents/hiding-distance-migration.md
+++ /dev/null
@@ -1,207 +0,0 @@
-# Hiding Distance — rename, single-meaning storage, and per-channel model
-
-> **Status: IMPLEMENTED (2026-07-03, by Claude).** All sections landed, including the
-> folded-in nextBestColor work (§4). Verified: 240 tests (12 new), tsc, eslint green;
-> 24 auto-paint goldens regenerated; the calibrated-path regression guard
-> (`tests/assets/autopaint-calibrated-baseline.json`, captured pre-change) proves
-> byte-identical output for the 8-color calibrated profile. Implementation notes vs
-> plan: `effectiveFrontlitTd` was unnecessary (single-meaning storage covers it);
-> `.kapp` test fixtures stay authentic v1 files with migration applied in the
-> fixture readers; the `profileManager→calibration→colorSpace/colorDifference/colorUtils`
-> import chain gained explicit `.ts` extensions for plain-node test/script loading;
-> one nextBestColor ranking test updated (linear light legitimately changes the
-> winning candidate, and its old assertion contradicted its own comment).
->
-> **Post-implementation self-review (2026-07-03)** found and fixed two issues:
-> (1) the ×0.1 migration now rounds to 4 decimals — raw doubles like
-> `1.1 × 0.1 = 0.11000000000000001` would have shown verbatim in the HD input;
-> (2) migration gates re-keyed to fixed version constants (`TD_MIGRATION_VERSION`
-> in profileManager, `>=` schema check in App.tsx) so a future v3 bump cannot
-> re-apply the ×0.1 to v2 data. Goldens regenerated once more after the rounding
-> change (a 1e-18 td delta had flipped one optimizer scenario). Final state:
-> 240 tests, tsc, eslint green.
-
-Status: implemented.
-**Supersedes** [next-best-color-td-fix.md](next-best-color-td-fix.md) (never started —
-its defects are either auto-resolved by this migration or folded in below).
-
-## Decisions (user-approved)
-
-- **Name:** "Hiding Distance" (HD), unit mm — the depth of material at which a
-  filament visually hides what's beneath it. Display/docs rename only; the storage
-  field stays `td` (`.kfil` compat is a user-data boundary per AGENTS.md).
-- **Storage becomes single-meaning:** `filament.td` always stores the *frontlit*
-  hiding distance, for calibrated and uncalibrated filaments alike. The current
-  dual meaning (backlit-community scale for uncalibrated, frontlit for calibrated,
-  reconciled by a runtime ×0.1) is the root cause of the nextBestColor bug class
-  and dies here.
-- **Conventional TD entry:** users can still type a spool-sheet / MakerWorld-test
-  TD; the UI converts it (× `FRONTLIT_TD_SCALE = 0.1`) at entry. The factor is
-  empirically validated: the user's physical calibration of 8 filaments measured
-  HD ≈ old backlit TD × 0.1 across the set.
-- **Uncalibrated filaments get heuristic per-channel HDs** (approved sub-decision).
-  Today they blend channel-uniform (`[td,td,td]`); the `deriveChannelTds` color
-  heuristic is only used inside calibration fitting. After this change every
-  filament blends with channel HDs — measured (calibrated) or derived from the
-  swatch color (uncalibrated). This is the biggest behavior change in the bundle:
-  uncalibrated blend outputs change and goldens must be regenerated.
-
-## 1. Data migration (the critical part — treat as a persistence boundary)
-
-New semantic: `td` = frontlit HD. Old uncalibrated values (~1–6) must be scaled
-×0.1 exactly once.
-
-- Bump `CURRENT_PROFILE_VERSION` 1 → 2 in
-  [profileManager.ts](../src/lib/profileManager.ts). Migration rule applied on
-  every load/import when `version < 2` (or missing):
-  - filament **without** valid calibration → `td *= FRONTLIT_TD_SCALE`
-  - filament **with** calibration → `td = calibration.tdSingleValue` (defensive
-    re-sync; already equal in practice)
-  - stamp `version: 2`.
-- Apply in **all three load paths** (same trio as the legacy-calibration
-  stripping): `loadProfiles` (localStorage `kromacut.autopaint.profiles`),
-  `importProfiles` (`.kfil` files in the wild are version 1 — must convert on
-  import), and `loadAutoPaintPersisted` in [App.tsx](../src/App.tsx).
-  - ⚠️ `kromacut.autopaint.v1` has **no version field**. Add one to the persisted
-    shape (e.g. `schemaVersion: 2`); absent ⇒ old ⇒ migrate filaments as above,
-    then persist with the marker. Do not key the migration off heuristics like
-    "td looks big".
-- New exports write `version: 2`. Importing a v2 file must NOT re-scale
-  (regression test: double-import idempotence).
-- Do not clamp or "sanitize" values during migration beyond the existing filament
-  validation — convert as-is.
-
-## 2. Runtime model — delete the ×0.1 layer, add channel HDs everywhere
-
-- **Move `FRONTLIT_TD_SCALE` to [calibration.ts](../src/lib/calibration.ts)** and
-  export it; it survives only as (a) the entry-conversion factor and (b) the
-  migration factor. Delete `scaleFilamentForFrontlight` from
-  [autoPaint.ts](../src/lib/autoPaint.ts) and both call sites (~lines 1430, 1545)
-  — post-migration, `td` is already frontlit.
-- **`autoPaint.ts:1633`** (`totalTD = Σ f.td × FRONTLIT_TD_SCALE`): note this
-  currently scales raw tds of ALL filaments — for calibrated filaments that is a
-  latent double-scaling bug today. Replace with `Σ f.td` (now uniformly HD) and
-  check what consumes it for a behavior impact note.
-- **Shared channel helper** in calibration.ts:
-
-  ```ts
-  /** Per-channel hiding distances: measured when calibrated, else derived
-   *  from the swatch color around the scalar HD. */
-  export function channelHds(filament: { color: string; td: number; calibration?: unknown }): CalibrationRgb {
-      return sanitizeFrontlitCalibration(filament.calibration)?.td
-          ?? deriveChannelTds(filament.color, filament.td);
-  }
-  ```
-
-  Replace `calibratedTdChannels` (autoPaint.ts:406) with it; drop the
-  `USE_CALIBRATED_CHANNEL_TD` flag. Audit that every blend/transition consumer
-  (`blendColors`, `calculateTransitionThickness`, transition zones, optimizer
-  scoring context, worker payloads, optimizer cache keys) now receives channel
-  HDs for uncalibrated filaments too. Cache keys already include color+td, so
-  derived channels are covered.
-- **`estimateTDFromColor`** ([colorUtils.ts:39](../src/lib/colorUtils.ts#L39)):
-  re-baseline to return HD directly — `(1.0 + luminance × 5.8) × FRONTLIT_TD_SCALE`
-  (≈0.10–0.68). Rename to `estimateHidingDistanceFromColor` (keep an alias export
-  only if call-site churn is a concern; prefer full rename, it's internal).
-  Call sites: FilamentRow wand (:176), `useFilaments.ts:19` default for new
-  filaments.
-- **`computeProfileConfidence`** uncalibrated plausibility bands rescale ×0.1:
-  `1.0–5.0 → 0.10–0.50` (0.5 score), `0.5–10 → 0.05–1.0` (0.3 score).
-- **FilamentCalibrationDialog `estimateChannelTds`** (:207): the `filament.td * 0.1`
-  becomes just `filament.td` (or the shared `channelHds` helper — preferred).
-- **Calibration flow itself is unchanged** — it already produces and stores HD.
-
-## 3. UI
-
-- **Label rename:** "TD" → "HD" wherever shown (FilamentRow input suffix,
-  calibration dialog select list + fit card "TD 0.51mm" → "HD 0.51 mm",
-  next-best-color suggestion card). Tooltip on the input: "Hiding distance (mm):
-  depth at which this filament hides what's beneath it. Measured by calibration,
-  or estimated from color."
-- **Input range:** current blur clamp is `0.1–100` — black's measured 0.05 can't
-  even be typed. New clamp ~`0.01–2.0`, step 0.01.
-- **"From TD" conversion affordance** on the filament row (small button or popover
-  next to the HD input): user enters a conventional/backlit TD value, field stores
-  `value × FRONTLIT_TD_SCALE`, marked uncalibrated (clears calibration like any
-  manual edit). Label it plainly, e.g. "Convert from TD (lithophane/backlit
-  value)". This is the community-facing bridge — keep it discoverable.
-- **Per-channel visibility (read-only):** show `R/G/B` HD values (2 decimals, mm)
-  — for calibrated filaments on the existing calibration badge tooltip labeled
-  "measured"; for uncalibrated on the HD input tooltip labeled "estimated from
-  color". No editing of channels (manual scalar edits already clear calibration —
-  keep that semantics).
-- New-filament default (`useFilaments.ts`) comes out on HD scale automatically via
-  the re-baselined estimator.
-
-## 4. nextBestColor (folded in from the superseded plan)
-
-Post-migration, its raw `f.td` usage becomes correct automatically (the old plan's
-defects #1 and #2 vanish). Remaining work:
-
-- `recommendedTd` (:386) needs **no conversion** — it borrows the neighbor's td,
-  which is now HD, and the added filament's uncalibrated path expects HD. Just
-  verify and update the card label.
-- **Blend in linear light**: `blendRgb` (:107) lerps gamma sRGB; rework to lerp in
-  linear light matching `blendSrgbChannel` semantics (linearise/delinearise
-  helpers already exist in-file), and fix the stale "matches autoPaint's
-  blendColors" comment.
-- Keep scalar-HD curves (no per-channel in this heuristic — planning tool, keep it
-  light). No changes to candidate generation/scoring/ranking.
-
-## 5. Tests
-
-- **Migration:** v1 profile (uncalibrated td 4.0) loads as 0.40; calibrated
-  filament untouched; v2 double-import idempotent; `kromacut.autopaint.v1` without
-  the schema marker migrates once; mixed profile correct. Extend
-  `tests/profileManager.test.ts`.
-- **Calibrated-path regression (the key acceptance guard):** auto-paint output for
-  an all-calibrated profile (use
-  `tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`) must be
-  **identical before and after this change** — calibrated filaments' channel HDs
-  and scalars are untouched by the migration.
-- **Uncalibrated behavior change:** goldens change intentionally (channel HDs +
-  no more runtime scaling — net optics identical in magnitude but now
-  color-shaped). Regenerate via `npm run test:autopaint:update`; re-check
-  `autoPaintQuality` budgets still pass.
-- **Estimator rescale:** `estimateHidingDistanceFromColor('#ffffff') ≈ 0.68`,
-  `('#000000') = 0.1`.
-- **channelHds helper:** calibrated → measured triple; uncalibrated → derived
-  triple anchored at the scalar.
-- **nextBestColor:** new `tests/nextBestColor.test.ts` — linear-light blend spot
-  check (50% transmission of white over black ≈ linear midpoint ~188 sRGB, not
-  128); suggestion for the calibrated fixture returns `candidate.td` on HD scale
-  (~0.3–0.6); recommendedTd ≈ nearest neighbor's td.
-
-## 6. Docs & changelog
-
-- `src/docs/` (`3d-mode.md` filament/TD sections + calibration walkthrough,
-  `settings-and-controls.md`, `troubleshooting.md`, `quick-start.md` — grep for
-  "TD" and "Transmission Distance"): rename to Hiding Distance with a one-line
-  bridge ("previously shown as TD; conventional lithophane TD values can be
-  entered via Convert from TD — they're ≈10× the hiding distance").
-- `CHANGELOG.md` (unreleased): under **Changed**, one bullet covering: the rename,
-  the single-meaning storage + automatic one-time conversion of existing profiles
-  and `.kfil` imports (call out `version: 2`), the Convert-from-TD entry, and
-  per-channel blending for uncalibrated filaments. The latent
-  calibrated-double-scaling fix at autoPaint.ts:1633 goes under **Fixed** only if
-  it changed released behavior — it's within the unreleased calibration work, so
-  fold it in.
-- AGENTS.md "Domain Notes" TD bullet: update the terminology so future agents
-  aren't taught the old dual meaning.
-
-## Acceptance
-
-- Old `.kfil` (v1, uncalibrated td 4.0) imports as HD 0.40; exporting produces v2;
-  re-importing that is a no-op.
-- `8_Colors_Calibrated_New` profile: identical auto-paint output pre/post change.
-- New filament defaults, wand estimates, and next-best suggestions all land in
-  ~0.1–0.7 HD range.
-- UI shows "HD"; typing a conventional TD via the converter stores value×0.1.
-- Full suite + regenerated goldens + tsc + lint green.
-
-## Out of scope
-
-- Renaming the `td` storage field or `FrontlitCalibration.td` (data compat).
-- Editable per-channel values.
-- Per-channel curves in nextBestColor.
-- Any calibration-flow changes (it already produces HD).
diff --git a/.agents/next-best-color-td-fix.md b/.agents/next-best-color-td-fix.md
deleted file mode 100644
index 949e7ad..0000000
--- a/.agents/next-best-color-td-fix.md
+++ /dev/null
@@ -1,174 +0,0 @@
-# Fix next-best-color TD scale handling (post-calibration cleanup)
-
-> **SUPERSEDED (2026-07-02) — do not implement.** Execution never started; this
-> plan is replaced by [hiding-distance-migration.md](hiding-distance-migration.md),
-> which makes `filament.td` single-meaning (always frontlit hiding distance). That
-> migration auto-resolves defects #1 and #2 below, and its §4 carries over the
-> remaining work (linear-light blend + tests). Kept for the defect analysis.
-
-Status: superseded.
-
-## Context
-
-`src/lib/nextBestColor.ts` (the "Suggest next filament" heuristic, run in
-`nextBestColor.worker.ts`) predates the frontlit calibration work and still treats
-`filament.td` as one homogeneous quantity. Since Phase 1/2, `td` means two
-different things:
-
-- **Uncalibrated filament:** backlit-community-scale TD (what users type from spool
-  sheets / TD test prints, ~1–6 mm). Auto-paint multiplies it by
-  `FRONTLIT_TD_SCALE = 0.1` before simulating (`scaleFilamentForFrontlight`,
-  [autoPaint.ts:415](../src/lib/autoPaint.ts#L415)).
-- **Calibrated filament:** measured *frontlit* blending distance (~0.2–0.6 mm),
-  consumed as-is.
-
-`nextBestColor` receives **raw** profile filaments and never distinguishes the two.
-Verified against the user's real calibrated profile
-(`tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`, frontlit TDs
-0.37–0.56 mm).
-
-## The three defects
-
-### 1. Simulation mixes incommensurate TD scales
-
-`blendRgb`/`buildBlendCurve` use raw `f.td`
-([nextBestColor.ts:205](../src/lib/nextBestColor.ts#L205), :221–222, :323–324).
-
-- All-calibrated profile: curves are frontlit-consistent by accident (raw = frontlit). OK.
-- All-uncalibrated profile: curves are ~10× too transmissive vs. what auto-paint
-  will actually do (pre-existing bug, predates calibration).
-- **Mixed profile: nonsense** — a calibrated 0.4 mm filament and an uncalibrated
-  4.0 mm filament are blended on the same curves as if commensurate.
-
-### 2. `recommendedTd` output is on the wrong scale for calibrated profiles
-
-The suggestion borrows the nearest filament's raw `td`
-([nextBestColor.ts:379-386](../src/lib/nextBestColor.ts#L379-L386)) and
-AutoPaintTab adds the suggested filament **uncalibrated** with that value
-([AutoPaintTab.tsx:1204](../src/components/AutoPaintTab.tsx#L1204)). The pipeline
-then multiplies it by 0.1:
-
-- Nearest filament uncalibrated (td 4.0) → suggestion 4.0 → effective 0.40 ✓
-- Nearest filament calibrated (td 0.40) → suggestion 0.40 → **effective 0.04 mm,
-  ~10× too opaque**. This is the broken case for every calibrated profile — the
-  user's new normal.
-
-### 3. Blend runs in gamma space; auto-paint blends in linear light
-
-`blendRgb` ([nextBestColor.ts:107-111](../src/lib/nextBestColor.ts#L107-L111))
-lerps raw sRGB values. Its comment claims it "matches autoPaint's blendColors",
-but auto-paint moved to linear-light compositing (`blendSrgbChannel` in
-[colorSpace.ts:30](../src/lib/colorSpace.ts#L30)) in this release cycle. The
-comment is stale and the curves are systematically darker mid-blend than the real
-pipeline's.
-
-## Fix
-
-### A. Single source of truth for the effective frontlit TD
-
-Move the constant + add a helper in **`src/lib/calibration.ts`** (a leaf module the
-worker can import without dragging in autoPaint's optimizer — the reason
-nextBestColor inlines its color math):
-
-```ts
-export const FRONTLIT_TD_SCALE = 0.1;
-
-/** Scalar frontlit TD for simulation: measured value if calibrated, else the
- *  backlit-scale user entry scaled down. Mirrors auto-paint's
- *  scaleFilamentForFrontlight. */
-export function effectiveFrontlitTd(filament: {
-    td: number;
-    calibration?: unknown;
-}): number {
-    return sanitizeFrontlitCalibration(filament.calibration)
-        ? filament.td
-        : filament.td * FRONTLIT_TD_SCALE;
-}
-```
-
-Update `autoPaint.ts` to import `FRONTLIT_TD_SCALE` from calibration.ts (delete its
-local copy; keep `scaleFilamentForFrontlight`'s behavior identical — it can use the
-helper for the scalar). No behavior change in auto-paint; regression-covered by the
-existing legacy-calibration test.
-
-### B. Normalize TDs at the top of `nextBestColor`
-
-```ts
-const filamentTds: number[] = filaments.map((f) => effectiveFrontlitTd(f));
-```
-
-Everything downstream (pair curves, `estimatedTd`, candidate curves, winner
-curves) then runs on commensurate frontlit values. Note `buildBlendCurve`'s span
-(`3 × fgTd`) becomes ~1.2 mm instead of ~12 mm for uncalibrated filaments — that is
-the fix working, not a regression.
-
-### C. Emit `recommendedTd` on the uncalibrated (backlit) scale
-
-The suggested filament is added *uncalibrated*, so its stored td must be what the
-×0.1 path expects. Convert the borrowed effective value back:
-
-```ts
-const recommendedTd = effectiveFrontlitTd(filaments[nearestFilamentIdx]) / FRONTLIT_TD_SCALE;
-```
-
-(≡ unchanged value when borrowing from an uncalibrated filament; ×10 when borrowing
-from a calibrated one.) Keep borrowing from the nearest filament by ΔE — it
-captures material similarity; `estimateTDFromColor` remains the wand's job.
-
-### D. Blend in linear light
-
-Rework `blendRgb` to lerp in linear light and return sRGB, matching
-`blendSrgbChannel` semantics. The linearise/delinearise helpers already exist in
-this file (used by `rgbToLab`/`labToHex`) — reuse them rather than importing
-colorSpace, to keep the worker bundle self-contained (or import from
-`colorSpace.ts` if the bundle impact is nil — implementer's choice; colorSpace is
-tiny and React-free). Fix the stale comment either way.
-
-Scalar-TD-only curves remain fine for this heuristic (see non-goals).
-
-## Tests
-
-There is currently no `nextBestColor` test. Add `tests/nextBestColor.test.ts`
-(vite-ssr loader pattern like `frontlitCalibration.test.ts`) covering at least:
-
-1. **Scale normalization:** two profiles describing the *same physical filaments* —
-   one uncalibrated (td 4.0), one calibrated (td 0.40 + valid `FrontlitCalibration`
-   with matching channel TDs) — produce the **same suggestion hex** for the same
-   swatches (curves identical after normalization).
-2. **Recommended TD scale:** with a calibrated profile, the returned
-   `candidate.td` is on the backlit scale (≈ borrowed frontlit value ÷ 0.1), so
-   that `effectiveFrontlitTd({ td: candidate.td })` ≈ the neighbor's measured
-   frontlit TD.
-3. **Linear-light blend:** `blendRgb`-equivalent output matches
-   `blendSrgbChannel` for a couple of spot values (e.g. 50% transmission of white
-   over black ≈ linear-light midpoint ~188, not gamma midpoint 128).
-
-The `8_Colors_Calibrated_New.kfil` fixture can serve as realistic calibrated input
-for test 1/2 if convenient.
-
-## Docs & changelog
-
-- `CHANGELOG.md` (unreleased): under **Fixed** — suggestion TD now accounts for
-  calibrated (frontlit) profiles instead of recommending a 10×-too-opaque value;
-  suggestion blending matches the linear-light optical model. Per AGENTS.md, if it
-  reads better, fold into the existing next-best-color bullet's section instead of
-  a standalone entry (the feature shipped in v3.1.0, so **Fixed** is correct).
-- `src/docs/*`: only if any doc states how the recommended TD is derived (check
-  `3d-mode.md`'s suggestion paragraph); the user-visible behavior ("recommended
-  starting TD") is unchanged in kind.
-
-## Non-goals (explicitly out of scope)
-
-- **No renaming of TD anywhere** (UI labels, fields, docs). The
-  "blending distance" naming discussion is a separate, user-gated task.
-- No per-channel TD curves in the suggestion heuristic — scalar effective TD is
-  sufficient for inventory planning; keep the module light.
-- No changes to candidate generation, scoring weights, or ranking.
-- No changes to auto-paint behavior — step A must be a pure refactor there.
-
-## Acceptance
-
-- `npm test` green (including the new nextBestColor tests), `npx tsc -b` and
-  `npm run lint` clean.
-- Manual sanity: with `8_Colors_Calibrated_New` loaded, "Suggest next filament"
-  returns a candidate whose TD is ~3–6 (backlit scale), not ~0.4.
diff --git a/.agents/print-findings/2026-07-02-logo-test/findings.md b/.agents/print-findings/2026-07-02-logo-test/findings.md
deleted file mode 100644
index 6113e2f..0000000
--- a/.agents/print-findings/2026-07-02-logo-test/findings.md
+++ /dev/null
@@ -1,89 +0,0 @@
-# Print findings — Kromacut logo test (2026-07-02)
-
-![alt text](image.png)
-![alt text](print-photo.jpg)
-
-First real auto-paint print with the measured frontlit calibration
-(`tests/assets/filament-profiles/8_Colors_Calibrated_New.kfil`, 8 filaments,
-accurate-mode 2-base reads, JND 2.0 default).
-
-Images: `image.png` — the app's 3D preview projection; `print-photo.jpg` — photo
-of the physical print on a dark mat (downscaled from the 22 MB camera original,
-which stays untracked next to it).
-
-Print setup: normal mode (NOT flat paint — no transparent carrier; the grey rim
-in the photo is a border/brim, not a carrier). Transition opacity: default
-(0.8 unless changed). Layer height 0.08 mm.
-
-## Overall verdict
-
-- **Hue placement is accurate across the whole wheel** — green→yellow→orange→red
-  transitions and the purple family land where the preview says. The calibrated
-  endpoints are doing their job.
-- **Systematic desaturation/wash:** the print is uniformly lighter and less
-  saturated than the preview, worst in dark saturated colors (cyan → pale blue,
-  violet → lavender, red → orange-ish).
-
-## Specific failures (user-observed)
-
-1. **Orange over pink did not shift toward red** as the preview predicted — it
-   stayed orange.
-2. **First layer of cyan over purple is not the predicted darker blue** — it
-   reads as light, washed purplish.
-
-## Analysis
-
-### Weak-channel TDs are heuristic floors, not measurements (primary suspect)
-
-Both failures are thin layers over a saturated, differently-hued base, failing
-the same way: the model predicts the top filament's complementary channel kills
-the base almost instantly; physically it does not.
-
-- Cyan `#00b8c4` fitted `td = [0.068, 0.354, 0.373]`. `td_R = 0.068 mm` ⇒ one
-  0.08 mm layer transmits only ~7% red ⇒ purple's red should die ⇒ dark blue.
-  Reality: red survives ⇒ true `td_R` is substantially larger.
-- That 0.068 was never measured: cyan's swatch R = 0, so the `1 + c×5.8`
-  heuristic pins the channel at its floor, and the black + white base reads
-  constrain it weakly — the fit's regularization left it at the prior. Same for
-  orange `#d83400`'s G/B channels (0.137 / 0.103) interacting with pink.
-- **Actionable:** recalibrate with complementary-hue bases that stress the weak
-  channel directly — cyan over a red/orange base (pins `td_R`), orange over a
-  cyan/blue base (pins `td_G`/`td_B`). Accurate mode's manual base override
-  supports this today. More generally: the auto base picker prefers channel
-  diversity but chose black+white here; consider whether it should specifically
-  seek a base that is bright in the filament's darkest channel.
-
-### Partial-opacity stacks (contributing, magnitude unknown)
-
-Auto-paint stops stacks at the transition-opacity target (default 0.8), so
-regions show ~20% of the underlying stack. The calibration pins the opacity
-*endpoint*; the *interior* of the curve is assumed exponential per channel. If
-real filaments scatter, partial stacks pick up unmodeled white backscatter →
-wash. Cheap probe: reprint a section at transition opacity 0.95 and compare
-saturation gain against the preview's own change.
-
-### Emissive display vs reflective print (irreducible)
-
-The preview on a dark background on a monitor emits saturated light a reflective
-object cannot return; deep blues/cyans suffer most. Even a perfect model looks
-more vivid on screen. Sets a ceiling on "matching the preview".
-
-## Phase-3 gate ledger (scattering evidence)
-
-Signal 3 (stack prediction failures): **one entry, partially implicating.** The
-wash direction (extra lightness, weak complementary-channel kill in thin layers)
-is consistent with scattering, but confounded with the heuristic-floor channel
-TDs, which absorption-model recalibration with better bases may fix. Signals 1
-(fit residuals) and 2 (merge reads) from the calibration session remain
-negative. **Gate still not triggered** — retest after complementary-base
-recalibration.
-
-## Follow-ups (in order)
-
-1. Recalibrate cyan (red base) and orange (cyan/blue base); reprint the affected
-   regions or small stack patches; recheck failures 1 and 2.
-2. Transition-opacity 0.95 comparison print for the wash magnitude question.
-3. Build the metamer-pair validation strip (still-open Phase 2 item) — it tests
-   exactly these cross-color stack predictions in a controlled way.
-4. If failures persist with well-pinned channels → real Phase-3 (scattering)
-   evidence; revisit the gate.
diff --git a/.agents/print-findings/2026-07-02-logo-test/image.png b/.agents/print-findings/2026-07-02-logo-test/image.png
deleted file mode 100644
index ea2b7cbea2d69fd0bce6cefa4422b6df781d7f49..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 68424
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
U+a0v7;11SxB`w8rc~kWN0UJ6N6#xJL

diff --git a/.agents/print-findings/2026-07-02-logo-test/print-photo.jpg b/.agents/print-findings/2026-07-02-logo-test/print-photo.jpg
deleted file mode 100644
index 7eaf0312d6f427394d164c74439e3777d7d7a46d..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 496982
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%0A-oDsRHG7^<{6<PgS_Max
zebN5_BkP`nl%=c80MvFt=rS@$D6RQLS@k&5G2d~h{p08}!TW#hxIV_{+Ia~rL`NU|
z+w>VGSw(ik{8ju+KFEi`jqj?Je4s6e*ZxF)Lq9j_I)-?a2uU?Dk(hEzRoUln)cTxm
zx2)<qzOqiLX}n1q*^g`ds))!&5Re!<mLJ$bI=@Z^X|=ZMrF8}BMKRMJk*NG{eZL%}
zUS&vG$QFFnuwM1vx#OQqlCtO;i5u6yz2gBUkjj><4POR_Ig2+mC1h}utEe;?Z_mFw
z{5#{XRXRrfD#*ezY@<~ZT>UTMoMa`msz!l<DgoJSZ^`ua_Q^Xlumad7^v3>J9Py{~
z4HGxDC<o1451!f4ge1G{qkyM#oXZ&2pWHXQ_TxF6vH(f@pwZ)N{SE^~A&FVRP$XSD
z9l+Iprb(g}s;{cWovTUo$1=Q)Mn(~Z(xtbh^u~?@Ji!(+#fOz|cETjFmY^DmIzS$|
zNfp`>T9m><((HLVpPtu<TT>fiG>cs(_vbl_0Nku^<_l+VFs|21(bkZAUEbgCIf0R^
zDco#5PCU~R1Jr6HP)eY!#>3`l@9&XqKn?WYJB~khfHgLs4R|K#jA5!aFpxpLEIq--
z3#EsM2cZ@NZO-R|lVY2YthRQ&@QQdUpr(>qn__(jKkEvrYG!#06w)-&1&?qx?VPc&
zD*RY2M__BVAT6&-jXIjP-`ku59egnxp$%l~2Y+Gk%5?{-PNC9fJ|twTlGnZNN$<JC
z)5WYiKlLtvTiuA`-hi|8#dAMS?N<Xzo@8CMDc+B^z~D6Em}p}o0LuDY5Ngie)$#A}
z0tls@v?}V5jYX>HRqyjW{4pkp))aSDQunskL(~n&esW+qR%LC7rUJnOZhw8SC<-bN
z$Xw{8V&8PwJB|qEhTQzIs7DbpL>M{IsNTd4>Wv;j#ARfK3mqT}0PIbj$oh85JFIBR
zG&-xAV1F&|w%HVv%cY!Z@W3jhat{5yvSQ>?0RV2qcFL<XfmOh8MQN(7{f9s26T@c;
zR?8iL1Asr><wZnm;!=>{wvbN1{60SU8JS*YIu<=gU<sx6-tg#FTGGVnChvTwg7S2N
zT|t=!ogqHzSo2@StJi!9Yjr?Wn^wI%0qOZ?J1_*;T~;V_Sg-5@F9yZ{)hCHS5)YIO
zhQ|TpMp|N^h|RLMelbSBBWd8?*+5kE=TMOU0BmQlHZ>2S{IaZDs8{e|kVb^NDh-u;
z5_#Ir=hp)xFPm1t4XYVc9XpoT*y6EhR=(qJ_kot%VPdas{<s#6b)%IO*TJe_Prq?^
z{Zb>cyip`7LZ+R1ix4Qc%z}Ld<aKFKx=1Q)?Z3|+KwKou{{VQAr@r0ru2`R^ky=GM
z29m%UG<VzO-#Hm|J(goB(l?{eC;Vqj^3AD@DxW|UeLu!>=y|mp8b<WiN#e)Pe1S+t
zATkgDuQ9#HKArIjfW=LKPR6RnGSF6IMTL+LKfV6|4CE2)WEue=>H^Omm_ZL1Ww_CS
z*r>lszt<)~Bb~2|W(!+`q=82J`us7VU>r80n^Kh)Y~@gIyKbbO5`_<Zd1Nz0Wblk|
zBWVRii#!5*osZ*)Lpzq3wW-o|1Gl%~g#=+W0B?2YYxVyCUf2sKBVrXt8*Y2=in^$;
zI=*Ks(>RIU&xYPo2Z>dF-uRNC4BjrCds2!!SGGV5URRKkN;dxhTqFZZrCE=du>Syf
zB~^_OEV{LebpHT}2akVWo^r85LZ|__v3p?-y+)W?8U;-@s<s^L4{N>t0}^U?ETAT;
z0Y?}cZ|q%$lUL8L#}!T0hOPlP4CD$V?_Qi_=&`R{eF+%_*s!|WYr<5!e@}omvw_|S
z(98{}V7~kR0M<O+M2w*s$xGFwZNIK40RI3{w;Np?R-##yQWJVhZ&_5)s0b>H6TN^y
z`rrdYu(c#@eTG&q4)_It)DQfAKZa*5=kgz&Q8+<SBRC7FxI0(Z89~#k)kw2s^PFQY
z<4*T{n#F0}RSM0roreHm00AHp04JKl0M-KrDh}1Q6&jR1hAY{x&5I*3d#xwXb{HJs
zj^7LnTrds2ep$|Zl%$ouGSDi#awEkgl9e7A4O&mQt^WWFf@<N245~-uF_uRmkO5wR
zU(XfClvd4DcmwI35M5_kVhaBNZ>|S1WguOieekR40qc69M|=0h(^h*9Fe7Poun)vu
z1GJ_`cXC<J{INn2_l0(^OsukrSib%tHb77me1=X*3wznUg<uH8VZW#tiX&s+8%d0Y
zzk$5xRniK!=VB`riBqS2w#o{a!oIM?k>%UH;IX6vp?yz$3c9_sw-J-4y<OmTfE2c%
zJw5&y+h``iHOG7eTB$n@{@KJU>Cy<jte$W=5U@MbR>H>k7J?AV@IIKoberwAGuD+N
zLVZP5U~(z)+L9Y(9;Ysvm#EPxSb?y>t$;gik(J3s<oDwPIMOz<c_)*B#924C^>v)V
zQ0Xmq-mys+L65!QVSZ~L3&0?#R-!lB@Bj_a<9u>~P+1m5fG|c>3Lu;UCuqSDmH~wv
zQ$TJBIn1C}n^xV27)jD-5DjuLfkR%#_RehpUkBegYhZTx;A&!fR{&srw^0}*ol4u9
zVPjSLXE#oK4ORu4s^|7{ki-$ARsrwt1GQuIkJBEaqEe~=)TI9aclgMx@8Tk)j6&+A
zATGdu#yWK>vnx7M{{V5ZjnsH@&#E<Yr~o$I^Ei#mld6!9x(-kyjaE>=`F7v2&16kH
ztnz9g3RAHky|X+~x+n#T>fBlFl~<V_<h4}#3<<nX9+@O{P{xJXBxPU_KwVgdBp-3c
zMsBlPtFcm1jcv{6LW(9v0m_gy2KB((2o9>OV+cm&M;@g5k(dspLn>)kwFN-jo-<(T
zAcELN#mOZXPQ%##8H~=lj4Xg^H|vmWm_J(pd8K+prPIB753OXArHA==<XIBPU_d6$
z*JM^SETp=#i1ix*b`|r)T{0w)6|&oVj`>GP;fgvnjY7PX2sm}<nt_O^CG>zOeS3T|
zv2@;PqmlKh06zAeUtG%=NPOj(5xOqKir`*FQUYO@#Mfas01>Z#-z-*F==6oOa0a1!
zhCFec{anT}5|gKTwcrnh{4Xjxi27C+a)%aMz6Nm19NHz-Kmx6+Rd@dYId2$sy+l!f
zflUJ37AKNx+~i(1E=I%yL(pxN=n#ly4Qc}FQQfw@A?Az0nlM<V+Y7yo8XsTB1aUG+
zs!-9F`-%tNs^28?1#OguJ6e;AKTz^T6oe3|vmNM@TOI2ITl8WDP|C|Q8eyky!mDlh
z`eHI`jXI+d@ZxRc(0st1fv<3X9M22Pp*83_PM{g8@uP-$M6-F;hN}Yi{Xa}8C@Kk6
z03ku%z7T4Cw%mJH@0@<8UyAcaKoWayMGi5b)Ql@ngckSW{{Y1tQb$mW6S@T+U=?@y
zn)nPM<LQ~Sh)tRWYlh!_y?@3!bh_X&1{HQuTw8P44@)@!(?Ujv@W46&t<TR4T}1si
zP}B6<#;PQ)*Xwk4!l~3c9d0$n8MIZayY72-{4=CPG|eh21!1MPtKzEuJNkR(f94-j
zL|nSFYhhPs=kY&WsErIC%mP8y0Tu&%K>B0~HHg?b0T;^OU-yhw6zLLOQ8A53I!O#k
z;`ZLF8>mCmDx<V)li6CMdwLK^JM*{UnbkxqCr+s%s}JfSJo+Ek0i&rTMno-5q@DcV
zET>B_5l91-a!Y}G9qzrovVJsU`USKkV^BIpll%9}-%X%@Dy~H-B$~fb`QSk$zOp&q
z2-+0eLjs|;?^Tb}$ErEqBxFiDx6()>alYQTjVnhauy`6*P;D2$tWKRgDM~(|F7&qB
zAC3ZPRAiA=EG>|}*ZcWnpl+f?MIh^Kmad4eY<OW4MjhnRP?9u_{ed2teySMMj{xY9
zrMeMReMbKP4YG)J9bbydsx%d51SY{j=kfjVmpxKHOr1A{PF|#)$vT&{fxVAx%K(kU
z#w7mDor&_Ef56|@HinHR>1UE4#EW=|D|%}8{{R^VE~ih5`WHwW5_Z%_B91%5D|9A8
z=}P((U7h#567^z0Rz^~#wKpQWSL66&CsII|I7UU?6|RNd5It)GvHt)o4?;~lyn@^Q
zBalV&>HDn394^Z?v-dWpI(vS+W|oE%(?c{KAUl^D00FPo{{T#aqP(6ji>L+~mi*fh
zW7FY+1VB0~jyDV%Fizie_aDDpT5;7YGzH>Pe2msEuaTO1ivDIt0!4-OcxVM`UqQ`#
z;-rhzOssz4J0RJ3s=}gXSDZ@$Xv&o&)zLiODj4IO7Itk7Wroaq^Xr;b5;<g)EOF_N
zS9-Brd`0uN=MquV9*!4s{yWL7nNFY<s;jZ%<%A;#npbHhk>+UHM`mrw{d1w|<CM*0
zykG}9K(V+4@A_qWNDqWp#a|tK$d+x1HRapjaZifjkt1^@J4oPtOKryZ3)aI5JSz$v
zI!l7uMULI*d@xQCT?9ngP&F@@KK_IX^rPr`$)hY?NDi9SRGV{K(BGcknO?R?%EvcK
zLLi}}1Ew+n^(SMw`QQY2x}K&O;zrV34FnI*<L#NlEON}M7K0E;Thec99A9hAPaDV5
zf>IJ)fJrRs70nI}f;k<w$s`^hOr%8qW-L^$)H&bxSQLmxIyYA~$Sge)2`7>0em<E_
zspaY<jak&Y03;w;QWt)B;`a5-@J9(y=kIPLvMEmhis#?;%@IU8rkYs1C?g7FqP~D|
z0Orkn@Tfo|kU*VMHiiy7NX@ev><_2-%b9wZVT3v<41^VPWq@u?9q9i6`#)TQMM;B3
zh8W|1=Z&`)nmWlH`Z!Cpo-9d89D=A4Ng&?h{kz~s3BQ@?B7#1g_{k$EWZ|_9g?jV!
z7|8@s!{dn*78(K64Ol#jzAt~vY|OH<#$%0iFx)lszvH;dEEBUc6=aD}Gk}x;AOUsi
zE8~PTax$q?0<$u+YHQojir;I$mQ{6^AzE!d7+|A~AKVYN!2K{uGb~b4Dzi49FWp^-
z2L3iZhIAqNQg!HABL!5oY2<=E#n`cd7!{I#9sscTbOQ$-Tj1}<eAm=;()3fcvYw}>
zks|^o6hQ!!u;%u^T!yyPSVy3{PzpSt4nVL?k}CfIJIxaG;xs*cYCIM%3nYYs9YX5%
z<*Whe#udu3JZ^uNcQ0-j`H3S-JAEwgV}ERv(!l7Tcx1xf8mf6if8<YlByMQ=K*)5n
z2oiXiRGGj4w%Rwl2jy9AphwsBGR%k|h!r9@$!gpHxAP|fXZtQlCz2^Tgew{sl9&*r
z5&#~i{XKGT)Ohkdid9t(z^>#Cfcj%Jj3$uCJi}_SPId#{$2|7SOVYv8ET}aXDr6C`
zumK8JakbU+wghA>(L9KV7BxC`Q6N|Vnj8J@cJGNCNYjLq#7U74mrn=3e@i>#buQ1Y
zIN4WAh{k{cDlU(|<A@5YmX}ku^xA+e+n;`S^se|1{KT;srHxgFf;55-+gRIv<2rJ%
z%E!ccRhvk5QA}%l-<`%k^5>;x>7-DCa~z}sK>+r%>~GNXk%mN{#r|x_ZG!+wJdg?8
z^IskX?SXL{Ld(>GOpJ90v3FpT&4IYzZcnC7mgHdqY6{0lLCHP0+<-473b1Q}6(lf9
z+j~1$Jl%m_*=Z5FDPq$%m=;HBu&gU@h0ytX;8&=XCF?awEP@RT#NDvF(hD9=!v1xc
zSs{uml2$!Th(SWXbnRb(JAN6zq=o}5kaa#Vl0zDWQEtz<*?8brwyyb?rRe19IzcU{
zjbwEija%pjiTRJ+;0~Ersz-oMu|UIHlD67Z6Z1R@2e$`oSj>GlRTHy`7DNZcDdHH;
z-`aL2)Q$adB$X#kpz}2d+Re294&OWZeR@8wN9jjO%}ILLRh!_@J<X2$(DcC3)R>Hp
zk;trKreXlo$pnLZd6yvoHxYRiMCVHvkH{5ho37Re9*2(Zg%iUqA!Ag)sBLx#BJbDy
z<P}v>iAIe>1p@DTvJW4JwgazKC=wQBky<uoKmHED2isLp^c9rqCZDJ1;|?A*g|$a)
zY-><<9{>&ejA}^w1}_yCAgERZ0tlj3xT1bPT%S&)sx10RcC-eK-rM>Q$mIzxl43+;
z7Mis2;hWeUw=@U;0DbFuqp0c-ToOz|vju020v~a`^FRPV-+i{knfHo0qYWW1G=)=l
z2EOqd`k&d!FHDa(68O3e(IZy2^c;JAa2UoklyRrSMP?*#<_ZOZYK3#}$=e=ej!unV
z!~>{}yfY94>mTyf#di5%>scb0fK4@qV@BJ(ZN}oi40(K4O>RR+3u!EkO($S?^xNTL
z?#=*}76&l0kQkejK(0>Xx!hMjmQO@*h|h|WF{fmz3T~*M@!7K7Pgt{b;wYNDM+Zp&
zvH`0|)y;W{HA4GrGc<Ad?cvi(#D!H}PWuom-|K<&pZa(-{{R<sa!dEflEZFE5uN?B
z_1TJ<(R+yh08IRw{{T*rqW&!DqtJ^XicLhDBzSG>zs!18ey`Ogo}hufMy+GuKhA8U
zpFh&D5v2(t{5C&{%L>??stnBlrLJlsa^{Wy0Q!(KYn`KSHvC31zh}4q06Ww#tYF?{
znEwFoi{dp0E%taL?GB-bXu!>w``Q^&JDOdt_umR#Z{HD^o!i$QDq+3fZ1pYS)hYr2
zqqpgVY&QP@tP}|29Bcp?u2@L$C}IV(zEpWZzxu=gUPdohrbbSc2d?-*-(z)@O_6V5
zr@zA>qU?>1bIU~eXjVJXAY(m*QU;<dfs<D^T#Rcf2RvS4Lh6euE3%M5;`lh)0U)pT
zgUQ4aS<*N>k(>{dX&>9T^vqOA0gZPfCdarHj%l~r!Ne`AYOEnc5W%Xz-zvUis;gs&
z$}erkDiU@)SJx<VX<2o0!;b!$BW&A^ho(7Dci!&<ecK#iT@v}#yJ`TOair-|qhWu)
zrU;su6b<h0z88#AmG<A}a*xlyjAcDn@y|?(w6S!^Ht)&LW2$xyFysKEJTJH3#{U4+
z83Jr#jTHX?_rLEw-lc-H_1KK(x0RO()WPA7QNjE_))@dS<ck5rd`4&Km8F+u)u><L
zmDJTn!5e&XF$F{tIk2SeJ@Oq~=5&cG%NROGzpfcKHb=uJroAf~Hj+jSllMp7Z(nTH
z9Bf!M4Mb9p_zVjf+Pi(#_xH;SMbb^TF5jk9+k%hyogmO3@;K}QDFl!Fi2SpZwOQDm
zhyEiZ_QX}4=|^&K#$3`%D=aXNJM2BP*@6}5dSL>2h}`?1T%Xzf0O+IfB&MCl{{Z-p
zOss|C8ivj9o<}>Azrv{XKF@7mXQ{i~{&`?Lq<~oZW`D9+{{Zmuw!w~F=|DUWUf}16
zZu07<g+h_G;P<hVK}g>bl053w&m;BAK=&CW5xE=Z7bC-~5EFcyWk5hA?dgid8urQp
zGy&gy;IDU3qpOP-K#n`&GZrOLfIJrT{{VSS7Hl0m)q7&fx(bz1wUT=e_nRRDX7WaN
zUtiZP8iv!kI(zz@ohOKl3G;3TzrI{YpjGe5&3SF8(`GvEP6!rQ*SWwJsjmi`=Y9CX
z2>$?C%;_J!xj#PmD#`ZzbE}TWIFdohAy{$n#O;h!;B3`qP6q)%cfojf`Q|WzRluy`
zeKVT&_0AiEnZzK4BXhXKW;o4U@$k<V_?!5Tqy8EDGETp&ZI@(0_no^a&G_+6?G>vT
zojl*;zvC{S_)qNCZA$%Yszea_pHu8J@cx6P>VDt*LHfS7N0FViOCuf0^vZR;Z(sal
z_S~IkR>ZTNm-}N*z<Uh(@3TJ4kE4b(Rp4#6;&bl(FVmxsPX1-(@^kOBFVb|8!x%*Y
zKpnrdW}ruufqjvGT<t0cs2uy8Brzv|#BP7$Gue6NW){PJBkwn_u*}js6R;YO-5!J2
zDI|(F{{ZQON<ZX%a|c({tT9O}k^~A1JCi{`!ox4xe`!PZUrPN%@&OuhZ+AX}KPUTN
z?K%G3>rYcNfLekj`A~1={{VTn_>cID{{W5kQa+a*BqE?zx-ER4az2%wLnfG+d^%+T
zi>bQY52rs-nyqcRX-#)m#D)5J<6fDAMqQoM>ecCLO#yT=2=hdRqjIeoyHi!^^Si<|
zKwjt3tM3)CSZ~4a>-5XPE{>SQfy$AstPlfvfY=Z?HVN)4j&N;d-g2SYf$u{5bMf0A
zNnMsOUCd|+TNR{tp~oQP=ZM5skm)I@PkJZ6&jTnr{K^0aefRzC^}uLlb!}@v-k@u6
zcjGP7%dUBPn7U#Df)pm=I|h#T$FH_$WNw@kbsj3Q@4ApjBjkC;XK5BQ$CM34bnQS^
z+>N<D_zfaS8Y_kJ$S5|Qi4|h|o(cHmVHVzS6b~(vTDRi<c}YyZMl~OhR@!{E=sib%
z`Q0h${{Whd^&!tp2-X*pKh6*)e-#m!sL~1|g`-2)>VF(oWkw~|$16vlo-2|71lT+8
z&QTD#)#0fDdEh9zyab5=m30`!xUk$2>$hxYhD`;z2rjRHeK8pV07H4bhQpurl(tgk
zTI+p|<m3}}V?YfmdwTqSnCyjBlXZ}i4e&j`ewp9XNj&>`NT$9>_W0f`k{KPO)O9xI
z+V?x1@~e)DBW*x~W4}14Kw!=HM_?}T#48{rSOrtL^*FF9u__#+DDu*isP-FS6q~7O
zirX*>4wPa|8svOvWVJ|RKu)w$bgl8+=GEw(RtbD2l_pma={k!L4%=`=f=9SL^EZv*
z$R&-8J*f!?d%h1F{V*Y@if%~Xe6S)-Dud6k17T$Izt8f)D0gBMu(M5jZ-4I<g2)3Q
zqPqn>{r>=dm<8CgFlH=R+c!6l)OloJ%#xN0b&mT3x8!~ACw?mhZ!M5^7eg9YycpDg
z>Oo{;zz;Cw4*VR7=^0E)rpN@9B+%Z!!Om~!_<*7Zy(}1Cw%?!SgJpJ*2=pf5OKeA=
z-uvMP#gW@?H4sN@ztbq_N*M;Z0w@=#FVE}S5-AOa2Tqa?HD33Cm1Vor$pf3<SGRnl
zg@}YkQ>{QP>4X_zng~E}@vFH7TWe+i02;p>1zrazjxLIlJqaL#`|p!Sq6ocXaL0jP
zv6>9v^hpc!$P_i1cMR8CUDX1+ZQSm5pw8cLGaF*uWf_-AaI_e0MDxefoJ3W0CWvJh
zSKhzu<iW5m$n@`pI>t(yVO6Vh@;&+69&ZH5tr+ms(z1=fHNN(LXBC*mpt=KN?)q)9
z#gW4VQ>#j;3NGvXZ@<qVXVAMT1U(zQ{qGE}!1!XBHL(r_YT#ePY*@mU3R;7FNy~-)
zl#G1ph$~44K(H^{bH}~}^}II8q=r@?*ET5rxRJh@(Tb}8e(B(hsEG9eOi=_BBLh+M
zH*zoW?UG$_cyhMC2-*f4Y8}8o1Nh(<(Hx<MnE-3kzLo>=ql(JH;{(h-^%48@%Bytp
z5_*Ji3J|3Tu)uk5+UoLh1aCEguFWTIcFKxtSrMXLnS9p73)liHBCM>sWU;l1-{q7^
zrASw&F6JOv!UMzAU*Ixo<|!GKLhL~vm<(L_WHD_71q2U!{{T3aspVi;5P0>#9EbDU
zg#=aXGLe;|sGTq6Ax`^I$R)7vL$J%qD#{L+$caF*wrQ)MpXreR2d46i-zge1*g9hZ
z$sNzjz66LBs2bkD%1V5pv}rB6l6V{B#e~>xb~fKDEV4XNM<bU&2~bbnB=7LTq!=we
z+J~<D<D!DQo<Sr5XW{LLXi(<4tW{FPb7XKk;S8w6pDvpn`)2@#O4YF7o(4aMF?NWt
zQVCL|*Bz_nlU*R`p=92y3Pzv}QfaEx0X+L;*qd)C0G++Eo*OgidjU2+qYTXRJ85Pi
zMF7N-6l^diw&b&vwH^Ne3~6I%TnQGLg_S+8jOCGrp+kBG{W0w|pbe<ivsZsiDH3Lj
zSdP@NqeO#U#x0<XkPe}?+*kR|ZB9<A1n;&JGlXcvGOJN4q|qa}_vh=C9S~hawN)L+
z;{XaJ{{WhC=uUMKJl}VphCGT#g2|;x0I3^y_xNNIAl{wmb|;MC6}eDX;#g4m<48v2
zf=NDRJ<d7<8arw#$|{Hzlq$&>jTcRj*2MQ7gA-dI(O}sPb-&j*rm?64q-=c#cZB7Y
zRSmsq9=QWT%#Wx5LhN-50`rx$)rzicbDb=01dSVw3=I)?zD<cFwouNit7GIQ$sMzp
z+gQ4;dD}Xfw4xH)x1ceVygC$;3bHKF{J6j>(HmEdg^#`5AHx^KIsgW!^N-UgX*Eed
zgcS({3%_ie5YhkzFQx$?9odJj#{rd@MyDi=fb<!|&PW2Q@Wdb=Tn5re56C@-I1!XJ
zvX%pZee#fly+{;R`|pUsS;$M$IKFTg%cvXRo1uwbZ#9jxm5LvHVJj#gPz)&GagR)F
zTu~ofP7Uvj{{VXL-+Wfu^qUwBthIQWijFG*O9xG`_;H+A71Lx_7l0Cm!9QF8ciTu6
zoB?gCeg$K;<QBd7ClPI1Zf|Yy3nNBKy0Ve6)wTgdQ5jLHX9`M&Cbb>&o;n4I2E99A
zPQB{^RR*jde%L@EXzkozd~ng|D#|a{z7VKYZ^&7$#o{ySB<TYG01T@$SaMI8R^9SP
zb~G#71MUlgS<=}T*PLf9G;OF7!+@$k9A26yc}z`I8-HxSQWiOYjkOcz3^v}dsVEac
zA|f`r)3)UNutrBt7(7~u6{sFErDjo560#Bq2fkORje?hVV#`{%_5T2P9(zY&U(6UW
zG!K_Fo~0POxeWF;J@EekEd5MqN`Fi?kXM3nQ>IS_M^@aB6jk71)#12WwLWSl$F^#Q
z89LRFUFlMEfyE2LkuOkEBA}WyY+rBPV?{H=D=L;%X3||w)m8p*I%ke_N_Rql3g>Iz
zIfzb?5?0)krBsV7KjbkwpXoCNI>WHiPo`RUms$mNVuIO8{qKOT>=8tZs!br#91hr>
zDG55gnALVWn!fjxX^{0sRZ$yh&_Ol{-+#v-bcqr+00*ny_Otqo4T>99g^`vw^J`<V
z=YRL{$;RSX7AJ`jkd_kfefIc#yJl1?A5g>-;kojuuxqvZeDR1AGrP-57j5}B!N4Xn
zAk!lNF7$)8-r0BQ&`l6;55ZBn;2(P*Ov;WVRan`}yAVqOKo8l<K@>?Kj%gP|azNcj
zujBY(O+3)aCXg8G1o@4TX6#qXoIVQ(q$H{ost;kg75E&@5}=KQmTcOUTkW@fva1;Z
z)<W711A8B)L4Kz~{{SpUPe)GSSe9~s4lvG<Dk_lCDFl^1+mFZgGdnMf)d-<JBB3F7
z=ie_3DJ82OO;H38cE64WS?5`$S3D0YkiEao6q#gl4U{Ey72D&+4zs6@5R9S1u=4Fz
zEB%e|h+=ITW&>eWzW)0GUt9}MEGyP%jUG5y09BiNu6U}w$2@n%V0v=Fpk@)C=X&>{
z*!RedC&UY9LEY|ye5-8R)O7b8kI}RES~W^_Yz6*YU}x)LR*DTe*KJx`a6QNUVKPSs
zmS|MS1riAW_9x@UMh>J(#pF7KOQZw+-0hAbGAoC0Ke!Gm{V;<znPX{@4&+e)*!3Tt
zbPgVP*{?`o6a!^XADv{3gQY+fX=69{tG-eh3z@H$re8PRCw=g%7^3T41e%gnbFOA>
zh&}uJeR2|Ni>Z=CVDYIU$K59Opm`i)LglZ+FIshZE91Z6h#aVRrn4Pdup8~h*d5{N
zfnBt=qSV@a*S90*ho<TrA`pYg<XWw-*K0iDbn+z)o=dW#$g2D?pfR+XQ&KaKG{2hv
z0LBHTq0~-=pJvj)@CW=&e22>+A(bOYLZFa&bphsYh2wPnGii!-c4b*U^Bsj{hgS3T
zFFS$%04Hjy6<(Wm$f$TmX(LTxULm9q06Iq`@n_@uVnquy(o9Jrh*rI;)K<d^^$RSM
zGPaf^o-a^5-{*?H7fSMka6>kRCdz?WL!<~>c7+rsq6q@*_8s`(V$D1CJwr;~Q(8zH
z0b6}=lunc-#96`n#1Jp%gRW*m3q}&nog-uI>4B<fmKjVlA05gMyC7ktivv&{vpiae
zmMukhT}m4F2fcGdVu@8^i%N#Ky#$*hd*c|hJix@O5%CEOPW<dJG@~p%O)9L=A{{Zv
z2;^>P9!Ke!WI`XrfV4r{^{&<HzvG&psOl92(}s<|_Q7Sf3P-MC>LriGPzh+r8!p6P
zgO>?21bF4})q=4b3mp7?kK>${5mq={$g8_1)wu2cD;avo<wJ3Rf|k{M&A6|a$j8-9
z2UJ9s6%8`3#E*aRfqt{8dB;nxO>T+1HH%_Rl6&^Z!zYFsHYmh3kfQJXZH*?5qFCf=
zffx{=jX+oCa;)(eO%cY5tEkfMN3Y|?0!c81q;(PamNrpf58v!%I;{yGOcFxT$!JQb
zwWG$>eD|!&)<<k+hfs){v&Wz#+w#plJL%S~p})8ZKJC@s_1f?xoi4c<*Th!`O|t(0
zaI;%p`(|~4`pDcUP_`_P1)j$Kd7>j2Dd9`0lkX`9ZMQd_{JWp#79tiXfGnD~`3_D5
zzRjDc>1J7!okG+(7qI7@v8I{bo%*GhZ~`wCV)(7QW50%4FA1N+KnPMb0(QFEzBoFU
zo2s0$C<!AHfRHF%P#%@FU^nv$qAQFd#~Q1}L(V`xYCidvX{1uuC*Pvg*!KBWdJoaR
zM?A1~QN+d;r(Jb=TBsjet}+BPQW;7OaOf(bZ+fy1%X}(*KT=}2nlUVMtFr<~rlJD@
z#gFxxCh159cVcx&VW7gz09cSdKb~Z2ZlDlp<D~>_FLTJsqmSkci6g=tim__CCvo2c
zr|G|=5s4w4`i2K^K~f17!1@D~>iS(U7Y0It(6K&SQDk1+(KT46Sm5dHP)Kz+QVkRy
z<a2lFdvXRA@W_N}l@KUk4+m}c+U$cv+>6L2u|?DMkL6Yi8499^HoFt(M|==R9jA{Z
zl#>143G~zNLj>}PP#+SiAP0zVQ5=i;n#~?JQ`dEADTKN|-J&B)qIuwdtPX&>#nt#q
z(lU@iBDB#5>Q3J*$^BlQGZc}tvmpMM;BVjK{xiCEo#u=yUxwO>kyXC`0G4R!x`r}!
z5uj4i0K#d79h$=n<AOeT5%4rlrb!n`jY|MSQEjVw-+RhP(S4fpDro8>F%jkjbFgZ@
zcCqsKW3-9(eC^@sa3A_Iup;!6<{RzF`POBQ3A(6U#Ev{Vl1ATQW1mg`09>KkXAk1i
z#_(LoES-p21M}bC8WhtMiyVz_rZx_A*e6w!@?F1Yx^oi9>SJLPr${D?s%%dFv_CwI
zeI%1B>SCn;RkPcZ@YvtK&jU>TG*B;uo*|G*`rL5gPb1(t-?mC&{JWy~J|Bj}bE?Y&
zSKHdhY;LKGbiF>sbfLE`O(8A0`D`oN@+wiwG>)Js(n~Q6<5t{_xEz0+3(Xt@rB(>*
zG4jYH7hsX*7ssa_nKYK6h)=2FS23|CN}+1*1>IHi!Oe0>A5#i+<Si%?2>>>zX`1M6
z0kM4M4G3Up_IU*=h1Eq(p4?Fbo%g`duBG*LFM6r1j_SANVe3E<>Bc~45h!<Zu@L?n
zEtMqE_}By24DoA@WwGT?6L0~$0FG?%N8{fuGX(}9r&Ot?LtbG;iT?oXfI{uf3<-6e
zcTv>4b!FXTy;{j7h#LdHJa_l_VScHTr|KauDe26ihLAkO&^Pk<@A1MqIV9?nrz|Ix
z>JX?-phYV4z~FC+@xe5*cm-i3dC+V%S=nrx9BzM0z|kD$x``%TD2^oX)k2{<fTLAQ
z_qJ2%@>!u?k$QHdR*?k6k{q*H*nznFpi$qy2O25i3cXB(hZb~NkN_7%RSPG!!%rCp
zg?gz0=>SnFW>KqfbSYp5&!6yc3u}>!$Yb)ypeQ<u`9lII@9*hnBy_Vtl9i1J1gh>y
z=XyV}^Tvc;k<$pv=`sc*an0E~0x&>trCDT&+B9I6C;?}WkCgVx1QNy5A&y2ek1ISk
z<!(;Ia7BSz@_ra*Xopha6=LxAQC?fsz1`n&?_2s|g@k2{si|p~SBODdt*g^xkdEg`
zt44xCfJiJaf%5K0>w!}-mrLjg;kNtJRk0xYozCa51KSW!sxZ?6p<7p$wWz)8{o}ym
zBRnjrBLm_KyA^wF>tg+}`lOORq3ujl!)VI%X^0?`Up>FZ1mccU)j<m+k-zqey+?ib
zKQERv-DJH-gk(fmg)D#o6bb;?UtJ*j*zaWH_30!Z$-yM+Bx;@{dPq7o4M&drbNb@J
z(n;6CuN5B;{{V1Npf&)vU^lOp1-ftLRU*{AI14FbDQ3P0Ab)KWR4(t~km@Hh4wior
zkgP>n?TOW?yY{eqdgJvy6rDd$;!WZ@_>~%l^0var9RC2vdabiBQ6Ze23=fB7FdU!u
zJ6|_}_5T3+e;0-PV;;5)%LJrRzwKdn-*ca-OD#&_w<a(z>7SSX0O@LYe{RgD!go%c
z*p)UwAb0uvb{_fqeEW3|V*G<|rftUO&*lt=Z~p+5ng+`!awAdsWPi1fAJSjbDtM3q
zuvHnc&aC?xcH2tcTkOzJQ`Mf}43was8%V#pGXDT(txeT8wr$1ohIsx^o3^oMYB@-o
zpIk{uAY(>B-#trsby;-WR#Ye(19=tP?U!C?51wk4xe-HZ-xXAs0=dVnsPm1{uCAd$
z;`14nGW6$Qp(9`IT$D?;;N=|#mSMj2il@uI+-EyLvjTp6XCB~=*c|F3Z>AmCP#voB
z0<GG%Cy|V#fI!?D7{74ovNt>6RseUr3s@W-?~FowVAKKT_rfbCfd>8qI<*b>t+SL_
z2YSam3N?Yq0Td5<#E^>G#SYj@_-D(#o$!%-Ul>wCDn%!oywTJs00_q1U(Dp<204M!
z8t;6h?OIh0g2Yk6zcc$_fBwLqPUNCr{{VV3*6L*c0P~NC8Rd2K-^cw~H@=#`{>taA
zFkLh4{{Ylcnl0u_8|=BfDIBis1y`V~*zuWTLPbA69P;`?2U^80=!5uY(#IBwx^h;)
z0>Q|_UMs}fx8K(g#uv73>ta<5@l1{e^rvy2biGEY09}cp^UB20F>^==J<0UT1r`bW
zqk;bbBkPL_l?T+1H?YPm2sO`dYy_Fbo&2NkAJaE|k<!}#06Q}O0Q$8(hptDU=s%p3
zTaW%;KHu{>>okFd0YOJ>^ZC4<i0H4BnJH~X>ztd$NYp#t5O)Oe>yAYsAR4W+!kJ?9
zKFgudmGonlk}${t?smz2m0!s-db#|DS+}LJxw<{`RQYye_??**O`a%xGSM=yDmfVt
zbWl5~*b+YjgeA(2WDs+gJ$pKF&vhg^NFZkdcQs<WVCBu_E`jGwZ(Qe_Snlf;4XCoP
zK59Md{oo|=8vBrV9_Ja9s@m0F{j`r?j&K?wJ{s!a(d7H)-vW_SS<+UG{BodzY~TWb
zUJ2(o(9SDcs&?tEbq=6!xWI>3nRi;}2<@w3+Ov(4G?AmZ$j!yI3l%`%EH7>_kyl)M
zV)~xhjLNv4a1aev3$s|<W&uva0YW?D3J2E#ZL2bfNs^le&p1xP^QdVi@>0kFEKMlq
zHbq$NF2AjZpy{OQdYKj|V+EO*&;vi8zl^_%I-lcTwm^t5=^|piJYW9t_dk|<Kl-8k
zbbj0G8|-hhX4TO|f2zoKnf(Foqx1P^pZquWH-M&DPzEB&KiV_v{TtJIBi_7saB_3R
zMxnRtKe3aehjDCqKk`1A?I=5fcK+ray|6^2GU)&s@{d95g^GnWdIA3c?~Z*eMxJEO
z++2bPUHC=z^~90sO5F}z`kYqOrmy;qxj*q4o2Z*j(DIFdJ^k{dr<%s91O6k^KR5n0
z{v`ftM*B0RV$do6vnk#~dx7jL_gU+I82<nje<Y32z-oCEi6jF2F<f)W{4?|ZqE9(*
zAH=6Lbk^Ta`|bX7UG4PWil1_fs>>r<1P%ePL7;!uTc&W6z$MgScU@WqGYi}c#FdDu
zR`A_`tN0opUNfA1<K--(mX84XeNJm{bdU+AJ_#l*dR3aLx2vy#!obBLc-d?yKYM~J
z_gH~tiY4k59<_y5E3qm8Bhc2{dyM5*m7EZk+md+qH-Ly;s+?VJN$u&rF#yG?iEE?n
z-}E>m1~IHOb-L4U+tcTck&docstN&m@9SS2ATktGc3VbLL1S9G8u(*}SXk){(3R2W
z6i6cY2eI6I1_0}*EQknFFKZ+N$I~CD@EK$sLj^*lYFZ~(_U*RTH}nMauq7c@RCw25
zRH>>Ug&_Wzff{653_}72k$R6c`2JW~<q`M_#K$QORoqzH@xtl|@S_FT4ar@_ZhjS5
z5h_BVJ;w)}tS;#g@ZICz&dSxbf&ux9{{XC3CC~xp@Wzm9;&%CyfX3Q&2Bg$LHCAwr
zZEqZG-bK1r?S20MF^-F%xGsT|=^D5<e@s9{Dup%JUD5vldt*vVC`Z&AW4PwWKT5z^
z9?&T*K>F>!Kc;litZo7oA(R@_4{SO$C=ney8zj)!5=K1oB&iaz0ikK6Qck_e`E5hx
zg&3WpP$RD?)qb7+9ls2UNTN54qLwYFHuu5f{<4FmX<?F7SMU+2xl>keN|H7N(L4Ga
z=zK{Lqtb&_Za^E3H|@99hCmNe&F3LYl6EG*J6XgLss`4if;MF%fAf`#O9mvOvlT!$
zHSh4-I#45!v@$ysVgu=`0_wN@-UR$x1;lEg@+_M>di&=@7`hc+<PP^$clE|{gsm+A
zwh#QhKO^<SGOV5<jXav^7zzqEy}p<eMe$ssn<c4Ka^9O^K#K7+k}ifeXlg6D8-wt=
z_s$6{OysQ#qH4vB`T1g%4hvF(IT!h5212@4HC0=p%uSp2_V&uZgZ!d^x?QAiKC9cy
zu^oWkkAIdXkLG4(XIrbP(oGMiZ>}R7AsE<Ot2PJ1z3%~;OL>Zb6n5Zt2k^k`#vyVS
z0Z0P2P42%OUocZtY;V6Ex592)CAS`8FPou5)BRxyR>1C8W9ha#7L|^XMBc`R1P$T=
z8iqgGD#-WB{{Sk>Aw@B>$E>nm+Yj}Cv}1?@+8Kp_FU_&%>POEPK-!9fW6kMfj4T-e
zj!455Zfkq4FXfD~BSz*zZD@c891eXqKZX>K9I~C|1a5BbfV2L7xzey;o*KxC=mXiX
zcjw`FvM^yuuxcbRy1^X!MHLJyNV^($_Q2u-m1Ur$_T&s{0F9YZtSS55y|BssGiZdM
zI+V8u*w@24K(k7z9WS|H0Y1Kiwn0czIFbJVnADV~N)t?6@M^fstSz+eKsez}?pT`s
z;@!vTo#U9KXB5ofg3c`O&o}^<QDA^8_gFm4$51r8n(dTg@~S(M+G;dY+<JUJ&LYUs
z16BjB<Z)bOMS6a#!toHt5e_tJVQib-uc7UTQBcXKSyNP`5qI4EaTpB&gIh7&dSj%b
zIGIXn);o?5ug9OR6m+310tRD7?C?4LoSPIIN2r6nk-y>b!>lR2Dl8FKf!&x7B7xY|
zaajS5M^Mq}6vKO6>*MmlB(loJNnM%96i+pr@>v?*+w{Ot#uSh#)X)c=_P?f7GF3Bb
zts}~(`;YF<0PMkuBq$>2U}Cqb><xxDhRj!ROK^QK6{K$rgJiq!`}yZ2WIZ*3b!2V_
zt~!DDod`o>!0+pdz9_9O7&7nQZ%yzE9cl%jD6~5k-=B{8HrNE<j(58_(n;b9BXO{-
zF9=|PO}i;$s)cj)+W=XOm4cmKzMlAuJUKbK%0{}>vTFe<{Q$+Ips@pfG6e<XVnG&7
zpHg$Qk!1H6&89J@NY)MC>4X)wVh5BRo14m@S&9NkW5s%6A$4<2r18!&=+gJQ5CGqU
zmg-&?kzORy7BvMx)3^frpL`+>89+7n+<S})zG0{u!pafBYTN@r-r2&8fW7Fw>(c_P
znw&0xfDK+_+qOvQ)CT%*bH-5h1~qWBd_zRA-i8Hq39glxKFHTZd)N8M1Ak1sdcj-d
zWWXeCkFx?rUD;aB5wJ9APkYJ>#Hj*GuB4JdO<VkH(-PTNSUWbxuzo|fF=EIA4=BLu
zRt166?SL9!MG=0O&8ZY2pbysqqMz^6?r=He)_WSh26x_40`56J*r1(65J>Hn417Nh
zzE}z7L=;FYFJs#{s1fSiweehMFcFYJ4t=m&ebL{x08^v}=KEtJYaM~&y-sqKx+DO+
z*E!9z*#~Tcoiv^N%jz(-xbmd{1=avHf<QItdB#dKhzFL9_rP+<v8iaox2^G#3vHyG
zBjLs=*pYusE2j4+ZT1;KSkIqsInLOv0l%&=G)02Loj$m_brVZKZ@J?j0li2+J}{=*
ztXZwTIEKdbK=j8_t+^GyY!1_;6T!}TOO3$4UNPi(C1ti6NuhN^<CEIR+kLEM3wQ0D
zcc7#F<481+x=0{z?}cep?Pv1B5HSSlG<|cmx{_?0*qi`a=KXPi*1!^Z+XL*<aMlTB
zvDgj$GgMwFL{lPy0boe@<m50FQwleTKJ^`s>}HYHl!DR}C4m;hRS#{p?~z&Kc?C=2
zSz}e&z8}8W($6gIPqm7oc>v`4m5o4=(Wn!+H{0{S&nF0JK_OTR+ScoSF9N~HMUM7E
zb$^h-)+-Gq6?7ip{okE><p41&N>n;C6&vr~zbrE#cpFBP3FmJ$4t4|UfiOH5C889=
zVvWUjtf1+etLa1?IAbxC4-WSu;qk154i;eKvEXa3yZiLTDDNnEU54~oO<%ob7Vupj
zHvtO+_g{0*zwc~}%I(!k%A`3u6-MLI$I}=&@k9u^&&Rjy<-!G33P8}r0o>q17U{=G
zb+|GgyUxPS--ax)_?15dFJnX<`1T*JDCylCbmW~t2C=Xk<yob6DW^~#TD^;83)6I-
zHuv{|_oMHH3c$0%BuAzoZEANS$9_LN(bYmA>5IEIwFAn@&E0Mfu;g|*llo#HUfN=w
zO(Ls){{Taj7IL9<ps;ozRpz%K0L-IN6?(V6Z;yJ(^iimNbE3$MNL3BEKDgQws*YJ2
ztP(&#PpuAi8+`@_Jue|>#D$o>hVFM8;>0BJ%E-lm+?(3-d=DH`7I4h5o8Mw+^Irk+
z%n?XdCn1KHByY9k8>1#EV^RoE&1BHrZO%XdI)_D16cSI~;BWa1N9suEbgs6hC5r)L
zu&>7vU6w>*<f*XLw&WjAjt5TBxl|ykt&jlVlg0XRobRF^4Ov(r)nfPm0C`B!W(=wp
zFk0xH$K{fh*ZFY3kxjS@g<qzEQdUHb)<5rXF1`L(I*y_?nrLEj(cNks$-ejV{IO%5
z<yj?-86yd$lraGM{(}TPFHVLT3$a-_7r5X4umZyr1gplwbE!{1>nqY9Hl^~EB<Vbn
z?UI>fhp1To@sI<tvtE~t1ZbUe2Vc9km;V453jQC9u0qQZI}T`Ikcm{39ucZQO?>^%
zQetHV6-hAzww>0E<iyi;1)YN%JJs+%z!(kFteqVpRVv_+tUt~UuI6HbAY3YvSCA{y
zjw=hxDG{_RQRuDEYX`M<=O^N6ENf6BNUlcx{-2HqM-WF@I)!4J5;!1H%0yx6I;7U6
zEbVPthsU-V;YbS8kc@P_f5h%{mT1;J3!_<KO=K`190W)oOXznrK+&sn@Abv;7DyP$
zD<puDP_H2VyXNpCMJ4)GcG7gR$y?O}SHC%rsFY4^qB=m+rF;BOYzK#{W{!B_3Dc66
z%qr+_vFvv3@W@NktZ*RI6t|p{c6(Mfwu(2E3bT+Bg6uE;y)x58%h4~2M!V3KD0<`r
ztd6?4KJv=StWJ=CRrUvQ@3(wdnpu)bHt^(Prb0V=V?wiZ<TJ(`&W1G(1@YSW<Zre&
zO*EYulTY<rick{8gXzBbRORxdO&*ebODDSXdwlSoqMKKP;v%s+j>mn0BNkZ7#Zd(!
zLOkk4-=z*R-~6h_;WCdB_g+*`<Qv}oju72!Mn4KRog@sJyrp!G;0?+7W+#q#x^PU|
zkoL1+6UWaq9<+pwrGQ*$V_E{i^*e8l&nHpSETjzxLT<p3T$<*vArbI;Ln3*pv@O-8
z{{YuGpi4hk0>;li!$#zts=e@d{{YK}Mu{cZm3yto*wFOJqY)%*0V>pYHGk{hDCUMp
z)-ffZ1dH@<Plnk|QcEdU0iy_27U&aH4eeau>eYIw8FaRyf%JwpC~uA8_;n*FgoRtJ
znSnfy^?+@<E|L|Q6@xX9+uxub-#<@GNrH(XaMCCtX`gL|#=k75RWW&@mQbo6%r^vt
z8w;-cZ;dR+u7H4wG=*f2G$fI^BjLF=atyJ%JfG7t^JH=;8_Tqajr|zGlvpm+TY>kl
zZf>x_)XnyJ{{ZEgKdc$9sDQwR2iS~Gq(uZ0s+Rs^SR0L%dDJ)DANP0&89G)_q208S
z)v&GXbH3H-nmT#bXhgC?(h!;zD1t>FHG#bolQYLNORO%Wpv(mt8yX(s@~}3GDI{_<
zZ>=I|!41bJ(zmP#^#vIrNa6`Hsn!W4RQEUZz@1Ez&L&afG=QrH-o*er*yEhlDw(Br
zn1%5pETB~{bG7YT?cTE=jMBM&nnoH}`Os<DRZtvuz+~zk9+Y&$aU_c~Fs=01AbMiQ
z5te@-We)U_R-%1s`~LnCjK*dq!$^y4)=!-CSKBnvlcrfxG?7x5Qi=lk0><ZlcjM4t
z2L4?`_+*s~LWiPC?g2I5(<ZV_A5a<=eK4rex6s$d@=>&Lb#~f6rgkLQzS_GQywbf$
zC3UiejZhLmJE^b$u05~>5X2%6B#?lTs47pLi3IE~kM+hzUZq2p+%Y<U;B&bA2YenM
zi_|o-6GZro4;n|muLCRB#_ueW3PnNyt;hm`s33eVzps1^ohg9CggBJ3)X2t-1uPI6
zJd^VvW&=4=lSLSiX&SYT39xFp<b3jyJ4C?0PEu8W4AX9oFV|o!-Fsq{D;vI<Ex<(#
zDQFrduaQ;Xzj1|dF##)e1%zdEadg{pxbz=W>6!XwAxxTyL@TRMuxoApe1G0)kiu?8
zqHftdKP+QzFO#_hR>Wg;=pq!%?c!=pBaJm-i0&-krH*hV)y*8T_>#okG7@y?7qGrJ
z_ruY2t=2-VY|QciBSK5D6e&Rd>S0&u^2-Q}@~p6~q-cvMFZXY1vCR)}Urdil)fgvU
zrXVB%%h3P>R6sm~z}wp(f8}0Yu5O>ih<IqyG1sIq8;v)~Bae<xsp;fNp-CYSnSd<h
zc|g609@Kvvyr0WKBRd%yXxUf=1glkA{E6rP036QJNGC_sQ8sIg5C+3~KN>$De4?#5
zf+dzjX{D0)K1B)*0YmQ{l<&7Y8@$ad(GX*fHWH7%Zh}$&02O?CWeOpU$YPQP3KFYJ
zUpLPO(|bOfqRu4}ctIjq^&LiuXCv3;-;a(3qQB*JwZ_h*2Cbb}nkTs1;Z=+#XgZkO
zM5ajQXIRT!dxjj<U&|(7Xv(5UTsxn;y{ezRKzf7p?}g>@CXL!jOmM~_joFAla)<u_
zavG1pur1O<3^Pif&L@E+4g|9%#kAN1dk0`P?t6imwF-t6fu4O@)PbnUw!?2js`2`G
z4^bqF#!WE-%B5@(ck&#4c*i{}%hX1lL6$kgXz+^ZTI?+S-O1;Vd<@a7eN2lCWg~4M
z>m={JozEQp8FXitsw#@|NQ99R9Xjr;06lJ~b{Kk?5hHox@O(D5h9LTiAu4I817g76
z-ysv2RJ37)iz<}`D3Sgz^Y~yqq)SX>hA@iY*2>(FE9JM#C2_QoAR2^7ZHV28B>cz6
z0EbgU7}Vd)y+{et80s4X>Bj!}^7T@loJ6S`M(uu4z3v5(y^B8I8p;gvO&aPB9pxv)
zQasE3+uq#X{OoY2P_P*U*E*LX%TRSUe*5Vg{PLY{si&9i1u_6zW<0pBN~)^*=6Utg
zLZNhmFT-8PyB?(0uYb!42974_o5N_}GKQiY{n1y*KHUDfPM@XM44q$5E7C^nz`Z%K
zOIOGxw*t=0bFLVoNtmNd3XLkhS(Fpc#;c9_KJ4-&T@-OhWw{}_S*Y!?RR?oG??Soy
z6ptB_b1c$n(mXOs+2)DU><_ip4x(<Wr`6LWtr~2E4S~`tek=~x?S;ChX=IzKBD$qz
zkiv=xI&DV6g^(`06Y6uk80G3p#K?gZ$V)xfrFxyl-RSXvra~cb;hsq10aZ-_X3hQ_
zdJfp5R5FNKC_+TUv065E;?Co07q;gaq@SsIx`#l|8yV$vjBjLJ(4a280J`omXN~%v
zptK4#%_&&njYupw6+^k&y>LFq{{T!;SM53G1(~0tazIcw@e~_8-r)T6^ofZ*M3=}~
z{Im0a{VZ2sw7S4U0y<{Y5B8HH3LioH8TvDuc@J<aH)HVT%{|&4iaGxP!E)s{m;V5`
z8J&RBD81=MX<}|sx8G5l8WdwvN<Z>Zm-{?aom+R?Y|KrUYrpD&m-{q|>WTjVmTblI
zhIsx?l=)PEaT9ZoF%~F__+qa<nd(cXRtNq$WjuRiP=YIKIb>Qq-fET-t%9f5E72{?
z2{l;~1$VsH_Ieo|wz3yB+Iuj!hRX&98(yJb4gUbvAWQGD?~J2Cqu+dHqJc&8nl{jq
zjrRA$dmejdGVCjCFI*_}yalB@U2}kJH@*fD=r^mtY!8KH05I=($W8CYAp9`uH@K{5
zXj9*Tgqt)43dN1=`G}!->H{6Cw>`2-mqD?=ugf^vj(Gzb^zJ=*#AYGEtz2(;78HmQ
zM*d@~Z<bT4mDfZ@hzDW@{0vAKqv|HC5%mW<sB4vUsq9VsFv<C^+R_vM0H|G8AOw%+
z<y`hB14N{DkY|F={O9rS+ER0(K^=T3ewps|3|cp#_oe+aMENAW3{59q>Vb({Vh5(z
z`DWg?tm-<cmCmI_*dW_%Kf|s%e!H#e8P!5WMX~N^eR;;4sp;3Il6v!v)p;2hSuf`z
z=@c2%fZPiE*^{D$N;9*SosW@OY%2V65cs`IwDNg@K2<%=Z&cA86Td8Sv1tBVN_h&n
zJ%QYxhdCHJ9;>XM!j3Xc`MU)ekp`QoiWNfc>;O^NXWR6>G<^&S6hr?2w0Yk(<iAWc
z-u*8gSpNW((bLwAAZ_cJ^%k+ldVg)GXyNJwTy6o|kbm7~IxS~{N7p`klM@&2#x1zo
zVQX&LSu4U-Qb+^8Y&!)UZIdQ|t^PU7GOt7Ium1oxkxyp7!z$<`Dz<hvllv}@O)CMp
zf72>sF6m4FQ+1eqyD@xKQA10W-`nqCKn&w@3i2zQ6i=0^#`S-WQUxl`<%u1yIrGnF
zRygkBZLYGQs?}YBH#mo4HYX35&_lQ)?}X1fu<J670<_SwPWumYlz|u>O612^zjAxz
zoGR&EChVH*ea>i7Ok=iVmUUKij^e}uJ@bb6x~%+gfoex=<A+JW9NG9_;)QLU=r-Fp
zQTEJ-9m(Gp*kQA$2^1)1K2(Hv@118jow>jTZQmx5+*ht~6f=PwbBfGH$1^~7+dnJ+
z0M#%3Kwg?DKEnGhU;bgno}xuR`)mII5$=Bs_doR?`0795o`d;bk=6du>K2iI{2KoN
z%>JM2KOXxJ?3epbsy$5lol9F2xski)(Rx3od$Sp`c=~d3GxSGhui@XYUF1%tW!sep
z^Evi#qQ;?AT8=jR=N1?h6rcl09%Je3GT}fw3Su@N@fr42uA$@J(`gn0s5MsZ+<dYw
zTgpJ(?2Fsuj#)~byo<p90FlhI%ws0cnYlml8Iux9=JeShZq4d_Gv@yQi$96t`x*d>
z!1Zz|D7AVA{D}O&)@}QH?Wlgp={#ohl61uw=0?xT`rfqtr}l*1MDqt}0P{(<gR$DL
zVYv8aHny9w(|zR$XPc?<C3d}L<h{!q=N2*-`p=*v*b0Pf+izRfKHl7Bj;b!2Bqyfo
zJa!sEA#|##0`@=o5-;1|GQ<*Cw5qckG!Hgwlh3YcbO%(blClT2Qbw`EZg&`bG>q2u
zZRR@?D{a4g;RuS#k`-+xi5uAVqrX1Bn4&~5s;aSlM$K$)tM~7P0UoGL8vuIN_uJ)-
z8UFy~o)&76in0wLn)6?qw>%5G_Qldnw5qMPl1cAJf6F-zmSlBiJ5d{U<L9<P!4^*{
z>99HA6MXyk+uIdfAvJYIsL{SZfA0Wd0<azYr;WS*IbQ}hLDaJd(Vs?;Y~3CCy5oO*
zsM6(N`#uGi?DSD3pBKy>sG6&=KAxW(#Jx0<Nkjy8Y6?g1_gQ)Rr|Nf|-PlnY+`XCu
z<**+>J7HM_(?qf(I7YWBKr}0B`B3=bQIrVZOk|BGQkw$Dy<Yy;w)oIW@w&4yBgF9w
zFtX>+-y_)Vj!dw0=UikdZAHMndk`tTEFHU%>NXO)yhxG-AQBhe_q+OFC>sSOP~PP2
z>E9$3qhhyfe1rLZIYoeYC}g0{Y;Cz4Z~6T3S}<K&NdgAkFx&xkbUp_N2nEuB$INJ&
z1!(h=9&I2ul%21!+VbcWMnsG*MYSq@`~Ew8GrFhoA6SKYWOW`y1TMmf7D?W(<9Jk+
zL1t2_4%KG8zdFLo$mLjRz3b!+kCrmTx)x<1(^Cc@4^iIF9OYIuk|xwyq}`T|!i85C
z>Fr(cCF4$z4xBRt*Qlk{o<3*O;(c)gYC=*|cXf5fJ4FwIuCkKG!4>y+HNG_cDUPGG
zG=fGd!(iKvJ&5>T1i{eC(;y2*ln@V~IHu%~DkD2F8b>7h46lbI{sJssBa@*OY_nOQ
zE57_;WQ|bN_bLk;A61|auio_IAe3(;Z68pny09ULv15J?#|EXU)4q@gKEEH&9$j7@
zmr)r~2m@=akI!sCBPf)u;sd!SVm7YZcghcqP=q8<B$HeA&LMk8L)_lj$s!G&80}OA
z)qC%E@7#R-a7x}B%nMqPL}{TwZLs4Y2*pWg+=2)Jzu(I`9fImxBW1C*^M3irV=Cyv
zSlEN*UJ2TP^zXj?uro83khn%W`9L3+7!wrb0j1Pv{{Wn+U3!&Oi^$XfH{9*<<1|gu
zr%V)?RmPB6l@7&+6nl$5{q93tV@iz^E|a*ixf^roc~Bx#B<mWg0_?P8I(@mlhW`NX
z8Kz+DLIu=V5!m+F@^W^dn9Bet`Hh|S+ZRKE91c&EudnRjRxJ%64dX~Ol?bMYHMg&Q
z>moq_>Li`H%lL}Rs#zJ%;Zt%Jz^3})k&%^FFvNrjRa^3XY+e;LRe0R7uMBy1uzjxm
zEa6#+>LZmwT{Wbrs?)(9hlBORg-eoz1{{le3U=Sq+c-0k9TGyHC_Rb7I!OzO8JUEv
z-!FV{s3Ue+oH?Znqh?y(&HB|2{@E=`$V)R5unX!xb)Bj7D(gCSI(rY@{x}aJ001WS
z4PN!z2F!*v*@?1QfB*sc^Ns<H8MQTTtS+|wc)Iq<$)UoC)ZX7bis2@W0FpF~i0!@N
zh9OvjNAHYj0_-&Dt$;lI@~)y7l{{ASN3D=9+O--7efFb%_!0otKq<dPO$^RkTGcA9
z)qC%TASF6W=>!wMw)pzePMk-f5%%AG#huU37Aaq+lmHZKAKa?TK;GBxGJu^l(g`F8
zS!1?hI|~EzBkO`1D`!EX4w7o~i!6OZX$(f<n~{<QM_>rT9p6l)^q}vgZY$F|_fpGZ
zuTP-oIBB3*4|9CuA!y39Z*Dg|$HU(PwSyHbWN9CGH*$U+n_!96O}H&WfCj5A)GP}j
z{#;AATGj>KZ^yqL*_;mzwRgJTdiTKM?Di~?*b~Ndl4~Wk7AJCRbHBE7#AJ=6Sjz<<
z5&@xk#ay`AYhh<$fM~CgS(!=l-qwA6usSle6Lx!_&j@J?tCP7Vn|dGPIvBiJR@yKP
zlc}gs7DwTb29iWW5F{z91A~KEkf?4KoG#`=Ap|LI6<6PkGZtAN#UIrMw(M{Oix`t_
zYeRnYbA^-zoZ9`-&T=a1U|2V%s~V0WG}^3l*j5xu>m{~Z-+X3fgHT3NuUD|%v#&`M
zfr#!+-|2|WYp~w;I7cH5N?Asc*!RnIWhIxyjyU3ok^(8?d#_&n<dm@mR+JG&_PpQ`
zG=@eET;5O!wg8pW>*z6v4E1ZL{{S8<I4-*^#3<s2I1)89OO+>!z(Y&H@3rGLmSM5?
zH@VJjASerDjm_S1wPvNQs*h}eX-S}dyqu!jgG26%AfA7FVp3T;m=HEK-v}#2kZ2Cx
zxkqXQlHOxj6o&GG5FcFS2}hgl>4XEO!2-A3)&&`yYA9?EE}$zSLA{Brq+vn+rlN!%
z8on3<X&Y5>xWG`Li#(18V~nYBm#`?+9f{6#0f^KNpFz$G4N7#V1B?ceZx=%7P*8o~
zKKI8I-!=|&#$%!gBkPF9*dE8_fYKu=TV>yR2ak>^Adq+W0}D|kD8Gg>ge&G7_TK>r
z-;QvAOMgz>{4j;xfIETp&ecOnG!8+)lyF>X9l$tstGKa4kA@|AyW@gTu9XVj_#D+%
zwBEyzFf3%glcZSgc+McZ6Se;U<D8<&vOyeBz!E2h+AJS%b~peUsQhmilfF?MK{gxU
z4>>}!7Hgmf01PTcA6vX2d3@%8#8wK!YadJkP%zY>`W?0y(IallMTXVi14&Vs?`yCy
zLP$PsWjlas@IKq6>YJqL#-vu)b*Kj4;g8hI;TWP(qy)2fMDJM!iTa5HF6;+vr%ptX
z$>Y7S8z1s=4k2en^Af|m4Tdx`M-&D!MZaz643v*!!$tCnBF6bq(<n|@o@fp0_3eQr
zeIfSJfvi!mH`^?|D0su9qi{<GZTQ>u#^|G2Rq4e8<yOqnMI_UdS_6_c9k3KJ>EvV^
zi{Os+o4Ov5^=?(jh!Lo2Z8u*W%hpCer6(j3O&jbv8L65n5JXp8loeP#0b~=m;enZ4
zq>dAGU})`il#i^G#1=UMi}Mlps;lzDFGO@ydq@ahBZ7Yn$<s*D$QNx&Nft0I)O2$y
zuTajV<~9i?_5knlIaKN)>7b0fak(vR=G<51-!w_nH&+*oT^mU^*@)wA)&4U)Bc^Vk
zp;jie)m<6`{NQxWEd3OdvJ#<1u<hIR=iKH_nHA+m3^uc=h0qwt_8vB{38m4&qwno`
zT@yT|q<T~uMeZxV>wtRak~Z=>%Mnxs!fCTyZZB>#izHC0L>*YxqpHCdz6D2R39~8R
z%zXjMx7q#*!rmw%O+WxZD^<_?{{T2sNKnQ=>Kk<$ZGRj1=4pW<wTS`&URwax`0#Y+
zr7{_c$`H__<ve0Ql212;o?@rWnrM?^`1)1_`dA`Z%E+ogU0Ri{fV(5#ZVqIWzg5<h
zb-py7XaPehEO7^WUC@zt@9Tc2@WnvQ43ZaOu6HC^Cx52bgjKq2mS_8i$O~8i*5hmi
zz(<BKp~$V*)8p%s>265Iu--sTfq#eVogwija_riU;MV1^AEh$CNi1s{0AEytZ6|xG
zuTVai$EQKlsbI=MATeMEzz^T180MK7&@ch7?(%l7e@uh7g6^}cGlD}7>-F!2Qdf=S
zGdmRu2Av|cf1YwZW3<g2z-ggvK-f3Q%S9D*uOVtu0NZj$?y%~K=eA~4Jg^#Yg9-jr
zw1HxFb+RND4Ua*K7?u)sqLc?=r)K{ETYfpxmC+A}r%?n@8xP&)r|F%cTaq>M*t2?j
zQS`mJ$gHS{8CWBfLN$?FS@rGCU#RQUbn-(SW}01M&=W(A{#*LqXX;>)X1NM4nueOv
zYvJ+2v$sx?boQ#V3nx#Z+b9~<z>&!++cIuyxAh*MhA;B0?##>-D8CKKI#;k9Wg`ct
znVq9j2sQy6k?=V=WoI#hS&3CvEXRGeAC>_oN9p5^HVjC%Kuv?&^EiS06_zb5-XhRE
zZ?*H3XH;UY<sV1{#=61$f9ow2{s>l>5Xo9WHUPfh^MRCu(?;4zkeXVptGW2)`le=o
z3PNO03gRq$#8(85pTifbnV0PurUeX5sGw-Z-vPfDf_TSJu)JU?hB2`lo&NwXJ#qpT
zY2^V3)d(6%+P-{Z^qo|lGc3@GnnOX^Y!TmM$=?=!rf#>cmHz<t%(SedVXy!K00Xei
z5~DyK8G;F7L!^pr`PlL8-vK_&c-bV1L^CjLT3FH(-+x@pkNmnu;0M>cY6HvjKbBGj
zkz&*sDp_lzdXMRy5+fv!E0IHeBanNV_rU08@m^+-2Qq4mIYB^r>Fx641aT*ZHGR;>
zMQ&XDdBYNTY=u@tk~3C~q|qGTZgWXJ5;ILQO(I7L5e0pa@H-y;w!q8NDylh|nWEIC
zR9%zpTVKbvFGyv1*(5?@*r;=xdgX)czL%#EE3|;>E=6x!(e~Tdoap+m0y$t-StFJ(
z-e~qhXwctoJ77dH=pG)bDGEy?vnh?NX$NW`-`2Uzy;`i&c!yS#CX~7WkAF?_i6A{G
zX;n1<bZ>fh^u3N1>A$8`<P5S85eT!trUY5MssuWjl+zm|o9Evz)5Px-vqDfG2ptBs
zFxVQupBW(}Q1vk}K;gq{T|;nq<BZb;Vh*pXB*qdr#_kJhJl5UM(+bM{LiLXj(y^p4
z6jlHV0`B(Q_VvKAi5VRLL}C+2Hh0?i-`0j`hp307*5);KJSnmmFrp1rbCyxz^$|@8
zj4Xg(mr;y>0VRF#GBjo(T0D~LWngHq<9)W@B`I#59rc?YUva?$DDZ^oWGwHfg=DkZ
z>v8bk=YRw~GEJ#`Q!aw8yKhu%?dybR5V=;;E=@olz-{aLWfm!VGaC>*O+_>iL0)YB
z{j)*oqh6>+(*+6%)TV(V&fkE=8k?kzJXpfUq`K@F`KrCo<5&YkXQe$dS(Y}ofB7z*
ztB&`8{{Tm)Ld~u<(nVdbn}4l-Sx%i6UY>6R9~hlUKmb4Gd;CBcI-+JO>eb~Tl|^iK
zKLKa(!i1tIql0!?T0&p@kS@f0dHlV02f$vGCx<GbTP<XX91~r(75d}F{Jlt6F{Na5
z03JB(eK-6L6zY1GNMc22SfeMyUoZ*1*!JfjiaaR{(iEu_D2)N~s5=lvUjG1v`{S2l
z8b21*0R}zI*s^!*4S&7yk~tW4N`V^6#&!cq8;bQi8~4oa%L6oqG9O?MW;ARA+neu{
zKSu*6UlEvqC=x&)^78&88a|$Wq)VnpP#J)BS`6mtN1-I2hszAIn1=pV8g#W-6nG2|
z8{;of$vjHYIzUH?iVbMnW(06{1ns>X3BlCHf=MNbNdc5!n?-;)`jCBa$s}xC!e-E<
zM;^0Gt9Q?>leYDfb{#Ci^p;7`$S-Y5K?1-#Z+~2AWp1t8s3S;~i|JLMhqwTqERFkM
z2;!HgRzS*+W{$8lf~Lnjk=wod@6m~RG2_P!dxKiIK3%{byZ*UkF~uaEIF2=rIg1vc
z#1*kX(6Ls1FViwgt|Qel$OO(LBzH~4kBQsmfk2HhSRzs3oix=&$qTV#z_GV%Srt}E
zRkfjVJngs(@E_gA0PbgV;cJ(55vbiP_xXNf(=<#Bi5tm3oe_YKa8QDvkHnveI06`A
zmVf4SO&>_o8z*wA7i#w(y3QRGOCYJEPy#y&2ST#n91=Y}Yvs}PBy}3*BqVW=0#KmG
zxUW-WdTokhf)#)2TtGVlz=mrSg!A9`&H!HxgYzmP>wB;W+Q+ZnHG5tddVv~92qpMV
zDMf?5iz0#iyOEKD&m%0d6;l}wd8IAi*3aX=Y`ISr3rejdvL6;wo9R`%9-rOv(g%D1
zdWUJ?kQSEw<}t7=#>gKNUAqrVUaPAzX%_C);)kjTXj!B1taf;OAPJbr$#3DEo{1!z
z<ICy(a$!1|<9$QJjG>cNX)-PB0Pnc%ea{16JtPs$*65e0j8bXzU6<6*_WAs=8RY7g
zd1nmrFxX!KK?A?G7E<v>L<ki{$jV4<uWipJiR06ZGKNl)qNv`<W)=$#K43?+)&!=A
z8Nw)CCe=x`01dBw_uTK6c)TdOaM6VTDQ$E-N+Wt3*6UuopM{nO>tyOC0gr|?zJvyb
zpa~Vg0k`%1Lv?b=Jh6_itzM!?VG%^EH2{DRg3lGrcD~0d=sJTpK>q;CPdRo7#M1^I
zbzbBD01~2w)gCfB-e_Ht8N6p9Osv#|G1*0W(foc<o#GCZ^12<B>bDEHtD(M~{RR|`
zB<R!`fA=-9jG7Cgj;ro#SOfgw2^`Y2$4;dRr3R6`cdwB8V|e07dV;S(nOH`lfO0Q=
z{=Yr4ko4kCm^5sWux%Fd0L`wzr9FjiN3JAr3Btn{h8_!ckhanuz#ivqg?I0O@bq##
zzsPkD3<tzg(n!QCT!Kj#>OFf`yY#*vNJB`9(g5mJ*3_v(Ry}tW>G2qy3(w<ADyq4K
z3p%hBTLrPlG;&e9NI=r6UP6zzYVGM;@#};vLFIWuAYc$$*&4jdu=OPN^cRg7P=z%W
z(@vp<=&gu9{pigdM^<F<-6I<MhhpI(3ZZoZ4%~0p0k_8`1VvcJz9KM?qZI^-zAK*C
zSK5E+SeSjQ_Mmd!8pfxMi7XBM4t|F%2`4qUKj%It{{T!naI^iX7$7=$DAWk1EZ4Vg
zGwq#$Gx}>Eu5PD?E^m_UN5${DjJ<iEpZ(F0BHmN$AOqVjqftEXIQ$N5X*pXJe9N|9
z?9e}wl$x_4%<E)>+r=j|eV#P*a)Nf%dAkSB8!>!|Ew-L(6mz#2&H-QnpauXa?Z$de
ziBWxTG)DS+@0rHkvDDV*FqRV2sMX$jA7+|KPS>?(mKw(y>GUdpmuA22%{e?UzlOiQ
z!)n_Z(wBc+l4=cP)>YeA-ah%x=RvkR-xz@JK#{&x!6J_Mgb;S$EDrms0`t9`?T>x<
ztOCuIuby#2gcCseW=d1XrY@@63mX`tesYQ<5w_J`vqU}DZO-?ZRd2RigI?n?k{U*x
zI)AwFl4!~j7#rAUDFJJPSmBBt`PduGS-~R?Wl(q3um>p48hRFQPX3#2Fb8iG78{NS
z&jBH1&<*dt75SIhQHB07`&!92)XBK`ocA41hM)OJPvicx!Tuj_7x<g)Nd-0aGBy0$
zK9x{ug2<q*Pt2UrK1+FJ=|OWMX(xSG>zyGav?N`MKluLuyw){zZlxNvq2JIO7_5lX
z$sit9a#!DeaMvV)9|>-^;YXmsEQ+A-YNvty#|-k66bLMKBzDhJ_;>81)X2ST>-{Lt
zkblX&a$0p8VK&rmUdP#=X2H=!vxus9QK+{g)O%*LCi`bfPUj_g#cOVM<F&UtcUc$n
zJrvRJWl0t4Hy@UH{W)2BWO8={bDp$Dh&kiLo(ECXbjE;JB}bq;kHF`h%&&=T$0q=4
z_N-S0M;0q7bzs&9*l8=svG1OAwzYkhNrGSg)#b{P%RueH{{T6k?4$iDul_?d0c@tv
z!`CpEW-p7pq*>$|-;tJ$Dl$(5?U1S#O`bp2U(B(fvUcyByqVQqcw@PpfmOTNf481a
z6$eL=MU%bc(T<btm8E9@lVIQbImcH>Yfx1f{q2Bm`F<e-xZ3hAsKIs98}gp{Z8b}p
zc@x`B*rUG6fS%bx3jH|AsjC>|)^bN?@Uz_K9r(d|yH;@_2d(ji5I`GVa~sYJLeD2V
zYxK*c4tBsn?l!_sk$J!r)v1Z}%%T%zCa-My@8b{R&Xf38?AGeKmeng-!w}|1^!R$7
z+3NkP_Mc7mS3@^j)yN`-71YdseCPAG@i*K3Z}Gp|r>JFRj`TqnWJ~Yw>z=QsdVKP7
zZr>Pb%a@`N)z<$26#cI+S=LBiNn2cv*+-!Kt3KE4?utH+6^=F2L;nE18K3NLvKOK0
zRR9jxx&Hu>{{R{4taV|U)P3XXeKYTI<BCK?JY1KXPUXRXTMM@cJx{JKqDum5zWZZ@
zI=1`gZ~n;4?#s>EDck=5Gn*QU(vQ7c@Pj<hwEF0J2xOb6lA}Rx$8vqW&S;)t9;qIe
zxg^k0pP7Fc{kznCuhoAm60}_uRz|&xn!QAPI3E7_EjnjP?p|l{58JYRyVZEkg(4sO
zBL3+A04JRC*_G7@-K>hOu&V?rMH+7Fb~3R!i1>g6F_P+7T9P;w^34-Fb;M}>L!-?)
zENY435)oSY;Cq2zyU4<^8JQV?O~`G|<9^)nUAgBFJ6#=?$<j~Znv=un$m&beI4S`g
zDca3*V#RI2-wMWv(kZ33ChL5wBydNs#6Bg`g%`zL`)~MSi9*o++Ox){$LXXBu98Ho
zu0^rfs28yLenSFcLS@v{+Cd;OvGB)03n?HSW{n;9Ja@%0=meSwHX3)o-#<@W;({UO
z)UtU<T_TE+cYg})-1=k;(nz+&=oQjJw%hGT>GQ;n(UVT(8?Za}$^rbV8qoTA4lP^I
zj7398&gDY_MIFZZKq`;bedFe1shC$MEhD_rwC$l;DSR~ne(3b?#h+Y(0SF_{>Np21
zn&yq%%AwSSa80v<NhjP2?tL%}Iwx|o^&S{1z%f$55D5d?&ez)SC#`GFSh)jmHUJ7A
z9GN24&h@#jPElcyu?R?EVD1M1_xNBlNa!Omw4|vbGX0kC<-MOwoQlyunmS-E!LWDw
z5&p4=1tSWq0RV+Nl19gI?hfDgf=8N8ol6$*){#MNfZXgoHuS5)6i5*XQY`agivzWO
zxHo12Sg`|0HF}Nq75m>fqP&%LcS69b9m%YJ7BrQNYpDZJ0GcD?&%PA0DGqPSk}1={
zHDqsuM(?SJu&fo1piP^)9r!r2vVuqfQHdb|v-8JPVH@a8gAGhqVX-5A-S7mxGsHkB
zKrKP8i&)!Z+a$`X<WkqTYy7f>m?{gu3e+(8-Th80GLga5c_;Vqz-A#%wP2b+BChWh
zq-h^h?PHp*HvKcTg@ID&+2g+b{+J3VXC7+Ru<m|1L-<9?k}1g9SChSQ+rBr19ixsF
zXO+CHy03fMyLxx*aK!UNAeC9eRq9hrppE$BV~}F#T&UUh8}WeBq-yUHhIdzBBnM&#
z8(?9%mE_g69rv;hJQK?pkyc`!APB)tD~(r2<^lO&rqb%B&#~oe_I_9#86jaJkQqoQ
zq-qQ~H^0MgjtLb~nIt7yNV=}ymEZ@(0F_l7U+?9Nsr@#$ts`apZy-?eO@2~X&=d*n
zRh=r80a`j`6h@LL-+WtUP`+mV;a{KOl~;2mvKl0<vlDE4{I2qW;mOoBDl0aPw2IgZ
zKROtyvcsj<#6<+@W$t^?`Qqy};wzPO*bq(M#~E3Kaxn{35ZD*Z>^@(P6ri9|6`PPo
z)Cn0wENr@8P?5I|4{D$*^}Oz)cei4iLy&x+D(%L=WQb*5$2+SL$o<v>Oo0eSK4G(I
zCjK7yth*2|$^rG?oG4?HW@g&Wo$uPeeB(&x!(T9B!%;oftO4!+09Zo9;ViMV(Uw8?
zm0F8@_phcnVI0xPBzlIRN(0FM0C_0mXYv7hwgmRahAAiNQYyA%ThQm@g%?0$1igZ7
ztDF7a`8_JGcB|L}+baUa8nKa^QBcSf4s}%%+iO1|>tPGDg^dzE@h9`h6-m|RB#thx
z^Tw!^%x=<X-iQLv#AgN!j=SwtK%s~TP^+ehHb}r}f&t`U+in1=-l+Tc`R7SXdjLlS
zaDRWM6qQA&49Z6b*8{@$Or*0_64#Xl3L<!|rI_riTYP_h_?iLW79QRG@RYrXCAJ_h
z6;^YIjippdKuV7@T^bf|<AKH84+PLqYyvy_;;T6)L(n3=IZ_~uH;Cn#hxYOFKfjK2
z(6l}q_>i%X79JV8_>Muo)qy(-v;*IL`8SOqfHH{5Zzv}A-?+&ZBn2kGCWU(8b=Xp$
zLV3K3<FV7asQ1RLVN$8Dl0{<3#@9&gx%bA1fWVMV8@#BVlc|6lZg=gDts5b-!ndzn
zOAJobd)FC35}H+eZfdpyuo%&jLa~bjaeEJav0unk*kDEN-{YK73|f@wI|?W7A8ZK6
z`#h~xe=YI=-e6c0V9;9F4~{b0`PoO95I#Q)RZ49of|0mB{)0Qrq!lE+-GjKS4hU2U
z3O16&16y7J7Qlw9^zDOLuulWfcgnDRw1;XS165cGtW$GM>MQfa8bccg*n`LU$~0Od
zVzPJh0ek+LIG6@oK;Uw|xE$naAsDbb9@mA48W^!GHs80VD6;!dv$i;hQwE?{iag~D
zs9N0}wyxR4jg%e1+>?ZoJgH<aa5J?om8%Wk04or|fCPhL#o(2T)~X(W40a0;LXsA4
zPSsh+$*eT`m;x*VxgGb&5F6U*z8C;z1nxk}ZJ@}4tdXRPp^2!33s=40e4~|1BU+mu
zL4b`c06Y6*z{rj~V8%0c6wx``0$oCp=zCytyGJ6+VTd>80D^tN=M|2pHlo;`2N+7O
zfN8!%ID@9ZAU7Wj2G<aaPLDAD;NPYqs_Ic8Ax`!)m;l^&`?*J13=1hkpqka{eK01e
zs>mTg7xBtiS3t+fu{wA9WcW~5d+c$3{q6znfbtX)5CJ0gvD*-xU)%J{I>ez_OG&l4
zBB=Ue7{Jou)Zbyqz*do@`@;SGF?g~&duJBgi^3x$P%HUhcPnft4@>}yu}3J38FUgw
z`W=oZglvE><$$E@d;BnsG%OtD@>pvi?_6gR3A(HXlmWPFJ?|BY=^Wkh+Ofa)SIkKx
zf$NA=hN>5UO1EKk&T_F@-o`q*MhGfc{C`YCzXpZieY*7pba;AHo8!2|Xw;H*X#`se
z-tT<SWmwcQ#-dsRh5GaP{c;mY98IZ}n$4Z~H(&4PfE9JRq64@)pTjIVe-El~%%lPZ
z_8VRy>I{-J(SlQe91qX;&NPppAkf8*)q4u{`ruQgPv#3~@~me~5&-Ad5g=hIl=4V-
zYa4N3<dH)U5sGSKvVtsqG25z)LM+=qlu$bgz${y-ftBeQyxjBYb)6Ii*-EW4fOa2`
z;Bg^oUTqOKhPy7N75R3`OQ;1eCCIO#PO2bZZ*FiII&ED>pzLI7?g*kivNDB>sBJPU
z6GLDC_+>gNmMPe$QQ@!~J#c+aEA;26b?O5&w|a|?E8igKT*l6xS3_z+2j}_LNm@>u
zswxqKfvJu2V(}V3<%`H|tnFKG{xXuJ%Nq4k(K6T`yHVfjFclfPfKiYsy=L~af9r3K
zYcZsemx@B#0*?%h$==P5+vZ42(=ZXnEZvSk`DUJ!6?of7Re!w1l`Y4<-z+LX^&tsK
z38db~197+1{c`Y-dU%#bO-gLovwVE{{0<2vSz%)qsS-6&t%qvg{{Y70<C9QAI4Y`0
zDnaZkbNltcX^d{gmr;{uC5L+7f2Jg|qQR$iN3z5aZHMLl@<Bk6qHXVB!++oU#nz0&
zr$tuZdlk3KoFc^%cmoLn05%1=I1&wO8d{Y**7fl@MTka@B@9#zAOqzVIQ(xI%L2NH
z(b#MVCi@TbfM#@5mLU~Np#o{IZco1XjVF>xiESo8+ZO$dZlS_T+FVGbYfJXA+u?tP
zDn?@=&;VF91K831{V+O0z8JP9OQOZL;~bWcrD3B|zT98V`(~KBDCUb(G6!pRQaRs$
z@tIa>BnMbVMI`upkPpY_foTX3+G+q%*x#?v=1!_YhWsr6kUs9!m2RSLo?Rp=89`br
zM*je2vi(HeNAmvw)M_9S7Pq?CpQ*q}x+Qmrbo9+C*d3P7@9TnDrP1Ii+_Koax(EE^
z`etbQa@xwX5=Nn7hsT~qFzLUm7(&uXC2Y1x!l^G+282RaQM+_oD_`d$JSiHdnTwPZ
z2-~0E*BWgQ^(Hc7QdWtr@82mj?-XjP5eQMen<F5MfuNc>7hbXfA-#a_k1UJS%@Ju7
zfC9IdP2YWnbhE|R7Iu<ZT#zk~ZTo#PKq^dZXlvMzHy*y+Wdo`5Ov?y%RzLkf0l(c~
zE@GXSg;g{H*Eo8eYJ9AQCSnOe$RyYA-#ht59YV2h>B(V9JBszdew?4>`iUMg3G#<g
zLw<5mv}-F3Wm%B8q2JRs_)`}uul*pTf{bW#0i(X${PP>Yy)@Mwy2t(1c6<D=9n{vO
zap9B<LfPDJzu}beEkscSeL#&&0HQ~^%<-a;Do*-bjc9c9UA=PCfbOWDe5&~h4o4gO
zG6|rPS4g!Iys=Pd467__sbM9W!rrPI9nTzB!w|1gL0JHeo|xC&K9|V&duK(|>2LmB
z0<hExJJ{{>{{T5eI++>dX(aO!e8Aa1Tz;L<NP<=-C)>l^*Y9j@ozaTG$V&?vg_b)X
zE;ug>FHZzS$YLtn-B~w(F4+WS@j?OtScHVAUBaJ1mHu2bGf5=u3L$MOe4vBed*hPb
z6vkL*wmO%Mn`%ESQPi2Ck-C_ZOIWaLe#5`h0864Z=_hqr7FE_gOJ3ujY%+D}E{Xb>
z%zzV7C<v>+VMo(_u|}A|F|cUSfET$?M*jd0jt-}(jF{3CE)e-x4lE1&a4XQJr$HA?
zC7HacjK!Jx`=D2BuTGFnG>p@KEz&lURh;w3&wr+6>fv68s1qfX6v2V5Lab24P@l`i
zB-)&_1yFeA&0$M7PTeX-T2(U415zLDB#r)`EY;O@46ppSr&J+>C$5kx#T=TaPSQ;z
zghVA`BQ#r0ay@b&PIM-n*^6CUS^og6BU~(x)+Ev+G;0|%2Vrb4zr$~yVARSy5mG4g
z3c6Bi{{SER#+Xaf^*UxoSB-|Haa(iWvCGXOG|^8SVwcQlkO1@^oPIc0b-gQpG|UKl
zP+daSgI)IDe!~%%PXvr!o+0I`Hg#D(!m`Fyo2ZIzod@$WxnoCazbN>OS-NimM+`i8
z-AGrC!jd>5#hN%7`gV7YP@{P(NC$hrUrf41{Nzkzkrp^B%39f$z^|95=ZpNQ>JdV?
zL`6}i#-n`i>wUX^IOnC5I>z*t;ca}vA@@yyIW#!D2~Qh5qDZ6F9F3%HMVU_j04@%9
zUDh!&qDH<YDhAWJ6gb~*KNFggI6&#0&{~Z$uCffiVk~zZvozvYltn5PmNrz>O^vp)
zFM8N|RuM@g9XXLURWT`s(@%-T?0E*;o^bW9C;qR8Cxuk14%+nc7q<r^EOLig<_O6f
zG&feHs2d9S;8-KlUPDAMQ&+JkefX{~++kX#j2ZesvZxQCWFe_VRdN6o!Tj?a&mtqm
zXmx3j0oV|B9)o?ywrJ`a9+GbgMlv!sgirwmEQ8x`ZLD+Yi4<mGDOHX&MhdFNix%5&
zrSDuE0R1e{K^$)y>XHyit0eDV0ywO%S391jc7&3pz>eG+6mN}<*xV0>WLaJTABOr)
zqjqe_PN86T^vXP53^(CAOtFncn|)fj_S(Lu0<SNF(#H^yj76l89d={=v`=BN#uAs4
zri9L(2AwQSdmy_kcD;?8=7+Xto(680r+CV+Ds{S^Np`QpDW&7;5-Rb0x_2DvTO*%c
zju9aPO(e3$SUWS80<0P=56+I*I<<hjE@YB_6>d$mkzf)BtsCFI4xWCc4DAfABatd%
zM<9?7%Wyk>na=%BN`ZD?6*n4m{O*Tl<9>I-nDn5jlam_xfZ14bc<o!@>Wp!-uS^R^
zH=jy>$B+Q6h`skbduFL%T_!kN$BHIJN7G3#+zq|}pIZ2Dm!)w8r;zR(c&xXxAs?yS
zU{+a^sdwrL)Y_<`uEYaDM%yS_1Ji83RniDnc2tr?RW9Bb08<m8wQsR%*mkY`G8vvE
z@giMOf?q>5nCxl2tK(z-BPlfP(TJHQSzp7_stGz(fdg+*S5`*j++Z0dU*)0>NHPKh
zOfSv1n|-f=W7B=BGm+Fn0A`Y-6q=1G+>O3$anT}*bzY%mb?}H0t8NaRjh@^efXM>R
zv7=c+6o78`BadJ8fk`R4GYFu%uU`aq-`j7+eX${UW$Geng0d-FRwv9r7xk`x9M#iw
z?K8s!l8}<HbW;0SZ9Tubj%E?{9X$G;4-!a~WIEFPFeon@R_b>g?Z-4~ZmM3ACwO&7
zG^){fpb|8?oj~7mq<v0gbxFJ!#J|uAb{2HlvN-j-tkhz8BRxk}9Z|=L9EuHc1rPrA
zhrsW(W^SP*gpnqM)TZ~;NTIj4rUm+rnR<m1ODdRS2xM@;8!KcluNB85-ttFO^Oi`z
zr=`4wtgR?K_8VWV8pM(nfuE;x#q{h!pb4TEdN<G4FCo%qX7P&1(=1TL)T`zD-Nv2%
zgPaI-=`=z&n_7p|(Hj&#@UypKKRUtHeW1lkLlUC1B#m3yRju!C=Wl!>Wzw%GX@W+}
zq4pY&1bgs)SwqpHe=Qt}5!nQqTvnh<dLG~bdv^HY2^@0uI;IjMcy?{J)Ng&edhb_`
z3;mzeBr%p}Qy`XPZA!t0k`xi~9`}{&;Oe31(jK9DbdSZ5>WGF6`xaXl#g09_G6H6e
zrO;8M3{bTKKsUJgFK=OmJTkj7NKh7PT{e8)V#MCyebO>MEOCycBfBhw^2VCY`fv9^
z-m%tc9h=HxSe1l89mHgiKqT27W4F2Y#OdI9A@FFdtmjVyMUXcqjt}neKS=)o(vKVY
zU$rD^3})%$HQcCs{7!v}fLZUmkJmn1{{TwE{{SJ>vz=ZiR~u@(C(3W}C!bvUxOZ>~
zJIF6LQ^S`u{!4%vkN*I!12jZ8L%#D9k&F=Qw=*5`(1IE<>g;beG?-S9c^a7Jj+JYo
zv;D^NGMkM(MzitFv5@}&XQ#J(-^cm3V)D+z&9)slru9(90P&uSc=3*;S+R<Ctl(=g
zML`3b&rj^>P{zn;8@%#CJodt@%GRWc?lWDhwi6qD0A+4=!c?!neY414v|ItHZoM;H
zUuYzND!m^=&S;uUG|eU(G}yC>)LUVlA5;%(?Su_S%il0#qJ^M+NWnL$6mJ=YRp4r4
zb>A!q9rKi4*SN-L$Tw!Qw41JShF%B*=ati_&<Ev+7Qoo{$^b=CJnvZ+3R!A_+zxVx
z>r_d<Lz8hr?#Kgt1cmQy>5-DfuSuiFKRj5?ND{rr*Av8MK&NaeMncwZ&Q*SA{49n)
zw|>$<LDMvYSN{NgpIGo{h*AFl=@a_r%zp#Lud4e&!LS|w09^YXlDtL^MI=mj?kc}r
z=AS8P?uSsz*2~e-mGB~`ukIqwWP3rs-mj*5KVx)nH&T*FKt;W;ovRGLVY12;%&eNc
z_34%&u2}xh`#brc>r4oUaJ}0-&WG(0)5+kl3lC%e02BT*J5W%lG{(D7^vv#Vw(^YM
zIHGH*TT(TteI$a%vB=dNkJ%kx^APwl8+7B`X17o{?VeUjbk3YNuT1C=(aaxeCxg~O
z)b^2lGwetDKZb1>pJ+mQo`OYD=1=M`%l%$+XRlQz3Qnbzjdx?7Fg*_`yVHpg@t{&R
zK8Fi1Ha83fU+JDKx*C4Ty%XQ4tkqx<zT<kV%l1jQ=DoKYdS;T;LlMEuEbYVL(hYk6
z4VyWojhgfsodwLk=IZ#(HUkoOyyE0r>Dh)p!9i6NIq!$Ux;Is3y>o*Br8Md%e_`*0
z$`zGHqpM&me~-gCw-FuP5gR;lq_5(TEqFNO^LR-DfE8G-DA;S;IB#vv-Bpc4uD2P$
zS-#o81IW%Ke6w32_#EIgowx6Si9Xm5mwoFpfZXw%#*JQflAzY-(-%d3<7D%jBB{4k
z8z+9)okYtT7j_B&vQ8Ij*yrSb`l<YWU8MdW`z~9rFH<reKkx_h`g-SI6Nzm1=&N1t
z6^+Zo{{YmF<5&JC`#^o0&`3|&@HJYUrhi|6?TP$7_8{pY6G`{a-rJ9C$NV++87#d-
ztGjNX_V>@Lf-ea|trh;!>+hd^#NyKhB9(`apETN4kIO=+k<a`_65_Q5@{N#spIi+=
zSQ0di*!ufq-P{qzw)?BuMs>N|@)Xp!x%<a4&nlH3gJn_MI!TLpbpW8%pYA#GKgK`B
zC+w6xA4=!>xdFCbVimW~^5@ee&X%>@>E!<a9e)yub$yr8$aI7KcOTw=;ys7wpBQS1
zT}Rj7+w;eEU_3$+*=<QTxB1%_%395;5<soN%`-c7)-@VDDnzm{D`5>0WCp#c{IL{x
zwz^%IZ)z^Rv3i6tNbx&vInrzc-j956V-2P^QUKH#4)tVJe7!cv$dSmwyi4;~A)9^g
zzpoi-S~;CnVMxiMLJ~!39;cIA`=6$D)K`!rJpTZ^sqo^J;w&9+PNBFIc?4hpu+uSb
z4DLsLt6}xq>6{}Bh>NR9U_m3EMUSQ_h|(w;wQe`FSH*pPxX>9DNmnbV5zpQOwgqQ(
zol21)U}!Y0WGDbA1Jnx#*b2zb0GJ~_$>nB@>b}+u?}$k(NxNOi+xN}}3u;vJy$){y
z>17&3bVY)Fc<+TZ_*Sk_N0^J`gIf<>{{TGUE|}D)Ai5R09Nzx`hkdZNh+;$G>eP*P
zf4hKwSVu<DMKLTJMw;Ak#C}(XL{jdt*&A-d&2%sEyqR)3dQe8=QTX=9h`N+9h78sh
zfnVpo6~Wl}jj&KlX&Zj|&S@MCP3FC|DvGVo*PQ6rTeOlEqO3&_4yyF`HH`8eq!y4O
zosj8Jp#Y#Z8*jbfO;3Q-&#KfNJ%RK;>l#OSC6Spt!*Wyr6p`Fk!}r@c79$b|U>V-o
zuXP)Wug3vVy1N3ZDwVb-{k|WD1eIIF4Iv4>?&FV$-wKc!12DA~Hs^caZ{FB+v!ltN
z1r>BQ91ro0=5l2S&Qo?`b|>}@0!E~t7hHC>d8+>adC5EZ$!$f>qpJ7$eDO|_fj|L)
zJMm!l`ET{c2@s8xlj4Ww_5zLV@vH$8#-q%mxTAY*SNi;Lw3_;l5pC?))z7W`a<ih$
zz{XR|#@MI;3LE}^vN92|j!jFk6-079@GsQLj8sMxCYm8gHa7V0>+gJVho>Dln_RAA
zT487lZf|O_`RqM-%<G|9d_&|E3a-a|c4a~T0Jp2Pjt}AUz<7s=AafxC)Dg+}<oqxd
z>;h1NNN--lIyBqD0SP9xUmrh~A+P~t`^4LNi~<!*iF@j8z%`WdQCGqW7Pl-pCw;yf
z<j4NmC8#dKt8@AeapXk^9PGpcN;V$G{=NCa5QAcX2v3w=`9|tA$dQ|MP!&U)uV0t8
zN=61Xxf)0Nrp~|$p`98tD;3lTV7zQTc?C4a9@MB&rF609ZO!^^_~%BWM2txwFc+`{
z+1`(Bv0f7yF*4kQ0toGA{9oaSsi0e_(nZyClvUQA$S)yt;xVl}jy-$e)+{Fe7;<~i
zCu^_Y7(7XOfbT1kFMB(&H@*Ju@g{eb-L((ANC&nR(>#+ol49%>1zSCU0Db^v2Z&K4
zkyyrcGJ;Jm;2QMY0rJBftt4-(yT3PGhTQX8oxT|cER0kdqrL8M9ndUMmC|(sw#47;
z=QDw+S8zP5d-LD(`rtC@dqrRX*dD_S?HjU`K}7!mZR|hZ5z()RKc<?<p`?RtjnPNb
zzfix;w4y3E;eo33n&;lJG=EWbfoFaFJ8g^?OM+zckPgDm`|bPhg&?$7Qp0csdj9_a
z##K@Q(lKpDV#1BmsIz^y?Y)jW<obnGm6S1|V#fAzYFTQ5+aPublh*ATkz}bC@fZ5%
zP_+OO4Go7UEhOK}XeCP0(-C&tlV;C5*TS-G)Jfqi0g6VhTn+Xl0e^tNkR)y{k0Tvg
zIOMcK%e`MWg^Y2og{NjwWrb-w6JM4ylNn$_$N|zAa6lF5l?b*eHw@H4ua4Qv8al|u
z^b}hb3D(!ZuVdfSDb$sfW0&tcf?Iv=&+mLhI>e6JMK69y^cfT$q>(@XwxA0W<vyJ8
zin26PedB82_C52M$huXO9u4z;-;Qx=-H}@C1?)bby|SQR^>q?GPCTzsDus1o#My1M
znyMAgJKjvhRTQ<`U3=vuVJHTe$x1$gzs5lN7FmacvS=V$f*G#2KcCApTUMUj?~kj>
z1qBRuefadswMgxuLa0G{Y;ZaG{<%a;>LeY7lUz~8Z8{FZ>{;ZVf7S+MNfnVm*jOg)
z*E!0-HQMv(vB(J2V`i{N-J&-G+a^g;pl*J(g+a1GpfHytlEm4&IYmie?$PPcS8zQ(
zeeyxoP=KU2t>eotit*`EC<XF>FK=v_X9k+@<AKB#3g?CuvHIgQzAJER((iv<=VK&*
z1yBWWHpNv0n>s4Ut@pqnm$9eri>2-BoB#``n&#`1f;D3&3{6=GH$J#RmmxMAlfFO%
zf6@=7>w;@+0k<OBh^xl&rFi@eZQ+BfPhfp(6-fjN8ynv!aGHS|Eeqdk7zTu2yi0@f
zBNtWgr{p{1qS$c|*Fdvvz`*7#pwUk+Ccg|=+f}O&EOJJ3SO5Y&apZ{sMUG8OR@+e1
zr21eYv$CvY(v9m15TUi!!;Dj`x~OX?HX}KzfVR|k<7@|#RCP2QA9IO8w5cEuP%P&-
zZS@L23{^dsZ%hg?q7)n2_w9+Twi=j#YyxZy=CDCG?^t#X=DPG44$_&K*_CxSqVtPn
zriEfhBz71zllS-nfgIwgqj&Jg2(fxd_rbES8<UNw3l*^)@B%Mo_TK}5EEo-|41RAf
zYTofh={8OJV}w2fFe_J8-zZ7~%8^)A1c!FhweN_<fB^ing6cE|=htikK|W=w7|h!%
z1qv&-bBR?;_~V6UTTo4W@HjT)kS@48-ZauUD6OW@05-{?9%4zn;>>nC_rUE$4Oh1t
z90Q+EbBk7Y7}aV<oxN~4scIt0IKZ7EFa`2<#8xSF_zYnn)EM1&!28l5@s5|(OMY)(
zOvx`#L(Iej!(!<%N?Y%0+wR#HoElj<YFN$hu>5=AGIa8?>DUG4&mX$N2|y%U15Y>k
zRs%b}ra(MBw;NvgWLXDJ0&K6b2b$zyQWfc0WGwVTojYvDu*o|#<v;;K@GI|nX1F>-
z(8i4_yd~3GhQI0yugo0Ij7)|?2{JuZ@ACYz4N1~BO)WixqgYaY@coR<CsOiAqMJe7
zfH^sD5J<*JH<3=2-)aN)ak}1}5=bI}&x*p%s#+D>@!aJef8I%psr41NJB-oNlCYI%
z$R}{kz2uw_WPs@<h#=ipf6!*BCTQRY*CC>!t7fBK{GY=hWO=%dk*UI}ldFAzAd0SX
zJw#IU@I>@fIH1Kve)s&arnptugCmeZvqWw)p_yZOB<dD28FY_tL-D{7^$*h(5yh;K
z6t>$6-oCgD5V$(sfqu*`_V2yd*Az}?5v+`*ck-y9F1<f{Vj{>GgppXFvCj4Bg=#%0
zju&(x<Aj5)I6KfkQ{N<IX%XZhlV2f;A-=y{j7=7j>It$o9P$3MS(ZkeN{Yy?09}Bk
z-uCq82+pdi$_dxMJ%_di>3^3XhD&88h&xyL_RVrl4y7@~9FNC)-}21Cqb%}|EhwVh
zjqp7%E}nG~%`*beq{ON?7k@xM9OjB611CxmS%^GY_Z;!R;hZLZpQwglfCVh7bdNRq
z`s_b<hzx3FRhTJerU6L+U`wWkSvu)rmNNS7Lns@8>6hvmBXoF!M<6t;TDGBQ<B@2{
znn~m8l07ldt?!+MUSFrv)I|!(5NBd^?riQj18(1r6q3w3rHLUEc<XG=O_v<;_1^Mq
zOvPR`Kv96_kEc83CNcj2J1at}$frVtCW!d@a&nzK;o4M@S~LSv@2h&Mzu!1UdC<+&
zvDsup&vrh$?|<Va)3;KALEbV->Nl$Ex9^NC3;zH$CYiOeH52~;EYYRD%a9Q)D#Qm?
zMpIk&8~qLh5AyE|$n=s&_l5oAfA#dlW_M)>DVn{$pG@cI<z9@)4y&TWoxOgeE77DS
zmFB8YR_}k76-iz$tPlW=)p!6MN8&sG0FRbNB~cWyJL-K^skW-xzYoJR7L~fX7ZQ^|
zuGzLenNm3f?tE7o=r7&i*(Zzv9rPkjnU~B~oYmFXyw2xYSvG61TDJJ#&mK;t7|Ai-
zK;uZ&v0eM~>4&AgM@-SirFXjHf0_AY9A}CKc*-dPGg^t+y>>hN_R4hqI>>~y(Zuvz
zmO6)hg<TViC@dxF8pLkE0v6Ser^MCd)g?3(6j=P!7V?cf7gGmM*CI);tElvyXWPBz
zUZD{_=bD&}KvkaA>M@$3k|7$XaklG0uW@&RP>Na5Ig*alKD%HE5vHHTm5WQT^3d(x
z^1WOlCyo4ZCHajT(?+Y<@rlyAiP}YbbkfRC_Y?mBc}AGS9HJ=IWmv+oVSC>E@NhFJ
zV!ksSYF|#0Ec@e1?CP;bX<L9mTkmA&0pjX`0{~Z3P`W+-8GfEf*P@+SR#H)X<NpAs
zkZ0&tD4CB?L14fDNu%@i^zE8@spF0q<%Ag|rxI%$0m6YtdLOfshogR_QRJR8$V01|
z9)pj=CbRVE2@*!qy0E%>QS|-%a3tm3-Q*3v<Z^ib0C=p{v7ap{AJe_hxfxq>@x?m_
z2)0ymN%tJ_mg!_(mS@!vF{_Wf1@_x*`_=^3N{&!8lsix~e!sply+4TzzstuMaL7aI
z;P<dW^c>)vo~P|5V8cQ@jM9tv*WroOO#M1TsR|nL0o7zF;D6t?0?Q%l0>n!liB+wT
zUci&ve4t*PBM1Nw2&RxJ<eiBB0I&7MAeJ>OE<<i)U8tI%eXH}tSp<?Ki!oNz;n`4{
z_ddViU?j@Wb)FC?fe5LQgA3%4LHEY#{PXzp6X6yCfIHRSKOA%5h}K9_RV!?!Q(=_t
zu&<BP7C#b6N_5tWY1*uc6hWcCz7<w*k<6V+2_(|2jKm!tYd>Fo_RRWqxw!+!8Pq}Y
zmMnM!<%;ncW@6N1TejSa2b<2;OP}fz&dW+W1vUx!UIEn#^=N`1#h5t+(63M5u54$n
zoH263M|K5>Bq$<{bHAY-{yBzKg%G;PFJAg@WBdH@%{+=$L!p5h>>bFUD*pfsfu<>>
zMI6d}GR!oB0lFZI+<JVzu6l+Aftp~kvdm7S=4w7_J^20B2>Q;Q<Cusm%ceWnsV8&r
zt*D;)UY<F+pAV%@m`x)R@t_v|RrDN<$=@iSNMxL(!%K+Pn6+IF3HAW|J{B=rA>eqb
z>STA(peZe+ixu<tyn+XXoa!1H*siUI%emi-w@oCPNL6nVMFB&B!5fk3@xWfG8Yrbl
zNXTLVDr_MecG|ec&^nOX!gz2UR9ksLAalT=N6Q{kvK9Vhh?&()T1MIcI|1s)Gb-sT
z4~VD4BT|m$jeR&c48{P$D6BDIXV7qL;xo$&ge>=@NNk?tZvK>WRBC5vx`aiJ)Hj%m
zEvl>z)njjMhEJ)ERO)6$aLW@kWrFN<>;d|1fTOMp)5REwMj}>lz*}1|t@{B&zurz|
zM`PhJDH8KS%JK=Xb6-rV!y8E(c-k!ikQ?$1_TcsaeE08$E|9_$%m9i10H~w`b+*IY
z0uQGC*aB(f5&r-#YB&(;)5v2)2H)awpbH07r3y<b(xgpqt=Q4pslEr>oTu6mblpc(
zCXPelNczYpQz&9i^Z?Waakl>eNTBLvlrh!g2Gt*k+K3&^9_0G%&IP)c5_PPQj}kDd
zqf)31rD#~MQ~v;Yo@Oenh07+TG)Cl$9N!mx_vbG%NFsMVN}X)_P`Em11IJ=PtMvyZ
z&~*o;kUVEwXeaKgZhLMjwl}r`AiN$F1F11Qpr0rT&E^Zg*Pna>B<i4^R+$ymHb&gN
z0pH_55ByExT|dheZ@sB+K)N1ntns~lPo_o=vEnjE5vvRdv#>vUxAeeh!RgtxP&!Jz
zn+!JC*I`)m7x6%ZNX}fd78+TsU1|Jw_3gGwMg}`}1;P8G?XR&sZC$;6vrG>xu4L(!
zN9w^nNbqm^8g&*tP}nIXZ~)_gRQisk$5AUx=`^Vtq;GBJ0)VR=X&&2VUkX^^Dy^;+
zeVJJ4Q`nDsU&AjCSiU1gCr*+h1ybNy8h12yqEFyX7lfpPr-jQZg?9+N5D6sw0XvPp
zI6;ZbfeJB1b}Qye15V)I&wR{=MwUbfR@k*Z+E2avW{#>^V^#4=-mn4_L|ER(wE%YH
zW5L$9N7WXMydpyCvPrN(AbcrL$G%ZH)>W2Ol(YfRNT>~ML4e=cyZYddqmoXX+)Q1R
zzP1!Jg*t}+03q@DWtXK9bnn*qGf5G+^&#0_k0PjzG=5__WF0rzazv8KS=~v}JgO+3
zPW{CJvEKL@0vWn~snMMs$qdY615lx4djJOBn5V;^r;TNl{{T&Vp$6<M8ouXt;~t<9
z2&Ry%ppxTG!Nu)e>}}iM1S_M%@~Rlh$q`nv&0}%!_w0R!Q8ZqosqvK&luJ6Qfv_%Y
z1>o<!)%Nd>nkAT?q2!J=Rns8zH4P$#p1>OUd_Y;`nHkFh0~tsg0L)0b_ObYO$&Q)Q
zC5;^(LZPovk!rmK*5bGI7zSwviqN}-Np!BnZ$*2a1&yz_KDee<M_!%aQi|ScS~px1
z-;b8$d$Yh5R#aAGlKeGrZ<@QU>b@JC)i~+Uzf3xLVx1rnv`%$Ypr~SQwD5l{3~S)W
z)U&fQ#v=<=S9Q12{qO6PPqgPfS!kqqnUoSk8nBca$>)=Ni`&x|sSM&ac-A$If>>G>
z0Vm>neQ+deBcN0=h67iKXjomrKAxB#tN#G$bb?Q^nd40;dYz*qWu;PUbFsV6rGya5
z0sjE%e~kIx{V#|A0P)ZkP|A9iePh3oHs8~amVGoS=Su$o@SJ@!eLOicOm$9`i0>b7
z>YSuj3@6>PaVb6+^>#UE1&B|xoXx1KylBMH())dLUq}mmmmQimc=+Z}l^ULD80OxU
zRQ;b2Q?_s8{F`xkK!&=kaJN}Tj+o;j`D;(lJqG<IBPSTbM)_I-to()(Ay9Pfwpgn;
zrrDiYKrAR7h38drcEi`bbbFfqqW)tMO@WxqFuio3KKL0m?`HVLCb5*&ZIet7A6GOd
zXR+wnsxP$@y~f_Xvm}eCU1YS8n9U+sO=4c`eM-0<VBVQfK(Ac+_0<{F4H4;@6Rwgl
zHJwA~b6n#6F`R#=uOZY%oa&)s^9)~TBair>eAgV>hV*k>)?tRFRW-Hk$QZ=cmDpMQ
zvSEQBjN;@k9sZe!uEj5F6_a${&N79o2YzeQ3$0PGM(1oQCjEBy&Uf(oS>#c=BQ^X6
z1LoYCte4sn2)@btMql{!(jWf-6y;aL{{R3DJp}T%FLr-_9Qt0X`ce*QqZjX<5AbSV
z*zF>Xte=M&?CO51aKvjM1y%K-u>JezG)CCl%U4R$%PPR9eL9%`0KgtU4D{JTAc;w8
z8<Ka(^qn~9(1JrvChp#+9mrpwInhdMx<n@>RSkg5=WENKHX|*LGcr?(R_WzgknXj&
zu6-iNv%-?c!wdLl&AOgzHhq)U7-jHXkB0nv9OdNV>W#xrO70%174XK5fNyMPP4Z)7
zo@~RF<)HBAm!}pyHZ|@$ei&GrK5sC}eV~R9v?J;^3o?a25&nq!Vo61qim~53O!Voz
z!=kg<qwJ%oO?|6xu4%d>W4>hjDN4yMq00WbsPmk+cH!`+PO4-)c}ClDmQX?8CjdHF
z&^Bu-3AP=`*!pLmns;ZRiZu#=x<&3t&W<oxOJ>%<yjas#pD`8BzF3^(&3@X4PCEU8
z+yD?k@4nH=gMisR@bR3JE`tm_`ql*(?TiKHQ5ykQpO!csj~ECbUwj~d3n<>RZEB9X
zQZ^0fa%JdQ=km^GRXWH3)f1mD{B8Va)BgYq{gTt#zf&cwF`w>lQ|vqD+;p6midW2}
z#-nc={{U2fj$7;=hyMVF{hufQ0K__#BT}8=Px*X(GxDF|&$1h<pU0g`E$w^jZ+sCi
zS^P=%tMy%EjU&j{Bc6T(^3S&DIz{QxV?_x<w*JxnbMC!6gB*N%pFeLWlb>^_JP;U>
zg$=f1JNpdLq>m{hS>%uG8Oo#(NB;nDzpg2u8B2L?*}YGudX6Ho3;jd7sihzCIi6=b
zsWi>IpF!!5B)U%H%yw1(0FHSdZ2heV*?kP1Pf*l|H>0~Az+-C>x1an|{6P=ceJzha
zQ6M4+hjae`BkiA-N!9foS5YL+%`D7Wi#3yEbMnofX??NO{ioNSvT*UXtw;#_mB1du
zJm+dFp`^V#-rM_Tn_F(GSEdROnxGqP`1~`Ote~qK+VPZ;$}@#pT|^7!xT?fD6_sp+
z2h3NR%vmWbw2G!ezE3D#2p#L@NzO4WOd3WK22GW3ZI7tzK)gvhgfp2^F&N#fkGg&y
zo`dtwIz(>MYVj-;RiFqw@$&lNNfffiDLAS$Yxm9>G^r}q+CdzHzrU_1ip{MZwimzq
z$C5OQs0dGq5}n;a9v~;3_v6;E7&7=n#L=lnpa|aXt8cFLjT}xRc2%`iGHPS@RFEtW
zj@TdxsOlss2X6OUemK!FA>xiTV4$&<fo&uJ2Q&aZ$F2Zo>Dm?l0Nn94ZUs<Y)wejP
zsJgrsw?Svb1AWH=&71r_c&^PPVyvutZlD3q-uz`_h{Mse-V>{d6fEjU0MR-{YzgOo
zPpJtvg#nr<XYoL-E~%t9uE%^uHyI3-D6@59s89pzoTM_eaw`@j6=Fvwtlz@1nM*h}
z3!T|O0Y}3CN>lobtaoEdMHA^qkIOg|I==7T@|q^7ar46w2U4pb8!*+yj@4fIT_QNx
z5h0DVJ0`#bSHCyyfiu-fAa(H-EUT8%H4?iGCai3D<8NVrNP!-mn8*&I#NXZr=f`{u
zg|v_YuugB^Yro#(5*Pt>4rp({<obPfyeV0O5IInGp~vp>z8oW@Nwv3+;xK5m)|CNB
zAo`L{-K!nhB1popBogFS)v*Kc!Q-z}7*QCEM4D{|?_}=A{Y`u;0u3Ql47M2UvC1s0
zwy9C6T99ej@AJfz+iaQ^fdGp&T=wTE%0dP@0n@Mzy@N)_uGjOxNI{W{7SaH*=Jez9
z#Au5aZcgk#Iawmn4~V3&BAtNPZ(v`*3|Qb|#Z^?2yBpx&KOWya1uR$}FeI+~)lkNX
zL0e`XPcc$AKLhZ@(JY0O0jBo=><=HVE`Sx8PYeJRX99%<(PiX<ZvKDoIf5nlTAF}6
ziumomblxgDqsXi@05p(59MP`${{YL&6bUz(W0bNh0zA|JKmO4AoCPu2W<miyhb!nm
zOycKEaT{Pq-K(N&f$*$hB6w)qY->m~TC1OJu)-yc*Q<@I!6Ab+0bqf(o$Jei9cdYH
zqT06G?w<KZ@XV;X)-cC%K?<Yu?TI4EFHp`~Q?oI(qp7=_&Xz+Vj5};Lu%I3H`QaSM
zA(57YfI~9g#85Ts+~Spyrl3o=s*cr^8WA5`9YBgw4SV0dN!XSI4Ge3IzIYaA^Aq8y
zMPRQ(Z*R*IW=CMC30eRVwVEEdn!p7J?g=BD=~qN(EP2I^_ZyMF(BLs6NK_ozB=5%+
zhSC6q9GAa1AQ4+ozpehcGTtGrcR=iR18?=5V2~m?Qc;a7b|!(Z#C>oJ$_m(9AQIh$
zlh_Uha@r=eU;J<4KYv_l(Avj#K%z*k{yz%EWjY9DVIU^;bMIpTOAFPZN$-{Et4l~h
z(H8GS3%#p<@sn84#$3p{hxYGh;kE~F5C8!HEm7W&ueJv>vVaei4X6qyzW%sS(w#a<
zt2gPl>yH{4S|yG)a^6){TV^%4<B6n|Z~e*^PTX(@;&3?0WQq-`YS?EYwFO(I*p=ji
z+YN}(Mv!;159EC@#*opjvPFgmum@s5=W6^i1aA{plE52zxZAe>01QS(qQ!gfX1@&Q
z3V375=K<6AQ(z9{o^Yy0f!9+oW2DlkHa*TXeIpj4`bMy%u%X57co?1(k&hA8l^Bp1
za8G^my+myb2xMBBNCrJ55PkjfgbD#&6a`yXJ-7Y(Vgd~k2~c};^~z4DjT)gNShAy$
zWYzqr{P9*HA@a2_9rgp`kP#yJzo4`eVow`TKIb^ZS`#7Et|)W&j^v-q>yi>&n&kwo
z?nX2+9-dJ8Ls#~(HSRVyfzHm+s>oZ&DM8>1-oAJE;($oA$9#Cx#B^39mNi|?;v|ee
zx{t%R8BhY9DpZ>!iX&_uA?I=q%mJ(R$^ar#%z%d23`U^l)o*&PFb=OOflB-K?eW8<
zd@xqo?|LGu(y?`rG~SSVY5j1jQrRo8)kl+sJklwRRcz5V=aM#|h(UBN3M~LD*E>;&
zHkPo<O=BHmQw*itE`S&gY~6pH39@O@0}@X3IT%3kSr<tH>cFyh{BcV%wYB9^6Cx`{
z;>n=5z5f8bAW0sA3~V0H6}YcafP)Pe^DB+C?Y;{C0G8}O4B;Rw30na1fW+`jK~{+0
zbMeB9BfChd1%gi70bcnwWdhe$tKU$^jHy<&C4jIFz@PfSiM!dp6^yYGx{ZN#c+m?W
z8Vku7@=S-OMO_vdn40r^3BZ(Pl!6T&FB%xkk_1u<o(&ow9G`3KPXiuU^sSZ!`>5^l
zzz11oX4#3cLcW-w68jQwa(!}#V2nsAMSv)uo+_3ifun%l85Jp77C_&c!~_ya6fl))
zW>p~p7Ei7qU^gG@0f<cuPQ6#<J-&F_;#5$ei9fiI57QNQ^J)YGk0>a>ymVQ0E&l*@
z;7k_#!?Ew{fvlTj_*OTW_X|VNafU;xtf;D5QCJEHsv~^m^4*V~5*P(yq+Y=K;d(R@
z>~_FXy~(h9jCh93MOScnIMXaZMv$vDs3!To<KdDPyV0+FfrGm00jpNkT;c*0*&KGl
zUdS{&yKRj^K+N_>{{UzMlt}6aQ6wJN$iR@SPW+rD4yt4D#klkeRuW$~wO|ul`*DCB
zBvpawoTrgn`ePJTWdm#3ueJb@fj6WmJ%?;kx>%0+%tMjQ4@^EqChQK_1!Gc4XH-3b
zzzq<f4ZGGfjErq;dfxb~6cTKoOa&xwouu<ydz^KMpD-Ry#PCib1e0LU^uYTu)JqJN
zC?wsE!0*mEQzUIG0Ze}A+i%$!or_7SrBI-r*{vjQpQm;QU@C^>V055I8mdR6f_d-l
zUtEwrN-8<Ae1n$hkMkiyt-b0bo-%JVaH~4`jnJ{r_`otsXMvfT<S9S^4{^!ul95bN
zMWh-4**stUVSf@>g2XADfK-i++?-^O!$g8;!)Y3e8{68r$SD-UlTr>jUi)IrIeCnL
z*O-;P%KCnTBcSx%R)SiAut4oua;jTedD4f(912JzkxbHaN&_)FFSob(!}d&GJnaqH
zs|9MZdS6P$#SfQJ^Ks7EKA&HSBF3w4KyO?8P6PEVQ_85TV^BJX+p({FgM%!@TN)PK
z&iv!44jM@*Rcg;S@IJWHs>;$jI$tBiJD+O#emD&nD4Ya3Kmbtp`u_l|n!~PBY*tXB
zhML;(=9LyG(MdJ;kEf<9cuMS9eC`2OzIOirKb8f0q>rUVDHzftv%kmF;g8YvYor4U
zGpgF^J1+cxyiT4eG_y-01mUdNZ;<)q`hu}b9I&yX+pXOXhi%3NnffVVMVLl(azIbL
zwemf)6F7{Hqs*xxAw~L8Kb}8XBTE1zlB087xAp9H{oX8qL(<0$3UU~+AlJ4AhhrQG
z)oWdP&YjPjoyOJp`eXv0rOU#uByE^iB=S!G036c~^&<$HOn`ugR^Ggyo=znvsVgj=
z8m;QmY=h6h?}ZMh?AiKQ{7J`z2I?4Y{2n`O%g?S#IXc7Ax-Ixbn-{UFKjSWb(3)6$
z6qJ-^49Qzq9G|b}iyZ40NK~wHnOJ$O+JWiw1L=X9AtVK(km(MfA7Ppx>Gb`eo*b;n
z8u_dNNAbLi^#)$0LbV|QNnyYH{{VTaDB+4`Acd1*N<}HY4f|dOYL}*+*^*HER^wy;
z0C_IAOw6;D15YS86hB<qIap+8>NK|F;p@l4^U0W}>LFJOu?+<8{lkj`zkCFWc^zB@
z4X6NZZoUV%%k{}8h^e@JBF^i#?~Ip<APTBkbssRVmU=SvW+>!>B?1ScNj6PUuc*M6
zN|3t)J0G}3l>}@ytdWqGpiPoat~C!&*~;{jGR9*l8p$nVZ9L~RJv%0)b^#59-0D5Q
zQ-F&1;z=T|v9T%zSEX_L-ySGpUa3`B>6c@sj*;p4{WChdtdcU3TDMC(=BU7AmEoMm
zn*$iIPX4|Aco6W4N&L7fpdFs<4~AWw#nZZg3{fpKgx#Cx=f)(GM(r6@4HN^zEE{v*
zZT>i9G07M)$TX4W1pV(#s{v(7DymV{NFs>z^}L&=xY2<s<aRZ_9+hN}ErFu^p=)oJ
zJItvn$10X6-fsJP0f1wUG|=UwRse%tzBscZE~rBX(!rIKeeV3$aWB-L43tkM?xgQt
zqZLhBLm?aTHn2PG_2(eCm0$!!(a6VpDn|5demJvqYtulp3V#?V(oX%)9+<GgRY_1E
z!~{pVJA=LB&(gO~I|qr&kffnI4X<K7w-^JV>SF2S4#A^%LlOuZF%$;;jL+0BhSF#x
zsbZm?w-;72k{I50mP2sJXsFzV^~aD#$m+7QlyVS}u@*2X*9DWSmRMM_=u{-QcGwN?
z^7PEi5b6x&L5w$Zcfb3~85T$kOvMxhEu)QF?0?ozrj9QWRg0L&)he%QzIeb%%OsK*
z^)w(4F&i;F{{69|>Dp5&w0<U(P@0VrF7^kXOw}||%EoazL=W9X7E2!1IO6g>G>W}!
zWOWkxe6inQ?eBOQ%%)G~1%)k7w_-RI_+lttoqS0OuO#imR%x0b+Lj>IU(^k;BF^=H
zhib^ja!*}BVH|#2yC#Ofb{JNf8KVx%yQo-E9zVRSrq1W#_#Bjx^%6nU%F28=kVaft
zuQd)k?OW}JDWlgU^T(xMNkj{^1GSs6!Om%4T(UZaiP>m&B~AR!_z{SIEg(l&%4}IV
zB-YpS!s-@s&7nyo=^u4ydI9-h@n!0I`6gWgS)9n1{k!jbRaQS$6Go7QVpeE_kU#~A
zvGlR~ydoo1@U4$2C4gcU#cy7xG<1K<bu&d2rL_35pirXp(X)NKe#SDOiFG6DnNzX?
zHG{bCV{82~1A3iM1$EE>-j5)j+>9!-^r8ju&zYqxRH+AGd;Kpb)VPjibapGcrGIg)
z$HQ<jm#LN6Ws*YDMixDMh1#osYsT<m>s+LN(~LW4LOj7}k!{C5xD5wg;YQKA3q=;E
z`^YM2{SFSAFwk`oDA3JXYKa6{*!ocXv2}QfG>_u=PWqYHR;sH6Ut)cG*~33iq5(d!
zt5WJp2V%UM*pt8007NR0ri)PXD>Z3S04JW~{NVBWVI)o0Yn;g%0?O9NH{0CRRtck7
zArg+CN`2HeNF?_7k{JDcF@Dg0=3Trr5g=7|R`sAR&i?=}(|`*c^9ESRa~sGOA~?QU
zy{quVl0rO^w1r7o91X`FQhoO{PhvAyO2em=$JKQHG-^(@B!WDr&9xtW_S+!L&`Tik
z8Q)}AQgo0kn)>@-Db$k14xuEBs1yNqPh;!I_4LMI&kN5j=?_Cl6hP!`C~`hqcg<ZF
zOz=!Ph*2LvDj16wVMUS%HK=|$o)m7IR9f|iiI@#lfAJOTU>~LjNi46{nd#vYTSZ3M
zYwpqdZ|#W5BvQO`stHhqEqjqxMf>r$Bk|n?QFL-YSE(nCDFOs87^ongIW#MNFX^6n
zoJrI~bg_E@lsB1y{{YL}Y&}053M_KyXHlj>ABN3D0H<wUgWmmdqKC%n`g9-&pHyy9
zMxdgBAYXoaUEn=4$<ogL431WsLQcZ`px?10w?5pCsQBGWNY)w9KEuqdLx3oAwO~L)
zBwFJ~y7I9mj{?WTjs3FyENdI}4>W5aj0IqB$v35ks2dzTQ0sbaEf@s#4CzKNH5N8|
zR@-bi+a)_I&}C(`3WeKkG&Vl9+u%Mx(o5saz8yxSg(?NrazH-6>jzIP{VFR&$5X~Y
zD(6>+<^&)7PWSNMvDPTjVi5{>^t_L`C@DcF*bsiB8E1$NoIgw`lI+6wJa5>6ME?Ny
zN813(iwrT&j#f5}Lk3VO_t=4UzW)FZVUvznWit4Bj7y}mH{Z}2s{8ClFM;9~A~L}>
zFe|ZOK+<c9-|_fm-@)m+KM`X|T{I%d)>rPfrJ^X)HTU3r!x>gAZAndGSTNqst`E!c
z%O_A*tb$^(NRereLy{w4TEevuK&#;3k-D8yM=I2js>Zs;lB_6_cH{wHKWycKWbhMQ
zpvt7Rc6KE|uXSCrio?}Jvx#I_=8XXUlQ)&N-mAXAd_K7e8BbKQ^vU3fKH|u~bT9(_
z$2<Fb?Cyd!>KO|7bQFpN)zCZf<^yrrtG*dpUY1aGi5!s#L~TG22BJCccI-{o*#YVU
z^h{&wV`O<%S>8dYs<7vM_fkFg$)d&KbnaOxocOC4An3i0{<cMX4^fxuVtKlzPN>Yn
zG(yGL>UAT?Ks*ZK`w_-Vtdc1@jUYT-I4Z<B4BUB$<C^2(J7oi-=?74;s9!9)+f$M>
zD%&!XTlVzidf|?F<Om`08c5=$+yaU<5}^7~yaH74P<VcH1cwh=wz@lSzk3|}3UUiq
zPaL6?4LVR+lJ_R|CjB|sbAi(*RpCL_X}HQ1M+5+TwBHZCzpnl7Ck%*Voa$2Y5X#`2
zZTAPz@AL=O@<YW5BI#sE>@w@Ezv2b&$o-4TvcMUnmPISHijlV#py@sK)m!=;1Jsp;
z7B(c9Q9=eM%5_;j!*V_O%Qs5Lr!tgr69Xh=P=LT{BE625;_8o~8IPzd)Ifn_3ossH
z2&V2Y>*<XrS3isludGI*l|ZFaXUYb`uj_&P7yg|9KZZJ51nZhcbA9hVgQp;f&2u5o
zp8o*T#%2B%=#h~4x~6yEzP7!y=ppj>Lb%jUZ?A_QUzD#Iwuj>RNH-AtA0yNM0Q9f2
zyJev?tN#FuMCMIybEOl#q0OBPHPA(=tCP3KF-t-dTnL4Ib9>AeriDPEp?@su;>PaZ
zg1eKJQQFA$#A!<kJ7o1RBG1I)l72qf>BMQ>71El(=L*Vdt8Owtk^cZ$*Op+?Uud|J
zC{PW|zknE5U<bBJa$l;2c%^3gkU!2_HCxL@PbRTf#tn3KI0JUh=i4!ARan+@3*Qhm
zY;o1WJKzDZvskTXoOWHcWbF6Ch1T7UI!!D`$kq8`gI@W>@ri>?QT?MLpE$pUY=^Fm
z*0oXeIpq(>11Qybu5rY$nnT<YZ?-sM-R$~jgtN^FwR2vFHO2OcBhD+_X1S!p38cf(
zVXR$olKVjn{{Urm@gna1Jc<XoQ-&U>I@*wLY`jw_Z#M^#?U+n4d_V9BNBa}5jo61+
z{EOVSrPzKyO!~jGdQ;Ls3xVRc=i4b4LDF=xyY$g$*4m1Vh31z9Mxr-4g=wOD&eLO~
zoyo})s~Cg1z(E`Fn;3u<irC|Ny|9(OFpTYpZBEzm8FyRbB*328B_7w=omcZ+IaeUa
zocoN>RGj(9rhbxjm45K;>OC{)(b9O<Sk0>o&o_~argsi}mDKH%?Px@u133p&BuEd#
zpTL~RTsnyq01o7OXRuLZMn>IS6+Z)>3|9zfTCOrwk3*g>Hohe(E&l*zuwwqCei@;@
z_oig~FaH3}q$|gV>+UmK{p%U!<nZsn(HYYi2KV16wR@e8C{aOu1~P<c1ZR8Ry|c=_
zwL5yWj?2cO6tKH&SueIZBK@*&vk`Z`aNgUUyDJ)ip@kOy7y#{zMw+9TRuuFJt+11)
zZuo)r_sDe}YC=55+tW5p>sZ{fraM}74JCyVO#zs?pS2@RlAQ5*=k+~v&0^?!48c62
zG%Q-HdnatsZbZ*&Jxn|Zi0a6v+P`hZ(e%>wT~yj4jY|{hpN9Vc5Ph}O{{R+!vS%TL
zW6Kf)vak8iL-^D9reC*uw&;3CC!<E~{{YlJzYk2+{5AF(K^OBAF8=xUeue2%iaq?l
zDgOZR<9e?)zxuIwhW`Mt{>opodQ>K!M;BS@p+&oETipKu$m1eg5`4Bi-ow)bmtuhb
z0KtD;`k0MAc4ubPY>V@--2VW?WMp+J2nRqr5BVHdkSJyBH)i!YmPxf$*s<jvnL_n*
zBugZdI;c=t-MCSolK%h|e-c02{cf01m!ydK0kBwlo%7ZHHvT7Wx?}cdMB~6hd{?^h
z7!APn1MxpB`4&>N+Skm01P4)Jd>^OMvsJD1=*LZWk?|yDGzkhUD>Z>zpNAy<bCXo)
z<(M<BotT@hHvB%nPLR2W&muFIqJ(*d+>`V5?VT)b(!{MSL>W_5MTL29?+=(Ge8ISq
z2G^&kXVSi-aq#*K<?#q+Gz%@3BKACGVg(f?bOAMhN$-8R;;)Zf&KFOZF?}b$72618
zStpRHsCRLsFC?FDd?%+M0trGlB#(gq06$D7JtaXPFjCC7zqjT-8|NVmtXKvrv<-fq
zynQgGC|Em~wriv7zWHe)5v)K$${wEB)vs^D@=Y{|N`)Mex!4a+h{lY(a+wM#0eF*-
zFgyJX;4kw4>I}f@0G6)cAJqOBi~_{p)Eddr;f3wZ-|x0Ms}dw=w5!_<j{A|d{0RAC
z9cXRs1!`TlJNCQ^J2a6;B_g8Qf}*JIXxAqs<ZBSctgfPIxx6MItz_>&jw|PQTvCLv
z%xaGy3cC32Fe)IIz<E$Mk+A^Xo@o10lamF3Ga}8TojYyiAnZ@Lyu7`4QT(z%@&`h7
zm7pks)xCe@-&~AOFHT=e4#d#}@J83ae&6E&%8IbF%0QH|fHokh1mEN<B)Xk0n9#N$
z@z@jdKaNp6PqZco&ZU6+&cF|uKfW+Z#$9qEuk~8A0pHsQRshBwYgZIId*8XvbP>&@
z$^9@$E~|frQ>j;iP@0jE9InRJ!QX#R^NeDRyxu6+cE}g|cH`fEJ+L!6)JlA!$pVh#
ze*XY_Wwa;)K!B?)Za2H<=~#^H(T3MfMOU@m<qX0_jb2g!^08&q6j<C~2tbiuRtQXM
zs);^ee6&5q-^k?5TLP>vNn!~Ch90IUqm`nDQ6kyW<Pb>hVDWn%{NeD5ivxWjfEH|f
zU~@>)Bx=r09hCjmzV-4O`(PJ8QUWrPPL<R^6;wCLsw|8_I!&7=d|)DJj-pXPu|od<
z4X*(ZtZ2l8V9+NONOd4DnTV{@)k0!uqv{A&(j4ffwL6NfxZmfIbeRZ}L?AiT4QxTN
z&&d8b9O}YNAaX_e0&$SGpcIg3(Ffa)r{|YMMCsy~Lb8Q%s5|V#u%W+Zz5O`a^Rt9<
z+-lmHZpIY88EJH}2ri2r0QqB-W&{X<QA1XmuKxgB5yl!eX0S&VHuwGfFzMFr(Y2-7
zG&U9o9r+kSw7SBeQKdx_Tl1Z!z)`zu6fZdljgFvQby*exBjde(Insi$rK5S*Rgv3+
zUZZYs3~l1Gc!=y2YBX!-`D1kKBw%GvDKuYes~lf^K<yUx8AXHhz^<AZO8LtQAnc-z
z{+~<*I@3^4NI#A$M$SPt!_ae@WPcJkBXqc<x&f`I?tWaF?Pu3@wIP5SX-<$VhGJ{w
zx8;C|B`H7w1PzC;z6jRtK*)4g^v=bB^vbkm7=);SW0`0cJdszo$2ho(lT1z-0cKKf
zed~TX0N1Cc1Oln$=ncl)oH6*8SY0x;??8Yz8}qgpqAZNhA^-&_yC-qL`Q;gt#F5c7
zDI_W}y(7~Kh-L9X(MmgA<Hr(x_hu`8V7<pCj~i|E#b62xRtK9t-LY1R`LCYX4;tw!
zBI;49>3a`jjU2MT>gbwWkX4viKDG|TeQ-0$D+tSt=y{vaP|l1A93!#QcY187zH0-3
zGMALPk;xoi%N3TuU9|z&>_^K3ENVyIDYcWa_x*5z;gDZoPXO<PbZ9g%X%R(}XMO>%
ztzj!kYP(fEZa%p)q=R~i8xGj(BG|o4K-uSd+ws7Dr5#ZuVxSwe?v=LV*B}nJ*qh~#
zH}95k;le)5;2P7<z5cl=P$Z3}itXP5?JA<Ps?oh8P}C@n!2b6cofNfzHyhqCjff;0
z3&orW+FXt`0u6Wh;YDLp5oRHDog;B~@cnYJfz<U2;t+^ib_+pAtqeUgbowS8Lpo_j
zF_m3f+NdetVeh%g$fiN4I*`kBdB51g7ftHZ<_*amx5hPk*xMV}ay<?-ui`}rE9F(u
zdar(O@x(zzf;Zk5XLIXZb7LZu7GeVfq;6}|2wps<>i6%QZMCzpEKS+FH_kA<1>KY#
zR1&P$bM005<p4UaqM=DOyA8*~IU0$uTo6Tj;X)ZeW+ksk2Y@~~(jrlH)N67G<9s4u
zS1YJ|c)|g4$QXfK6I+aBhgVPHYg@b0I}g(pR63pf-k!J$#1JiO-uc5fk%bXJ3M0NW
zsIjusf=C3``hFN3#?NXPFLKrM$P}qoRgrYBIAvkt9V_JQF_x*DkT|}_6aY<KlZ72d
zKvXK(+>&qvU`3J#7mOlmVvVR>ZQm7SVgi!ILAp6Zt0<9#M6o+5E4_Q*W>y7Cg#b{~
z!9KVH0Oi#v17Hz&tlEv~3P-1WfwYED2@CShYBYd>r|%o&-#N%`H;-*w5KrVYw6gAL
zYu|jRK)Toq9^3wS4c%WJm{)cc^Q>}pe@#}wZcjK9Qq9|q@tFZz19P0LV`g42V}O&~
zTHqMi>F~9kB=LJ*D-9;T_s<!0>2)DV=I;VB>E8LOzyK0OAEy`qB<(}vjjoh|{oU|*
zWG1~Wrsx{jpG*!uYPJ`FX-=bCaqpB0WE+*Rf4Jfu{JKSs_&|)3cs%ybAgMM<^%%gk
zO3FL(4s(Xw$$E&`cC0B0z4L$~j~(y<cV@DN^exxM@HkjgCm`$(zD$r8y_3!{+U~&Q
z3?&E~)z#6!3j0wXJXS0l<AjhXjfnQcOu<P2lg0PK6+t9(w;9B;`Hd5VmMlHE?ToCY
zU&;w1w`>FoUiTYwfK}J$+X=0!W8Vqdz3>AN7<qxgxf>CFgBws9gKm3ZRkLP*KDbxd
z&l9edAeINY=O*&o`L|C_e|%=OpQe$?dp=WO3dw&h{W&CdK|~OzlfDHsYJsJXirfQL
zc&d$IU01%`cJGBtDv0B1jQ!<1UQu1O6hMb?Lnz~JFf)>4lSZP!LE~YK<Ftq<Q*FPf
z%E{C}^AU##G_K~WZ=Pe7^vmI>eL8H{`M_sYGBYzVvqQGk>6+2i2#t4A0b*DT&awU1
zHi`(cK{(f~3juOWv@N#-0__3SB+yEZ0-dXVJNx7#XJP>ev@hSE*Esaep#)Y6?#GH7
zaqEOiWm2**R@#_?0`0dM1?Gv^tc6f13RwpP05|+QWd70!k|5IH7{wMog#H|77`lhk
zQ@t<|jXMh7#h=FtO95x1-c-AB=so^;5HZ5qi3~R;+}Hh|o?Uu%D<6pLPu^VzfGWu!
zT%M6Dc#<$%Yh_i~ciXpr!!}1r)m$(AJv){fd+wvxZ_g;l=IWeB8UFy=+Vxj$z~k2^
zI;?#_hzo8hhW`K`jvWpsB_mx$hyu-zjsEt>>N;1Be-ZXzqUiVEAgsbGj2RbHk8B6)
z+us+hR-8o5EkuCnR^rWFb{u^MD>HTdEOCg}Kr|aqn3G>Kz#sRPNAbLxgGPvGDX@EY
z_4<qmbt<q$65oi9FHl<EuCM%MUE`OcZl*RwV!=dwlU@FP`(!$%ZmHvw!0-?Nns@~M
z{{SpSkiy;=0rdcBPQ!onFf6fn(J6&MAd=vpy|DiPe_URrl}4QcCRHm+hM4!W!0+_V
zV)3gMX#g}v<o-V)^u}jtQWi8-j*+Mf{LU4cNEbqo%2*2wI6HBcm#8F0<(ejNLx9^A
z*a{Wwd*Vma%CkIL6{Ar>h`*+7f?^|N>O#w{SSpjUUG6CFxxbbM5Yj;)K;eTfrZszg
zKP<0LC{T2)j9d*Nb|`*d563GJmMKcYPk@9GYj%EkBBbl2jQDy%E1)%T`#2M5(OrC@
z*~Nlaj^4fN@y<^XrB+p20HIQbzBUiX>6$v75*98@eq9B7A^kVp{WCg5K`O=Ey0b<>
zyZ!s*4IB~3^B0I|3J64dvTD6=wj--Wq=0lt+KP_D{AUST2%D%)MpQHiZ6SRP5A%R^
zB*G5l1R$Y13-9@0B;jIP4nQO+)Vq!O{J$I%2ZQ=lK~bo(l5e;^oL+Q2B;9dCs7FL9
z?Xe>*Zv(RHSJYZIAl}1k9^UyxIyH?Z5<3P$XoV#~J%y2iIP?=ED=LFucEIoYW}gWc
zt&^u_QmBE0g(p$ifyMh|^-a|=FEciQX3gLE=L4YXW9j;+T#FHnL2Ei`<(>&0(FdHe
zi}MRRgWnNKr%~awdRciCL0@nC$Ckno6h%~?Uvt~rA+$<(Y*APiHBH!kGK&C78l+OO
zrPyto+RuD14yhzqin^^?B8fGBhD@W#yGG3&5kPWqDDta9W=&`TqN)HIt8M<dqs1LZ
zN{m)UK$by$i``$-Ak!d;V4|qxGoqio1!Y1cf@mUz-PyHAr2WMkl4}AQBXJr9I@eGJ
zwCe6J{<5SZgjQW9CDt`AuMm^JwGUsz7EY~IRziuhQibj~KeLr?p_pio`i#i2l2mzX
zdKdZZa1*PMM~LPmxq|7?Xl>qx{{WUGYZAN>yN6dgn?jMclfSOV<Z^H!l&xD!zJlL$
zA8O|uOd(|I0RmJy0|Vw`T-R;Q-UfJCjG>)`dW$l%8vuPb<F;*&r+>6xre6(J<727W
zjmQc2;0^MTOd$)@^-;mp`I+>ww)C^>XR+ro$YnA$0T>Y%VR}RQQ0KoG6p>%6mHL80
zDxbU)LN@yiw(N0Y{;Af?099g&Nu>tO0Dnv$%=H7Levu?(h1q;f{JOWIN39e1<n##)
zQLDKs-WVpxTRU0pd*D_R40?4VPYQq?h#+^P^{iPWk!KYZNNt=c(_s4Vx5Ep@A!m)8
zmSR+(unE1W@J1_|5HVs}MluC9b&=Z&P(w(lh}zW$l%KpV+RkZ(71~!J^+gcy(N4=D
zHNT+e<6C5&CzYq_<5H^}cJ2uQSnYdpx!`2lSJextZ8{1rlSH2X0H4nR7GzHvLadAk
zDg${~aBtUdOcA$)guNCDYhQm)j%og869i~tS7lT8!S~n?Uw_NEJv1|pndX^BvK5dD
z3Ig(d53UeeIO37IO_jB4l55vgED^=m29L{Zq(i8hIi!!m)PqS)05Lr3D^)}F<0sX;
z%%VvYJpNe&04vNr0Q93r(E8wHWn#}Fq@jT?tM6Xm@9_L^t_%E>jIp$H5R}b+L%5^r
zcgb}n`evFGl$1b>$gXG*H$M?)e|)>m30UK3pT=EE&3ox8D`UkQ+rC4nPM$bdOpX0S
z)J+q6@y9!SJ@6)`S0hMb>IECp6amil?eCtCMITkww6JuE;usO7c~v(N9XhNIKm*}f
znNj+Q>96{$TA0?F;1YP)ei*GNl^ua-`2^Y0S87r6q4dC{%hgVkPIYMNB-Fu8E#Aa|
zwOQKz^Or`MWn|KhR1hQpDybZS>qF;~>bhB=eJaVQs<|pf5O)>t+PS^4dQObWCDyFy
z04l2g0Nlr6e*jO*0p&^hkF-2JX%bGrwx%Ig&5J&Q#^(o1AM*&0sI$hzubPP>fUli#
z>P|eKA5$kw0+DF~hc~1e7hmN2WZ>$SLJ)wKnnfrU02S~euhieEz%l^xp0a67z9}G^
z)Ju`~jrQDc>+6X$u!iwqR*Vo;j-857TA(@R&wK6PQ0e-Z<bfw(uuP$jk|ZE609o}1
zYsmC&ll2O%IE7>KMj4MSwTj<szmdQaODpuVmUV_U00HJ>Ap}srUQO-B-k2Aw5=arL
z^&+6)GMYR4?oZ*q1Y{_Z#_blD1V%~H2{nHEZ`-~II(2T9{4xE15!4g^000Lc4fpS3
z(*lh1%W9yqI?{vy5UXBdH_~ZO=5k&bSdo`^a#(@Rq5#qbcHj0hqUsx|Qd~yLl16P*
zFA7H^y#ao_o$&a!Jb7%ETGth94VnXOHf&#PB3)dnx>S1;-<rGnep$6pG-ccshB)ma
zVpz4+d^Ixz@;=#-$ByW_gE1`ni93qq+2)2?0(z}-yv&iHL<pyLt?y582n76arRh4?
z=-5wEGcpk15`n1fHtY(i`DFh9nq$+F&=9($V%}}Z0D<X1iys~FdX+LNGDhnjog1~?
zQ6q0+KX;mDjwxiFgJ^^mF#@Eon9v&<1g`%8A}}KaP<0(2Q8!fb3Ce1VO4xI#4>2TA
zpvJ}V?_q;7$sDn!mPpN%kcw?aj>7i#_Q}enmL8Q9sIcVKSkrVb-%$AR&TVB+w0_c2
z1EfM%sNYRm_bpzeY$*C~fsC0PXowk^W7Nf?`>Lk)_VR;%?eA|Zh@MwSqtFhmDs^qP
zz=L(auVdU`UXn>-icP_sv}>oiwLEs@`yM+Sw2-Q=N|P-;mudxU1|W^O?ra}X=~QG`
z<khZSNSd@eF2G&V?b_7lj-#XlqlvVsWsSb$TL2sTg_^H5abOH915MI(4=gaJo5WLO
zF#iCGfx!mP9>(iq&jX|~c#^092c!X&m~(#PUw?;e49vzz^ni{vX;Wud*jTIMpU0f-
zBga<hp_vt(nmRVszmy*21I{>DzpV>0i5f*QkN^$2v3-XB01dtv=w&e(0#Qp<ak&y2
zw!Y`eeq4Isaa}Px8KfREhGJCt)LoE$Ht)%+<1=)<EA>q~#&rne*6UlJH4r~L^v!V2
z7DM)oPLaCP=ye4(Y$}e#n<lD&#OfrEr~6IJtdn>$F!H8_m337RD1dDH*4toS7+K_a
zpp(W&I)q4DOu9vq!(&tpaC0*%cs)UO(<&QKpdCfMP4EYB56baas!AhvED_k)1TjI|
z=k1m1bvzH^BvGtoWPkY`RkG3hx3~k=_^c1vKZ6-Z@ZUh{4ZKpwK&`bi8vJwCh#QQ8
zN0q-^^M8cAFaH20x+aVjL(-C<^Sd7Z00W+vPql7nM%#UJeSA3be5F`P(xi&0&fh%L
zv;p>r3e1*ou&6&=(DhOg&xQuslLK`q0=T`3sLhiVF-LoO0Q@r#R?JpK@8ucj&kd|<
zPXK;d*~Ixec-~M!VNG_r&e8!JbCg{mdQjM6x1rBVZr!Fx8{RL7Z{dzq-?_<%+!13c
zN>VVBuaGYhs;A+9u237y@sQm|P{RKJ_XzrJ`eoF2ywyHj_wqPYUMT!=#@QG+3}8ks
zaJ-11eW|#`Z#Ckb`NA8}WB>{{Zm3=oHrVfrls5wi7BOnEfIadcRTFr@K^0qJAc1F$
z;e6J^AmJGssjr4I^>ao-sRez;PDw23UNJ1>*3E6{C)$We4m6)p#%o@nKH;oqhqZBx
zg_PJN5$TxDIQnBa{{T;OW6mor{{XD=)2^8hnwVy&y7=4xPLg{Z*EN`HnoCF(+W{7E
zq=4>g9EBrn#fFh!SZp$6UHaw9(c2N0@(j+m@y(xPbz`TS!FD<%;`<!UBK>kl%fE5P
zVUm$()Uma98hu4+Iplq!i_>-fAzMj>*KI>%`eyI4`oY#kp^5QOZ}0Dk_RKyfN8(qS
z6RN#Of8Vxve5_xL)?C_}&YAwnBl)R7*l7JmZ$YYHJ6`$b{fX!5UPV4rAJ=i7tV>SB
zocY}Is=W?0ZEED7!!HmBx7_#1!UG*AfxcLq-#k3FdswPQB;Eioo$+j(Ac46wGo8^8
zJaLIEsTj6kJ+m)U_J~_p=$~A{H07<B+0J~Nir2M!%fAN-*Y9r7)6{*WSQSq%zIoEl
zUw(3ONv_Xqfs;#Z$G&n+t$EzNtQ<(BelWRkgIf>)7H_tGU;K0YWd8taOy6dGn;{)I
z+E-uxq4XZ#o_inqnfA|7(sU4XP&-CCi}4t3YAb8^&y)TT=wa%*)-v%J)N}291JY}1
z$0H|y)4=tPeX-2pt5@*<0Py6CQ_iB!;2y(1tsnp>*dOg4p652gh^Porzug%(j9C<S
zHSy22tZDKVwAyzmNCJUp$UppJl6GxJdv@>HMqWs)*c@y#B+6q1Z&kVV%$T#yD60hM
z90T0v#D5$A02BxV{hQHD7pW`#X)Jj`{?L7We|78s02Y4|NA@Q|2o=>z2!%Zdc0Ui#
zKPi$=6*b8;k0gwB-+nvY-Tq%pFK?#&RQr&UZx!S+A(lpK=Y!s>*YwD&!fE_X3mTUD
ziLe9EUDwX@P=zHD$kMECt7^5rtDpexYcs?e^p(&^(n}66_wmh6g%P0(rY%>do=5e+
z?ey)>zAugC3$P%SQ_9g5@!OyASg}a45(<Yv4H3=O#|+waTGt!%N1P6pDLh$LR?<?H
z&!HPt4~J|-aI)%ET_91_d+kT-j=`e=qhV;F$tH=u;NN5EhBDBsjD%5LK6P88&$u^S
zVFYf|I)NZq=#jTHFMo0~qm~t&?mbbp*0wec8YZi~6Sr(cds`uNP_U=(aewCypvn}B
zDdhwJF3CIkoyW`Ng$9wlJuJHW+2+4v<@3jyDA9t43=KBGiX?6~90Rs8#Ic|fjSj@~
zb{4%Z>v6f*{Efq0j9kzpk24X+eZ4rq(>GP&^)f6X;$2FrET~gsVB7bxdxCGAhfx~|
zN|@YI@8$-NH+8r-x5RF7OG-zEl-?qN<p7hu-wbwljXdwEiiH&RD~j9THo^>uyF79S
zVN6R3?fCD1OfjdADxj1Bs(^OWW7f{Yw<jVsO5s2)qz>EA8;^(h$6qK6>OIBLBZ3FV
zd@8fQi6t)aL<m#_l|gs4`<waV0T_<U7H_<KwL`E!5=IWBZ5Nbzqq^Va_*M;DXh`U+
zetk!i>-lZ%fUwD-WJc3WlnESJ2lV`LyhcQf#^E$DE2m-)V`C8sWNT{ychk>2eFij6
zv6AefP(QZF2e&-;{4gdY(18l;2I+5$AM59g?p=Jv*lD3>)Aln_nPZtchzmx*jU=5w
zo%c33+P3)oGa;g&fJJ#u*h5B&8Y>DxAP^hZj7M_GL=i^zJ7+4e1t@AHY&kexkid$u
zfWvov_uSX%fI~*)JhsXLrCl9`ewfG?%Orr5)ub)%XmRb^@!L5THHPZg4ZDBdG^o-f
zOc{uig$Y}exE{C?c*xZ8Yw(oPv0h0#U#7#4Y~v8rz9O)#j{g83^^An7D1R~<I&YdM
zYxUm@WS1dL2MwrSVYuhqU``?c)8#ZlB=-LRSzzna&nNR8JF}H=0~*lON6wGpGJ2zp
zNeV@2D6PJ)TlU+G0ht{P=v{dhPksA(-QhqdoPi+#DQm7Pfwlq*(T`AIEQ-1rRkw~(
z7;CzrvD<t62>IhLR76g)xpgU}MgIWg8|B~YftgAcB(nep!_?m&t~5}qkeZY+C(KFG
zzZw{*whIQ*c>|Ji%{zjoI*)K!RDI)j`tgJ#$>N5x%oGB|`t94|PuBuQ1bUcAEm(p$
zKZn;lLx=EVB$fbdD$gWs&i??G0vL@(sRrJM_gEcGqjSiy?l}GYF_Kn`r<12FJUIwr
zC|;$oH|M$I+Yy~eQMs;9u5k!h2BCIN*cMgk<nY6}jGDItPy+YZS8mvkrR8=H<QyG3
zYz?>^U|<zNvt@WEz1IGl3}~IT5QH#bPLsyK?_Qu2SQAw*x0Gr%s<;0DS;?d}mIloz
zJXZKvcyTcVwa~6N^{)Q_?<wJ#40`Fyq2z_87ta3O`Md(gN!edfw4_i?pC|xe>fL4t
z!bzl)xo`jrUvv*|%O*`qNN}WWexwf7@X6Np0lw$sg;WHOTD!5KOQhH*{A9~Ut|?Th
zqvpR)Z+yF;0nWBy#OP*HHI4k=3+EH4ouzQiZK!YB=uqH$3<)V+YSaS_sPKKw<swB#
zUl{3)&XV=0t?zY;feMgIYX|O;wSS!8>=#Kks@kjGtMV8CI~D~<*or5CzIB!>sEs@v
zWJh&*5R_26?^WCLKaNh%hEZsMY@P`}zt0G%1516tbo%@Dz=^J_P`!_r-~O_0q-pF%
z)s$Cuh2jE%Hq?2*KuX9<ZchwP2KmN`)-YJdtQrgn*pK_f(!sRWttRW&zicQ2lE=!R
zb{9tjn^P_5*>=9wdBiYOvMX!f1rii)y~#Ua4CO|V_jj?#zz#tBtW9sn2Rf9oqHA(B
zXBKG~vE7d3w|{)1nh7Ljq;1QF8x8(DkB$NunN?kw0B@6lXo76e!o{CLT9T%Lsu;!x
zGKiH}H3Q~5an3*zMbs!Yo_D)B#A#6IyC^7F?il-gjs$fFQ4grtI!$AUqiCO0nphD_
zr=MI2D*(ERokzLj4YD1}1_QP*SU;Ci8O+*^sT81XTiyEL(P56GshWb02>sRrLn(=j
zqy{_H@x^4xXADTTC!btmfE81<3p@So^R*DgsFFCpjslbwO-e4y9)1`qkgBzVzEHQ1
zp*)JJN#?oE5){8GkV);iz?v%^)q(c!^uo~;TOe8Y!=S1x*QU<ePU9H}qKz3Y+o>Go
z0b~SuREAn0jqb72tCr*{!CBKmAOH&begh<SCYySr+c`ooK|~umi92CJHadcq8=m}O
z3uJlgS9~iPmZN<B8OjSTmF#sKh$1ay=^#+LWB0R*7+7o@ZHXLWf~rU>s1xgoTgoi?
zyKmbAfhasc1$*N&0%#w6Rsfwh??mNHVP{n_GVy3m=O~y>M)(|CcEY1VpD;i8?}e9B
z5G_Z0?TUP@e2-y)!jj1cjj&#z386x^9N;F`O`E>`vc3X%3jQcE79&WmE1rK$1u9cX
zG)WwH7$41aYumPS6#xRno%qI&#c~93>TUoFWZ+FjF$U;wb)4!}g%Ek)IQdBoDDXhQ
z!GXRj0H_GyzUq4eUygB5Zkvw&xML-}m3QmgI6_pgdIW7=xExVJg0fkzz|hIw{jtJP
zpho`qoD+Sp9E5K;HGR3P1ge2sj!ygHgI$L_XK_T}QN`+I`=_;MEQ_IR3mXl)V`>uy
zcXd_+VW*svdT9gS0iBBtMMnOevyp(M15dv<gR;>&u>%velYm%hKOXhY14m(d3~(9L
zg+f3Ud)5{J#t5qKgexlr1lYaDz8NF%+e?wf`Ay<*Y@0oXH3Lj+U#17yFGfm<29`8h
zg5{D#JvdfSRjBJ9m$qhB>O?}AgkVR@D-;bPl#LjL7q##?!nJhTQDu}mtszw!Ls_l4
z#OPsknOJ~8Tk{&M5NntENYUSYTMe+w)g%bfT51jEWgvn@kC@-`$R#v_U|GDbYegVC
zUkB5^E6!0%N4qkRThJd-^T5(88(s+qiuq%B4;&?wt84=gTgn2sXvA$MuIJBxre}E!
zZKXwBsjo}@@0XY=X^^n3RBLaS=Z>hdxoDA#wS`r)$@KR9Fe4(lMv+>LfmgX09G?y`
zFew`n1@K1MWYN^A1n3|WzpeUu;OZu6AV{b)ChWy`_T1oYg#=?rHlTvK&fi~+jKn%<
z(s@~&F(iu{so3r>9lDu(E}uiVL^~@s!21uU&}5*JHJxL4+0bm)^!@yBC^~5*faum%
zG6t?_ewj#}`ZBUg-XXpy5(yo~BT3;+A5j9KipeTB1daGTvZi>KqC^K&!HJ@~sJ`d-
z&Ota~4KP_+!;-+C?)d#NI>bFURQu~%+Rr|<^Sm<anPHJtONvzk({sKo>#TrImO>Ly
z8nt`h7#xk$I?826)xaY5q3QI<bdoVaTD2(z5@_w)9$D9?kytXZun3`FhsPQa%Rloy
zG*l33B8dt|*S&pkG({-u6h}0X$EQ?;5kT!;_Id5!F~A-<%+eCEwVOrc^I4~;jg~mk
z{GpAKq*(&L&Ox9?hr}9ERBbwJ65G}Xbu*ViLQ==f`h{*!{bN968<^OtsT2;w)a8`J
zJJE{XfC4Kk^Y{M%SqYt5B8GuitxDUUkvn$4b?Rg#d|Fk|MXl~V4R-$kczSSQ4I-4W
zZKlPYj@dcdCuB_pD)&~@zxRn8MoF07g&Pf9U(W*3^&$TNt0{1RZilrF2h$H#9CD&d
z9Bmw@fK6HE{{S3=Bt<khB8UNpA3uEU4k8j68bBo2AMP9XI997c1NgGUi?bBw$R3s7
z5*eairV?+$QKri8^!j};tY6Oc0hw5YTWTNL0XZ2ptl~){sFc!}#@E~0_Q)yKiDZG~
zl$gwh&igWs6c1rvhG$@=2#8i)+UQWiuA$h?=M}N!{d?w)si2+0^vD(@P)@D)@3sbY
z>e-+Wh0+ed`g-L$PM5`TPV7%*KYQnkGf42JsMG#FQ$c;J8Z}t@n9*fzDx8tuzS%$x
zu37B@upww4eCXy!T?0sMI<;!xdh^cMhC|iKBgUdQ*n+`L0quVrv=GPCMh@O4>VLL|
z<e!J*fsPefft0g{e|iTsq?(}dBvYb@6|&}JqZzP7eTTkNrk#3rU{h9r3Zshv?Y(3Z
z1jOd!P|P(eRc)3XRH%g;P}ZmWy?M<=V~EIwq%yLuh7EONabA>h0ZyNzVzJ87Or=7%
z6?<9s{C%r%n2tFnk5N=XMVxl^_~NV&a?Z042T)Zv=Au38^T+7oibqJ=7IxKaRM89E
zZ?+^%;zURy@goujS|-hUfq^MjDP={BmT1SO)mYOV1(>U(r9iSa`BvES&#pt%0bsM(
zO@JQNj|&;1RMk-<`Rw^r9fMzd1?qZMf;f7))GTr_RZ!KxJNjb8kxLnwRO*Xk<s>;g
z4{rI#taR&2yRTCiY7f4WIPcpl5a`S$f2@ulQ#PPf4eVFbe4;MGCMgQ*X;;h?+1r25
z4xsELF^40aBg<FD$JcM3MT?%Om=ur*{-%xF-@Rs*>7Wc64ymNuR<938VmCE+-`nZN
zK$FSTb&l*1Mq5$P6ale2`VWRLQX}bliDTBvLailPEw?{BDdULzcbFngsEQ+z#R0}f
zL9eO})Dv~5U2T5;_!X62XAWExCs}6Ob95^C%|B)I&`<WPFVw<jj>`p&#C1aXB8UCv
zLaF@7SmY9b73e8pb;0A-v4m`~Iuj6Bi1Vlx<ey$h9@!NAPgc`(iPIe=W3s9cF3n_;
zM(2N0YmCntsuUV4N{vm<kV)U;U9Tv!D@`nEAPc(rwhz6F9+;8z$^)#E_-rHKd9@NO
z176=u2A8WZ5-^2o0irfl(p%it#DVYr=NcIG4xlwPwXWNNu>3G1P7xw#?p<uOK`qA~
zoBMB<k>#7F5`DuHtY8oanzz_?72DS+(HzUtbt9%>Bf{HH;rV<}yMO`gHq4zIGC%d7
z%^DJ0Q2zjkCWpOdsU}Gy>dc86yTcm9LV!sdU%-HD`-{jikWV;?Pl~}%pg=dFY6pCQ
zdT5pU@vVw1p}bh!n;>sTzV+>w>UwAqVreBUa1*e)ZR-9MK16&o6R`0mPz2{$W^hRa
z@3{5#%XK~^>=~RD6t+j)@_}Cd!|}=wP1TN$W-;m1Vq`DRnD9qo+m6Q!GY{qVMbjEG
z@Ic@DkG}&U63^hx(<G_j0zAxUSmM9VS;UhBK<`evO2}w-Gzb3xdx29c^)O2$lE=KD
zk0=aE?7gf4PXp82G0grVhBX(4rBGj{#G0!oi_7$$A(}a4L*QE<4#nyNeZB-&&ljqU
z^x6kZS5&KBR|ey7XdgqfU%9}3qAw0#B*mfug3+Kz9+zUl{4+G;NpBICTIoJdyH$T)
zKOC`HllmdmXj?3lzENb^HFrbjLl#rwOC+f($nPeTs{G4Wt9}Q^=YZW0TPK<*z;o0Q
z6pFwb2j7rv4Z$9r&UC#rYci{<K=3YyRV0}<C*N~m5r`mor*)PhjE`?%lBVl=uh_<R
zkviv+4G{#?1B2Ka+ti=b@GvH4@p=FqLE^reQ1QlFP*ykP0PJ`MhTlE0=Sk6J>A_#U
zOjfB%3ZQvBorgb6qeuMcc_j>O77%<vV1NzpzM2Qpff-JXx^(+Kbe1g^12gK}FtDTR
ztG@eSX6Q_AchLkz#S8NaAA0Jz`jeK2qIknNRGKggNFp}Kg0&I8!_8KCBjt_Jsz$N(
z1n6NSDycw7B}U{E!MeY4dt{nMgHefCM*8Alpb%`{k^XQb-X!tQGt+5RB2cyz13(ko
zZ^p2)M+9-aI+#bZHQF=R!y*wDR*XvFLhW1;rqA!-GTLP8;Yd=Hyp>GAYA5cId~iWL
zcH00rGan5QMz^xRV&t$YIie_Epu(MGy+Kwf7PJ;N3J-fDgH}(j<FMIX7EZAw61=FP
z1%<mBXbL2Dq43MUS>p9wPhT`$G)2P5I(Wg*P3*fJfgAq-_c$4#I^06<BS#(ha_Iu}
z?moM6b{`DYGo;-y4WSYg)e;2WMm4J5w-y+WL1UbsPYgwox}|>&RzV`7(T{D9{{Vby
z&!$NPeI=QEDIFbINH&ZQBj4rlz_jqo0=oxNp~RavnOKXZ^w{4Wy|PYT25mIn4>A%?
z&07)=a9CHqH(K&Y;TQxy86|3{Zr69YqDK4n&PZ55(8+4jNDyik3Y!)U@3`cBa)c5v
zGDd~a1_Z_!fYeQM$rsMt<vM73iIy0Iaoj5;fax42qRf42h~Jt6j8@Skso*D&#-IkP
zwNa?@dyi`$OnCZfdUc*(5y3H_31n*V4c6NmP)%*mt^|6Xq7J52l5%yqcC=AUNIQ@Q
z)<+e!<ElAsq{8~b$O4sC?ssJajes0?A0%+FD_IX9AZiCt02&l;f0w7GXzRfe$X+sD
zH$fz-{v>6{I*tDT<Uv0#YzVurO0I?tVWL)jG(=~RRPVO_qtNkYNS-dWYBFdJ4y)2Y
z<KJL*_sv0X%M6bFFa#)*`hFxq_PzZ`Bw741dVYdgx-l$hsvZ0_VBouu7h=4DTZ8hz
zhgT#si98sZ3Q?vqFU__2wxM^=u*OdoO+q;+_<ER&CsEQ4{-o9K{xXQy(gZ?UZO|-h
zdd2GP+z>va(=+HjG-c%0uPEFVHbLBcZ)5P^1V3~B6;zM-YoLvgss2nIBl~x~^L$&6
zZwTf;vE+%q#OW9*1^PIccA`R)`sTR&p@2JhS-!p;c|KC19RC3Nk(x~flh;C=%;YY*
z+z6C>^3F-|h!y2QnJ^Bi>0~DV0JMztdYPmYOl6Ln^87Q*o-pNs;IgiJJyL}sJri$`
z&Ym>>P1t9<%pGRr6k&o+x*=bCfBa5RDAY!qCmo_qw(Xvd-F-<fTLYTZN5o~sfxyzh
z?R#Wfr;L5&10SSBSy@0eq@A-UmQg54(nuzGku^sl)O7L>e05NFqCPpWNudq!qb6i7
z0UTB3(oI=O0N-xdLA~>KwIhrgBCF7(<~nQWWU_Y|$2JJ#H{=+<%EU$QzoE=@$EA|*
ziy7B->ze-nluPA+_~N%lr1@BYeMRF(OE^1w;}6Fz{Hp_6htmsm?y3Ex<kK012Iq`%
z@3tT1<sH8qJ`{>KL;2*=bjSgG>@g&g_TNt#$HZerNFL)R!GYlYF`_CX2Y+lATO8oP
z9J*zrfyLth4dRBwWOl40xCVhaGhpv@eRA5g<n?ZEzD+KV46;H-mNoSmqA#>vTl$N)
zs^(olVJGRB&0<(hVqUaeTvGkk7wB?@l#KBWW2aFpbxcV2&2x|R!g2ndvnHWqBJmzb
z$Vc{w*gDs^%?s3|o2!B|39Q3kM8mpS+oYLfUdM6jGwAiC@#<P+arGJVY{_7eRhs$^
zzxj9Y&3G(HB>w<!zHxFe^+w^ZB{vCum>;G4QTkRSg|I!vSkH1WN|W!NKUXpzwV>)C
zA^29V{{Xwspo{@(2E%`zd{?OJ9L-&PD$S1?g-|=34*Sr>c|=HAh#BVfA83~}mItnU
z-dvGh^7=kM7Wq3wHP6)~B8jt}Z&BAYhjT;IAtTu&o%1V7x4F+dCR^XMczfJ#1XsSd
zD?Gd8WO8oJ44j=nQLwzrCs15w700hHQy&^yT4g*~1M$c+>LQLu#3Wtf>o@6}HteQ2
ztIz&1`xpNJjQx(q2C1O)t#W-ves%UoP=3zqmB=6iOb2nFu0b^#JZHdv8U2O-0K<Co
z)j&V_dHlk^wD%eIAIACqc=rDQhsgf`Bj9d5`u_mS>$*oWD3UT7g{dBy-XVE~r7G=N
z^S{C$YK<qQd$27@?mLY7SpZwodE95)MD6gluB2&nt=9x*POT#-th*7&$7yvBKusI$
zb3CPu*cz9S>N6yMRsR5~og~NjkH=$OD?)}c7Wf;1{{Y>7cb^>E5)&JFy$X;(Yv+x{
zXY7B)A7TFh@vpNbfk5$)86Z9NcU$-4>7R{wE#fMbWCgb@E06lkSB~zicHA4NL`7c=
zH=BUmvF~2jx63HjdU$$pW012K1RpTmimUI=`|;Z#=z&P`w&6ojqyF=w4D1RO1bKEK
zRqQ$V<_&_rD@m(B&;SKM*nl^>_*wenJ4Vx%g*+9MkU=_%DLh&BtfF;Nbgu0Sw}~>c
zyDNYSle*A50zn&|GJQg)-%W2B3#^@pVxW*cH`Q1~=8!&yCg=qee(3c2W0a3niyWRH
zEl60^i{$!VBDheVO+`+t`3=7h$0l8)W3?K;h81%hYtzFZoqR%BS|tP&8*Wbq?ENxA
z<O~f4um~LA!_#bQ0U3#o?)=wen&Soel&BuGHau^EL;<>({LEG40k6yDy6?u=mmIU(
zwwtnAtX&^pQ-QqkDtL!VvGO17y5HaZW|?7=r|V^gaTt9%n1Tuer&iiQ9@}ldYz)B!
zQECmj+PEXr>yEu60}&+wVgN@vNxnJSkFF%L4MA3$#5K5~$>Y#tiA0gelQRH-X;nO(
zhr?lnJdqfY8TFx+3)reFWLLv%uvB%Pa}pF^{jsX+nxS`JmfpFI+WJ&uE~c`&2`5U5
zq3Kpn9+`L`UZE94sR?38R^X5Y51sOM_vZ?nk?K}x<ku3C)YPm+fC(4Rn}KJO#sdqf
zO-FqpijhQF+n=s<Bh9E4Q*=%DzDK4jvbiQUWz<KI?n&-%<N4q;atL2TARroGN%g9*
zc*Rn-2y&!1JZ<go&(j)D48qPlJ2apzf+!8oZSMXf>oTB~2+TkhNfd1Qe6TucLv-k*
zlO>W#-p0UwzlKsUTq-1MC-$=+eYxOo!NDYL0+>uk$789Rnia)%t^WXH6$Ge@AYm9b
zq@MNv0QY|D2t{@PfZA_hKO8<KZfueiP(GFT?Ts{Q5HZw%?6=7u^hO1Y(n!QDkT<W9
z{0;(Ef>@j4tmcI3HLc1^$*n@Qok2i6e*H5uw#<UfozJMoF6^jF1=0$DIj`9`57f1y
z#4pN83tfm7dG;B~%8|&dJo?9)%>lpb-`ftMF^|JiB(S5CsQT`C++vqPx?~iiU{r7L
z=Zpi>_#vBEGMy(#3>SJdcOJBUL}HB|6DE{t7=jC3k72!UW9jkBo|MkF4019l2xXAa
z1eVkAus;KtUA(EVDhD8Y^YQI~z%X&Hjrp{bSADVLiAyYH#7xWqKR@5sJ4q@(sjwCV
zhl9`Vu)<fXo+O$`x^*%S>J=a@k-4Bv4tC$?ft}cE8bJj1KAA>|nN^TBzbOh0n&0u`
z3c#U?0wgv<752W~`N=@6n$$9zBI|AidYl4dc%&fdRws5RVaLZgUJ`-aIFO$(s!}fU
zYbzEKs36B$b_5gee?MGjR*)3}oLe!jZ~~K{6)Hxvww=eO{{TP38VFuSX#{~m*t7TC
zf1cSki^2+lfi5hAR5tzmGnP~4EO)9DH$Sm>1*9d7r7;9^Rw{-i_+>~{?w|wD?(yUs
z8#G41AK$;GF3Y1;wE$Orfb`?k{&)=}q_VAmw7UUczHv&wmgoZ8G2;EsHB*TW=B$86
z@6&8zbxLGgOS)zwVZPr_t_K+ET_a7F*~@+Z0H4nggA+37))*Q)jyvHXXxFVog}&zg
zQR;hl+kVH4XFepX8cQKg#P=89-0$yr9TKDHI+%Up1?;Ot_c=Kk*@;(kXKNH|8Yv}#
zB#a{e08v)UC_7j?dUoR$tUn4*HhbO&DNwrEyrj`f-@g9<0hW?kk}`<(0}<r|W-D|^
z^`d$8#epI5qmD$Czo@#39#_z9&U4fzLWGq^DxuVGb}p}DLjr6(paua!^B(^IOdc!7
z8Dnp~&2VdsEbSvSj@pZC+P5d)@XnV+WTG?3v<cKS(|6j>8~*md=_F(UO9oM}JpTF4
zh^cKlf(JBN#{lCls`9t?+b}n=p~fVET3HU09`vYB9@p)GqF)9MrJ{;KG;up2nF(JJ
zc(Hs~^&R)jja%v98ov1QN8wVldGB%i?}|WExChi=aV+WyQbLL!_lNJe5r*Gj20Is+
zM-#J>o>f!50&a)b8KYXZD73q8SHC}>(*j{jrG?o=-F~>*!k|E&8ww<XPOkUuwPI^v
z-d`yIhOMx&FjOUg*1OkXd>_vuxPpL%+_xVO^PS>=ZbIeurU%pG?UZ$w!ba0Ycp7)A
zyZUd4bpm2?yn;zx!2J8=L-?s2vCOpYA6p}>uE&GwImxpbB)G#<Z?NCrj6gYLA#2cY
zm35X7Kd8G6^qxJi5E4;WLhMN-o=2uCL|aud>@{v{D4Lox7<5npdSEx(f1cSfq;ICd
z70yKfbhS`6JLZVI1(*_K(pSxEs*QSIu1Nx-k^+-lp4bt*$8Wu`CxL`0QKW!(8-a}?
zvY`Y}29LSIfA^RosOEs&0f?#QRZzu=<KF?vT3un!<yp#5CCIEv1Os`-S7`hY7=c?K
zT&jp=V68AkRNB;$b-?-jup-o;GYcnSw?6s6h5=61+yVapc*WuopjB@WUbA9}y{iN!
zSlh*oo;u}}(I30O<O|{;`=ARX?|1<W9G24FfKbAww?@)Ipxl4f4+)qsS|LEzY<lG#
z<?w?Rx4NqB@x_dQ-dOb-?~c;xAkx^|abpVjL`K8~)Az5w0!G3nEnABliyPuGWv0FP
zyk^$Mw%q))g*t>UWqo)90A8Zni9222d{*^Su=U0ZMZDApuY49a+ws5(Mcq~~qBa9p
zt}@dl5{p(rH)q>8CbcZ8e4DlJfIKoa4K_gM(>WhO46NwOxFc-sOyKXe>@N|CX1c5b
z#Fix4zsDEia?vD6qFEhFYOf5b+<M+4vgjaKv#`h&>c)U*_9pU?N#VG<Bwr%)go>`O
z;R8a5YphlUEw|sjU;@RIfn43z1sYDE0Rx-k4IqqBV&{?AU<_+bn!Y<6qlh(hD*bb)
zGXTb{b{WkZaKMc|xVlQV=DXk!wYegO*~~_jD#zS<9A{|RR45^U^Ac{(4oKf%IKUP~
z-`>1ZYqn98&|p9VusmXo!6$Rr-~i-a<v|;a;b*bVLIE}n`(b7P*e39f3>@lV!0m@i
zD(YSi{Nl#iLAqdjAI|`wIUDhT_QkbELL~~jBYZ+*3FT>Z?`O9gemO=4La|1wrD$w9
z#+#&6fJoe3UH9L%6`Q7n-Lp`w=x>&hqKGL-$G)M?-nbWmOh^N2&UFm-z?D;4PC?!x
zx+^j%+igA1zphpp45BqGIjZ#bIRyv;g&>32cFTbpGlo(WkxWkfZ}{aMIz{}{h1xj+
z{oOZTFUx$AyEN`m7LAann)Jt<B0P+OqiQ2j`^JTzsl<r*@+xXb!l|p?&OkbN*$5~K
zwb>_wd1g&-AeFT0^4jb#<=X>IJgUtsj@CFALvy$5l1T~KloH3kBj4MM2ZN(e<^*j#
zQUC=INKs<y&3gVAJUE-G(6&{07qLD608G&*M3G98_|cG}&5$>%J0GXZCh&DKm+GuK
zld8b{KOvMP(X8XjR0vH0eAe3xmzFm^8#cq{Pp{VxQ529pNeN1$q>u@-$@c#M8A+5x
zB2*=t!v(AlF8pkNcY%JNubZT0WTlqF0!HVaKMdfg(X_E?M=VITJMp*YiX@IcoUF0a
z?i8-qV2`Kcf%>?_LN$qzS9JrG_>t{-1S5ta40==syDoSghxyHYLrKsgO#>6C11$hR
z-)pWrbM25R8?1VpL?(j(cVlDx{uvIQM+M!bG*07fxZq$_=2`ldZ6iyd09^|M9cJmz
zPDk>k=Kv^R+W-l&M}L)KEy)a$ww2#Vp+tQ?8D5TAqmFpvQjMj7YXf2`w?2mopH0*}
za(Lo*NfkVfNg7X}`2aB_iR5G^Jvx@a6=x()h>S*#=Jw*f8^0M*G;Sgw6DFEA)IWUv
za5EHiV$AA+YSQ<tyiDCfG_9??G6*KgAHA}pp^!+LYD4$5AhYzt(=xlwA~%KzAVxge
zkG2L$5cN`*M_)O*G^7uH!z`0J!jUtV0`vgZ6!$fp-)Hp?B9wwauYPv~3*TXQy+)<e
z5()u9U>Fm41gQxu0X0a~=ira?nqZ0NDbbW>y~l>uFL8Cpe9I(8#R6oIk{Oz-e5x~r
zL{=IN(;c+&WbIYA<AI+_vxQQ8J{G{d(2OGLQA8@psuh@>Ti-N3T>50Z60$}iV=)$3
z0cYdy-#E91g;|+qC(ImiU-f~Zye8^d6&<1=xK%Y|-E(|c`et60Wp1ca2?!yGYNPT$
z3^6*Z2`qrkvAUuAtfF;sscVT}T#HgL+*NJqSp~I-r|NuOnN+sx5CW5Z_RPINi^O|i
z?8*n2Sswgtm1?P3sIrY<-sF-t?|(mB4J5r}(n!gqFs&k%>-I8?#Fj#=T*j?oN$z{r
zXofu!G-Rk*K~-`M16=WfX(NUxoNAfem8Js6HNUR-k}R#Er5a@*lE&}r^B;ymr>A)O
zXA;RWO7MW}2sG#ZH}J_zKl9yRirN%2SOik99ft$pFn{ur)`f7R@97}+?S1}u@D+~r
z#POqEmqEwG`rtQO$tPJEh_VSIUlE(vy=})B(ae#@G$LhVBG_@LG<9|dZT|pV9V`z&
zP<0&<nzByBSgRzA$sCjPy>Xf~C`QWlT1R3lzkCf0kj*Q@(nli3Q~UQ|YkK^0GD{ih
z-60R+6;Rw$8#|v|vv@ENsUb0uOx0U^Uw@d)sh}|=H>fv8hwFf4qdK%}QGlU|I;i(Q
z41Ssty+?|L0;p+MSiL}SD}P<N!w>R}Bgs23g^3^`w*$8z17ER%38IKQG-QG_h9Fw{
zpUdHaRfZwcqq#+vSr|yIww?$#cij4XbDn5Q##Kx*MHo;Oe(~Rb%QBad^(X%6Z!jJH
znX(R&ZmvBj1a1)MxfE*SZO^|LR$!GIC~%D<Q2_Ee{PK>_c&wvRCd$J8@2>v<-Fy8;
z4x$m$g)^`ctaetpJOFpw<B23F$sCr<+5@=NTOR)aE%1wm=^&NMiPOajprZq}t?v2Q
zdvEl}$V75Ps=5JUS&1fz;C>j-B1$Ed)GUB4fC(ao)xX1>pNe{=NLiSovq+wx_b2r}
zg8}-Fv&V-YRI@}DOa7R!btoIz6@G7C$J-huRQoi$_-9jrU;@AeJo*ApIFLr&REZNX
zjR<W_&8El%&_1X9WEaEI9#~kqw$=A^kJpdc$Tjp+NF)i<N@JVESrSuWn2V+?HWiuL
zXA;ROp=j>Ol-OqHbKINF24DVNmX#P;E<go=*pJKnZ=DQ%I`r~I)w#7SQnszvg|29K
ztg1=PbfKh#5M&Rl#N2^mf!l5P=jDqe<;&@3idkv32jzQRbGRS6&gdQw731oI_;Ll*
zRYNrf9C1dnY9mgnQLu+{hmAw9;O~J!(+KB&mR1U4)WuM0)W8}RFX8jR-9eQdHAc{?
zo%D|@6WDgIo>y32r=|@f!wg1>sk+!|Bc0Fh+6rV?_4MS#vc^=fBn>x2{0Q6Yfv2RB
zNMUA%DB0$SrkN;#+fWCNb~!mEM_8m(WmxUw(n)Pbtd^~)i}+qARXmQr)MBARg<gK@
zfCtO<%8#?9W=BaEre2{-6fRd~{Kqxxc?8wuk`+b?LA<8GH|9GF8*_gF>z$<w8I~X<
znN?$ErB!WQfwtB7;Wm@R+E!X2^e_b4?iBw3_ahHe5<p04qn<~MO3063-LV(yJik1n
zDG1c^F)rnrL#wq4HD09reY?>3Or9KO>tzJdTjKt>kk+P}a;zjxk$aK8;Bl2t0gQ`I
ziU|}{1_yAvlfWcjf2IXIaSX{L1aKo-pa?y{ZMQY*JMW0f1oLT;+oo16Qj1n#FHMel
ztM|sAuR@VW307E%Le)WuBT)kUwgn&ef#vF?SR#r*=%mQ2;sd8saBJLMA8ZN5QbeSN
zR%t?bjB7|c0DVTs;g9_9RR>5>Tl#aih}NL$DhjV_z0V)=ymntdhvPf6@(25*0K}TH
zN1DCA<yon^lL1&&qnZ?1BSm6%0h@4ZW4WR}V*@muQR<yz4<aX(hWlEB<}^3uz5~}1
z2bJ0>6%mk0;+0mmA9NeOH#;A5is}xDqHz>@R4RtpngH|h7r%3gx{pY}*NDs{CWo0>
zfFBCK#;_6{8c&Fcah*z{gF2FRZ@;Auc^;VaN**{THFGIdLN-=V6gK^<e~9^HYDguP
zNX@t`rIgWNb|8_pf1Ku(U&3jrv_?v*`;$Y`uhZ20gNsdG2~nXCzn1niEd3~NhEo*%
zUy?S8J%Yv!9rj=I@05hEOEbsR^v>>4ffvD{Wc(<fjbRHPQ3p`PShBQ#+&9^_{5c+g
zcfeGer;c=jeQO&qIsqEBX%}Qymc?`a$m!ypL?~7?GKD&r0jQDZWB&jUKYZj81s)Bl
z7RwvG*d&w3(0wwDjLcvWRPM$#ux{?S`1^YLWgS7x3U$2Bz8Zipd)wvrf5talWoZz*
zJ*qyEO@y;#5B~U{YZu=PAN;>l9Q{AvhKwLxyMwdsU=VBeab%Enooll+kFD9qWfph8
zZO!~JFVVvvNz^^m(#RPjXxtibY!F4*y5GL}IiX1-@g|(g&PzBK{V;y%Vs`%T-Qx6;
zj-7gim84=+pa?7$0O{WL-}mc6$<fUN%r&V3Mv67^y0vV(ZMVyA_ko!_ISN@04YM-}
z^H$t@;}NN(SR~a0?n$wA#nA3}9k1h@@RkK+(2BAd8%+{T)hQnX?V9>7fWKHeNyuoO
z%G?aD*XX{sKo`YXz{*%f_IL+d%j-gvFa>Il{{UzZeSLGI>5S$#LRv*#PNfZM8=gJ2
zb6X5)dSeLbd|5Tf0sf0AxYo~=w&d79ub}EySiD$i<I^YwHQ2rM-?;N{+UvdoK{l7r
zj!BJ4R^ZvHBj7+k3*(&TYd_2@m34K{!*T!}yA8V>F>C4ix9TGS8CXgQ7fcS`Q+>hM
z-p3^y4xP$M%=UFMgH}i%j{g9LQTxx?=%?&niAKeGNCE!<?-w->D09j1lzv$rmNO4T
ziUyD&jWqgFjk7}~$0hTjM&B&o4l7S{N<a6%`zw}FsK^Q1T8xX0<Q=UBT}3mF=2gnX
zW+PA@vW)hn3e!1qPn6aA*4g4r4%NYvJ-)3-l+foo_}*o^3nHPviN^3*fo|Xq*ieNB
zzErbn@jD6!J6$a7n%0Q*IS!mMOj&``r?ziq@goAqka6vhP|}xCKxxdOlrzl0$5wpY
z`|tj;3nPF)7qPso(XfpMp`;U&;(_F5=xj2(17{g#alq_;n7?>$xb*eTs~c^NA^di-
zdwO9VNe0HleX?M0w{OEZ(``d0k)!#dO{q2C3F=r72KC=Fh4eUd?N{3JX^g{9^H=YT
zClm?i(=rA8F#K~Kl+$6HQT5IpKqHgsn299sfH4Q3Ty(CR#K4NY3gdBOF={u?cZl3s
z$4S!OG!y0k;*^cHWKKOZ8IkI*oIWdlIO$C^m?8)64Cd+LBB+m^W)l#!eKD4Ht@~r7
z=~cQ!JL_TXih3|b_@9O<OxzQUlDV*W$))KL(bxX~Q}E9IQLkoN7(|R%Z?;f1?Y2&o
z>4XnWEznTkJVOlIfR~!Ji{})|06W%BliOmJIh8^1+vSlA(SppceYV_Yx9b%)XUxy`
zlp6Gc3s(cSXB37}kM`vILS-V+nNMIh8N2zRU>g_s=bZllXayi7PR91zVfD<NS6S4^
z+JQtYZja?zqa`U2!q{SbKAWd>kExCLO=8FEpG!Ag6mj_uraqbSpJT%}SfBjY^r&oW
zob+UZdnz4BA1wF}<h6@y*^d7JZ)4IuJE~^cJ1f+6hF`wh4%voIv;n1ZGj%Bu2`STj
z8rb1fNd=Ab;bxOE`#d~)V~C9-EX+lN&P2I9vCXHaPxNwQr$Toa_NCbutTQ=29o^)>
zzijjb5wC0pDC_QwO%^jl7*rtL-XU8Y9NrQzKJIbR#boGDb&fIWGe7YU*-!Sr*s{YK
zlOj`~^{(0LDNjL{ibYMp&D?yGha_aI_lGwsJ?wKyk1xhLDdhV<tw$bKM&tC)(0Wdx
zdZ-oGzTo;C^FQ?i_;5ns{8yz~ib6a<KefGn8RP!|4E?eqkaW|r(8huP0Ez5#^!^7j
zoSadTugv-UOJK=0m)1B3%))`$$D#Gf$Oe=B&Yb&<&}8uqu=Zj4=5q_A%_oS=R1YDl
z)9tnAd(L8&KeTXs$WDG?{{W~T!_5a<A79hZkEv}k3!sv6e!HKpeyuDD_MngtnGe6F
zd4Fnsoe$c5B>gW^E;*M=ZTB0o_=Aa!v!%5!!^$ZdQtU30eNCPR((wcpArjjH1dPLS
z0T+LW&r7f9AMAd*UY1yyW<}EBhRgxnk5FrG^`3H-MUe?$(jXKF7HkuLPs=n*tPp7o
ztjsKi0B}h49|CJCtu#tdGpowMX!1uR;mFQ1s;q4K%)<P^&Y`dae~8;Abp${IXrgb>
zdIEUh;T4uS0fq-(1<Hpk+W;5>8)2~1Uy1LTnMyk%{o1h4w%)&vTfk#8f=P)QnaR>f
z<Muboj-SJ2R-QEug@FyK#``sHHyj^cJxWlqbp|bLd@vbTK-BC_o%rr(pU)*1hGj`5
zW8tA1lzrwGy&59x*YU$IPo>#u(6A1Hg;*m008#S5j@PA1sgq|ecB9|*z~^_22eJcq
z8w0(M#2=<Ktoj+86DZq#z#k6Y*oo2>f=Oc+;egM!;@eN=N7oTi^{%BQ^$m#R-=+YK
z4^ZGJ0M^%A06lTq;8iK87pt|Sx1r~c-xwBC)AcbtWL!<DPUCyNMsRWi-IrsixcG0s
z&x|5KY2CS_@XJTxs;e6gTaHC~jEta2;O%w)03pxs^2$dEohE+}9|>>FX`65;eQ>8Y
zT6BjL6dgXh{LTD-ED@@mOs%H&3BBF=-~r-|TS;iiy(e+>{{ZfAvcj?1cGgJJr9sjw
zbI+|-2P{$evZE3aLl75|dti21KdIuo$WNHDx>^8ld-_+lDRx%WrkD!80K?NdB&tJb
z(xmZZkSu;6VFlbSrgo6XHUW;}y?$M<wk4ApiNg>H(g~ogTblZ1dYNRBBpO#jrj;}-
zkJk`N@y4fEYuP~;@#pt=4G{ifK+?#T&E~zmH~4S(97yB{%OE=`v<?Gt>JAibK}Uz>
zL8bJczqvL|{^(@%g?*V>PWxZuflmPGW?~A0pt75-TaCT|{V^tqRzXxl0MxsYf37=B
zUN=_M2ml2N0KJFShAPIUIGtT2l(8NWUB?xEpxOFhG<{1#z{JG@s{juBkwov`;pjat
zBnVS%s&?9r_~{$BltZb|i_{LseUI<9a<_u?(W?bD`QR&+5UhSs>vmWBjgEep@wbN?
zLt9A7b*VfK-%>u9B??e6b=1slRd@rBjwy|nn2KPe*)~2{9U?Oz1eRsH@1%ag!y5Q;
z87+zsFG=R_Z^H?vBpDc=y}$Q=-f?oU_$=hF-XIOEU0?qId~gaCXv+9QP;Ei1?ma&&
ziyg%ZqDjgYEvi7eI|>4i8-61ID;wC>Ut+t82V=*>wg5#)omODTrjDf+SAF)s@t5fW
zM{}2xP#T7UHuUG6@-xXVQ6lOjmM8lH?oIZ`Wq1Jwg*{jxgYC)voC&KP$Z98GM{37(
zSFq9q<ftq6z7@w6i5drH)Iuh}lfd}*?TzBEf}v4E0&VxRU<y69qxJY;N>x$!Zjb!A
zyrGaQohhZehTlmCZT8MW86pJ(5n_iV_PhMJ#3&Xr$~HSy*<22hw6PXTfuz^vl<C<-
za$HLH>VD}QZS})Ef;pI(yhq<tpEja-Z+rE?fxJ%)wHh^NVM6=hPMM?uN1cz9ah&7}
z8dNuW<Nojx!E1rV9&b1$TZAI_yTG!RAdM$W&|{<)u6Di-*(VCLTXvzx!xalXqNsDE
zo9;HUe+)htXvLZoN#^h>WrjonP^$xA`U>2Ac<+-!3KR>yUHkif`{guPTQwDdceoq>
z0K8WYs^qY{(7>JB<>)H`x|pPb(nl)v2wU4p{INr$Mv=H;H#=4QzJu3{REb`TG2N(z
zTQ!t-sE{hMq+p%*)JZ%3n|feHNKMLuIIILwVB>NHS8TUXLn<0z89`Jg=z&C^rf{;1
zOk_3v>ajz5z*mVh#zpQd+3$pSEjw<`pqi%ANUm)0>zvx*oU;L`8}2&Q@5Y}`Y#lnI
zhAzkiYDfg1F}^nc09X-Nj|;gZ-FB>Y1vKyGJE>FtJ{icG<WadTz8-g=d+qrg1a>^{
ztdnhbc=9`wY*e0iHcxHO!)yvhx==jc++!@I8No#)_F;Yh0M<ovfX8`v2FrHNjGqLJ
zO1q7T<o@p|2Tanh-6eF`q7M7k-Lg_d(JJZ&j}2HuviRECKA%XA$tr9MKKGLGL7gPf
zt48Px2jz_-AdOhHf(MjemvhhO^U06^puF&JDx4E5GnKX{RVdheFdsb)Cc6W-<DB7)
zV39xy2LAwlxLK4cY0?=-BKO}S4u+wpamfJLyam_|uTX8a&LdXH)=vmA4d}bG-+nTJ
z0VRvKJDcy6Z@ffoq$ur)tr%%#0<7v@Po@6*;BXO@bp{5B(tiwr{{W;A6eVRFlk4!r
zDhldicG|O$7O*!py&Qir0>}yt(KHDd6K}ueAn*YKuP8=^@Y~ATuW$|)YXrsu0&I)i
zdI9Z-LrU6LTNMY9z{;U3SQ<qU@6G^7)Wv;`j1CO}L{J&r(P6OX)Zqh7gI%}zWi^P$
z-EBp7H^wf_xF&}eo#LAvfH$@SX;Pp7+J`&P!mAU}W>p==OcL)(P5bA6aORFcX4R;j
z&7NDh#Xw2>py2>r6>2s{JWR@(mOzH+fp?T5?sShRCXMAMj7CO>1qiJ|`SirtmS(VP
zY8;$vsMSN*Cdea$fT+p?(yJB}0S9k<R3sljM)ib?;C`9N`WO+Vfb2&&8~|1Tkw>{4
zXK4yfqC%a4uGq)UU8rtuhZlf_3$UZy9x?!>Y$b&R{o}ySC4v<MkWS!n?TX42)r0ff
z4(hy(`(*$r01sX71K0NPg>7k=SjOBfmE8K^7{g1cH2`Y--Rs{cq_-UV<0{;WrmT@z
zB~p^Ik~!Y601IbOz(x9FaYC=>oZt_-#Djswf!J(4`M{F2d#NKjkw8!ww}17VH7Pg(
z?AaH5)^jJ9P$S`vvJ_Qfh~FGWQV+4>xWF4$%en7`LV2|s+iasn8pcaG)D3LAeR4`S
ztLMH4*u)dXVoe6%orW=3<YH~KfuvV_MT$3|<d8qR-}hO>tS{ivqB$nHz~qW(^c%JQ
z(Oiz$e0CE%Oy$+jn|?**s`_C>>orUB^~}Blli@k0x^Mh{#skbluraAcE5d_+jvkp9
z$fI6@D4j>?wrGL~qUiiam9400P4@RczB50D(#>n;Izr!|z^tzuNLeYUbLqYq6=R!F
zHVqbK?Z3+*8U`<Q!PpKl%4&gRAR>Xkn|9xfgH+uk%I?sG@Z%SuSe^#w)8FTYNOh~S
zu#68sh6pT3C+XXtOql-w=O>ILLKILeS@Uc+vU}E3sMFHFhUHp4MlviNL?2OsnJ4j?
z<d|wzT_BqwexE#~Eimc-0IX#2*lI!A$8qn8{V>Z66Iwd?#cA(#k1PKGEd*et(V)y|
zsWo-)&IH5)X`=A~5BIL_$o-7JPK(q|&eBq=Y{%1nenS_eMbjj@f)zqk0xd@VzYGcy
zI(ZCl<-N(Os{a75u2C8;=1CVxYC8+8w_iL>)GTo=N2ZSapHsF_qCoMff94sNP|`LA
z>%Tm9^~GWQ$5kwH6^+9XLYfz5$F*_t$R!a10!k8VineXVd^=(30(FuyN{*#Q%9ION
z{p94E`B^BR5V$*YTldQJvDlfFWL80|N%ZHBo#13gDdHrW2?l{2FdmjW{4-24gbUN4
z9$;^C>BiqopHS*mW>k<f3tQs5<vc~W-Iqa4>2@dQ`{xRNq(Z$i`I^y!f$}E*00ENf
z`c*LphD~fo+za=1JN|fP4Dr6UAswt!1^|=m^89k$EXg!Y9Fnf)l(pJ`Y#+q^a0l6i
zznDnbU5Oe&2Y-zmpHCE!2_Xak4w6W_BiEdibH9%itf5$c$PYIDgEYw-M3Xx(XJtB4
zFnplj1JeF`<Pz&Tj-}Qg5!x`Jg7yd0{#lNH7B&)=GHNv3i#fQ%CsWghW@Uj^nDe8J
z>)ysH2o?b*lKKsj-*k^p_mvZ9)g%ijE2%YCCb#-y#L-BVufx!2`Mpon{JnFc3DlJ@
z8G^PXkyYvO-#T<?!W}VctMU(q6)4}spT$Jf0n}=ZZ{GotdakUis;b_jV~^eDl^ril
z(G>9!rVpr~8n*b??`)KDTx%h|ERV|pdd`+f9jA#Hz>J`_)%bCWH5L&DAThCA<8^@*
z7sDVkP^BAf-}mdC8=?UmiUyH;HG2DCTSUDo8DGP-D#{pHW3~6&gOTbJsGOdmlf#Zj
zA#75P<O~tW!T@|iK?BT15%A8Ma_V4=u7S9*Taoy7$SE92A5g6}gB*6p$#!dD^V=rU
z$u*T$P^5xu*0%QTl7Zf4NSN%udiUS372h<=B(S8>bs}=*ln~9f++X2<g};<tDx=PK
zO0Q90zg(#5M@~#3f|3CMZASa-bBiQF5>U)S>e$wu`+uBhG^=>8DV9UAAOaK~{{SD#
zh5~gD;`JZQq+S<@e5)9sv^X966OO%GPt&AQNP!H3hL8z7YA5H4?-5lbF=b!7UQ%zl
zyWb(O)|yr2p|}(Q^uTYl72)d|Hw&UNRE4sPRMq?Bppnu|Zfq4`be*V<4SrdoX<A6U
zC61IR1e(=+u^6I14gkp*ByG4mi{9^Ty|6kKNtJw1#Ilqgx`zkhh*)@fWh<Zp4f1(6
z><QZ|H&k8@pQ2qw0WM1lwm<73E6pcPM6*1VNYuM34_|Bia20hy;kQs4PZWTb+vytv
zd)E0<?`;y7G0V1%Rz-UJ{{VgQp?;gGgrkzKf`g}}@^9nqnqZbKME#{FQ6x^LHE5Uy
z)CB>*_SwR-^*uLB9FM0%u7bl+AUD&R$)Yz?8tH|KFOv526Lpn|dU-lUmEmLIF^$R!
z=Yz%~2?HrWWkg`IvAw}G53o1sfFHw97FB4Z3>4}c5yNWl&1^mKOnTW~G4}&rkOsh6
z`BqM1^E10?R-;x9;Bi@h5cGX9019;jQk5pi`u_d!f#JlREK)SeWSQ7W$Y4GkS04E|
z!Ypm3JyH%@$gTais;p@l3&gy}6<ivkPww{1FH(y<la&n`NB3s|tZ$@Ub4PQx83tJT
zrf&qh2~j-4KFPgN`VRSd<bJ%i$c~40RTtrf-oPBz<nnTHEQ}bK18rU@x<%l8ukp+E
zvpMP~k(FJY!hO(JWdP9>FW2HSs}Pakj!KL%b3w^ADDo@)^O{&nWo3#OLy*Y83pMIN
zx;K9N6Njs)dRQ5Ha~oOI9;}_g+mJ8v<mPlQAQE`4vJhyl#r-(Itjz#^nH3nv9AL^z
z?XRCrzt7V<#vvo=^eRSBe^YQM8^2FMx1i2mmR0I!Sri9}Ma8{6k>wTf2j!2}^z37h
zppe563K_=)07w)nw<HVWoD6F6w8B@9#!DsRy@>998-bQ-3p^-dV3E;`GXrFwUgO*S
z<>%<(gQ>9U{WYq1i+eK*_7(>|_#Sjpx+EX`yyL=<FDNz#(0bAJz#VMze>UArK$a5{
z4z3ONBjA1VJp!p#m5TV0$KoOzA;H^CeNW5R9ra5b)3A9&ZlczyK{jrzZ@<p+fDzNH
zp^dHlB`Qs|k1d0>Rr+(j1mjWClpY9nN3eu~jcN^7I}YROIl<GOl*s0J7huLX<JC&U
z`km+sJ<h|_kYGL^QqE(JK_i<(U<0@!!MfkqpIXVri7!~p0EQ;s_wtZ9y1#FZ1v<6<
zabqGjT>(s`dDP5yKRkIP>JzA*c*;Q|1z#W|gGRl)r;mm!bkRrFn0i;4;FW0WjBU@y
zf#2g^xOIhT8Ty9M1CkUQ)xMh^mtS99umYp?k}xkK%F+i^v8XLsI*HriiPJ2o)1+*t
zNpxqeoopWC)j{JYA(kHwMQH-7e@<GfYXs5uJ^miK#yO{yqXmve3rVL*^b|QH?e)K0
z4tJVq7|SC%=pZpWg#dv>??S4*tJ56ABXkKohCqxML_(i2T{{E+0F9~mVlglY6{FRt
z5Q4xlw*u&Py~nRPz5wH@jtM1!*+ZzANo2OON80sYZhK&3cq&*}buQjATXqEM4A<%`
zepvl1MtP4;dY=juc6Ba<lGJ&tBI!rOkB%Zs7fGPJYc{1}rTO2|y^V|7&wQ4LI+3KJ
z?W~pa78Y%<f;RQQgp`#cn-(pO+ZEqon~zHzl64OVsG>!bF0g7nwkK;lo&d<p62meh
zpp#nzBB0#>HKNGpZ+_VFm6m-G#G}SKS4$fQQRIV1ZN47(8Qx-%#E1&8aP(J!$UiH~
z%_Yw!rB#5-YE%#qu;g#)$HNa$oi2z;keOsO>szOhcdfgY9-DmfOlDa0olF_GrLQ)U
zE4KI=XMU0uf=-zkNREcDydPpoBV)<0L0$3!RA>?qRxc1~W^-YD!rN{E6|nTgzY+zD
zN!1(JWS|e1i|@G0BE0h?z8oziji4fc0oYdDe$G&$5!4aV$uh#Sx`8v^fG_V*9+i$G
zo6QV~pe$x@DveEJ%EbC{{x2sIBt1-8{Na>>4+G1l@6yToZ<8_jT}Oxth1H~xe69PV
zf$5Zn1dGS&9lBMIS}C<+>^5M%*Hw!fkf&j`U<@LuHLj;sASUHSHQ&9}k9=PW&?{?3
z3<w}upfz0$>q)<nI459ZS2UrRF&woLcONRitgqF0GC6%lT`|bkZO)*_e&+Pw%PJO7
zy;MCzrkH0#Buv!OGLpL*v-jG^&$eUMj*LRgLWAMzH>6$B_ve4WWkCLCrj9ukRK~#!
zmsAO22Yyd})wd@B=IZqI2c~FaSW8o^2KEen>iYxfiPNE$bxlaKp)}#SrJ?QpzdOQu
zn(AbEI!H{C0Mxb-ECMKc(LY~NozuxAa%f2&IdssavTZ=C?X_2?2k+B`RO$+lY_A_Y
zW_8mz<L-fz>LOTrS&FbEN*Cim{{XDxOe6!lft?WHpDK~&lik#2m{Q+S?=c@t&Y&@C
zyE6>a0sFi2D`jFKbx#rjdZn%YHJ-mzNtwC!9+~6AD-N@zqhHj!`RA`QJ4#DzK(E6(
z_}*pFg&4x=U-@47W?gpM1@1laN>viO*86+q3hHuINK$@T*y)62MrBg9N;k>JtHW}m
zNjUGY1uRhC0@sGa-naJ5>dF|Ly?}Q-;*Ig<BusW2Vu3?9vp&{6Fl~Db7hhZi*BKDx
zZ?V8u_`t1%A5VrvHwWXKcNc=qV7u5|;SbwvS|;|w70KhaP)1L-O`=0_>6{kpG%O;8
zj6N7244WC*FShyG4*O=4qNtI8$cym!<mxtoiMH712o6y7QE4YyQ1{3;+K^o?rX&6;
ze?BqPs~9T1Fo;0sGC$ffJ&3w?ZMH0EXL!A9iU}I~?s9b_SWpQx1&rn>g3ACi8uWc!
zo5?#H>^8#RW=7`aV<m4)N&NC`+RfF&9{ws<yJVm3HM)v9B`3HP2iGqjMIC+3hQlb3
zqVGU@ZH=2?5_Qs_Dx_oH&J)u0GKzkozFTJY0BknjGxa@GT|8vFQ3C6}Nw&MJO#L%A
z*|7!==TRNoe96>xeHTPDmrccU`2PUbdB1Fb5t4iuHoi}$eDao_LeAxh8<Wm)<>k+c
zwpO2ZeFszgM;3x0jm($#iJ(4N=1umuS=Y#@@8ttvqO0kdgs{dagSy^t`!}W?QBfM+
zqo;4jJp9=wQ)^474LYwCtUk;5Iyv8_0!LyLU&B6wsVx&;^mh2+`v>gt(e#NKPzf95
z`shnQD}_1p+3@w&clP=`Sz@<{j}Y>vMPW>#l=|jR<tFL;{WEJ{{{RNZkA`|628^fU
znZuaaf^*`zJZZy|Ur(ULld3x-2V9bpt_nEhHrb$y77gM|ko5$3s2kscK6w`D`i`7x
zf&66Tt8?->t8Atse0Eisj9o<UlY^^CiBdE$<xe9orufZvto<jB(q3>LagNwF&10&K
z<Es#HMPcK7tYv8-i>~Qq>1P)ltE7*Pem(ZL+46mf_MEUvG_-Bcs`feh^lnvw_s;|P
z^Xwt^m)XPZI8*xY3UCMBPxYTc=sf=bV=uRF68ZlCTj2ZH`m5$1ci4Yvp0}d~g}h(~
z{{YB(=cq$z1Px5QZOG4p`wQ(x`#Y-u{nj)`sL#8JiB)L)z>P|MN2Y#-S=>Gb_34z|
zFUUA=G9N?fnP*UKi1N3Uy^eYgx~vU@ZlrcOo?snIkxKqo9*5U6VE7;7{{XQJy(#-j
z6%9X3hBpLXh=*Wy?k@B57LUYf9b!>KQ3<}Eo$+LT8T<6ew94onfmTz)DbL7%j6TCZ
zVg0Y+LIhnT`lW@p*irIdw;wT@?;mcASNfOFskZRVDwQVdYv*mg81cxWMN);9Iw1+Q
zG;ez5#o|mEXLXV`)CtzCw90RBLyf`4PXx5iTR>XUpxI;oGh1*pmm{!5LRi{qwOhVE
z9ljVIH7W>gC79W62N}@@dmAm?vGx7f`QuB|&(cjKb0tcI>yAN1NbE-=2%OqnM@12M
z)xWQNY1LXlp}dF!?zKm__2%=suj$AVIlM&$s0#wD*CWv1&mYHCfnr{sFy!v#Ni0s(
zY}VZT{)H^7;z}sFZ39svz4-L3LJBq8m!U*<B8_~o#KlTR2rOH;_4PRYPgY;4o>Lm3
zk(q{;G=+}idv9&c{Cj{fhi4>cTO~`92_m)~iQF8BC6PRZy}J@lGHa1^By7!g3W9d3
z+bE?^PC#N;odt=~Y;o^EZhbx&6NkheH-;ZhnteNYY;*Iko;hSywS96h^QcM-+iz2n
zjI?s=(zdi|w-!BbpN3x6SWCwO>lV8cX2IP50IyB(I!PlUaARN|nlL*MYu91V;gB{I
zvZ|mU4_?Cm0DZEJ43UJ9nN}i4JbZo@576TXPx7K-UHWyDpx%Kr39BCq_>2izbdsV{
zO*XCVKOW@&0M=BpFesqLth;JEC<gaE_VgV6GHS}o<-!l`6ip59x5GQCW}4(@X13gE
zr5C>4hkdY$MKqImi1J8GfG*9kt^xG`50**cbf+p7HrY;}ya%V(Db^~wq{|9Js+1}N
zq*AW-Nj7fJx%9=}Spkw|P_#80ssg`2FdA-^<FG*m8%u)2%GO1EcE6FytEtj=R8keR
zjrYC(01Rb?q*n03D!aSt0cz^(@HZb^5WF#2k~So$DY)6Mk_a{`_S@s?Q)o$3Qt1XV
zb~HBRdy~leVu=GXl?5nyt*+X+!!C&=A|*ahO@rxY+wk<onT*pC<zv)Bno0n1z`&$x
z(UoZAL0W1}T68hoA6pym{;?$Sm&qfVavkjRw<q6o^}{KZx-~B4<4+`H_7+W7Yb;Ji
zzow^1uzqLT0iyE_I)rQYg^ROYw(o{dIxQ;${iFaalg8ga!w-@|iwtMP0h!Akzvuz@
z;<R#(n8;S6Eu=B^6iEEAIK*R?IKnWHHkS>zn*RU|t1H!cA{8uEDk~ipYQMCTz5W|y
zn#-04UDIv_aol(L{PVm;4$MH($8;Qu9R4Tq!a77~Bn!B8Br*;3@qawwBSg$1W<_B{
z_o2T306=gzQzNvJFuiTNd-IA|G-rCFb^72mphYvH&aA0mI@t~I_~RuBD5#HCz^U@4
z``>@p72`tQS6%ny3mjujBN);ZU{O}~U5Pbk@B;m?7Ek@cO|um`gAw<vj4>!?76aPR
zzo5x225SJ{bNT#op@DFS1b0ex6J59Zi^7$_k4dUDLuxl?eaGSR!PGPO+GIyo14~~f
zkNO*XVbrfhV_>Q+^mpH5?Z_E5c0w37{MW7ntY%wcKvB;7fwyk_<&09tFpH?DqyZRe
zBKJ^1ze*$U$d)r9*%sK4qmk|K#_?lB(9v7a-0fb~e=G@_X*nTFUGqaLuf>qFJ2Z^M
z?gbxn_~NiFVW#A3HY(4j$D9m=ENt5cUn^A#y7}ZCZxIAAR^%T404&ifNi!6AN#DaR
zz=Z(b-w&5;f-F^XYSmj%6n5KxraPY+V$KYV&8d<i05|DEhsb3SjFW4v7R7=`G&sO@
z6x)Rre*LlRYd#seu(!4>$~G)U;2Q?;hw&qf6-z4T&0>fbz&HAK$;idRgLI;oe%$A4
z-htY?D93ka>Bgo(r1?}X=J_}B?|`lV04?^T-1_AucM%8~sRI&u*zN24+ZIL=5vG(A
zdVk<PcpXBw^#-x0eJ#f|zW)GB1!OwtkO(?WiUZ#qkGuf_GERe4s9$598p_TF#h<$o
zjVmGwxf$qLU>8ew8*)CG6&4I^3$4NLiV4&R>_MTHlv67&{{UvJZC>9zo3YXq*b8GQ
zV2Tl()}X)uPX6ZsV0!^$>y%|r1hY1&0SXlCK%?5e7>!EIw4_&V*O45JCg`l;KJidZ
zZQS5cvT6nBjqSf2c%YrbG%?8P12Lr}1stD%#bBjJmaJZ?{4k(Ugb2h~++}BOo;8Vj
zXPMY8rY@mr&md7YHs^1E%%lxhMz0_5X#&ToC!C|S(*S5+7HDTMAdzEYc;gF$q!Jh9
zg@ZLBwT0XRRmS-TOBwP=);vI1U#IM1qZABvUZF$|<G9XkD5Q!v>;1UO6rmuUdW9$(
z5$<xJkVPnn5J@1BMBtKN6~5vn04YbN7pg)dbQWo@@8N+NLmfz_&kfrkX(Cv)DPUVo
zn(gg~qhLtmb9v7vn1QH_0ylc9Ad&$0!nmC!SXKAUDCyEp=0K8=qyW3AvFZrpoXAwE
zqHilRS5n?AXfC{nb{_&SDivea#bO$$S+3YZvhOCKjkS*d0KKtYO76OVBYX$UFOWNW
zU|CuS*@20i5w*7mAPqf%Rofd%2*U{mpm$Tr_s&I9rHJjY9Fu^m3pd`=w<DZTMg8r?
z*QQanav1{m)135n0eRRAfdQu2@9@sxZUHB^rcqT{FL3L*B<y_#C0Vj71Cp!~*IeVx
zCbld>`HlH|U`8=Lf;ROV9A_xs)jN`Y?QQ=6SQB8{L9d13@_%qQ#SAht$i;vGeFp$y
zXs`~Yzf7WnQr3n-t9Q8Xh$({x`^S6zGlYz)!A{4MShfkjPizK`k%JLnZ$xEgb#i55
zrJJ&ftdq%ZSPdh$wkjH6$A3yV4Xw23)WJ_|G6f0{8YAx$>w;Pa#?~%|C`x4vKn?GJ
zXdU%$`QrZoZgE}BRx=R2!Lfi<RiY#hFgIlFSuuNWVB?)9g|B0ZwPbIA2&WWpxvXVC
z%Fa(6u}xK*9^SZBjo#P`M{mGh5(pGUZ^6!|yQ=u$+;TwQi~<3$06D=)Cwv6i*jLX9
zP!Fx}a6aRv@ItVW-&kKN>HT|VZwX{_tOR~ti)M#KhI99r5q`V>0E@^uc9EnM4bT<9
zz%lgtV{bj^7rRmVWR_DL<c{L3d)`;4Q>>B{+1xdpZ93#35H6EIj!C}x2PcUclr&}5
zn!T@+l#BW?vocYxSZr~b>?_Eu%G-Nn<?&&WN-~{mxEuk0t_1pmOQ-=>ja^lo3|S+P
z9drm_)M)<B7(@7s91*oyJ-EwDKZ^ky0D*ubdfzB8PyJ6ihC;fHy;<KCmse4Gbi}2I
z*SG-u0P#Q$zcKoF6Tk*{DlYVmiQ6FZ%L36h#Pe5QAFe<ZQf+NWx&h#ATUHqiMM@N9
z(^M4L^xr7qTc#?6$1Bl06JT<G40&Y(rGhA)RgnpKEkFyk1M7PpepnKIoWiCzQf@t9
zw>nQ4W9k+bCOsi^fu&C-_deLs23jQehC#VE@B+urjDrV=JZj*s!&Q7Y1NFeL>4b(V
zm4jHZz))~RKbPwmlEfX05<x${FuOz|GBT0|<N?my6MosyNS#DXp$QZV8{7-u@Vo-d
zvCdg$i%zQ~DLWItBYtpo6BmTsVw+-Wx#ZW&5@=*d1ZBUbNGHv;{zsFS>D3`<<eE7Q
zCvm+4U95~MeLNSVTucI~AR8O|oR3sph;o1-Vn+8vFRD@1`IrSHfB~=v>yv3<)K*<g
z0W?=&PT2$=M<&e9&Bpz!x65q2ZmkdkF(W?qcBcJ%V=POd0+mR{?B0jdpKQ|I6cap}
zI;9~HQle86=~cgN{ql?*Lo!&UFQh9D<No&g<<@n0)wGdIKp*ZuztbL1v*+o$O;Qlb
z#6FO3+~3e*2U3Zq0uXFjn``*(`#3_R$Eh*FEBI(P15ej(GA*idDd|-105oXvl!7~N
z0t9Dp2s%L}kF^WI)2NHhBP)aVfIho_j4AqAK<Z443nyS}Z+gXzx^mq?kz8v8#;LF$
z8_r197>fmMG6EEk4%T?fNf=QSnw3LV!)gQHjDj6YH%UBY3YI7d)VJGieXzq6=b~uD
z&SMRzpd<i)XYo0s?IQq11%<k+003e~A1|M_MU-^VtiB|2!6v~EA%_+}?<mc3$85S=
zkVfS9_QnWgb|njVo{h)P_s&(CH|d-eC`m71ReN8i_|U@M8os*m4XTZ}_4dFMLS<+n
zl&n4yggk(EJMV&cG_Qz-4Y6Krj{N%N3yJ!o&dh?2>*W+Up_A!~BRrA@ew|xFmD^Jg
zXbT%;3W2&sW{OExIXt0((s<tUJW_v6S@%Hp1=+_fvlayIX+itAUT7sn@KIw1g$=CW
z8C9l`X*$AKYv2yY9yX7oo>WN0t0L@P#S`37{ni$;svaVjY$OMAI}Do1I8y@0rDdSa
zVBK%Ord4!ltyV-O^&h+c03&;WUY+xykx(@5OBHV=54?N)KAB0N3j|;(RA*!ofJkC0
z=<s>%g<?a}=|(L~S5G5;52g_89yMOFNSWh|ki-%ck}pofo^b`tvAl7UKqit21cFEa
z4tW`v^)(iU8i*QH56-*eE`b3cvXH`scJ(Lp$T`|X>Rw^HB^NBTy8Sz2bn?g-TAvY5
z2suA5d<@S7Y62J5#?S-i^gjIIg@;bAs+wd#4U<IkvG@M~7#-BGa&9M&S{VGs&E+HM
zWV8X9;*A4KOR(Oq`;EufI#}kaWJVh}bT+H)d=7W`<s=K|kjOPo+O(zY0rdF(`(atr
zqnRNxv1CxJ2y;ZAVe=T!m+8ZG21Qw7Wbn;iqwpgkI8ikufz($#-yWZb<CdGPZl+Kg
zG&2P#NdODj0s!070a4?MCz57)C1O-9@Gk71!m+xZq{T3u31Mi<bz+49x1ir2?E@%~
zK_kFu2BcB3BYrrnPN@F?@-V8#8%q-GJCjH9{O~CZmD6<%AXyZ!V3JsA7~PQ6cq9@p
z(=)(gl33%JK=DBi{ekR9JN<DPC2*|t3Yr&wQFm4Fyrfdj-9VN<Ie>ttuwBXhPuByc
zCPU$~%xv0kY8U+vOlB|A&XTj3{R$n$`jK1@&pWA+$510!!HG#R*wRgk=C8IWW7M>9
zI8`d)6_skN_xk=A6r3SFLdHCf`V^W08{}vYu1}?a&jg_<d^q(;#1r9*1N?qDKzt6K
zNc0y-<QB>YlyQFpc_<jN6i*;Dnya4ofqA0v6Q}9?L?%)mQqBksW~`1j_x!SrI;^V?
zQp!<fI=mVKU;*F#W-U`gBD8C!H;a2Zy+xjDf1blOB(cfSN#KZM2G+>8QU=2R0Q;ZE
zAYP?F`${O-s;Ds*SF)@~2G4%v=1!!hfzv6XlU<b}`(NS5zG#?B*2X%Xrco@+l+;eB
z!U09TK+yKd^%AtO2WXNebQea6-0!y?zur;H3m%FsR<X#$c#O29-H<*TWTKI#k9H|w
z0bQzqJ7(Un)JfC$c7ml+?Nk{r*S|j@i_-N{LDNMShC;~8AOv$vKs;|^#cjq0P{|X?
zOiXe<>UjZo2Y;Sl`Jy@z4}^>*m5!w#l2li22KVu=Opj9%F(c3a0JurD*b~hj<Mhk*
zVI$DJ8kFhF7l1t$3-?Wt>QtKJ>ww{{M^339P~AeS89*b!zcBy}hSz+Gyn@9P-DugA
zI+9COMtfhVs@&H;*poCNSHNbp0h!M$u(9<g=socn`lB~d)JoE7)BQyYr((7b<$%hK
zG=dml@g&tr7a+9(b>8z!#?W+~Lc6h%j7$Q8z}PGaIiI9>T7MI%xw?4dRC+x30{#Gx
z*vcndr>Kz~3&SKp5>DW1*{jqIfb_s_jn(0vF&PpnkPhB$ML`?)u097N45O-<Vp$|u
zWo6eyF&mL}wa_Qin!fnVG;|565X7=bp@VGAL+e7wKJ}7<L{7CCf|8{`AO@m7?%W<Q
z7^_NRn?UlGL8{KJBJ|(GY%by`5tT-$TG(g+9Y<~JaaBW(erAxWBQt7w%k$;Y#@^(u
ze6oEEGQ6?K$!tSuAd)VuAO7SU{niDhU2}M~wW#9G<bmnw?U_@kVq-}nu%1z4YqMN$
z$u@DinZ%PRgs_WPen~7#5-j(xPmW#WjiHezM^zLXN{vgnuuW_^u56D?4DwH8DkM~5
zTA`|lACW&x!xWB?sW#~q>+-LYYQLVs{k^e_j*fg$sKj*;O$YZ~zju;|Yjx?=M($fp
zF`%ct+2?A?g26gTqG;NlC!#3bgSjL3@XEm{>V$#JXk%kCs9(HIc|ZcZ#ErNBADqOF
z(@Ej!5d!5KMQl%D^ZdQDXH(OvbuvR2lq0gD>aH7;>98E0$J+|VpVS^SY|%0lipjq(
z1e4f%W2p-#M=L}OT1%{Lur$qoB0(HrE{gzDB_l8m8ZkP#qJ4lh@;<p<wg4va(WB4_
zSd{_NLXa%i7gk5;Mgq){o{|zM0;Wwxf2i7-fW7PcdF`t+>oA_7Br2u6x9Grw^Ba9}
zq$ILKWtKGo2Q)>K@fwNx{4vv`eyU@s`gTbqke~*OFdkmkLEu>R<D3UEB(WojVqXR=
zf&Tr;CXVES!{j};r%lj>iKKGEHFS-~s2h`a=|p@_rc161Br#5gW{TNN%%pgX4$6P~
zojVRMGtDHYajM=hXg10eSLC=9pHvbEx|MG}nNOJPg+nMGUi|#8AMEEcb)7UotxC!$
zFafu_v*>K&bkI!kbwT=bBv8lUmT_Jl_NU@VB9E?U`x~S2I_{P!JUwsJp{+rzT^<Mi
zC%=3T+xmtt8y)GSJp4c2avQN+$}a?|Q6MZyGPl#qjSrfM9LqyGA;WJi5t|o$%bL1k
zwHd2ApY_afsnrm#{-Gx{^r!y-ZoL@gV(yrO)%1suU-i#ps3fxjE4FzZ5|-<_Ut@Xf
zN_7`CUisI?`*dL<M`{~t;EZ-+6{1jd8$14aH3pW?CmLA`u8>I<duL;zo>v-aK^Mu!
zLKZaCc_b6gPDA7%5=SQl?p`QtRSv^5t2k%sn);b4j{6abM9?Dg?-*w!4o-K6wrtxi
zrKG6i29m^O-J^^XBY?fhIRn@9gLHj={g6&NlV=efR8HAJ5#(`@PQ6?bu*iNuWY1C7
z$iyN>gWk{h%w|$sgg_h=fv(14Db+n{otOUrvH-;&XR5I*S&wo}<k~hjR|Ilt@e^OA
z?}+~ZX~dfV&V3b5B6P6><y9WIz#?$GU`_teo<mW<R1WNMOr2}jnNWK#KU~rkM?U0N
ze4>kPz-`7siJ+EEo_Q<(025!973iaP0j;n8M(Z}{rN4>!-f|&w8oZtIZ8nTu3|15Y
zM#eblVqMf<$2E9<A<%#ktC8OF@pPmU5CG~brM)ZDF`FA?2!Q!i0#D(LMwGp{<2N3d
zbio*q9=8YAGY1iqvXWR0{RU0#8PE_fa&guWP_q%R8+>rSm9}OBeDb>g0OC%QqYMLh
zk}kw4yq3II%EV0gdd$Hsj@#eEJdd=#-|2b*=5Wpb01?U0o9n-ddcLVngP;&d3!XY8
z)37rzEaZ{DHNJA+mGxHG#}Vc0^?$`(RP4(T&^>Q|!!pD6$533E!!WI@*F5mfHKhd?
z&wO=#I}SJJIr^<Lxt7SCc!Ej{y;QTl!&QNNVryd{39!4$mM*kKF4ytNIx425;`hY<
z(_o5Zc;i*?S@-_{!9Qbae;!rY2HyGdA7gZH)Xsv7YBaU@=j>l$eVjTDjyUv-p?T->
zZPh(6^*EI1uV3xD2<VR3Wk6Ms@!u!~Hca@0%dG+^YC;X_6gSR0x@qTc7De!!qVf-X
z%{+RSP&?<N_Jmqy4x?rp=0;jPUFU($<9m@X_jtLrsd?p^Gs&adEgZGS7<!1R>oS64
zZ25~s(%P4;8oV`4)5Fx!k$l~lax){ZRnd~)`|)~@yuU2al7n9yvdMp*XXnEX_3bS1
z^)dAd2w{#z4{S;L80T$q6AXvC@O~p9<4@8yo~bQ+I_@(GsnZkjX#)uN&RG^gYHVO(
zy$j<om|-UT^F$5+(%>?YL>~E^ag48A<cZYo8tq=F)W0zPEc*?<!~0p$0T93SAwJ#5
z%RP_bkF^BdKY)JvZlLGae-M3;pKtw`@UnqCerTJ}`h4^9$mHri%Ioy7D(Lh<+KA85
zJr~qtlZ#V7ls*I2coT;wR7Yukgz023YFFHQHc5b@<O**qk3*B_I>hUGWsykI{Ezsy
zS=cDDHoY!CT=${iGERgOV%-PTbLW4Ge!`FK{{XXI1s~Rq<$$00cVD0Q&!?AQ4O^$;
zGaSe)=_ZevKgLyw)b02r(8U~uG|4~(zWS@a-nX_-s**Dpjv%3LSu`wcHoi#bZZquv
z0FM5~{{Z2=fByg%>DT&QNg>xwg>s}HhTD&O^v{s$W$_wUF|2G$TG{Sw3hYO}rf8Vc
zva=H#gqlY_Qb=$#f<WAJ^Tv<|Ah@zOX9md!*Wvl#fnQR$PNqpTHK1D~V`t<yzTYfK
zCuT&9sMQ#+x(C<S=aENB+vyHe0Zc_u_ZPMW3hKb>)q5!Q_53m73->%V4_dV`+)y{|
z`rrf!wKG=)lef~a5lh1-iWgfIBon^pYxs_E#EikJnwH3Bp^q#YT|DI&uClJRTkHp|
ziuAz}i7QsJ3Z6ZC4}I$bZzaqaI0WrVC;`SYx0!%jVzfQC$~`>ZcUoHsr+_)H$04A@
zGWd%AV6CL`;P3d101*A*T9nb%U%uI)*`wC(rBt;PkM6C1qJFs3#u3D5>e98?3qeht
zzb*aqy3ZI$WR+f}MUb&1>b><7?|~XKOc7NA$jYNzP#vt3u=hE_5*-u73a6Gf6cdz=
z0>->T1E1+%-6F^&pWoq<NTi-)1bRzTSlfUs{sREUA|KN`lXk#?y=*rgy!zydusT4o
zbV1sVTf#B32SSBY%v*i-+<a_gk;Fifs=|oe`i^jm!5Yev^zPA?)-;jHs~a9G{b3y;
zIvwM8NkLW6d2TCxtP;C><kX2&f>JA{Ag-N<q33<}?}YV}5;be`fmS#Jiahtc0UMNv
zqexV#<FNRAcJ$*JI)COmp$rWy<=aAePNUduzth_l8W*Pu=0*ol<IQHP)Kz{XBpdpy
zf4H4MgInMkREH=Y{4zz=1HT`x`DE48NSdHY1JTf1Vgqru{k}AE3|@n_<?I4aZ(q-R
zDvn?JY)KoEIoqGq;ZCzj66qj#c24VH9mW0`+R%c0Pb_WyH9hv`yI#cP-c4RjM3mV<
z6bAnQ_l75Ur4AWwMeYR;uY3+td^=%!27$M^Jp9fpGtNP4a)W|+0Dr8#LX?B3XK4*c
zd_9)x=#ymfKkpz$nJJhJ&l~UC2&2dcnQKueW&Y89kIMzDN?Ei?txuBAl=eRn&U8_j
zhNoXUH2{CR*SEjpj?DxT#?b*PGEow(4McCSJ+EWz4%i5MA=Bv4##cKK+W}lx$KU0X
zN7P7SLXcGLzqiWkG@x_S0Az@)dYmcb*$cgVs2@Y?ykHCra%yHEmZb#MZhg4l3NWNi
z;;EK2b&t!g{N~2OxY*wQp0$K3HAF2*3Z;RyBKM)+wjp+rRa|P*wyq8qDjZdiwskMz
zfKO33PZYf)QH|Q!Z-!f=UZTkPoRoSF?xw5@!+KLt-(naO$M4rE3@53PB8Vt1LW0Bq
z2|SbOzCqq7@YL-@ohk)ss@$62Y+j)iU9}br2^2>I_j$~k(@w3U1Oq@`_>xFuuMyf!
zAOXJv)9F|h@X=+DRE^;4({<(pZ!j0{w)l!XD`IzXuw}bb-x*1X#HCf}f>o@mZ^0ws
zk0Q&{$s1g5#Z~rgLbf0g>FN$qpHWhE4Y=Fezvq^BMq~;_F2J|Pn*B0SHitk+Wds`L
z$L!-*h#ic8XaI}b<&ZZ~p`GPcwItBhxaZe=F)Y(6s({SIg+OhA=Z-+%;m^JzpAe~A
zGU_ZyAHDg&V=1KRI=E#gzEQ~X9U?VbMIex)j`!<|#a=a~^9v;3Ib$MCB5MAc1*Qw>
zci#~rNo+<Pq#(Dj19N{X$PprU7K(lSu;_ULEiJLzZhK`X@u8PbhW$L6K{sI41Ajh#
zc{C!H$+7r+GN8PS(!7mCu{wa*e1BYIEdh`+GKm0RFyQQee;k|0Son-tnBCdu6<n5M
zy`BfQ285g}gac=@u-y6_lQfgHf;{J)hH(lCI__v{4tXQ=!6b!-q7{bbxC_2TRau@T
zgsAYrCtwK|{)Ptxm(ds$1*ivZ-Twf4;>5-jNfE5EAgz8l5=2g=T2ZZT%{5r`yZ{wt
z5vH)DkS(wGLjs2Ts-T+#Pji%s9%+PeXx7J;AOY`ZVa85CP_c98C+n327LUxXNE=wd
zniMH!TfNlT+ic*M-l$t@<M+N95dozkx4pNksu=?=le?~=rhwpavA>ONl2fD`+!MbU
zL?H@!Y+aFOaeQMgwbaHaz$6Pl+r8J}fV!<wRTV<_zcX*&;fT(JX%|2p&wcW<c#48R
zmm3`+yAlT%^TdA-P$d)v*y$(CZ=9h8Y6C?J&SDlrqQG6iys8ixpHVh9An<=&nhz3v
zL1;1f0f5880I?0IsjarZ@rdDdc}X=~_sYhwq>8Rc1k;+j-+InR4(ya0V@$`285O{I
zO6x$E09hAX-rr17s4Jr0qqSFVPvwdOE0x~H=i58XRgD2#4_pptWKpcGfw3cSF-Mb2
z6I=Xi4z13zN}hjA;@c@8ZLk&FDjr~Dca#=k$!e>?Y~h>$rMaP4s^nM%{5xkdTM`Kh
zFdM^FZx32AKimo1{NjJ@zo-@g2C&l5ZO5;%z^GqQ1MZDSAfO9Rsccxb9k4noZkEWy
zmK+~U5ysD}Nl;X3I?ZkR<nELk+#U`Ch?~M`G%-+XSQ}raG@2BkLgv6HP#pVvWZROX
z<BYMh6!MdNS9}C-HIuQtZ!V3=zfRaIeeV4$oZxJRpfCtFb{he`Vzqy5oTI5>=A{5_
zh@(Z=KRls~?<yoTrB{j+N%uHpNKsW#w~4;6K&AAfd*EdN*Oz|d0Ifhd09PXb5=CqP
z^&RmQbs8qU&OL%QQ$u_1bAuKXD0|idf&eF+Elot<!x+HEBOn8xQGZNb)Ng^oY=r}J
z#`(l~Nb-;mJ@cN*r~yTCdz?-V+h9<Wpb<ciO|oIC#SgAHVW6M`>Bb=++us4Su>iK(
zxV#K+VMF1aL<3@o`r-2+vs8E<xDx|=JACno8gEsfOdDOB#sNmc&#$%zF)~n~C{_SA
z0{6yAG^s!q&m@iUS+DMj-vjO=0m-dRLhAbraU3X;F;jP1PV{klY4ix#0;&Zut+Hr`
z!*vb0*ezH;;{lwi#1#tLZq>-G@HFxkMMO_1CV&K4Bhv&iFHpr~W<nT-CvVR>RE=j{
zEJBbAZAayRd`4))vh2G7Row70g(IR(_<=wbz~9$6bjo^NW<UsPRbDyu_-96<PMOJ5
zrJDSsQRjb#0O}+@DU}p8azNV2{{T3pRw&jJr%>4Mup1wabTlSG)hN?sTN|zY1~*mG
z0?JUJ@fv{dR1Y5=urz-%@hFI-41^ZhfhUlDAD%186!7>D5e703^wbhXdirm8I%bL@
ztvp|L$<xULwq-4+s;>;ji~@k(Qb8LZ*8=O}C|Q72D7HMnaq;J$o+F6m6U3|k0E+Ht
zn&;z^mKj8>>;Ow2cZ%SCnC_ClQdTuUE3n`N{{XxSCsgeWT^j!YaRgc8-|;vEM0F06
zp=VvRkA^~IGL<m7wIph<y}sWJ(<D)J$PA3qyV29zdmmhb8x(y(1u0{pjqX1yIib39
z)1+y>ogtWL^);2%0|gPH##MGC@@#*f!xf^C6_5}MebK7B*UNE~EPY$7izK4d9tr!u
zyTLT1$x_=ybroHFU;X1WZTzDHqgowSI3mvEkJlnpq!JZ%k%6*oY&+HO-+_@#kuxwY
zBzjWFx;*~?)%#%TV(E<HID?n9A)SRA=IGa_d^+Te2+}eGuia&!e|zT?l(cBd7E8Lb
zN)Ge~@3uhBV|DP*68EX7SgzIb2Qx}cjwDdAlR$yB4~_ooG{$C0+o@CmVznmE!{x}$
zA-Z{|fXNwHOB+QX0e#1RPo`0d6}@U*LaO?jYVGsObn(c^I*lSW{@cH67xm8TB46g`
z5rG<#baQN%$Q{18PgB%LMB}NAm;neHHy!;bZ+qZEZ@#g^{WtrJZ_R$U+a3By(KSlS
z-V)I&!1vpqd@0kwVRw>Zvw$=TwPvy3wF~-UGMV6IL^{HjV|}WJ!@dV}{X0CdMhnSo
z7^vJ<Q><_nXYrUi5Rrg3C%*ohoTu3n!o3vfDj6gLTAg7)Bi8x!`Q{U^s2&>%ZM2nO
ztA4xuatc6(AfeSJEI085=@r_E&REntKy-jj-kYF(&m80Q{Y-J`Nhx>x`az&Q0owtI
zJRsJ`av4qU?_=eZC|H?IfWS72)kppDfT2l`g*u>7+@9vBZI9AIVwy;!a>`9H4L}aZ
zwoXYxbs-ti!UIKsBY$tE1te+EuTK#S2@aZfJ@)sl@gt33>D6Q;yifN%{r><QuTBq5
z3OY1vFn#q4Bpy2*w#1iddYSdZB&<np2Iju#`Q#m_GfNW0eDV!a9sIra$aN4vC2!@}
zx+wt(S`D|SY;};hD*i$Zn&$mJ8CB`!kD@}-YDR0Ju%Im8!vmx089JVjwt_({{vfsX
z*zH)dN#aPY6mQ{bRgra2Blma$!P7|cnwL--5Ye&geX)X>^sUDcQdzXn1Yjh@J1C8e
zaa$b$$tpb$ukUOTtdR900Gsm5rir2R{hT5OQhJA1C|Aq1oAekDR?>8_6C)u@CYb7Q
zPdD-y5Szu0B)=}^n@;WReCD`ejmtP<1WH_z+}PWlzYHD>QiW(1MqL(KLACQk*D2F6
zo5w{(SD9%pt8#B(HrOAA1cFPdHexk(3-^lvJ@>_$qd=~fRmik$$@Q;Krbx&bhh-oE
z;epDb2Q4}n6#{B3Jj~>eGM~$iFcF-g5dc_~C`Sx;-tfS_Je@h0s34cEWc|VGN7#Dc
zMRtWGkV<5cj)qaa0mtQttX-6J_6bcAYGJwW^1!cH;vr*9fD%bx?f~;=+XP-4ppoM$
z;Xt)J*E@UgF<@~FX!ckD$`tGmwbuN88PfF(u@#i~l95Cbe4@77w{9@2v}diDN#%fm
zz!x{Fy*nMN_HunP9-)F<XdlcqI0~c+vQOo<XSo(dVjiMe0No4t<yfpyGI(pRlSJ4A
z@I5{_Lc7FOCVN>C>_?-@!;|y9vW9h)Wl&;Jgfg1gsTE%JhptEraFvh41Mh&^h}?oc
zmB0DG{Ya2VrBO&iscTimae>oM)OC{h%vp?-pvmqiAHzA4CRqze`orHKf_JlDzHw%9
z{W2f9p;crk4(u=9xIL(0T?^tkk(FIJVfT&f2pk&Y-2CvaWz*8zu9qO|8yc$H)Kz7=
z7{f;*#Nd$V%!N2!c|GrKxx8Mivh^$_>DnZa76c6{2IA;#K<(+aR!)njX}VYwsnBFn
z-B}B$APP7F?_qb&_z+LDAEk;#iX}rQn#Y;73!}dSem$`uU2@0M^v)xYx{}O(^C<V*
z)Nh&kv(vGWpb}_O2-mp^03E&m0An^o<RPP=&r(KfbsDRmmHc+XBQH@i&o@%#waoTg
zRbAOP+vSM_AWmq8YTbaf7QB2#{d1-zgpNqGe=nCxkOBE!0rAVJjR5hR#0?<U6q+Pe
z?eK1Wu%+obHR@&6B(adIEQiEq0O<tQ-OYczlCzHt26m7EMDD9sb?ry<%9m-Dc7PEJ
zzR2tg>Ef@R54Y)!)Ab$@W{8S#R0HPF4(xqyt9`gQ2d9cg>c~<;vagsn#P%ebs~~!N
zV0acDkV_IwWFR17fGm3rSHJw2k8Qnn>t%#0RQ3ZkfJp+t0PkGi)8m=hot2(Y975`=
z*bCg)?|buj4&5p0<VA$W9Z_g&pzK%F*1!Y5A5m`#!4jx(8Szn&vo^^`W4C>euVde6
z^v$bKX{nMX0DuTIDL_5%Z`jU}h=F=g116@G3V<Af0`KYfcsy_GfZ+-0CWM&8s^iLA
zOIZhgXwVhE{JrlgupyJ9*71~wLb(abbH4lhb3gMgWMdR?>X?A7row5Xw_(K|)NzEu
zLh+dNtj-Fx{nb-@Up|(7FcYi(UsH`Q60Dk%hxQiXLH0Mf!tqBG%Ir%KD6~^nyLau*
z-|H^%!XlN7va7b`LF5&%J{F@SVo3i0mPM6y$rqbS)|+xjW8Y)x?b`uZqo%Dl1&u^{
zB8vmRbI-PO%+PeIgeJMH-GX%R1y<a1-{qB03K-G)k>Uo|8B|~nzy&AJS^3e)0Q#9q
zsCUykfR^?ymb(LYUX_4j>O2mmBaMuK4zS=G2T2v~ERNrvB=a;~K9@zWCzKyDkO1Fn
ztgM0Nk@~~2m5-R|-GQ^|q;Y@X;yV8TF*1&-Lu_@M9@oI{upcqo0VR35zYoS`r_vFQ
z<aVNYsvY?G<QVuas>)oU{{Y(}sk?*kwS9BY@xkdqR*hW7?pA;R-)}>(01D&doRLZw
zsYgvVqE>kpiZ~Wl`4&Z1--X}_q>@+ZU?k4*lcB;}5OnDPRguQWxjz$GQXY<D)ypKO
z#-hQaK4MCpKMJxBe8f@YcSL7NW74HwhLCRe+PNPq$Aqs{)0k$P`ns$FH4VdR_Pv+4
zCy|s&7~|>XA<<;l5GplL1g-q}s_*T2PM$fT>Pban@eTBgEN=Y6xY*yY#XUoRG75mc
z6vgPMwO~Qx({2xZs{a5i9(f`&j+vQNXt69!*c3RsBKr!+5*cEPT`3Z=&>kk-h6FX=
z&(o9JD9O{7h6#v{IJF}%qGT%8M#jd~LizaZ2)bUC*y`#4lFF5)Ci@!~cfZc8*7&Ew
z@Z$hUB#N#WD5@m+PX7QO!=FktyvkBpBt9!SVWAW)DPTYZamm`Y`Q)OFmOlyNEb*Xc
z)@f9JKoUpRvTXFa3}mXaQia`#UjE)&%@Rs_sQOtYH5`wnoG~oHNhFee$lKeFFf%nr
zE37gXL~>)1hL$vTYWnxjWB6$rf8sx~qG*Uy)*}!v$XS#NK7jW3tnuXP8HsipRe=wr
z?$*{%`u5Lj_#!2n_=oK86K9XBh$6B3#GTvd2jPMHB&;2x0YLtt{PDVS-_iwWc!v<u
z7&L=m_xR;{b=BaD;h6pz(+&ypq(;m?7R?<g2#II=8}rQlIHMQA^6`Dx=ui=w!ZdxD
zFYPE)or0G5Y;)6@m9>zy>3Qb;nsjyXf=2OvHJ*fxt5Xi&j&|{*v!@q_MuTllL)2$T
z;3tNlAN;*>04(YUB;qmONbTHr&ZuvK$t}{b*d9R4vrQ!h0b5TQreFxrplT<ahLWa;
z1pDT2${A#Ct%jA-o$jpS4w6?PrRrsGU~BLhy0#w-aT%*Cwq2WIU$f&IkYCfjU3yeg
zMJq3$j>G{(=TIabImm<xp=n3Q0~>9C2MON$4B&vAp?#~i`PyuOXMMgoKmn{elx{h~
zCQ^XVLlf<f95y$tcfs_^MCyQ&ES@X2QYNqJNTNbJ6V6GM5zrM~Qif1=TO9ZQ02o9`
zypA{)DD#cuG|XApo=6w%##RoMx}Q0uT|3_#=DD4D6G*&MsER})@6#@;2qhvkhW0(r
zY%)gE4J<UEHF&Kw3FS@nn>XC%JK8%^M#dzi6fL>q{os?T5e+M)i2zv4Ge}vPt4e$J
z8RY$;{6*6ATBA}VbLqf1wAQh^O2uY;J%iOdZzGZqEXO>5w7-bDZio<v#Fx|4K3lK*
zcdP5!fRUCl{i)yQo@slP%#X5z?|I99PWw^1F~oeHkJ>+Pb)9+p+Eo7lYMj8ti=(}2
zqs3%qeJZ{k*xPIXJpsLy+WTiT?q_n#tLha;iNRO2Anosp9fpui1=U|XXp>VGVY?it
zKnCDgG%qrUNllg3#DER&IbvtuPnUeqiQ-#GDQ<wnBao~s%RpHDGbBl#qjjtGyo`iO
z$r^cyJ+R5<wo9u6oZ0qQNR2y4tO*8@d!KyOmfbP7%vGD(D-W;!2Kysa!d4csjfQ@S
z5UcbX9ka;(8|Vi`_IfQ1L|M;fHrxSaM%R2FL!M6e-d@GL>O4T6agUqI*~DHjUOODd
zNO}EqL7^(6alU!FcI}?zv`GX}IpsWF6s)J^oIHyCy$&_|X^KR!LCjOfTX)Y@#-B{d
z)JJ0LK6BJ~y}Ii5c)7l%=BpHMOu9%9AC5*uqly@=`Qp~vm!&ZlhTT>yagMGWQvks7
z4rNI%zso93?!Qdm6Sj$>GX0&W&(cZZo=P_Af5sr{-X_u1Mq@s_gY(TREm%C|11y4^
z1_zKu<~k>T)R1LiYHz+Z*T`mhzRq+$Cr05<CNg$E4@?QxXd!x(F*Wz&>zK`U*ERcw
z_+E&!^3RO_0Mt*hG%|gw3i%}R$^hW@IrXZ+hNU3hR(_r@wE8)^Ilw6@6|YUX&d*Ne
zPZvC2>E`-}7Bk|S%kwYcpR~LQ{{WYejSsQEUdKMd!4^e<<!^_ses|aOQvHwilfx(~
z@jV*uJ#+1T$NNos&XEb-)M<Zl>z}6K$rr3zKHr;iFwQ&7OJVo|Q~v<QT+b{>$)$GH
z=8XQCsl1$SR9OE2$#N_K8b=N0L+E`od!6F_q0mA0k4-O4GKPv}(;z?EeMWvY_TSl4
z{f+jN-6v23xcj7kaO_9Mv-df>y;k(&J}>zH0PIiaKFvLBYNmdS5X6hsAFs&o^Er*<
zZMf~J)ANp+SNl7xSz0h!J)SvlNgdU=_+(lZn3)tas)4Uay6^sS(ZBN()0K{coo)Ti
zM2oXR_8V8vB9qFHvZUG-=sGJOKF4x6HD{kw@0wjo7=xJ+Bo2TxYCc;c=<oB}pUVVL
zPbnxO@pO{xRB!;~n&T%VOt7gdrC5@?Rpo5Y9Ev=qAj|@RL=rZ?^MH~_dWL3y5uDYM
z#i(om-{tsYbp1NbG4T_q@B*<d5^5>{zCJa3<l%55)ZiaF9R!+TzUICkj&y!Pl4=5&
zfm@pc)6@6c0+7V=%BYdM9?FVYh^r)5r#S~Dq*9uW+l&2i(VP$+K`s9Polrb{GptDy
zNJ=89rHpdlzkCb$(bt8c9>$W?K|7Ot^T(#bz4Cq}8cJDaf4i_7ZCB6JD6x*75vnmO
zPY$qSed8Bf*LxfvQSFfF#AZ}UcokMX_q+g-fgG!#wa292_MJfA;ea3MmW^0a`GKx)
zpUWK>4xQl&rHcXx-H8B-9)o|tVlt#rk|lCvuv9LPMgBYkfI6Z}lt(ftrY(Cn*VBwD
z;Lmnf%l`lnYjIzeH%$Xe6SDYdiA>DS0UYoN-{pAyRB=H59Bf@ek3O2d_gC*<0f9cG
zNbDqiB!$$+*K$8IoK$!TIXax!(g@%VNE~(_B75ZD$i%BF3LtH{zi!y5ju~kzk#;vY
z6?Irxq^NvL1zA{Dnz37a?-7$g8hK+t*Evbh%nK8#!xm~6>Amq*bDSwI9l?+>{{Y(?
zABSupNR<wN=tZ$4uH%mV_~Q^xRsjG=z%QwvNY%#x`g><AVTcbP38w7tr`zMTeDH|X
zgEU+XR#~|fcV7$!(Qz3RqSET;-mCHB(-Jt$(i5aHZWJHK8>eq5M`ae^(E#u^H(YOv
z99Hhm4#)0;zdR3>;YVSur7VuS02b`;$?b(=jTU5@ITBD6qrXmf9^l>Wjl8irc@!)}
z6<z$~n%mdEJ%(~aB+eu%=T$EB#L*YE-2vO!U`9J@F61C1fqnfxxXjBc4aho()1+)D
zR^#V|W3?_+cxrbySIvG$7Bup{>P>P8<G;_021r||HWy^sh^@IJ@;NjNPOVLCe0SS_
zuj`xI{{WhKV5t@}8<&h})OIyqwhrFM(=ya?P;g1pYozQsuhSraLdQbcv$ovjRw%}`
zl0!<SitY)myN>x)=^j9Qt>YCeLmf0h-odZg`DS3O-eRPx^XM;(p^y&^fmPE)Y72CB
z{{ROIGJ-TH6qH#>vTpC=y?Skm<u(zGHoNLP<vMezm0m<p<bupEN58(<6L?ZNjBey5
zTAdv2<@)WG4IDazAhR(AS(nYY*m`&T1_<LbbuALmBpu`-YK5O`+hO11oi9N&WO#uV
zs99mbTOWth2#OMp4SYe~@`6zkER>AIkXMh`=Mms?rS%4<(pVec<BDtqjH-ex+3q;~
z4g<jlk1C;I7(d+CSKASQ*GNkmv$a>QK9Qiv#NF*&6I=uH7|IyR^t8bXUC=)x?bu);
zt1YN%twj2t^_*R0Cvwfe91bw4RYwvp-l7Kl{{WBif*{ebkra0T6%07^I1H~yW0+9}
zhTD&9<#YgQMlM_(MW|JA_3wDAFxGd}hOFrqL$|gbptp?Sf~i)r4&D6@{{Sp1omYn(
zniXZ(c}$B$iWF<%?s8ki_R0y^X*PNIe)qv3r%-Os_Y-?|zf9n^%8Ca&5@=o!=#4Y!
zQV{85$QQ9Sx%prbs_a)@o7G46^}(k}F|#J;l{Z+WfDfg`ecik7{;(FxfJi%II1e9+
zN?0L6F2;c5kEU=T8FgwYSGRLnz$+3!Vd=eXg)%v56=@Wz)~od1@7E*cFJ$?BJ#qA_
z0z;GpT_5f~pTA6bslh5YrLY!&?a#<yBy6<$wNV@c$<C9HHmd_+lm%psi>zs;KPe#H
z-S9h}H_3g&roc96@@oiZ3Uq*4^zX0N8HzNBV;XdYQ+>^E$G!##7gEN<QKTbqXm9z9
zQme2mDz_`W90rwUjS(b>rHx8-)}<!z++r(f15zo{D0Z*&ob12?OEFrj+zcqgsF*a2
zsi>A?r;m`p<#3{bAh$ZW&M~H{*0wk!j6!v>`0a&}qB=-6a0@AQ1QOaszSX3g+dEg3
zFk2$;-vclw?rcSIzIBEw6d!=XsUvu-H7NVHO0|C+T{J5|zD5>ijOr2;VdWItft@3H
zf~%d!CAr8NZlPXbBv7YL2mq=RTyA$Koz64K8YlF{wb*_AIIM#p*QD%jtBfQHQog)a
z*h9%Uk;^dL_PvI4BO6u=W}d}tKYg-RH4U%ZD=f}i&a1xlfPy&m$#NZHiVZ(|*WsK%
zD68#wrL_=u+*bI^iJ@Ov)JX+vfq>c&^yFIWSK_xnJVq;emcSzzl|Tx4hSy`9Qo*b+
z09hab-}9^}u%!i*8fvky#gM6^OaUIf{{Y4mVgPGf2B^`+cClLu_R5ZU*eGUJTjS8<
zI0(uWwQbL9!0J_1h`Y`#0RVt&aaarH8xy~!;nLfILu=m|buwxz<=>1#TavU77lB1!
zY%w5K)O-9f3lpf8=idtIQVlBs>x8Wn+#V?4BCfg$E8OQ4Wh|$+d^?h8*XxfSgB=k~
z&#}N#?CPsvgcJZBz3>?slmHfi>@X;66<h2*F!*{)07b7m?SaV5uWAMJip8D1&uk?4
zbf8lm_ZYXa2b==YvKnDTVBqd9^NG3xZ;8UGsL<TtaAUo3-xQxPAnrS5BZ-`{mI^?<
z&JBsuNB|Dl3%jtRzHv7|@H=1~#|_9hz=34BzlH!VN`#?Hy@9@PU>3WdY<5iutYcxQ
zSR`z6eDAf44jQh-ZH&MYe88VfUKfr1aBr{!1MU;2($PgDGHM%>u;+@#km#OBqp~cj
z(v8OA{yCs;GPLZ*Ff4D#$n_&%QW`Kq1qRO??Y0DnPLb+6XVqR~dwNzZOLEB5F%F}i
zc*-<vZcQV~0TxHF7}7=Ic!f^w<t%pt;ejTbTzhU5>^*q@0Iac)bkQq`SrD)UFL7Js
zBS8$K$FhV9(_3ZwkUGAgMv-ZTH2@3LZ{D~+mIVM_p+u7D)>p_Bnm`D%`Q~<IS)-cR
zkh=hRH+P*QD|D|AO)XkOE6^K@`0-t`P$5zy45C0tvNpibI*~MT079v)g73)x02tFt
z41}(bZicQ8)95ohp9~b(1SZ&n``;+56LoQuEe#4;g8kk<ObvZJ&`&go(CG{JcdPo}
z>}E*V!19)JL;yzMus-=H{7}s@Htxh~2XpWBI3i-Qs#c>`H7)b&kWkDa)uA?Fq^RyL
z{#d3(mPcO+k#vFPHc78s($N@J-Ss+>9D!s|^!Q}@h3Th|gc4hlL2ZZ~uh(kyzz-ud
zB}_<LPQ(LW9lft4lgMIa5ddFcJ1ENt6Q-F$5kwvNByq=Wu_Q7HgEV9UX{`tX{{UwJ
zL$x}nu~bPMSEsf#%M_?dR3H+xgzCRvd<<mq9Z{45Jj{0h5sF+z9BXc?dW$HnUjy?v
z6zO{Qjn(B{NCu6??epUrS!U}Ax6+)@G^?;5j@dZ;H-q_Ak5h-eRza=%cKmafq;v#@
zVRTopHAnLN@E1$K?GnjIHacm6Hb-r;{Wn(4B!q~VG-MWPV3up(4*8x}dE;oJMFcRZ
z5LW|$2k+~XD$qnm`dEcxPWQ?EFs(?7A_*0?BS>RnyLacF*_*0`MAA3kL*_0203vtp
z0U1FWi)hGYQ?RPNy*^)#ZE53_GBj$&U@RgJDCU9n<9={3mK3Whg1o35xuN*}8EE2x
zq<G_#Nz-gd`Q)BGak`37q^&QQjn4l73Ldz6C0?JU>Lqe@6w<T-JRe_f{{RewIB6qL
zB%qAmY8#L~8LO)5A@K^q;;zF;Y6P12ad?BJG7lAwgsQzm%y%|^VBtoQryWeCO9UZx
zYz20}GD2j7P*e=}Vy%D!w`CZL%oPF;>XoHpeLw4*NF<v>ed1Wt?X`SQeXy%}*Z{2L
zP`2YJpoq@#8D!F3sj0c+B?yWs95$wUyYK8hJu<Qf>9j;u!?>nVV1R4$AD$I~Cz)HO
zh_cp^u_PNiA5+Ezq3O)vD-alp6gD;Z=9mvkk_VJLs!3J|be7v;#=~!XnO4^;K#oLY
zhJ7{%_{E7;dSJ|;c-Km%wATlGf-=S7#$(VLn|3y&6Z7L6tUfct6eW-VMuJBkr?;+E
z`eD>4XrwFXhV1Rm!0q$zk&alMi^~^?SZQTVw2x!h;7uS7!D~y^1A7mibOZTrosvW5
zW2;{FE4FCqGzDcve-Zqei*bGanK@#QTSQryfTvjmkA8c6yJZxW+DRo>j15Y<RJP0B
z_xj`_f?1?k^y_I7lvQo(l!zk|^A_J^BD~z~jnhdYyrV-Djkjc4v$!Jr4gUaKf^qe7
z#~UPTr7Q$%H@64(>w~OaBqG~NWU#<}{kQl1oG=FKCW#(*5$Mu&AGo)4F!dcP$tZY;
zkZIT*+JNuy!mHCUc%=)|BC?AN%r@WqN2$n55t22Pil}DN7Weq!=_H$_nP!T2h$fI^
zR`Xf(-_taGs=Yrz8YqmiDPY#rJf7ft``~oVFHZr7N?87~vXH}Vg%Q1T-+i$YuA8Rn
zqwD%rUl3Sg%VCKgYr-Wl802`yiBKOccI5qQ<C(f};bs!b0F_Cz<~Qx=eei~nOd=(1
zEbkf8!*gEawjha>lS(eP0IRzI6n6&p2Q);oviSW$ouPsnQ``Rl5$rEBy0q*iXz3%O
z>VrtHTH^}4n5OE#ozmJFs4JVkHz#g4<1>k(5Huhi<Ysqfs{rf=r{j!V%MuvDQyhfp
zJO!ckz>1Pa$U^I@kg))Ty{I1h{{XBbOpvUqnxrLU4I@W<Hv-Rpuj8J4Q93kwWGE#B
zx%8v>=cUxi3z(JqiCC;6I&{6qVZYt(58>ZD{W5gz;y7iIiCEO^!oMzXH;$K}L@IiT
zrPLjpY6SlPZFAq7_Q)9A1&L5xfI61CJ689w{IEp?lJ#X(kjUg-m(!q{t3I9f{4%Hv
zZX=n15vgYJIcjbPsqMFat`x7-=zzxb(v)a|zXX5I{cn%@%A`@p&`mai?q~44O?1Fe
z*e`qaJ9}-5)%B^?%+n5>0?t`L8=EJS=r-H&%<-0t$#Jf--XGoIir9L5dBQ6FG*Wm~
zD=b7*j6m}5+zahrJc4xxq+qbZ5b0nfbg)Gm<a58&Wtw~YJ~eMJjGG|t%1xUc&cklk
z?}`#mq7e>|uNbI--($Z&4etSmN!1uv#EDd^=s^1tethyd{{R@FrI*7Xp9MfhJ*)3m
z*L%j1-Z;pa8MQAB{iLs!ujTT{cs>+<Fj5*qz$Ftv4Ub`W^sFkD#yJA3DnnsG+iNxr
z8#lk~WMhz(bw;8=*S89J2P}xPKv0nKod;F@;!RgPS7Y2{rGb~I4-*3S;t?H?HnKil
z@HCez6ms}+N7J(<25Vpkm53zWk~sW;$)Si76tNJ2Y|2fIU7EYtum`>N!u>i;(m^9n
z4yI>1OWD)08+PxCSjxr-%_4y8#Z5B`wy$7*gx~|x#|KRt2ZVr3U^98F-<XOgf%5s}
zgtGX+!{m2w3<7o+Lv#DAc^LHoFN99A7`GMc&%JMWrH4(_hfOaOa*afBBT@5wIl?sm
z04k7lddz`J%*d2My@4!u*lsJ-{PQe<)<M&{5V4I6RBm_U=rW2Wa*SC@fu%q@oAUnv
zth5qB-6KCxL@5K9#ArO;Yx5sk++A(970WM&B1zH9CyeP@l<8$6h!^r3{WCXCg}T|i
zSYBd{szufJlp7<rVSg;7eME50t_PAgG~nHpZ6{!R-rctL!{MOmlfzgVS!9z^7d|3^
ze4ab)UWUgQ7H*VBAf0DZAyQ=_>3BPV%L)ejZ(kX-YKl*atJIj4>@cDT2T3Yu8a~xk
z&IGyEH0r6>!!D&jCur;sfT6ehyn}=w8)C*ld9!1`!v1}*9i@+_=|dP*<b76lI}j`3
zT>j2n9<#2Mn_4kg^p<iLW3`*BV^_ZY@^Q>2nq{6+8SS+y00zxqa0fNFwm(OvKBuV@
zG^^zfgO+iz0G`&jfew@Uv%?x7B`F4>r%~TxK79LN>3XJx(T<rY__`X{7G4QnJx2Rc
z&T?3QiVDZEUHRg`_ci<CrP4U!bdpLT(Y6+Vk_z8*MEg;|w^P%|(e+b!gZf28rACm_
zG5er;P$%V!7f-5GDdTuVGRE+!wtDjKw=MIo*LhBvG!~Xo9O*kU27Wb^-pSyC!?j-H
zjLiL9z622h#bDH9r2&H;PTcSB+qM)WxmBJ?95lc&k?+r1uKn(Y-rVz+R7Zrx9Fi=d
zL5v|9OOl{(fB75RYOis4+Bsc6nhi8^l?agSqRAx`9x0q3O|uwT;${*=G{ViSII@MT
z0aiFRe>>wUAH{+xq(n%hV+!dYG8mkS+K%KC-)vS+o5q*<bWjoL1vR>mcO8cV>OJ#{
zblpq5fs9P0U(N}j6zW~MB-MU3gQjVEW{ut<By1GvDq7c7-45PUvGl-LnpwIx1r?PB
zvQF*DU-6P+#452V5{6`5UgG_U+wjWG1dB7n7LwXVfTU1T0T)|e>%Mdmtn)+Cvn>;}
zj85!m1HWtb;9(Ppgh1wUR1o2G-L~A0!*le{claba{{RzxpZvqf$~urxgSD#NkN)%v
z{{R`|hZ<HU4u8FdpsGTHRku5zjrPxX_#u2B;%<khG6&RrL@M_~LlLm<Z2dC8{c1vW
zbmsdKYqsY!bo(q6D2;sNN{fcKIt|~h=P3}{J?@c@=ba8IQZ2+c{{R;`W%6jV{{Ydv
zlt7hTxQLvy0l)q*53UgZ0B5@&wP4$C44=b2X=#;+<2?TWvSZiwi#_bH0rk!Dwt&EQ
zJ-9jD#_;IH;DMM5Tk~yoi)TmxZ{HmYX$maWu)kd36bkNWXH+-A8FZT3@w6#zN7Ff@
zD&Ap48>_(AtG?rJY^tI~8rii3QKs%NxmEM&BKRJ;HnM!ycf?{w$I3eckUP4*=b8f~
zbk{rfz%NyjPWOPHHe@)Os@nnc8W)^v<%Azhp+GfP^TtIa{C3U@zZ>NM(g7e4cKBot
zU?`T`9!J9+VJlARNN>AGIu#lV%G7%U&OF^hpD^<G8gm)gq#ZeoYmi!v{{YrA^=g5F
zir-)kz-B4B$)y8P6rP)Hn5X+j7%q>9<FMl}nERE8nR+vIuOd;UQD;0~w0_*_x+u?>
zvF%>InTM<ULQbdq$WQpG+b~RvENrqU0hWLpW)_*(;@w<P=2$+`{wV7D_RyrpgR-2)
ziqb?3k4z5tlZrnKNV-O~HD}awkTNi0hUoL}o_)77`4eq+gTvM|Y=ISM9rowrl0a3p
zEw;k%gYAYi(rUIgGg?HoNxhxO>@g6=WgiUCWgFS~Wfn4bYqOV)G=dt~5!)U(N!_-y
zRC&yhf;0h1Bnq)uVu(pZ{p%Dv9At>f<Zb}Q2T&BXRbKn$WF|042I}cR@0sN~Ek^7A
z03rEh1jM@o-0$js85vrRk~XXe%vB>QHzb2u^uNQMD4F_GpbK+kci?}Yu6PQoCZfiP
zDi*Wvzkxo>@grF#Q{_HVGmDjO+IMiP`SnlJ?fO&z1fT#GK^?O~u}~D0wl)YAsAn%u
z>m{t9pjyyI_v?7XHLxne&i>xxIHn!3+)n&w5@;R$^Dk4@$J38Fv+dtANA|>RIw1rG
z@0_;fVvBT5ySi(}$u;VT?DQtBj(PoRfaw0CJq=cb^Ldl1k6a{oUB*nY)eDAtWr2l@
zBO>ZgIc-)b<fI2Y+?9(&#Jws`r)(WWR8HB2v(|Oi2t4PXI#YY+%JT3|J8A9U$<+ue
z5yohR!5n}_=iecK9VWrwIq7XT+PiEj7+4sg%2>pXQcd3HoS{(S$2q@y?+rTFX)?=u
zlUVE%s6!m88C#spK^)^Gq#Es$X*B&ZO7Hee=?gh{W&4bIUu^VXl-O&}FZi2NbP&!z
zvQWQK{<B|6CaBckY?qGBc`Lfayno~Gum@ez54E6Mnh~Z&AKbpbEcpKbuzu1%XZ1=L
zf`rir(?3>)k%316k%bU=&&|J$KZj4)y?C3a2l-jaWd8uf_gwnl<KCsZ#~$<F>G6KK
z>D~S6NBh2_Ht|tP5J25*@;xvxA9P(d>Q83R2l#94X6gXxoxJP16ZvP*Y{PL{`1U#W
z5j%W@*HX;ucI9?&EA7X=VVW^*9EuxFf(Wq7o`bauJRd9jA6(BOumm02KVIvUhvPrR
zKViSv-)uBcf#6Ja!qQb~_b1Tpo+?2p)f@$j5v9QH2^&|&v-RKN&#;&6ud~cbzt@iB
zfY=0{>u1)!pl9SGR5O;89Vlx+8hh@)k2$K*r&TSuafGaKTRMv@El(Fkhp5=`>765k
zt4mTg^mo4X_+=u{<|dFhMby+c^)!ApUpvS=o7RLooto)y;qlB_xX>p_qJH+(-|)sD
zOD>NX1Vp07$QyCDzSv=rSi3q)C7Ui9taHg8*oIUEnmE@}kxQp!-uB<u@W3P@D{Apx
zfKYC$)9@H{hYIn>pdBg_^?9fQerC;oj0Kz{eeVs3XWwFXub$`Xa7<kXg5&`9KncGR
zmZM1&H}&BBaE4VW6ro5ufb)0Ld;a~gTofphgB-LP+V)l#efb1^aJ)g|Eebh^9VOqt
zJCHcz@Hh~mSsB0-pa7uN?a#{l;Yv=WO(B#K{{Y{S{;N7jbq08eWLmOCStEVEzrC}j
zBpO#!YiCcXAMY*G%AO-MutdOtdyp62ffu#yfU1wCNW7K+E;ge?0bZu@US)EjH4;@p
zv$3iaN#J6T5S9$87?Eqa1HM$p{Y^lBOIDp|o>O9guX-ofoC&0$trA#K9QXeK88S)$
zzjII{;xGJ+=~bbXkT$9&$f7UuKdw4Rkw+?cWu3sLy_e-%{+JyOg;vx}k?Jepe|@k@
zZ4xrb3X2}s+uM7>bcKy%4W&hpyBfdx-`@m!qh)w>8{5rPFK+(;9&m%=K9)lwg3C-v
z`@>^jhvALTn9_8TRA=e+uZR?jD|?TiIIj|<X(GCoH>h_8>W{7yugHj`Gg69b2L3!)
zI9CxG#AS`bNIbq77pZ95aYME;tSi$_0VZNVUB9=J-($wr#rk5R27OU#Wd!I4%|H@p
z{H*+rDItioe-x5$wUg<9rqrll0YO7?u)F<mG_J(Aid>!Bes7z?e1r!cQZJ5jy;13m
zjFAS=s;Ucm*5_)lP5iJVj=>p0G)LX+eJ>2}0Mf8T%1W-QZC2gL_~H;k>0&qY0gSM;
zk!$j;5INkp>He@8i%OwDQcLaup=A1Z<0TY|jb*kQTJlC!71|Iys(_c(-0lbO=bb8s
zQ~*YS5`zF~>%RTY`2m>7t*QL%&8^FC<~@z`&+mMZ)L!<~-T5|sy>i_{&D64MR302^
zphTbw3OC!obMfCJAY};3`;RaqVh&JQ{8x=0qYAo7Kb{BFjI3zs-+iy+ltfo_C4g!-
ztxYp}ej@}kJaPu|?5v|&h8u!A{7(Fi+u;(Bw$d|dW+an#dHr&V=<vR!W(R;fbNFwC
ztzr^A681MB-^Y6!5%JCo)Hh1bv9OD4U=0($J-vRP94R5v6^pAB?x4{p37j!QCWj$3
z)|#L=y5#%fw1uHX0fw8qZHe^*9i<NyX;4pcHv{%CCT0x9^a95AJPdb?%W^5Q515<Z
z-}mc?tOAkcAb?HmPWTkLaO%V|@BT20Myn!d(Ws%a+N#&ne3VQHAk}vxIy8C(Kmi7$
zee+TTFbO;W^1Ojo-(%eQc{l5Q@H0y5V54cidwyBMo<dx)KX{(_Lg*!xsc*3J3|Avn
z2^grlI%xeb;gC8-tqbyODBJ=`y8N+SS~Uz@8{>O5h{{0wqng{2a<UlKI<W12QZ@j5
zFa(T_k&OTwHpjTyw)*{Zpp1z%l(bqkbz<vmGq{#UVD^BPP&gKN0`Ws=Wngvc7C{^x
z@`E(TsF1XPS|X^@v;_bK{`twSjl8$<+VO^`3<c{u(8ZzvAKZ4YL6BR;21%qyQYCw!
zw^4(@7y96wwzpMea!D*u*dybNs}lrOl%WW0vAa9$JvOWn#u(@a$yV$I&_DJvi8_*o
zn6>@t27#~p&I*O2G94hBZMYt|OwxE_E7%$p`DYCpNPTF^391AW`eXpR3J7UegN@*7
zUlKnuY6x1ZeCOP(dVK0gAPkc*K(%|>*yR;0R!t5Lm1|{P?Bu{wDO8suw`^sQhtyw7
zjmDAR1(i_fbPd2f6Z^al(h%=fK;-a#SkEDjKqxg0S9kLmh^*|Sfk$DzVYX*>YO*&c
z<J$r3xG}rN6;{W&tLGP|nPG9M1FoP*Bbx1fv#mhT7SE`_7&5BaQZ_U;_?!a8rB`n*
z+x8##il~aZ<lOB_KVM8~7{A^&2I7V@h@>r}?jqjg0)Ac2K(c8Y#~zSCt!C@ivzpO}
zUVT946-c5=-3r|BakV>BJ6S*~&jSG|fGt1^=hG=8H&E=vsbgCKfVZ8By^h$7EL|JD
z&#q8eu2N%NDo>PqdK`12IT5L3AKbUW^u&pQLb3``xcJ~23vg)q?^p(AN0puwDH%H{
zZB_HdT{lEl{<%P|MJNDr4j?-B+>!X;ajK!V_k<uWs$WPX0>o^%HH!PERadqP-*b>O
zso+Xgm^cQlPRA9Bw)+Bpc*JUqa!&oW#8%KlP&JfPTuP_G)D6=e$K{D2u%Inhd@{<+
z_R0;L#iFO*0B?3Ej3sE<1Yyz?fJkG{raR2@X;yuebc^gTBuyPaahxoz*M0WRkyU6T
z>I4flRDCjs$U#jl-_&48k14%~;{XJ1!|RWF_be~dD8g4aNJ~)!Rs@-VP(@$qg3g;4
zzSJ<NHdLDStQvqcK<ANw0ZURv*5`h3i3niJYC*AGvXXd3!6AqrcwJe^ZMZug!w4nG
ztLL$-02Q(iY$()eyY0qv9qjSj3Q@SbHZhtqu`HUFn&<|yJ|h}1%*<#S7qH_KQPHA>
zUG6YAhGBkU2jPsNSqUn3G<n4Y5O<^43~0)vY#48QZ-9*S3IVm}YN8K+d}$a-R5<O3
z02g4K54sAjq-y(wciipoiKWtJ66!kwqhVWQr0Pgvs;{}K7n)sFq6L*nAdueu_xfQI
z>KUY95DHOMS4T6%?<8*=h;2y=x8v!ShFwqqHUo3mlkv?HM8-9wRRro{4(Ho`Fr;{z
zRe@=X>;VIx-DP4jw5}q%3@OV|B=`E{y3Iw_HAPg7eQ!{{eqW|EvO9E=00J_wU~6)2
zhv&uubtqvd#gWa~5sFdUe|@mY9FhS40CaA|fCuB>e4l{c8u+BMO8)?Rk_Gdc6R1Q~
z1z4$}slM+x2dYL$JXw{NIjw?&>BZ(D0d*{(Qwj%*H=1QJ$ndE;w<P;n#PMEPQ3JB*
zHYiYEQ_rx#P{I)q0Fs@F=jDFcqE>;{Hi89NL85znHt)_uz&;}~NToodB~|+4Le5d*
zqkNNmdfC8`a|u+FRh^32`k%)fvPUB_QtC7;>_#iY=V>*wDBSHp_W9$hYt(H^8f9h{
z#MiIKBAcg1POdg3SPI>2f@^{G&22AHERsi|<AzYDO_Svteq-yHx?*}q5|Rq3-uGMd
z!8cO<DJq}+YuFw30B`&4fMtmtX7E{rWyX+ialZcmrgVshrfp=XQ)LPJ$8YzXx}c2^
z1T1JBtd95i;FCn4>7|ezCsD2Uzn&3ZfHRq8StIg-p;&--q2JqomP@1lXQ&*K+p#+e
ztFle!K^h9vCnwHzfGB*u{{Rej5yr^Mu2+)n!+!4rJ2S;8NYPLsqG<E${{UH4mtRP*
zNW>C$8x6hi$tIZOEW=T)JnCRiZr@zY3G=mDsMr8E_@AZ~U>Z<i2(QJ^I=c$@;~l1j
z1f4oBh(^l9AKz?}C^}kc7AAdx2b?iVtdgW^bjYL<Xjt_6ez*ZcbiG2nELm)9z1!I4
z&ZQ#j8aQJ?4DR35E>E=z>?<(1Fv%0gBNi8JTLbNh)FJ+Dr7|<U17P#8{{XBF3Ddvw
zB6eWs?y3#wU0&RBJ~xtQAhgm(j1cUmz+YZ>-m{>XKx1Ymtdq9DjxnAo^eY&g_?Fs_
z_g{PYAErR8t1L>|5+a9!8_oNyqI8WkrK}W1)=BO;pgZGrJu<=3Ad#+jeiijl=Wsq>
zj$BC4t1K?JBvnUnyKmTUwg!HyQIa{}nzfQN>fL*9`|XkGWtrDZY|7CR!jBj8+l+H6
zz~(oL&wt#Y0k+>QvYiyN$05<B<*H`V4SV;>0qLFs8KovR8mWN*?dkJ5HHl}?kr1RE
zI$5`2?Ud?N$aJpZY|!Sw_srfiH%%6eK(CY#Pd>R7rcSslQuOd62X@oq2H8`Jq4WCj
znfhqFjT%1c))*SI@BU6C>-@Z{9Dn=7+p!^(?eMQ(T+-b(h@_B8?J^b8RA~eeeg6P^
zVGgmYmzB(n!L67%U{yxKhoyS<$;k2-Mij9>m&7A`Jp6`M-}zNo^dV8AK)1NPuh;S8
zAi8>1QLn^x1oohK7!{wWS>|Y^FDok_1wjEpx+cCu<CBs|Ri+>XTGUlY=KXm%2~A>w
zXDV!+jo<s@8RF^Jq?%<{d17!V3mR(8;6p)<NedwnvDDj*hd;51B$K6em4VSG+)_3-
z`g}6aDC!FmnpZ$tq4nF}laX`{0+nENu?u?|!l|v-?D-=T9YS43BD6RD@0T9C;G3kD
zFA1i0j5;iXeiY>k&($o`#v@qOLN$4dpYy*XBvI!rEh6b5NN)RkoCFRKyl<#AP#5<_
z{{W1$TS^^OszNk|U%o28F_Kq8?gA?KgcUDj{u!tvJa8;b1iJ^3taI3(hwFqlQ!Jhu
z^u~E4>El%z2{hzzC>riX<l~$)auaH(NOWRr&<fv=e@w4WPzgYc+{#9m+e=s9v$X^3
z$ICNC9?1luV=sD{hR1vCFON(p$tuG%!ew`}wf6Mi_hUP#kEe^LL8+QnELep$Z0vpZ
zI9@4USffRG)PM?&>6@~TS{0S*9v-8wbdA~wLoV`DFcsXdrvCtz5uM~cObn@{uZXU8
z+@EvKSoo6l9Y`H7gDOzcK^xfQ9q*jwj^h#eBI!%r>GK*idv1Hs$v^We{LHb+T~?5>
z=D1(O-vMTdGv`R@0RfmE52f&ZkKv8{qjhDvUYtCtU&t4LLHhc0SgGR5582UwV+Ixg
z1lPH)=QwpRsuzu#$+l2US0Cp7I0Yb5i2I@wp`C%!t_AkwoF;1>I;=>o8jmR!ufN_m
z@voLYQ`P?f@fc-hRP88Kj0<2i)!xE~`pmFe#nl-Lc!2;>dtHsT_U(bEsAWQunAVX#
z<q<;oKD$x9v1IF8%QXc^p29zHcHDQ^cJ1wr7f&P+r&ZLQO3aR8B#mPK04o)cnPQP0
zbe5Dck)&7HuER}w-_UlzXrd+cxm9ELby&I_4Y@mKMjmibGd$(Ws2k}Z?MD0W^!LiL
zc<(UkCNDf{g;?1wwE#T;75P>qy)RJ|l0&DPQby#F>D>L_hS?Ry1W3RRqMcZs&6+xo
z8_~@jG_k_*bur$DwJWUM54;U_YhjrkTEqVUc&2LKP}zyErWnvk6s0#dBx)y$I|1>^
zC)J|NATdf6YN%ZyCy#DV(=3nEq_&Z;5i*SrLelKn_26)S3dIRg#L&745rQZSvmO0A
z?l<;6*<a-5k})x7R+7pcHR2srUta#l0w2vg{{S+~B-d(zu9mLoj^kmrQb@$$e=e$%
z24o>WxDkAw`;oO|rs><IouWl%NUct$1$6=Dq75DQ`HZWP93aKiu_9&&ili_Ux_0gT
z)xGnC0UWZCAPSLaSc5xNn&cmdKMOdnk*(_LbjqZiN_N-+zllGwj-mAQ!Dpt`t}w%8
zYXF?eokr408mWvCsYtSRAW`SN<W-(X7pUn1M$odN>Jl+JjopuLZr-O0LOOo7F)T&(
z6(oky;vucCw)els4v6RKWRy=Tg;r=xqs%}X1L?JmzvEdF#A$U#5y%x?iKBZ47B;FQ
zoT3sxf~<m8l?W=E8d69X^8kJsXI~B!oCyUT8jlTIn*RXrf!{2@Wy>NPR8Ima8nufd
zeTO{$d*JDrNC&8qV@Yf<+UabOw-$7dpSBUp9E9}}Ac{st6}9TxjbCf6z44`Q9i^Yb
zVK-8BMo{bl7FSQuZQImsi`1kNqclNdWUv8aVL&_Y$sm3i#6qygPJZgi8#8PH1AqXd
z$UiSl$|$kV6o;oSg(43tOn>(t_X}ROHufhcCrc=dnADYzQ@JO#kIQf043o_h#K_AM
z0(1pmxWxAKBnrPzrZ+_xkh?k;6C;p{KeUEAhoA&qU_p@d@W}+xYn6b|H#$z+(C_vC
z02==Qmy%x|T^>l{&{=4yWgK6oo;k8F;f_sk&aV@wkR3p&;3?Xx;hI~n>K+;TCYEG|
zSz1{WS<|Yh5;!N3euVnqJHspV@k}F@0T#EFSnXx6Qm);!j{g85S(#>tpX!OV6*|;4
z+mS*2_uP*7h}xDIj-mk-rADB)ZO7~RW`&Q$V09#JNPBIx0i^6Ih_*jWpfaKAmPoY+
zlI76DQ3CC6)SbZ}KKTjE2gP`nRb9%48;!^Sk<P~N{N~xxBoa~-)moVB&KO>x2-!_o
zp<?U4*rR8W&WTy<l|WCPs(|#OC}31dt@gZUsL>$t)mnwAQMT3WKNFJ@NRqEn)9Q{+
zmq}NzHP}0m#UIdSXjjYTMF_+xVl09vl0ED5&CMFg44p#)v9Yf`(-r{OJ<j0#H^LDk
z@}tg$`gjWXp?hjwHa+(Gk)K2V0H-j;FYyd41qjvj(F6M=7pIf)?eiJ)PTntzBO_`w
z0-iNq_kF8ZzWMfF`fJnI+jHBC9Wi<}dWcYW9+&v#uavimewNEc3E%o<zXO$wlcKor
z*y32!JL!w`$}4c7SM*8FhZ?E~TK@p_IQ%PK{{YflOQmhNh-FEkC&300uk1+6_5DWy
zL|`1-G9sqbP0;ok53-|B{Zann05z1ELPc~hRS$-Daij5c<M8FWr39MCARz#5#DQJL
zPB{nwsq<GOJ5@fSER)W4H$shS1)o1~ah5cV3rTv2w657DnwwJ_KKP9Ki!n4w+Zt7*
zmr*Rh8$V3VB!%s+$UA?G=a9bUzF3wH+vZRSB#YwlM;q*Mm>vfi+HBVR<q82iW9ZXf
z`0PBq1Mh*@rC9`=2Qip|)(+kKV0jlv6~CrU=3}<{ZtJ#Y>N>c3a7>I#AMG2QhnB5u
zMG{RM$v;}1H#Y1IP|rSZwH``E@~dq_l0EY?gT2@T^2{dRrs`tfc~`6ZN@+%$(!cRs
zfFy&fU<KsXuC)a|rzPSst?siJtjly(BeX8)6KkMY0CN*+b^x0I<4DfLvl4$y3QG~q
z4s!IGV(L)E*J=s^$^#1<dLP7oIp(t4Q5tz;x2ex(?P20{ODYgQmn4yVgG2MI^5<H0
zakwB}aOJM7)o&(+Mb~4s=BRo{j#}ImCv(8eOD2|4!Ln>;p#-waAC#6hY#)a?t%yiO
zM2<)wjx<Naxg3+d5(ekn6vn!&lVfvz^5QWewEmeJk$-f7&IIOGXw>etWD(zf`I_27
z8Q73-e*ET{fehN5E}e+qe8@xf4s`8(h87fzG@esceAZ{{B`U%lw#v)YDn>@IvQY=$
zGj!@^mdU!@<}+<9M&6g%y%FjbC|32z`+8^WKV$uxpJ((?!kv^~xzC0E4ErJaj<F^v
zd?@$4{V4$L+dRwLs?#rCwD##0`=0WmjkY<??4z7visJJbhE<;Ln)^|Ror&b;ZlQ|w
z@whvw2R)Cpx_=RMfGlT=)p=mk?la=~SS^Q{x$!Tk<K&E(qfe;m<Si2V5uCshLGQLF
zMxel)>;cDp>AM~?>LcRtC$*<fDVIcyr;uwE#-Zt#>rf=2`PGrD-MG#h#-~q4lemdz
zbw3Ks(?h6TX4wMW0xu$W^4590-aKTk{@u7T^vlVSO1Bv^>zg{5NMbu?LMuLE)tH@2
z*QK`r2^;0&n#aGULa<$LmbTL=tV?kMLAl=~P=>4!%rAa(LX~>Gj&w$>(>tpV+p(7W
z7Ek<HTk-z@cs|Z+>Ek21jM4V8m-{EFRiHxZKO>m_$bDTLXVGgd{Aq;ur~JJ{VlrQD
zeUzVW{go$5)vS4=W7&o}n-`Xa^sqeUyg6-(@p}1(9(*y9lUaT?lFRmQSU&V_jYJW;
zk)L_c^(odslLJd2-+#K<gZ}_fe}_zSfAMaeKcy-Ds2|$izdZ9lg}%_yG3n)MSJ-<T
z{Xf(Bb>!lVm40pN97(~JYcHsERZ`F2%H#FS(yJx4F){Q10Fcej%coba&OcnsAlJY5
zAlv@{CG^ih=de!zCWX@rL;7dtpZbIRI%4XF+I>7%6vT-D+e`DuzUSk4`izmJh!sx9
zbUugEJm0i>7(USHX6d?x)f~&BLETTN_sKD~Rko%0gFJ}70Rd7sv!tIf8(#Zu@b8>q
z9s<j)FIJMH?;iYmak=E5Y~A+P*xgsyy?n4vFTysZcx5~{u-tskVwOa1pHOADeb5cX
zcfUhtzi)<Vm~_PKjpbUkW?&o2Hc{!6l2l>gqOY4umeX}WS-*3VrVmUig$~C#0WVEq
zZj=$u{9sl`Sdrq?PN1cM+!7AMe{1^Ur%cn!94SoB!Bi<5llfyLTiDg?Qi;`GTHn{7
z*u-fim17J|0j59jJ9ofI3w_YxtFYtiogngfj19QkeYvmmgTf&hxmyCyV1MY0qxd2i
z+9xd|Ex50`Z0+;|3V516l1K5PSzH09%nGY*xf|H$Yv<{U6oN?zSmUib8x#!-=bjGU
zrw3DZrbQ!C*c|M5{PU${c$CDI=RR;q9}mp@@D@iQ^pF&dn{H08-_tdCFo$T&(FF20
zilEYiSAEGI-uVWOS(a&@KzuNuGatRZX&$Hi9A<M7jx>=OpGhTCgIf*9Hh1lT6r-dN
zRPqh}{jh-2Au3dG4&vxnZhQRxSktOW3d)QF>MG0Vpe-Ms_$^`t#$*(ro7;Za9pW;>
z{JPeIOx*A3d~v=Gp+vJdP^+ZwY#m<vZS={B3$ZFGiPg;u{r1gC41NsGI+QXORqst?
z_9L}l&jL>i1yK8$4eKqliz9EL#I>a?JiG%}`y%q>$1FvdF>t_|APxztuV3ET2VF0r
zfECTqtOMrIWLFAy0;pXB?}P+d-AuZWT`(KH4Zln?G+Nk43#=>%RCf%@cJD&>_Q<I5
z7=|8wJ9erb-oX8E94XS$5~Q_lM*citzYUqy11k^%IJ!LHc^JpvilMM8cfK?|Oo;AQ
zG#b#YX$MO8tK;L&5hJ8ZRGmVq*T3xL3j?hPWgvNn-5U+I_2=u8kNRL9922qRW15?A
zgd%{YiR7F7f5sGupdEaoQ9ZrrUw(0d$0V#&vPVRMcQr<aForaAkHk;vR=thKx!CQ$
z0PTGG?URwCkb;O;*3I7M+ik1qkXxt`ym7pC&A*8HuUWI}``;%1L@E_Fald`CKolg9
za*~933jk6xdw%{{1h<)847Ws*4)^SSnbOJ`&>><1-I@mLem{I?K@-SCaVcgaVd;UK
zhgJx&`FI?0Tl=5aD0v;FhR=qGbf%iJ0Kb^-PsbFqQ3&d)q}Gr|t<LzU0~KGoIrhJf
zC}lDOZm2jN)L$45s~n6~+rv?2$lHyF#{^4KMW~p=Z*_D(T&P&eP1FfAgenmT)u^{S
z@vs}@UDURs7_Q@Ud-{EF6=Ne{Ks;|)(SbCKSde+8+Woz@!5*m}a-&Em%sIydEtRO*
zTW?zZ{&)&By`V<i0GsYlt$lX)&S+Ul5x8Vl1hUy%?a#pA1H@%kDlf~Z><_ulL?p5R
zw_8~Phd4zeE~xJufNWLE5yABCaTbVFpbq<=?z;Z~dBJ=y5lZS{G=Mkx?Tx5VYZjwW
zBz_qOczSgxrd8ygTW~h{;xp<fRH3i!3+e5e6RtDVT|r`s85fO#Yu>B5CnIq$jj*76
zg-!m(1v;*y`MFE9X%GlJk*H8e9M`T&DRu<Wp~Y-QA{|UM0Q5LMnM4u9+GxI|3@giL
zxIezxLOf~_2-%1_h4;d#sYo1+$-dYFAsYc;-sfugU{E#rn48?-b%tG+VZW|c55Bjk
zg*u9jtar)9AVSE%lxo#SdcN7k0e#y_p8VDUj99O|7;VtCULPoJ#Q@t5<KvSjNGbsh
z*zu0D$)!-Tg;79-1GzS9leygF3PJG*UO}q|oOV@RDmN+#CiXq?b(rQ>6j*K;cRsl6
zP{&|ta!9+{tJ5f0)U}q<p{vf<wigZ55EWX=+KU~(XBKF}Nu`)IRWLRxvzA8E$R3r2
z8#^CNisgz%AtdsE+D+}J*E(+|sAHGKjU4H1z$4a=7|ALnZE6kIufBAa=@o56*)>G|
z>i|Z>dW<iWfNs9Hnp<`wVT6)FYoay-*Eq(?b~o#ILWbv(H~`?>img>=;gu{GV!mqI
z+usAJc!5>jc03Ep6k9I9*`a>9#Fi{vl1a0^<mU!z;90J7mPTDb1pxD~+XJJ2yoE_U
ztFgi+cC=<Kdv18fjx{nAcde|FHW)MnV8u?|>udm_Rask6Q}|@SW@_Hg7IB}Fq1CjS
z1b4;^MK+QTW(JM`B{Y>5C~`-B`N%ctRlBO^JIhS0#P4_SoXmkkDc<-ajDb{|Dt7sC
zgs4+=NaFa;T}OYO*hwH+uzTJIIy6Kpaaw@B#}$Aze}*}S`T|`+x1uj~_~NM~2=w2f
z@01tR5gTHpR^73NhDI89^&P%A9H|sluIN$3qO3(%u)r?LY$&sP98e1EK^N*fVG09z
zta@#oqf-U2Ht&JUUR4B8H^vz&RfZnm3K$3;YbRHr{cr>3-{pbYwAoMr_ZNmXP^2(o
z-Kg+8=KuinUi%H}5Dm#4w!mxC=8PUF-uOT)L}zN-bFjq-2-w;57*uOxWDTzXGZm%U
ziRQ7Q8?o}&7H}0H9Yj~YCYr0Sh66eUKAxA(02;OcjAybGvDI4uaSow$D*&h^wg=zW
z1JL`tdSe1_VPm~saHVf9`(OnGDSq5y{p%v{IFP?|fmlkmlU(}V5KY8(+Wm58(B(t!
z1B=d8Mm*5INaG6oDLP{-9|={0lJ@Pkba0SU#eGOic~<`b9OS)T2~b$p*S9zsWbo-^
z(iF8&?R~v?z^e4|s31sLYUmoT!+dzUhDcP&Fje72?oYS1UId;8>0EePq$&oY+l~7V
z!{?baBdPHm>r3*1->|^j)H1e`t){`dJ89T=`QlI4saPH)3IcCKxc>mWk4%zGmhtjG
z?=1{qgGEXxC5Ybk^zV=-jwOUCK%q~WsA||@>0|L1S)jhdkzbxwf0v9lokl`7x&e3Q
zyX-T%$>tEDk@k;K01Djfc=rPW62(0f4NR9-c(3}w3O9y^QKM1d@JGY_=8l=<&}Wc>
zH*>H1$Rlrk$h=jEk~)s5RH!FFv%Pj5@H$i`WQmkB3LxqLQTNA(sAPGUPm8F4%DacN
zd!GA&nWySJZlyu;kf2x|VlnAPu^SZ^LVy=vv4J;rmIPoKn0ZvU0DFEoB`vNRQZ*=M
zYBW22ILo>PO)A#P1+RVo0M=8cjyV)FNXn;XZ8iX|+;6uS3kifxJWd)*1R(~MSc<=w
z>63(NVvL?x_5^HOw||ZW@XLaXib0@Q)sIt;)66C;Sb(IR)P39EYd^iPsYE2d<%=(f
zSO+(-9-o$2^vq>mo^tWUdh9Lyz}o(~KMTWV>XE~M+YjzLoyg9YtZuF2ZEmczHM!$|
zt$&;$WQlCX%q<4!yAjRaUAl<m`#eDyHqBbAx1jjn`pnWsv5y)@49BrIt0)PA4;~s@
z^63J*5nz7K_!DT9#5~$ffI-~V9sd9i$2nwK)f5C>Jl}ua;yileSrwQYH+&qoPtq)o
zkSv;xt!K;6HTWDVLI|W)otcm;c}L!_Y+kZvGo!*)Rl!yuP`&mY^4(;rVLdK|Mvea9
z_2BLC@A1LabfzByB_-UAMM1ha3eh}<7?w&?u)f~s06?=5ZLdz|x8rOqQ^YcA5orRD
zUi3dwKBqbvu2h}SfE4U%iS^&!@P<hL0GI1ooN5Dby1DkpGffGZS9pLfRZWGzf2KU>
zCuQmtREJ=pK>(kC^w{Bq{{TC$r-p@}Bw=j5cGy|m;aR$QnHR_iWF^kWao+%x$~0<P
zCtdd^wf;X`y3HSi736ObNm8WmU-21Pk4-bpA&5mvL?~FBU<ZBs{&^LGUksIDB{kWQ
zUZy?k>y}Q9wRtwwwzhd5{{X(@A)@r8h(m!y0(L(<r}GZIJI28XBS|&5-0UxpmJrc|
zZwcE_756=FgZN|1B501n_;tpREw|s-5a^ZEc#I)XJj8AZ?eB-FK(N{`kR92mk?mL!
zo--ORP?XPS%2)CC8PN47!j>=!EVZnG<=gYhzfkh(e-+sR0jYputF>3Z&pII^S!mXH
z)axe41LOPpVN9J<!xqd;z9Q*jPxQr-Hv0TAV~<)%)IU)Ix-bD4Zzs4N@_O25n@X%o
zpxt*Jmj3{K@sdPxXN?sMWEIuFea&~klT2L{yspd}%2<vCZR^;6##UQ_pTm)wDFv}A
z1=jV+@A+hznpcp-2~hgLYW3$T5Orw2a7hG&H@Ex$02mbM*h2@0p<Bj7rjL8t>(iWe
zPMt@F!pI;x0lR~}-^cgsgshS5g}jSQ4%$bj$1elPA6FTe2SqAgGJf?PuD>h}F@N&$
z>es1WtC|<FACDfG!%Mu8Dy_n5#>Ly-{Xc#2e$hax;Uy9l6{L;hAG6QHAE$;m`UKKc
zODU#Zg(&&+`}hWUrJTt!GOUlP{7ddPHD1}OR(`$N)mO?@ygL@g_5gQ349GP!gZXe>
z%N;;fm95TIC6C09!ctd3GI*d;_aF{Vz;Ct#Fdb3X7}T9O)Zh|L8s_~hdt~70datw|
zaD<jbXMJoGfCZ8)@7vtqZBGf*#xib|PR+k@+io!Qs3As_Pb6L<m6J{Rhh--CKe2$G
zBRTOR@kD7#UWK94w*LTKve1~NXoIAWOHM%Cir%|_)-woSp;jU|<yLkIwo9*T?X_*+
zee<E}8>fy~k@Pr-=^+8~6Xy7K7x`dhd1sClc5e(aR7-S9+2DFz^Nu>FXaqV!Ms%wR
zQd|O0HS3l|Gxc3CV!}rRdCuyf>_@*~F(mNbQXQlYg!sC=&8qkI1opxqAZLygr9&Ed
z=x*ejzkIhwrg<4;X3``3v8WziPvz;`9eS1Uv;fI94Gf3-NjIqdILIuL!7}(r-~N+H
zrhC|ed86rpN|p^2%HcqeG8){D!|B_$M%f#RMPkYT*@)!txBX`EB6;Nz#U7Po;Q~jM
z%?jUu598k<Fi#l2Os8^DPu`$KP}_4y@W7moWMr492g3>@QlM@q-+$k>JQ9a+@kWYk
zKmZO1qSSW%_Re-i=`?i=?%K+#F`y2R39nK5WasKky>OLeCM6?Ipg0>1s*Mk9ifLwL
z>L6Ivgb5&1AR^rCPUD|!SdqV&KnRqqfkK-MSoZl*7-T^br-s^OS&3C%2Egj|-)+y!
zCeb``G9U!KKCnqBd7y9q04>QKvWkl7=Bbg^m63qifwCyr^&EEtw>Tk`PE`(}8C?e0
z3*N^5oP97y)4<Ngd0AeluogD12YrF`?eCo{2w@2zW|c^yO(_<Az60cM*p8Y`ot=wB
z=cfTqg&%RW(WC9_-_v|Va;s_72Jk>-E5@*PBkF&~Q&dS8Q5=inF-uac7%3xje!wW(
ze}*f#jZnnPs7FdF$lO=YZ=o3i%wl=ikQpOTs;7h6{{T_&$vYU*=-9e&Z&|K)_O5ed
zLRM0SH2$n9BR=QD;F1CL=hJ<&G;tUukRk~bs3Dik7R7_{+l;Diu2r59u4_otgaC15
z5};nd5`MT|GTkJz!ca!9p<|+2>vji@-o3?R{hj=*38r;oWGd0N`c#e09k;Nf*c03g
zUb!ae$!DOB{vyI!!UN9UzyX1)sp#YAoWarv`iC*3!d12eI)SE*cWwFh_0K)!W73Fq
zg0Zy%(TgF!9jk2E?HuXTG$LstiC4sUlp$6tWqXdq-rN#>u)xMdk(wj}Q!!NpspR}N
zvtQ!_Z&TvQ)yWABG|0>)l({9!f=IAvj!(;M%i^@8brUplNbD7Fl0W6?K#ZJnnNaA6
zhO5*M3NGv0<9ufBltwyuVw#dk8KjJ?MdWa3FD9zPQ1u)3z|Q?ohb-?nkTj)3=rpg+
zt0v8oFJs*NG2tCgThzq?B<PL2HPdtz2^)6UVj~qR<2dm=Fl+$iDI9umPtOlfS}7)x
z*-Wfxup8;3q|n$8%K>`EkEk!<q{a<iBA0MVsXSlAnmJfRk+Z_l%NvBVU~Jm80sjDv
zi>l;->yzmcFB4Nu7}yk#L3DGdc}N?9-{tF%)`=r$Lnf%%{`&s_aZ$|<YuDccKS+xs
zYcHqDY3oYg03P638ANFsWrVV`In)`q@Xt5DH?hjMNV9akC=v#cv#3avu@u8@!uKa{
zQSXpujwD7!el<B??X8Hv-y;F!>S2O8UM`&$M>nO3I#lT(uj9{Sz2`J;y&X#sM)8yS
zu6Oe&G;g-R-}%WvkJq}uk*=#ypc=K)@5$S5jSj;vCxanmQQ|zsf2zdXLany%&&sln
zls8e<ODvKVZl#^Sr}u`fLroeLW4B}S#G9pyrRo|XI1Uk3MQG@TG#N+06Tf=J>h5VB
zqSQiw6GGOlI~Mu^et#UO(I;LuS3|<NI!~1I!5g1%iNI9wTUki-Fnwh#vrr&b-TwDI
zuiGgfN>5MJD)=lT0i?5fEPx7*{DJMh*`2kz33or-JixPev+%#2d}-;^rRmWFmaAan
zwyL4(Hu-OX$sdtFscRbBIR=WIfIAI=8+<E1&;I~Qp#K2odhVz1j|457^4kIj6fUlT
z&ySI%>Fwm2GQCLgS~$tm9g|nb9E!29&(MGLsSACN*E>o{SBwBp0^ITMd28j3=kb@^
zJtUGJ_@Ez_7T8F5sMUVBvZ)ev0>|D1D<Y64BY!ds=y51efhCUUxnjO~816Nw#RW^7
z9Lfe%jl1tH{V+8Blr=wER>0IhT%@3t7IySFzhs6TB<!cmWFr1U1cjIHZ=R1DKNnUn
z1_wftPW4zpV@>H?VgaNZJ%(^{tbRGr+EQo&d*CL`lflB*V7Jo>sBO(xzECI;XXRMR
zw{2Suu!I&#@~+q&wxPcFfB~~uS;C4O^LabHhZza_xH?2FGpdR^VrC#{CfAzDH&F~G
zq?JdpJLk>)q5M?t41Fqv?Wp(94sNDt)EAMMleoQxa^&SicB^Dl_WKUA?KfDpMu$P#
z``%*&y6a<C-1=s2nY@1rSsavOx`WPJsw`!t0b?63{N~!*sy67YVmvr`03mF4KDk|C
zw227-k-c$QC}sYaop(C{&Q-qg9kV?%(o&#m(kqjHJkHVS_sv>>jfeLRJ@F5lcIN7`
zz=nWFrcIEJHuz?R)CmMvHIkGa&25QCLDPRaI*y%49wcXW;2iN4f1t?6OQy^ZuH!zB
zq|+Ip%L_H}&l~MHM@`qA3;iyj>KC~!c1Pu$nd`pocJA|)i>fgeNTNLsZs_D_l)1Vh
zzGo%Ufvg><_w>z-x@{EdC4sT&`#H+i(bBTUC6I++7%d+DUf*1d{XhnWkfO;yzlH`w
z)7Obqe+{!ZT}JC_;`?C<=9!xH08i5x$|4>~0@mdG^0Mj$UvRb*wQvBf{+Z_*l~e#g
zBJbsrWGwC{a`I?c!6cGsXUP4#{7XMj!=&g-K^#wd*Jpo^wt8Q0{j2>Kf(8a9G)VsT
z^!N|cK7Z{00JEg(=LiL}o4n_}x7m!}ULU;w0O+6b6aBILKPOAoNw2KwUr8sHLN+Jy
zA1wVX0U7vT@LX;DBh^LJrIu}_9;=_Y^j%baXG<LLwxn@j=Pj}Hy)Hi{GROL~0qKCQ
zFc=#!bwe!Chf+Or%<6u}R(RQ@rDv@<?6Ti%msW)I+K2xDO@n@)u5#z%<IAbMZ%)iS
zi{tHC)1r(-G=W0BdBXJ~hEfRR9OYo>ruQQlfX8I5w?4Sn(_Z`TSi0!%rv|rEe=Nd0
z+~=yuTr!Y!u&na5m13muYdG`QzTMn=ZZr-xZJEmNwrL{BAZ`Xt#f`Z<=QPIMRhDU!
zUfi7Xrb49Ws#8W}>SOLZ=Yi@RUYYBw)8l2|XP;iU55paXl5sP~dNA(%<>H#glh3Y0
zzIPmDt+bYnwsj-K`#-5bESS&bo^RNO`b1OMob>u)WL8e>3g62--?AexERaYk<6;QT
zn4YNHpIV8Bs3>ieO^!?o8}`Qp*QRUenQ7BRu|?JNvUJmcW06Xbee?0Jw7NO|#`{6~
zc@LU4twV+$x%%*X*l(UM@mJU}eY5s^OBw;yLb{ZWSbAsBdM`ixJ^j0Qmxt>fm+#~2
zugV@D*<WqP)IgpquZhD0%MA4tk_MW!8khe7A)lLumI<gDDt6Da{v7*L`Ocg~>;#GT
zZ`0F0`nTKj>*Jcse1SJwrG3=@0L11=6frV?_bxwN-7ISM4#@qz4n@+JQw}_?0PUL^
z-yQsK{5*cy`!-1;U;b~TQs_tbr*-{D!20Lqi3XB<O>5=YuG^4n^!aD+GNUPAhRV|^
z9malF{AKn)`w#6Gk|68RbvGgfYS8`1ehqxHUE}S$9loD08<=Ef*_(^MUVb>jgq0($
zMQ(uat9~~1{IJdfsR}C81GNytpWfJowLO5kzVHBXzXRJfwwx?Qh!X**jU|_IE5D$?
zvhMy0>1|q;&;H-Q{V{~P;+15SDF!-2$)IeHho$%Lk^ow(0>P+VeppkiW@T+_Adn#`
zRiuH)?Nzzk>4i1Pr4kUtAtY_Wf=NFBKMa&4teUp+A2P8%U@v1`yL|EE9wHH}Dwd(B
z)gDRwKO6%38^j}J4_ghZwO%7?OS-Z5bn$_m-}<|@rZ!uWYk!VWL|O|Lt4}Hq?l<4k
zuoZ}PT?wZ4&@Zs(=Vv)l%7+T27Kta*)A#9sU0Z=dx%<`VF_<#~r)G0NRUL;I5+lsi
zIjT|LHA@PxkZUxwwBt=Z&<E3DeX|~&Ac6`w{BvHVpQkWK2#!EZtjlLz4hXsdMx*ns
z_P~U(=vD@Uqfyep?Y-_WY^uwq!5r5f`CgQxOB>n%gtmtSsinWhfW=vgG>EbSwWNys
z!=3(v0pJQ8Gcp!?7D%PNhkuVebG}VH2$}p+`m~Us54zh`@A37{AWY0r3g4@7l!f|u
zCOYCt*Fux3#`_XE+q&PT_zMI=Vf{GRklKrrMywCa{y2^uV-jfreL?2zZ}d225z!&o
zwbd^JZg1S<#{&NVB>h75aYrC=5QlQiq#JKa8xMQiz68Ts{lyFc2j~YFz^rl6M0PtC
z-qefO5zip}uoRO*yM-W{7J2zy*7&XrOoT3$``+Mo`t$R`1o5gdUBdyv+~1~Iq)9q`
z2^|ni`7dvezz@eJ(CIDWI0Zl^>dpTE-V$A5bSf!nxB!c;{GNEgL<Cr1SXSM)&Y98J
zDh)A`NFJBB&n6qW?kd0Kl!`P^3o%CDa<|&We1BXiqJ;GmEJUbz7$`EhP^S4LkO22M
z80%020uYb^UsLKi`Qj5CptWdj!t8u9jE@{)Ln9NpTfO+--ylMj<wsJ?YKJ4*@}3(L
z=0d{hg7Q6U_unEmeZdvmz2=99Tsn6~Qp`a%6l^P=Z`;!WW0)!M{3d5AQk!wVwko(#
zU7}V(Z*fAm8-Dv@$15WWATsX0QFr?T3Pf0d134hj1CHnE&Qt<42i4~U3T^3V{>RT1
zPO+zL&!*zPXDF)38Q)2bYf|c>*T=c{&gi0Uu1yg_^2w#xs)9gJr0Uzy0#CyL38X|R
zRU6izJ|@3kt_4uYTUA*i`8~PLX?3$wsTV_$-=E*E07|d{fWMC49ExWs6;7SFS{onP
z$6z1Dor0|krCR}y3I}fZ&!Q=cO%{d^WYHmgsOEZFsL5uddWYqdRRWHckBjDSC`G+S
z?|v$UZ}Gtbl}&7l$QW8y=i2chmEx32l&+@1y1;>*3Dim5w)DW~C`N#a8qb(s<KOq+
zDDj9Rrqm=;rIe=t`=0qJ3lc9=8shk&jVFoW2=#)iMu#?Q{bT`(+AEPjSCEb|`kuCa
zs=QZuXd;GlWCa>P_yM(iGI0YWfKq}1+??dsDJ6-m$v&O(qnApl4R!^Oju(+-Yf+|$
z-JmwZAaaW%DkZ23T#z;=>JANv27x_^^!?rd)~#jjn`$-b{<4pL2_OIkU$u+<{PB8Y
z7Pn@P#9+QaT866~tA6`qk*=AQVMZDc{zL(Mo^YrTqzyJW=Q&FURsl^L-@nTXg<z}~
zU^wIFg`_UUsdRxtfE#2*T!q%_BAE`%v<>>7*vSNoN}Xgrt<{FWU;|*|WmCzkzlL$6
zqN`B*+J?a16=T(xGB%jinDB}M*85gYM>0K9DCf!deSg=>10y1AszuhJz53ybMIJGk
zWGqFllT_Eq_N%~Gjg~PcjfpF&w!cru7k2?0Z+gP+%B3p3N4_&?kHckP#;otK_BcQ$
z&cH1W*c{MpR1J?UbAgx=)_sL>oa9RS*aQUdw?pfc6xF8a*QwxPpup<0LuwhzR#?`N
z>wD)c%n2ltyb<ewwml7j+w;Su81)h?nj7OpT)2%~D0Uxs>^;x69R=iMwQ3}ig820I
zz~^Z7*j7X!0y)X>rOR?_<AtcB6JYiS@xU2dNUet3U;-)kTD*2F#*6CHu&d)9WQkxx
zo3;6vpTfO8@=ScHRGZ-YU~nhQNb_H9urZ)Gyk%_#t#uLw8{-j$?NmYf;4)nkt4OV{
zzHus4Z)EMq8Nj6l<P&6!C&&o$kyT=j0g3!2Whkwy*SFIb!z&)WRcCK}ZCceM6rg)^
z^TlAy*LFA`Oo8Y*xnAUL^%KX(CTp?d*Bz#5ViA;4q}_qP&k;h=FJxDijc<VEq-74u
zSyy0dY*^TnV!baLTNLp4-sra9Od2$$*#qz=C_--RowJn*Jdk+@+Zocy*n@l?*~**I
zI}YOmuShFElfgO5<lLQ)rVX_L@0`@FM27eqzzL~s*6R?1+jD%3a-e`i4f}Cf(diBp
zlS6wP;0L7u5q`U2^0N)ff_{S-#siSMim*w}Q{mGmn{G(k0Z_DWtqIhI!Ng`PZI3*h
z;j2+6i{BbVYuBKN*zIFufylN<0){4=-;Y6!sO*I8fVC6!zyMh6J7;sX3}h>IHu&HG
z5>64ospD)StboK0{`e6~Jp}~%XK6OXjltsz`;?bgP#SjB0J}Wqs6cs0o=1)<)kru}
zD4IULxt>6>#|UB<NGDL_`+og#yfvCB5HS`=)K4^T1ClVTJTwKARf;#q<(b#bB#$U!
zY}irX8Ah3ux&Sr-06XT1WRJoy#0tl-EEjqQW9@kcW*!ojL~u#_q~6&f{J;#&<W@TX
zcG`w?oj`VI>CGEZr(^NW0vV%;ivguY75m-rI!IC`Nec!VLoidu{{WuZoVyden#F9S
z`(1r-vpEt*;-2e46;;~4HI|J$t}2OE=i#{n*8+V#BxLF~2Ef%0{rlzJ>0{D&Ao6>j
zPEVy&Zk?2)yoSm0-F&i()JNh*9YgI@$yc=v{uRGtg=3Z@2=N4(^?z`^s*gWB)6uk1
z)Xk}j*<eN4{{X+w5k(n8vNDap3^(@p=G5wydUuG&4vPeCcdt*a;AN1={v){xq>-dw
zbLsN$>5xd-dUuUQjWkX0Ir`?#o&i5iDOO@5Yt=z})<L>=(zBP;tlk(bcQw7&Y^co~
zpcOg>lx_}a>7^vOc4}(?YODDE8PX!i1cD|Zi1LHE*x3W*cgn~Yq)3$9dfUvT5J<DP
zuVau%!0H&PjRCZJ@B0|tBD|5!6j9SgOBTKA`&YN+hp2_aGbxZMA;2Q2ACI;eAQ4L(
ziy{L2hi%F3O?LkPI8wV9+$4$#O^%^v@nu3+O&Kk}xbgA$;aSV81Wjx?HCy`M*B7RV
ztQY&PF3I=pgdl_{9we%&PN1rFf7V(r?G!`EXdA6Of1H<798QF*NQFTFR|o#@Eer`K
zMjR}ql-n_DP(B0KZ>M{}oQ4w`=vFe2Ly|_v;f@!@>C`WVRSu%e+pzlk<RN77CM>Md
zAG>G2uHU_}`i7DR5rxrQ{e3W@9I;3kG$85*jn<RBe7MT0j*NpYwpkR7JQ6*9`{ZA)
zo5=+t#S;>`RDPWBF~mo!k;Bbl6JlFWn2mrR9D-6rJVHQdQtSe3sP#Vhk;f!${S<8~
zES=7J5~KZ_3{5Xeu66y#v8e25*5{nZ63U^Dq5)4ZH@N+bpbn4(MR`?T_1XFN{WH3T
zcq9xw;Z2f78`}2mzE&vWX<;+(y$jm+%Jm&9bnnzf)Oi6HOhuinAISdzj0}p-s!6?0
zbt&)fi`Qv)@EX@ivcM1D&l&oe9XfEr;e?Q?4Ou+?Uxq(dKZ7$}F=41!ufrgWuD%#p
zS((1=R={@c_~juq5`qLmMM>riYrnVG82At2aEDKv-IhMX_wSa6r|IN~^vt^YiAbg_
zR7N|Wpd8;P<AD%vG>Dx#j^gx>sXTA{ymL27&nyu;$3SVS0_*F~Z()l+Qx93;D=H^~
zx=xh<oA`5!_HRuCbpd*bN+UM!wQ2dC&$ZxDB$-`ZwAs4VxpQ6qSgQ|(Zby)8&q1{M
z(Bl69ER&&l^rV0Z9F313zn(k+;Md|C5m;U9STr)J+GKT;!}3O5N>~(68=gS+yp&K*
zjG9!m?An{k7y;Yz#d7mTSr92>TAYAM_RDmgW5+Lz0+kA&IHJJWqjq@6iZ@nTK=MGw
zXMZWZiuc>~$QckaY0|1r$`5~k_l2KaQkF$`)@W$99Q{56BjJB87Evaz6bE3{b@1Qu
zz%mtS9SCm|?ztW7^v+a@Rg~+}7JzfL*Xx|o$i632!U;&DN=^HA#aO%&#nqZ802U&?
z73qOVN|3WgX3!Wa-!;wtfA0_49uk#E%9a#-ypl%;<y?2if;ngDmIzW(=VsEjDQuIs
zrbu+M$talFEVWE`C*kODp$}Cj^BydEV`SU_pn-nJ7&;z}qIoGmETekW*q>9|=ba2J
ze$b1jjyGaFj)6_N{{V;szd7Ahf6PzfXm2?H*rB%{fWUN?7(_+Mla_j5bs-!Lwmj}}
zWrZV}S}Z@N7z*58;{B+N{+StG8NtzNPzoD`0CUgfn_=*L2;wU$31l85jKlhiwF>Q9
zn<lpQz{}FS{RdF<kt0foz$%}+w<i`T`nOvY$EabcS**y!^YO~{Q%lrJ@jyW7#pzqS
zt}ecRTv%RD7sf^kQFc@Px7xe^0IUXOSj5d3wP`#*6l|k!e`B^JbH&q3BQZ${V-W>+
zBanRt{k}Os77m^spTcMAVUgsN*(%9Gw*7rEg2eL93dW5sBCXLER^HqCow5TuL#!8T
zaLVL@ErA!L4~_5bn5CVPX+%vfh3~Q*j>p=LX@x}4O4Gb#z<%f!TI>^k+hCdx49BUK
zN(C$t>0aW2+WwxzW@!ZTJe@-AYFQIw#>5X?ze^kw^=MTiV$?Ki(4?LPp2Lq*k?Ixa
zFFMdBLwDSAd+;#*o~7hy!xXxrFHv!@P<vS-&;4Ol{<Jzwu0)|EElXEiso?Ks^72au
zM<b%Fp*%8$T#(*iC|Ii<!1!I{WYHwuLzV%_Vdf{yZuM+9+v{BR5J(zSkp!|y9hPMr
z4`0&$7z_YtL}CV(c|WN3EX05sJ8(_${{V>0&e5!4nF&!L(x2KF;p_f0T*$o<j%cP2
zEKH_GzV-<O?_>8_5b`9=Ji*=)Pv2rj_qhCb-zphkVbRIeENDQ8NI@WIwxFwK+qcx8
ze1r$7E{KsKNYKbYTLhiF$JmkhWqO$eeIHHJi1f*+o>v5d)&(K>Z`;3pvEtP_co8Zj
zlFF!)6G|6O;NI2Tn!T>@2TWYIj_wo@BE7D_Y2$7$fmoeCRNu&m{{W=1v(}dYmO4nk
zS^$do&7BzO+2rX;AOa~tXwR9OK`Xi1uD$lmJu4~c)*%}BgHa@{mfFbret1%pZk9Cx
zSi)4c+m`bX2_3)Rz6VwCrI4~YkNRLy@)N&*O01-={d>HtF!P-{r6Fhz2hb1L&Q(-t
zWFYA9^@2@nV^#9|+u%(Z(pKsERA~V=Z+<vG9)3q0L)GYcSHwONon?)U_ci*~0^_7v
z5*HG9pffVqpg0D{tsD2tq|!|q_?{VLT|q|-HWW?pG=pCcTq1MF(zGirGIF~0>ieKj
zA49(zjw>IbPN%2UDnv>t0m<7*2T(S6J^n{03&aGj&?OjvT0eD&6lnJ5>$&)1baRlC
z3jx`|(m>D!8z%TWF5UiER8+i3!C8T#twOAJzico?;lk6oqDPPsX6#k^3ch_Z{TwgU
zbyGqFidsDh7~P!hN_P35hD6IzGU#>Ci^$lv^m+6*^5X*Y6#ieQc+pnImSDb8MV8gv
zo!8s&%FWSrlfgEUiaL0eos6QE(6QvzkbdajW4Ae!Gs_^389}yXEC3)u-@aQ)k$juj
zZ$~tAQ_mMwBrM1z>Z542KI^{s^Rw&Et_FUd8K8Tc#9bwVvi4vH(}8EUbNB~dmv%r|
zS#?=qwS2ws%`>_P)5JtH8B~z6Pyw5L$t6eA+a^+qc!khvRsmOi#>AiBu2E)&IGo1G
zCb<PuUzC;d*&Oe`9APYw7^7uRx(hX%qIVl`YLxu&^qp*wM6xqS<B7E_gq=x1Py)pb
zhUe4ceH%Yh;t&0{@b!XgcU{ON`kOx*7!Cwc^=0~5rAQlAf&IeN?N{nIzT4Lr-6vBL
z^z%m~>`TPTy0$|?!LjduhG6N;-8`}N0@rpb)wZe|ek1FY@CumYX;cGxt9sHl8*(@J
zVFf35S&%w_^uU^+0lWML+06YqqBLSxsK%yYvo-b`)eoQ7BuG+$7Q}~UW4l-*>6eB$
z)=?a@IgT)+O8Hrm_pf^6<AD7%)0Pv)%5*9%$c2Pz4c*c5iaZWIch9>20Mg0)UYqR*
zHHQGk)CTMKwmWgfcKPSTyTpNF4N&OuiqR)gQUc$4;Qq#ar~Z>7D*dS7>eOKjSC8-5
zei>`!js7zI0FN}o(TC=8%)mT{{{S_~PeNX#t=EVu`*W3QXMZlnMb3vBqyGSK{{Z^n
zYc9Z@hTqgVo<F|C_n241G;10`9pxh`HvN@p(Mkt8k3Ru|VoC+mxZIo{W;-5+QU(72
zP>wx@cTjaA@3`zU(c}DGc)lbc3*T{s3Q*O196;W0Hv882%Oao_37~fUbD_0y3euN6
zfw!(o!jO9lp@}5VBW=g7W}m5xrBc&KsyW=^dktnrkop1JGWC6Q9U?Q$Dz4iO`Sbq(
zX@3<8G4x`$txcW`v(41as!1KYomtD1lM&ji>q(z4f2;m1Z7e!et@dNieE$Gb)J@ef
zd7X<BV*6lf7eEuZA1nc^qSy5)bq>Ve{bwDrTK-!#5#XSxU@qwI?}`g*aA*>{cN>kd
zkrY@U7T>=)MNJ?EQFbda(;1hq(|CP4!4YyxMi>*e_f?v&#nY&HLC+Vck=43c&90RJ
zZ@%aK=daVqB^rfkBF1*{?b}VXp3M-^Y9Dv<%1QtSO<nPsVQMsX2Q?uDgC8xEL*F`E
zc2O0Ju15a=9Oi`S+j4ixx_NI=9C3i`<&=Y7nAps~ng`#UMpe>mA774H>GlVX*piTz
zt?D<e&Njs$?5;FsKem8glct{RtcEk~WBnZ69)JmB=G=<RUuks_^%1liZr0oJnsP?t
zOl-%~g*uP`whuW~llejC7a%LnWO(1CY9O)^<vdnZr4zAY1+l%mXAH#0mZ0h#x~5WW
zRoKdCUY${-u!l{P^WQoqju^u=8`a;O$<;K{mq^!GpxbYxU4D5sl9aP}tV%!huX<~|
z@V|)u*j|bg(DbjWcUqB${{T#Sd~;{opK3?;FHWaOexg8h$La2Uv*Q#$Q8P;9vpFQ6
zQgcP^`eAE*Lr+AK^(fG_zXfl$`T8gD-|+H%pVJ9vLE}gVKiV@7@L%wp(|CPcz$|Bg
zdHCnm&m$~{R}1B_lCk#Xz5byo;_%kF2cK;E&)`3{%u=`6lewneJ3oeesCG6E_2oYd
z3hmQOj~fvrXHuK(nOeJzFCQ<rc(e9}ILCbQzlZ+VkL`c6)?r>C^16=4Jw-XgF{#t&
z>3Fnm0FAc5DT5;mRuo1t#TS108)1$DVz`*zlUJG;@3v+GRljga%Oh%B=a_Gw*cUhL
zo^M>bI*S}Iy!4zBY;9SOu8gz_{gl_&IrCR_Z^1gVC_S-Az&WgNHwQRf$uJ~-?;z+j
z?sHWuonp!3B_dHKuQg`J87noG+;{1hmDEL~=3}0$@oPeTGtH4SlX>!dj5Ch&S$kM=
zMWHjD#&!>ebGjCWUk!oFJWx;64xl+n2&S$WW;?7ph@vxPGEG|Tk8`)6uDYlUFI~@U
z#~)F^G!L#=HlalP^L=f$na8O&i(C%)W0TF2WGXhrR?>3rVR~X=@ju5O!{?%(`Tm)I
zp((Nl_P3^d-`U@2H$~Jepwiy|037{ysp(_;PotNlo9;T$K8M#oBKueD`996-W$ET!
zEUl#f0G#`OMCZ<Ie%<`X{{SBc>;9eXU)`j3m)`V!RDE|&l7r=tQ6KSac3<vc#?C!Q
zu6(!f$J$~UKbDmL08Nb_Z+!ZuVt3Q1sI9w<`Z~_vD`?cRO%o+3Yi08x^&Xky{kir`
zUu^U;bg~K(ZjV>tzhnFCbKZ0eGz%MQLzyI^z||}4-p4az6Q|)nXmm34om{c?6ed<>
za61rdjxuQ&@JktE3nO@75-f0R-ve>K$3FZ208l={l4T!jbmF9nqnKXWdpGEQS^4sW
zW2Cqw4O@O9^G%~t>8$P+jxy3I>IrDe0L^wv-CxSEMnnGq?~x)xwM)Z!uT72jv%XC_
zmRE{{I0TZM6YIaY0|+Y8N#e*=fYe5wUikb^KADRl=~Km-K~bQ$m<Q5G_9u<IoLka>
zssZJ{THK5F=kmr#)jDaUW=SmgY6}p;{{XtXjz<2t{VbjgkxCoM3#)zIV#V^OW5*r9
z!jL+<#G;8nbp}z*{yn+h>5eN@aEmfnwm=CU!?`wj_+;dgV>G4hBy(&A-RzHT@iYaP
z)9Rp3rQh)Q;44}kKXlh~zEN0C5ICr{Szxw69G|6}RgB7Y54=sg6F`3Vz!9cl6k3~H
zfGTc$$8HC&=r98XRW2K2x4-XfaG|Jb;BkD7wjW$>qQO;BYz4S14I1|C?SdgJQY5jp
z*g8P~?PPF&e@p=S8pKiQt=UfCZ}{TWD6MKpW%AorlYE`G+VM0Nv%QmF9ITNT*+H#C
zV!C!;kFEz?Z5osXSO8d&xi&=##b`%QD2_>PB1O6aY<Hk)`{gGRGnD>aqEsMgBXRTR
zBN`IcTSp`l+iSpgjkj?SMPYh(;GMb7T@M<eO#mI(5=&pVw)}eKTr^J`MtoJ$tz>B<
z*!>9j4@?pjWz`a@g&-Sk$>RPP5+KOHnF&q7Ct?8h!4#esnON#7KniGs{{UZ}9eyK7
zKniNey7>P9)*vHL0aRYsX0QgL3~HsU8y?3TG-_E|GERaNhN?ck<B{7edPaeeoglEV
zS*RVZ#eVn6r%=8TO#yW-jao+g-u>@^w`?Q4JqxXjVF@6c2k;zxaw-;TR%MJ)+=E<u
zeKVHBkyP9frvCsuXC54sMyjH3Z9`*#;Si%dAlfjXYmVO&gQjr|@y#SDFpYyWPEMBq
z?hR3+>_#t$%u+Jesz0=1wy7T4==KKwSQOGFd02)~_r(r3{{VSCWtBx(Tdk{~Q<myt
zB2slqYsqdX>QF6v@yF8^PMz#7kgVG`Zuj(}KDbgLLgwB=hjUvS{{X+k8k|V9!Q0C~
zU#A!NXF`g6N(I8HB#z$rSTgC<pb|O1Vfub}LNT^ub*R@iMsyN*M4w%*@JAcI>J0;0
zh}!eEQY<S~5^o@?taRe-M#Q$=j`)Umkc8NGs_*NH?i*pIhSqy;l$XOtV2!PVZ6Mfp
z?ccWl0I*c#1d`0+&o%q3Rv{dT6yI_?WmYwG)D_12ZYsae81b%!WtDbuVcUckME(_k
zkpXWL#H`O+8+%>*cHiF@!~^b?zAxwb{{W2TiR1&rw<OR2*(b2Ba3C~5G~0&U*%ims
zemPLr5VZ)+WYIkL{rs@SC=ac)>Hq{`wO6pgEFvM{y@`cbJOFWgj7UPnjtz2f0=h;>
z{?Z6F+v}8(;YfnUS@p&Pms---dv0&G{^um|vjWKz&;wED{;|4rN07xluL^~37R`W2
z74ASD*b5|OK-XZ|1zToPE0O!-9yKW-R0`)!8{7*V?dg(hXCz+c`MkS4(W*u%P}?Z%
zdtcyi5O`_|(L6TY{{VM_me?{7K-?b3;ffWSh#;N&^Mk*b**lyEc@5u|h~I88ig=_T
zqSh5rchr4<EJO(QU7Eo1fG++xSZS8nBVP19@TrZf@ygAqPbxv~r*rbeZEi-OL90-G
zF-`s3yaz>)M)N2dLDE?7&G!1|IUH;@7ta3x99CigPQ!Z`#bYq*G7l7=x_vSsNz{Jr
zX&cebX8xfe00;Yb!rH2pcIRQ+4J!>w!AKl6@9@HbP+Q710f4bkO6t>lSlc<H(!e+<
z2p8X;_`yb%9#g8wH$;AzK&39DP+(Tc-(!SaNNaH0U#P`EPQv#*95N{_Vu0L$GJsSC
z3<<vDITRZug#p3ARz==|e;jZVMIrNF2arA)2Q#ZiX;`o|e%QJTSXFBqoOv!Vh_8B<
z+x&ato1wWrhbUGhn35~lR#9XD1ZKcI`{K&l<s}hgQ$mOP&XVX+Cr-nDG61Rx-`Cf1
zj!0c04VD|^ixWp-k7aFx5L=ty0XIe}MK$9xXsTdun(c}!UiVnkK-`n<+W}UI^Io0k
zjHI%O0+kwQ06-KnWDs}ljPyc~v^$?ulqhNhdgnHsv=deM;Z*|0*inL$X?570vH&eF
zV0PZd04+e@(!DUSqEyj7qYjA_iv=|c1o2+EMFce$i1($w>9Kc^vs)fJ<FE)yh78`I
z*u|z$ZAD-L3EZ3a^}s9|J7c4Naa#-6@qjC84pe|mjj#dciy9jPoGp0d<%DSQG`F}l
zq@Hm~>i+=S)J0LT-vDYQ6$t=d#FJQruoOTbcFtfDj<D7*V0QM!vPS2822Vehs{7{_
zWk9#(z78!PTgC`9mL|s)cmR^NIVbSWW@-w?z#9xYeaINPZiU~+AnK+A>zw@7-n(Ja
zO8}sH;0#orE8&y{;NEj=F89vWTyum0Uv!qh`&F3Cr9sjL{$ak{WYSkL0Ufgs_=B+c
z<1(lt!$$zEH^&-2m;wQEh{uq7U_JQ09J1O1G%nX&!2I&vH%@dobqp(#-<QuM@K;ia
zWfQYM%J}rkB(&ZltArb~YymZYzlH{8jU$nzBa`I=({YW{^$f8RG_NFs$=iy@=_ZZ(
zi!ucSkGw9vnEh)+C8XA|jnuM*W?R^vdt?!ls=0hwW!B73-C7%pJN+@?>RqPsBa=;b
zMf^rG#<Cb=wGomFv-bLS+~WwNW^E;eL91O0Ciw$xzCVT(y-da#SR(0i2GVX#k51cs
zaXOgH$|VW{s(@q*Rmki;PvxBOkp3hfl+<XDEU*1#e$$)BjYMmpAfh#W>aG6(3=Ggk
zBlI#5l6Y#sw3WA~HQw-;V<mh?Z6ke;;hi5;kjAn9059d#OAzPeH`^*g{{Tf@G=R5S
zNGvbYzdwcopXmuC(^0TA*JIOfUPl<!(o7&&OpI#Xq}VT@9^7w?B=Mbf--b6Sdwo8c
z(lnBFUMfMNHzK18upg%w6`FD3c#$DpBe~q{C=X5l09?r|v-LsbkdxtUzV*Lz@i|#1
zW{?I}SbU(y3E8Oc_@AyyNF<M2IFKx+z))$2&z?E<!YvCs!mPqaWFd;y-M2ZGW!F0$
zMJQgCTccZjPF4<}bj-3dE77e4dmq;{#WKy*&pWAtIa^kgAnDq>`(6ep`e{+aOs?J{
z5&~ClZ__F!m3m<48a5kUU$tKYYxm2i+6&T8Wrn6cTL7IP?eNJg#z@agFNTU=TS&s|
z=g1rU@G^B~T`H!@bH&&v*WWDDw}d)+P)C)38w&50fS6={ufb;N(CGvM0b)46mM4W5
zSSIRLMTLt1V;#Y>&!G97D9zHd^zYQd=*t}fbq?mZJNNx^Wx}I8&8U&U`F{Rcq?o!m
z3~eEkQK=zSt%YoUeX|f9JdHG@Qr*WGYdr1wpQZ)6caB7tTCmnhRbqJBhc`oP>E(l_
zpseh`P$Z3yed~?$IGseO%G&FF#=|cha&=$K$b2w1VoL?n`}Dw&awK*E!)ev3$o%ur
zg;z@T8W&0dT8EXn*!?rgQjW^NNb%P;Z{R<D^H)afAd(prs5^_kN6+6N?y_m8R(Dv@
zQ*;U{g`ZE~8Lk+*f8`~ctd3&-9>k~s8lm{s{@In}WOEroqD{jdPt%R^eOFb}lo1Gk
zC;RmhY;S)aa1u_GJSee^Z5h-#;=2!A(KmwqBy$NL$6#y<pas_b{c|XqSR_6ZFjKd3
zZ`XX)(DbHmpTaaG)C!a7>wcIR-ejUQdCJgTy}>zNnZ)PMA=avNh2GEXei;~%-c}O%
zbT=np*|JWUDUr2C%B*OTeCLZ4DzD!t%QQ)+R=?_jrGVs~Huz;2#M*jc5fcMU>`80L
ztg*5&Ako^@YR|Xf#%P?m5Wa?t=stBDF(02J0U_wxNM>N#8Usul+}6XnylFZ_jzkhU
z5C;3p{ob{Fkz)@<tEB20SrC#yAUGS@^zZB6Ak!dO75@PDQK<!OUbzPDlczmO%_o8c
z5g|}m9(lixdHpnzo}`%?MIg|jSMl47x$37Z{{Z~Qge+a~NFJ4gTSL>v(n7!2wh|G!
z+i~!~*o`+x%M=;}gwc}45J2vB;N~fxLkG}={lqFsU5(j4JoGxbkva~ZP^n={5>r#V
za0eR?-)!>wj-WdtL|#bObF2j)LHjrXX7LeX4`Wr37OlT8!wW=1yl2E$1f$x~pf?BS
zlxX33CXoZID#|r4n!hdf$4S-NrjJ`H8uO3=_1di92qk`#K#8MMOaW#c#`ZlvIm<Gz
zI?kD5TGlrWe0)Az=4xpoE@J^f)KqO}<BU&<Cr%Sn^umJ^w*1ybRJmqHL^|XrKvGX|
z0VC^QyD~D&-XnQDHwA@R6urKGv5PDQIhsNOl`TNl%n0OiF;*s0q1dOJOBEJZ@%rUN
z^niSUt%1-he{ykL$0Vw$OtoMSTHuq(%`9M%&5__hN;ZbC5xu>*`DB}>Jx}ueJTB80
z+=N>{3g`9qz<!MjPvM2FDjQX8XZ(EeB92Cv$NvE8vl&#-0G~?ZZ%>w9ZlwPJF3%xj
z)V7pK5vtS;$J1_d3nRkOx=B=NRyQX{srlK+G?fAtm0>O7nr1EJ9#BcWy?DsOAssJ_
zlB}w%%2k*R1cAMLhV}Vi5Y7CULnD|aloU-{YU0T4&*SfsC^}hRrBw|gxxe_>>;WFP
z&(kQZP?YJ_#gFQe4c80a{mB0SSUPEvUaMD9*H(^0P^DTFM}8`~$|UJpWNl2$cI*cH
zdszqN-!e%O!!uJfVHk^gI%~Q0Jm7E&dbky>Rzao0n?Fm-bumiI6CK)bFhm4+d(if?
zU9!*t)ODgw;~)@R>_7=%jkdfKu}+#^o?~)~F-cv3*n4tLKzh!yUZOSCD4Z!8&<(*J
zP%pR|N4EJWQbtKU2$(YuHl{bm+urv?{I}yP2T);P%AsC^+9_kJVhFzbAE~cQ?xsm(
znP8S+fO*lZaz5(V?N#{TL#SyQH;tqX;?%9-*{;A}<_>f!(Zwv2GLVlN1=JhVgIBoN
z{5Hrxh{$?{tubs@RS~~C@<}(f<z#U38;^LD8e&CKf_CGZ`sEK8OLq>p5%GgH>T!Q}
z<H7Cej>{B^=oo5@0s^fK#WnA@uf+DkW@wYE>BM2RfWkK<fmBqEEP#3Md6&f~7gFic
ziVCWo!8fUmd;VBe<qkR&>KUSWUF%F>YK;_WCA}<>x#WxQk{$~gbe{~QY*x({JXPNn
z_>;~bFN$555@aU6>0mh9w;0Tk$<?Z%f-gS)W~jHTB=7m2Fel-$>E6OB0b$6it+uM}
zd-{ENbn+o(k(F9-7tY>o>W8(1$<9=Oww90qtj0)Ee4u^e0N%;l;g#@YkfO+dLk_7I
zPn8%OVm9t;Z-x<IkjWT`y2chT?1)3%D(+8h&#3$}FHX~R@k=tQs%;dckWDvm56gds
zFHQuVOOg^l5gCarK%v|9{{XzK1E^VK(8$WMmDWHZLGs?<`qhob)y5P))<Xj!Sy;kG
zgndBk3&Aztaf#B$9Ee1Wk&*ykFi?&+EzNPa#~;9trcS0lp@gOe2*C)__kLjA_oKHX
zxWOy*^7WFR31SkcAvhLJ^|t_nL-F+rJdYYm3YB|P5d`W}N6XH@**lI#-Sa!TDF{o+
z6&3}k8Wme_+qLGABe9kvAn~=RNga)nPu(V~(C$TP$#oq^Pcn3?0g^XHJ}G75fB=dY
zz~k2I0LkIPt*K;Qp^l=uK=8#90^a<QkVs3Rk<pou>UFbV6IOk@eLZt<`z`1DGpg$m
z{3zC88j1{LccK)YM#@c{wjghLhD|@pf@HQ*6?PT_U7Nl59N)`q4q*Z5!^&h{p-2Hi
zBG8j(^7@>hjyLK=(GM4;iPhh22Tg%Q?^pUCd?s$5H|fNSeh>k|niA1BzZXOc_RF-L
z8R^<Y@!&F+e=I{t15nZ$_}xMEvwRB-jv1f%gpc}0%Ajjy1B<@Ghu1Vo6kR_`y-9Jb
zu~QIHx{^b3O%Mp&-Rd2|$#mUxy(o5Cjamjmt-b32H{rjq$-~l(Q%BS{hGRnH5K9VS
zU=HVVv93AWD0rdjUs+WKIGh%<vDlH%{{UqDJ{ZqDvOL{PW;Er`01#|>MQk_YB(E$|
zKB5&Jin<Os@9?}G9CAxJ(vlLXs4Qz_(BzLzx56yVr>9*^6f0}3Jhx$AJ0GqE(xypc
zK`clGk~cT7z4q<LtzyX|!y~HbR4w5D08n0vAoIxH_&aawy-1!Fh7Cx>u<{ikn;J<!
zmpBufOQ<E;&Wcl1K<qvg57$3M{{Ygc)p~EWTEJC!C=pk)oB9!-pIW>qwoI~6UCx~W
zX?MG@K=|EWeue)4r3vAEi`O|Jq#aCPitVKB@6KBJOZ;W`4^kPopky3;@`klAul}$f
zo&mO_+_=gG^K-eF9O!XLq1}e({{VX}qQVjX05WJ~<66+${{ZfsV05Hyzb*RZMz6A*
zui3H@-cm2*Fm)3KaoT_uGM{FpeVR7{<YSQQW{N6zaG-tSbJFALDC@=Xa<L%ab9p)E
zkEKR3xK#r8=R8io_@N`T=~Od+$mfIB^^^6|E~YiL*~xxQYuY=yD^2-(e`x;z6Rc#%
z((nHOnd9Z21l>gaT%IJ3&3qI3V3s9@F!FJGUwl_-5b!h~Fs<us;=W5?%Q)0{1wk1m
ztam52KY(VDV+4z8C$?ESX6gdz45}$ujz4>5#fZiXG&B!5VmBhU{4-vLA<{DsD4;A8
z>TkAbFd_*fMFoS{Z-&{TIs7$I(*kuVMzM+1E{Fb@zN1-Vy^Z(ECkjTX;xJZu0a_z<
z-<(OhGaC^mrE*4)eKSKMDziulc1>G)-a<!tBJrGp3zZ9d?OnO=mJya@c4)j!)GpS0
zS^oezuk6Xobm0n-pyqz466aB&La*VIihm2LMp9K2QC`R6n{nHwSyp?!+8V)*#eR9N
zBp?PN%Vs{FLhGbflej+F=)oBZb++TN@15Ij+LEa>R1zq2@XW57TT=Gzn+fvlY>le2
z4SIpCBKzS`Vpv-MzWI_?EYwZ!mFnaVO0*BC%so#~y(D(yQ<3E#t{CjSMB)_C5A`eP
zGtM(dV1O?pEak}|?)`El^)AE?+vYMg4xq5Jz4pYBS_^a<lx?JXoX(HEUfFmh0M!x>
z+vdB{CK$|Y%*J>aslGrL@XVc0+6(qnGIes3=oeLMJc01Mw_4GCnbZFOF{p@(9Ydbn
z4EVpa`uV=r>Ws~5qhwCXKhAmiH(t#*opxpF`iXwh>m=$W`^<P80q8T{{u=uM`q@@S
z1V#?z_8AYbKEr>sdVs3FQNDhK7e<{oOuaWw0;>Jy^*O4w-+6Lg`g;(8A50>MQmTan
zV{|<_6CjZR8c)wVq6sVrk2=Igki~^w+}>BJ`%<N3i3ftdR3Ht&+Vf_d`*{-&4sr(J
zcdu3S#d-l$SwDFXsPxC`&x<n3yr|q{)G1ID)~_<3L+O>2J+I+Uw#V5WcoH!kJlilo
z+n=Yz;zSOl5Jld8GGh(D0gZecKKu9+?RM(ACg|pCk`0Cb0LMA=Q|=zG2a){}`oZwq
zwjkNDfxHH_XDir-IQ)*o(2<>HDGB9I7y#2N{{Z%mGbnW9jmBuSI$=iNaoprxb)(0(
zm}Ova%g3%Ig*HZOnA*o_c>=+%;~v7Tn?Ee4Sb{nB8#kLKEN(X^*F4)-rgZdcZm8IW
z0ktXQe2yfFLmiD(-cf7&NFxI&qvouOzU+>s?D3d-sJYKgmc=o%UtG;9Y6MmKXOrq2
zZm8;qe-|#NPauK~92se&DoM!a&rE6S)^`EzgANSElep(A6qP}@86%za%&R(*V{O5;
zY}|fXH%hOrMI^18jMA(RJRIqZbwf<V)Ui23xzC^eI{O#-{)~O20s|ytOq4laUzU69
zg-!O##K_>sAO#px1Kej<50h>_SiCs-ylV0>O)d8PVkue~11`+Jh|jwF8|@$GdQ?CC
zNQGCZ&z}A&`wjla`$d&OF-hl)`+8<Cu>RANq3TqF<vqQ9v-FNOdgY{Ez9sp0FO6(D
zCmp=Q?%p&YDw@AMXY|a|uKI}bKF$9CiOn#So;50VVX04{^uZ#6OC6QGtPf-BoqKS+
zj-#g&tdUBgkb;sa?x$@0d-#j&DSpBGR!)|KMSd(q)iU<~02QCMN`zS;YfYQ~03n|{
z{9pDV`&;bSjx`2&#;Dq?l_Xdm`)%*>$!Oa;TT=XzI+4MU5L($5F}df9_Zh*J`dER8
zsn&H!8uf!z0QRHx&JJRj(ttu}C4eW2@BaXJ7E%kUyA8ojBB_D(`JdR$E`rR@ERKA|
znT^@!Ibv!hO{#Kx4}Zrfk|&Buh%z;T9nQnH<G9M$j#iP-=x`knEorhgzS|CakB$T$
z<eptbs{%=(Un=d787T>kVFl!oPNVSIeYgCu!5EpmIRa`H4ygiL9u1#P_$LzhLLV0R
zAxRqz>*2}z;YyIr8kZ|VCK~~$6YJ=3j}}Qh`bUT?k}sdi&feH$i9`t_$O$qO2!ome
z$tSkrzIh3qgP_(yKs1mlyPh|@?}12URF#@dVu1#>*zNV-AX=CoFcsM5n8GR6?g-eG
z)2N&0*mnFfWtvEx_CTZ$iSJ*%uqa^gQdgC9ojO%Xs(*((d_Fy}^%0e|4hk;8#@c{8
z*T(PH14#1~Rse|OrKQ~alizc8eTE>2NH=yMsbItaF06n)G%ze%#XUmA`jOlaWj<mq
zubxeh$F=5Jj9{jV`@659<MHR`np39|t2K&EELGegAesS2B;7xO8#74|{-=jmWc!2Z
z@9rxBWKeZ7YHDgi1r5pM-?mH4x|c`|dRTg8*ug3`sYscavC_WZsXr>kEa9I+nH7LC
zF$TL``(1B<@-UK=#9iF|<)vM$c|hzy8~WsDO)f)_SSb6Vx1qNE{c@`9D*}QzKfHxw
zq)@Os*ZaxKFN(#ULR|ghu_oyL_x*4Wg!9KFx|E_(W2ggX&|ROFbUqtO7Eihbk*F_Y
z#r&}zG2$wwn_#WE6=${IY$}g8mNilv%uoD4_w>M9)^!&^OVx8j*W6(6*p*eYxS&Pz
z`x!(GA4-NEpzaRaZ}GsI){I6$D77Vf4{v^Oj(_RuK!HmSF=7b>bMW|Lqcec2$^bX0
z;nV^Ya03CP0BX+Xe_#5}K@x@*3+dYSt-tRIF7g|2Nf)FyHhbeVs?up58hNZA?H}tn
zF20<&AT`hcRf^uv9k}m`#z1L8lcXhV)wnx+{{S<PE69rBRka}Hiq^l52aTg1XVp|W
z_RDnrA(fIMV^^4YEQ==S0()=kStZhzOKU279gb8NZwpOH=TpiZhoyVsp&$~1$Q%J+
z4lMm}ogo3#S@*8MZ}{b4sT<5wO08M)gKgjHdE)~=+y#*B!+YbqsTxXbNov(V6J4{P
zOLXFqRDwxs-n|IPxd2w5pL{Co)JXEYs)~r0Lr;`;pfW?wRLH(T&29C^GP`OKc@e+`
z178$>JTpTumQNc|kXU_2$vk}UiL0~^t~b)kY%n|DwgV@K<;e)gnpz)0hr(hUzNIP-
zqDKeQd_to|>Rr8V&I8|u!o`Lgh1$jfR?P#Tw&V@K&L>a0kOiLE(v?uEKI;H{+=Jf%
zmQV#U5vRTHf+aH0)3&N6`P&N?a;L+gqi-qPZ@wgq8iI;ZwvmBI;ghPFA?emhUA(Cp
zDPn#D6-okhw;K!Z?~AOKQ};>{Rk8m7yyFO0pvrc=M`48-5GxHnQ&tJ@>F~itRO$+Q
zjq%BnLE{+9B9OYP%YK*g!n#C_q1VbRG1zuJ`N$K)&<SF6_V>xPk-y`XnFA$(M^W6K
ze|9k&?<imZU@YZ8rdwV%<ek2_6}+UHx}YnZ<<n#v(e2wP>l+dyc4ey?g&O!-z>r%6
zl2*2_Tx0}#8``U!AQeKS0cVmuJ7928!xbQrwm=nBHj>l<-MPvtL!qilYXM0g+HT4G
zKDcxb<;fApVurH&oAe#=YMiW#ppP#5X~1aAYZE%Uf&ub6**&&3&gAyUF=i{M{4v=I
zc^cG;AQ9M$&MHF@As~&cZ&(39ATYZJ(`w6}rn+MoiaRU~mGf*pd82$}ofHIBZA6PA
zw+GWWPQDmH8iptDcfjRv?4hUyvtVzCSl5&rH@)`5y`5X02`79d$*=7LZM)?KE<m9~
zVYO+pYVX$ZSv0dD-$|lD+WtIe0HBdyJRn_Zpa~aduLF=0XaVS312Z_IMupvRoI?;^
z{G``7K+~u&A**fbvH<F(2wS_~;fx<y04AR(Uy1j?y0p6}1OdOU7+OfASpaoq-B=O`
z_Xj9O2UW2RTMhAsmGiJHH4iQ9a52<F6MOONoEMfVN{;@A0Z-mNy|96~Bz%r{K4!Kx
zT;a2(wmP=lZ+IL6l|FC78OU@6-t_DiyJD4f1xpnpVx;1QB>8tEe})6e9)>$GLUt@D
z;1V4Sv?%xPJ{f79rwrysaI`$f&Bv#vLrEZNHS)kxi~wS!4%Ru&{{X}dxvX-*Pz46Z
zB;txBS-@JqhErIhd*2x~0*NP%*umH)ngkziFawPw5p~-;Ue!Z6H4{J+@a>%%116H;
zefta!Csy2_Kr_5ERtV$Q9yvltT!pWIBPMqwuNW0nVF6*Jfkn69e{YsVSfh`vz!X5O
z_|9((iv;>^Fa;S2+z$JkQijKwPs0Mzo!3{kJF*p|j*leX0*ckSs`STW6FU)VJ~nc6
zG~J83uJ}a)K{S6106{it^MPPN3-ij-l~5UKuWXYLEOx;C1E%TcNF;WUD%rO^$LHTC
z5S`WAc2!-q19j_Jq|8}IPQe8Z=C`i+dPNc;Qml0~f~JA`;9}~eEa0m>(F|*ndk;Z^
zIiwNj(4_^N)4BQo0GvHQX{A0In3Y)A4Y=){pva;a*+37u19B_Z0S{6Zc-XF#R@{!}
zsPA3z`l*&v;v#D#3)Q!3&g)?ciWC+X$m09o(<ZR9CZ<#dk7~%Of`rK=qy}B60Yv^7
zs->WsN+bb#s)G06ZR?HFFNi#-M_@_kz58vpCs?u>1ThBi{{Xo`<lr|=3w5qq7~Fur
zcCWF$z88~`1CQm`%1IVBzlqJU_&qwpBMijewJl)!Y(9CHrH%>ON0Br!?RBeu2c`l=
z6?l<r)T3mf_l@UC8CHo$-`@SG^P1v@Zj>mKcKhlGq3M73od-~QzM-afa3$J~`)&33
zU_>i@p9=LZo-LZxY>r3QoadZs@tLf?<wzh6w(pA<g&$V&bpgsX3O8&1aJ{lTI#lXy
zTAO3HzZe(k<%g>c;xeMCI#pDX#ErN3fr<8lH}eFeg<rivwO69%D8Y!v#8^D2G)`&~
zv1tiW1Z;GTBe)y_d;b8O4h{@urBnjJJ8xevmQGn$!(@Gqu)qzjjeB+{w`|kb2|9RE
zGFSS5Gbp3A_xH#rNlxN=)QTBGo=L9%06YMwvvqD_MG8RN@8<ZPEbozR3nZezy9>D>
zZ?;-)nnpsZ0>-A+*dE0Far6#}d{PvGm&e{a(BOJtBz-%0F~nH1b_4N0OT>PjFb0;R
zd^cg+;gW|^GEsYLvMX=i_(e17RV1JU>NjTp02~InU!-(J1r+KdPney+{Qm%ZV2`79
z>5yp#z+>LG@0t|&Jsfi@tW5W$D()zJY;r#wJ||Ne7#2+`;A$7ovA~iT`fj--So~lX
z>BSAWKZZPw{KrryD$LS~U>?gKU&ws2omWzlq+w!)Fb>jC?O$Fp9a)vxCRvxnU_R;J
zw{F-K9v6ilOjvAewVwUGD~yz#JkWIu8Ph3iDyzXAju(b?h)fU>T9gjM*6{R4s_O`f
z7f|WkkUNS5p4kGqZkI^g#AP&1c>(S5#*3vAz|-;}W!izg!2N#=oYPC<uwo33LD=2x
zj~w#A(yV65rCMI+niYj=jlZ5wp_5OAsebB!`wv0e)PeKJK8NawGPael<*J&y0b6En
zm-=B>#t3!lE$T7EfBeI<YD98$>g1Eb1JmCFo)wG3G6iEY>l#gk9^?1ME8L*Kh#Q6_
zhU4Ms`}q?gi&RpLWVkLv4acBAA&=I}3x!Ua6A@Rk?BtC-mw~?g_x8$(BnTmwTMbel
z>9Jw39@%GjN7=JSsU?&kRI3KI_*HN8_sI3EBvq8}YsX=~Z%k9rs;GH9zEBZC7D?{M
zu)KkXS0V7^(HW4PF~q7){g1t2bdRZZ>IefufOi&J`S;xCN+A+N@e;NuE$SfERr{Ot
z#(5nUNRvyKBT-&Kz5)LL9k8d9r3OYONMBTCnVGJrety{90HLN=Me-1mNx(eqd5(5H
zET^Zi$UgBK->&}vA55uur<5dUBTBn-zTA><hh2SB`CH1Mp;P4wM;F?&FGi{v=9wA9
zMuvg4{BuW5KT$GMGc!y8VC+;7IKRW`k$_1HtYN&mgC8yN+OQZgCS<liTg-=I2Ru;U
z{brfxS$gGdEIMXY5`+D~YzEcnKh|S;znq(>>LiRr&r}lYj(hrEJhHD%8mxbJmL`Zl
zE<H{GNM!0dnO);mMf0i=OSz%2^!+iW57Ja@;nb3UrdLgmhsWoUib(1(4y7brwGucL
zwl_%H<&|ZOctLcU9%=`-q5b<|P)Bujl+ml8K(C4Q%^%G&#?i(R?uNHZV@Gp+zkeKA
zl*`k_DPRK=Wr^SA`|pVZPtu<n88!r>n-)p<@y0|v-8&>hO0bRG?f(EG2KDQ|(`;FF
z#!y1*8^oqFL=E@e$2{}?vF7UsQ5;?$O0g&!3&&#Ua(CqNPt%N9Bpp&IM*g5uSn+1-
z>0Ppe9C7H0ikW4Q5D|a0j{ckAnr2jG8r4*rP<Ow7P5%Ha^c;16YIRT+@Xn9`(24-i
zqQ32M{{VbvopCJF7>i5kA=oj#<KcJ~JuIdv{3Ke5M2BDA?XdV>Y3g+KeP>VnoB|+`
zE~c=y)B!i>em(v<lt$mo__J70pny0agF^3p=wHXv0C^^mq|zNws95d1x_8)pY+zM{
zQNFPnEM#Z^4O*DD-5Ykk_ICJYc=f7{L~C1iK%aKKZ?;)Fribjb`!Gm9t1pYJ@Sv>`
z#oruedEybLh8{;@N{mGZy4t=c@b|*Bw^Px?f;eKF&cn^Axf+R~Tx=Kd$;%Y7LbJ|j
z$uNwuY7y4@Yv^y=<BQYutU8d6%F!bK09F40wMG8@Z?+`!7n!`$y2rb_4cwD=N7rl$
z&D0rPq+k=mP_dM%JDcXt+t;wnLP=k%QpxB8R;nY4zsEKtLRp}W)*0BSSl;_`P3%5?
z`)5B+?1=38yhaNn={i^MTAlYNpPmOaY1VjTOm(o4nMYwmfqnj`(;|=|o|)BA*HV@4
z7r(=7v=PW;k}j0AHxYO7ACRMU?RI;7G95xO>X~-bsIC!zv>x9b@D<sNWtg+E1wdBa
zc<1F~^~!+L%LACwNtJc7I01C1pf~M9=62_s$qd~rE8wtcC1-`$8%I?NR)GV#`R()1
z)T1X)sibL&xL*_-u1HlqyX-wL0#PLTPgUX~5c-gU3DmXoJdfWSx?Z27sZUU4S>^?y
zlrW<vsv)n}V|TaDY_LQMc#R<gr-<nlK!Q%+h#x<mR#+pJ6_Zi$YM6>rtau)@Hs99p
zGeZ)hsnp@G$_G51ueSN<LDi}!Qe=`>Qwu`@kbmvOSlJhT`+BkT%)m*~*GgfjBHnF#
z6g!Ic*o*f$H9yOTR7Nw(G_y!3Y4-U8Xa4XDo}hGrj4Zm*5onz(wtT-(Psao;BvC(2
z7}cj(aDw$9qTAO4Pd}Cx>g0JmBJNSpD(C<y)3uT7L!FNJVw^8X8YB`c+7xvJfkX;C
z_x!LBOX8s{#dYqgeBH?S?fQH%<dP|zbtn}9v`E0cDnn5D9lz@*KFQ{Eb#(I(wL}xO
z`wHW3J@Z#f)6e}Fx=AB(F<smMs@`hUPS?9{#@^T&r10QGa8#BAG14qJ6<*@V-`i~G
z4Wc%Mbh`o?L&FxkyY?Tmh=~d^0;IWC`_=~rzZ`TDPYVwzMQu$Yp(2!NzlQz&a3c>?
z(1ac=x;P51Z`5!8vdr+LV4X$f6jMzq^GD;x)sl^xIhJMeN*cz%1SWy_jq0+}G@oe9
z&e4~WR8@*F+M3pse0BoA#s#{5ks2=+LmW{ZOZ{KG2nue!ESjyzzH2fo28mJFY15#+
zZlIgLnJ4L*1g+M*s?dVZ2sUgg0675rC>Q$~jH@iZJF4r2RH78}$^jc1Jf2Uk`9{)?
zIw;~H*!YB^$h4+AtKW_J-nRC|>v{)0M^QSMm7>ygD_J-9Z*nhv#??e@cEtW=j6Nhy
zB6TPWyPxgU+}Pf}@4)0GXAYV~u?MG-6jh761K<G|8hkk84)UvY1TaGAbOEGMv0iRL
zyZrKv(=0tyiR0@AFbvSKZcrUOcP5Xy`sR3gzK%lzhK<zt*Q)4HA*gNlXy3jrqGv~y
z+`Znr1d>gfukN#V?N|yFO3@)8hND~1v3vRxRr1A}c#=rc6*?hniQMY)?r4hM$sXTZ
z%0<(O*-opA#S5okPZjXzkB_EBJV!=h<tR*wq=0t2C+YjV4G?s4Oe5*zWJ4__$VTmZ
zbHJhnni=|c{*^!%?0&H8EVA`T7f=9@7PlR_&&ysw;iRXLkSCk_kwpM+=ri>n{Uy^s
z*;2?^!TxHPljwu=thMsTB>pn{QdNW3{{VylWg3H@{{UPoGeE$QJ!Ic484V(Kxe5Ab
zLxrL;00(3JTECt%jd3FX0OWFT)kX1U$NvD^iY@HZH`gjK{iXKu{g={sD7u~a1GapZ
zU)S}2Xt`-*G{4)}X5ZpTv~{WgI{|*@pVvI5W}ZesD39}*b=qTJPg4zIDFYc)`^Qsd
zU6iq91W+gEd}mG52>OOoMU|^=Hq8qRQA4SL)Z1~k_|swtq^hHNfUS>gtTAbsnY^)p
zXm$fB3`EaPC~GQP(<mbG9b(i9DZj?Iz||K~;>#ceMH9B5plkphpDcn%N=8)=-KHRL
zPCKia83AHZ-P9fFeLjF<$V?!>fPe|sPh+tB@*(<pncRr1tp#mefXBG{ZlE_#y67-E
z$9=c_@^L{WX-_q>oj~lj>z&~Un0eXBFR}IQ^1vsiq-mv-OAxvizV>I88Hsj4i>a#n
zj@h!*KaDF{Qo3Vh*zHI4$aN9PC>=zpqAK#&;4;E6O2yfU++JmoORH_9Uv0B*Q>4jg
z!nBSBZ&{tjz7CKq)@1}ePqJq+^y)!35z<GuZ1&@DSIlnsIr2YeO`?Ae^rP*5`SiUj
z1xhB$k6i4<ZNqhEvvuqVI}yfY>SX|e8ph(YrRqwqk=!4adEHM^AwupB=Vd38n;C3+
zuC01Vi#0Pg$_{ulO76v(wK4CH)OAlQvq)^6tI%eBOLl1C3+r5Bnj}{k>~Gj$=V7?~
z@<>pczVFXBbm*X43ZY{2JW-njap|6C@h95e3O7Lud6-nJI}iBgoS7oAw!2$U^Zx*d
z{?`8h;ypm=;cw_fdu|!Mb00;}zf&Sd8kQu`9;YYMK+;GQF6Tc%{u%oZ`6vfbA`c!x
z<WfH9_0KkDZ#$P2@AlXBC)q3ZXG$X<e2bC&J%)NZRE4qS{?zsN$89SO@__#U_wD{N
zY|IYkq+w*A?HQaynrCOd^OP~-t0I%B{{YL=*EsbI%W<evS6;b8%0c_PF#K{xA+Qt!
zZ@2cgHn3Kd`M&V@;UqeZsaRjZumGZ<pYP=Q9MSe)+B1EZ*TvN(l?_rT?lLO6h&v5?
zA7;SH!q|dzoiFe2l4E_DQqx)7KVRv3nEI}rCW(V9iw7T^_`l$PwU#p9X3ZhhdZX3B
z9)mvDY~j6nW%QhE(UOrYgk17>-ye)ueH}x9JwGhsz#C(n_LqEZ#A$mR93=&iO=8)0
z1mz!#z4KJFhCj6sjSMV>+l<Dd#^ap&9TCsdXmtcQ-#k8}rjw$RL-~RGt=Q)#d{YzD
z>Eq^!j*qeeLDNI!ocs}1eK0Mi<8Xfr;z1<uobHl{%P(VHvowI8Y|;JJ0kg>U#Fcdt
z0IT0M+BX_(tm<~b)W>4RdG5MSdhWMrS?Bc;kaOlaxIMeQjy6rhHg#dn&KF=-_$${5
z-#Y`b<B+MXvUhpelunIpv@j#odYlDHo6N~3lShowt|(udy=O&j7HPF+tY5@mWRJH#
z%6OGW^AQbE9{1dQ^YUpTZk|?&tw=vZpS4DGup>Sj{{T=whx{I)e$as`Igg&dwf_L#
zeMg~lrndGk;(R_+`3I-P>+jM#!hgd50BL_QAM(;L57_ZXJ^55H*3?66;<mi}<D%-M
z={ktyx*+fI_0Q0{PNqJ$r%7)03UT`9*;Zc#dg&=+HMq8q{{Y5Z%Oqt^kaqjXbJ1|Z
z&3TjY8Jb9e0YTWENOLx~<)6o2!^_fjqppCeLDboM;T#Re&bImI$jA{Cpj{*#!R3B`
z9R0iPf3qO_TkQGzPN8ik6iEKp8-w-F#{SUgB<McSm!s+-D<n=;fHp6kkAH4?8LrUi
z$8E-$<c0b<0!U*lr-gk(vE*!d81i*;%2HQ$mQkjih1QWlX!0tsMvv4-QD`!-Bg|;&
z0?D)RIVgmMSkOJ}@&E+w^gXi%)0n&_siU=K`{RR0df5AqmQGjxsN0^z{&>kLa-u_}
z5U8MNj^zIUzkH`r)gGaAx|5(41h<$D$}hFqKDXNf2w3YHMus|z9@Xf6f0j8Am{Uum
zN=XLnXx{Gl-pKi5ykR4a!}z^9B&V1H4U5~i%x{qn<pDC2USOVt^It*uU?^f-g&?;i
zo;~(BUQKbmy#Q@ejaldN!z#$NBZbu<y_(6s=YNgkSdi&DKv6~OYwUiWxE4j0KeNYD
zUOx$>@bn23KEN9)4xqem!8hC-i**t*fEj`iKnibby87ZP2am%nqT1Pr8vr|Z_1oc(
z1TxQ}IMw7N_-KQ3XK_R0`QUK97R-!Ta9YR%YWDbI=nn{Er-A?{aa-TwKVt@xvOH?q
z#n&Hu(;b;)hB%1~%4l#YciZZ3054BZqB0nOcMEs76g|yg*2so2dWj&L<X`&AK!QNw
zq)3%hPV84*kSJ|k!QW~bD*m3J!~%9z2DN{hz*;1I{o2D4KVQ!b;Syj1X&MyKA+KP0
zAF+l}8F>O0r8c^`)5q5$H6wXVpI&PS*!@J4#~U)jsEE-f!AS&?Nv+BA9nI}SfH5_w
zjg2vofT57-72H*CdwO@m@%U;QIU}a92s(@LwRSt+_4OEtj^V$kK#XeAK0o5l_*XAd
zP%{@}BNJlz2b=u9cvq>?&Vtnn0p)75Lw<QAWQ!RjGH5g?-C@$NE|40Du%K_hY=VHt
z)3=%?-9aIa<n!_v(<g}vJ*hxwsL}|sO%CJ%-1>p(lXWsKw{i(P3i$GVKj#&RbquP+
zn`UF`Pp_vK9pW;fO>N<`UV*T&!T03nKxB@jMp375OI4fr`+H)77h~oWZigP*<6noQ
zhG2NFUVfManA|fKeM&}>H?#h684&N{d5s(2ZTG*=D5QpUVg|;57e~~6ImsHKq}Lv1
z`SJVhl?9eK-<Bas=Y}1>TyTg~w}`5CP@DOOui^P;O66kk*%Y<vET>Ux0)>v*H=;q+
z$o1dnfm72mC6+|gf%LNjW49go=M_T;{N|NtY6=Md0K7+#$#f}H?f&qfA(BE-z^g-l
zLq`Ca83GWjgo_7pV~Q2-Irhr+k<Zh~a`f^<k}jl43Hz)pAAUi>)JYRdG>Z|94(S^m
zepA}(pMPwRmEw6?PwHv`P%k36`E7+WNb<R9gF2E+3$HO8oTMEpP2vWWMWqWVaX^qa
zUybdPGP}bjl|@oPWffw$tN7vo1Y$!>6||MVpZUPAP&_djlCn~P<>S_`+V{ySnLOmE
z8!0%>q(nxF1lT9v0?w!x`e<EF);2tL_QD-q+#>`mtL4~NBafiOl>)wrG${je4UfY*
z6A+a|+War>3q;^p3)kKA3+DodLs1dw3ZNbNHMi8>NV1pJNkCSRD;<Pk1re!6;*RIz
z@X733fVOtC#syL2P%MO6BJ|ztcKmDF@ftSONFIpgg=0w*D%BD;9QPvzsU$)R22>th
zP1qg)`SFD@P$6j=Q1*1`yEj+HK-eTuKMb-4kz5)rVAXzKhIA~6V1#ufgM5v-{C^Aq
z9J0n#Mguad0yN&opU*iZkc&{hRnv4h{{T3?L<ey9V1Jx#QgrG-U^QCW9({gTLQ(<&
zB=5N=-#Wk~X{$dSuQ*U-D#UIrh~plSWN71W5lN(OK701S0i@E$eLNpPFZ|~_>nIq2
zSHCthn9yY<TK419(-pVU$|$zP1HaD-aC~PiAt%!JyhaoU8+ILz6R8@-`AHYe;;>-0
zs8n%&xe>}j*&r75JYd*)N{@E*%9$OIp+sh27U*C7`{K}zg1wci*x&%nMJ~skhWM?e
zs2lQ%tfZ){>Lc0MZlLTvzbr-<y^G+1?Sa8q`B%8UJ7-3^m54iz-nd+|6(zN70-gOh
z#!x&euRZOy1k%abN%qDbacph13ilrz;8+?v8?Rczf!u^F04JN{097fFRRg%XKTKA3
zat+X`+Xx!YokQzcz>R)e1GZ7k=Gi>J4b5&dl0q+KHY$&70+bWD2WuEniXB!zJPwP@
ze&{x9as~$^@pL@~IMa6O0MoXU$?fZkptmFeTUh4+$D|P>Q5W}n<FsUw@)bY^svZ5S
z5tX7VxZGG2HqMYp-ewE~Z*AWJE{)d5wmg%WG_4g2z{O<KLhO2A8!^*I05Lj=s=T5`
zvKsM{Js`EPJD)*A6*S$q7gvi`#`oWB0c0Ip;{+~GYTta|5CRUMN2eGUy>1TIfE4K`
z85oBk1)?i)dCZ_v*awnFd}JsC0<6q<AmC0#3i?GKf!jE+t;XPOUGs>oxX#`}7uy4r
zgXLwe_ljF;vMBM4Py<BS_Rc6%V%zdY_zfu1#A?-hlanB?BCjZ_C8bi#+>we&YrniO
z0*#Ku{0|tbWRavCAQrvJ7(#gov0du}jR9Lx^u*k^sqKze%W6Rv-#HbA`gc4MFh2LJ
zX*8<Fz}EDA`9GE<T}Oljj!Ur`NbEQN0K8Qt2x(oO!KGey;_~{D;CHVLKmd;C0&dJu
zvK3U6`G=?#u>JPPEN(i25}Nldbf6DRZmK(R;iD0xR;{~PKMYA^a8SI6#dck<0?)Ln
zSzLkiym{tU3bIB+l0EkQ)=?*$sErw?X+(P}`T#RLy;+)jZRi21j{|*&*CMETl8-<r
z2$U#s$N0$}qDkg*btrM9fG82^Sn~K2JA)y$S{gvy*X70m;{O0H^(bQ(d!b$E91C?3
zOVcz`%RyvQweMUU!hnecg;b4OUTuiWDu<C#$^vc9!o3HsW+(ZH%e<w<`wynr6<(oT
z>QxSTvQFNc<zr`yQR%e4l04p=Y%&^cilHos)-{n-eLv1L-DAfTutvZM4x$18PWMCG
z{9reO2%M|3$24qgu_xuQ`1bFW>VKGySo)czj$KDW14V@ay>CO%`(|k6GRWdhE2wEC
zclWF+gs_4*%AMO$>^uHP0R${Muj(;!_5mkic{TOOw6nEz>9C2&9>neXWv58qo*yVc
zC;_?KbNC;_3<^S-1(`MrTrb1sa3oq=xtOp79XGk-HB8CX%)9U5fu_hDaeqNrk0f9u
zOB`)#Ltf>3b~v&b5s?<eXh<wCeSpB-)h7V)Kn}l8CqQ(dXNZNQQWSHyxxVK-&jVYk
zvspF09fkVluNzZ1Soi^BDo<iK?`Qn`VV-XqQEyO0yMe(q_4dd!OALKaUOIS=q7I$5
z<J&u|jPzY#h80(lSNfVxt0#U&-?NDj(<>N}Er!60tHaYgo->Hci3k7|KVR1<JsZf~
zKywbEb`?g)y<_!F{LGIxP{?(0TwU@j<J&9te^>mQ>nRJ@9wO@m_Soiif=;4g81qS}
zY&crjU?V{zPOh<)L=*uWcm13pCXxdB96g#eM&92%tkQU8;?}^0qTuttYzYsE)1wRV
zUy*lwVF}epTc!~(W@z|5hwt>sF1VB;ljhvl!!II9Aw4^tAx(H-*ww-K_rkG%NJz1x
zpc}rr7CZXYZIMgTA=*=@9aXrizmDF#<x7{GJZcaW`_H+*hc<h9W%^&`8JWJ&GnCP(
z7BCA){kJ>}!P2ym1z8=Lb!riEF8wdxD3J{j@YWz#f=Hv90(kM31%zYo+flzjdy`(6
z&<1%B#v8>@O<&&NZf@|iYw5vO3+66p5^V52&ivp)L`h37qGqw7PUf%IftMXTa7(IF
zD)jNNMy-i{_3PgjXk>+862fA6Q&4gZuqLc~Y)ARR@D+2@#u8m8b~k5_r|$3ybn$p$
z#HcK5DMW$42e8R?JtD)?e=^f4kdje9xY63jZgQPZMx&{c6D(+8k5N3{!1M9rI%iWH
zU`%J!zHz7SpG)t>-bH5`q$ngT5si{JulJOBP?6!sXd7Tg^}P;%Op%Se5W+$cT&r$0
zjjp|M;_3jHvIJcgLn_f>To3VtP0M(pq(^E1dARsi36e*UX;KzW3FOzOwpL-{1EbF8
z&0yZEI}d6YqA6lpi~j(p<~PmoYXZGI<_Uk7m5TJ?l*ly@0|0$HjP8yYdXB8LuA~xL
zh#^Sr$8Ux*%oYaLT*k~8i#xvipI%RVSbE6dNhE7|NCGt=5S#LBU>TQ6Ye??YSOC?7
zTmBx|C+VJHJ4xY$R{^Vow!ue#j`>;9{8I@b#DrX&*Rc3wG;PxLl7BNCqCll|CdZEc
zn;Z-f#i?15LpeKc7%2E>q2Rn?Q!*;(1szEi&PDd^TmHs*;UxZHo;Wl`9cm-|4AU1`
z;dryp8J04HhH4~}!5;U|wc%O%kuOpaOswm>k-$^vKAF7{5W_0M7>QLxWq}o2+2a2I
z4sS86vUNkjQmWcOP!IPKFMnTrNnFEm#_D`B2`T}yJq`tWf)aV7@`R8O1WG_2*Fe@z
z8Jnci&>dEmYqjh}^T+RO+4h7k-)XB&GRl*Ya@k<yjqLZU-!URG(m>{;Ey>t{%>nYl
z9aODN3`~KnIt{DfeRtpElUXBIky<K`Pjh?v{7z{v{LHdXq{i|vIumUo{XPKZW|d~0
z<F+d1fo8BPjr;5{s|J~RHdK{~V@-8nmG$(h#p(o2{JO#79-*0pjjPB<3ZQ!IZ*z7y
z#%bCnjzu0Mj<&)@wW_KDy>`f?20`JFRH)lgtsU(AepnlN7)wmL)m%*z0ktegeJ4@d
zxBcW3r1AR0B#vVgWeuoXfDZ??(F5b13(eIvJgycYK~$ex{aU_x7l-+Ns$no_$-R`{
zhujlg_rRxCo&%k6tvZhnzLCunT<^Xa`h6lJ1c0o;R0Fo7$?wJ1=ltYk=%(r2BWOvI
zRMrU}+v|-mko18afs!UM1w7T>-rJwv_zl&=)V%L3%!XrI#zvno_|U)D$i&k1Egw$A
zD(bH{1AacEoMk=>Gcy^I3bLbVDA1$v{4(tt^!-aK^-;>Ms$NwjSRj+Va1O`ci@;Ut
z<d>m!kOL8sJD(+A1K*F9cTodDJ95%VVU$%0KYGT%ayC7VCxxe~Md{IkGKm7Y3<)D|
zVa{D+ktKMck|hOYjJ?>9D*3tiZTMhwA(y6AP>kwBFj@jI!K`n&;BUa=(<2{E)Wrz#
z5UWKkDDJ1fm)DF|B^4yyL!ejGNGD(b{67PMq}A4joZpB5cRTPsX!~EU&hQUP%_Qig
z{{Ze1&A=7k@)+_?L}?RL=?gxo6?c#wfg_Psu_tY^M9Cx(lx<5ImMCj#vwx4&oaB!B
znFN}PH<`#F2Ci<tM+2F3cyjds6p=Nk?RHmxnEGV^>N@#4gEXKtajPE^!78GF2jl=A
z;}As$@{z|WCEddkynsJSC+G0o&D2fQGR}25i^!rt2_R7O9{sQ#;f4<uNDPXAmWng8
zAnktTbsfF4A~UZ`2&SQIppdEwJCo{o?|HDRM=V_|=28sI8a3GJTL6-IHhJxt*ucFj
zhb5+U1bK9YEPUHnxB9@eJvwzUctKufk%FNVwtu^B!q{(P@!Bd{D9Wj3@Jg{}0C{h3
zen7{I$c`k5+BKq~fu&(Y`dP1rbS@>0Ov*J$r&Gwp?Wlrmd;1>v57e=oCV{Fr!PLs3
zOO|85!kiDo2DS_#3RX!Dk_+h%A2w{)Y8U`55J?^tnVW^ZL=aAz;87R<0NoCIE~e^G
zIgkZwX_%<;6LrTn0l=e1y-`Uucu0y*BUj$!S3KRH_?`1JJ4NBqWI!3!+hWzV{uNwi
zh6^-t#AkxQSVO(o1%cbO3OoCp&a%lY0h;A1d^Oa2Ump$rrz$jb-4T_U=Y0`L-9@S%
z7RU$R<TlF0(#O-!=72;ej55haj^$|XXm_ukN#T$K6qRlLVyi_|0ln4UFY@xVO&l^a
zs9@w-I*Vx(JzDSRdB8~=bv;3rL2cAJvlOZ}#_zE8ql2RoO0MSFV_yW&*>6!5?{|fr
zj8jH>fEC<LL3FK+Tl;coalSf^s!y|I>SER-)MJuFG_|<^`jbcL#zhDZPoq~=sRJ*D
z6;p6(te<KIyYG_l^%Clb!Hkk*HZ_sBUt&+^jT`jo)G3-LSWHC%v+5!0^>MH*e<FG3
zAE@cp9;>NWDpnal8Z3eu$ot#&@04(ka-B$?(q&~ORcNUskC6ts{css&>Sbq~c)l;5
zLIrF{Hc!*`aeAJg!SEB#$ubEv4#b03zZ`GrXVhUcv{A|6%SJ{Tl&v<$W!tv~y+HK9
zWGT{3DKVGn+|sVCI@5a8J|G(Z09pE<{+TL&`9I{XC#ae14co}1U#IWiKPQlhWF|6v
zI@mJ;P*)dRduQvP`f8>>;Yir7m1!j_e49`&Ej+Nv@R!kaqM9;)=1yva03jx~)PFq5
z(jPo@f8=vaPhJS%1!H;8;#;R6EOu?QKj)QtWgJ(BnGvZ_^Zg=!9J{qB@BJmf`A_0X
zlddAb15W<{A(?t;43q1PK+>U2dvbEWZvOyNuOvU+p-176=@`W$cy3ED-`gxbOn(@9
zYZOIU=BFx7sy<_g@dt!zr6cb9e7}6;RwA(nlF1{tBPfW)RpceKRSWI5X3J}hE$3x1
z#tmuhez~4WpQ-99HPR4(3Z8xQr3O+cu#ZtHt?<nqG;GfrMglWwO<Z5DNfDBE?8LeT
zW?{$!b6-r+(zId~MW-`DES?3m=2080l8~o<G@dMOJ^B1Gk4{zOi&B#uYIYm)4q`6u
z&?CZ&TAyRhg(P8##0;iEtjKEbzD7gfvjp)qYbQ$%apHA=>YgTNJ6P}jGOP%RqrRqD
z1cgZfNxy3P=6M=Pp{W_t6az||u6WLsijzCmoqu<W7md{QN2!gZC6+J-m0|MREF`f=
z6U<j{hhdpmf=LHsmzl``sRPa5jLI#xI~>XoUX_<mVRkd!=z5smDCFMUQTERT)b2po
z=FWyk>BBCNMPJW1Vz#B7f7R)A9YBOLx!7<$bHwU;x9S|1C!M{qdd{KdU|5?Q0gwT&
zeClm6+nf|RIBeAuig)(HIGs&Zwo({P*K83XEk~R`X!X(kkJA|#Ymv4@zEAkgIWG|%
z*xF(|q4vkxtM*q<;iG@^E<Ba}p65PBINn#(NoH>6*E&fh>pF&(Rxa*rlicUi{{Rbp
zgZ$+FG~%H{WcvGOoqNsY#ghAaAHv^Y1=H2_E9FuODgN`HTm_v3>1y+^>^(D<FpMce
znx$IVN3JcVoj?6GJD%=x#A(TC+`2=sW!wJ%!LRF?<~*P_Ke@eqvXi+*)IawdZhq*`
z6Yc*1w_y7dqcX@t6XlHw16%z2dYq(2-gog=@l=0d#;~K0=A}|mLh1?VNU_QN?V0}o
zgnx@VpS65mo2+nWUp#C;21V`-cOS2|etq_bRX5rlZ&No=Sj!_5Y(;=CZ<pzmif+5?
zj;p7hG%&lwuBV+#$Zue4e{1Y>RNK3w+l^`aGPT$Zx!p+h%8NUi3jB{lo@dz|dVQ<*
zd|gUV);F*1aj_p<-y7AIJnX~M-!??;qGL;4f?JX0fAf?!pl@si5&r-s$pCLt8zW}-
z9kPhKs8eNl_a2#1&`SL@k;@B^%5^Ia+4@)5A8fDM-5R?v6DX%1{<-<oaUmXC7Hk~#
zKZoD>ey!PM&=d<>=X}+colxxJa(%06d_L+)Lv>B3dH@_@9{QN(Zk^PC$ORtxux_I3
z;hs#-e($P@?HVuww%ZBxq0VsHw%Z5<rJauab{Perdx$R@bGnY5I><~i5-)JWka9gU
z6_BrH7xT?UfeJvZ+YuIxOI^2HZXOKrKSwc!ORmjZFv!TtG_8?*A58i=VUMbW#VD|Q
z_a6D+bv-oQBbenLU+r)<Z}*%T@J)NihkqYDU$wlXMxo{;S2f!Mu9K*4zm`)-VW?0b
za&d2M&0k}jlMc9)Bo-+~Wtu%ek~3g6YqF8XO_q%v!S9@Wyb+e4>gmCgrgZV7N@~RC
zHg!>HCWd4ngP$#W^v<R2Qrmzh2RItf8NqhUTLcX3?smhK18jKYDT$qyCq%~Eqmygw
zc*g3wSiaHeB<ZFWjtKZ|&SHvF8(HJuHODUCf=|A6;mt8IX!7OFhpHwe`5)UKWzF_a
zUj01iK~u5pM`NCs@aNi#(@Y_mkA`+R_Fu-oV-K}{&OJ;@4Db%$+`aSj4NU}q*6MTg
zKTPLGClp)mJij*eegyII%twjv{VM5vw8eK*>bQ>xZGqX2q&|l{&*A?7w9i%31v|QN
zea3pPOaiUxZ!-HF_2aw3nAEY%x~<3qQK$Af@c#hE{{X{F*Yxl9mrl3Ubm>k9{{T@v
zN2wo{ee|F(@dyANoO}A_CP1XCjaqCl{{WE0#>kyZ@R?bO1f+j-Y6`RmY?}wvKKhyq
ze3B}^5uU&CKiG2pjrOeZtZw}^c#*$gq=97n6JH$iq#-9!8#Rx+qqAPZ`}{^|nA55!
zaknW(ia=CqT_F`ue_wy{bDYA~3dpS0shhFd&3tbZA&@ax%N{m6gM8z~QL{9tvLg*G
zxwP$k^WU1nxR~{bo#YV)767tF`_|sRxB-Z$zTn+*zMsE_c9%Uflnvpb4BPCib|02Z
zXiYlxl1*KCKs*ua-_y1bVhl@=LX}d?#P;I8JK<>K@Q5XpkQiSF*biQJ#_=1hE7PGx
z49K8tfvaJB4(7@AInB~_5KOBiB$iJQ0&dc-{uD5&!=WQC^ceY5oA=}6l++cPHEM-O
zI)a-ZY#R`gs;WraaHqch*!?Dw#V2B`qz!9Eyug!0i#2;#?Sv=u3{ZgHU6d9#q*ZP5
zq3w%)AORHB5<8YY-k9>oGD2iwAO!eikVP80^!3{oIZTZjpds|=1W>!b^H>cbiMn_K
zyRiW340cv0f$dfEynP)xDdHAaf4usE7Hr*Zz$0$v@GMQ#ZQ+xmkSd+*kH>Mxz9^0{
z7&6Pg<45-oLG!!`!h%;J-Bc=;^K#z8yXQvCpn<rq!;`jjF&P=O*1)#(IQag~T4`9j
z0zqI{6##_>s=yz;uoF>}`ixAEBNMkE-zPXrA%$Yn94i*89GdUR;C?yDCxkpQMS*u;
zh6tvTH)66C4QFF@f38Ir>STGuwV}fTp*GQ6SFqZ>D*_dfm@z;<xtJ5j!{PYi%cEZ4
zB@W)$(&>(MQsKOyh8=+ywg(_;3`s`h7UR>7_!zXh#A<Zv1eV<WemL>FOD3WHS><94
zi!8)~KEJ+l7Qhg|lT-?h_!Q~&y1Z(o%Zu`;y@4n2ys24doCzQLjth8<dwb?+=~~-*
z+%No(rZMw)VZtT<0C&vpYbYws5}ISAX>GvsA4>1v7FgaOzAFniw{b++KAYwGU?hTQ
z(k)Z{?RvJ2M>aU$ZSS%5$VjE1&E=uF^};C}N*F!bjm^;7{X6r($s(2n5H=c(4mih(
zMGK}vSx*c3*P+-9;;P}B#6-0O3O-|E$LsR?fJM0304*UPDk!`6{0G++!KKg*0lk~w
zzBGkXg<!y&2hz6N@%iNKpFmwig*y}RJ9}U{Led66$~38F^LG7lC<_!Q_r5Wg!z!z#
zgV`jO6<xnvFvNO-$b=JKP=C1C6h6O(6d6KIP8b2c!+%k}8KMeR(b1KGI!UsFalgJY
z%OgYKmjzX?N%s|hfX;!Td00%cvi|^Xf-JXUZ@0D(B!Xm*#bjWbfYe0`BFF2KWg?9S
z)!h2#i6NE*GDyyZ5#g&?EC}Rwt^WWVh;ye=u%gBK`rs*zqhK^118F_++O;b-$XtU*
z-?jd@5W)i)1M2?JydC$ymT*QeuC|aNCai3B{O~4D+W|+{Ez`!PL{>&%#0mz9zB?ao
z*};+*VWq<ZS{QIW@&>4oLEn4}24aq-RIR8ZxUIIt`>}usI<_OzDQariD-z7a18RE@
z->yeXF(SpNzHl@v#_mNjqAh?9=D#zDj2b3u8u%A>J;!V$%L}P!EohJ!8ezdV@~oQc
z^Hr5mM2-dFPOq^o<s*%@C({>FF{cH#^3kpHi4rXp3u5h$KKRkZ##W7_Si*yL!(cmn
zcH1CW+fp=bxI6FaJ@Ab{2N8m&%V&$p#o@Gr#4Zx|Aa7p}Ty|w-3c9v8MD1S;s8iV3
z@{Y%x3Jisg`|t3_R6;{|iWigW52a$GC}XeWM*!ee(fmD56+uy?0qK#VX+z$lxW)=e
zA(-)E&py~=PZT=>s=9~XBF8@10Zyj#+t{Ez@mVy05BG3zf<Y)e+wwcs7t{X$FDc+%
zk?nx0<qH7BDcFE&@{vfe__QsErTF^fq^-1e^&H_~Qmo$Gp4kIAwM7#W0J^H9`|p#Z
z@yf{|m;kXL?@BX~0t2anlef6SlB80ggH5`OElSkGbNFX4P*<IO{VxG5<d!FWiMu#K
zR#lalwSnqB_Hh9Tb6#Lb0P%`e^)ijHrj?SU3|E6kwonJ$<9p`+08AxK0uQweHVTjd
zvAI5(J;nn(WkQ|B_c?Wu<Belk6&1)VLBFr~$btx>PnUi_-UXwp$*XOvwg)jK$kpO{
zA6zKxEEXUgu#YI>pPRk$Lz7pz_c;M2*>}`b3Le;lbG=qMlTjk-`(o+6fHpbG2Xjl#
zcFNXlV-Ui|n$!4VmIb#LfNNc`6u#KO$&W$30Nr1ITE(RRcJ{zj14rwSb1D18Y;%hg
zI=~7J+1JY7!yGoKs)=jZ<sBSu@s_JmzZ_st3IIV2H@{p;Wo<W2oJ)`xlU!ZkHo6)>
z9>%eCokv*Jw%gVkFQ<AJR(oSf4xL0ujlFDn_rO4fm&$h;#1-AUd*CaiRfB$q04u($
ztOhKk19!I=nu#Xp{BWukVpoB^o^e6+QGmn^&c?86U8>ak;SFHlC%!Eb50tPNA9>N3
z+E8Bf)zBQ}`bUl7mN^xcHS=j6i)OPpj6}i1l6#-ueshcmr*|yI+l40nb%2t}9T9v#
zFau%V-v+SJuzD0h+j_@`sgimN8IX;_uE3tzF9J!7g~1G3^d}eZfqspnWMndxGIFF)
zImf3!1dLR<-mC78)%)#{fWJ-Dkk$^Ws@!ex%_yrI6Qjgf&zPI9h6bs>mW%B2?D914
z_h=}gMBe?c@XT<jkECP@T4@M0lu75m&kys;>g>^}T{T2~?f(GY2<4JVbO-Q~j=)e~
zU9ty_oI>6x3dOf4x#xV~h=xW8#RioYM&xpS9@wH5U2o#DG7XD;;%|;|j1dM_R%s75
zZtv&sfy}ba)VGNlLiSNk+a5n5nb)JfulkNzB4QbU*zZQKFFVg4QVS?Z+#M~zBvt;H
zk1Ro)MoCq=qxX+<_~1#U3Dq!VZEI?4*V6s6onMMy#Vk!&E_~Kb^ge%{KwRupDy44P
zO`n;|${C_m(`X4Ouf7!}EbF11FE?BsZyrvp#)2ISq*opL*W-beV~H8;$yPVnS9`~T
z%xxrak~M~D0$mFNy|*I)5mAcD14akTpIp$>$qE%+dK%S%YS-=08JTBDU87{!k~MO8
z-iFz^r-eFKXAR<ld@;biuKxfHz3?$d)Ws>BX=sZz#Gq^io=NTaoRR>}VJgiMk2M}m
z{`+Q`$}dt8+gph3h#VT@j^3D$D34Ev5~h$Xd%nckI1oh%Ba^8#?5WM0_swv4QA`>|
z4w`u+iy&Qo{c}7*Ub0fI%AnCDj>F&aKU{YRMzvbpCAFXR*!~z3T}njCgrb|Eemj1d
zSktJ6L;=<WavUgew%zh+Bl!A?G_awvRdyes!g{6ZXOi5=Tgs)kHQRrMVI1Nq8H|kX
zu4qvA=C5uCIH@T*5@#YcHNPMqOpFn`FhcE3=Cilc8>kFOQ>jx(v3}T9)r@o6J)osB
z0kGQkBj=QoUZcQHmLnKREcj>!`)p6X=X{(~M+6`h1ZvoVOE01Pe+;2-2dj;ujcVAU
zxHkNAUA7-nfsQvUq`Eext@UmPrdm0IHo@(N+iq{RED9g35=e-Ek1zz+=jby`z)Kd6
zo;cPd+r@EC)HlCwb{H8|qXn4R^H!z%r+@p-k?p095UO_b4U2yE#_HsTI1oZZajKW^
z5$R&;zdV+$5DDZeuXe1zko+($I!qoBAru!#0evdLzWG=tGKP)gA&DW%ur>hWZL1(r
zW|BD=Hjti0X8q930(a@8Lll6uSrPr%_uOD-XX)A{U^w!CMFKs?_`@6_gUF?{uXf(H
z$CSYl{+EW@hd1{d*U(}g=*Ub|s>@UeB;D_j6zaO4<$O2YC4Fjm(*4QX-;B=6E@&(Q
zTsFGgiumTpde(vh(nKCK)TK|95$R%%OQ7mHczV{5NctQQ-Vxk`=ua3A&?IUbTlgp}
zs{^~AOa1eSCsQmzBTXJ4Vr-I1l6m*Oc*KxN)kPc#ZI$RMn;>t+cK6LP^^4O?p*nV9
z8Xy)ZKXOlV+kC1;F94E9V$q9H;r43!`((N_3jtFVu~6WvY&ZVz-+z_`R_c~l^M{d(
z_-cHr2LAv(usm{(n9Q*{hp+%sMMlTzV}E>sCq{^wd_u=(B)0Yc0DhjCtEg}N#u{QI
zidDU@>T7RLOqpZUbjoERKmt12ii<Vtcj<w`KDj|+j9E|}h+*8}6qaaZ>0yF6q)w&e
z8k+WX{{T0WSY0}&=-JmnZ2$%v6X<yP<mO{MeJD~@v}peT?QfLobONZM7|4N{$geQu
zDL*VLD2h0iXVa(;Dvf*IGe1s}EXxQ*(`pIT<^zNC-zrhn6$B*ArjFbJ+<WtyrD4=U
zu%JyWL$T1dr{X(cVu4erD$_`J8bWt1#rxx^gHe>UsL&1HlEfSNZTVt#00|m6O1UP(
z6Gpxx{Nwb|K-&CJS5VT5Ilr&@!Wqwn(l3T2JyXAo&n<4BK5p_J8V52nc(g$v9gf%Y
z&qJsHA#R<O<ANZp%(MYz^9}v~04=?<$|6ajjxtg)7}F!BpD-KOuKoW2E-*q-Gd!_N
zq*^B65O&-P?ce3;f_v*`ns`tnJupP$-{r{5EJ0MU)dRAPwpA<5{#EPr$cO@{@YvfS
zB!6(D+;+mBrk+^RIr@1RO3n-Y-UWa+{{UZ>I&|Ghib!MrT!{@cZK*djEbrLy`s7!l
z>R^mXdKLVqSCvWFk$%FyxO^vyc+yr82B%<eZLD9&^Y80{89Y=P9G56U>eM|p9{&K4
z`Q>5~)QA*QAoH>NgOk6w`0a}mP-$F<)vcqyH3De<AC_o}PM4;RK_Po!Q^Jex=_)tW
zZq3%!zo?;sj!30w7^5*&(xvO$fPTAWAn-#ejv@eHK$CFid%uV1b6;5*{#*KM;PkZ{
zdEZk=SdbXkalaf4#nhECA@iXC#%p9WHs;OlFXDZ04@f0hyfT`+Me+wA1nyhYj1&I=
z^7HCq>pGJ_?P|iu)E~rU%Oq{AYwF~d76pkQs_CUPJvp!ZeKR!BNT*zbU2s&|hCA2O
z0*Mky5s=8OYEn4Yb|mp*(#?L(8h8LQy1ttxJE|wjM{hxYA(EOY;Ge=tG|vzMLBLaY
zr;bPIf?lD_=+3Dj00F6nmL%%j{{H|BBS2;>V+$fetaYd+l{lm7F1|ZtgzW{RMxe+?
z^)@aCw{fu>W%_B^+EXwJI)HX8N1I8ezd?2X0Ns5t=+g&^rq^pzyKqhY0r(2SuhI1p
zX%8$!_*bC`+1QXkHQT*ynjfegKUVQ|3#u9XqGKJ60k>rxiLZ`HdYHO?o2ZFVq<I(>
zY6SoYdvjo&jn!{kiteUZ$4vBq2|#s-6GQ<;w>Q82U@uJ4{{Zn5EU037xKu3xU{@Si
zt@+;aq9p4+*6KWGL8;_%sM5&RPLLOi+m87e5_w##v4n3c7}Qa^KE3FEJ9f);5yKDK
z5y1k9i<s0ckU?OisV9myykJG7kjpPj=t0zWEmVPbP<{fr^z_N<X@fEVojQXO6Ug6C
zP<}i7{qWB#G^+RE4TuWbfHVQ~d;s;%>8F(^c~!%_jP?rNk+CgYSHHFPz?(&?Lr7_q
zIV9D3o_%)TEFz3_eNbS_Fp(WWAO%xuc=)f!d;)0#q#{ISpIITO-PLba1%cl${JDt4
z(g?b=Xw0%k30fsjl<~k(#s+OA<&$?65F0Mw3cLRR#8Kbd=bR$x$_0^_GZGAyw;+B4
ze{+H)oWmsQ>a178plpGsjr~SE?x$sFmNL{d?hgX&@5uG_^}y)kmHbyz;v@@AY!N^L
zhTC7Ia&X1=e^u3V-XfJ62vDrrKqjd6<e$Ugfn`bh-BWb>Ad*w8ML;TZLiY6M+V3OP
zbq>1p6nzU;<T>1S^ylSR6?I;prAD3<G9deai(taTalIPnu^GljPqW}2G9+$m!(G@Z
z=Wmd{J62ia>DppELdg0C=E(znJ9_{xxf^$(8(f|!s8!t5VM7?ymIMGs^?svq>sS;1
zRwQ)r+Arz{XATKbS5yGKg&(FTT|fT-Gpr(MPy#9f0b3**=j)ma_!C0?3kW9B;kxN0
zgQH6y{^*nVdXbYoG?6p(@=F<74Cbhc)$6^`CWkgKGWbR}S4Cqov0cr9UfsTVrRM43
z=~Jgj!^^E4yV=|p1Rr7wp8RvZLP`8a@e9r3fnau^J$^*u6_sSvt^(@v5-2~<>6CgM
zIbNHk>eHy{%LqdjAcZkG8f=5j6URH>W1p)3004QvgZeo_Du?k}hyMU<kJCRLa~y9|
z2M$Av;<n_D=FhL!KV<$4sQ&<izRXo?2^@+)^8T~$_-0h{!zaP)z|>dQOCQfDjkJ5&
z@XkUe*lm78l~cNp_`~|<_ZrG=Z(;o$tGOY!{{ZQ)%OFXo^brhsKc^IjwuQtoeDB+l
zMtZvp1<^l2o_9_g#CAqEdmn#%zuHPA>fS~m9bDfTo)WRoAWf9Flpjn(*007JBZgVY
zXC*-HJNspsB#}XIK#YJ+1o0zXVnsl9-+L$1FMc+i#7p0}Ih-!b5P438I)S=1x!XBp
zcbNdRLV5XCRbwSjl}J&_ozJ!;X(aAKE}#$LST>mISoltgQGzz0H{SL*^U6ANrZy5v
zLhh!<<BIxZ+GItH^yG&tx{x_MV0ceVia`xEgJZVbWKmNiGRZ8Or67_Yla+N;k6fmM
z3jhvJwndUc$*p`z9e5iYv?V%VOs7#jj~^_dOkN@{Q`KoJWEEaVrrDRMnPmkL>J&Q)
z?d|wtODCAQe<hJ)e}K%&B$B`$KyTre812PNx1!zF9Rzm-bG~V4(9w*N2>Iqo-&1J-
zP}^?#lqnEub=t?KXqHb4P*b}d>|&r;6Im9-dhwa%m9Fl=_0EiR`<8X7WFd*F`sV@w
z-<+NMRxtAm?m5ly&u%21MlFN!&SR;)$8StlX05R((b9tLV?JN)?zQ^ww4@j0i~4Fl
z9Ou>a&Z!%*t58kn!jp39J;^6HIToEXXO`ZA0W7F1y=UrQX7q9Ny(B29vaNyYeNKLL
z_7ZC9pkMrkeytLeQdkYBeDju$9Fok+N))>XcW=`nFO&zWt&u-m+dO0vtGbQ$?sEjZ
zwz3tgl6D!fse|nwv?1s^SD&bpN=LgNQ|LX(&&qz<`)*&h{?Tr>U89G1qp(yUJW=G5
zMdtqi;_u=&`%kP`I%aR>p(L)4{-LAhKHsJ1&50C6=N@6TsO?_k*1P7b+isk6*OyF%
z5=LUg7X^xwTBx6gu0MvuqjRJ@NWn=h!D}MBpSyoAd}tsu^$rTSCZsWdO{Eq;MgIW2
zh*;T}4>FDG)c*jFrz0?JeHZX|@dN#t*MBY4$^QV$O+a4aHodFRZ@zw$8{M||!5^-E
zH!oB=iM&W7jwMioKqS!s0@Z!=**tGvnfe#-N83%;bf==~Np7R1QDlM(ug|#P{Ifbw
z(^g7vygscMfS?;?8(;SftW*f1cN&-V83cN5hUj$z>N0?8e<gp-J&&erbF`$wzzRTd
zW7y&Gm^P(imMX{goXlj^M}YK4{w<HGnyh(SX7)b0N7nxU3VpD8nA@W29_CHdp5s2I
zHr3B<v+};4NqR1+dWgx_8*g34evkHlTAgQ49O=UgIp%V)bk9_HeJ7@Jy~_J@<{ps!
zjAk@-7SaGe44SsQpk;C98&&U|(DYNXlPi1G`i$HMH<%<~yXh-un)}(Y8^l#=`@=R;
zSl&BCoHwos6(>_1svS>bgWC>l*4p;*`tFGIS0Fl}J70D9=25sJ)Q?>HGC>qYgUHVx
z?H{wu0j7u(6K={sv)|#IS@`<=s_wza-{WVWr%a)ZS7YgdMJ0;z4}7ptcCLG!?-cGz
z*J`ofI3}+6vlOYQS8<+n(dj2WsSpkQGY?Y`JAt1+>O5YV>xZeu&%Vz$2g4oLOB`MX
zc<)LAuY;Y)+dDhqfHSa@g9`3)i78WEu``bOVsw)mZi-Q+uVbH{e;R)epR+oX)WWyZ
z%5^XPC(}OJA4vlbUDBu8{S)-F(Na9V$Fa|2()~hs`C@*j%g6O!PL56~uiw-1@3Owo
zev7GALqMK0?|NC2tbtt{%Kl~cJ;r{0*7S08U0mHefEgH%n9qOsQ?6zwq;vPY%6%I@
zNX3#Z5itC}HYu#kPndlhCi<9pUuO0>l4$ug=1rJ-jNc&U{_AYs$1}>Tz?<_Y-XHQA
zy~_Dd;@_}`+dpNzF#>v+hPVj+?^XH!U}xm%8mx)p2+x@LBp`2fM{s+7Is3Gz6bj<4
z8}!f4zx4z7f5MS|*y$5MW~r4|hwR@!)88<>eYWDa)8g4Ak(m_$Dx~Q}=X<mG@0^;R
zRDe2q`Hz$u@9&(_zlW_^)@Qw4wf8)HF(8R#>QW-{jcf+CY72h8m71LjPZM~EfdXps
z*4D()-2C~#<3~weJWPgKF@SY!Hftk|%?tJ06Iw)q?U=X9wy)o|2-j3iEh{3CsY$CJ
zztaH}1|^kE3gg!+Cs6%Fo+hM69l#4zb{l-K^&SZ7bU?O<D#-iCx%~cE5XR~msaSc5
z9I*5obNlUqG;yR4DO>MDayy?)uZOB37;0t#^o{jZ{SQC7$%2PVNWNSC(a*0xEOzST
z{#d{jRY?uN-s_J}J6AYC2l|A92qAs!*S;%%N(mFrCDlgMYzF%uTh2*HgehP=H9AI}
z&5^M`UtHvkXJ)5=D6P)ydjapZ6idH^I%{&EmsAIaHD~Cf6G>DTPFUC-@g=h>=>>Nq
zD+?qCQ$%bbAQBG!jaL`@^&yPRul-uOuPqAs;D(w|k;HXX@8;lHJ-rSYI(ID0QPdIv
z4O+Js$G!-a6U6aDE27X+D|-Ng>9yb~*G5M2tJn;{(-HgpaKj8z%9^A*)rDQj)l@xp
z-+I98JR<EN@fh)UvA*5E-Wg+QI*lm_i0Qo?=>Trt+*$O<rs^b?M>6#)S&1Hc1l@N%
z_Q)yFH9o{p0Qdd=xa`(6mIlRY1AhB_4cE&ZdPiQRB9=B+VzjNWrlL9c;6gB>*zIG=
zYmM@;tMyS3&9rMvxE<{G_c(-j5*zcBumB>tub9CinBPgYYtq1q(_Y@WP`Znzg%72C
z#9r2Ni7iAfG%2WpO=@pzJPa&6H-9QMRWSVV7!9-n0tzqK@6X~es)hn`C5AErXxJ4B
zbkI9;LEqftc)Fp9B$7#0WF&>5rt0XP=D!SAgd)WwTdbP~;1jiget8$V(mbFYTl48x
z-vAi=$5N06?f(FXym0WAEvL50=y1eik>dwYZGbyf{{Y=*0?{xmv9M(XosVs|`Pmpl
zD=e`;iqVGB8pz(Rs8HDV_<XWKV^t;G6IKVP-x@_OJjd?rYrgh=9OU$%ZI}_tf`2@L
z*(@^|6{$tm)yMr~12d25mhj<At~R~@027@&FA}Rdk1~P+jfM6;^}TzH=pIC!3b;lh
zt&IVDe6S>{QT12^jxpqg6sqfO(#ayJtB(EioYI(qLIV;=1A6a#*5?3JWz^)2$^QWD
zae>9!MoMFQ1+DA08Ll|Oc-|lzswuFy&(Hj1zzn`tqhhj!8ZrVfk%+bmH(I^2g?lWe
z*k1QQQ2J&1#ZfA#)f$Bqul>7OA6xlWNd~aa$Xm<-Zo==k<MPFpM4Z}25r*VlkH;W)
zIvJH!SP)H(_Wdzq4$4sxK?~+J+W!DN4CNGnP?kHD8=b!_9v~=40J%Gxz%j1m={H*%
z*dO}FW<@}*s7mi@*J8e#XGTjET}q`++t9DyrT~FmkZ3&KukGIfMIAM4+;6|(oXQfH
zf&IjtiT?nsqzdX9NLcu&Lx6})0d{Y-V#CwC&J`59H<eepC(|fcq7qK3&Y%-kZim0F
zR7)H_SBY2_1h@B4>^pr%NlOqAX#k!`s`>hJiy<1eH^q0tnWZdQRTh}{AG*%nS+$`B
zMOUH4AgfsfcfqNg+Y(v3`r#Bnt4tU-s_<*$^TDG~vm%WngLt7dk*P|9>*?!_8a(Vm
zF3K<14_|B!Ln6o&pnV5X9N)y@Y4x$xfkl!PMOFSe!c!SO423LiLEMi_J}8-V2$T{1
z!|#6o0L}z}(xhoNH#iV3r68Ytw8a+V(!)y{)yW=*Bc|(+J#aJyjhR^-DtfTq{Wk5A
zZ~f0JP_L#23P~!)uC0a_m^oA7Dv&DH{NCp9I5Pxl0QrF}y^J0kD;;3_`e92qNL*Fb
z@rnu3ciR5B2L(TT)|;z1QG7x`yY1=o!MIUlzpmNL%3P5^9>DRGb-3LL1nhUlRT^}%
z`H2)stYmVi1+BAgD{=G1AhX$JtJ=+s1uj%+2X6I;L0||Kd!6|h3fmAjquY#X{*!58
z<)X&-I11EPj{AHwwUV?85_a77&TC~4<@BL|Ufx}YI2~HQyN}B{t8V_e)kK=x(BV=U
z{#geuqht}b_zuLH1J;i?!IU2`Bz6M^fEk3Aq;L<e2L_M9V{9b9kr=F`)%s@vRB#sd
z9~=f|1yM~J9+}MMfGRKF8PtRYiP!%C5<7fxTT}UoB%f1&zj%^<nCdjBJCWaP0+xXw
zk8A+7R^VT3qm>J>02}X%r+#?nD1nz#t0*ICz3@;J3hqZ0M*(#X=h#rjWjaG?6gIGM
z6-u((_pyS3P-?z-0d*-PZ`*w4ttP;-c|EhfI{<N**s>^I!vb#Q&j1f>-~!c)9>)tV
zle1rZAx?tbuCN_q(;CX`G_~mff=9%5$(!7pKRhX6s5N?@OjBX%!L9H<{IoN4qEjJK
zr({&z@4gA<6Ud}0#uWha?O*TxWoC#J1~v#7S3Yg~p4?^wtrY4cm9e)O29A;6qc5T>
zFJVpWHb1|XMkbOunKhGU*lO?Sa{U)m9K{2(SUZ;Bd<J%eStVeu&KQ;L^FQMXSh{B{
z{{YpEOk_}P$@Uqisp>>Afg$lVl633)$KN1<Wa>O=A4p?Ftyu%x6=UhzW-bc_p=4M;
zECUEh73FiGRFkA#p4{O;@{m=5Vt4JQ+Rw1bq>PZXC<K~;7DwIq3`LGbQyrZ{k~jF^
zU#xEh(nM9V18#2bd;R)iiOZl626<M?5_s>FPvz!KF3hh)U2<!Wk^J#Qkw^akwA+$H
z5Ng2h^Sq+{7Lu_ZszVrGC}kJ1+}Fo3mGSzQkEc`NY9UK)<-M=)%F00ssH7VwzU#-~
zNAbmqXpE*cQc+l)VRt+4Lh=el3ZXqXjisKoY{PTf@;y&b<)QHC=>~x#%V(c%-%PX2
zvh_(Mk*sl0S|8j!Xl`<1IGRF{7BT9tH4ERq2Q=M8FoKduQbZw+pIfoNZSe+|(HWeo
zcN(@F@0vQ6nlgHQQGirw0*Imq2lvJ_GKdUu%@Rfh9nflP-@h9iBQx~siywyClsDee
zPqkUEkIyR<O*dGs3ptLN$nD?rz4J)xkOHVR5V}=pQk{+bZu1mfY3WSpfr`nf9XG$Z
z?fPX_p0VNT{?jiMX&NdbjaN-T3*UXt{{WUeaT(r7L`t%=c$XsuS|nAI+K+STo>bGI
z(xEi7`HKU;9A!jhbcSJF=#W3&LC{4nR62=>SeA_fLJfxC4_pVQAIT^(X`}Z6Hs1mN
z09js?s>eJn8BKcvz*rVGzTNl10!h>CW%4)OYTOF~{lC@)dI*&?EUFwit^WY;jPsxY
ze5@H6xd3nLn<PnmD3zGi?WBTuz5Tbvonnr08I5DmSW_KVci-|D5=RNCN(XD8M}6|r
zMCLVOf2iVxcG|3eoRY?=)G{=I^yy=vi56<c5REjFYS|VtckO{m5-5a7!HaCgfuXR!
zy}tZpr<IE~rdwN$Tz`1J!_yz9SyFhV&~%YOs{a5Vt}j#5$rn`|K}#{+d)d4NiG)gZ
zE3|}cTVR`x-S*9}+o>Klk*C7|gXX?#zjOOJ=k*b^b25iA5CApX)MlXx>3U?FQCTJ%
zdg&Lq_S*xxZ?mWSLRX47bWE+JLPb!zBirZs<W@Mux(QDTK}4w^h#YsuSqm^lnTjnR
zxkQ??wef#ktP9h_1ai6~Mp(7oe2L%V-vT}icI?s<r|!4i8f*)$`(agAGB&RbOMUnC
zv%u#g)G?K%E#ZPjut1;(HU6<9MtE1KD(s4GMy@`12dY#IijD+9El5Lm@9UN)M@m;t
zsZ4>qMsG13RebREk<Hb}rIF(SKvg4ZCdbQsLc$sJM=A{|OhEFE{QNQo>WFBJbP?*B
zy$C;@j1AH}jE*BK3WW~Hzbihc@Wl-Z!)oBn#FwxLKA%6YrDL?GrwGxz0IDv@Qd@p2
z(`*ioR9?6waXC_SX(xVpHSOCtBf->8B_(NyC`AFk1oo_mn8dEplCI5SO-8}^<s6k7
z<!|Z&4%Tduz2H=s3Zg|ANsEF7l28H7_b1`&lAbxk$aF~21|^R=kAK&koREiEWm4gk
zYzXA>wmV8cl#K+BD3IBVwE)2O9q_6|j}$G}MzK6G>{ZWm+uVWanYF~{sby5uK=8mM
z1>191$Hz3gtld0Hk;bvM&O-0EH|#yKBf^c%AgL2|y8s^Eql^ZML(>T7RzxZTt6rwQ
z-}Rjr+5Jyl)<Ytzw5<OCaPzB@e_X#&_G-oUZ%r{)jU>G+Kst(@$J6#QFwVwJDD4qL
zWvb~&{7wOWz1~(}%*@2H$l}88Z?^uoijkk>)x(bwS&>DMN{#RF$ALtWM(aC9jEx+u
z-!ga{aqE=pda0%mc&MQj0FGMHE8)T5{y!jIk@_d;8D{B}Nm|2}Hdqb-^*er9BzBj~
z00!w;?pDs^{{XC#nC52wV|LaHJ#Rp8KgE7obed?|M~t}|!;nB#1%c<^nje-CIeLca
z!bcjZjy+M9ue{bx-#;ucl`zL7sI-m?Gaqf1y+3<oWsIjzj;thQdSwT7BiHo#=7t^+
ziQPO%T-JjB0NuaPemfoTE!TCUs!=kQVyL4-b|;a~00H}~he6;tl*oWHMW!L!P&?W9
zW3(?1Sb}0=fRY0Gl^hYa`~Eo>jRf;cVMJ8HZ&$X&@_0YsVOnBIBAEgmO$<#V>mK``
zHzfP__s;5P9dFsq5QLx|KyMPSasV2dudzP%aXQGR=%eX6qTU$lk-<>@eIV)Hw->+0
zvN5;w3=$LJsDC0?t85Rc_rbIMqJyUm5*5~r$XuO@&<3k&2KOA^RaL&y>I85`W%B4H
z_b4n;UjCwo>zT=k<W8Sv+zYz{%ug(S1L1hxGRk9`S4mPcDqev|pz5Gc0{eY?U}t#*
zFRNC!R|=_qQa2VpgC1yKrgc`JB~dXAb|_i;-_I=%*>OwNhG}X9V$Z3RIt}Y$M&`Kx
z09YORS$a_3a8Zwp?0DLOujBY&(ojYOx+B#i0Bhzx_kK4#<ki%p$Q%f5SgUe(t*_IQ
zl<6UpryBesz|ho9DH~b8fg5}0brsXfJUJL4-@_zq3B4^`o&nnkXX-o^k^Dg<(kN0$
z8bo9b!N0xveo^~CK>cDz(+L79BCf6c+D5AR?SsRWJVsTxqot96_2++6N9c0;x_P?x
zSnUh2@bv;xJHB})w(Y&0yJ1VyGni#a)Ey~c&|}8@amUM^_!py}P>OYu7#YJc3$m#?
zbqgNVjnqo;O9Z3}EE%hsp+{~%)-=6T(ZrGqcMPSq0j5d-fWy62`h0LQtga)SMxaj2
z2Hm)><6v_A61Pht0~~XOK;Svpfw><Y>*_J&PYyXX#?0gfWs`ca0d1;<lV2~6WS4c0
zJJV#AdLznsq3_!RS4}w41g|6b+Q@Q!C<Q6&w>);qsE@-d;R7L0D_PmBdLO696m$yc
z&l{4gNTcas0qk$Lpu^JjXt6Q{lfy-7WgX~?C!g*o<S;7zG@VqlFM}tG(-cWl!>VpH
zk?ciRCwv2=>iQXGNg`AoFZCr2O+X$yjrD=?JY*sw9;RRF$^+2>9F0S^uZ@qdzEsFM
znBqMoC1q-etaj{9qhyWw)BvwRfew~Jg_=RAm0-SGHr}3}?B;|Lb&)?%?JCOB1dTNL
zbc8lddJQ`PzN|<(h}s^frSSsllU#I{sO@|5C=I#i1n*Py-WZR=L=lY}7p=oLJClJJ
zL2wunJV4Pp2CY?9x3}q+>N>w2JP72CP%X$;`?#U$bO77@<E&Bmk<ybKr@|D2TXCp?
zezrZvN_f+!Z!FO^h~t$?@GJsF`ilVj-^?5B9;JVkJtQ^dyRFSwHhswg{sYq<1qKNi
zY;Q_Ng4$MK!@cY@@6P0Wb28tI3mC3KBPUfTZV6-DS0ru5Qb@caCh8Ekh-hkHJU|<A
z2Vu2*ZveCs!7OmRijzl78Hi<7AT^RU_>On1pG=NK@<pvgN?Q90{H)eYvGF8S04|L-
z+wFJyWgX*aK@BA{6;cP@BDwYF0`f+kEbu>`Na96#%8DhZk~Lq-_TKX{N|E&E#w_hC
zBNi4kfz6KRu=(bP>zAvBX(w{7BUqz4cdc84zr^3E_-1!$C7ep?SH%W3W;86VU$-~=
zybUchJw!@_rV11@s2i3BfV0lj$0yYp-Cvf_!sysf?c3PW@9mLv9VihsmsKmPklzl(
zbMd^<H&Yxx%SbkftU99>-npYxXpg1)WeVLyZ!?gQu9j9(2BGB@&+hMh{fGEa-|&~&
z;Lz0xa0bJ982-8V=T9H>x`@gRUKO)5d6t+00QLPp57~afg;V%%?B!4br%s9w7Ao&D
zr<T0G7o!NKvs*`+2^;?a`jMHCZo<F%V}E_KOqxQ;zRMbovvZP1P(_s1;xz{;BL?w-
zJ5r34luX{fL612p;<x@wmJ#y*0Bdx@KDubu&X*vL!#wy1)Y`W5ahm?tUa9`k>SU4p
z?ISY}a(B$IE~3HqAo}*p4_Z7!&_#KaXl;T1<FL&z^*$RI#9+o=&6BwF_+%pwD<nQ0
zM5gF^ZGWbE3km`wQ*kjXxT07M$G~1)i9Cvk8aJa<&Fk>Rho}-vh=YP{hQhn&OkzgT
z4G=W3<Q@BDBI*(Pm_$Rv0_=>Uy-8k@H;j<ZKw39obAzXE<yXd#pB1dCk;kF@{{Rer
zr^4yFyJC`%EDlZWSM~fb#Tu%KWun1>0l66smNP5AjWPyz+*ZWaL#pZq!%%AjZ__GV
zmhoTvlKj2>D<KqXFHk0#btu@ctz|aKt>Q3N8h=dm`fsyXk3FJl*#7{_8ZMGJSWhz8
z0VE0z)LOUvPs21#)@>qdkSLQ<F|Ip+J#cO3^{kybG*O#j%X)ieG)U14x{%$kzFJ3F
zRF?n+7B{QR9Yo>W(`g-trgY<{+_J4pG{u|Dxjlis>(kc&CimY7*zsWJL^eCsu=+Le
zoJ9=ccH?i$DWaZmHP+ueC!R1dDl$mb2v6lF2V>!%%RVJn&F@D((U}+Q{-l<wjk)+|
z$wZMbZJSUVZ@14p{zuc7KbNcgK8)Rb3OOvIv-LJ4q{MCgP&Uua{{V&~5`DANg#>xj
zZSl|28Aw67-hNMhGeul?EYGLLHNyZi=YNfQgVO&14t=FM9WJqi1a>Sy{E5$catcee
zT%VB7oBlne{ut`RR+pAAZ1K+j04l$hWj+|!%s&~_LdqE!xFm++jqmZ}+x)zU3SX3v
z18N_3s_WMGtOi*XmT1X!L!>cU)43!3=8&j5NfK31$>)iz62R%8X!Zc{eD>!wI?|p8
z(HqFcU51tffIt*%in^jG_oIe8f+-_VJUK2laejJh743RWdkje#rD<e&2x%*Jzq@|j
zw(L7(wQ2xMApvY1tk<{rzyUl(0Qo@_qQG1A_TxQovA)-r?4Pu{ex_pW9Ab)%j*_C(
zei?ydmval4qhQJy*tGzb2Dc`U9B=c>H1M%l{{WXLy7jvymsFu*uC}9GbG{92`v*(Z
ztk5jckjlU^5&gjB)PuJdx}SXbAK*{7$}syXVn(Ia7OuoyufWy)Mt#b%(C2-@^f|h-
zxN_RMmX&cr{_E_2@o!wRkSUM<0A<JPkd4PJ!P&i!t~#+%sP0D3?mcrR2WEOJUS!yx
z`7V23!yjvZCDi`_CoBH|N?p*C!Os~3l{G|<x=(TGiqO)48m#I==yME|i`P=!$IUpe
z7KiF^zWQ@R4SNs@*WLYd=0Ao$)^5M2@Fj8M#A^GIpG^^tXz9T{_Vv#q)S6qSUs;bV
zWvpJNkxP&P(g)t#owA)X4-9~Q>ur%X+JJ3KxIK@s7~L<F=%ApE2WrJ<yE{i_f@u74
z#^V&%mavVsyx!9z+;6rWitj`m1Dc{NbAx^`j~}n-{{WPeQZMuv?f(FY^vvyaDY?&m
zkt9ZnL8(t{@VbZ_q?p4YzUtM;&p(ler}BrR$IaCpGvx;txX3yKV>PkZ)e~F{%_5ze
zv(C+qFIlX+@n5EP^7@#FIhTy}dWgd<*7@g1lumq~BNXGj!`{Pws85XHws*%nIosV?
z#COi)JB$H`oa`W80ISNt)Z-K`I;Q((Ro>WIdp>9Q^XzqHA8Et@Bg-ehq0f!!dY0*@
zNmF7Cf;09RzRHK~PKsWasRXN!q4m$nzT5jAf3W)bI$4zYPn7=v$aXpR{)5Zw!|mF8
z$NvByp8o(L;q+zqX&tA_?K)1R^?fQzKe<M)Y@-si2=lKLe(=wm{u=vO0y=38b{E`d
z)UxUHIyYa2eJoDjCu-_gq=Ye{_axnYj(PomOAlAmKTkSqieOSjKc0Hh=-n5G^Cz+N
z%+noSaws;(<C!sjANJqbkM=LxlXRLi$c}vXK&j%rh|fL=QV9}K=45p`dr;rCA5QuD
zU;d)~ihA#}M_&?;AElt=4a|POBl+j%C`uAo3f)Qcy|YcDQtG9*2Xo_ZCF#})1MZG?
z_U%|?mKEumFXhm+f+h@X0MtM$zm4{*s`C!t+uF`cSpb1rfY^|1)>KX6lt`gf)AyV2
zSiA3-vq}8GGElv$_a8ho2~e%Am=HB>RrzgzC|Q7V2){7^AE&NVI0~SEbQV^Pjir%6
zhW!5kfzAZth`UBeItV0f*j<tIILcl~j3zQsPN8Okk~jH~KMZK(jTTLAhsr_#2^Z=(
zt}4&3872)AG;%48fi^2~w-_AS)G7c_l|M0mj$5EsZllC@h=_{F-Xl<82(ic~;5Ybl
zkWgz{Gisu{9xPV>04%7D<X4eZSV9z##Bp`O=L4sZ>F@-hl}&;VmX7}bANs(=DQNsp
zDuSff-mX6^R65sF%1e?!UqC<a2Z;}hVj{=^05g6&U^qGoyS}B}LZf-M7vGL~_~2o#
zMQFyvh0=TNzWEbDPUm~=`r`>ogi;l>-F*H30DNH_!HD~zR2|6u?}Z*jM~xVTdekew
z?3}QgQxHT1h=J}+3%jny@fAy~vlmbU3s865@&|tS22T!7rIbA)&@WeXI|J)kHI<q}
zDl;o5m{B$W_x2bW-I%_n1no<(s;c-_*aEEwW+6?3w|>}DNgyDsVRVD2KYlph)8Xrc
zyD@2jyCYMPcE^A7i)_mramE^))eF>3ZMQh+7C#{Y$yyuin~Nr|Zhw1W3E{kj1(MEa
zS=^u5&U9m;S%D-4RUQ5CyWEUbdypt_4g9l#B|<d~J8mm(XrA~A$cji)tXZS~03b2t
zj#QgOic?_PYUmMT@T_R2WoXJeiBztgD|>;rw>X*&y|<VPd+pox!jRAxwO00b`C`c0
zz-poJ0DQ6B((2Pd05{m5d_|1OdMK#mjs`%%0|FyrRe02D$HN$%qh^Hw7D?k)`ACO>
zJ4R7tlXMCcGMfZg_w+d+fJnp2R8tx^wff~85wxpO(#DRP-x0|TTLbNv>D8U2Ajlba
z3Y`1?7``gGXL!T8+@DT9qnv>^b);3b8_?YMyr59Y9+GtZ*VucVy>`i!zc7o~gX?+T
zGndz>lUi-N05BIyn&h7S#xMvi0UNLyj@9e(#WE=ur8OJ6vHr7^7V_z{{h)1xQ65<1
zWZhBz@!STk+08SgW-<vD4&#c&dSG-Q03Ely3nGmzTUVQV8{h^$AlAgOI}`bDoDYb^
zJ2%}mLieqQ!#RjxbOLB!z+q(}2i@Fi+nT=lK?JmFfd;Fq;{C9+OBAge6ksoKc0B&M
zC2cGlf)2!GWmte79Hg<_g1x>!>i{d*Dx{$c<_b>Zxj0z(o+GZRL**6sN3H!aRu_N$
zzdIVBmweR$+~T6Su)leH#2-O{Qu1{(5fUB2(u06GKQ2y8Y1-C_J2A@i=*~!g5DF|v
z7em)NGO!j56qZr|J&&#gq*V?@lcd$2{{SqZU?#O+3@EB3pJRWnL`Sb=)O6*cSXWn#
zFR=k^;3TDt&Z18ei2<zd^~DUpk2l^Fcdfk+JIsNY#D!J1v$-DElUUiB)_@<}co+x6
zJ|I+53FIBOz*%{%&!=yOIe!(usQUr6j(#~Yyp-Ht0oKX_=mWmvoZ!U}uAxNnlmbaX
zD6Bvuoz0#<ES;jU*!;!;+=9i1<852sE`p;~ZP?|yUXE_Ac8UaPN~=2s-^!xN`3wab
zjEJNva!vq>ZwwVXsqI|;xiI={jxXh$4Y2s-2)M($sTZ<?{xAcu{?#j7-YXC{9G-6q
z$^A1H#1njP_3ets%V)cDdtfpU4`O`}7&-4uyc^2P1cDf*Wu$uwLA$PT7Be%pr%*t<
zW6gee0nI4^w;bnJl|Z9?u?p}z<r&&U)Xp_6C>_YaQ)qUu!#P;H7I!<H&pFhlFD|0j
zx$TAFXv-{$QJ0l%jzFfF_BUSDwh&d0-~c<~so#pu6i(Cy@N$Q^)kA&aY!G&=nLKwm
zQFRk%d?9t-p4;t#!I&B&f!{a-bwFP?i=>wWP~W-2>*2K$4SU!*1IkjBRO|-k`{KD~
z3)~I3&R`Wm01$iN^AIQ!0PTRmLs$R;1@n{CO_BIxK9l!B-_+T~G%rs704$)XDBFvp
zxFZXbAucr&`C{|)!VMG69>W2gDm8}I2*oP8LoJct6o5wDdgUUcLQ4^jNE~1yfI%DQ
zAlPa<a&HSABgoc0#vrqS-*_D$oa1%e9HK~61G(EtuHz<1vPs*u;S`ECoal*dfFz6L
zWW$ih$_e8Nt?nxDF`>b+$-=(i%U&ACO1uy^`upQFS0nkzMBJC{`#WS19c&v`fNa_A
zmzHR>#SCzT0G&)pB>H_a3&#pa1IkuCT5o;y@3ngKnbs$ggl37^Z10siC6hobQ%EP=
z=EUefm}uhwMBEp4papt%!1LGz@-RapZZrUQ%JmXEM!Iy3D?oaiyn_cMczS5=D07V$
zO(Zh5r4lvJ-(XMcz7@_LqGLRP7!N9rPamc-4+=N_puRRcoAk$V63D^cH+dJ4bUS~%
z#}HLlXG4318BpCM593h|-0Th+XAzwdpbNFNU7Fvwt~j5;WLWEqVg~;JT%;dor&hyM
zfk9nF20L@PJ*y(QBN4KJC}}TcH?X0(`s4xz3;`_QQ2<p8cpgY~Xh6!_79#c=&^g{b
zYcM;Tu;RNB@A1F_EoWJO2`_PWYZ6LvsZ~XSIOE^rjO;@|_h|MFi{Ck*E{?_gh^3g-
z0nXnO#t?jBnqAuEQRNITztbgtE`a5mdtwIwd*P*cYzEwlC%N1G=SWH>h}1eL^Vapf
zbM)We3fU)36kTLSC6OYMsI_iIU3RbYnI)H3Qs|%icT1;pS*kH4(yPfJlR(%lkhjY3
zwl7k#^wOvr7|5qv17&P?_pjFo!PJ%U6=O@Sxw_3=A(`clC7{OilduQ(Se-Eu^z$;P
zX^nu+E{7M32@=R3#9-T&HD$^DaH~eD-B*V4i8PT?at7y*(>2G`N7c_CPt^p9G+m^k
zNweC|wqr9eWm#!iUWa0v*~)d1$)HaoY6oR1Y=8mV*V6*MO2IEoqoKVj=gLQzuG^FD
zei`PldGx%;biV%p53Xo4DnSfz+vo(yR8S|=*A-FbcXzc&?2R48@qmcTrDH?qVYTc>
zAK>NXcqQo_SiZVYh>9rs-uLU<A=7J<s7qAP!*X~Y#~hZISn1T8B^ZUE1_K_lZk`B4
z%EA>VLh*cEdhNB~GED3zTMV>UNE-p_J{Vdf)I+#p7qd78xvzk%F~Aq6A|av30ErI!
zo4;<@L5<U_>wH<YlcZ}12LKLxa5K78kjS&OJ=s8Pog;x;dj5E=BdR$YHI!=K$^~uf
zh<de1rHrcv<qDoR-u<fz&vH#MnZf>}TLm4?`wZDQ>64^bW4DsXDu1({{=9rMG%F*_
z8FnE_0GqG#fz%`(49@Dsh+sGy{{Y|DAn4-Kx8av6ceCZMj#PC&%f|4T35|!`W~IJG
zj`fbUFGy{j!UX}zrBmoX-=WO$bf3)3v6d#+l^ybpay0!?2k|wtk+%vIZQtSFBQS-!
zAR<&Q4yTgNrr+sb<LbTysKv`F9pfrF{CjrCm!@IUDv263OMM&L5qtZ5@(97wNCHa0
zk2ST518X0yReF@1B2I}EMfEWNZ|T1^UB5hlGU*OTZ35Ie+kb2`6ph*ym8Fc3z?IN1
zxUZfDtt&gTIzNMDl!^gs<@gH0*G`j!DG<{Y>1*Q10>=RCKP)T~4wfLrk-*f-YzYD2
zfID;X!PHIDln}re`2h0|ym=<L1B?Zk$5`zou92dEs*%tPYuCB={{T4|qlP)xs51Ea
zPJ*KDfaIS}YL9N%(5REbMN_xlHK>96{V+N?489o#EAdM2N8&#`s@NmxAS1(`MoA*G
z8Ul3Q#ZCM#G7hC6MN4ud-SsxaU5&pS2uDiV*+Xd{*8=&*V<gWT^=WN3#*Gp`f35{e
zh`Ly&Nr5T|WvxLN@HpI>IVol`#~ATcjWs8ePS^KMa!JSO14Yyk6I7larBDX`qjUbw
zBoW6Pz_OVc`H6W3_`chEWDOE{eL8gE1F(>{-r0P+iuL#HlWwC_ap`#r0Atd_VHxJV
zGhbadOx;gXki2LZfDsUo$JwY*9sP67g&t4lCQw;Vm&9co_Skm7)d$(FA5ScvbSWaH
zhEk-4sy@H5iPXhmqf{EusbCt*16+3}jk{6JFD$Ti0icx`x?&p71pGUZX8FiS?-=UC
zF)}r_rLQwsv41=OPfyb*ex6-(5X$KB@Na77&3D?e%*I}t-Z2)Mbqr6KSsPzF-u(SD
zCb->tc%t#Omepi}2?J^snq*%RC_G~%!bWx0<6=)>dGCKbfORuM-6ut)7^Py;Hl;OO
z04tHt&ogy)@-pa937}MI)TfX0zB@R0BMgXSi0U=neZ2?z$Bko<z_Tb&?`4!7hhTWh
zG3j@3;TPBM*in7*oi9x>n6d@6PZgR&Kqx$)Z)~h#A!225p`~SX0>Dw;#{&H;kD-Ef
zmU(1up-+aOXf_1OH`BK~3<Rh;ZmUbvpbh5x+CdzSEbq2f8AFDNyubj;0@zxwU#H`d
z>bjDKNFlQdkjGL{ExiHh$=m#8R1hO!BS*PeUdW|Ajd5G-J?{vo+8rlP(yvgxJfcR8
zL%XmFNNpqq8}WPae-W8FaI-qVB~?ZiHS8Fk=g@D@p!db;nfz8ET2oqy1Lyeyb8e95
zrs}$Qhu#aNn0@j`-X5EQzb5_ws7uuU051@VCAl7*WIU<8h(7hlY+(?Gr;=&Q2^qv{
zNvl#1nSDiyzkHOSOk|EoN`<i=<bX#e`|y7(Zmqm26Hkc0(^Xx5YuFFV^B5QVG9Htv
zoSv(yF(XFIf`RiWG#bdE!1Ukco^l52WY!7N84;O{5!fGLjT~Y*E=NUHv8{a7TYU43
zamI+N<ws?90);J|ui;-@4YKtM2if{mhLp@SSroc&ayyOozeCOBTdQuKM{uR1W-_8M
z2TO|r#~&}RyRSymzKA0aAkyRm>DYHBs_WyH`!%BKKGKNw1|u9`$l<h$3rxWAsG1;e
zXOC<TJ)@oEb2;#zO4)YbNuWK>)$kcqAVC3_L2|}`8->2)ZcUT7U@@lY+pJcYvWV54
z+V@~~y7dYG^&9)-ylQhIpk%)gRVmwn_53%$tmamEdI-oW?QD4QSQAFOY<M1-E}%~@
zQe!8=D#uW-F2D-go;mN&d<Ir{!HhTaEg=Ak&=cReJN_A~rRm;oo2n%z4vaKEiKSQo
zbtyH;P-}6pBYm(XBp^pTzA{IlROn;As{ji1z5W;=>SP^c3mxgwLM((>zr1~qCi`U<
zp+hS8%8*Acxfn>)C;-|)7v`;n_c%Hgfo9bxV+$Z;Z5OSVa->~=O#@rj{qPcAk=hQY
zt!X1SC1?hTB$8=;EN|FY&Xz8xrH}b(6vZ!2?id@j`~e2`-_zR?9-?-Uf&QdO-Xw)6
zeeF9EH=uO<52kGDdbVzo9+?G6AS*kTAj{`0H4Em)2hbl(2u#wX)2~bvm}$X|$w9W@
z^Q2#|CdN%wOdV-3ni^>DXe=E=;xFrzg!ItPjnu|uEUe5U1e8*{FzvSHy|<yvVC!F{
zcA8Qo)B|a4#<DC};Mc$Uz}eQp(?!y^Q50+;o-q9(bN6`;8jm8VdWs}wbePH4{{Ztb
z8DUTANT#D^TDlZGwhwOjiPTJlCyQ#Xts8E|Tod<fcPHRzXHK*9$rO>8*vTG^K!QfC
z&DVNr-`r(GPOPHCEMTjhI|gB>DC2|e+ezHvh9xe+Mzi5x-qJS&*8H8mcV3t#@k9Rr
zH!71Oo03l2zFQ7B_Rc4xLQK**c8<~GUAyg7>q7mHYRIUG$BNO<0}U_dXzKKe0Y`3k
zz3*)1a1sy@#o`@pA$zfP+uRfD^un_{#~iI6iy;Is(iHGO1Jn>~`uF!n*C|0D{*xU*
zF4Vh?kA4r#U}#p4s_T|crN*6^ij9JVBq#%qPxXNjQWTP85tboOAhPU9;O)0GdEd4m
z5k)Cr>{JqgnkyhH0tpvZM%BLrd*UAzCk~C_GOwqZ2L}GN>y&JsIc7<^mVm2t?%p#a
z-i<_n4fE!{{B5?``zP7Yuk1dOLV-1O(6Ln%pp*w;+u@&x!y%eT;MNodUn{*We12!)
zzJB8zGC}rlPa6OkV1-Q$wn3Rw%T`~C#c0X6*+Be8RzX5-?!t=5n<8(B8)fAdCB6$N
z&CXF_sifck0H~s|<OP;MJIE^WbkjARjKdCs-~soH*+}yFPqfcbCtEQr517y#^WQUc
zw#*Bb^s$!fq;WjN#s{6Z_1xn0lgFf!LB&<~#64*34bb?$GJ|bIZap%+S5q2+3}aaW
zwO=`q^#@*{NY&2!9M7&t;07Ra2In${D(fz!k15y@>5bCCBglj}O(%0#w|s7zKMXM-
zHm*Vb)0OE9Cs2%}RapdW&QonOMH9S|=xW-CJp6Nm=rI;w5;oVfA3!VRf=O8%0T8|y
zNZ5)tPw%!Q$kD=pKA>BX$X@>dfXq~?M^QGQ3}96X?d_W&iaw@`f`t{%!)?z$h&Zt#
z9Sj)wDKP{Zvtu+Y9tcq;mHW!q#a|gh^-{nhWJ0=V0DWqQA1v}@J~KCne1LP7>SR4c
zfTb!e-?sOjZ&}m|(tyzXbABp)vWQQppIN0Kfxyhgiyg-Jwo7W@oNiA!)ePal-o#-9
z4T;+T=YOxR6TZi`QUo^p{JpWL{{Z(mpQb-Pm6efB$8IrMsO`ze+USeLBq^&GnA^fh
z`q=*f{twg;N8KF!MtrEC!~?gkeLver!TS<JtIW)!@xRkPS}|vF-#qR|mnLs7tNsSx
z?YIdR0Vn7Q&(Lg@g8Rr@_w>(({sf4Rv^+vS>c4MepKeJ%%L?r5e-oOj<G+@99^xR8
zW<#}h6`vjd0I6M0pRiI5s(!I|t11;*_W6wZ`9NO<JK6Yizwg^V2mb(4y1@iJ3~Z{w
zmR10bR&71Sa7VzLw(wFrz8|KTq^k)(&BE>Cn8%O_X@Ca6BzHAieMVX3X?kQ?PN^4l
zG&F<)tBWVMwS6eEMv-Wg0jbz7+o&K}_dj>(@3exBl^Lpo+UX~L-1-mknq5ZzapGt2
zR4mP@8-wNBYO3wMd+~$$H<DxFu_y|wNWy?E>*?R=g=9?#B-X026&gSVtdq~go&B-X
zsh{lP&ZbBNiplG&5JujjoAJQp>0$9_j5-%OmOcEeZ*!<{0N>@4njzD;SJbj26=>CH
z3Ie&k$-BwR7)JnJ!*b$|`-AY!9Wuczx;%D<HC8&!0!Rdo{lEjAiNJ9*-8WGuQ{z0n
zM~ti_t;xH-d9kq1(>}rbRxh^x&5Ni~q5kZOKefj{FHdazxV#d0alsQg3<C?^M!Eoc
z3ijlmZ1n#ChW^}7uzH4(mPhGkA~IO+4#c$&P5!x+XG||$!}UnyDoJh63_V6@Mj%&o
z9#TKKeKQn9NQ)w{Dn)`0#2)#f7gB%?mECh|nW!58Mt0>->4Y6%b`8g~Vk!!uux~Q&
z!Su=}^&5>LwqfYmQC^FyZ?n3!>Z1n1rx%~1{h!sO@g&iG$6LJo=0pu=Y9gC#_kV<b
z(J3SSog?q}li{3vyj@l5k1+MUGn3J8Zr&yK)OK40HQ5}GOjQ1ivF=K)+v3F_Ag<)`
zW1M3_bOWe?xbL2POXwR$<l*F2Dji6q_ZZ2xbVEeDakd_I&ar@fJ@TL)ay@rV{NGGR
z60Yb^<?uOU$G!m6N3LUP#KxtSW@2{_152YA<pmjbAoj_!(hY@soc4aw=>Gtkk6dH=
zss8}u4@~hxYO4Z<+nzJb&5NR5rX0O-xMy&0+c9-9Y)*PoDXO~%zGid;X{*l<)Ofvd
z)el>Xn^UQIL{Z}hIeF5U?O7c8*^NDToxow|2n6kn7P4rWC|qS5)>1fHLqlPjW9fA6
zduDaVGS_U84C&Le^RUfP#<6eTAMT16HU~G>kqs8S*+r4BZL`Y$G5ZXCv-U}JQT)s{
z=zEdeXQSdO?pO?A)~#2l&b~J$a9%GG<K*$9H71h}#1+p^EsG4NKHuz5wLkcWL<N6R
zA>X*q5BSgQfBqZxo4PObrnwS^+wwCP*dJ(~i>U{dZL2>;;_@q-9AvMFerwI+P8^et
z-%qu5?ZG~1&%dT-cUNP+$L|ZOIjLQGh{bHKbs;^Erb|leW+Ii2mi9T=^VoWbmQ`eR
z48L{M?iq9O@8XZKU+hn`r0Ee0MB`L!ch;u&9+k(}KW3R3bsp*{k5TKNGyGfj8T()C
z))A-w05u3QLey-I>$j-<MoUK9G22r7mTwV&W(z<70?-4uZ-!f@jl&%bk+DWLZ;d9w
z_>a#KZBjt+hS(rAT3W&S&?D!K)kx1rQyL_c94j736+^ckgWEK^R_Qvi(L85zRM}Qy
zRfyupvAoP=@Q|Xix~m2>y}+((i~tlQ{{Uzm$FKU%6P9m2mIMJ+Ry{VryiW3y98rgo
zVRTKAM)p0n83QAOccrUN-u&am(@E6Ioj*+rI~o)Xf_;6ycpR%wqCdD#mr)xZ%K@Tj
zmKhA1!)c@_x2WF)o&{ODJXd|DVwXsEO_it+2bli2?S2SNNnVO<l09qT$G#9>N(kjb
zBlBusDI5K8feeBsk(sqQ-~cGtH_xZT>4r;?85TQMp{W*tAZ`ci^}x<rH7)njfTaKc
zF300|w$V%)mbDiE(NkXBcEDEDfW}B?Zbbv6Y<4(duMNMc=O(m~dr{vSA_;{`(9|!I
zTF&GRz8Nwf#3ksRzw#JUI(Te=X(XUL-QVx?!xf1DQEVGf4zvdRpYe!+<E93;@3muU
zkVpu<Omz*;=JxoU25moi<$o2d+L{BNekbtt?9Te*)?@{u0aMdsz}tRrBGKwnM1TNn
zS?7M=zS+oKoH7*}Jvg!d09X`rNUe7yo_#=#fw9|z^zEGr%Nv&z8X6=T>_*gi?Y1db
zM{@pVR-y^LN1f{rgjO)htWPY&QmOCp+P@qKvWHPGhzqsq6<g&(w5BySNn26Hi^+!4
z3b1BScJ{oo7}%}9mG8>L`940rxDjSx>!ps{jrhXFrjj`Hs*nPLTW^WHKwDO-J5?V{
zqcn6vAq0EyZ@;b(Hk0owS>IBPh`|_g^%)gJZ`fnV&IC%<NEV}2iYJQr-`5F1jufJ@
zDFN8<Z`^j<^T4s`(paP`MtDkt8rPU^2^4p#A5-(msoWE1Kr{jEc|jU1Y|A2AJpcym
zJ$@U0IbNTpjo5h1V?a)(8=g3?h{C3m6p>kMI5u3<U&!Q#gf`O5<PdD_eTd5VZ5orP
zI+fHkn*(}31Nh{0v0Ku_R^H<vc*DqrLmE#z0(SWRIF7Ah@9%c>$A*xS)uVzBKTdI;
zWTO%R;SwM2g22}o&2N<xqRzwx1Ki?{#DYOP`sFXoQ6$!c0lBOC;{u^oOOd5c+=6{D
zCm(%{4fgc(%CYH;dR#beLnj<}_q>xyY5@b^>yu@m2p<A)9U?SHAykd59sO~FNT|9_
z$AV8ErWR#Th*ha<x0ul<+mB2x7W{;WWHz?Mh4w#O1X8TErAHg@x5qglQ>Zb}<xK;7
z`+RV*)T|Yb#Cb{EY(5(sl0|c*)89A}CE{fU)Pa7ORyJfWKo0l&-wViEMv$)L-vYlZ
zWOg*|=8bFwEnNFxa}q+ODir{6SAEVaMCc2$umFHfdhz*X0acY4uyrQsd9P1nk|gOX
zy%T%jFtg@QzQp-^VwO}*B>^qItKegm5v*)TqwqcZkC%LyD??Bx){X@PTa&0#ix>Ud
z_Vv!v$UN6au^b=W<b2+SvZ_R*K+~vMv)|Zz;2`pobyt444yhW2-vWj`7H0uU(EFm!
zbp{qoSv!z87yy!1+_s>1zfX=5-Xv_P7$<9P;;~AQb~ZZ`fC7TTu_uFoRj97Jq1y4w
zgawstLH_T2nwGFZ7Ei+}h^se;G19k8RBEq<bAc-$0s+6n3T<js8{)lkjHAOLbul{v
z52rh1)~svX0k8)k5+km~G@Iirp<^C!q^ZAq>?q{TxuRQ5UDe`|rL0*1>`3HbIy90<
z&ZtOVGf>zMTvl?#l6T|N0=X7JHf$Q(3Y1l1$*TC@gOm`0O_YFWpD_cB9#ycwgI)8L
zbsai@zW$i3G`SWD2CQ*`#h9Ad4`G#!msY96IP|`9X2B#7Jt*fe(h8Cb6MkLq0QiU~
zh2Me?Z0ka{!HK=V;=VYswv%N;?ZLwk5;+VBHL=J5Q>R|rZO(ADUT9u$ZH4kNl$k6u
z5SM#;<q4+Nz$Hg|!iZ!xqXyfGKjQ!lMGc3p1CJ>i4X_yq71(2FAQjR((;oPqN*kN+
zfL&+<M5)C>%ybJHjaBo6fnVn?I&!@;&PfOjDbi`raekw3t^|lc0Ag$&!vNR~K-n7{
z1QMaIord@T1kqq9bAVciACIPWt8784>~J!Gs&+T;jGziTQ0D;-k;eJTr1q?1pj&d^
z98gKy*8`bA9q;3XGy*jeMe%@*CvkP#(+>x7H~cVxAyVeJ#k%?9NV*=eK-PFWV14?)
zv-Km&4FRw{@h6Tok)sOUCg6a0KP+B}%1f?2Ls6g<*Uuh#B>rbo=<)z9KIpH^<W!zn
zAOa;&4U0S-z3_u9>^w&#k!(rlEDFp^I?=uBd?B^C5rB$0AaBKBN+`?@p|;h!ucln<
zUaDBx!6R{`^R@HqzDUZVGpLCrCWZe1Xy5V9ho=cJcT!1GG@!O)ff*T0D)EgHo(Z#K
z^#1^O{XC2%M4Lwd^R@i(*}s@AFkKPd3p@kc^T|mk{{Sw)*m7(dJLL}1c#^PZOBcB|
zET7rN>7^143dQ6;S_6SwjEoKps&z19z24{Ng#@rj8rCx0H@6p&Rb5J&H7I3Z3Dww+
zJ@A;<r|KDHWmJ$*s@woMuZhScC1MOb+nfH|%g9n#V_F5ZYAx+s*R}$6O&kcu!?Pdh
zjso#Uz5~CmDl6+)*5xfnPULU+WA$DfOer-+<4GOP_6OmJvmXYOQx)B>aqu0vz@$h|
zmRm@HCrzCyO@Z?n(zdIPHMM1}Dt-InJW_PMKTR-X^R*Rb^Ao=H>4dQm_?nmh0I&@b
zYx2OqK{`v)N`;(CZ$JtN;)(ULGbdjIbkha_nTgciib==m+)7TB&}_H=0B3$Moq7vM
z6Gp!c)~J$id?5i=iRF1UJ?YU~aCh|d%Jk@tB$&udssKP#X}?prte;%*EUgO6=@B;K
zhdY`c)_)w(v2=%^kt3F07gFdA9R?ly`-}{_8eXx;kHjL_o(Fxm=ZtB3`6i7~sG%ex
zDBHLC#CfC$)gdXUS*q1mDEyD(kENDK=4H1~4vO4@Hlc-fmFX5j@t2X4ioF1S&LAn`
zf=g&*9@X^y?~B&TUPYERKh_&At_Cbpw1}}hWn{l8+hO_oU|LxrXH<=X2!H^A_lY)s
zm-u90GD{;z6_ERRyPsk4%l(|413ZFIROu=YV$^H&+a)y7baOMSG=p6!Bb~SQtG}iI
zEP8kXYdXL_Mc9ye-|3Ac_tUII(hwNNqK*5W{{TE>>IX>w0MACKHZ-gQ5O2`!l8Jwx
zm`+cJ#n1q3I}fJ$19d7R(BYH<Hd^}TXGTTwV`Xha&41gPfE`3KJb(?zQg-t1L*tW$
z0)ge&lU3aNA8ezPdD2Z<JU&Ppd_B%5P!e@%CDb)F+j34*sGa3l;3@!Jg>(MTxx%4j
zCd&#HWD)=ai}yGT10p0MSlTA7KyOEWJ@>;j&N_f&dthvyD1L(y5@6}UD5Xo*-2A?E
z^~uVJ5sNOOO>E=uez*okibxEM)XP=3KHrW|!6Y#F#1;SoD13nD^2O=;Ad3v$L8#e?
z02?RXyARJT<2x{>A!4$j`9AgX8=QeBaXex&0Px8#<=h+f`SF>Um9kUr{o>q@VU+2-
zW@=D%Y*Y^Qzr#8xS)4PlV8nyB1n@oZ7)B&4<gth?hGEak>5hsuM=OLvs2PRP+wv#;
zVd>&-np<RahE@XZ&5GY|OS}@wjI#7SD5&K=cacV-pn^Mjedyp(=V)P!tWcsXfx@Xj
z9qf>36Pf3kU0LFcuZq^}-eGs?jVy(_WQ>*mlW87@;p@jc<bt{>g_Qc~*Wb2PKUX;F
zq&kyNhN_28{{T?mVk)-%`Y)0hLr67fJ83jO97&_rsLlzHnyr8*_gF~R)5Q>CjE}2;
zpdXJp5uw&pnl7qUP!MQjWzwOyI#0eNpmj~ubuT*VT`i>rY<mIiwo){gsO!IzB=u4|
zlNkhQEnA!K@xy4a%^^i*az?}M6`_8H@T~m+sl&!qRIZh0x(!^|{rqyLNa&xZX+su~
z95o$ENIQN!{4peE={yZWIW#$?=I?#$wsDXM<CWv_S>!Coa<q5{(DOsn0TyVKD=;dg
z>7Y--@8ylwm^6orSDr#N{{X;t7vA~9CqnW}v8fWSpqp(*w&!8r1468f^bkjSLU2me
zpMT4I1JgHzQ(S6vv16%tukGLBPCWA+D61}=wS_D0Z*%cKJIHEzI)>Kj#esHny^=qE
z`{g2s!)-=ri15ze@Y`##z7WX@hiTEn#EPuwhKRF4cju4SC;Y)KA!XI7O=duER@9(;
zH{&`*fn;eEuZE3Rdau;h-=<yS2$J;vDM%sHAXZcTO9HFY)L(Co24{((V3O3D!BBN>
zP49jEdCajQ>MbU!vY^$4-~RJsh~1h**W!mB89q?vx8r-`@yBSQheXk`$QW9dU%WvC
z-?6`ZDp7QSI++hsv!r)qSY9fC@7vn*oJX^)o+7zm%-c5RsQaFN8KOdw+_0;42{y5*
zj++9nP~T#9_x!Q1h_MA7Iby`J?^I}mW82dI06ZeF&LZo&h}D6Ok$`W2+P&_E-lTWT
z?;Mc;vW5yx`ArMoZ+f%-aH}K8svWg81^(JT{@Bkd1|BA-RzRYbwDbOdAC?7BnL4hb
zO+b{kD_TyQpaA@K#CMV4j67(pgqM(5VhvZwQQ&v)iziaWtq+FUbZ9|(f!m+oIJ5Oy
zW@vy@=G>tq4lABOvxQg3hpMDlk`xj%?4+GM1+(Y|-yAc<u}joM>=_J;ayn7ik+|h{
z?f7RSGI?aD{-`S;Z}^7WZp7E`aQ!zz{cKat)f&3^tU=YWa6523!vi!@v#iCPgEH%C
z7F&P7Rh#)>LmVm_KxAMqSfWW@+wc#zG;xhg%%)u^MK0lZtLJUTJ41a_bd(J7w$8Oh
zyYoY1x7PtCVqpbi0MXQF0cN`mhQl6Nb*e%@D+oFZf#n5mtLJt-a@`|SbddxStd^wB
zdK80T3hW0z{iE^3nqHn+d}!K7ePqa5fGWHI4+CyJC}2&YMe9^b$el9<W@yf$0}CT=
z^|gB7YgA=d5pSq2yKX>H@fY|UZl9)#Xx>3O#0Qq7HMQ+PSv(E<5-{}9q)sH(+GST&
zqBcMIUu`Fv-p{528C-Z$P3DHes*BLY4)zDJ`0su2=yje)=+;O6Swx;NuvKoDiac2Y
z{W4H02pT8*gMSr(ph!D$@%iJl4g9h^C#Z6^815HGl!3SYMEhVVfXG!kcuT2}qEWC8
z)@$G2)8m892T%u4rIB_hb}|FG-`9R}ooGacKB6gQk>mjN4*Pg+K{UJXw||x%nCV#+
z*I$hR(o|oEv0@j~jqBWCCrr_}4Sozu9HUuXwG=cz#!sz|aV5H{u>pY6DU^-2>_02R
zJb(PDg&D_&1g@n|nYj6LUmuRbE|t2KnnrCAM5tZsv8n^#e{F^Zq%YJzh_JGUh-e4<
zbn#xdM~__19MVS6vNObrRIygsTW}lmKH0yg>U!9vi>ucV@CwEwlme}w6I9z8^!FaQ
z=UO{T9au(Cn3(?n%IoRLuWx)JvAmKW38#@`Z#h8r3oV5;b$g$HCo42i!7D}K671d(
zJ?_{Or0zerVgcKY@gW+z^4b@sQq-f6jav&h-@XYMf=u$DE?5Mx!t9cF;F0g`?|}m%
zB)ZpIDGJK%vD9l<2abMOxWgpfM}&yXfqWQz!ql@G<C~`X-TKB)0!i9MQ1uW2Ecs2)
z9<{}Hs=*upuve4F$n_vw;`?^rY$@glV2xeMtWxQbm(D!I`Mvg2^d7jQT%9k509GV`
z+BdDMe@`v{0QcVb(sf$8iG;l=S=uoaV$H)%R7Za(t^K>^W!7YgLy@6E5XX(TzhG|x
z(l?Ju(7<?yM2tDu8m=}5{(1Y)R@xB8#`J|xpsf5r^|JL}X)jSJ6Nc&)SpW)z*PCDm
zr?(mVhh411*Rc{2n<?e1H^c$I5K!I1{&{9PnZ@nmfmsw$rH%6_yt*i`PkHlemRzf3
z7B_O7v~D2@CYz}X*Uu6WZx|dInBz@L5}V@kksFuAbzNwlS0W-5-4n^gj4Q=dtH*q2
zoIA2cFHPbpSyX9K2FLv6hpN#T78Fx?tlxUgJv<Sy1d^>lTK6}ZVo>Kojko#cp)$m@
zhf58Qr_0|eD%*x6CzowQ_r6D>b0ppx>HDMad_l*0>Lb`t+RFCJ^gS$bM=@(s$`wy>
zeegS{>LN*tDJ20vd|mHf=Pevjq>QgA4Yt+TpY@B<cxYAu*;<J_RaO0R-AHutLX#Y!
z6__{-3eo&>DxE(~q9Y&x#AG|Sdl&TEGWFB{05Lq?44X3pzkRDFI++XtHg+JJ7I!1}
z`DQ+&sSzfU7hP_1b~<%SD1qu`NE1Sz{@1>FQ!v$QRCA`CiQL{u8yjb2Mx#xU;lk>@
zF@f82iYvDDhumdJHm>J5TW)s!Fa__n*!%NadJLnlQr6hOleKMu0AMI@@xo4^Mi*cx
zHFJtZNWP@wsG;wPL&N~{n9qV){{V?bpR=F`Ym@Xj;6gmW?f0|a{w4(UeJ~{b<N9ZV
z6$e@yS<f>+$;FrC`+wjtb;!ejjBh@{7##+;NHq_`{O8I4009k2)VBd*zo{AZe{ndf
zfPR^cT(<JbH<$T+&e5OOKR*8e)RKd)`z75CECtC%0j$X2Q1ACgZo}6<K$^*kYzvQT
z_-E$7`l7AW{kQgCP8}2{N}#!YDlSJhPhq}Gcx8{v<fQ6ko+(2GS%Wl<ASYI>@7P#7
z{{Z$zL#ryvr@~}?0d;C8U2IPN;QCe;&^$C>6J%gWG+OV_cLZ&}d`_U0g%lQ$Y1GxQ
z2jSX@Bj4wmodrpi9il(fjCoOyAYJY0ca$!&us#q~AKSSVu%W%}@x+al2Zt<cA&jsc
zsO?Ah{wt-CrIDvEWw$y-0C}P42h#%Y&`g7<l3R<zVHu2&8&SRm@F>~su<wEhdRZie
zOj4H)#r)!!1r!F{*gsK=FH<D4yU9B<N_@;%mSV=upI>|}eKJGfI<qkG9hS&K2>@}<
z!2HG(ghC`mj^j-uQ9fcAa(i-4!}HGSq*5Anh$6E91z6(w{X1m|hDiJv+9lXAl!mrC
zcp#eC`VQyV34c_mSsB>@u!mq9VSd{R`3xiPzkt5kJy%En0K=udeKOh-LDZM}So|~V
z<88oGxZQK{&$52g{{Z1KMKn>C>Q&Z7ZGK%8btxYE50-wd_HSPo+C3zFTnrgx^DTDv
z&6SpnmDhKwk_WY_SK$8u#j>btcJ6e)vGvTUC@gGHeUGvA$_WUjaevz1=QcG<NSfG!
zH&dmDx2`I?^wTWSH=Z&IpHYY#LECm8{xai`Pu-$M>U~G1NsX1X#O@z`_BYyV_K!@H
zr3U`-=yTT%X{ZY<duQh#!@p_&0Pya%n2`jgj{F?`1E!To^#^gDR(yWlyLf$13zP5T
z@8%wdPTpNNWez|0AAHZ#`DONPvq2(<wkbP?`$u<K2iFZ)=CD|-;hC`zFcI8g+iK1v
zbA$`6^UC{IqY=OJQIF}i&H($T*XN#_9^$i+fdyDvkwkjtyp)SZrMDI4lhqHMVW=$=
z&u;k{0KJCa4ByxEpUFt2Somywrug<bmi6k|tJgf7xb^tU*Ts@1BGAFrC9a{EiVM$D
zMW9rUbIzR#pJAUV&cW?p{T}BVCsjZxJP)2|i>KP#G6~2Pfx4GFS<XnbL!xVG@btV$
z;}>G_8>vCP-g%}*J@6JMFS{&b1bw!*SU0SL^)B7=7IU`;Fq_P_Mk>MDQh7PcAszB$
zfw?){@0jjc^ud1G`!zn@`z_%k`lvNVeaCN}ep4bpOEFfkLE!QZe!T>m8*KRx<KM7!
z$^QVv;1rUd>H*oketGqO$9+Sl-o^Y+hsb{;^xnGr^p5af;jgsUs_Fa*9+-XKP;=X5
zS}n+JpX2MFo&BBFw@K72g6io10G#{olc-*&r%6W)0CDJjbM9+9et&xCvfth#%$qRv
z8IDA;OWSqL><=VcC4xWXxt3UgT_|WB(E593Y#)~Y03H2=KF;cw?GBbX7pI+zK9jOZ
z`d;VjpD2pbHHDM60M&l~04)8l?GB0_zonO^>KFP_u9o#v*pGbtckO?(o9wQ-UYDrU
zCWxOg;H_<6PJPB|ynVOhw&O`8jp2@!iC9_n=`~gX7Ef?729{M+K#~A#vDorS-;IFV
zIeKEHS@a!D2IphJ?Z2k}_<E?C9;QL80*rjaiyg1NVA?9_;hLO>MJz|I<7Ga(laqM{
zs$~jRlnMjuUH$W_H`Aqxd1&gous$9C08#P6tjeV&Mx*yfA3uKM2<XUX3mCie5KhOv
zA7PwYC|EcQ%r||uyZ+y5tW`r#Rpk~=uGTj9?ST>Ha#3v60o?3=#uQ^_AVdgK<m^QN
zHr~&#>5C$xY=xUi<nVXSW-L)u?{qbG_V{B(J0d({g2_rok!OEi-z*>~5(T6lQRdXw
zb!TsvZ0V4*I|Ha*#O-3}WhYq5#$o}g^(i;N2Z6nB_#N>hW{CL80_h+HJdXPgdvk?S
zV9`d=GDqTr=WRfht*CGB_zKPnu5~?FQKhbdu73=Hh_d+>!Q9#6uPT!1Vp)M;l!cHU
zcH_3kW9@(*G>j00$P|#W0Cc@`RspX4jsp`#4x^@<*YH1{bY&xnm^+uN9%|BmUx(~F
zOwy)_OSBxuy8h{^ACMm`fHZ?tDvD6A-eGoI*W1(OhJOw@<XEH<#0gzmPnZt-`t6a>
zYg>|N504vunSP6=ldS6_>6FH->=9Z=R6tLwF$xE{IYF1fC{{P60Z8L>q+Z_>nAN0U
zKptM?<!6aZ<U)L-)ZKjh;EVv|u@_pFk9xqP`5lo8NDpwdK3Ba9{4#bC$`l}iK^NcC
z6>Ve{!LiL_vXWFQ0?u}`Rll$K!a7FM+p4Q5t+%ty{BnXeEhJzBWfi?&rF--HtT1$q
z)QRSdD-NA}SqWeUl0X}GHp7q7^Eeu$VjM4_7lB{p^jZ=T(W!yl9qVf6C8+p?gM3N<
z0C+^Qc#6ff6aWI-fmzbnNWZABYuo#GI~~4%F^~`$(t;8yi5wj0k$i>8Mb$;L-rdj3
zIz0l>nCb$-9ARei?1ZtqcI5mp6`NQi%cV^z0=D1h^}*q@Dw+TlzfG>PsK{*@LoExf
zk3GHdML1;^LhzPty*qw+LcA!1s!Ajv18NO%WPG^57?LfCO@(j1QAU_bDJt|!jY5ra
zUi{>!nA92@`fXpafDybSdI7U`MmxARBPU59n-zJ|BW=m@*cHI%CLKyPs|M^>10bUb
zWw6ZRGTMmj4;O$1)QcId$R_Xb!MlM@NgR6&2s!faw%lF=tSci|ii_w?@AS?sBLb|&
zRodHgq@C!I^TDJb)=-_c7se~d?&X*OPUe?yrchmEM=E@*8nlkb9#84L0*_u=9q=Zg
zB@wvUMT?+Ef726PokwCf0=dB8DA^Qlxb2LMrNOpT)%TA-OssH;qYlI^T>`)h=ZhV`
zEQ`09fC>TJfxy6bNYs%Nmm$9W9VB1B>x!W34#=ckpZJk~mQmnDME;`cZO4Yd*1+-2
z<VW=!QLe)9Eh?{3)G-B>S;!U*0g)uI0IuKi!*Uj(Y)_{9V#=O<8g#HUK)|eEOvr&q
zEDi2A$r1fc76RSa^v9x>12AsH8ru}AqUr=T^l%NKVkBdvZUXRgnVvl?kEf8jPT+gi
zGL>B-MHDx!G)_#$rAgKYvG4H61JMAn^KtOb1jtDStI%PDHlRfvK5FC~t1yL}B&E^C
zF;S++Cu|8@5JHotsNm70StA{^q5`94H@V{`$5MqCLwumIE=!V5{GVJq6UisHrX|wV
z6TULU-V;bb(zG{fJNtLQ<x=bwN13+t#US357JUXXA5{%o(ar^dvb%GD(YJ<1pbw}#
zAEqm{fOK!~!NvqUqe@lwya|3~;P%_T2O4`|s(_vWyj?x_q0g>7;Op}R2Dlg_(p8n+
zf`MuPyEp||lo~9c`_?Gb6Us#szAfq6@8yQqmDP972Q3nPhTGxO{WInBUdIC)1C2w_
zXE1#ros{u`$5w?kUjDeOrMT_yg+U<uei&4%HND^sOjqv`qqYq?m{8lkaR7E8AACE5
zq#k*|;7!o5J^Ku)>YQ}n%GxwR_1$hwVrtUWAU>O9%>rl|z-8u#2k^z92mtMabL;fS
zC{@CcRja<(3&VD-Eacd;zdPWn<8kktK)*}^l6YjDA&J`s>TSi2;A1<tm0Ful!`Np^
z$n9~afm{=Rjt40OpD|I*VwSKkoF_;ehQDpbD*!AKZwTVVfwteCGpJ4puGfGdZ@YR&
zz6LwhY%o6gka!l;B2fT^8=b44Oqhhk3wXus9aK2~068b~8!`cONYlT|EgZ=h1Hslv
zBnINYcac+!>sd5x5x1`AeX)^@jOrIks0+;wKO9{t(T$i8!+zIz&^Tc1sw%A6*?sUd
zbj=b((QXBcWnM_X-)va##gwUFovFPB+xIoLMLPKk5J!{}Hu!T`AZG|s-%14*E4aYW
z9xj)q2&^?0QoDY?re}gRk|{i9*Q?9vx3J1}eN#+`r96p2LhWbQ-z60KoGWYd8a|x&
zz|Rn05t2427RapG(iGh!-eM_r5#{*aMtI|nQqfsvHKaFhQhqgwEQ7-ZBS68l>^Q=;
zOEvh=tf7fM8Uifyy;slciPa<Y&Z_R7B@w4%RD1e&_sr21hGMRyYaEY%^_J>k@|REm
zumYB{0Xux~DF;_kG*YhqpmKW?-xM;ZOb8?g+n>|EFIo~P;oNuB-n>xxVk9y*Or#pN
z>?rYp%hX8yMJ%LgBAD~A?UfP_3TJ0>r+xO-x7U(0JbgRIFw&0ILsIXaj7O)66XGO=
zhy{G~wMOr2-*2bB1R+--$g!0Q3wgVa=i582j6|{Qj93F<uB;ul_-8*=8gz0%8JXl?
zG28++q4mfuyn%qZ01Bsy{e5tUZ4Oxp1XkMtzo+0g&Ws+K%P?}?fWH2}Oko*@9-<aN
zWLB+YamD>;V|0LZ0gSJulokO;CcFH0z+e^OmN^l`nns17EBsg)nlfAZVSsVHD8Amg
zWJc-Rs1lTU2b2w4H*2BKe32#?5Wunm)*5Q7_#fXmS3~@|NXX@+@bAN|wVv1Mx8;sY
z!!(ecI+&a9!Q#&Noo`I=M-dICGq~S@zUHw};PGOawYXkG8ZEvD1dyY$s8hLNbSozR
z0BA`sP5h&%Sak-{2P6VFJ^4RVn)<$|b$wV7tA(IlUH<b|J*#T@V2h*vZdm|2qk(lZ
z0yK)=tl(sk0U=v}18rYS(HBtA^$b8@v896igJ0(dPZ%#^XvBK92Eh27qr7@#E#i2k
zs@r|P&Ey%HNrI{}eez`js1P>#bM(!9EYZOLmGv2jBTBB}O>7Tr$<$8r1(r*9VWa}r
zKw*oiWdOv$3kC0BYKZvnlqA#ma+1rj0O_th1>-+a)R+un)+ZvuiU+^X{bxv4PYtxB
zuVfV>zIjQ^td3|RD}QGIo7jH)U`}unAs>dpSc9l<^8M|E1u=;TY6F8@{_7v5je3G(
zk%VM|L)~fjKHm>qjEucRN{R}U+fxt#7s>tl;6IEN)u^TND*gxl@J-{#;>y8HMSv`M
zYv5lzZ<7ke9Y`{ec7D}asrn6QQJ9G&btt6SH|~AMuY3sfqh7fSuzS(~1pR$RX@QwK
zq*alS#C3ypL~}>=#p+?|{5I(Wc#j>qRUquQ=CQ~Yd-~=VpU2Qj6=1xBMUSt;jxsCT
zl3+pV4@~L_0rWP=r*3;5KBqkC8^Zfdzmv8rRlWOxg(ZR>ki_MSY7!NyANTL?^UTPk
z&dlyXbkq&=+jD@zUmQrf4)$XJPzThU(fpk6(?KaoSql))T1Kx+<8E?27gY?7f<jQ~
zrmcnc9}J_Jp(?E-yd;$cj@$Pa#o$Y<gIfvJnlug-Z=a|gw!v|OULT1VHSWXL+Vfvp
z{Zw&93%$glyd^Dkr+tSYet8(AUY%Jyj2Hk@ja9!t90pk3dSMBAZgpxSNcZ*I^~7dG
z=~6K%UA339{{Y^B@y_Zx_9jU@UF9G;BO1}MKO?u(9w}hz#LVd;Ko`lRfE9@x`s_Fu
z7MrAQuctG`8V68Vqdx2`0jT?%KP-SJrs=e!g1`HvY*~IdKAZD_r!Im80az!Ns1`Nc
zpO4apAdcY^q-@ee;4*_?J@S1A#{nQ|m7GZC4Obv@xd*kAov0GZT<HTssJ`QJf5vxJ
zDmP6TW{}OTn5kWq9qgX>@cQ0XCh3C@4no96$5l|&b_4h6^THt%W2cP?0h!0di{kzE
z%S{UshF+k$!~&B;aeHa*NBQmET{Loa5j=8ABZOA+UdN8z^0M@3y(`Sbw}(J6*hoD`
zzsK7H9+pX&l!bLPtTv)I&0S=pt9VvNV8SqDwXZ*?$6znNwii;?V+%kdGIqM5TmJ6^
zL=KWb?;(}$!!Im21LQ2;++jjE<0vMMC9f+st2fTaw*LU83FMX$pgyRX7!i97_#OLZ
z#Ognz{G=9j11q}@SY4B~><w-2zGwSSsuM`-1Zt2FG^tR0FnK!xcYzVq%+NdwASPWc
zvd{nuU)MB!nIY*AymdEH!PY+#={DVl{Et)mWEhpw@X0O2f<G9Vrry;+_S@@>l53O1
z20*|Fz+P-{0QmY~P9F{#bV#grG%L-l>^bzm%jKw7QyJ;fPb%9*=Gg^#i50!j%%5q&
z;LYKdPZh|Jl{&NnEG_!)m4+E1kq=Byj<MRP8~ljxR(?YQDKLvu861UHMp9_C?hnGi
z$C44_1ro<9$iS=Dn1FBBYdcx}F@gn%7mlMUR2BaKiEeMc-o3JIKTRZXqIByKRnlbL
zwVONd^5fG2-CVM|tZM49Nd7vi+jv6#&fI)W4%L~WkTI4xS<G5X1!nEA18z=kZk=8P
zm~~OClbHjdHp&%$ySJFwuR&Rz<MSbomS6_9Vki^q^S`bHP)0geiJ}orADkQWHsfRI
zTk*d6ex*?A(8`7&4z(4i5qoj#UoqP=%>zPWkVvvLi>;L`ozH&P`{!(KiY5C+);Ur1
zAuQ$~EGmmN*b_%{fmMwpNf0{=qX`Z7Mf&!$>+!^qznE_#mQfz59e6@ozFesI=B}C;
z%u%Y4QS_<McifvK6S)KBnS2CJrbrfP3Q6I<h8lJH3K!}~_U(IM9Z4L9UZRRLL4|Go
z)CG1MAC~xyF_)=jkwUDCRBF|18wBykK8GCi@S$ktk~1M?&}g!vkWS?NIOKg*V}@5(
z)}Wo+R@woo`0_9oBt<Hu7Yk*zwwm6Bet#pH;gz~_v&GaIl0_)d(enXd0uI2|;;y;p
zGAb}FFHxWdCBZsCaloKA+=F$$Cl!`Rhk(jsJvs9fYqD$-en1VqJK#T6Bz;8evPL6`
zBm+qmLzWwTE4C|6l4<b%@*Ntgi9$C0clY>Xq_Op>)E=d#8kjNwY<Pr=Eq#r4_RDnb
z)AaDH6Uyo*K+oaT)!O>+M*CF_tZo^lS$e**LJKsE=TjD{C%Gq%+~*`RJW<ExNal4@
zD+B#K_WV7u<0?8yVhW^4puL^!)owfNO%vbO3w2VCi~j(J#izm~%Fb7PR0R)!0?)a^
z2T;g~14S;jR%tZyvFy9<H)2No<RpoYO7egk!T|C>4ZmvFRMu<bus8Mh%k<N}q0<PE
zYF0+^e4tso2eIw*JREMIMdAqJX<^e%8JYDkBn!F#b7$0T?}c|q1d+h<%F-C3mNNE0
zBpbadf4aN+VQQ4Lz9TGXx`5IM)-_P{;``s_i3Et=9FqW1Ea|gO2Xb$dV0!#BJCY>v
zpIJr<bvJGSKJ``dzz+aK8x0a}7#riY`jOj_?VMx_tO*EGJg6*Qsw5uOu=-}v9L@G;
zi0YmPibwzph_M4u?nc$VV<1ZUr8+_tS|@U&ZM^^$>)QZEnxnZjE}+~kRUN)W{#j_?
za;l^OFZAd)6iD2P+-^RjDbw{Qr(*Dt8x^GT*=>rQk8^zc?UGlMs*Mh^Bt{6V#)57B
z1_e4rY5voP!?k}Ibq3pe76-SW`DgBZMx(QlyrzZm#(pXGS@C|}`!X@AQ7=-DY%H@9
z0}<#6<G++~pS5*bd{LwdGB)F$*|Qr?ZxDF+2Xp;Vx$Tb|7AOz@0EQ<e0TjINC+IS<
zedw=`5TA~2a~={k!CQHp*~#@&S52txO2>bmI#={he>uqYKtD<YZZtLgGOd14`HAI;
znVu3#g{$M^`sYM^L{AJ2Hcbv|1c#<T{ty-SN#gT^M-NXM9XpdqJ9=Ir>baOit6Q2l
z@IYq;m8yUy{{T#dnKanFs2ud-PYx6+_V;90w;z$rk;kVA6q<>S*UG-Xz4DMqU6?hr
zfL(odA3UPT<0~kR>})a%;`F^qkT#a_0<%`bAk2D}>R3YnEj^oSts^(}Ga!yOlFX(c
zj7i*|e9B?z`e$Ylfg_#V{{Y0BtXU=S!SN}HB#Y$x=5(amSws?f3<x!D=Y#2<RI_Vi
ztDbKu)Xm~GS>N9?@4@=#ZEL7!0C>DS5uLE-4;=H(WK5Y<d~ndfgL8fIx(F6HI0yxA
zfZJ|1#~}PLg}wV=(5i=97i00xH}lIP>0L|n#3UWpoH76bQU~72D7FOd!{0P%9uaL`
zaoaLhroQJfvmK}WNEi7|k%^`yw)WdR2<cfs_s@U$iA(fdESu0`E8f4>eEeHFp4;u7
zZf}!|FUj{`z<+bApnvv7d-;ZaZ0%k!1QFnX2=v?i{d45MfPeP7!&?Y%=2#5+xxmvQ
z8-GE6A^vk3xvk}os!~`FNXO(e^B?_91%BCxmo_>`^sSxz&GP5hKTqlj)}y(MbMVj0
zzx6>CzS!uSO={^>n=}WRxBM$5yfVk-@=-)(>E<UwtZEd3NoP00)$V?j56m;V#T$fH
z3IHGh+RYvBjA7Hn@^~pRl)5PfGe9u{?#E-X{11GWQ>j)hTb&?V9#@h05%kSYg@}yw
z-8`<#BP^8hEr!w#)@#1wZYw75<H_WNMx-9*g`KzjKi(OmL=HhH6f29~)b1?$?!R1U
z-ct}%NeZO}@>+t_3m-$pU@&Ltde{D<eZz7UJ=fElvtR2EQ1RA{+^G!C2_ck$L$@4b
z*kUCSLnAPCsRxlkKmi1`>KC>51D-P_OQgmgg%jpAW18oE`(am?r~Xynrz1r0HM1jz
z9@IsRjc;^s+VDJ(Yi8D6NiIvS@*6sTJ^N&|!z!wkEaow!uEARW0K0AW_w@9vSmXhm
zNTJw;MQ!L;r{T|RAx4xGx|BVkv(Fjzf5CrkAG5l|`#MPv^7H=y?Ggae{-=HkvGmWC
zME<JjlgxG`{{U{={BuN)(;yMXthx(6rvmTN=o8y++u|olF}TzARdA-k@{vc_=7eLW
z&)#3Xea3v>@Tc29{8Q|-@s6qD0y#)GXR-N@#`E7tBZ0d9BR9nD%V^Z;q!PPTmGdvS
z^vZ#$Kn9fgkp7t==A{kCnNR7Ag4@gYTXFvYi)CUY5~7C3pJSg{{3Z6obx@v?X8yE%
z6UiC!?7&B=hzDjKhZm>npP=f~s*h)k`G=^@S+T|Ir(X||IC4b&KU7IR>v|m8)JgQ`
zJWsRw`1;<OIifa<FFjbL4;UkWDCd_>)2V$#%vvJQu-$OoR!30)i_X+d4s&+cX+qRN
z<YE`Inda*t>GqaYQ|ZafQ+=`sBd3p7qc<N+)oj$SnQf*U+r&LfvxxmnQ2qH;Yu`LK
z>UycSd76)5x8;*q0`a-ddvgB(wjEXCe{{VMw0h|J$kr(AfZ??fKxR+6$_Y`cV8`;u
zL=-63#|tO`soe;w&Rmz9&gH(8ibkOcfHy=MHMU~vBk?{txtPYq7!p6_kZ>-?eDk?@
zBQ0hf+<cQsc@oA{;&!av)kR-C!bKX-mdQ!2wJ&oWx}#ynb{ylH+W_YtHqPga<F)`I
z`Od4uoq@pCT390cN28adlxj&AN%r^1<3{=$Y}t<_($Q+Q<;NGS)?b$WsnARIXIn2%
zDBT!>M{(Har~Etip^3kjb81H(x%FSgpI{HQ`cLM%aeYKXa5;7K_~+*yBXrXZin<#a
z`d_8<>&nFz-+1!;yVd<V+-$QN{Aa`TK+U9YWNr_r^u=hE!CRpFr?JmF>~FM}t$--|
zz*yh#&rOkAxX}B9=-KQ<yeW+^PaO+8-<8L{d~fmR*e9*%+pUEzew_$#2Jas?^8CIT
z_cN`HWMB5UAD&~DI`WVjhX=aiV`XPkx8e$umPAb~K+_npcV~}#J9pn~i3OX(3uJCb
zeYww|{w)3<KVyBM&j>%tbq8ExwiUTk=~>{*{YHsndu!9Cs0!eZiOn+_bwuo0Ss9Vl
zgo48d<Q>l*v;fH2*1)ybrvoVH&>AeN(XazeZ}0D&D}ZH9I=rC^6UA2IvIkdXa|;+v
zw&sBcYUFkt<Uw*<LsxtFX1I}Cq-00}%I+9Q-GBrTJq4bA9){DcXc~5s2t;uk(;mHA
z4e@>W`e9Ls%As64sH(Nx(Ek9h!vz>f@&LeYNe7TO#$Kjh<=QV1^f3gfZHX5|k8MW3
z`$sxa;Yf`Xib|>wMQn6}e;u$7S8Flwr&%?P*#Q8bP3!hDRLZQ32B2v7zn)mgXKHqG
z2_&;`q<;Cukg81KWbx5WBXF%;8awg%;T;sI86nU!5JesV>~Lu=ODt95Hk&ukptJAa
z6h4O6N_}=TeMUU7h~QEKHoe0dJMCh-e0}gUt9iTErZ$6GyOTtobBZ>t2WA^rAC6H#
zIsqkAdi{9k0SjJ`ES@(V@u^jSe?1Sn4Pv-ZpoUj22_RU|Z-e{qh){yN9s6WfkgEhG
zmQmtpI*_Rhwrih<=aL0NjUWS}jh_Ca46J2ll0r+KY~B9GS|WjiKC>)(ST3Ek^JL!D
zx5o0KQ@~crfI{rVFe1(I^2J0h4~8kU+iI?Fx4-+%9VCqu@vPDwon&FERZUK!!Md^N
z4Q+|jl8iKJAh5e)zFQS%w-^z9Y5->QKbV@X{{V&!291JA-!wX?V<JmzrC1dt^S{)7
znFf0xYA13x`1)a7k?u>YQj632WfEN=qsGKo77pP1d+nU>QoBe@jKBa@z8wDl04%3m
zAVOk{>mpaSQAkwPRe;{S;7(QyG$dL(k6kxld-Ko33Ls?ydk}?YQl`AxcKKKrim{kF
zf{qrH`N2L?2WuDuq1C7cP&@KHD<E2E(YVx2Rd&n&05L4GLSxerMO6%{7fpBDlivBv
z`T~yXYWEvfF)5&e%<X%6e6os8V3VbXLTTy&VIkB{iF<?SJuBytVhcyMowTtV?lGLH
z2$aO?w;<j81%I3g86?KuT_pKf@$&g$3jSk#j{svHmE%=sAw!KzL>;cZcHCmGhzgY(
zk6(sfey&csSl_FXS%RRAZLEa@U_FKcG@$+U2Db8=$x#Pe1J2cl%B&Ry@My1mew>jg
zlT#_=kT}AEsdqYdTD|u*goTZnG^B+aW(LDz7YqmiR)GYa^=C&R(?ag6W7{BTQ^t{1
zLKb7NCrJ97kp++5-uT8<yLF*QVc!TMl@>MDNwz1O{Ia13HKM`T4*8>|c%qeBWk+5L
zur=|ZM;zxTiPZHPx^>X%HCmd}q;q|^$kS6DsQ17wsM3KRy%#{X{{Z7USi(pOZl`_7
zCj!MGjhzDl8S@?Xzsn1-5v*!d(X!RK_P|wkRs<b8@^`M-(q5ZUWA78`^TVYU6&_Gc
zo_9E}ppPn*>_On*Fh|xRJ{cyc>l813c*L3fNg0Smv-eYF`3$5wm06Lz`>FU5zDx})
zhgk$~VDW%FMkD}Rk6bqLkb;d4!vS55-^Q`2qM%l_07m<ea0@6Zx=AfmY*im@MNv#R
z_~B3<O(f~E2BLNz=M1bVRJb}Vb{POb%u1rMy^VLk3ohz>)pv*u@xjWeShoN%<9wl2
zw4H}NuQ|NyXGq?t4sqmIVjv@GG%S(9?_Sx=G|0tGflXwCfV5sRLwSL!18UAsC5Ef3
zs=VzY$-6xKGqk9qM7ZZ+SPaU1B#~7VDXRx^ea0axN)!_P&Fpiomeh(ojAbe|Wxcx{
z#sH8#g2JoHYy9FikTxXm-yLmjL9l$p1Cu24cn3%d8vE=od}VztWkq@%;iRzhRc91X
zO)z`(I2^=C<*8Elpf(xGN?6xnxfRX=g6~k%byvPKs05HUJXd@LAQSEAbF>mJ`8Dy*
zBv)~QfgoN7E#00lUGO#-?4S!%VD=*v71eZW0Zmvpgc3<LXN=}z%fD>k2Adw6)&n^p
z{m`Ti*r4j%n<E%0AOM7(cHcNhB!So~6<@qZZ;k*A6oSYYdRZ90Q%4GJ)JlsV-Ntoq
zMu)x;#?1k_I0TFZ6Y|4C&7H>tX9OWj0;jci!hun!k+8=RjU<Ag`V)z{LqlvDNZ;p#
z1F@?E+YX&O{{V3q%%CvP;jDJN8i7!}(ZKs;07hMkh2n=l40$7sx<)YtB-fa>L#Ulf
zq-mvW*23=*gGDl~p<IwhY>IS^l{BzMEwLwalt<lD%XV-5=C<mHg-|SOZCaS`b$niD
zlcj!^A=JnS4t$Hn{0F85z<!$iG9zUcWxdJv^dpSQlB`JMSt&r-9PNU5nn;zkk2P33
z9m(I}wp+j}87k>O{p&h+q2B^Y)J7<*V4b=4?d_61LbT=lJ2$W!0rB<CGIXP-2vN+^
zzVxH+)pz;+d6IY}gGY!}pPIWPe)&ex90}6M)5zNQ0Z;>Gw!cC9_@Z>AMkLZ=T?g09
zM>X%0g#Q3AT7eO&-6GH=Uq2jRy;O`o_lNgJ_gNJ#nN^f&1k)YwbM2L$Q1Z2-0L%uH
z*}X6b8>I0?(}P+-pbh^3i_0kK`hbk`DrsN}jmhVK->w7_G;t(Sv0)f2zc3Bf7-f+3
z#a2T|bx_{O9Q=36nR<4Wq%rE11qCC@XaF|(W<`ypO+bQ+&5e)wz|qsWR1M_{y8sQ@
z_+#}htn^|8s(tqa`~JBx(?}UrXwqvt@!z+%=YW~zHEix1V0H(#_wcL?(Ik_TA!ZhM
zQAYD%>7syc%#tfpi@hT1y>B1_tV~s@?2^RnJ{$9nk!p%r8(1W2RjTdD!V&s|8t$qd
zL!_1#cl~h0sz-p-UP2gw+k5zAo;_(w04i*ey_^34d1$meTI70q1ScAe(EV_&U2jM_
zcWC;5>PP?vMK+<0*t*~SXP&Jq$^mmBQ{As)mn$z$$pal|MyA~U>lq_cAx3bjP1xLf
z*RO010LFS?z8bJ%Ts3<ghoI!%dCfTLRbmNjjbMSv<1`lVVlYXt8yh>3=~-BMewsi^
zlB%S;6!U0b-E)8>>7#`-va3!3)nsWN*WB~?W?c@bV~$cuuut}p>+s9Y(d%@D+rcEN
z2BN@MCWkqkGX`kMSJ0<pTX}yx3Kv*n@ZOb}SdcAOZI9vq09d*%Xv(l8om}l(f1Kgc
zys~(TQndL+Y$$r3a-q*r0yB{$nsl!Bqz>N=&Ie9jCW=>q5EZ>304s~Hm*bh#!_`j3
zgCt95O6`8xsk&)A1Jsmg;}jXr_j`eTwg)1Q(lR-X87oSxVu^23eK_X`oAn9c7pK;%
zqiRsQ?eXuIX-qvSiV1<V9^38+`X9$LE~lNo<Y+){IPIDy=$;ixK^l(g8<IVLKc*DF
zX38R#Mx>IX^Bp!9k+41Z-?ikHL}=YaAqM_uH>7$G-_I@6!76HnZC%gY7xzfAPkn|m
zLa)&itxubE19tR3f%;$~1L4T3PlvO3x<If7;9qO~FDcb^E!HYfDk7p3n`b`fGoGjV
zeMdxO2^a^>qj#<b-L@F;LEy@*GO-Az)P3e2p4WjnUDV4oF37ArH7j>r`R$J<g3-L`
z8mx+%LaExvdpzSeP-Kim_a9H<0@3fK4&WbhEc1ZF86_28N`ltIO4WMz$f)#x)+-dK
z{{Yl&_n~C{a^Gomf64u#@S-vzi(Nz7#>e6hz>HFot1nU0c&fl^*1Kr$cY|2!`k0zY
z5A_c2eSOd3P68xKvXaQ{sZV{uKELa>BgpU}j!7+n)B_s|eTT0ZtE`>aBP5GR<{-)|
zT8=gYgX_*?lS{%JKpYziYoCA52-clQlckL&msEt4VYWbhyOMDdHkYZA$qNz^wd_CZ
zGbjNOTSz*5qO$NWP{MG90byrvy=Jx_T%nt#M(M+dSyZ3_nBSX|=|a7+JXD4ziBdA8
z*<I>~e|y2MQ3`bJG4K*Wy>fkh@H}1-@SDvpqIF*P`|Zv}Di7vaDClI~iLF+De<7ZV
zyL9~%BusoRtL}@xFg2^=S6A5P6caB|9I^tXTS;a+l1BdkKaOfWY%#NRk;d;6)T#mH
zyLPgpaqqqnozz9sm2kcZ+_3<ix992f_~4j3$0ICcM#V^FyIyE~{<&c^o)HsM#XGZ|
zECU+#uHR2?GdyjnrI`~%C_n`N0BGY1yEtXF=`_XRYG7QQM0Y<w%Ol~Y>_Al_#SNV8
zg?`YIK9*Qwk;<0^fS{+`?Z3Cj>LKxFfM_eCH`Q(GM;`ngzBm*&)5&m<#YF~XBS`cE
z>(A?qlZaKiXqGvtuf!L*74_rO9w{Z5%>-!_k%eJ&IW$WTdfVH!`N`1B)AaC4VRUH~
z)n#ErQt}65wR|ri%9F~yT=YCySy^4lpiS<^`&J}!_>AUfSkc$ep54A%WxCFueuKez
z<wN|;B2cloV@I=B2fcH+#AfNljwI>bYQLr$w%7w_f==i38DKi3F}lYLf=Iz>H83Ea
zHu=_Q{$hE0Na2bE@w%A{MA4_5RgD+TZZ;g|bm`AWE{#F;0u2iA_uPJ;Jb2tfs9XA5
znIa0dP1vAMZr=8Afz(8wX?1Myc@=_%M%m<JK-ayJegilYq(WB8TR6Ws0`&rW-={PN
zMmYp>mDQydz#y8d-}3E^(Z>uuTQkU@7?^_FfNK7JmFtBS{!~J`^(uHITAwpZzUKG>
z>(^{oWd3F~>mzm%0DL4GZ*9I`zkKGH$J4wqhIXDH#h4ouZ1>n$tN7%ll)Hv{X3#;?
zvVsSw=e`Ecr>y9t`!q-3By-0zmt}33Fd9`yZ8Y7_BQnF(1nMPc0%cVU6mX5eCvExs
zb3CObRnrkr00eh5D*m}vcwvq`E8<#_ASYsbAD8KkX&QQI+okG1m~@U^C0u!Fb!xiX
zfw2@n=yXO2B9VM?4Yi9Es?8fCaa$e_;06QJ!a5Tyb4KUIRMH0IX|l%s!2{>=%{NM~
z14|!@iliwzNgAr^{cLUe;ZFeSQ^b%dXIT{lBb(ffxgb%^5<v&@?IU#o`lV1!S=+F>
z^j)j|L(>uFSOJoYm50Jc8+nO7Z^ZuZA|cb$tA%Z4ElZ7uHa<I7%LAq;v&BiKZwy-~
zHe}RKe_{sJxcQVsj72Iujua9VR8b^te-3ipN*Ow&U=d^jgGTllubaN+#@?SimV&df
zV;c|}S5_ch6R`Ccw%qo>4y-zerD&Z)`H(jOcKYpKT)N9KjpNjTq*Xq3qki8ZfA^Gu
z<}&{PFr7NWB9UE{l<8JKci=C5`y5Z@)TBY#o#aOX_>2?t@2j6dfUf2!V}YR%wP_?D
zGd0%#019uf!vwHL3}MnnI$2g)?!>cfPikI$acy1vC}Rp_2%`1`?PS^7&#%WST1b4Z
zba<<w$rfmDcj|BD^4JWriD8k+c;+kpQ>Mot1I^y!eZR`LQKR}HXOF;Asi=VVT#F;u
z^#juvsAyq}se&hUWM$EOj&)z*@UxTf-=~wr>IF1_6(mq)JRgCh^zUZ^=@&^aSnjT|
z!y1`9_T+)U*b!`Y^s|||nAsE=2bDq68~eC5^lQy(kw+ABFp8(R^dz=w$gn#B+Wt7*
zciKno89$pb#5`!#838UyPz92AvUmRgSQ$EonVF_w1C<CXeb$uk-;AM?ry5dtH(`6V
z4J1(5dL8}GrY}@UXk+l+BOum|CpEX5jtvuk;`3zC!8cX_o(J)vGWdtes7e#3*J42V
zU|=%F$s|bf7D7smHMQ6`>+M(>)2DSXT&*Zl2L4hH;&~Z#Vq%-AVIh&VFOs$gbKi?#
zK4%27sFbvA{aF=VlrF;m0Jq+SeNF@eMDRR)RfdkvpghINP(ePx6Y<BJr)QEwCr~vK
zsx$*dNU(i{R^ItumKT;Trbr<x=hLazWK;hDm#^c9(e(X1H4#}%jp3_ntuzIaJqaR-
zJ&xX#dVj&)AaA$+$z4pcH&+@Jb+JH(745LR{eoH&qk<^4f%DJGzk``i@kiNp)H^qb
zvXvmzL>BVj$#>7y8i9l#HzvMkHe+ec^nRS#kJrQ}^2)*~pgVHMCj#Gs2df;XP7TCK
z{>C?(T*Cl06@S6bN9_<tL;*E%kWa@nz$-_zNAt}80BlAZrFAB$23A=9Q2C7!EKC$3
z0m2UV>xlv*gbYC*p7@U(QNg2Em^YM;25Eu_{7_2*pj!^)<$98^=$;Os7PQgaZZf7;
ze=eF;zB^=^S0o6*RI#x(239ltqIj&Jf*99!_R5Wsm4l~QY<P6KoSlW@79DYU1E+_(
zUH#+QtKoSTf9LvbEeIVns=iC!!QTC{(gjYPLehmI^p1ApEo(C@p^|B1kIrd_{Cnq<
z)%8Ys3BQ2N9dwLZz}r01nu%-DbF!4wGVnip(({J<3{mF3)!boS{<)f;MQld-!9g{~
zFsk>)N+e(2?SMiQ<QhAJj)afBb%kUURmGkGJ+Ny5w4OgK2Py&eQ^s%}$4`9aU=2S9
z@X87cXK;TUDZHwd4dfWnEP{u8u^t+dx1{#T7SQ&)t^<`{49gi7KesV~{Y_kZX3*jk
z@goF|`HVKHOMoc$IfbPX{w8ud9+Y-0O?-xY^k;B3t<HTH@i+&e>07?CE9IX%)32RJ
zt&H>Ye4KfHPrUvI71DJ8?o42xsQvu&>SYF`qjdt0ZrSpG!4Kr>#@j=Gh|j8WTIlWk
zuqW`$YvIdpEPY5N(XW3DbMVj1KlM?IeYMj^;fDVJ<q=oc?>8Tgew{Ho(2dEAep&g)
z{-iu(?QWGCK!v(69D(Ll)aP%deDYtzEOXuQi0raN8W_n+Lav}#=X%`s-+W2BiCSq3
zl(mqNqzVT64^Q!&vc(*Q!nuHv;tm;w@C_Qx9YpTy;V46|OGvR+mm<RK0Has&yYHHv
z48e?#BRVsOJl^ErH|xKre9<73#AH4qIY3Ga7D=#cxUK$~nl;t~YIZ++njrq0_swIe
zl=P>hNT>%4?5xL9fD~T!vAQC@@%F&a7TR5PjUtNy_pEw$*yYP~>I%&)%tU0Ws;vj?
zEFK8vx5erbIi+?|BSsp65)Sk`4gn``PnHQ&r$CXdJ9PnNkf_}n*k~TxkEd)2cnazj
zb|jUdz#^=Z@bt|CsF$NElESVEyo=(C6ymH8UB3b8lb$Hxk(b4WVWEb!unTWw9j}eO
zZ;XbmVfF@qttV>qAHQ9&F7igjgb5%BqC_m)uNHW%_M?(mgOVB5SOCWTKV)Mbk=;^t
zP$Q6#C=vs6r|DehO5pgj0SrURbSC$Aw)RgO;Cdg!ziNN*Z?s{MZm!yAP;be7fbJ^u
z^;jfX5oC;pQUfb?V0Zm<@u<3K*-udlxd^t>A+a6U7JFWOx9~UHqG*rVGTInGXiuuu
zk$%1YXRyraEm<qR@4SeEu<zzW@9C9N4(DL}*Y=#r6r?CnHYUfh%?mBtFra*{Jv|O>
zXj%NAmH^()KU@+hVN?sKzy8wVc!X?4l;{5dCCbOhqiO}G_`*Fu;g7YOqMf>DZ|FJO
zf4Xz+pzEQ46_P-qw+BBobP7u#-0|#l=zhWL8?Jz)rsYkJdEDG~tb3Gu{*lUyTiD6}
z01u{@?a0-N!y8CP1ne^`pK0}z*e~IO{{RiMFpo*9=PVQrv&6R|_VX{QuOA(JKt~FW
zcPA(!1AOJ%oONF3*D;A@A`}t7ICR&;4;+(O*UnZ0$RLf6<AOT?isRQf8s|8Y!jzDG
zM|>#_Fe*l#*#j1p(tB`DUDsOBC0me3Y(}QAc463ld5ps<%Pfc)2t4PTJapOWx}A+?
zUZNo0U^Bq=9yX`09=8)W)V%$^csR#prp3=0=|E?Gcz5Fme2U?=b{rW;R(AtC1_p>E
z(%JAI$A4r0043LsrWMl+{$K#uH*ueEr%Al;w7$=W?Z30+=_RWo(ZAx}x$62yI(XTl
zXT<q<{;|N0P6@1e`hHdRUs(MgQjV{r6ZARveLRcQMywB!{{RD@1=jR3eV^4y)5<iu
zwvs&#d%wfqYUv-#%s~fl_n)QW$rgy1ep{au($iV<52A2EHZQY}*E3BMSOf1a;QEZ%
z0n@Fwt(ba@i;#SPZZ}ivGjpBceY5sVe`@qIbf-<oq{hSpp~nY*-5mUGewtp7s(2q(
zweq^%QSLYI$j{xRT}(~+Uyoy-o_`+wiQrEk+VG$u&xbmYC?3pyJYTkBXzbaJ-%pH@
z<BmltriJMZzQ_DurgN`R9V^+bfK%y2llkHXFQ>)VA|eo~8;(xfac1k|@yoLyikL)I
zV^9cf?YFV-*yg78bXSp(C;$L8Hy{Fg<4F`EID)y6*fC`sFQ(w`ep$~grnthRxH`fg
zax2?xSfxVF#xO}j0J_qBa48cH4ee9T0+~u!i*RgLe<>de$m&K8LlDG(2AdV`ewe_j
zpE_J%`IH(Yel_&KDU?R3La$@V!U9UrhEPBbq#cJ9>-5eRsw(J<2al)I6n3rlvwgD8
zQG{xYz^fZw7pLC)@pw{&4IeJYxw`;-J7+nBr~)?EV%#?8@XAdX3{WZyas!ZicldYX
zwkvBSvm&>NVO_kVo=4+^Cruzn5)$G-10w@e!-M!>K)M(JtzxY9-?zwNSpq`Q_-e<o
zvMAydAcj#y4#V-l;6f30eMf4_8C--mY-|GZ0XK>roBsfFYEi#>?S^d%<dE7<;(;F;
zzf39msDRS(voT-`U;Mj)_+bHcEPfj<#2cc-^X;|%8O-x(3@t+_T_ey@{OJ3fo$F!<
zTO>0U8~u6jkOo#O<3>i1Ynv<VefG|878zM2LavQWjyDI;jBS1#E}$s|f!%lD)gPbX
zftSQxOf-_VyA!K={O>9X>m54}5DH~FN%InKar^Ya8rm~}3#R2w?he=THQ%`R&d}(q
zCcj`$VmG1h#&S6-&crsW^B#Tc3Pw`JpJubZ`{zETU;zv+y^q&9Kmyf{tJ`kaZNMxP
z9X?WPVcWJ5+VzJlp^2pgoyI)TEJwpqSg);6KQ3}Mpb?_aV|Y@?DoEg)CyXed{@Mon
z;dvQm4W(3l;0G0Wf1~`S<&4_6{?N7g;8AH?h8y;v0LTdp!&S9d1HSlruBWJ$LS}yv
zw5sda(4j*9Sdsyx1NV;PgJW<get3#Oqzkwwao;GR8e=bPq&A($*Yx`5O*NHk-`H2-
zfdkX1qLpXR@BVX@0c{1B<-J}J-Wur)B@J{)sw12tT8zg*g-|E3_QMH{9Dt%tHU*A<
zeEhIVjEk;7S5flNAQ8Uf>5v6L(U%M4LKK^>ZoeaiWmgAMgDGu|?Op6-KeUhu_sS}$
z1H@M+upRQKGOH+}K^)->LIP^;fUIH_8_Yz3g_<~wqNo!@U2|ANr-o0Q737e+4{yg1
zRnh!*!y6*8Evtjt`)!BCS1e>*Zp0ha`}V*hSCPmvGNaIP4#(2{aTsm_pRN++l<YS=
z`ejy62!jzx2~8*ZV{cKve|!ij^8(h&J#wBKI%_m+ZKZ)fOy-c4AflQT_eG8G5;h9J
zv1L(zcLR$&bZUt2j>A&w1d`&-kz;&G9o>m$F3fC`+~+kA2Nlg=0YOM`OL7mk1)*C4
zc^Af26v&oj0It9uPq4|9pbdY#17VfC*TJkMtXnm+9jx(!Nh8v_6G<GM_rs^gQd(6H
zW6D9^`}$xll{^bmW8XO+RhHwv*Nn(wRz?Ah@}|J~;8joyY9np{JNsZO)!nhbQO-5$
zKX3{Fdt#7U!x8h!h@%Snqyc~hR13eJ0tlIf>0l284Y6s6tzRrE>_(FMK;RRcXq~+)
zd=3^U0sy<eOr$+abgU(YR!O%2k3uN^86tsHU53YIj7F-lg8kSZ(*vVI+MetVXkZ}5
zp^YE>NyRO&3M#qvI7E7*X9R3OtK9ss0ceOMDZbWr7)e5-R-4=IjN!l}8pZX%;70uE
z{BwyM3nSmQcRSVMsMNx@CjyMh6+vCcH^IQHf+J`Ro9B$;8JdVTIl-us02l{f^uo{@
zP5YbyZA$}Vz6D|$^n>xvVdkp?*8{dHHy*>&2i+Ur!y8DYEDkGO-UIp7Luw=EzAm=X
z)=vHLf{io{*zemAgFqd(<JSYUjl*+WR&XrFh5WFF0cZ-}wi_UpU9W1u;i0Qdf_+ao
z95hTt(I1X;Fw|*lY*Ix4a4APc>QSqabzdx*0cwxF7Sn!EK=(P-esZ)p+W-I>?W-M@
zHKHWc54PhFfVD>NIf8%%d4b;p?Ind_V@L+{2|OQcc!H@jIY%{A)^WO$dZLYVM+l>D
za!yh`3lm5YNDF>zp||31AjIUcBX3Yg13f;Y?IABk988J;*Z?i8(7eL^L&+Km9<-A{
z^YE-#7&OK8GLGi3DxFJ5(-^b>8=3=GJ8$do%XIR_h|4tsM<aUpdYqKegp8PwGZR9_
z;ClWT&!`2Afv;eD;B-Auo<;E)-Nx!GV1IRu*2t;VXcp>4Sst8>$*=idqC~5ZF#z-P
z8CeMN06%@6i(ekz`9P2)MmaoE2W1K>?~kCsI<qfO#w&GGe|S(H_mJu!6G}ri!(wmW
zoUcr<L(-QcUar^Ad<yi8#z^FFcP57<@4)xR>N<br1M5Z%+l2!3f)67yw~HbILmeY-
z!A9HW$a;v_#r(s0bnFPf!mu-mV^)j>0Mi5Sd2=Hbl_V-7`?OB&TW$O8k}nA*&Vd|O
z049rXxBX-qNaI2Uu`*e5D)v9EU~8UdSmH&J)LC)aPai#oXGn`&f<m$Hq}cNx@wQCH
zs^CaK1XvuNJu>mYno(qOUxQ|X{{W1D1_n_I)vxyhvG>mER#3WE&cVFS4Fm0GCT=Ob
zLIF^2{j!6ocIp;(8lxAdS)tDL^}yzpJP5<1tc`X~<;UnYKO4#{Az2yhYC;yp@5ua4
zLU{vDNMcs)Sg(}*dtK%FIpPRnk|iV?2XfV051thXBmzebGdMlQ%4@kCoNkGH=_{}V
zng_qc50^gp{VGH!F4Xa=-iITR@b~SBH6-Z7Dyx$8YPUYwLb8Sqq=g}f)y@0-cg97A
zB#{<L83pLQwGPCA-yU`GBUx3KS>zqPw)ObpmQ+VYVy8xu!@lF6ZSoB9w}_1zC>BA#
zT-Lv5$pZr-LdH}jLonlg&ij1pJowq6a^uQ>x3T!<ww;xtlsHnONL}oF`(zxmTrcM$
zNeR-RbA79x$MDYkHdE59y8J+rE}bEOFMYlrETldZJ#a3u82R6IyY%ib$rP}o6_tu9
zrgdHHi{I0}P_kTxjKD3>S38Y{_4Uk!BmQ8RWpXd?9_QhgNTl$*MDqnBaJRjIx#N$=
zG)WY0AQ7PHj6kHU=W^Fu{40!uJBTFdVvsFOWr%vJ^*=kq)K4Vw#ncKi4<@VFfyUpz
zm2P117y%cC0&V8+f0YjS-9d?ZbuO)~y!t@g1F*l{<q?W_<1KRk0937(Q@av){PK~>
zAc{sIMbHEtm;9WBP<Z6YCzc&n94~)Q^?ABdy*Eb83ETi)_7CVQ;m-d6t_E1*)zZr*
zs8%?JgQ~5`{{V>n@r(e_Brxe!7Dn`T9G`vm85r4860|5N-TNEtKYjA=BppPv2Wcdw
z0a$>7z~666`uD=8;mEQHJW(S!52O%lzW$kMdV*t#*sJLpKw)Zk;0`EeRRWkq=BoIu
zN6>oZ8a0F_x70Rm9;beNu!^ry(-Be^3c{#vT=pKr_r6Q2B2J}O!bn*ZS|Hk}8~O5a
zI+(OLGU^3Q-xYiO_N-Nf{9ypOHJ!G-N4Guy0AnE5%hNwhknWvA63iX0I{yH#kKvuu
z!5rNSOCq~<4BlAPYKMD2p!MyUWO*dMmq61PI@+}r-+zxEz43pXG3itc049Q(BzLp*
z$}1@yRB@GG>B63O+SK3E&<uW+r;1l@oQHKGSOQJ0ZodulEYB=(gh8n#7ApS$FW>2v
zXf%XHkfT@z&#2$wkw$)@Wo>DzTRyVPzjSxlZC~RaZme|?yh?}40;`T{y**A!S<|GI
zRx}`~<(H5!k|K6!mf$UZVY&A`#^(sp19+V)tDsXHbSQ$%<n77WbNe}ysOn0_k;DqP
z<-t3H$Oh`N`sL{(FqA$KT4R1!ZO!@-_-%;rMv+J?c*?4(pk0Cun<sAHjskS4s3c-A
z?<1NOU=Lr9r#znc5l2*nx)lDMC<1^Zx%hrOZJH$NVvatU;PD+Pl*V?_PbY2n%<iTT
z=`WRag>KX;z^dB{r%e;TPKg9-D@ed9m9o@$_p^~#DzU1SjyBa>)}yw^-+`JY>HwAp
zJVc;IWAblar}OS}8Bos<VXVt~eB2(!yARI;WPL=vIAVeNY2s3(+2HKkdR2<cbur9l
zgZYVqtV)&Upg{oncKMyYc5+YC%$+<;?-TgCqu7QtFK~GE-`nAf)N36xt09!GjV>P4
zDcl3=@c8!_8TxtNZnR4?l~U)-`<nH$@*hkcL=ze3>K@b<Awl0)29M|T%}|+SR+XRx
zLa55xFLHJp`rYSsf#E9zkKx9#ldKEYeq4=L^vEL@^Cza0TA4gn1i3zdoxdD%4CNkO
zGAba90^4!00DJx?zFVS|I+zblB9S{0;K;ibPz`}!+-!HPk9y33X3--?j*&)##BqB!
z)AznmjVy5obZ<VPLHYQB!2SHUC?OEf)JqeKm<FIgJZbeOVSb+s#OWVZF0xQg`c+Yl
z1^2V;ER*Uou*#N-y)<RkFAUkcbGUEcrUywp-A7s^i314f0-}-PC<4U}1r75%GENpm
zjZ~KVp-$gZ@Y^=^-2*H_XjzdB$Ist&`@mNteoiX?04gL<+W!ETjnKGXyui_Izb{)H
zVHo0(<XKrXqPFZv;B!OijKNhvA!ICRT8`Wuz4xvCa{XCD(7^pN$Zg~W0N_|7-+~7I
zpHNaYDIZWgKLt;nf!(<vkB-~^m{Ua*QApiLDFl(+k);+IgMHC`{rI49VVRFp7>*^C
zOO_Fv-Nh658u%0P?wQ&sQ%a_v7_k&J8U~N0Q()<qK;1!rlx1B{OLm|VPp@y!wc#0m
znVM(6GqG~<?PRg5HSe2rj-7QXES*r7%jemAy!}m+?U>_{x;c_dMx_Ns{oU{D-!+i4
zNejPDv8sg(`l(9n4gCAy2_6`iN`1zvD4?5F<P*O)`TACI(!W}C^za=;i162Qu>SzO
zvh<HQSm9)mkQd|tcCstJ!+a||>kNe@@WMFquO+K)IIce~_!8<=K?+91jkO;k3{7qS
z0Nk3`{Pw(Nm7t9pWz^Cxpjw5N*q?=C^&)vtbq?{CASjG(Km$ky{Q&LSvH*lx1k0^o
zOQ|H?-r#$lH}}H2H|lz?5j<H8D!QEZ1C3u(_~W4Izn7IA<s<+jA%6b=oK^4T+vED>
z4^tdHJH)*@7iicS2_&`YH_u`={{ZcLGc+VLk;&kf8uW<9#Qb*nU<86kX(ZN)45e6-
z4&#0@tqGOVCW2t^As{ik6gC6bx%qLNA(BN`O(RaWB<v^;hT9*Wp~hFjezqwld7WHW
zhp6ma(I66b6mQzMtPY6D&~>oBkSk23BwZ@rZT9cD18&0d9Xd@6azh(3tdgPEr+q@e
z0M|R6ueY{ok~11~?B$X<SuGgdR^Jg;ez<4rU#Er?iDNp|gDQa4<tt{!#*c50I2lYu
zq>Oc1&r4wHt8WZF5;yqm?VOV|A>xt$0HCa@<##-t!0$kx^_1$Sj3|OWps}wwQ~?VD
zKnv|ucdw`!H<ja!)D_fhH46op1GzoLAD-g@;)|v;R=Ho!g<{kH0K5%td+9ZOzqb-N
zznPT9MS6`vR9>V%ddc`$_Mm+-5%oF|iCZjbNj5+R{{YXY;gr)N%B@VLkx8qnBXVok
zYpe|nWDuC*@m%z_&lOUxz!SG?8~jJEO`1s@sVJf^>WxE9jfH#Iug5dB#SZsQ2?P&A
zRDA|eO7L|7<86Vs+4nX$KQb^roA?BEGX1;LlvqbfCDPQRP&!<${O{)a4?&-)%B!jn
zKjO#p&&faZ{$`8#tD#m^-%uR+e2t&2zutt_!3};nyBnWBm^51mPyQ@&iMUVy090`!
z7Gmb~H|vcUC0A{XWNn)q>c=ANyblKNGJU*5^m7eGX%t_~W}v>ne@JJa{6dnyNOX78
z^UDnJ{NeJ_Dym+sKprzhO4FNO0^YA{%$^;hw6C!wZR#`G`!A#ZV?~g<K-1_?KkplQ
zl5~P_ZC6sI8XpVGDwz@qoD`BGL0j6%uh3_qB(O%^L||#q6k45$tn++Dh<GUCh_wti
zvFr62m3x|Yx?X<g_Kw3c^;579{Z@3?fNIxj$_LW4S#0v&xf#E%r4aAi-#Vil#BH9t
zF*_L)Z(_UTniV^!KRne8V|8_{#rpf>JPa1p>OPrcFYSz3=1Ut27pD|k9V_!W=sFJL
ze2a9Ti(Rv9OiM2)Y7MgPMmDRvK5XODy04ILhyVk7yejGaKmpi+&N78>D|t>tZUCwy
z7?S&494YLA5w`RvEen)7TXER>W^GnzoyIcDV?%th=xJ+0RJEz#jEP?jtChp!c|0@6
zVtZn#pj7wo>5T`H;a+VUdKr|hy^p$b$I7I0c__s=)wsSh3qm3MM<D)Rri=~=Z_7Mx
znLxIyp`MTNOyECGfohbWul-^<>H2@N`e>5RQ6l)Vdk^g&o_V>xPAs$eKBxE|A^f*l
zC;tGWRj-Nv09o}NT6l8K7hsWuuiwKw58)_+eU&jE-0CmaJ?^E8{{S+1I+S16C44z;
zJ=o<?Bmnk^0)6X0GXDV72Tr5-kaWf5jlYypXo0mIC4&0{bWVPk)iZd~?Y6@|DE>bv
zzs3`eN|Zu<07Y8-57#C9GsWfLpw}0OqgX+scHCW&wQvo79=JL~5Z26Q4uX}`kfY26
zn%=09x2VAzBt;}g(%@Rq4MZv5+i*U=SDGyyY*2Ls3ev7tl}I2_2CL`4uKB6Z5ke#C
zqJ(&k&H#}V4>g~Eiu3J@)JqVXQbwua4FIXtsfGE8?`JA!ScFd;k`A>_nhF3~paqTZ
z?_a)VX<hY}B|@nvmUOMQ;1Ay%;Z%}15EU{%iKH-602`<~oBsg3Sl?;N(*|7$>sqy6
z;rQo3P^oQp#Yxh@X$m(#>uzxw#5Nbp8z~E5g2L+m01wXy0mC&gE-139(V|5g`3uWB
zM+~|PGe;W&wMxYe5nx>(trK0dD+vsmD|7z<mjmOEtRgtD#JFzOD*OEYe=H3$u#cuq
zLfIv9N!qpm4K-bfyv+i`BvOZJc>&M`nl?H1<a}#1MIs2;v})p80WPQ=?{9%0GwqX|
zV}!7dWR^0(jW!K{J$@(Y@W5r%y(IbrfvHc2fBT&JdVaXwH2p_KDs^creLS!*)7ae`
z?ORoR@H@&PMJ(PSMPy|H^w0obKG~Uc#OdZI&tULs`97cT1NFbKKG}=ypR?1cLKVL3
ziT?lw@AA)LIp~{PBW50>KPUbh`)*&dKGBeY;`GjctljjE<FPy6uRi(ugc1o5N{p-+
z0;C;?IkvO6HS4KuSJ)^tS9Ct3F0vhk{q5BHA56^>f}mcW=zaU;)B<c84Zp#&Hno)N
z7Ip{lINc{y-)HrSI{nZ<kb7h`{o>utA7h-v6*}zy0Be7omWZ@!SyJ;$MWOd1M4Ba%
zHn76%VN+xd`SZWSpJ)_s<Rx!k4*fkd=+$(a@1HNq!8orm^!x4yE;$&Y(d9rra)8xc
z;x6NSW!R8&L^|Zek9y7r;aCfKg^LH@7;JsBIA9fC_%<VKH+DW)hs)pnVMOi@nz69S
z$>s+`0L$Od`{fOL;Hx${$gqtMyIb<Z(<16FyJnd{EGuUtY>R;QI3tninsVcd)@v=;
z?=_vn&FW&Jdr{2U>GcuoTkbi}Iz*=1Z23+`8OM2vd$=-1>RxbOHVo%(3^*|Jg?0}3
zdr{7;Ax_yyq|k8=bynvKF}H>MYxW28(4VxradIO609AcJ@AA)sf@9N8vH*1<&)8sK
zK~~%yx6jPKioVA`Wc{ZgRX!8>(EA+wZ{yyhH?OgI?;als{EyROlkd_$-SmHC{h|El
zOtLLAAPUNRjM7(dwm}|bKBGQ2><_e0Mb)n4so0Nf`w>pGt>r#sKc;<kXK?td*HX(a
zk_cUc@$7TY>-t#w&YD;{nDs{>DC_!<eDz&Xl#&LQ_5RlN%<==vF5_k%-np9x<6ms_
z68(qOKS3img>2}+ef1)NALH}SHG}C=KtLM63(4F4XX+ouUto{5`T${2daj?(9f9Xw
z>-+T2%#4U#Ouk|cs;%2`wf6MQHjO%IZNOTP7H4JB4w~Z4cKBi*oC2)0QGqru;rZZe
zasg5*_fd@$nqyQwI<kh;%xn_8SFrcY8H+3>OZckNI<aL4e2sj5w~{IgHEK2YLi*#R
z;Zjs+$qv3=Hb3=viLhYA>e`26^ZI2#F)~Ih6|udJ-HugVPNr3+(XiFY;GdrRVN%)*
zj>rQwd5Eq!p}ltW#n8zqiNJ`bETeIN3P`XCSc+mmzIFrr{u#g-d^nl33lvDbAo71)
zdhp9CA~*|Mja9whrr>2Ij%DeV7m7ttd_^osUowNRJ8l3s-)s(#sp-)ql1`slAZT6!
zkjrHI5n{bgLTA*9;1RES><0i3rD8G=!Ag+C*5<RLPdFipjld(Dt}q-FApOul+K+#p
z0RAI9lRGg3V|(9hoQlQuHo=Yk+8-b?-A{s%!{N!|l7zLcod^Ct_0P{BAjo=TZw}-0
zAds%t++TCJ_*lrsNRT<LuFtQ_EYh(CG+<*Ibpk-#Uc<d}_<Lbu6aZ2xe<-D+Rk7pi
zl~PDNRb#AdELr_Od|@r1X)L1CVmn}0c%51{8ii4=_!wzbU@Oa89q-rI2z7-_4>@ZH
zz!e^*{{RiLB;Kdsa0W7hl6h>EK5JX7F%>RUy&>CC^!a1~V0K^vQLRIM)p^D`Wl)MN
zcWMXc+Zr_`e5cRrbwdCO(gd~xd%w@=lmi+$P>unu?_r$~R*-pyk-e}Ty^rOFaiTzt
z7LtaUO@e+SwszXZs|4K8J-c8N45Bt7Hw&=(i~TXWew@leq{vQ}a<1A%0c3C7f!inI
zIFG|FLf*O`o(%w+XB!QVKP)P#DzxF64-&}oS@q-Bjj>gtCPKiEYP<gc7&n`88MK{D
z{GIs3ck@si3a?Bc=^+Dd2K9aOl<Ib7*$Dxw@Xiu3kdjC=K%w|!_$ERSI;aa~#SOnR
zfPm^?6?hzD3X)V=7)CZ0Y>$uYodcMbMp6krTe2FDHQU>KRT4^GS|?8BxxnojZtKu*
z_~$!2k*KL<+fZ&m{njG}3IQGcaFB$dw?FgPei#NA*_}p`NGD^kuZ}n}D3Mgy77cKJ
zXArXJJ-Z6;g;)qhH=54Dc=_NF4uCgCXWK|NN6R_kXk}>1KZv#&NTLsXOJt+_IMP1%
zsI`g&jz{cZAOf~;HSvw9c_3<0RDE)@&k=$s;OYD_tNll^OSS$RR@nng0o;?x$PS=E
z44{$#6}4wL8uYOtM>W23sxWUb2B;5QtHfDXR=_B#9E_rFS5+4_JB;VhYN&DL!QquG
zLK+*{?TnQsp(DDABv89<-S+t4EKHi1NEiw=OJ@5F;?zhg565ic{{YibTpK2^nxe##
zK8NLjGP<}!&lvhtDPlB|e4ri&d{rQB1^VGBXvA&3U>9~)DzXMq#c}k`F*>LuFjwQ>
z5P&F!+tlTCiVd+h&F_Ia0E2dM%9W2%6{~=KJ#k44)&*JO^0A)^iwdK9N`qfq2}yTE
zY4`1%pb~7>+<KgF(Tzoy#06+?T22Cz74cYXc;5r0EXt}u0Y?Pi&lTLVrod?xV;Mr9
zC=ATiL}c4iww4qD;{mj@Fw(q@s9>)?fJJ9JmQ@;>ha2&SapnVJJ~e^N@r^rbs<Fl?
z^H~c^dCDwphh!mv9B;Q692i*zjdsAmg$I4jXBP8X1Mnj2I_R){K%UqEST5Io_`shI
z#|LauNaMBz1nw^IA4x;^Xw}gep^I6q`|X_8PNRfyPY19k0G3u!Kv>%G81hA43MYIa
z7@DjCt!CQDz4M%=^<#a3?SXAgj16wY@^A@IK6vi2h*L|xv-g463`SC>m=Jvq2LkDL
z7z`9x)Y~3T6QD61(AyU4VZHXkD(<)L4}1W}QTw1@dcnPsbTAR=oNOH-i5~s11y_5<
zcGgAj@!vTBvtx7L2G&K9@WA`7rAx<gDO4x>k2j2+J4L6=?R!x5$n>i7y%rVf-Lq4q
zkQJ+C;1DRE)MOcqftFyJA_Viv9}JTn5i;2tyDxmNhE_#W8m;f9_{|+T>5<qyG>S!O
zHn)5Hu%ziGF;X%HBwc~U?YYU!EyA;Tlx#0${5Q%4c$_jXn43gCVmYi{uces^%hfsl
zr4p*vM{m=NAtjTiA-pp3Oh5|5Z%h9G81X;`nWQ9X6rs&n_;PcRKbDd+2p%b_--CQ$
zm@(b87B@z${JpRyu!AEK%1Jz5`ppx6EMt#ySk-_iRedu*PJ&1Cf)tz9c^@pVS2_~#
z#jHX`l-IE<??>Z>WR`VcAtY&LCXU{l(D)41()7_zs*=d!CFPY16WC@X>DD<-sctnf
z&3+-76=Mvk=%nxavxH4_X!8mnUgnqMilJwpOp+5CeboZKKySatEEyZ8mKfEMcHu0L
z4<w!k8J*zp#ifVTMT2`*=J>$8dSO8##tfv2EI)Pd&S+0YM~*_s${Yf3NcR~?K<Py&
zCS4~}xda34@0hxYU#N7lU7CgNNx-C?M~VkdQ(mq1Cx4D4P{|ZNYYa_O9w_CK4+cfG
zb$$x&E8>3~tk<bn0<H}+vvEXm^}>;nQI<(dojYv2o_pYc0Mg39TK@oR9kIb~r>l=e
z^(+aXRMQ^&a(DXVrFo(adTa^`7K#1Y_~8%Ju`%71)pP*Z3K>7NV?_v2t6Ns4Yhpm&
zhhdfRrDY6bi&ZffLVyGOY(7IKA~DF4GP`;P6@LNk&IKbf#X3a9HTg;8ueZl+Z?w_6
zKeQx>M(V5gwVFS@vQA`Pq2vs!Fl#4OonGF#Ml!33T|>yneMfJNowmZDh=yHh9a;O$
z{lAV0x>PGGA>OTQ@BaW<t>qG!<Ue?T4uM<zxcOvdLo9C^f&@g-ZMGcP`d}W0Kjs-_
z-bWr#0Nag#9nJyMbsuSU^0Z^bde+ED(f|U<JODVs1d?>#7l7s|0}*#swsc6Y$HQ+9
z_GV+p7q@(Z-7J$y_I$D}h}0KggJJ1@*O;R#EWgxOB%QuI>@$20dVZ6_(M)K7^hY;l
z_B(d0SmcwYf=21klcPy+wp1JM*w^KOiTqTFRE<J5Hdl|C%g@vxjIzdQmYlKNpYetz
za&$Ch%>^2U%jsW+FINeQIHV4&00%+%zF6s12H2Vh?)D$=3a3TXMmkqXOr`f|kv0l<
zI=zR({?bW=iy&m(s0*?MR|o6HPeQa{>F~)EZ*orl)m(i(Ss%ONh6BVD6#oFnee3ed
zHP6zXmKf$b6i96c_a4_>h1edsALVC)PYH+`kg+wf2P#;>;v|m5x_Lql4+8Pqs1Foq
zWAl_d>b56(B>Q}@jBPaVqDB^+n+Hg}iP#@ZF}#5vs30(7;p-;opV`ei0z&h64po1r
ztddsw-24Xv(+5}4v}Op@IO*L3rm>?|+nV&d-}1<(juvP?m@)$xV4(6??ZEWOiDc=T
zS7{n2w_uul;l0Ofy10j^3(~1{AZcdW+iL)wx%y@*og|(riCV(FQK~gV=ihtEi!==z
z2I?M!fr$!!@!N02WTA~Ck&MVhaw*bCqHEIl_sexG6Rd~Axe*X*E!^^U?Y>W_Sxf0{
zuYz|gzWWX^5xS7wDs=X0DK#-u+mF}R8d)Pr0abQjqr(JqzSsHuv15$OB#B;8xS%&D
z-{<}@iAm*B(y|zoC?9)KzC8fQ2T2c(U0u`#Qdy{$Z{MzR&gs)l1e%0egK4VN2Lm+q
zlK6~fRxK+5;?UAbyZ-<i?eNU-O0q=ZK#;f~t0*Nt2iE`}v}KYcNh8$i0^4sww)g>$
zC~lrO9oaQHmZ5w5e*JU0uLdC(fbpwH4~QuF2NiwIe6c#y6Tt(iWtE(UvB>Oiw+8}~
zi9>igVia`>TC&^war$?`8HQ6dvg$GJyPfsbY9rWx-Yj8b>O3@*ogjvAO%GkiY&~%g
zLKYTf`>HC(V_m;IDpE0s#*!%hT%BsDK`eIzf3Dv6&Vm^=Pb(uc1PT({O><v{QKM9e
zUjG29ti_ZA<)P(25AlJKpQu^lPaun8`|bw+04u)Uyx>9y{*Q$ujM45*-;;5*e7ke7
z%S$4v_=FenNz!;E4n70?V4I<ME5)m14mTW7BL2Pc)#8?K9N4JT%vf0mjfbVy-&_gB
z_M6AhOAm&Qbm&sR4L)l%-0@e>%WRAE6X_<<s`;EL?06sOVn-_p5V2KdC6s6ze0_6M
zv%IhelA(y(xbCL5<B@0Uffh*OXyxgpl4MRvQUqk>XPks8jQ;@3n$@U%;s^UQJ{i%?
z;fc~R1TJ;>VTmO{J72(^{f>08qP%g19vqAwhnTASpNYD^j~E%%b@ZY}VdS(mwvovB
zo$=L*ERsaFSYE2#ckSulIw<3u6(vv|<kGtu9lcL~Or&r~3#?3nJuGR@%WqcmcESS&
zJs<NGs)h5gvsLZ3Q>l|u>tr#c&96W^06ovJ{4*;`@F`fNDttvOs%%{!%NBl}^vGnj
z@W^J{fK3gsHpw)~-8ha#4k9w9f-XJi1L$@edRAc&MJ$R7Nug5BiU5&dZ<?7pNhzX@
zn8~uUo(KnT%hPjRuLP1T!dG~XumbBQm)M_rum||uAuN(js1*_u8i@b_LZ~BQw%xb?
z069n{Fm&BUi8Pmw!5~$U&0lT6{IK+=#+~Mk2$59GOHff;ow(p|JMrm@sk$zup?gr_
zLv7|?UxDO&un%1}sN!$sp$tNj;F4Gi2aW;s=WFkgfTV}R(m`qgLED?JbH-@tVU{In
zbwePEZ8|jrw&b5uJ^0*WEJLSNl2;L{K9p+Sffu(o<``8W(<h2xLM1VkR@`alPy>E{
zWM@y(%N!zgREBxxG0>B60{N_Sy@C%M);gl~Gr8$vu^`fjESozi<ef)yN4KU)I%RpI
zQ153-ua{eIwSj(}iO3pmmBE8Zm?bSLn<s)#<H_S}%`EcF>g5pVY7u~Kx8(cpSM8d5
zdFFt(QqoJJLh&=kMY}NEQ0-Oq^~r>1X!=MCqr}eAFdNV|d+%CDC$Y*cCyCUrTNhJ0
zbng=>@CuuD2Tqmrpiahx4^S~-SmTXQpn%A(+QH>O{?d1{RlcBNbs}HohgSVUB!!p_
zerGgCp#K2KoAx-cEG;8JB%&Z!%-U?0_=`2i7#E%4>m^BJj$o3Ce>S4cM3MmX+v)GK
zKuqcdhSxHp5g654i8MI^{{VHiWa|+0tr~_<;ReWV!+bmQ@4sxD?5wZ?p_CJL4&U|L
z14R8qEMTN0N9JZ`*Q?FB(stlgcgl3>EUw)`hF=wnB!pI@b*T2BeLYV**Pl39C)9!b
z%s>hF*7>OQZPQ3g=_k(KLsfin=tmvCxE7PA>5DUTy-P^V<Y6j=VAKFS*5tRyZ@y>L
zvou{!pCS+$Lh@C4HS4+gAC6UHS$ar-nN*0$HlxS`9gls<AFwhD;&l@WRe0J(Qyg2C
zAW)?gclGap9w?isA}KVBq7MWeuYTO~n|gn;WS{KrudYGj^!+6X^vR^5CXu%W!D2-X
z=pH%DY12B-7mm8Y*p3F96~D}kX6mh(OSFKvJ9$C%73uNfu_SBk(sd8iL(}vzJYErE
z$^wAenLsw&)q}C(&2ya-BgT@UX&xDo0y2Pf+ZrAC1GjVY4IJOg#;haKycOAqAP{|M
z(5u?=Z8R)ot!ry&Ltc=3U!@X0KG+{a{{W}4BmV#s^iOukvazPIK^y%38T!d8<uqLc
zJ9=}UnSbfQNj~3Hbn_%KX=SY?Kmvt*eedh~S#2{5<HP+kZZ|%EFuZ?uGDrUaO|Y+&
zC>34_z^-%w+(Sd_jLBE+2m>}WA4t|0(l9?P$^1ea{{V;0pivrsF`Gaj$WLWKnZJph
z6YQtguz3}B=hyVg%OB1k8R3>>j)~K`&#U`0rdZ(d5|k1csr8|sF%ua2h?&SB8Yk3e
zxhGcb2lS0Z8i8JFveq7~!hLU4vQAYmOpT{d9^{Y9oX;$t5@;?Nmv%VPI&_FvR;D7(
z{{VN}JgKEJJ>J*0cVfq=+_Q?U{J@wIw#T+0m6Y$W_~HdBLj$+2JDo#p-pKdj`S&cl
z(C?Z$X*DenFLG$+IAt-lZSl$*Ner;4rao_D>zw&%_Y5so*GSz>fW%SbGk-2l=)n4n
z(;G)3mJFbl9G*{XX*y{jw@tw}@%8-ko-HuL!_PNF6(EC(Ay6y<zIqWdP2zZwl+x8r
z$vGD3b=gDY8`f^FZ`&xd&yo!`QLiS~q?57D@<tWHt+&g*LRdW1$Ib1VqR}fBhFY;>
z?_&d~ZYbk43_QS_9fl^8c10Y?knF&McR1_6l-I`*NNu}}JDs>AC@p$QF$dEGTRQ6E
z@I8^v_+hq@cdh+13wSj0{{V^N@xIiBMTPK%`wKh$GZBzYBe~kZq3AQ#{wGkKL~?g%
zLjET_cvK#H)_Hk;QsK$+m+3#kV*bSh3oSaS{6Efmok$^P^)dmTU+|TWvSat^Yx2)p
zRkV8HrUUZCcyimz48Sy#Ujei7U*lva_>1jd<~3`cf9W#&H4uCIZJ(|6TNzLP0Hg!+
z&&NNF%P;YV+Qpcy^%4p^=_hTz2k^{q;j<KXc;;ZT4G4@@jS*^8ZNcMvKKI)UZjndg
znI#T~!wNalMP1*m?THW)5G6WeMI=$P@E7l2Q;*Y6Cr>Z+MxcPM^leGqN2b@uu4`{P
zL?!W)#Yl^}JM0yGPv8LGlZn(H<}^K*)F^`64fysO6Sj9yBbmX6Qx6G2Ey-ia?PBb2
z+OgW&4+=2r6Ckq05wX3A;>qB8;7w7YR4X8n-D^hF0l$v^-?7v5^TQ<GHHl+2GBDCn
ztn5cUjrwhc%DHBg$sFu;5DJxGZ_|&4_w9ivjz&dTS){U97B=HZ?eafd1QS1+GHrls
zJOO^5ybLVC{3SXO0UN2J0i##@qH>cz{{Sf*gUr(tugCx-dLN(QF&QI3vQQ*7G-mv}
zVF$zkoscA|y8=|uS_6-t;giy^kV6NW$<=4e+!6A>-wmM}5?z=$psEy6J5`(XzosnG
z5UR9Qhy<Os6|e+*bNJy@5Hax##E_#%&@3sxTlCa&Ypyj#T_;i24}Wi_Ji#=N3&kJ`
zCAbH3V{R*p_s3x6Wg;d~E9y&b04KkHOTbwG(j5Y8Wo9Ba-A4Cy#>8#;XWoAVeYG6F
zX2sAuFrF2#j4IdL*KPiO*PjIxWNOk3YoLY#L8*sv@aMPJHbK;X@b0Up>fq{*v{9{v
zk#=_NwE>nVOl@7m_2hkCP<_<<=9tc|NT&Q7JkPWG$a?;cKB6I{NVliDw{U(Lwl@s4
zMF;2D`sV1Jxn?xiVU(7jcwu}WT;(2XBFgN;)OzB^`fZwvRW{wdalx&Wl2?oV<;seP
zTuL4{Sl&8iVrxFPqw3eI>D7`%b{jU6V)Nvzy^d&F{{W1)**|EGgRG;p67&B6iOxQ6
zAKk~>%spR9=6e}+J|*@j)wwx9bq(?WgG6Nkz4*_X?-Qwgyi81P6bJiTI2|I51sIG&
zdmJH&73rBorj7wpM&|ua6U}UUUJDiGJK$0t$8pHZwmK0+QNhTvC~;ZF&H@iT@UDB(
zeQ{j{1Nh|t^6$vW5<uJnM(m^a&PiBCMIN5{hpCU#Jr?4Q_qf}(XOcZuGt2c3KV5pG
z%fE}4rgbkUia2@SE7V7%-bdk|J29!#*ooY2+~;%gz;KEp@-h+VbG?oW2jh%4*x?JE
z@x$$%+KxaKh&hw^kL-2(YwW@mLFys}kox+J*S&9*f?X|KXGa&2Y#AdZew_TiJ#*ul
zTkZJk27+BXt0~(1XVv|K_KE6Y5j%O8i|l)6e;xgY{J&HG0K{Qm=}dgU54zv)K6C8u
zt@=)&I5azq{Xc`tuOl2}tMZRf;oFavaoP7xOuCN2j+P#W*C64R?zJY&Jy$6QP`ykG
zGM!4om|<YShju~#0N*ZmyvLm^eqf{Gr$0IVIQt>K&+5-r)1rtvpmh=lk*pF1+i`d3
zNYB&cj2)|Ex*tz$^1jvkIv=&VIl4)Q^yU;#b#BM&l4ESEZA<aB(vt2<0!TD3N2Ou~
z)vr@qR@LjaXzRYtlkCo|`d*^aSemb~-}0^RAVDTTy21mhj`i_BI{D_Abim0PMyTRV
zY;RyINe6F^+x*5O$g45Z2^Y4#>)+#peIPc+bE>ZP*na(RGd9h3E01r7&mdxjhOfPK
zz}bKA9#v@_!jQndmvL2o-G)dFgO>STGdi=WJ8xuqWdcJYyrNB7$@7*w>b#=Ng~OD0
zw9r+FqHAm1ZDR3N86tAZ-e%G$Y<+k7VT`#dj;4Z^9>dr0z(W{OOwJ@MLnfX-9(l(G
zL*@#{Nh(&)m3=+A!7QeE8d9TEZomKs9)pZffpuzNTa&-<_Ank-jb$u}R%`%h4)i(T
z?UGOn`TVMP6_r!r$Ug3*z75$Qhtm-1KsO5^Hnqs(lZ87TpF>8d(lwfwRc-D+-XyMC
zh$l(_ppoDAc*YW-nWO?nD$0QDK?L61cH7?{s4h@L;>V>Knt%gxYOHg>p}_5dHaeqs
z9vGq*Ks)bd{$JxJtbEGb-BWsHB5gAgSdi-5k-gF95Th)LSwJ0$;|S1^x`4!MRTRpk
zfCnPa6i>eO@XY;5Ul6JRq!K6sD}O`3*9%-~Y3vXWl<j``(!(qzJV9E}NxyO1^1yKZ
z7lzK4sduyQ+tXoP@nokY22Uxo=DYY{LZUV<4x+RGHS<2BCI*{2H3}m81Cdn?8yhGE
zjW$mQ{#EepjUW)TdKuXrb$V~c-#+;w4OuH>S-#@{eY=00A=UK~0t&hW_RbMQpqr4$
ztZaX7n%jHk{jyuNoxO%Oog$9LtYsB3{{SvSIkMI$Fg1s%XqsSQndDVe-PVcniyr`X
z`DJ72(nOVu#*xN>=$d9Gg(xR;X3wy^&mcyOxzr_QBq&;4KGoj)RzX72Gbs_Mw9-Um
z?swg<zD-$#O;l9#@0}y~&dgLGp-Me~7||FOI+iI|(-Eb@(XS~x9j~8XY@i3Q;0-!~
z*l-6qB-P>ofHwPWl!W>8xYQU{+mY{pM=ULD83=7QMG$-KfYVJQ$>PdxM>@3}lLykY
z3EyvgeFbgXOQ^K~xBK_b@m#K@6gU7Au=E@6fU4jik4PtTWbt+WGLeYb1S3NLcLMLz
z;fo*$-+4`_`-hFOWh8)Vj|Qj@!vL^GArV})Z+^bs*d2A-=?VegN&PS;lmz*X!*FW9
z&NZUFsdiDn{7Cn}SmbEfIvpf?VK4nf5xHdtZ9=PjdSxpq2SeELH1q3MibEpC<4_DX
zKLdb{)gv{H&h@qBnH{`aC3JvDEqiwO;t3fY?ujCfp?CAZ2`Hfb)f;VBfMd|eOA=n_
z4_p+ZSp;7j;+9auVZQXey|JTWnuz4>xV?@7meAf-`=^nFk3BQrzc>noZ()qc0+x2<
zSlfI502lxg0bPLRt9<P$^ahl(xi_{DfW~CDphBBH>j{;LGHO~hc;9S-OgzLF2YS3>
zrBArUP+05<Y;fd&v<Ucblru<WQ$bRPZHdHc*oA82e)-gZny?2JES%t2(%BvP?}5v0
zuw6%vFp|PO3&r!sa;mB2n0EtXjrWj+ssn#q1Oa^-@0-HFT^sf}%FK#m)^w9)0ob2h
zGHR8z5{g3I0b75Z34mJY9ls1CNH%!%!$UyO4#UlOn)Oic+X1SDf(NB%cx_v&S>tRi
zY86!b)pyP@Hjw&&_PhWhVIPQiy7(LfY#E6xPkbokYTEs8wkqoFWO8sA1--?AoX=#1
z@+se(0m`+70E2WzjCls6@eYxw@S^}SE}c4yT~WQUNdm=Q0Hx?CyavX{YQW~&yX~E*
zj^tl8gas;gH;MorhrR>&EJ!3!E2v+5PSu6TWdvHEOl3i~qeIu64q$0mo4<beth5c-
zJXUs*dP83Q#&eA{0l$18C94DZ=N~t&aA8Dx=KyH1G%yt3)49SZfC1kNDFp9+_y8Mu
zt9%9r%|MO&`eL&JNXB@X8%Y##K=nNO;C;{8-V-B5!)!q<w><mhI(CtKO+`x~Bzbqt
z>j{iQAu6TK1qaRkvY;5G)E{lWSs5mwkqoi`IOl$QV#v(1nMnm&jSqaU+A>Egq9Fh(
zg{9km{{S8GeLqa|9}YBjV_H-TB;av>6f&u0BVoN>04-HnixI`<j+8NUG((;Z?_aTy
zv|ge}*u9hAa=1W|<T^ATB9X@yPI@!VBSRC)<78#f04H(yclc&0p>CbT1QiB|1nzs;
z%O0WzB04N6FCxYVpEH=^WsHU!@5wxEj-VJ;Qu=g|J;^_p8A<wPRYq2fC_Yslr`IL?
zwvbm)X0Uemz<qAc7DI8}(>3<QUZIwM5d!EW9V#d(vGVoJDbpDvJ|WpflfV~Vo8k`#
zr)eRLoT#d1^4P23U&{bbBxuaaJcMu!-?kPZTT`%ADp^z;uR)TIAw2BG$Qo?=;<PMe
zR62E6#E$qHr}28U5`~dbMv`mq6Y%2r%w)HVsY#E+6=HxCJ9_4)6U56Dp@xz}DA|GU
z@We)pw5aY?RCzbEbPnE^T;&ZHT_Zp(#cHxo-gDZ|r_UMsgE4tsV+^B0px(~=-+x=k
zogGAC2elS1j@Q2Xci%78bg2qQ83mbuVN3u)ef{Vij~Nw>dW|;0m@)!M?fc_6A?h5K
zk%IDXee*=HK#<!gX@d$;xa3{m&o$2w>$+%U>Ea3_@>d$H-^g#zz61e+89|NpkfxNL
zdED0njj}TI-9sRqpGaaxn%{drO8qfme+-#o^AS~BR#IuwRk=$sAKB@!-2Rvr5W&*)
zlotAi*tkD*5&7@=;%kxmPaL6GiP1w~d)EB-!dS?HHgyn-U>A3@uu^DQ*m1?;N+#)_
z!y!a1q!D_wsiV2#_`1R(vp4fv${?Zu0BpZs_m%08tdd>5A1$4S8`sxt<wT3Au<RpJ
z3bQWdy@!4O0AmJ*=}JiZNd9n0-G_7RHaJiVBeteZ8e7ayZ)~dTifHdeX*I`}xhECY
zZm+3(HoKAt+$h@5r>0GrWn&Qtk@I^V2G)IdJ7492tvXehJd<@X>Pi6WrR+XuzSxf}
z9Wus>(#%V0aa0etz5&t+niWzATOLqtuZ!)#;_^YHf;l=_7=T!YKzGzHpJ8|s>N<j1
zbopZ)wQf(TIj%VpG9-;+NY#O7QF=#uzD@~GLdubd-N{;gJ<i;5@7}h|F%K)nK9o1)
z(kv;+t(y97mPTkqilp3Om=^=K^|!|${Zl_s9ys*8V@)5K<F*eDD5e36Nk;V!{C4@A
zq&^^NI@F6yA+)#u0BGNO_TwrLbkcP*uq3PBi0sE@9}iz|hCJyXO+1my8!Z9J^L+k3
zov~r*L^DaMK^n-Rm5HkT*8>TYq-}0iMwP2Y{m|Q4H_q4fzibE|qD^X`6-BZZ`~I9`
z31xRaBC~~B;86IV!}c%<VO>e623OVMH}`u1^ZYWabGvltRU>M8I}d9=kIdv1*2P4m
z1(gsoDvheD{f6F|njLL7h>R2>i(|Iu=V#-a`e_eO)`p!_popV8Ca{CCtD<+<dY$tC
zQU3tVMAHDO+Y-CB`+olbWC)~;ss(u^@)O(uc?aJaA@UXss2PCV`G5!Cf$!~+pG;;K
z3|KPmD|;A{mzs9I3AO`!`1+iq(Ee6JJXqht>47R-Z>Ryey8J8Unfi{Me*6S1D4>C;
zU6XtLI3BpLj};0^?5MU?JN!O*Nal(@hE!PDx~U}cJ24?v_X}P9{XNbBdQ;RGq_S4r
zxUF8l^_iL$gozEp4*LRobB?}5X;0l|(2wYOG(TT_39fjAa!I<du~$R>`(y@wswv!&
z5+VWtDz#>~_-9KzuhXncMZ;{s3RU#8-w1RK30Sp&<z%6-HO+f|7&@7ZWn$FQN36Q0
z^ryea<>`U5radf(mclrNw3T*9;{8b^;-^p+TWCv-1~e`<)mM9MeC@wG-b1R3`7Wt7
zG>WYoIJyK~{-FG;5t3QnGHlZdZf|SY4l4?1I)m4BEUpQ6{{V>~GkgcrI0xycc%=KR
z7%>N0udq1%LdDW`FZ`_HSi;*lU%pP{0ou5}`}{I)$dER)EM6tkM|9tRo&I<ei^SH-
zQ%f@h;4veU^W1(}SUNd6?xID8CmlN5JL$FxqW3&qZ;ke6MA9ggTSQE+t=LdN2IJpi
zK4!b*`k6x*;(=N#6#Jc<xueDYg8+5Jbt<w(O~%Cnkwo%rkT?17$6<jXXNEw7LdR_7
z>rfZL_x}Jn&_0yVNN*0yw`(T0zIOEeH))bdWu4fNj6p41RsR6T<J;Q^8c&FkphgnR
zI3$2SQT{QdnWgLICCr73A^<efllW|Vad@2*5@PC4R$&nk$)I_IS*jQ6JO2QTy2CAh
zFdJ_VRHM1v{x#e70uv-9r1065*2@F6Z{}0@0rSR~bdA$NEFxv<NIoEOXjZ^o9<@gQ
z0MW$iWN#6ZrzOmU`u_k_9)B;V&nGH4k{AIGYIJOEyK&n80LB3z8Jsy_t-Nh#?;n?Y
z{BgR3E!G4wX^G_u#F9qc&#!Zw#(Cz^E$UYDBPlv)4t@ZB9kI~#(e(=~y*tSg3(`mc
zGjYdn&bweq<`72EM<3jMYDXaYUwyA^JxOk+MpjfUv$+m5gT-yO*ZZt_*@g8=43r3F
zx==_WkJo|gmFT2ykL<~y9W*n?GJw)Q-bx_Swe7tFUAFFUGcuN0M1{m)22~p=uKxf_
zulvU83r5068pl$kE|5pJ9>fD)**WGdY8V?KG*JN1<ooV$zl^>VQ5)6^UD0cxMfRcy
z!mk%rsR$Co7nwwMqmZQ8C*J=6)^xKE6r_k`300?J614vSgZ1?%GW2peV<ND)*eF74
zNjvO2ag|Wo)W_m#P*8;wY_{JKfqs*yo9yXUXwqb8%C@v-QiD}&M;1He&r%?Hk`h-`
zftpp=s3z!oZ|UjHWn}9csE#g@NnSA{BAHB<tfIixy#l-rC==_Mx`<f;B3tnR0Sg;Y
zIOmOk`E7$^G70*LRw{%l09BX(Xwlqlfx74;>19MD2?EIX{{S({`u9Em0M1Pfup>Yv
zSr=H;ZmW-7s2<1RmR^|jp_fP~#Z|!o`P9)--<spL0(7me<dp-77hbpA2PW%(TCaw8
zQ7oM+w@m^f6_dmXqSykpN9)IK`{mv=>H3bR`MD#9sOcE8z=^0c>K7P0fCZiR8+XX`
zeMG%8Nh(ANN`f~I4R5*Jd<WM8h={V!<H*kJ7zQon*T$>9+~0k@b30C4ET?&p>D+R)
zK>PQ{MLGeQQB|o!UzzUdhcrEF^TQO7h{L-~ffbe@2x1=gH?=7I_~!$J{W>I${Wy71
zg@rpPqPMr9qw>OkmsrbbNj73N?Lc3l;M(u)Lkzt<bEi`eMK|;zCB(7~EhyPV4oUX+
zzgk|R0|Y9h#~Mn?bs*G0(hUzv4ZpaoqG<-0fGwiNh9vCG>3;)%EWbj@(z~Q_7M36-
z5^JplFd&a#hr=_7G{|KVFpNl8I0nGx$EMYVK`_XQ>mK^Aa?)88Ij-mFgfyLEIvBcf
zC`OG}`i;rhwfhFL2e`Y=XdX3i$X(TkoN-2g+-<l7{yCq*DI3ZOpxRWC<vR=gKMd2-
zb%&yrdZ4cGheP2py+B<KE4de4@TQlpZkd`eRI00>HG0za4P1@3_zKKQp`L;}6aW!H
zbgAI}Ij5wF1ad5~Nh3PwiS<wh!M}a1e8J-*)eq_bztJS>@(Zi2hi$Mv$NvCNB5s@b
ziOYtJm?R4uHIxFj`c{6EDb)Ah!vpXc`8V)X@pS(H#XTfTA#zosW*j*nl6T*lA1wV(
zLuyLof;Y{W-1+>&U~P`ucv(V8SuXzo_LSB}6~7Amt1V?B^OWCqLcdJd=az{j-a+i9
zy>rk0ELZ;k;mcc(63%Q@)-3I5UongJ>IuHbXFKTuzL|8(6zcH!c<0wTY5=X96`rSy
z{GwV)LdXFKS3K^R2yNtD?`8JKl2IWi)N!3yDfcgCvAGE+@kz2QpIn&S?^vrCV|$Ek
zH}cNLX9oTlx{2GiF00PfW4+}HO$xlM6O<uO9r8MfHNFi&cpK!N>|3>Xaw$~>HEJLD
zoc1A^dXXJ(sjA5PqyF>f;hRHKSqHXhhF0krSQ5+IIP&AycwuO6>fx8B>ewV<qHi&-
zZ+*XhxjzwA*>pHD?soE<qCS4PyP@hAs!5fGpmw$tZ`(6XDKbd}OqLiIVy2W6b$+$B
zXxjjKoJOL7ZOQi;o^F&hq{PLTcRU<;;Qm^D2<3`Lt+yt@*l+R2exenYGbM(UfOL*X
zHhAMNR+boD9w*Y`j|7e~Qbw1zZ+!LHqD4(+Hj+m*e&*`Ehvk{2=#aYz$<{fpFE-OO
z$Cgn#d2I`Q<s5UJ_lV>Xn_dYcvq0}#WQuAV4Br_dSwyn6H^gN+Wi22C?fK#G00p&g
z`DVU{rfD|=VZG)zyhJQ_@bG_$nV+sjy^=61=1=&{T{K~ykEqW}__`qn+JR_;p-Wy%
z>^_-#&$J<l$qLQ^BRtz%s&?Va8no^D5Ae55;r*A=p&OZ6Ps9CY+S(Ia8A}{*v)95{
zk!UDp0D20*<o^Ib_AJ%)Ih;8rcPtYopun5eCFkQG#ZFK0H`?FS@;6f>Hr6?9KG&bK
z%63u3H>Q3k_W2!G+Z}Z54udR*{{Xe;;C!zzzlO|SUQB`dW@eIuM0A6(+<xolhEc5x
zNTnEn+lsO9{BvH28eWlQMd{%v72L65ecr2|Z)~4d<f1}ZT%&KLDYXy*QhC~j-ydAo
z=qq&ZA~=Z)Y0|D^`=O5(c(Y$$h8USbJP)LuUPrQ4*V?<?ZZK-;#;Da=Li`0ZJ6Asg
zzrH-qz8bGiHTYJ{*TC3Sd`~;wj0Ix~bpS;r>KCb0fUZT?>FM&tbdn>fk(jd9tKRnK
zk}EYyI&|q2E7FrY0jY{@TTx$f4&>h=vK?GZBoZ{b!5V<oxK4NUuzwr@908Av-_wXz
zrz{SO=WoLVjIk@Ownb_Rif+YnefQ_w;`Kd2m&9~nf<s;jzbb)$3LJXj5f2Tt$sdOr
z(vSdWJ+|k+;ekm10G9D$Ss|F&DMo-K0YmG_z7Mu>>hwflNa8d@v8y9twfk-O;%baa
z#x`jqR`Q7jQ7gG4*6Zo*lXgfXW;z*JE6NE4h!#6=PvPI34SiQs{Xh)Q;w|Vc_e_OH
zspp-$(afGLpw!JF4YHDIyZvw|5-P^d66}i>c-U+`vqL1Z^sL}&f)&!N6e&=|o%Y`R
z-oF~a%q42Q0kqcaFHs*J-r1nZFHq`>DQM6Uq$mP~4VTu1`{bmPTq`$+DzVpcJ8A~c
zVYPgBzn)*GB@zNUiIzeNX<f@|rKJOX)YrXM2fh3g{6qYwR^2SjL_JiOXNa7Wzt3Ux
z&(ULZs{Xn7?}oiR0i$L{@{<$t`%yRl0NStxZSS9<{{RO4w0_t7J(6I_)O6$|s&2^s
z)BEl-I#1J1O8vv><B-{IN{T+?Eg3qf8)e;3sLYVsliaBKjMAI{r;jop(>Am;Q3jWT
z=3kGdPGnh>fM~bpov5<xc5TIWYy|7Fb_^){91nl^Z|ydo6Vi1A_^}EH)MvOZ`|Y0#
z49(JYG4)ZBUNh$&qt`yur|M(spjl%fl#9;;)Oh_C>#vD@hobX++Ix1M@X$zL2*NJx
zWW#O%8)XLj=a~<9$Db_%PWV7IV5n=@)-CGTbB;~!b0!ibSS4#v#V2|^{&;SIC$<JR
zb}P6!P{3_vxcqQ^>LY8#B<bFbZhja=6McxlNdei0;<sFjEsGbnUDtg}xf^_PWk?se
z)wv#-jiYSqI%4W$)Go6F0*5_mDyy5!9YlIb&ztA*{kwHXhqcAa)f$#_?Sr;=2RM%T
z=Q~|@hVWOWABI3i{{S2u^PTYL4#azmBd9Q=fb*SKoOkuWX}V~B(&;4WW?f3+z8?Ac
zSK6Ov%l2PgH%%_Z4Fg<`$3Ij@(0%jA{w@0l{{V~hf6VmjeMCxZ0lTlJeGj2}kFk^6
zy#6xzzhCsv@fiKeN97Ne{vG>E!eb1E!5Q?{SON$nZl~0GXXi-I)5<EtF8TIfVg01N
zWGa{EUBLY_^elGVKQ+loiEWV!3I>(;Ut^gH(bPcz+OYIF=sM~&C?j$I0Ex`ft%69d
z&NE|M;r{@SKEXX_OaB1GAw@HE`#7(>p1&{4;h&#0fuvb2yiM9lKvkQN0QBQOZ;?4h
zrUTn%8Tm)?XV@}*llGjbmSB);g}Ehm8h%`6yVvcz9lo9%vv{bhsB%pJJD%q$A5Y_W
zmmow^q}Zl6=)L*H5Qz0_3<?S=M+bxSInG!^<14bUVuO9i00a5&n%hOw!ZJci%&V|;
zy()Iz_Q?4PR^_W>?|9_1sZs$JHwM4&IF(SLKtsKddFScPe6R#+)3HiA*5B_{00}>r
z;f6;|I<&R1Ax^uY>6~=9U|iU(G$;UhC-B52bjLvJ1eR}KOa=y8)<`2xiYBY~`rs^n
z<#}1I`)&R=#z2~tcLDh<cm&Y8=CDr~LL&194Y(`E#QKZEx;W#Jo#vU8@&H@ZY<ums
z{XOvpjec!(5BB%?W!Y8S1XTo5Ef95(Ir*Gj4ChpiS7LmiZa3qBfU5Fz(u-lJFlrua
zJd9P4hgTpGc6a;P!F-x@G4paap@Gn$Ml?eU01$Tf^f(q*2uzadW}*u4N#^+68~Nmz
z$v&qfojcdlf!iKrhBh(8S<t9D%IUWFU&|GnT3c4ILW=#_`2PT`AQ0XNa;o9G{{X;`
z*KfxWXxU&u2W2Opo>xos%30N;lgh|XKA_$y*CVE-)YWFY_um2LUlK-GBh(bzJ$B=^
zz+w`h4^KijI8szmYzyD^gH`x@;+cs=v1N8rK%u?-```&%Q-;-KC|e6a(68}|qr@N<
z8ko`4Xnk|FiW+$x^G={zKNbx!Fa=c`dcDXd_vf5~6acHH9l*SA{i#;ikO=cB{BJrV
z8o3O&d^WB=J8nK$BrGTeC?B_KzS%>%s7C&&a-`_wZG7+W{BcP@(T^2~p=1rk@;CIw
zB(i`7p2JTA1Z$}nstrSXCu+bhs+xde=7CZU!{RfU)f&{d6i7MCp_oR-k(g?IH(w0m
zRYjGtSpiix4+L$#!;IooI3#IS?l&VlRB~8UV0i-W&ImldC6(L|H4FNC<pYtacB8%V
zj!2h8al=eSUD;!N`((c8BFCGNj2X2rnCvJ~`=bHno#loYX(}K<(x4M&_amR4Gy>g~
z*%QgNsr^29iKIx)8v&&G3FqTm<Mj{#8d!@oOQbWO`4PwGfUO*4un(k)6x-jazSxn*
z%=;rcjmV?8_paCzaYWs0pqveH>H|<b8sP7MSs%(6P$IxPZIqTD4j9}>t{f6T<#($6
zaTS4(5`=6v2XlZSZAE;k%^uhf6lAWUpsNssu@(vM{`01iS0}_^#Z6E?QQF0A+Xk{?
zF%?<|P&*I%zzS;`)G+rZzYGP_XhEaBov_9gfl{EiHaFV|eRjTK9qgB#Y_SbC2(SqB
z?|_<yn$x*F<vNI@ibjpin8h9c04z|VLIGq13In;uWi(rm1u){U5ZjH-Ry05&vjw)k
z^;MGqi)uBF0{!M?qP@Fh41tlFnvjZZ`S!#ykido;@6Q+%0yo;boOt49SCMoTj;s~{
zoA&u-0C`Z8N49c>cM4c0{{VTo9~>d$DOy=v9@~uTMU%=&9q#~#KuLSEunWc^OS*lk
z_r_?>fZ=U!x!Um@X#m(Hi`d`_;N2Wx4Hqr92YvFM9DWnX(o=1vDDU&h$4*EjE%!JD
zoRM|__U94fDa~)(94%pMWAEvViL4S_4I-%Wei#abX*YH-F!OS62vAOtEaw*rO#p9^
z&H~oLiNm<9t9qf7cRFc?k}r<<go3o7u_Jr^FgVGq(F$p3cB~His1PW6914Vsuk)Rx
zuigY+1rZ&WTC%89TaXXaBYcC;t`We#FCW8Vg@W1QfZqW@wIYV+oZ^Q`YZN&bz5;j^
zRq22?w?B>nG*APv=L)e-I3lXA8IcthiPqh#U_G%;#M!FA7h4OjOyQ-sCcU$bg&Z5^
zvzCe8#s_H{t#=qeMN$vmJR92vph?>lfp$L}AcAVF)^J9W!i(>nTUh#GL*@Vy53S%3
z$5N8)2-|aYf!lFhjqeqKOTI>M<8#Ib*_9#Hv;YR;j^`?6j!2X?nCiah-xN#Xu_>oj
zRn_+5vM~5-87@tMKn_pG44PwAr)wYrbZxoGw32l4ksCgtw>%#C%IvXQ7hdAFA52)}
z2**rh1M9G?4T4ycr_~yjaB1~0^y~-6BB5g|FkLp=`nNj|j%WU4me~18vqQdCCI?=k
zEpKu*7lc==jFKNyBQk@hgMS}}O;!kCsbll7uxj?sGdEJvfTaad)N0Ns9wV6xGdZ#V
z=ieZ&Nd$dl4;#0JP#FtVoq<2&B@AlXS|UqbkVog7VosVp$r{B`_Z;ny5O`u~i|JBA
z((`x*Li3F%m0$`RoAtpbOd^4#HYNu_2DbM6KP)iycNc=OkQ4wc^WSftOh{Ho47RsU
zea-=z6j;@gL<NYj2`xl#?eFu>EWIfb#TnFmwt4>mS(%<mLYHE}ccXo{%1hOR2SxZ~
zQ3rx@jWO!#W@%(PS;-d7#>UC~GHr78DkEPl@^>eE&P1%JX_>eOVV;Cf99=BkJ4TB!
z1Oi8x5Gad0Z_Q*@eyNBud4=k*6?s1&o=`|&K+4*RgMI#9++^h{&$g{9jjPS~sBQ4{
ztdB#j-aAH+w;<35{b3s$pfaeDb^Y5mcXsCehT}3XQ6tLsjLOb`rWldV+j?iC)%EMs
zbu59=ix2*u;9m89*Iz92+1e{3QbOfcz~jAh?Sav%z!{a9Y?6H|Efc_y$xr|si*m-#
zeZHRy$xGp?&E_FW>Qo1V>VA0eMm!aERA9sdd!BauyJ17B=@>~1D!L?u=`3xJ2aZQL
z@x;Cp_^$55V4&C^AH(a0M3<+VSp-HX1}2W;{{SpR>RF<mD8(-3itGjV_|U>G#y+M(
z(veCyMcj(M-%B~tPd8BU^^U4mAw_obf&2R876~Tv2l9bbPLTbmU}(!Uf+kD*rnj@`
zKgr58PY+eqbdT3Z6P0HsQUxthKV7p7giNu*qA)`X)5iVD`S3esdbg4P0HG|JB12kD
zpD;h4!nnwo%n_DQ9Fl9>-oIalMP51PDNMjY0M&Ox)Al>$qj;aF@w_K0cOcb!pReVX
z5=PN4OyQedF;(XKez`b$b($v)Du#>})K1C(CWpUl1eN?Uu_!T>^D8p|03_DgPNE<n
zQUQ`jJDzJ{Rf!Zaj-WQBaj^x71LJw=eV@~G&DH_b7ci<8164Es0D*RJJk^R`j{g9e
ziIF5*Qpa<-7x)}hV;4$%c4BpTV*~D!-2F10PhT%r9I?F8G!Z|MN&ew`*RJQ+oLB?4
zmY+j3o>kNVAf8XL_x!R7yxmXQ3eII|JQ#whD|!dFU@ZPQ7z1?vCx}$Y$W(?FN3itD
zGz$_*3&~z^qLh-ve|G(<>u&gqC}yI7=~6)3k9+NuXN#p-Nv*7!_dc2F#ETqWDPSaF
zdoU$O7D?~E+h#{FI4G*XvDxoow)=kl@aU7K(>ZpdKoB>o+u^nYFqT-xn^jv1WF5a`
z*T*u68cvuEDg;(-S9AWq-db3ns*#!|RY=s4zqS0y%f_V<^rf&(maB2O{r>>0D=$c5
zr0PzvV?J%KSLidKmBaN{9<boCV&AWSh7?mDOvOsu@(2~{u=!<wn+q7}EeT=+H}`Hw
zABX$G1e(`Dch<yi!0ouY_~NHetsPPpNeC<|$pY)?`QV+UkHJOqqOm?1YtnsvEdH6%
zbu7~Olak;m1AkA4KU@JARQ_Y9c(lx|p=@0p>|g8c@05)6^O%u@!&x3Nuy20fhd21=
zeVAF&bJR=V>WPZ5+?}}j@K2^AD#4($F;+`pN8KjqeLw3UcsfamZ{?J`3)8*oH`~`B
z@W~{ov%i9M5>F)2-;Ye%X6hyC3r32nQ$jACh^`OjMrM{KrFD`t8g#3XTKKy4<nR9g
zSPRrdWSkha7?_%4K#&gq08^SeVd2c%x<plqk$bowci#B<;CLhcsGd@<7*esS*loEz
zhdkm-*T`l^cWFr!9G&d)J-^1@xEYtIld6fjc-c?}F2D^U_#YqA&%PMKJZ<7mN-o+{
z`;FN@@81<-MOFbw(!}Zl><$+A@A+n*3PL05Vd?cN%2j-(ive}-SAjyqtB52XBz_pP
z8@}Y(;C()XpJ?>vG?n6-KM<JwH1kl^{{S=GfC>CQ8PQABL)GnJ*lN?YGO#uca44UV
z_uV>lc_o@x)vAF~+iTv1e*0lgO2O1TP37?EIN7NBd~%&cu(K?`%!v%7J8A8<;Erzl
z{7-Om5RhtlO3_u=4^i8E=W!Gx$`nu{fN!t15qQjfL>)x4pbU3Ft4nq}dR6+9wj`2?
zBzBPk*Z~440{Hxg<MGJNYD*C%5C{*sBDeM(w#r0Vckq^W(O}7ALB2=Gcl|J}UIX-V
zI`u3TPMm8+*Qk(xw0qanzBfv}Aeov}^Mx*;9hlIi(l-_B-m@8zpn>C+QDjm`p-iCm
zCz3e*oY^-`0O|T(tEZ7BWB&lWvWp?Be=q!fFSy7dI;;sRbl|iO!Al#|4R2ps&gkY4
zks<|^iP;!fx-?I%UMWT~6nNw^lc*BF>^bA>l8AWm$o(`@QxF-NgIWIoi2ZV+-6T&M
zJOt}u<~2=Z(4aUcetofepn=SiERhXGS50gN%g4iWnjR*CDI<khC7Vj>AdM?lcK5Hq
z;(enNbg9$DDUL;%Qcn?n@~E}1LF#Jx_1gmdG+j4HrWwGWs(6@CI(#k&Ywxw6rYsTk
zy*Eqz)1yh_YmZD#Mj0>4PTqj+eYc^Q`ktexK`ffsw5v|-xplu@{0==aqKsLIREIX;
z5p7yQ1fPMxqX^Nbew;If(k+&j&m{cp0fD6HNG3^j&$1d7RA}F&j^gr3)()J1D=0E8
zhP$9PK3`4t-`i{*LI@rSnCfX`CPAm~HSPi5wQuWxGODlBN_7=tpz83DY!3E&e$RYZ
zTc?s4k)mmOnO%H2HB#x{R<8GT^gkSwy-tXHG>w!v1TA?>Z%lnn9lj?OWR#EuDwQ8J
zP5Pg6&pxLDj>{Zx64b!I-cv(Sx;Ix}OU9H$RtpWSVO>Y=kovbIci4*gd*r+#k*2l<
zCUe*li*=}vuGvnsv-LAg)J@_RRW9vhyHF%wuVec-8Vsz>JnbMdx|qW^o5XU!@^5-1
z-@iGISudt&W7E2VPLfCe0AybjFvt>iki@95mM(x@D6zF3!}fBcLPBF=Lzd7=iwrMd
ze?OIX*cYgYS>7nwCD9mdaVgS=Zgv}U$j$-XmOZ=}w7V_VqIMsj%Y1HvC6lOro2PPG
zP{Dz%)C0|sHs^lhp7|Cdrc<j+#~`F5aYJi6^Mn?Y#_DI3GbB?TRYP)3f$*{N$LUx+
zF&2fSiYEh9U;;}KV$X5`1D*!hr>2QkP}*cbHD0aF1Lm&6$lKDhr%2$A7~ychqD)kR
zSsQyB(D(WCg<3|6AumlT7o0IfjXvt_M$di)S2TTdJG7I(iQ%H?3a)G}{0dR>_3m=L
zRQfuJBY-rdf9`7BF#?NVj$aR_>SUG=7B+tkW&Y%KAlUf|_#cK;FI3Gcvx#H~DGM>R
z6rfdn2R_5oI5ddJG>FtUh+GbCw%@R?$KNd&XX)Fii2!W`PiPfX77Azq?l<>8IQ3I3
z+Mz@d!qOL^Ws{SnZfFht&nMWR-_(jKi$D#jPNTRgK7d!w@}_hAq%g)@%E|p8suqQ{
z>Ob9N^X*-RO@s-f!*J<Q>eN8kH64#VzkE(3sJux6$#k?u><ypTz}NN@53~N+>AID0
z!WosCL$!c-7sna<Tc(R*LDImAIrw9BGo#MZv%8U{n4N&s2(jE)Ir}HsopSa60A_Ua
z0tk{6Vn-K3{{URi8%}8Lx1^d;3tq_J-=H~UA~q$D-IMS+k}@4w9vN@xmUaZN{{Wf>
z`HbA<YgY(B@8Va;<)qU$K{_443@b4+SYV&r0}qyJ={kirr~d$|KOao6k=l0nUZR>t
z28A4wB^|fT{{U-!pD#z%xNvESqg>_+WZM3D-HOj|9pYnfq2BlHlVUytINep^v8|5z
zzipd#{NCQV+YoCIo8LILHpgRCz8eJBd{S!x+i}haG1yr<<=~fXE=dP7o%cDx{dUY}
zxjo*OMKeJ#Nl74^yU$Vs9H{6@yD4T~^iAm}<(>p`3C4#$!!~q1Ls^PODWha0_aKft
z^PE{JscV>e5z1!irUevBplDV#Kplzpz5aQZ?CBzpOE$S)N7Hrx0Jv+Ft`^Q{kbw-b
ztRh(sjVPwCe*V{;36^<`#k5HY3f@}RK>1etS<OhuI#d%)G}4nGv{q5Hed#^@{c~SW
z)fl>@fuiwB6KX%Oe{G*r&1Pwf&md_Vz?wMHoQqh?RoDJR9MRIok|drhgm`V#17uL3
z&GfvB<{7$442;O0RSLyKpLzK66Y(eOoi|L%Se4M|1=p?~n143|#LaQ2p&<krs*TrS
zoz+aSM$aA8enZ?}f5$9JFkZH<eFlAB@VD8&{6bX<DmZ{HNax!=Itk3(SY#J_Q2A%x
zeVx}Q@c#hthuS}BvkwuiV;##LHu;RxpDfO*>BHJ4->2u_#{EbC01^Hr>e+N6M#2@`
zZWn9K-@!csH`)s;GLagy*8Y|H=gOdNqE>b#nU6lC=jdO;JqPl=1Ikv6<VK$k`Hf-a
z=C^s5(M6^)5%foLeJ=k1$jFneVc)Yc{Bh?aOu9bn5fc0d>}GDE!U=SCQ5emxR2h^&
zUF*sj@8B==&%x)PsG3<F)!hW5&ntVHzuoVjuzwfzf60Fjb?(fn1Rff1{mekG#Qihz
z?yZ&t@X{t%(^3{|1@DpR+iz}j3(I~O`$R)0RpBIYmXNQM4S}K9dhBuB$<<2ov|zm4
zY;BJwhv)IekH(H2V^T*G1E>?ZCvTl!y#tc*B#sf~W}*tU>^ZUXAbm4ia*BKwasZ+g
z90ssP#P{ED4{^3zsf(vbP{8cQ>DUi0^`vktiXi%twSm7Z(!<s^j|c%5gj!hjP%0FS
z!6R!vqK#J>mIm<1X^=9NJGeC5fPTN0L9`~M4IC9Zoh-zSBY<dd4cW4LjycCs19eaX
zIO$?w`j%BLss+-LyPFz8BEDSaDO;$LIRk*+5(O+*?x<=6ao&f1`0+3Ek}GvBA{GrK
zlLfK3@{J<7Kc5?J5}gA|G%W&!j>d@Nzx`xD@S2=yHc^Z3Rx0b;{AQ?DY2%TVyh0)X
zS+cflf$wK}zD`asBz1%~rqyjBJ8{Vs*!~@|iMzy!5~33z1Wm7TV4gdTtMSTpT|-L>
z#^@42S+y?|Ni|;|(+bYLJkgYR=2NMeG?9FYJYA1Xx4`6vl_g>*6hMS998kUQWBcO)
z5>ExvO(2$A-j5@nZ(mV~qsU&{%Aiv>B>E3buCo-0sRK%YiZ!sRA22uiWqN0X!__lE
z5grzmEy!{^en0C19YdBn)&^D5ipECO=Adr<_pf7|vPl_NQpmxStBzNWE5Ce5q75(f
z-57=dY9J4e{0wy-Dyl3<tco^KyH(laZ-0hCCT3&(!0Nj#bU4p%>>sxz`y=fbdV~(K
zQCZ?9^#kAIu-n@_xk3h1g__zwI41ndf8z6=G1E9%<0O#8mhV=g#`Hl4{<6U@+B$xz
zI*3+i+&ZweVccejq}0Vgr8}>&&x8K})9<z0!f&%@lIq?9*JIUxU#@++Fk0nx9jn(j
zMD59H>RVCAz&WG04V+kSe+M6~NPXQ*Y#p1}`sD`9OM*)5-s9IYV14~8jlcUtJuk4j
z<mlXV#>8xVr?4kH>L5@yM(TY=P4xg5{{XsE>Ft{G;*6D=%YPd^u;h!^>GxnB*+2(l
zdFFkM_K54cQNNuwBKOZgHEafawro?1^I3j_#?KkC#q0K=p}04UDZK_vZAa^kwQM%@
z&2cT-R>23cH~}P^*!K6u1kquJ!wc>+COR<|eGeFf)!x;H$v0wv&bzI!fwgM<uvn}0
z;|~XAq2GQpi5{E&SXO-?1GNE}<xN12ee-OQi@MxoBw9O+=H%dvl$e)B9KAN%%9RQ?
zwkI6szNIgYGanmg%4DR{(-QZw+p4<}oPD#n&dqF{bauw)an3IsXI*cAc{kqyH=K9#
z3<U950Pn{+Xe82Tow6r>Fat*W<%!hoZC<F<z8Co0>`(q5*N&zYs3-Fe{9CxsBkZoZ
zx=yKB5)_}I&(r?V=p*}M?CE+*HexLs(Yt5mJ!eNRMb$~u%%vGlmL7*cLi9gS_wjUE
ze<*%!>;9YUW%nx`rT6f->R}JUKQ-9km1q)2{x9(L&kOi-?JG~^=4$@i{d4Fpj-$%?
zTzZdO`Y4^gTG6RsnHdQjmE3R0&lC8M>{a`F?8bmsinj2v+e><U5BNFsvcM{oi%&A2
zQR$fErPu%!_&$d+(nRU_Z1A!)qDV^UW?E83H@)tA<ZQAkfI_D=+keOYv+aM6e!^~_
zs~>8>DJC@_AKNFd&c3<wJzVBarKO4})B0dkSEufPPsi8XoY66<byjy9EI?>?T}4$l
zH^rL$Mo72y017Ej_YIH4ewjsOV^X6%CzVu%3f+nM{{Y@AJC(W&p{%xwyZLdq_{>=X
zn$k>RtQsT`Dzbt@94vv5f+?Fu{EdP63?dUVA_-%R81;FMkTxd1C-XIui%^kSe*M@t
zL{<Tni2(iOUoNVxhXeQPoPVcG@zt$?>MwtmDPVv)YFi-b?REao*9VPYAr-&g9hZOe
zfk@dKs0YI)5J556u(!AedOr9if950wR*SKu?6!CwgF0AbSixlQ)CvZ-H@N%`BdZW8
zu8xooU_VTtg=Qy8Ee|Oo>iuuuIz?1x&<RU5z1I5zM%}OlQuGCjv*}qzk}Gl$l{H9D
zHOB)Wn~<ufQEK%RD;hvjVgfKI)lInu_Zw}_03<A~0u_4-ritGS?;8*VMKms*-pM`x
z02@C%B5GuPQ7)n`^p8*u{{WtIsfmaTq*aYL!0G;>0PR2$zck<5Sd>9l*xzqVp>&c(
z`9a)Ye7uOl6&iGu<az`Ca4Mp;n<HbtagM^5MFXh$R0Cl8d~hPLmXBB?V^w?oGK-`t
z$m#=K(G;!Q{N$On^T_1(KTND;WYgjbH(Jl#A1|-h0&2oLZ5oLiZ})xht+ayGq}8zl
zn?1fbqyR~~6}QI-VX_GK0M_08eefuoGBtoy*-)2W#`ZbVJd9dhqcWXBG+iM4xXCuC
z*Z@|>)CK_L8?c2<;5r8|NvB9qM!T!N)!)~QQl&v|R2rkb9Ap4$EZ~4ODE|PF^!@s0
zENkGi$j+?57{FUr-i@2uxAnlCSkeJL;}}RuP*F%xR5reMI4P8dtx7ouzEPj<NFqfH
z2o>K7l@&X0Ti#Y6HER^bP0`?weCY^?&|M@CFeb;X{#YVXTxuZR<$IBYA+%Fe19Ao`
zpEsBiFV?Zu2@F$DHKcA%7=YX|gJQlO_zOWrtBv=r>T!hbbZe(o+Pz1<Dv{<&ByuSC
z!Frt6m0OW}3<^o%x~WBVC+`wAzxvKt=p(-B_5!Kgk&232$Zt*Fpe~2D0#!j&^HDTN
z+v$OBo_Nw#4+Kx7?qs?n(ARIrAjmw;sYUJ-ewkR}X#zaHR2vco^f~<Vq>?va$~3nW
zIKV7=bPDPVT2WnFhV|p{{Bmdnj?E#`0^b*StVfDi)pwy-NmeGd4f%WEC<evtg~(7A
znEKh|;}Q%?L9(WgrgO5%RHPz~JuoNbDhB-TSnEo4l?(+9Eqmt#wK@g2AP#HS6GIWJ
zfG`?X@gyfgs*R`(h6@DO1J<xDlSI%vo5zt_Fsu)ixHo`IVNnSxLjy%kk@3V;EOf5-
z+WEoeDoCI^`{B9*)ZjCgC=*#Kye;v8RhrJgFC)_ehAp!1@9CTk@@N*KZvmZvIs*6Z
zZ)_I7@fvT8Sq`JO1KSu9<IHS<_+SMJ#)1-WU_CL8ogPs{9q+y=B&ZZN-)ssDhP?&z
zfbA11B!lj?)f_%i8zQJ?y9T$!3<x2GdV67zC{+qU2Ov<vh}Ia41nD*`H*958C(XZl
z!6O+6yCe!93=UZW4MjmCZN=vqOWn6Py9%%l4&c@06s6K{QrOzJ&IEwkLELYhsZ4Z5
zSEo1)8lo@rz*+};-}BBCcE5%bL=8NiZvhB5H+`@uu_lLRZ7j7)d;Bs?Z1+DLW@ccZ
z>?(#Tk=)h?3$u=_b>6zMM4X=BVBdl-2z8;zv3%mO^gCl|BoV5B7D2_Uph>S>0<5GB
zL*_H8#cX%y*Ex{$+uJ!)QPQ{sk0@%~-TE9rKsGoB3WBDG1J?;)03E^Pcfk98mK6}Q
zGO5-;2Ug>L*(Hc0u+Un^ly=7q=@`*Uqiy@-%#wJ3h9tJcivWD^qR3lGEUGuy_rWYo
zjsf1!uKappNhYZZf?Y=74_w#L$YXyRRYqaB*4qt-I2ol_BOzl15VqEM`ec>aS*?7$
zZ_gREVlzoEQzM`<F`{<g)C`yrhFKJ}jLdle0sGq^jEeNDzM?D+^_7RGJt$_8tPQLi
z7DsPftmRy&nS!Vw>^9>$rjM@xu@S6$4J*0%e6Sy<=?`21{{H~HSeo*I_-0=ag2^I~
z3H!al%10@UifSsr1GyUm{<y_v5lEq<C5u^S<la%r(ZuG#4Z!xwLSvLLBV@9?Q1?HM
zTdGc<NAnLoyAYrS0+zo%KDju$g3&Y)X;kjt8XV*qq?sn3;!vZT^~Qx`3!o?<@GF|{
zzi;u49rSPg17S_;BXU1H<}Dy!3d>gja6La9p-QyUh(id_5}~iZt~)pK;gOIRtFm_o
z)7u}xFvMn=!EIE^PNFZl?T*O+RtgNWx|PwtmhW<Vo-z!ALQ6i9zzaF8dX|r)E8u`g
z8g*6hdw-n7Co-Ml)e_h>!6)_0{hA_{S4pHQ<xMSHH?@5*1(`vTa7LRT4oiCD%__?r
zUML%J8V-1(PkfZN>>*%d31Z3P{pEZ%lw3+FJAqUW7JYWW&DCm>UF;Vkfi*(59}K72
zrNa~(DKuP;J{5@~8PUAsbLBm+zW)F`uSD?(U&Yoa5(wx1uL{%G^>K*Pr0K+_CSh#*
zYx#Ou{4*mjO&?h5&R#H~f}#7(>3=+@ODsK1<$9+fYSBTfzAxK5sYQ}l$(d9DEP-3z
z+<sU@%Q$Zll(7Rz7qI7V&pWJ$#a<(Y)-^0~fvEGy{@y+{@yp56^<5&L86G1dEQlBo
zT~6V*?X~70#iepVssOnIelH5s(>!xVgFpohyA!v-ez_zfNfA)B5CslN?r-<oD(LaW
zt3wqaeeMbDF?xLpQMHr<%degNJ~#~@O)S%$%IQ)*HAb^M`g&-LEgF|&sfzFNzWimT
zA!<mR>~xJnjc>X4%)&#|%ship;GL9v;5=zBNQ0?(yg*Ko>JRDuy|YvkLLFo*A_a*j
zoi$%mndAy#2(mFc#U)nN&+qWc%@jl)n@^YpHodmopHujEz=wq#EG3K=5z`%F^&WS}
ziM&}qs_w3=9O(cNTz{`jFA(YabU^AAj`zKr>@rc3W-VvKQ*2J$jDqEiohVAF8TB-z
z?gdqR{{T$RRxvrI6l^PT^Zx+6xav{`aUfQ0dp-8-0QSz2(PR?BsT?A_#A+Asf0j`%
z9ypgsRM=?-w?6yh%&iP>shF8SC65Pw*U$RIKpI4U>Fbk!Hwp>-^H17cBueU|s4|cS
z^+2^<oBRi$_uL`lJTm_P!t2aN++N<f%hZKw6v)R=0d)2|9^UxxIqP~zT6TE~0u>bQ
zH{6rQAC_kRSTih%sbc_=3Ff<Bentk(9uG!YX4K6`f9wou&%XobnPH1hP$!pVQ)AVu
zzH>N}q$-S_E4SRUzrV`|PLg;gL19q&p8oT8A0KQBM(sCN`;8A_S54O3{6%CTMK9s7
zAO`JBPsj1fl8rC(61hZjS%@2h=s5lJo%U<R(=m~XusZ-nmi8DO)y}K^DA!DJo4da^
z8=m<IW)ERQ4Xm?rPp)k}LdP8KLd!FP?Pq=f_q@w7EgVc^(<?5a+V?(Vf9nF!OyVff
z7<j;yL0gYrejmN^e`px`ZlXA$V>3Xtsn=>E_6N72`Qvmd8>f+^kZN5_rvCN%cO>og
z!0RC_!WOk<S7!d>Td%_dgT)m{CrKHK*kIOdZhiuXJ?m=DiA;Swl9ksWE+~zP`ug$s
zWn~EFNkn>DL;W@YX;HoHT>56I<Ni~o)76KQsp?`3t$QqHwD5UqsyhIF6$S@+I(am~
zyD(zZy9GVPje#GgU!>{e>N<5rk60@sBB>>;3*XRxzm8_<VG}%_ESgb8$iQ;lhu4fU
zOz{5zE(?^G#4KZ~3cCS+5!?LXSv)eVjZL76V%#zG&sHHOl<EXxI|XBMITu@c*BG5w
zP}0SA%@i!kn!KPAeK_0o=ZwO|qUy|XOdXSD&~0}c(fQ#OevuLxo`Yz+)OIX=J!pRY
zbIB9JNOBMZU;)Uk-+;=>=c^Kuf+0(xM!-<tY@dxA#&rTpgBUH?-q;%YzM1;jI(3FG
z3MC)Yk5;XXZD*2C>y(mPmN>OUj*H>3Pc?(F1J`@_-=<`Vq=^LHDWE(k^$P;|ugCPu
z2kGNk@290`iiYp2Z}){o;u1=gE|;28S)83f3er!%KTIxGF($2AdlA5E1pD#$=T1SF
z!;`7h;X^5^TLXYSdu6(q;zTjYFPDX4v}m<8k6pieU}lf0e<X4#daWY6Ump7phH3s`
z;)hfcG-?}9kkKT1A8Y#WkZ1EEBznYZS|R@cAaBfmpN4WI-Ajao0jYJh@Vjqbn+@<Q
z_O#t^S1OtG$TX{?0w}7jZbsGt-@mT+nPr=)nv3e9flxPL+P=A2Ws{_io;_NZS{C6!
zJ0GCn-+TqgX7D<6Rb?@NLGm6&UwYVc`rve};YeeeFX^ozL?D2?>~HJwInJSASs;<x
zP?{S^BcETDdw#vsbn2_qGj&Lsj=BQKq7MH6D*Q82MGR2&FvwmrBKX(eU}=74iTy~d
z2uvaB5E&$Iy+%R~#eAv<wN>qt{!UJ&StL~oh~P7mr54XOz{id;8E_7;>dMLwC%2cL
ze=&&@Zk;4j>VtD~8eLWTZ@vRbH&fQb4^JV~Vbo$!yODeVJ;}5FGJQ;p;RFsz;3Eql
zo_@4Gxy2^xI+yTEi3=SnhjXiaAb$DBmN{VRC+R~e4ImySoj&HTaYTN6S-@4WijxIh
zMN3`kVWz?O4ZgW0P!eRE1!gLzQN26<eBM(_+#O5>1BR;`1vPiRz;pCCdWgfx42-5B
zI*EMMO;!sE<IR6e1c#~+OpO>Zq;0CU*4x-S?f(E-MtH&}Ngq)eK+Pt#A9S6o--WN9
zcUKB1A!QPaBXeYsKpXek{sR^`!o1Q!=7_`}N`p!X28s42uhd{wx_9Y|%%zh+a0Atl
zR<(QCv48HQ@^sSmkwzp|Q@D2WsxkH3weRr5B$Ch6Dv26j5D4}^e{oxSU1LhC0Sg={
zB#$A`=nXQjb-njK-LQn|#0Ea1N!jhA(wa8~i647?_SN$PIig;dUrvBbOBLJy0I600
z9@q88hxuq#npZQwl~o9<*!j8a)Hmd3bW(L4Jhuw5SCB?+cD7OqliQQV1m=ofo!$p6
zA}^JhM?4$)4nHi-D;3g;-XUivN}aE<`RAZI`Md{-rB(4rSwW&(%n3GZjl!GTzih=I
z8X>sV0`3~V_`k~nkqHo57SS<PAPt{zXbarkXF5hC(#A@Sfg-><Nghx=cQ==hs68Ms
zO&O8dDvB?cR+0#={Q6ek3<fTyewJ>%w?^tbHh0{!kWW6MxA?E9!0!i9oCl3el4;e+
zTRRfRj{g8mJugJAfJ94|(mX)K9aL-p0pxb|%+Qk{W|@m9AhMtC<XNxo-}B3KJs(>t
zA^xERC_p~wvqJp``5w3oI(ZkSc_vXImtt&&L1T04!Cz}V^YlO9AGDLJ`vy1(x9M4-
zaqLMW^ZYaOC$^DKh>E4G0B(W5iLH*_<36AGTlj$@`)$y`ojiR&B26E0Nc*%q0ad;G
zoXWGQW0E&rKTeK7p-CTiWAMuArK7n`$GACxC1x7y*o?4{wO8IxyY4+Rp~Tgw0#q9}
zXn#!a6e-jN1IYgXiS@{%d4KRHp6YPfy}&L%{BeYBk~I5L4+3HYgLH3P`ChxFZi-VB
zszYbGvJ@n#C3||VXpr>ZXhavQk6mmeUPf%C^xuO#<DE~3#yzd+BPL&sUrhQb{{V-&
zSugocs@s}wbIq6RPOcXsNQoYzjps#j!@9hRTg0;T{WP6OIzaZm`6f>bX3tg#ni$GF
zPAF|_m}Tkaoyln5jfHm1{m5q-EBj^-zqT9WPUF5%eV;Oo(TA}ZV(6yv04P8{*?q`8
z$o-@Z9fjaytl#06{!T$Akfa*}j1qKmMI$bf2swSq{@HcM?ImJ80U4!aS+;+?IQPlT
z(s@;=kNk%R7C5E`!jtP+g{CCxiTipzA5jZ5sVE5}t!la;X0D&CkVzTpN;4p4BnqWF
zf%$KqH(GokveuX2-+X}T%SKeV<YyiGOAe@g8R~pU<4Dl}*i#<Ycalz|NR2RzMW~ur
zKX~p1=ZL*)-<m=|<9^ty)jKO8eL(ljcD+#bdd{^BW+F7kC^nN?y}umurRtx=l8wgZ
z$T<x}ubHS5x28OCG=QH9Lsk8zvP`k+h*zVXIt4vcgeX?p@?UQM02E2~&r1*4{Wxg)
zNVlWQpHq>O?7qM4S!hO96+08K&tIbc4GN0WG2d{bzH6FpcGZ4NYo&+yYwUmKx`k#!
zP;5W)Irq`3#~LhP1cV6GS1tQFm!s(;=+q=Y1_H0LjMA*3L$2zEkauJ2n<Bb!+S`-$
z1j0h>Ru!^GcFbgpRFIoL)NHh`K~;{!&nEr-GYr$wGBKk60Du`td{6$T_2j|P{hAG#
zq%+7be&K)p?ELmXU#E&c6kY!S_KE>~@<7jH_>=8Pe&73cR_SFXEkq}v0c)Rt`jehy
zk;W%6Mtnp^A!$G^4&WNx-{E<p)46rhH3`b)!mxlx5^M$i?fCpg1aKEfvK4QO+QIz*
z!yJrfjUBuc3<zWzN`OecyY~5DGo)_%p<Oz3izjj$VtecbcH1K$PM=t3ZxcXzW&|5!
zdV7J}*KP6KMAIJ%CrJ*KMJ;5S08#p%pvg-jByj-{RtxuylGnJ~jlW#!Y9|V;3bx^t
z*{^Zyfqtqai^X3ZCA3F6ccwk8`V+scVwlorDkY?%$QJ2ElRzKy_~&R@B+{(HC942g
zP<s<s=svZGOmf2{jKVixyBOf^KTG|bfx4=OLliPGjY|y#3jiMf0QnswAMCj$FET8%
zD)?5>$0m(n5J<n3@Oa}UNR+ROuf!mOXLdWAH|wy+i>FrVS_JAM*}!QU^d5J*;CwQL
zxY8)xG)mF4r<HdqM<>5>2EzgkKt<!ALIGAg1+(A3B>gbDp>Y~`aj1=ek(I5@ZaeS2
zdVYC3MvW0busp{5Zf}2&1JmCDRJ84&D>1X?B$DQ~ABW?E{{UjIeLxZp_qI^1dPPdn
z>MRHw0yeGheecufhDeqbS2~@Ad05`GBVs+UBv6nVh*dgR3g*tjvXaN6@1bc4)b7p6
zwzG%8c*1CX8o&q4Jf`pCg^YbmM+^xXM;@ju!~*1QN%;x_{v7WDJkr9f(Yi*UczZCi
z4cHaP-0$$t>J+mV(#0Hwvwmi+`S|aIMIV68;uQ)(Q{jRMBmzHvm?wGG2;q_RDw67z
z_et3N{I&A<<pvJ7sOjd4Xyz)&+JRanYp_0^+4|SmziE%Px&)cDc#Gtf5rI^3%^%-6
z`4o|<ZxJ@u0oiCN?g#I-d%wYdYmc&i(Pf@sy)RHgFehbh&G6)ARh>2DuHpKuQ*c~!
z<zbfd0yhPaRe#84B{aixd^T#0*?WRlaD7H@b7`Z@008bcL+U*+F|rNNZN>IJn1Ph0
zkaUB(pF@c5SOQ0s?8DId;TpO=vQM+RwUt8^V^S}!eT*GK%^JxW1Tfg=!)jvoz-q29
zk(<8B`%%8nn@b%~Iie5tpIr0#{7-f|tL7fxr23DsZj1b7_2IPDo4lpayv-cS;5x8i
zcNs;HF6PdB<iy14UuRoIqj0XO!>Y(($8nG^-+_Z!2W)MYnnP;bULJhFjL)dn+#GFW
z4UPKdQ7mSvvjR5GB}m(2kuANA&JB0w%(k5?>j%E$oQ#S9Cab<LiDvuf7T4a+O{_vJ
z0kB45nF^jWWQTeJvQnsV@17^AargPv>Txpb@s=<^<Y#e(hLcAZJU684tnNGK9k#%5
zuGL%i&STtQyj#NP#NG@9XK|HOjmjI(oBlfc6m=0V+At|DJhFT{9Qq5Rd1VPaO$?wi
zIHC@BdUq~(*`o0Cy-$T+P8p=XBI%}no@ISiRet&RUuSho)xeU2sEwQ4XU+Y;_6(nA
zb&jcQhj43=o%RP@-6Y~E9O=G2bM*WftCF#L_?P6|oHoa4rK7w)vRJ&jLETNS!!pkr
zUzhH_<8QiidZBdzccH0IsPxFRYTE&`@&5pc&X)_u>pEC^-kw-Gl-C@COpE&bZ$BXW
zZ|ukW6YVK_IaQpaSZl3m$UjW|vPi%>n{Da6^WuN?7wpj81b=9yc%3_VPHX!b{{Ual
zF}!we#cfWXojtO=k^<$<<n}-3Y;{=@Hq<Q*60~>p{P82V*%Mo_*+%{QW2`K?brrb)
zE31mK4*j^zE|5qhmLVf42#QT{bbEZy<B=q><S(|vG`wnx=#v0MYFmCuuP+0SPi#XH
z^z3P)o|x{8cLU@$IR{6eYcd42U9QPHjt8xJ<gZ(7Z{D{!-~t%CGOz<kRoL&n`eBr=
z$55eTVX;2{0OttlXKxS+T2s1(t?IbI;o0o-BVOljaJ(%R#D(-Da>w`i;zq7b8`gK+
zSwB3Zn^HfSZiplw?i}Ij2ZVGMRs&^ay~nmzDQK&COD@evW(TqTjEbOUB(PnH8jkl{
z51s;m@{hcwRCjI%!=I)JAt>K?HrHU|AdD*)v9&1t@t6e`Hw0{U-`5}|N$JHRnm>BC
zC;ViIcOeCB>DvL2i5ZmWzQY)TR2J~laG(Rd`jM4d;)A5Q)w;n+9<=hEF8g_XM<jel
zrum#mSoy%w_eoU%=KzL*Q{jW>WIO)=j7=UP0ZR~1mifF6W2wr56&G#xBzxC6!IY+v
zs_gc>0I@m;m@SYo<31dO76QiQe=Hyre-U-*QoNzstFgq7ce20&M{S48Eb^lPN<nul
zbnpkDv44&QWLY$`RAT7!SOu6zD)}~3+qpl!+0tn7$WqT3YbC`Wd#p(aW_fjjNwol-
zzPK1F!lhW2B<dcA0ppYZ0GE^~L8^fSS?26|arokRno&V*N3bIF@5U~P6zL=2FPx(+
zaJGkLC;NaObl>BJAq{p`!8fp>oW(+dn$^P_6|ni^Gsavs06*Xl>xflXb!|k8APz7&
z0Bf^E{y1bxt--NohZ)L-SpqKSuqT}5cJr#p%dciOe8bS;0ZEOOqGk*`jfg(k(YJ#k
zVXOZDxoYo>2`UW@y|GS|P{4*K*8`rNk#-fe)nvgIYy(%$UF1MhQfwB8Q@K8;1E1)v
zMmDpn)Eosxkbn_)qsKLYRe&SvFquUtEOiPNdkl7ccj4TMv;!YZ4q(=GwQ22l^u$*1
z!PFF%A2rSt4z(Z=+OHkp(gv1RJ=h(N1oaT4X&dr;<s?WHTx{lmyV}os$!tMWwOOz+
zkwF2DkU-<PzzP$S-(U~tj5Lw3<72-#tjTJ3Aa=sRQ8g~1sO%2}U~>?Scd;MZe+&~!
z(n+nDu{)AYlkv`f4ADYV*5Ho#x_nb=0Qul(={ld~i3T|4Nd+`=T@yx*#_U~;goT;6
z_zZa!Q~(~zi};*AS=-F|Sc|jTuoRI>p#UIm!uR;#XEX+@#%Ba-RUs%}Jl8k?(n(dY
zIVS^-owODPx4&HPF}qXmw%IpeSn09(<CnSsY<8>!*j1Ys+Zn(Q<+1IYfc9Jba9Ak9
zxWM3o_j>tbY`hPN!eqLoP(b-&n;;*&PhrLfSR@Lg>z$yh1@3s?IK7G^&F`F{m=XxU
zEL~ZPd2ebMiqu64JW$Tmz}U_fzGAy^^T6SHw9(VeXEh!#Z(QKy4LZE1k%bs22e=@E
zfS?k>>~D-trsQF-DJ^$<Z-PQa22DG9Q8)#zX8~4?SNqPECW1h$RM@db#svU?2>_1g
z62;f15Xj{pQBc*{g^UF1HWs}`b8o*H!L$a_F7^l00)|oHQADxdzDz#WcFqi2b5t;I
zx!mA&mK9ms>D>IV#92x3?)%^*Y{Y#quHJ#X7e>J&7zOiKG)CL;k1<97fPs%Xco;;;
zzq`2ZeK0NAHO6&mv8Z2c;rD3P2i!ihASjFB*{#1EjkKkUzL2NkzE)@Okq9QpJ^0AS
z)5s)H(Uljy^N~)9k?Bx@r0?iG4if|P=U%lcZu=f`z61)=w6bVL*if=h!t*OJp2=`)
zy=59-tZ89hl~Gh!W9oe|Olb=e2`mk2CvSim2-Yz!kffTTZ+8Cx82wC&zyd<Gad-ws
ziesgKp<!75c|B_k$O4+Hzf+wNS8p}xZO^7G^Og#W64?Il(;#+~M$G1pv%&aak%Kta
z_S<SapGwA#CXy2Gx!jBG@9_BKmRVucsK0+=Nay!?My`jbfOT&2$Er2lDeqY_vZO*y
zRHcXse17)E5Jdv(c?P033H_((zA2U{<)n_(R?c-2YjarvRT6aMMp@=|1DXI}l66Og
zViwir9+|JgjXFkoi^UXx&_TPAy>sx-EXAe)BxHs*2eAF#2F*HQDD-P`d9R)<kpyrf
zVnq_ve>@2quShjWT0{3^U(DjgG*QJ*ug|d~oj!u{hw0P#c~y}TLc|4MyrBNLr>Ab6
z*y}=h)x8_Xm00xRMNo<dmw$k<e+)2}D15*v8d;C!fhpv7jxwMRHQ%ql=a!hWC_(2<
zGyyg&_xSIUm#9aROul;50`{+3?URXIva4C!YZZ`RsgL<}SQW&p7zOK%=+GZ3KMb65
zNh^^#Wd&>&^xn1|zs3@#DIERc#+LXe*Ajmgb_9zn=r^xlKsLgx?5)*+0=o|>Vc2nb
zZnvfBx<3J;m&9<}(Z5eo-xYdTrFE140Bs2+*qw*hlm4@$F-aP~mq@i2$*v7=M+3T!
zqF=Qnh_<rIqRHP-8*Dr9anSUt#L1)p016Mo@i&uS7pv<VQ4p<d;x%bNYz)BAJg}=d
z0ok=*pupQDQv_W_Had3$Z(m%J&N{Xz2vC=%jg{}P{qu#}`eHNHY74MHcD^pMv-B&{
z&l<+c_6cHI!VRkXd)5PVx7DH{krhD$&UPKO8u)*V=oIx&Dn;SO001#MQ~`ERw%5M=
zW`2%FSftS4Ah#O5K=d8+q$UU>K-!s@ITyzwkJkv0WR1yESPw1LS?}_{T%ufZGrJW>
z1xD9@yU9Fba=O6gtM4{Cv!qiq6X&Hb$R5}7!kJyVnY>9YG+p;6ZGayv-m-MkbQ(et
zEZU6B_IEW#{kK2oJmTNWw}gqPkwBZ+de(HJHC79$kP8O%miIoKae=3(==yoO6DfTX
zETC4vGX7_gnB@qu2$5XI*QK@uov-lx^P>)C5lBvy8tZz>x$#;}0Rkq$lu#sqKiAan
zfuE-FSE-EnC4%p!j{ccJ)E=bB?B`fCJ~(W_5x24!3p`=*2t|q|3eI<Pu|E_0;{ts=
zz6Cl6-^@cJcli3_OphuT)#nUJ+JFS{mg;`bXeEf25i<`EDclizQ2BS~;gh2~2(>#$
zdh83|xv#GH4HrsQM%>7$_nAiDFP<ss4w&>ae_XQ_1MY$QH`{DjmHZ|PC3&d%xfx!g
zs3s+VI(TbNNgi#70?pRvZ^O_s$s0@6C?GR`ZE^nqSiq-FQOdBA$ny%nY}VaGat|Gm
z(69*^PynIG_?_<)s)iBM#VC_hszR#&0L2B_KAYfV>K9wuhEaPjW%>6xQsM;~VpD7s
zk}Tq^oA_%V-fQxW{RLw>MI1%LTZW*6diN*r`uku^qDIbRVn5;+dinixbe&vK!4!x~
zN{?P1jfmfJdy}@=9;#)MM<|2J0ew3t+mDc;_4&eCWO)<CES?&#l&=fOq4U7i0g3u&
zNu`j=g!pUyw%p(0kJT?v)by(aWXaT$s=9871Do|EfyZpgGe_dHErBr%1J!~0W#H<S
z7)WTgh5)tfYJnf8%OIaiG(r|xK>(m4h|^%*pI-j}6IhAT9;iz?Gh8EEvzi{;`uk%v
zku)+C5o%2&R^*zmhEhpkbz%SuqQD*7xV}%RKOu!LPO-%wQ#Vl)IWg2rta)9yBzM~X
z01V8r_*0aS2<ZyyUHA07v(HmT@hvL>QQ0~^2iM;z(&~?_oH`_pr$Ug#h|6+*LjHdY
z1%Mb1vg*Y)UlXt+k=vX4dt^FThf*Te(Z-TD6i%JK_wVq{GDOl8Ro!CpEe+fr<a(b>
z;6tZUAu*(7hmk-BgGvuIw*9_15^j+MJ|>AoU@=`rmc<XujA<c`G6{sYioQ@AkURXy
z`e2i)@T7+1J{(TMG$Pe^<K}GQ^)4lKsbpr3%Gd;7Yro#u9a6MO)`yBGj)Zzx2Hy9s
zO?vweQH|GqqGv>DZfzi<>RRLt&*4}TQW)Lh)K1_w{0blSlWXabNwxvJ%e@WAA6@Vr
z<VhJsV?z~H)GCkfe78okLenEK0g4G|gLK<~Ke+dy>6!G!46-)Nt8t)VXUq*Z#B-Nk
zoClHymLv>CO3iAbfgpSCERS)3^Ucyp)2wlZ2(DRN@V8(C@T>X{Q<IU5(Dc#8(-SEy
z;mO`k#*e1iKAw=d)Mb$p<3hGM@A3rZdF%fGmtPdH5rgpL)%xyuz<F9QKcwpF#ONFC
z@A>^Qp<*(}1f5rtyMbO&z}tS;kT(4~>4lKO2b`V3qIm28$LYFrt(w?GEQTVrQrY^E
zLkM`FNlcQwp){)OMcw}Zas2+79}N~#>!3!ANb>S7hwS_3E4NT|5Q+c-$gLm)zsG;n
z=E5Q~uZPpJz{<M8B|`<PB=)np^un4k7fU)7GQ1)i5)G-y9mh1(Gd%Jm2o*?1yLKmP
zpezq={O2o<o=E(COsyF3%iStj+;=o`+8eEcM+C;5EnCS}7_}<zu-?x6TY6w+=u9cp
ztPO1w-ktP^ZRiqvU3|W|X}n&Kr<xB9WT^*>+$k4e5GVpj<Ir!$Pf|)GDWnJr=>%-&
zxhJ<A41XGD>3kSnnjWO8$fS_Ez~uZc{{TMN5{pdQOlnDR5uEH3fJpg%ez||O8VFpk
zMXaQtg;@{)h+4oN<7@eh%hSa)3L<xS!oHyyvA)9V*EJbm!=F-^qK)Hgu)$buxIcQs
z6M+FF67;&7B3LreO_sI?Z>IREqAsdQVOESA2(7(tFIDm={Li)+B$6pa48AIESV#A$
zDeil3mwDpqI*|QKzlks^H48hb^L<FKY$HEVn$b?U^|3dk1quekkA?kyCdPG~I!h=o
zG=cnEpr(!3_?q^wOo){cUs(~lB_ToF9{&Iz-xwnB-%I#uq$M#Xi6B|4@4)$t1yb=k
z&VtbcGLAx<@3kJsEeVMxjXISOqz6lyEKjet+gG{9S5{cvrz>ruLC)KqyH_8vi8Mg#
zfto++&E_PU1YakfZ|m!YBgri5u2~BYD6)8^0DT2!zK`tz&{akZ(Q4MM<_^RV7%u}z
z<DKg=r%5Vw?GXoA(n}uT)qndy{W1Q~jiBl$ND2VA5m8_gq~AO5=y%`b0&(>c^_@pi
z)X4FUq4hI{QRZ?--2i>-H`{}TKkG^(nTC`a5iW-m2|ktF<keLpEE<_^>`|+(J$A>R
zriN3kUPS4D1sRkUCcD>b3@^QVR!|JyFHRG}jws>O<-p!TXi@xl_s8hrjh#qI29QjP
z4>}1@clZ<Sx4v?uN@bOpj+mV&IARC47q~yMa2-HFND#@VMJON<KnA{dJMZa)evkYq
z{7DDeQ2ziYsl0BORmgXheSg>EpF*-7T=_}o(C6cyXZ20f_2O-B6>2)r*;@vP6~BG9
z_>BE0_<!xB`$`WENhAJdF;XgU)wQqB_f&IkJAF%^CO^1+6mCmh9Yc}-04#NHAq1T#
zgWYoy$X12?52k5~Pd$^RtCPXatqSqEBp%MYgYm>|xUdiRE)euhT3=(q#VdP|%6(UZ
zku(cp%_IBpbDG$F)*h63&al7_BMRW`aOm2?ZRi^)Lf3!$o`)0)-^_ih3j_VC<J$0r
zZsJS@VPf>PoS8x>>TrG;QYh6*a1amw0EGuCrhKRGH_dPnXYUdJ0Nmv@001o@KMd_k
zHn*>a4W<_M)Cly`#yDL)!1-gOi)Q3u^2hN(0^fdq?lx{vcy*1+-@_2Y8*|{F{?=$R
zh2lZKZ8!vqPyXWX>bVAE(?&+04ik&~j0EotCpHEj@{YZ02vBz(77fcZ9RxAHq>2<H
zzd5x!Wo?Mm56EQ_k$(CQ{>a0-{{YFpCWZ~lsH&k=Kx2DX11+z13fAA;-GKJUDp>%M
z)%~gZ<5H>f0C)1nIQifelm$AhA=nDtusrOgcrtcT{i7A+ZxEXXL*KFt%_(2(ascIz
z_hDg4WwD~|M(oGA&yW5&{v;n~^oOB}jQv2SP}QO{+vmr^^KbDF@hm@LMWM>H&$Lkj
zFMsYngZJ?K>H3bR?HNa1H&vmeX+Ny{Sqdxy2fz>h)@!xCo3YdGSvqLhRi%o5<<Kw<
zsi-quZCusg*CjN?&ZJhc=R5Zo!T#>spG+M&I^<UW0NmWu4VJez@$|~CTRTMkIA)d)
z5XvL1BFLh`y*94i*{RTq$lfQ37-RQ}l0NdDejoRT#Ehf(&#9?G0KL2O!Ps`+DJ-iT
zs6kTzrqTVZM`P)CzWZKTx@cIdNiiKux*q@~FNRl9VnN^<9=!S-2*cBtU{FMjq%v>0
zYtlY<zo4>mN)_T7^)nJ#djL;=m3|qahfmW^vPUGLQYG1{*@yww#{!E{=Zwt*By%d2
zjiW~0zvO;ndiW9Xz_~F%iKV1&qs-C`CWh1qYqMg{1GmW^s+q}>OOXP2Dz0_{wxNBw
z`d&?uV^UnR0HsiY-uU0xo&Ffiy-!gfi$gQ|R^R}2Y&fdO41zhCOv@q`r5aaJBntN2
zu=#J!baO{Bi~#Xpm9)O@$G^A0dS@oFp<zN9DfOo0wd`-O{c%=BfXNh{IBPUPBxzx_
z>~}oiRz91kO=}9Xct~BGM|3W^^y1EAGHYgHstFye`gZ!|->93zc7VJJz=sOvv|rul
zab#d<+32JIZ9%>j^5ZC`hw4e{C6Edl^|-B8+D#7U{2b1!)0QMoqe-)3&pp0d<>r^C
zl4;Bl$dICdn(3OhUHf0Sz=4NQlEDdbi~=Y^)=4A->U&@#bsi)q#f$<8A=Fh_$%#*m
zuSs@m3NF0fpbV-=z7g>eb!!HdinZClVZh(vjTFI~`H6hr)TV6#wQ9TPzT0iz+X5Qi
zF{FT0ZKUu8oxePGR&v&-NmacB>EChr@s(+pOvEcFa;;^JsTWo~PvLneXL!|wh$Re!
zDzQFNMQRn^>*;|uJ{mHGQ>biC<ZeEhPMK0^{L&br+gqxV6?O!WJ6Xj@%s@`$Xa`9b
z=HrYp%CZu+5jF?kn!n#+f%;GIPuoN79)!U&vFbWy0F(X6+Wq?+`e@vpwO4gMnfT8|
z_JjS6)_*nA${I+I-MS7h>Omh4bM-&6{?_UK)#y{GgzVcDJjUI@&9s+3O6$Bmb!|vV
zy#&$!0L0}%EKeH8_WuCLW<-?Gt=hcH{{SJCN?NuhIacn!9L=dy#}uQ3{{R!|i0;a0
z0e#0~g_sjuG30h^lM+EuWp8ynj18S1+Pz0YZYI>d<8RYGm!bP!4z@7Cf<JX`bK~qf
z*Wa&SyfcpDKx(eXoa5whapv#hUY`rqa`F3lkJIk;>pPvWtBdx}h=;A~I#NVZI*&`S
zn<D-r>X2z=Mq%En^UKNUStH{+d-#2S4WsjoKCsE@z`$lBU`=PuFY!EsW`S?m;BVr2
zFKAQin!n4lew{JvTwm^eFO6Fa25q)BbLP|dnTa8~bsq-GxA8P-%m)20F`fo^`ez=m
z#h>bX{w)A|=XkqwzI^(B6GFrmg_nKEH;&)LeJ~*Cko)F8;In?2N2+mW`r+-gw`RA<
zi7fhOnBT-5D_@oVn6rJg(}g-iFh1FaP6lg6rmd9qPBeFm!_%2;ZII;Y%rSkv6r!D3
z2=D8b9b8fy5)ApiPo(lO+r1}GYmMsMY?1ih7k??E&El5z#T`UmZ|X1CB;7<^<X^6F
z&kHy9&;2`NnTz|OYuh_lu1EQZyU4#>AIwI7y?(hr!RG$iXB@m=-3w~Y1a~)*5+Uv@
z<Ar1d(wt8hEP1S~a&ga#LY$kuv61wf$$~7=&L+6cQ;yN}&)ls2m+hakm+fAc$Onpo
z*WcSeJ?kJnJk~~%4t|vcfgAJBmi{OEJ^GHeNuq_cw)O`*XV`xn<Yb-Uw}^Z<@_sHl
z>pf?`g+9UiO?rqtHg7y)_wF;(nLsjE0+?rm_6ONh!90^m8zO|NJ?!VwPBg6l0QjPc
z&#<qD!`>rrH>yuOnuf#%&kOjP59WTs`${^p-8o_L8~&N}Jyy*A(TwoFhyecp;JtG(
zq5QMn{>L(uub1Om<mnZc#5CX)(Aye6r{|JYLR7o#PUH(C<(#3_&dN&<OWLm{O#mzr
zTTtVC=XM>AsV`AJ<nQy!Gq>{S7F9Zl@{hc{Z~MGa2lSnTDN)|{IH=lPO06>X>~J-8
z5T1r&31pK^3$2eIm_LRjGey%npAISZZ9+h5$RKb>9PQuNGoZ2wLAk2r=81Z^<dz>E
zJMhY@>Dy8O00XxJpL2NzcGSLLZh$nW*9ei(?Ua$t9`%d@v+Fw{1fsUrzZ+r#7?x%u
zW3^xJzEMD5#d!vq06VcBQGYG5EVi~~B%T2EIK>B<nV1Ull@<xxlZhXTBu<K@g3&a#
zeLh^^0;~?V0B^U)9K_6;fK#L!^%YzEH^yk7NRIMr1AT=9XK%|4V?>}x8kh@E4c5nh
zrQk*X0I0`F-mcFl6tg)D#Fif3nOUI=M#bzj-S1oR+a3nj<ar}s4Ox{~Y)x^ubMJvC
z@gzd}2pkd@;m_fK0KhYXqfW#Q;{}xr18mz63E$(KH0S}ztG&0pDugeD7B&UX-ZV$R
z44Y|@r~*B`aA_opH>=le^Q@sX0VaidVHHxuvYjX!zh&>R#BDBbWeR&?NOcq~AXO{@
zKk**5lxWo&SryhrN1=Oa^fmSUaH+`b-~hV;z~BMjJ7$RkG>@lOlJ;M5f>sYHD7q|F
zUqAPqDuDV`!(DNEeQ*S<3abq(uo^+W+~P>aN53z~05R7?nsO8<>^C?R1|dMwIkWJ<
zcSE##0=F%Ep7}j3WRb;K;_!oCcxvAHz#CMB%>}*z<Kcu=NsCOx3cn~K_xH&awz&ZS
zi}H%Uh89-02hB%w&K4RY150Q-i|6Hlpn{q}BDpxyMl}GkE70AA(EKq|b_z`|wsyg&
zjgHoTJO&EEEEN@I$>$U?S_8{<W40+2NG9=x*mfF+8*P9@TKuU@#9#TvVnE;T9!@jA
zi2hX2ISYIYA&l+=vVa8xTmkUF;_;@!*zgGzUis51gGzN#-G>;UDYm{aQ7S0xP6uin
zRh*`TC>*g<Tl<_uRRjhH%tr#~XG)|oPd3ME9k3dim+sb&HTxV4<)akjl_rO3&Q<~j
z7C|R!KU=^R1%c_wH-W`bt8%U1(-bo*)zaT?PIED4C+}x58xgARsP@2dBdGAn@?NU0
z_~|^oI>@nsQ!bJS2XAjo4>WQk7K=+Y6)I}IdFK{L#BzYH2p}GK_Q2t)fGtaWUf3L#
zVl{3(Ju{Vc5;rZ_0gI}|Z)cN$%NcnUWAicWqR!dOjH_;>QLlysD`1d71P!)0#m|T|
z9X@Tnun;p2Fm8KqjLppfcfQ=?=mnGquzjlm9T^o%EnfJlO^*57YNAN1<JUOey<Pn<
z9(h)23y9V*do9q;)JUKxb~ujum;yLB4XM5GC?zVobdCAE20$Y<yEexA3_^CJ@~mLM
zrhtHwZ&!Q+bc62M`sXU?+}IV!z$9fFXi&qbJ1Xj84Q+%5Kn>p4h1r?FX0cuNtm#52
z8d#8fdSGP%Lu(dA)&lZwg=ZQEj0#wTxvogZ8g&JBAxYeUbUkpSBfbC_jX;|A%9Eo~
zhE@lA)B89Jvqh({;Cf&f`4vao00(_G2p6^>W)0j{9YV<#y~YsQh>u8e0XJDNEY<Pr
zg;|SP7ha<rDU_WwPb3c5QiN*MM%b*nSOa4B<0xhlStyEq1%Z=dK?K;sI149nUbwye
zv5m1bKMV?>UicqxByPH7a-eFkpzrZHaZ|UQ*-&n1Zg0?LRM)9p*0k;c-)vr>t2*gs
zAOmg2ua_AWaW71W=*y|Mpr-5h>zNWm8C5I4tz{tS+Ic8aFTUB`T-u`WwXupbOXaOc
zxylL!LE<wIR9FFb_V{GVhes$2HIhK*Iz;gnGopfy{r&LCAYUpm+t5}($s43#lBwIB
z@yTXSD)~p_^2nIonL}-R(;69AShH$k7^vW2cZ%rcN|SVS?tZ^av&Lv1r9!NOkU1CI
z=aFV<2}EroLwgzr{bgIKm19fOdWMh%)px&4q70#?3gwj)YyrCZ;0fZ%Yo$+SC)1L1
zQXM3ufN9w3EBN4zqDdrXQ=q8`p@1jiejnokT`y4bs7AI34x1Z%u%}d-9V3kiVL-n6
zf5s~>iy38IG<?MSp2H-ust^r@7J2*F6N-_aOA}&+@^;NDLKatVGjdMk4^PV`po!$0
z!vZuGK<qXg=Qv3^XJW0b{@^4U7x4Jx59aXINClYK+!I3nm?tjrtZ2*WKmY*WzkG~p
z(1k6q-jDjvML(7wW(geJ?BLb#H#-a~G(HpxvM@(wp}6nAZupNWie+>q_3q@34dh-R
zTVCKE-2NT0p*yvjaw%_ro(G}T06K6ab&R)|D$!;l{(bTtH~_}NG8I83`Lka8Wcqz^
z$s}4vq6jS8k+=BDOA9~|7%)2>+hKePz_;36QR<a<eTlNhg`U8DKBEK>G(9u3kNtpL
zhu|99Zs&Ya(UytjGp~vq1qv+jzrX?b;cv5x!pvs@Lh9f9y|5q|b|{S2zGiObvhm9r
zLLo324BSb*Dcg@yH_R%;vm{reRR&|o^sh|2E{RbKhh#ei-iN3CU_9Lz2-C!&RYx~u
zn?H%8#ui<DJ58jjAqsUdw<LRfKNE{1coDpMje;1k+qQHbS5=l4kT=~@NDO^_``~d`
z(6I(>Bg|DrUDx@*{WNffk)<0O1F$E0_aJSWUM5LZ6<2T>Ro6<JCeOfTZojEcvRJKF
zz&j~D&wqY6!V5{$s<MINNXS(H9#yfo&orO29#~_kBV7Q<%EVc#vv=|yxrrcElp`Xz
z2KL&%CpHOCbdTY)yrP1(!Fvun_ZRPdu&KMOaZK_b5Y6{N+kN*xPBL9)v(lroklJ*O
zs1Q4TIEFZ&P|`?PgXOKj9_07N>7<T8sKZ*7HG7|)27eUTkc%f`E1j;-u2-iaSz{V3
z4*j^?;dN_iS=Ghp*n`;d?eB}x!Xc5&=FoCWe*PF1oXgcit|$Wyb*s5P--c&%B)v$A
zO#$MxC@2lD@b}6mQ1PK*vT!-_`wVG1DSCLL>K$r1fpuFTup3$Szt*rNB#yA5WGY+l
zIladFet%4xLnLv>CF$`E5zgCIX_u)_4UFH^mOuaspdzUKkETh)okUM76$qfIEy$y`
z{{Vm<*aJuMonpKoO&W`~TNXDvdIR;ziRxb(n479SfbEr=sFFw#yg@-o3Z1fWGtJU8
zS`;#p?;&cXt;e}P^?_;r&z=CJ#y_Z`(Qe67Xd3Ou9}iKM`#YxT+ozUZp@2j{?dILU
zy@$8>`o><Z+pB3b7}G$cPIT1``+RehMq&iYBUcvHWP#~lED5Q$Edkm?L6>3=CcQGL
z5$d5-LJ=bbokRc{{eN75>I4&>o+$J#t?!UMFA9^SL@d$PSP~U)^FO~_0va?zju}p!
zlnW)W>HcAavbwBeb5(6!hp+2`bSoiQT~4$-Skvi$oqyIv5GhoV+d`W{2ISt@8{mv}
zy+p!3oVke@fcqbb_sp(?sp*+YBxsaLPH%t*b7cPOE+m*RjZU8wXks~WcfYCJeSR1o
zG?GbBJvx9J%e9lf!}qp9E}X=oDcvK~JfRAmKNG&^ztgr|p+!LytnsNnW8Ft^J<duP
zv<Fb4VmLKncC$m<^B7GpPF^M&!4!3Gx!eKU^V<S_GRGS)P#9_qRZ~s&=X}!396m-0
zRL0fet(pgueYW)D<B>2PtHkQ{0K!2Mjg@!y?XV{P9=P2?o}wixz7i^EQL9rh9Fytz
zdw0T><cesYuJOD!O(`0cy+oemds!#eg=a$?aK{^Ibx9nkarc{w+xPG3kzSik1=A%B
zyZlXh{{1st-)K$z$}pypU&H`_KqPirq44d5Lr0Gr#z<THx~%Fq_;&eVNCbjoHKv%g
zs9)|PfE?|Ay2t8f69~mdUQg;8994k4@smls@uY|EHN9=V6}P35XNSRPLoB38<Xum&
zE3xcJC-C$chsUAjjx!rRrcOAz8o8~{?y~UpAIn1V7^Y-pXe4IXsj@{M$1}PJmQfm`
zsvtV5$<;&ZF9BeNM^dh-r&hh_0!go@_&CUsyyP?ZiyJ7@!%26z9^2!*(HI5lCvC>w
zls5QZ*E97K#V1r{5NL=Kp%smR*c0%q3z-C7D?;s3uB1RUSl^#YQg`?IaFiB~NAtX-
z>r=67ucv&nNg72izM4Xk#o<M%#i6muuX1+vA3W9-V@8Zf<pC@%#RFV@eW-hkBHce+
zkd=$erPAw8!T$hc`&DE*h`*KUS{0^^$Zrw0I%}}H=WniQi6H5sPv%=^Q>?D+Lu@L&
z04Ba1WF}aXsCJ4#t`SNl1_}=TVtdy6UpQ0sG8E}!MeyEfB;8Q?<I=UirQgTPgQzOe
zA{iaUvK8Y`JRai9eFv^jrHzcLvBc88%Nq@eU`FHdAC4hMiJb^^AQ196ur*l%yIux~
zBMUTeN{*<CRyL5<^f~sj54Gkn(um&4Ws&^+(I)EsPb6g{jLhj0l1aTQc53(@`Ek?7
z3Xn>(S!A<8Sltut-o6+RSVRrh#2m9H^zOFVg`fKO%A}1Hi5iBD%ydZPSYSnPELQn=
zI(3VvUY2BNT1f4@MJr^eWZTmC?YKFWI&bC#MP*qUQb9u0+X26@H$&8e>4Z&uY2ouv
zLO-}Ww)_um?+;SlM_uAeBa&T<IoJZ#+N!p`KU{9HL~|HjE=U){P!8IcVtwy?ewt#@
z#njB9?bafs0!VE{o%`{>xWHc(x_IFc5FT)Kw;Z2N0Pl=CW1=*b;2I)#BrviCfDgZ*
z?|)4l1P8$C%`TTzg<3!fMl@&>!Jv2a1a}$dNXo2848@I&LjGAr`Y={0*_p#6MuiVB
zG!Fj&1M$c3nPTcR#H{`<p{RMNixu*-^4|`))uv@dWe7+@v_mied~2HY9~^|TIaV>L
zK+)Bc%>ifdKU|8}_FDA7Nh7pHm<kNU6fAV?2Q|+9tLEQnbrAJ2FNB^1y2L~PDCt!f
zcVg<#xjB#S&F2d4)#4RhmdLF=xF3njbnu2A9K~Jr)JO`8a6vchK%wh|LO9wjVl{aj
zcL#As^#kd*7_k2URyFZk%<p=LCx33|kH_CEU8h#*mB@|4%yt%ZsVC+4w!-Fik{Emz
zawRB;qKhy)fCs5PzF1ODv2<!D8jPFn>NMCJfqan1;kFXmzR!h9$aS!7&6)#XFR&z!
zi8-aZevti{B)wxYOc~ZFS8WZcPnezScK-nHemR~7Mm`ejFR6mEpDvCzy~p=%cQ?m5
zQJbxap(;F4D^OrT*jO8UMOV``7~_7LNi@bMP*f(R77ne#fwr1IQQIW0^UVpGH9)JU
zSY6nFNhj3NyndUeh_6)BbqgHPuk_WCwMa?RLWa~g-mntU3cx&4r0Uc;W2d*S_C6U-
zkE=gtOr2T+u7JLfYR;{QJ;wA$pg$armROXhlFL(S+zJPt+@H%4d}o2ClUqa^Wj9vC
zbL@Ph<3rN}^pCNBi6Q$^IMzauPp8a;k1_A3J-DS7ReZzH=i~i6!={V{^1N~v1d5}#
z&yk+z*<Z$;Uq=ECuKJkRfTxBFxF-AWn=60YMe%*Z^no!Aq#7UbY_OOj*t9;|jPQQX
z{vzl;(4~W@Ms579<s|p3=jEP|mb|Ludvlv2Vp?Xi9$SkB9K_z_)+-P|9vYu@Y|G<+
z_DT1~2U1%gBjcGdXxRS%V}JMA%|Kp<A3TMH0+ENWn*op=iZ|B+k3?-8qu%f;jfeGq
zxtW-fe5`#u*x-}`gM2V9#8p(;!Iw>3zfN;Ga4ZdfTpl46=97Lm!n6Z>>yzn(um|tI
z(;?$oBUG1!$QG&O-;;z<pZ+dy{{XXxSgqtA{q9V4KpHYJzfp!c4U^(`^up<NCBOQM
z{{Y_Qm9&jIqdmUvWLeIl3ySqCl}?}y%PGG4c)~Rq4#UJ>lHo%@*m*uX41)C{{{Z&~
z$#b8m1aTyvfWj`)FyX@X(wyLFbS~f0THN<Jm`_ST(u3Qa%_mZkDQ0Tlc5{W(Z{JHl
z(};TV+4FzIpT#i!kqaz(X6iQ65}&($&UoK%e;ufW;`=q8M=Te{W!QSxzrVhGM3T!R
zE0^)5bu8~hozDcHk@@DkU-aKhe{!!?)X(;u{w)1MGsyn{)RoS|e}>DyYswo><>r&7
zR!G%fLXRj?Y-%HNN!xzJW_5yPlARa|{+QG*y$JdJa_I;%M$0M~V-|c?(#1mFowqw}
zx9gf+3-wFmeWleuR7q~3%Xk3uKn%Z>1p>qtp|IY#KU~0L(;G-1#Z_u8L@2wj$nBcC
zUZOVX+&@nvNP&U~Urv(LHwT(f-%;3BW^S4|-DEO<Opoe#V#?Vfh3&sQ_x8#tAV`v=
zMpCV&?@&|26UO4k-oq^qOB2G9ml4USRS9YZNF<Wiu>=m=>h{cCOspX>Diuv(iyN?a
z*n5ABc_fBfH>=7(099R`&whJ)3<ZWoGRG%Sq^xV_RUr%4ZaMd(>w#ri=4X)u5C95;
zMUW^Hx6Jy{?s3RhX7MCC?cJm&`-tFU+37Wvpj}u-RGUG25Pe#R_<CR{h|kn4aK!Sf
z7x0u==X)IS&RBmidZu_MAm}0GGFGN5=iHs{$gckPk(W(JF(H<Uga=N8RzdH{=e=fh
zhr}}Jkw%pbzSp=LAD!eCrgfCXsUC%vt?s^^@{;H=!m-R`o#~xe0ISb)-;b_mjDQrh
zo(V=$2xioM{$Ad=@J!4+I8_#(Sk^-ghX%!0w|ojps(N@97z#*?Rfuianj+Wo^~}W4
zt2)Nq?tXtC&nVjDu;dFphUZA<Z)^coo<rj4DncErZSQZF9{31`6$D65;@fYHenTnY
zvPnhdqov#dr0OHn*pt8IdC6wway-E4rMe=B+v&b&@l4`ZE2=^Shd@;WK;LTj`Q;1O
zg#K~j>1Zf#43M=|<=p$#{LU<WA#WI&BSc}S7it6hfa8;-fyL)MhEAe19t<(7Yyc%z
z=xSrRI{<!pIJ#*hP({i^0ZYgm_W6Do6j>pE4Z5|In?=1_Xua#?D=8mRi_l6Vg%q@*
zjFfevRR9>8AeJ^Ow>b!hi#ce3LJ4TeZIZVXeRe+^&WJc&Q3&-hC{CkvM&sl=pIj<F
zU;wSR3`Y5)W=K`KT2}!ItAzml>$@EKZ@|SzSR>V5B9O>@rmTVi-`|giY*?f$3zr(>
zHq2|xyA7{$eZF`=>0J!;<v<~TFZXv8J$vV+_7B_geUH{Ah-7%0mQ?Qk<KKMq<`I87
zOQR?RuY$V}0NZ>Ku|_jAf;Nn)3<xX_I}hIY@RJ*Uz0mcL{h`xG)O7NPjm3u_k@PvO
zWj1-f>+7GCeS`c#KiF*}L`1zS9ZwNzK9&!!8TvQb-)X`2k4(Kp5^6>p9_oD#ZmqWG
zwKVmV>O)>-9lNeLA(Rqz0o-ykAd<A3KmDPW68V8U6aB+7YhPzJJj2v%a%I7_4afZO
zl1TF?K8%|jU0^rfQhgX!0CpgPz>ogP=L1XStwelAF%`-%Cx0tgz)1f9lY)I$0Ys{H
zXIvrEjZ4k~$QyUx*G>Z<WA~TlxDIsQ%rSKDXG!_v761xl-_&4sy|qWa2Ncz~3V-{o
zAKkjI*9agfBu7`<5P(nIPyYJ?%C*>K3hV&*WKivT0Qej$B``X6_~jN661?BGO~F$`
zReNPTUoRJanI>{a-C>hNN^H$`9f!qoVTtBO{{ZiD*X5#Kz8N>w_k%dEY@IO6u76>u
z-3LE0ft;O#kbW3LHQ8s|(QuN@y}$nedybf1yME6U@&E^knisE;0H*}{9LQR^b{_SO
zX28@h++^vG(skNC-h_W?Of0s8ntE@vQcu3B52()^SwH<V@XZk(-a+qqgz@pud8{@^
zD>QbC&;7mR>mgd8rwqM9xYb`Ho=j|{i*@;Cls;=GVch0*$6EYjO;^i%{N`n$Tg)!E
z^Ea@`ODBk=aAkYn(-KJ(sUfK^lgnmy>Rp|fsRW8a?U^wzQ!b$^R>aV(`H$nCqxoOq
zuC>Si08v&I_>wR12R-SW6F}Oa<J9Np-};gEqe?n|vf^d(13bW*-+}m9`Q)_f8PYc|
zguMjlW){1fuZ{&qc!tD)4N&79bg*?a1z4ry;gsphc&s#}p+i!;P^vrKjmP4CIic2z
zd1TYAMw3L1#SZxWPf;YgNl_B%09M+CoyqQb`g>%Z33EzRox<}&Iag8_XSN4)?nkZx
zTCx{$$+5oJ?&47D!DD0QP>ZoY;=e3OC@3gEW3>+6`{0XGo7KUs_`r8Z5-z2pR)?4S
zYh(K05jK{#(hskFuCP3e&WmL10o?sQ6@gTiYSdSNYk#N12zX>E8HHLl*X5^Om)swo
zASN=*TXH)b;K02oYPuD<uZB~@8W*UQ?ODp{+V%kP^TMSYNC}TnU0muM<s?xSlT55u
z!tzGl{{TOM#c&yqgbvnhn>CKID=gAXfs0TF{wKHZ+aeI?bn}%Bd)3}1lmskn+mA6L
zVZY^-E)Z!_B#lV`lmlbyiyo4)T)J5BiZ52<WBcutIqD<Ox*}CA9*3|EomYO{u_jof
zMP)JvCg{~ysQKP<bmUMWmB<7J6{`D;n}Vc(RNrxcd_pde5=9b4<4e=XvbwOcpMHoS
ze8w)I000xWn|xs9oE8A7+$cAZOkSLrh1d#jbH?>!Y?{85AaARX4;a7!dYmJz>_Np9
zps8bLU=J06PYi|A{WGv;d)#xk@6!~{fpo^Zuor4M_V&a|K3cl&4pj>D&#7F4KoCV0
zJfHi@gjZ0hr0HNcBV*66d<@~(85WS9K+at&CCG(<-ht$NbBeT{U~O;dfyGnJ;j=fJ
zV8gZm<PbJJw-<*>xDBp}Y9KDd-yRv7HVlOWMtr2Dl7H3&*bpmnM<de#Z6<|n>y@1N
zvJeOL8Mm{>{{T#wDP=$`Jx@3clAT`Q5H73n%SF?-RHR&SutN7E1+X{T`96a)znEDd
zZ~z{d2+~d1J&&dVmN0}<SSw=%?g0c)<0!{mVn+_g?pfRqOqz<_i2&bh1L8V@2m<T3
z(<)Y1jCBPULTN@iXm_A}_BjpM?hml`%Krc{GW5+F%HlR)Swj#Qjx2C$&({NtB3(u<
zR@jT7Up?@2(HUh6t|U8~kkH!{ZxB%)<lehG4@%<@qa_pESU4AEO)5-}twn6Lr{Hk|
zGXfa-y~g-S{+fVjQQH+ASdTL;az{7{Kr8~?9>+P?Nhk%;&Q(oysjB${eC2B!FB_A9
z$5dKVP_OweBL$*t^S0dMM(Q<dk65v|HAB5)$gr4JMPQ_w&^JF5fi@*TUO*nWv{^s~
z$;K=FJ5o8S&I_alKTHSJ{Vg`5wR+)GCs8^o1V@mC6-qb!0Li|Sx&j3aSL=-=y5mI_
z3XBGxEf1imQl3_$V!^~fSzAaNM{~|{p(LvvhW^-~0(_#+puho5(AbP;17=$Tjn8}@
zU<Vvl!mw+!14yylcfdMTw?BIso~cQ@+m14R85@o8IV!|5(Ff;%^bL|Y;|VJEYMAyM
zV(d=j=MXs@`e1gQO=9z`gSOX|C?YWik!h)kUG)C|yql;)saQDefG>SrvyPwvAkpBF
z`CtO9(fDBmY2bVN;Binaaz~-Sfu(Bn&b8Hhk?D?%cL-=5&5Q&pH61tez<ZO=rC}tN
zB%hzIcP7ZMhZr2CwCUeTJbULbC;a0(mnGN@MD9SW3@XC0qrH0ICwt%EbFRSvV*pr+
z1--F!uq1(m0K@_;=Kxf0PBKv*=e__ekybr$2pUPgYKAWS9OI3r%gy{S1@;Gw;@c84
zxM5<(0!8h=#{=#<ShX_vjuj6l)Mj$#exN3!K+^WS9XN9)w%NBMQM&kN5F+Y4<cb=w
zt!vZhk<dsPs=(EIoSJm(!cxk&86%q}zur!F3#F}#9ftc2@<LZe0A7>1_Q2Hy>(i+Y
zn-Nxb{0?M6;!a;)l{e1juk*?~Cz)E8Rs8Tp0U+P>leVv4Yzj<#RE?EbX&bRT{02(O
zFgt^H&Q|rfj0SDUEOrCf3^Md(9d)qQM(PETkUvcXQ)`xfpg<xPHYA^5F;Kj*4J;H6
zJx`#>=?X@TWNNGCzBuz~>82(<i%_CNUfZ0auQN#wqe`Zh&fgn2j5Nh+rGlR=bMg1%
z@x+!HCt!``iGG}OgsQHXV$~r#Y9n*-$Slz-MiMio?W^EDb0b7nRCXI3s`vi@tk)ie
z45$EdD`U^k(-WnD%QVZaSnf*`wg*bA-7!^Brom<%@U(CwN?gfii35*@EOP{)LwI_r
zRGQWA>zC^!{$p3%4IF+%(kW}(i|6ZsjgnWKG|}n@ZH)!=&0blZVMJBdHURnx{V^OD
z`!Pc<jT?hpoJwf=Rh48K#|k|Ua(iJ<A5AJuVPqNwfhiOkjbFnl)kdoxq}-z&FID0J
zV0=GZ&HTiu=o#6pbHTrCcj_f?Cx}fCU54N90&>!y9oXtd-EWq^^_G*Y{$@3BbcFLW
zzT}=iBgR5$&r>u-qh>#L$>Zhm{PE<D1)ZbNR{0vXvHD<G$xwLO$Y}}HcVpb`wq#O#
zAtBVJ=nr3W?V1D-$UpaJF8p$HpQl9+rLHs}E$?IYa0F4Qlln*uXrPnM<bl7g{j!}1
zGLVlTjbjE@DlN?m{rqrEFY@sCNH4?lSs+_iZ(1ihDRgwjRZopA2CasVO7u7q)WwgK
zGdg)|_r}$a(`r{N_86hlW{)1YdPUj%P{zU1ZpHRL0qK*K-c~Yrt*EINeW-DPUaC-f
zn2e@INVaeqnfKs&af>}Hjnowg?Anz9-3M>eC-!$w{KTR<k<0zSypl~`IF0(Asbd;q
zU1Tb`;9q}z`8W$VOKc`Kv9Q1X(e$qPvC2epMd2uCpbKtRzhf`gEV3+6l<=O(BD}|I
zv-o5t>7;}ZNu;YF>?~g2hWG(c=`b0>0BN7~9m&P$BZQ`+<pA4Z<~!r`(ML+s6B;`a
ztnNSG@7Ed_kjm<siWfBPwxQc@PS^*k>CAD)1OEW-xo->`BhZ|ZCbA<{FE3+6k5Wcj
zN{6X<rdA`TB!pefd!9dMDF`vcD@0kUG0g#Y>*?+7fty>*g%KV=iA>dX>qD^Kzwb2;
zp=Ie=x{^ZZAyjV8R8SSzU2pB*Aq>6;MKU>Ml6F#{9!2_ndCEyj)<Ia+0_g{Hza;&C
z3=Ezt6dHtKchkYIY-xH)x~C<{2#O1OF9W{W-4tCr^%D55$`-sdt^0ijSE+ZFLlkVr
z1t-c6BzOGqAtY?jh~QFFQN8#bukyr~U5J2FrHz#p^1k_G>zyNYh02Bi5C`Sy>F~c?
zo~wgUAztVT)XjYSFg2n?!bvPrB@=b1{yT0yIU-}xsZr31ApqM@8y}$`vw)amja8)a
z9d{zAFMplogtGOWJf0)?Lw!0buWKIum>C*DEUeEM7H#&sKOWbb;yUIfopk^R+hMl#
z@5s#2#_tm>NX|h74XfgP>hiG2zss1H%*@4zuTBm6dwhMe0?|m_TO+h=^72D$pA-20
z&M#J}(?ujq&g@tf+rMH@>F~vQBaEvmlybC@fyckcI!>{=$x)>drj4tx{{ScR${I!<
z8cGqBz}BD;JRmr;@4p|eNX`~VWgaE&+DW19e%<lsiHAcGj+R1hN4wQ$Z;<@S!iBni
zhCw20W{?o~dsUskb-%7b-7i%pu&uqZy7Hh?$oYyHIagA#MG2wL7x#Dv_wSc(jbe<q
z^D(oK3}7~*gzvfISLK=GRYoZ?P~%pu)DOb@4~f7{lH+GObqgvF&cA=2XfeS*TF^lx
zpUbD8Qwn(pYZpUrkmk-9{2~Lon+!sEyPhxGf1P&7^+drVe=f?=NV;{Z)$A+}^XY+k
zf(U<?jzLPdt$5XU&*AdO!Xt;LSz0%9sFiSN3LDtxlh3w1OBjk^yM~NDqqdf@^J@8T
zzibIBui2A$v9nnv9Ewp#eZC}b^1xjU{GqU-UO^-RZ(u9xak^;O$fjN71ZmXTG`0Hn
zp}pW0EPXwM@idtven?TZe*XYm?xH9}i!gHGOA?zkaq<>P_*MeU(nt~JW{}AC$A04Y
z_1Jwrl#`?IzRySTWD-drSojLcZprV?+*dp8lT?19No7T1g5+y9Re1b;J+i$!k!L}r
zeIT&=rup{m^gj$MmPA4PqZ;somURC9)n|@4=X03iNV;_D5u|33Y$I?v-|9a+qy?NG
z2sFJ!hJyZEce9HpK`&0RiKIc|ErJczn)=}sj%hlWT_$x5Vmd<$ze9bEU*p{4IqJG}
zj(1yvb}{J=JlaUGYkI01<eoVsks}CM2`siZVMl+%9pR2KG^*vHAE@%*y?%RT3h{}V
zWmavR-HK4g&XMv0zL=^Y5UZJ2#FEwf1))OE&w=Uk!w*j+(<Ml{b%Ui?4~N5YH_COB
zbp1zL)u@m9k~0wM09&rWY%KBE42tA|(L85eQO)KWU(AAt9}BAEfr|qvNuiXZGazN7
z{ooPF?N{@!lo}$+Sr=IvKmb^(-}mvxkylxY8COJx{KCrne7C^vo=Zs!zJRD)6<cC%
zg5RcY@gs}*NjhM$JjcW(muQNDqK|$F`1+BG_V7m%h+181=80(OuKkTy;qQ4F=X2I9
zj#Nh(Izx>>f_FcS{BHv!k1Ucgm&9i(0AtAjYzMcdXz64T^-=^_iC95jO9NK^<MhGQ
zbuHCMTt*ZGQ~)h$3Me0r+n;=#0!3iRRLbsG%t2yLsQL5jglXz}q1AP>byAqTNzSt%
zT`L<BOKd%f6gch1c7%{T(IIqsKc>$>*dX!Sx9sL(UM{1;kv6(J16=R#zW42#0<?mW
zoW_c1fGKMBCyj>tUI3qX;|$;^B+3g@Io*l)etTpAXb?2AQ@JLF<xTg#cpru@TN=sL
ztZIBpJCJNK??=DK7)B+VL~00*waDOr1#C~Cs`bhrt?5=Z)g17%n%EO(Yr6L1_jpjm
zVSnZ0ZxNMEF$_ys1c6*#{XqB0_|eHuV^U4F$$W9Y&yQh@l1R(^#-9iP5;4B}^M7CU
zkatDW&n&XV4v#8;42?y+zzV-|F_=jQTc@arRp1(l0B%6qt716#`tOrS+0|7@*3Y5I
zVL*1jncVw)ai@|&)E_x<84)yx?yv-a0Q8}SSE?u>h?w-5Rb<s*P_tr(A3f{ik!L0-
zgfl;s+ZMkoF&0Olts~cL(Kk$}KbZ`&M$GY|_j}t_b^!i6cFeJp4^SYJsPL0f)anTY
z^0WsRrGH;wZo9${9O0fvdM;RS{*~T^Vn-Urf_RBCv9!|PcI@+e5l1N|xq6uzMYfTP
zvK@f1L961)A575%(JxChC#3NiopiA^;ROU6KI6Bywgl2>nl+cKvAINO^nwWhS@ogE
zYXj8cwCU7!i#(8)4EnSVTmfH+<oe&k1W~DGWfd$WRAgF%U}DYF_<dBS7Gni4PdDCC
z?m(~z-)`7L=!^Mzo>^E(;DD#G1Xu&U-TjVdN#XEaIcYSgbN#2e0QRqkuWZo+bdrdo
zP+@hpoUzq=*4teGM%&*104bh_!SEwlV{tLm7${>HEJpr^Yp;BvnH}NK@)l1GiGIg>
z0_$>3{>B&*8Df$n8$93x6BF1AKbOmXaJ-O1B&fnhMrw*}K2aXwh*R9{TkS{UCQRK+
zG|2IXa7rLb)EJOJt~VTeoPi;Uk%4wo95mrg)0-YpN5k;Vk$t=Nr%NlCI=9gn9#%V7
zs0a7HLS=rEUSmZ7f-6uoD);Zn{{R@hM~4$CvzAV!Rm&@C*xxnW8r#$yq{iOwP5fc@
zlyTht1dgm1Ln#bwUG23G)O+Wl)BgY)uytOqq%p?GWDFS70elKRm7gMs{KSx_OoApv
zFQ}c#RowkS{0D0%qlCC0d&HVTsw>KNH-Ay}%(|tIw^!Jw@%Kj~s(&v!lUlD}hu<1+
z<Bpa%BAE2<M4+&zTTmNL{+x01<32KUo2QaP)CFB7km(?^I66qbujhlQg;_k({{T(h
zoKoz<>gvfGgU&kTJ*vL2e;vUhIZl>Qp>=NHU+;gWcmDvF@Rcgv9DwO8YC+}SzI=<v
z6G)WDMy01aC{Kl7B;!pHf@w-BmWhO9jqQ&6dL57W$6TJ>UtGV(kQn?!()9=fY21rE
z<3I7wN`Xs3)d1c0*!^?kd=sY3o+`!8^|=?YK9yJS$t=!eDrkmc0ij0uKY+{EC%0GK
zukp{>`Vg}916iPGA5VXLzyAQ1zh-JE(@3Q(HLlh@4}ARf0M?>ItqnQSe&+ko?sgbb
zJy6oPcV{ZQamM#`{{UYMdy<~jU!b4kKeGhJKNdqoi_x~;`04y>_ET;A%dHFEBUM-F
zp9vgEC)w>(g&4>~F$F*aVc6;<d-;7g&JcK=G@U}t7LqT+U~gi)*8-S#-i}{#Pih~b
zfB9qfK`R*Q)r$baqbKyjzs6r<vjzTf0lK3b06z@;>!fIv1l}u&b_#(g)voGz1Rq~a
zJ#2GH)U+zd^HRphji@mRTM@Sy_a!~5zeN84^2h9-49J~mAakZRKc-^pzmI;;O7OgS
znYI+VK{xyDp9H-mjncPM6%P%T7f^i8TFnYOieJmuB8;eQ2~kz4kEo+xUyeP=J(|AP
zto}6WWvKdS#2ze*;kgz{TLNp=$LF6l)%~T`buvKxS5YL+1*s2OSlL=W+kRcLP)e)O
zNeS@`k0J#C5J&*(H|xOp@xD)?StPL9G_RPeb`*TVy#=49V>X#*6^QVpF-IJ4BQvZP
zNna0DIaboTz0Hq;-Yf*c6y+dMuu>TA2s(w>uGL-ZEztGL)5Omb$>Nx_hES@g)K}BY
zbe?t~lg?y+8?5Tq2^n=uAui6_7vPe|*VpHfl9ETFIM#JBvmX^?AcE_ARqyI={A89l
z>UA`Fzow;*l^`hX$Eh{*8K<b};8+n+9$AEkO9S_lfHd+At8>_ooH`vM+(;0G?$m1P
zfCF=MYuMxnvRv9N)+<|3+=}1z`uEF~k@|A%p<`$Af_G*DfCBd0Y)+ym`~x96+z?#r
zqhy;E&Hn(4#)gn|)5?ZKMo<vRTDP(Te{W;+!l7OuMFxlzY=dl1;kU=}$Br3fK&lwN
ztz-rJqhWsBj2%Kt31oDswo-UE``aDmlyvaKB`T<_RTV2^M#&u6_4L9LSfh)p5X{Cf
zwlzcpZaCZ;tMBRSob0iW<)f6aV2n*wwQWP&QTXDyhr)EGX*F1q%>@g%s{a7&@7lfa
zLI@@(0410$h1A}*J^AA(8eB07#OfmNZTnd}V?qA_%lM9Bjr@fviQ4wDUmRzQ#A8WN
z9YpzPjTf-Ln7a7mbr8#-L$36SHU^|Tk?Xa4bMeRzOVo7zG_X$UvS|c3YLF03aqJHs
zqVj7Cbv;3cq>95^C_9w{bH3aTei%UNV?^o6P`aE5!2p9>k~!aDzomA`MXOU&v}#3~
z8<FYw{y9U!luJmALLKao2J}W%hmRbyM+?Cegs7`3H@!Zmw&x){rP)aH*xUj8tT9Bt
z%*Pb7Cx*-&oRhF7zbt|LCebOCCJb~10_gt$o9%(3R8E<gu?!8OwKWDey->aVa4fzn
zhjSx@G>FE)7kX~N0*Si8Blud-Sz+ZAY$>}nza0H?jc1@5W)euLC@A_?nL;oJQDAu%
zyK}kpti?&<c}rHES6Ak)4pw-jibAg1OKDx|%Frvf!<<#9!Ei`pK}Bpo-}}I6iH##B
zPZdmb!m6nK-<CuJ7<64^F$5E^JkcZIPr~q}sRzSyjLb&c5<R<6%k?wM)tKg#`CCLc
zz3D{&a(yfC;~;>JJq33zDU?{P#qNFs>+#3wqJFcfNMmbK+7v3=du_?U@VHieN~da4
zz?L?5udYl(pbbm`{{V?U9HH%W88y503`!kiYCIiR&p%9PdPur}JXzKetOfx|p}m^<
zej_u;l**{YiY>URtN#EQRO$jVu@+<;pEY{j_c#Op0L`0Bf{bMC!M(eDvrpOIYjq!I
zbx82*N|M?zcVS}Gn#`yp@er5s3yWX@1yB8DI&lpBQa4z|qjwsO=>%A_s*h{zaF4nB
z7x>Sn`$D7Y3Usp_>6^&g`u6x|(?>B@)JRjuwthCc7pMW;A2yv^kfV$Dto1q{;%>X_
zxO^BT@f0~FBo;TVx!Z%V{Bt<J?XKAO;rh6k4b88qQ;*{7+gh;y0Lz^Cu8a8Vq-svC
zIXY+V$!v%9{PWr9{{V=7&g&R>J#S9!z*cQ7^fj5qqFSbt4{VVh`VapAa@oPdSk)q*
zhGp>;)HOEakaEi+Dv}w&%$Vs$Z!LI@?n>4TVMqS%<Np92*%8!*2IMBOUUqH7qv?U9
zOSk^w`+0Mj?!3|M?U~0=x@frD)pL(g_kd*jVHehK{{W;%H&}H7YzV$bGMT#%4!#%`
zVOL3oYg1p?hW6(OTRS4{=-H6V+LP;*iNGd;`tyOLpsET9ANgXN2ktl?&6&&I`bWs;
z2cT&i;2Q$>fBq0>7Oo7RJ@Yq<wbS3n2%H{Fm>M+_YUKK3hYe#>{WCD0_675U-sHd6
z14B3*G?ko;Kl~*hb;yZDZqJUg1=vV=+Qt~PER@=HC&Y|@6Sla4AC6}aXh3ufcqCwr
zbhA4;7CT?IQLDzF2$c}~E>KOYg3f*T%q~^5lOWrFC?o5E1aYxtXJUQM4K}poH6J+~
z0l>tXLibH?-1Zrrr6$4HdJc2R`(yZzqx%{iT|<pu+X|mMpU`{cnOKeZQ|+&|A^R((
zGqt%;LPj}}tMbpuzS8PCuD_{%rgU;={;zuGui<-oW}meF-0HsD>YiSq(Nw9>q#BHR
z4|D2!`eq4cP_3fWIHJ0Vv3I}W^vyQ5-Bhng6j<w2gUqD;>#t+)f=HU9ZA<?E009Kw
z!{_<>XE{PegQS2?o^G(tk+zc`a4ycnVb9MoW=Adv0F`sxn%lNKfJWm>DP<pfO@==)
ziyN}NuwtWTpm_DgcWK<bjj4$RiQ51G8OT=cUT#L&$~>DRovfb2-}J)%8Dpl%x&#Wp
zmIeR<3K8kO=^pq&3|l}d3P;TzZ1>76(FJ8_$^QWEjdA{W$+UVeP~YyUQ`}eSmZj<3
z_>A@z%2fm01MPSbBg1WwhS-lcx3(Cy${kiFc3&|nH&yTQ-w{|!G`5ul-m2pXm6cAC
z6{xS2R^Er#3N0f>C`OC#y`N*g6C_~<l_04G&h_nFRxEAzT0&cGHFRqlK$gmc>D6m|
z*7!k^Mt2feI>4|11N~rK5$j!4NFu-n{jzL6@a0DbxyM0iq@_7KF%`A~p$v`~?gxAG
zZZ^h=6rBwELu?qGhsO&`QHbmSwky=%`os<57NxG?M;{M{L4W1H`EpfQ*bc|CEs_2{
zxi;}Sb^(y1CGAu}_w>$r31Z$7uA&%Un@IWKj%HbP1~f?3Myw1di3nGFTO+s!pUVcI
z(WMQ?HhDh7_r^C$u`!fM8FEpIo2oUES11DjdGx?y11Vs|Nhe@A^xL<5EQ+cgCkz7a
z3f7Z#UzPzVSnOK8{qJMj6t=}{d$H<rqTMP&QduQ;R$39LTUPZ1_WB=|2_%iQv|~#f
zwNdv+ZTtLje3B~cbf}|8a(!}SuA(o$d;=qb7ef{`xgx0Jp(YT%Af+UMLhSRtE6Nx!
zCsmsiD+26Jn?BeDT7YoC5Nd}%93^d8=z>PXYz}j|X>0&E;BAMf>RYIxvZ{&-ynFpl
z_!3dg8m{<O!<Ug+h3`hJW7M7qeL$#c1K;6|;hB1G9LR&t6GsQ*@W4cEYEZEjK?RP(
z<5(Q|h-cJ6JNo=HjkAydZq&E}6?3Z4fO#9=rUQ>YlqHX*k$d2YfI0{)r<51w^u>7I
zDKtstAnq>kv`&qsl!hX}KAo@~Bv{f-m_G<ZecxO4+ZR$5*w_9&@l|}*%WK~V)D+Ut
zKBEChHg2^8l$9+POAA%s%U%Bf9Fab|d@-5i@eGd4Wd8t>J@6C(LXV#QRhk-QR4|y3
zf60IhY+nZgA$F+>rjSV_edFnzh^=f$Rbp<r`CxMRDKU&wr4gv@_+*?!(zuKN0B?|6
zV_3sTusHRxc%m|;NhXf|mM|EqiI+%rj{gArqyF%QK_##bmVAd}^%>0Wx*V#2KIt6o
zl2c~bUiWwoc%UhJoD@-k7o_k=tHy~;&a0rg?5pX8$Y`{?H<H4s;BSFF!jpaIfrVq#
zg|3GL*BLS>jzG#13?j7Z`Q8GumGYL{{SI*o7;kr6cEBx29-Cn(EQZ?yi3)XDHQNYZ
z7VVb#wm*g{a&`yx#zM41F5ca+7qJvRI1giYoLb4OX!L3t!K?F8z#)`9q3yn|_@M4P
zU}CzdZm(<Ruy6jbC`cf4w%d2WRB0QF{{W3*mTC%b+Z>YGOBCa<tO<`Z0r=w^L$%gA
zksp~@5&_z_#UwCYDs^#yqKW*l)}T$*9u6-TgbVW$K<<4o16uRkV-`M8NV@uBfn&8`
zwbB3=?r<EEt*A90TvxEfHT#RsC3vf@_!R#DjqropaYXT)U4<^9N4_&Ol2B&UQ(y`0
zlPBeY+k;~MIBt(49!l`n&3@O$NH&`_cpYVre}*-X50rd!qg|P`0Yh(m9PfA^XZ*rK
z6qVG=xE=m}m`713Q03j2$orFfliTT$i>526$cIw$r?<xfTM!kivC=4ESC(B+4x37@
zmbN^T^TmF)H;=$r#-+VPgKfsxu(pYOqis}2Ve!g8fC12_SvU7<bAi)^AsyJOT@?e5
zY?q4D5n$2ZNav5wD;S04H)RJq(D|RPCy0`DbrJ;}014mqz@ZvS%dqXa-vf0sPcu2)
z*j0{ru6`LVsut+o0~)hK<(BE?iYE-{WB_@Tng_o48OyT7V^B-qV}Be!`_cJ{Vym|G
zmVTuKIwL{@wx-i`JuCg<#tcE(Ksu~*#skGXk*EPdC1?t|y|c8qP+d?lCu3Ld^4k%e
zK=B*{r{oCq+Yx5f06Siwbc4^mWDhiqKdnbzs#`nO03=ubkvf>}etx(ncIsIbV^j#V
zNZ7Z>3}Cs}K<WPG;CtW~hg7;_lpQBYamUE|ZHK307f^scgt7~r{(~q8=|UC14DZER
z#p;T?w1ERgo0E09-vK6obrRASV<TN(9=UYrKc^z0Q{jVTdAHwT`DC6}>LxUSBVF_+
z$^}=?DxFJ-D6>-#!6P4by+6(dY5I4Cw93}|>K)hP{xYzuogy~@rQ{8$e*0%n7?b*u
zur$Q6V|Twk=O@#aX+!E%QQY?Tz}C=zER7tC=1oN??oDia_phdT`b6y0X?9}vS(?id
zb6;2*X;?ez9ERV_Jx9yeClkhz1R<z-mbfH#_c#wM(IPZ)D5hRH-uEMK-C~aw{4!9|
zpOHSN*Z#0{{W<EMDA8HnY!$wJ0LsY(u}uk?<3_Wq(N6mj&fb_5PMGym2h_jJITWX0
zqtu=U`pmM(oh;I5kiMWsvArK|E1alVW-U9+%cyyawYRW8fUFE)iIe(7gc_Ss``l2k
zh{BXlH3*rGqy4S83(n*5!!)O;>U>bG6na%PwUc$R`V4I`bnx`=;eSw?X(Vlp@j!4r
zeqTE@bkRRj^o{*pF_EZmUjTN(8Ja$bD1t&`D`$T;^awvp%Oa5%j8q01bSiDhzu(I(
zAn8Zh=?H;`P|UQz)c^=TQ%B{Q-AN3QkTjYlH^1Mm12mC!OB=E>x&m01*y5h1M3H<+
zHCoc3I}FP#6AeLCTBw#k+rDk-I%Z}EPQNWzCw@LZ_l05!FIS=@1Bw72-=*bdVHq)^
zyO~Amt`EnbP5bf2bHU+&BSJRRONy{g+j@TQJNcH95lVc!Ul;KDU`jyn+7m*&#CP`m
zGUb#@5kdf<)y*C;Wr5xmnY8GR!VBPg4AMF&dbEhbd^p^d8`(X{_81d%h6Rzp@tlFV
z`=PA)K<{9Fc@CC!Cr?mm2mpGM>y$G^4@}G-Q!vuLP(T;!_53iTP)Y+SV#Ds18;!Ro
z=e7hQMCr9L@fohQD6jYEa;?-qPT`|g3Rg)Acidyi)JBUMf?U}$D-uH<*Y!BP6!J~h
zD>j8xQ%VIYuY0eD&mf#VA?ggOhSV;nE3g?>RSO#FUl0NpNWENgKYZZnq<Cg-nhoQU
zLJGFpsQ&<P^d6q0DfWcXy!F#2j{yW{OX}9+a&Ley^5pZBM8m8ZB`osJOE;|n_+g2>
z1QJGqg7QV^^e4A{v!j;SqQp$BH&q?`-{H15RU=CiEwMuC3BSI;en1QenIt;li1<;m
zgx~KrS>p>vH_&wH0Pmz<KP-`r_5ISXv)S~q$M1aZsn{7+Uddfn2R+FAuo^dsb%$Re
zLRHT?fcE&^4{Qbq7C4x#2iW%`Z%<Rd(-JPCFXh!tZ0?Mtt^Muz%O;1IG^|w{`#_=v
zcJ{!i>iTIqB#Id2j%2+=?k|PEfV1<=i5Zesj$~zEl&W`Q+!OomGn1vbghAOE<TdZN
zr*GKx%{@m=EGMRErqdxU<xy@atA9dH+xlb~`mUZ{oIEMh$g;;LnXbfqP(Jti4Y$S+
zBgpbQ(KK!MAl~GD{jpkEAX5*B%ma}q^dn*M?~2kZbhAm|8!i+%JAgZTcFHwLEM88P
z4!Gvh?!a$-l%K@c>6v<-q;(P%jxe#Wm3B8>{=S${>GO1;>L+dZ_xPXF4A8el)Xme+
z)7+tS?hUCR5J32P`ruQb=wa$KMH9%=U1`&{kSw2l_OIDQZlPsZPMHKU7Ig#^z4!F|
z@>+Y_tAV0G1(Mgm_7$C~BMNwPR+4oZHc3B~WEPQO9aH#K;1<{u_x&&1Z^J54`WUB$
zv>>4v4!(8-{p$9vJ;r9}%R9$Tu?3S?iVbO@`hI5`DLi?kllrX~LaqJBVL<zK->|#`
z);Njdo2N&G0;mKMZO13$d*k?R6Rh$`WsTCy9yM1Rdk@55nR=d~7x}6DNIFFdqU>+!
z+RXv-_Q@;D6TAqo989BHoyw{Fus}~PzOJAR36PWAP(SMo(IdqiiWn?oKm_@VQ8sXY
zI^9I*3;oa$S+{Bc0rUd1rGAvWz7Ub<^G8kJuRgn<Tn2v<D4Hff?E9bmM%#RN{hUsz
z^#WYl_@UVYSR$&u&jS6iWp>jjlf>}|un_mX@A1Rc!rmAq!%6=D6&Iy;H~8RDStmgz
zgh2}1sZ;B+{{X*#Y}E|Wbg0SUMf}X`;RSK#Rd2lB-ceuu(abR!Q>rtxYa>W?cth^&
zKJoZ-``&}5m#JwbVdFH9{mo8YuB`lbKkHx#G<`o<o&<g-qM)jhHBszF;?7Og<B+;5
zM&uUK2ICi}*E_3%x{WK)`<`K650+@2F`-9IBP0diQ#U(a-lt+ctl?IcNPm-(+r)AX
zlBS0Vc6)#c8h$?v#@$qH)l3yhhx==7TiE$sd*tMjBKnOjveGX#!LNmWS!lXQ)^Iw8
zXyYKVfC()^!1?~TMS9M@S5T8Ohc%!^pin7Q#rgm{R!5`hV_ud=ZwVeH)VhfVg8@K%
zNk0I7YRo16W2i`OBp@T5+C9ltzWw`UT6Ra(Gw5j$x{`Ge7y+>Cf5rs*&aCyaERu(^
ze4w}9-t7MX_uqy)^zuaKqSn$zO@OUny$w{{d{3rM2#T3kP}Ia}2h)GnzhfG5(Z|y>
zv}o4eKzBjKA47VM15B_~<j3JC(qbU)RPA4_{5^6qbiGlBQo|&L!iF`l+Q$C?3<(tG
zBFjP1yfz272fy!Zd1Sew5vwq9Zis&K8=*twGK7_yNMkbTP^x2yU)?;n=XqlD9+GaK
z#Uz)F5-U48-H<!iAN}9Q89IKRDPwakkU`b015;_L0CVQC@S~Z}hYGu_#peFjUBwYZ
zZ{L5w`(zE$^pZJ7Zz*OYS7X2%cjvZIAZWTiq6ynW$tJHb{^iwmUgoa<06ntw?IDsG
z3zn4{&aMX(J@Z#q6QwWHtHS#9kt!S0V^w>d#rupXL}3$%)@b8j2}Ziq6rO&2_V0kf
z5+CMdHmv2DkvC9SfHyqsPr!}vM4@6xLaZ{!Y#j3LSO5ikZ%5GOJe@~Y-6V_PL8vW0
z;Rqv9C*T{`13y|)IoZ^)R#0kByjx8kJ<0kEpb|(ELNRF_Rdmp{3Izq^l3VxMl62;8
zv^;*7rqrMYSY}{N8>Juepho`Q_#=`d)%5Ptx(M7K5Dzq9e{~MyV}S}}f>Mh{H%4Mb
zFx=H2O~>Jfs%DF-cVrB@n3)&?7?ES}t+4nJyQq2eIoXt{Aah{*@%70`a=F$@#kQ6M
zQB}R$04z$iArx6gfTqP&U+>o%MrG2!`;oaveIkeh(0tBPX_X^XMKPG7I%)3p3ftli
z`Q1A^^=tgP0LH(kdr_(cpRdm<Gc&r}b_sD+R4fs{=e}tXP0`MpWJX~dDI;>eS~L%#
zYTMHDi^j#~k~fXniiHh8DY3V<=bWFOC3Y>KBZ!9J-#5MfK#njvZv|M15rZfS)OI4q
z!``ni)X;%lkZ3HXqkYwBg0BAn3p;#y85#PP>bkph3oMiwL1X6b#`m+y`24b+RHVle
z2;&y)!GPG=p<DK<^!nf!pp^9xzd#Al6ts#g>R@bd=~d~mII%n{_H>&}C1=ta=@Nz2
zb9=D#-v>+7v=YGmOlvCgR#hY$EzMCsv4dE$tnJ|5r3^2d0MPGNepps;NP<T~g-ZZj
z@}lc+*DUPMs(7Od9E?(tsCx1H;}Uk(hzhCF30mwc^2X_xLiFw6vjPsbQ@K%hUiD)F
z{ah{#l1wx-C&6k%L59R{!RPVJNpYa3bSmG|paos;cV}=jUsTUFs3R&<{{VEcY9*`9
zUcc)QFHH|y95YDMbn9BmE~c%l0Be1?+X&K~MEyV6?-HbAr&)KKK-5hz9%{NOTWhVo
zXyg#<n7oX_M=Yxu6>N3_yK;X4lIk8QAV|>ppH8aa9>9FRGwFEq79ImUUL1^pqhbBR
z$Si&AAEpGQju?n0MskIaP}q*c*k3;!cST5Gm@+E{U}0O@tIcFp8v?iB<ocCRJTzsH
z7TJ_;2m^10?VJAql$8|Dvc;k#5vbHEQDIyS@0R*s7#ZYcA%W^9cCrXz-(i0Hd@F2`
znI!4-ORrEGP_+#L&d1lB>BN0gbf6?qc%e*;2|dcQ9{sMdrY$tnvPh*tEve80zTA4%
zAC46$)>K&w4cS4q9FN_87*$qu)ThG$t%BQ<MOYojIj&O*tH&DYg_w}0?R6@!u4>4w
ztkz=G=v=gi#3uBRZ)5(>5xE>k5+M<?ymB#LErLZ0CxdDaV@8I@e4Ri;9*~3jVCrzh
zhdTjZLVmeJAxHxjKvlKqVn}-fYW3THh{;InBddQ?K_x<yWD2qMB>p%W5+~`FIVCRw
zI*PjUFWn}GBWm}f>5(ivNft2L8Hm;>*c$*i{r1~Crdb{dJUa3ycP!v}Yz@8a_WuAl
zs{og-F~K-17@+h*@wpxA<J$v-t-30e>Dx}R9oLj|_@Ayam7r7;riBs-7j#GC^RJrp
z`VuxW4MSS$LMYdBceeX{{jg4xA!RC>Or|y<?W*?{HY01>Zar``k<&xgAY#(RO>7Mr
z2OjmtWrRGf8ZxY5p0%C_r}@X~P?;Uq!wknr0<@^V>^HdWewh6v9V*U^)yX7%I2*|j
z48^v(1dm@_1oHIE@%beH>a9J<8+%dxaK`gYj<dJ);g3p+3{iCgbOXV%PSyR{LDP71
zt*YshO-NV^1o8>kZYu;mPK0RQ*=)Ltx?%v;Tp9r3S>%`cpa8|V*zV`w>T;$+r=~F%
z4H_?)Y}&84z>!%3jY2r}I6iGBZZEcLm1F4DdWj=e@t0IUl0u3qTBvVhZrfJ)2xRHz
zB3B|1(^CbuP_^lI>-EVIp%sBq5H02lyY3Gh`W^P?Iz0!eZ3;vhs21DGPjm1GjHgd3
zv{FSZen%c60DJ5We6R4r482sHaYHIJglSbkC>0wG&!C_=#^`!k`qy5X6eZrlj4)8u
zXTNQ`{<#L#0Z9>*$*~%D@cjqJ@!JmOP-J9nO2n1~?lp7jZ}h+sES)+DR!EfD4gJMI
z+k^4ix6T2hFijEj5<?Nqjs1Nn{{Yqs5+%mujmC=Jg&Wv=pQasgxc=cGT_l>Su~q4}
z<$x9=62wX!)XC=*2=*g>)$zVE-7>`H4-y#)mZD-?X9KVnH@&&Un693mN0b!ONbi3i
znD~R*vZi3A5;a*tQ(&+NjKG7&!*OG^0hA<jI}Z(AJgcC_LATr*y5Dk7%i)>KTHGyF
z0$85>o_#hMLR6#w052o3We(u+s2}(E<jTlr2!(8&04V`My8GOG?;t56h``sQMbhtN
z_sWX!L$WzwK^nOK0DZ7iB!j0_jhMOfHuOc^Z&mr$2xOGWw%UaQ*nB>jP#eO~#gx6-
z0GiXcHa*D2k#xd}QFRfi_BxLh?O*RHv!K)vFgM5ohUcHz$A(6oWr8l9rFjrX5u@b_
zbsjnIe;g_uJF@~7kTDvT{`a}~VDkxGnbZQ{oeQzO_U&6^7t)Iv(%_3W4c#5TFRm1p
zGP+$_M!UUKdu_*{KU@V<9JE*yEfeMRz3=hIEfMN#!=TCqDAG6{x5)fXEKn(sFi^o`
zFCf*VSI56>oSI#bX<qGqqp<ux91BCztg{GWloxUlYmjV>$?fyW%P5mTI+!A96f1B0
zyybZ#jr5=>@rABvSo&@;s7Rw&5tTx~o@77g{A3DUOBl4M0_>XSx%@cE>(t6XEWm?c
z@B8B}0>X68gqYJ;lu=-8?nlIYGDE`=-sVxY3a_qEhe3J-)~X=x0KZ?ZXk!`|(j8hs
zYD(1uM`8N$i5hAIEwZTepa-wzlYqC33NRb}KDZjXPqaF&g?v7jsOlnKKvyf<pG@@n
zU*cc3T~Y<>9VBKNZ9^8-TMfQ><iyZ;QW?ypzyct(Kv*<>MB^P@KuC!zLr_y*V%5LS
zhu0fTL)M@8o9&1SNc~yx<x<gHY32ac@wVZzWBAMMVfT8g-2LcMtL4sl21tuYM@p;|
z3*7b;Pt4KDx<}!w+neV5A3^?o^6pcnA3&eRKWZ>T{KO4)s5CrfNAa&*Bh(ra#ekz0
z)m+{Fnc$>pGJ)a&FmQ?#6RB7e@g#Bd#X=QHNfbthQ9@6bdLy^B<El=WeFOgh8GWjd
zq>T?vZb;n^w`;%q#Qy;D<F5e}LDRH{V!BvSzB$h!Pfa6A^7S&t;v!U-?_2G#-(Yv&
z+ut&o3=B+8P!qSCwS!mjuckVr>4(%G<F29x0#1rIwG_dMZ`^O`zFHsSrqEme0EZUX
zlTy`utJ6M3ixq1u#ax>#4e`DL(n}>GEt9KA_4dovDbWwJPyIrK08iP{fO)Aw{W7im
zchaz9{HIf;Kqj=Ey?M`ucpflSm{{{rV0~}$&W=E+u2CC74MZO{{2X=3?ZfVm@z+9r
z?0r!61TXo+{{ZFx0NK_<Mb)pw5A&Z3B>o{f(#sp%lS9)ct9q`8u4{3Qxle8%e82jE
z_HYE~>V^LR;y=z<e;$39LW}AKvBr)+9QY3mA|ot;nZ=a@?(Rna0KVfD!2~k8-IW8<
zy?bM>Pi`NiC-I-z4C^2BGAkXt$Y>vr8Kpmpe$06ae?J<sY(oModgqM%yeZjKhLviF
zH+b%}v8t+|Ds90dSO=5yABH;RJ*a-A2k|G_(?}J5(dkJ)`GI)n_?PVH*HitW(t+(D
z&&r7Ym?42-R!wXV1HZmZF+vzJIgE4dnR}9+%s*3a;?J_cAO8RlfP=vR{{W25)qfm)
znF5^;G{km|XdV4cXXgY2W<*16zWb547>=yQizr&VzlpDoPPtgc53Bn}{{T=rx&HvC
z&_JCsIIV1TF!vpY<DWA>Q72f^Jkzw3I~OIp(C&SGvOAyZ5^S3JdgJu{Tf;DO5=sFc
zM+Zq8>}s|kpRQpuGR`Xz;l&3~fBAUI)dRmI(A(bdD2xCl4mQ0iqS)WBZvMPtsxulw
zS5YGW0Dmlgk6X&A;wlLoF1P!meooh43@egiv;;{bkV2~gK>R&_#v`lIWDWrXU2*t(
z<4Ms;7%aefTA41GZhLdvAEoMA4NVzka;%z3pg|OPuEgL)!!Q;$<WT3fFo?XRAzgMV
z_ujkY%#IqzmujKg{_ukviUNZ3`d}#_5URlUzSoq{y26rK&op*B`r`Niz+~|hQ3N5`
zkHb0$wGB*7X(Vmw`C(l!LKToYvAZAIJt*Pu%P1y9Bv#feUHx&RDuPh1rK*6_ckuMZ
zjpA4wIw_N49FuEZy*K?bAruBBT+sF&m{se(lknR(5JS)ktz4bPIw;en9auO8tk$1x
z{{ZVK9vu+K#n6v2)4}xr0C-U&F}u8gN+_zH2>t$JCnR7J5V0X|f5$lxmkQ#;cE4-~
zjha`v8J$#Blh}3`fR!w4X+7&NYXu_$TSy=Sw>|xM$VgH42oi<w&I1t}!dZ4@G)J$$
z=YlnmqdKbv1I$6-ar)tfw4*MiR<0X{?YF+?0YbAdl1n3!4e#;7sM7eGBL&z3wN`zG
zM34ytF5K5SSoG>sV9?yEf_{f%l4#jvvODq)L=eR!{+^dxp{x!5BeqZgwvMDPZ6|F<
zzti%`J;e1@?Xmv=yd~~E_hNlHz~dH{8;v*duY3y`W(A8;x@!IHl`9!asTIK8Nbi#}
z5lX<w2EzCmL2{}T=oLb!*Bs+T(;1y(P%VuM=bFV1gpgy@qhUt2_Qevo0c-%K#@HG<
zzKJ?H8Zyq(qZDmQ1rhVe%!WBxL#wKC$_-(fVbm69B)K<c&HZw6A2F&V?{$FhCWwjw
z8;7DuUo!hy-}K1^^9`tTzS%}}FpHqpb_-vP;L^oGZX53JfI(f$8uS2ia5@zx+m1Fn
z;qov5vk(UMDv!1+`4+sbs1G-$1ID3OeTgGV5%+=bc&;}fuob|pc7W+tX%Vb&r|$fH
z4oo4TK-T-#+h7${Wo9DC=CPzALK-l`YSVUcd@wd7t)0&zu(yc=g+|<69@T&bprr#6
zr*r9f!HR+#i{RcE)t}33R0FW}=L7Buz3+SH0W5*OAG&q(zuhC80ycBap2Hf@!rD-W
zzrCxsrC=0hVd3s|9k<%>vS}p<3fD*5*91irFm%*N+kL_H_rn__BMD2BUP>MP{jvq1
zzjd_&D#qEsSpiP|`P&2_4Z$1W7V>V@`2mzxL9cMiGypf)oI_;@78CP080<mPD1C8C
zv5vvpfIV<J%~rr(8*jYVM{$RLC`B7~JB&hi-;VWxSr#I|DI`|=cl5+ypabUE=MVwZ
zr{#?s5nu}^f(GE=A@eq%D!9C5kg^mZPWOHA>LqH4X7=Y6ML?^igA=*H>rkSB4fO{S
z$TkIK;?nGC0i-0UKaNG1=>QT3#{-ZdYJEXZafLiPZDH7UBN&7b2G$Ff`?bHvBwe1x
z-T|O&ip8_{Xd22yf>I;lw>Egd;KW)oRDgM1?*Rt;9@zDw>>I7O&PD{CL!Rdt#-%kG
z6pO0vFc9w41z>NEH9Spq_;N5enAsJ097eONVeNy=0TyWU?}bQ4w%mJfoEVX@8~R}i
zKnI<(fYrFb54U{MvqZfyPYig3ldkz5m4OB~XPoM=H{a6*U$DX~5o4SVElgI0pTi2G
zkar;a_rw*id-tqo(SAlXfGlYsjr(GqBi9+W8NdR**aa6}#O;e<8zS(ay91iVt0wCM
z?E1c-%0b-vk~uf}SK)xGcr4MWG%cF@VU`IWr#(SXsH6^gH<@F0)=*m~JCD-}yiNo}
zDis8BazG}%Td);=nXUsAeLIOM*zN(?9LgnD8z>}kTV4agV==O_Zgv3ve}@=iaU7+{
zA&>VC0QSM5jG>uF8;$_@{uo2+0W1S{NL|mv0?dol5v8{z0b<yn&|^fgqPC<3!KL42
z`g57Yd-+Q<U)}T`ryXQK36+kbXb)@$ogq$~kaZjKsqRlF;4%@TIp(i@&fgqvrd6JR
zAa7>7{Bqj7E|H@|wt5zM*xufl5|$qj8<3whU43&zT?~&K_(I+#E&$j74}6qN#A$yh
zH^H(qUrpmH%LFCf=nCJy!y>%Mtjy6~wg+-{vOYNeG>(rNim_s-Soq~Sp%hH2R0kh;
zhOo!eZcZucS&7+47wdpXVbbozIsW76=syfDjUvXY86<Z%S##ur#Vc;hL74r+*nyd3
zl}rl6G3;pUaEnC2Yf|`uHlRGX5+gs1(Z<E21ezD6M&##o^C{`%F6QV3L>pa=kG9!J
zrf(JFTB$iwIX(aiLG`|;+bGEkDYK!N-rm_lwI1Xuxj%Jny?$K&88IkXC@!^D?XYas
zE7*xbQ-DKR0YLu%IR<86u^SG|$I2{r^~*^lu|lRlF|Yw0h`-bF%JlK{@+fKCt?hm5
zZU@6NFIv`gAWc49HCjbc+uzp$a7EM(tvnFTs+VAQCxM=-#)_;YTa|Yuh~I15xZHo%
zW{zXi>MZQ+;E;;cbstlhUsqEYD<}`QJ^fA<qIC$)=^nZ|n$E-Y`DUOxNn%GTMv~7X
zo!R{W?Lv-WI-}`=6x`7+Pp|Cd1hBtIV{J_)%A4)Z_xSDWfu>eYtEG}kSmKC-8nam>
zk;lK`k&CEE0!|9M2J=|IkQ{B3>KM$iMg<*|BL4t!yrLnAye1L8mIQ&pJ8ie7;NVVY
zUZ<>9Eae-_%zwR!vz-`7%SOswmY9L*S6lph<>8hwI`uNAi)PgT+U)IK=CW>`G~GFo
zAHtNl8bBqRbAP4)b$H=P<aA&~81H`H<oym9`re>;vLT}AW73{oB8aWMiTLFR=~ft5
zR^T(T1?OrT_q>xBo)%#0vb$b|{DuO{Hi+3H2a0DSb{lQ`_QvX65u(r{5vmU-a((`!
z^Ttf4P_eR_j5}VF&c>|!1Dz|GCS5A5B9BP}jkhG^4CM^Uu^nimdf*=TWP_}3rO`_g
z{%s_IW8bxN_~$fD;rQJt)8ZXW&B1O?-G?5#<=M==IGR^2At2fQ`t4qV{u^aSp0Tq>
zszP*Ml)2mBKDoD})U!B|RaQNTkZ-8_eRjxn21$C@<9d*pb#Kkz<%=UP^9*$W6qj-a
z<l#lxn@qC;q1uJl1B=Qk{{Sx<Qb^Lv{i-Way|Ow)<VNLzR`LVMJ^uiI<18LSDVM~i
zUj2{_fWO~4BnJ)|rif__-eJ8SZ+}nEe|#asnH85zgsatl1N?T#B9W%%{+I-S1(JB7
z?RGu`2T3<jollJ$1(h205qqCcetwu2XkA3l69R>Zty|FjHvBSFjJ_$_ysE!0Yuo&1
zL}Uh7!P|TG7sdSd!qG__1E?$$#=2VVeBZ<$rckpxYI#X%nZN~!qDQCY@XqR{(h*{G
zR0>puKY085V(KO@46i5e4*tV0FWIuY0TzI=vY<f2ayxz&PaI%Vq=~wC*Qkk+SHp3!
z-A4qU#1CA~Wp(O&S}mnEJ;5FFlFT}I-Z)tp$@hpB1s#XvPrziQl4#DNG%Tx1n+;3F
zpPmGSw%#xG5COSUWtj2L$LX5>(Ca*32m*_tKrFv__Xp%Q^vqBp1^h#=K=Ov*6W{mk
z>6?1qogjd-?INIR?_>=l>ApY%^tBsBu1=wg8AO0+0=%a0bICXD&Ue|MM$@u|Sm8@y
zBHpXnMSAz&)7vF1%6ep50hk9mc^-r5`R0zD(hW;2EX)Ygy(>1`A6`xb%*oPqP$U9I
z4!0Q}cri3SV!L8>QuR&N2?Cp%W?*(KNZRked_&YTbtkBdyDTQbPI>kCoWEA^Nz){O
z-Zv7EvDFZ@-1gpp9>)rlu}=UpuA><K+Nv$K{-ow;W>tuxNYsVWq>aTM-u~w;JM|(T
z9kn$wvmy2DPqD-?iDZdRk|jFHLt1aO_Wk;0Mvvs1!XgG%l15cAF6BWVv6AVGu@=-F
zXqyAmgYi4yln5m$(>|vQpjoqh&!F#?r2a~B_GKG_Tbi+d56^1A%w1-TNQG6dii5e|
zx3>fS^IR(3Z2CNCBa%WQQrjr)x%B4q1X0NX2@REDdc6l>_-6T}ientHs;;6`qK%Yn
z6kpc=0AnDJQ_}c7U1?thNN}lVR>ICxrUFi!6_sNFox-o)ZMWa#0QuqjN+*o8(e*1L
z--TfAO$(vfcdy>rx&W5aP8h6v2;($KAouJpupgup?1>Q)6go<t)xR9jym)j(KdO9H
zT}77m<JY+rewgpkw@S+t>gqsP!T?6(1798me$1qtFHHndM$F2L?xb<=L(~t;0Rafe
z^1G^oag|#P2G#-X{xRA)qUpy_@v(=*u<OUd{$GYHs<J?VnZZpuW38xwZ0)yij@bux
z5l0t{#w23OFN56RZxZy&(v?n}H&R`sG}TFBm+55uev#?AsUng$l_Pk|DiC&87EM<*
z>t2~7JdyPXWLu0jkr}@-f_62(JpTZ!qst0Str%%m{{Y)@W`W?I+j?M1BC9NOv`Wan
zXYG5D`}kr>IC$c6&Rq>HkU<@};)QMT%B<p8f{P{GyKD#`bMzJUIG@S*6S#E@01B_R
zliL0N09yCJCPrOC84E-dc!rH7ia$%M@AJUgWpH6tm5T*Zt6L4v&ol|*UY>P$uTs(w
zwhrJ~_zNT4-)x+RrCEZYl~ck|sBYX@_;N?j07UH@r&P-+M`A<$(r))2_7BtBAMFv-
zik1kYjyX#-QR*y0U5h@Qy>|MnQF(e%A!4>;sjMKX<NpA@+;Bd4(=wtwu1I%405{|(
zVo%~f`=O8n6UOm$nsmt~g)xP?V^zO$bsyLmhDkb2Ez?NIs^&)1wH4V<#_#Kz6=UhT
zNaSv!)>kYeiK)W{r6iDRa(4W=Gw>EAmL-@vun%=wNC$I$`T2eoT^C&#ex6w%j#r2f
zRNj{xkWGBJ^zD&7YIt4%0V1n5H519N#P5M2XnIi5*aeJWo(p>)lKpaX!mzpUNMM><
z!)?JNeqS6TL~*}WDoG}o^{E3#lrs_BpMFnl%Or2ppDG1Lw^R3t7DqoLn_wnBm0ed}
zjvsQqW!X6U)=Bwdj+RE~dWn$6QX#3qYSIps6geal@4-E<11V_KtNJ#u4%^wUayZ{N
zA?i9Vx22;5y+Y`fN)SL4DM;X*xcA?Dn1`n7B-B!&NXSqd&1gA3w!{yB%<}bS7Lnm;
zSWJOhz`jNN1%riM=0=;SXvAQUNODUKYszZ&{D;>xg{hSq;!YRP?m79Nu3Mq#qn=1v
z%!|`&5z8WrRKIWC<e-LGAf1A-5vXERSi1v$+#kdY2PE|}O3<Ul7J}Li<x~;B$F<-{
z=jvdWs6xc8>tn*HrQg!Yub9Hg_t_bcbtgb(APUuIQTFnj(<8+PL}ibuLi224yE;X4
z{{WFbZ<Z03FB_)mx`ss|B&eB!gQQ)bf!mST9B!5lsU7q>^zUsM5*-BatO@@B?zg{x
ze5X{gL(%wgJo??WOaB1a?gys!ewhf`PZ*)r@h0l6+zU2q<7elTQdcb#EK#F0VO&g3
z<XIF4rTcIOc8I!#MsUH`Q%X++04sl9e+-QA#T3%T1iICh!&L?w8l%N;^v>|igmlEx
zh5(Vc=XUiy@(aojU#-}wk=)2cV!$NX<n6Zj-U`bc^LSuI8u=N?)JCQvh}fQQ;Bp>3
zhDM4hE+i%BpFlwW0Iz&6Xvd^QU0RhbOAs!{&;4amGwO*_%O=0QTeBM5;5^mw_rmeb
zBqn%)Sj*@x01Ct@uswDsY^R0b^y-tNs(HcWY9RXjKnL3ws0XHt`D5Y+Mg&IYl@F;O
z@-_6pnvp6=DODQ~F2b$$1KXYbGkje^h{6_bor5T!S#LCY2d87TZ_O$1kem5L4dIzY
zn%uKcDtIgN*}Dqc<sP0iPMwr#X{a4Q@6Fe~!tjM(For@rO*d#;mEOnC^&Ys!LS9)V
zMl)LmU_svO*#7|UuDg+vGP+6`R-I^Rs~dXW#9mS-U*>K~2;hc2$l|Y_K;r^F9F0c2
zfE#nS0B!QI_05{Wd5n5vN~2)d8*IM&0lz;w$fr%B4;E%9>_dfNu>;f8?l$&0Zw^xo
zP!<qDIn>0s+}&Gkz#y7D0)1?TbXfXv<}4)vi5!4yZ<xRO#YGVp4B*71sn9o*Zr9t6
zYn<AhKiTNz`rf8;BraA|7U#-Jn!2VWdw@Oia6r!#9x#xkjPa=}WHoVQ`jPOnfsIv`
zU3BQz_gC)&eZ4Z1#VqV*77@q;RUos#t_Ep6ID@JpT~cb9kWZ{=at9i?t00qnWO|8Z
zpGQ;FF(*QzG2cq4(xc-*50(W#lz3!lPf-bs0%MSp1Au6ed-5-TOfrb(>RHwla;P<g
zJ8IMBCjIRCZRv>?u?jelc$C&R)j(K0Py(*~#zrXDLvLz;mSW#{SQ~wR3=5u)Nct$c
zvJv7*0z7@x&>$a;o)2TjXI6Pp5{tT@DZUB4zCYtM1%Y~LU9?8Q)F$PaHv8A1tmcoW
zF{GqS$Q_ZFPQX=w4eoCL0DE8<Q4B|1%&<Eskx@qKyw>8#1buTN7n98#YibRftw#By
z@ydgxQ)>QQi6Qo&Nc86K@cCoMEk?|)5?M6p^63fzCda1$cIN}UUYcU!YhriRd!4}3
zXKDj|{W5VX%<@ReN~-ve9|89Ofn02V1B=s<9EMg!wK|tctu5Q)EPuRlC|<Kswu)9P
zKn94txxjt)Wf2(&p%Fp=0YKM$bNGXc7gH1y2?tLLMopMam92$Y-`|{NmT8Iw3Q{#B
z0!4-HDE{`_zD6LuLo8v^DzI9%1f8$cU{PUs<>^OJ5ojiDglq#k-E2+Qa0&cz5@XUl
zi5b#`iZEkElEI_%8PmJEKxOI~$^#HmNihM(wOKoR98kZ^LW~nbB?Dx(vuAKVf4jn&
zW0g+B$Vmr5wqfb*$RG8W>N;!bBb3b_P-KiVy0K!6Sou%AC_fCG%O_1ckUTlzc2+{x
zRE}{~6=sApGN#3Xy>ZU<x3&j$Qi<5c<TzF;g=~aSZj^cr{-+}y%d2&aR^;z{><7;)
zEGl|;b&-zcBMO$X5Jl1Ff(~*bMyJcFK|n2<Cxh`kA5L&6lB9@2=!;6YBq=-4vQNJi
zbT75!6RMUe8eN@=l-5)bED%qn@6J*vStF1c3PcX3UUd*_Zp46Z;7)f`kUUW@Ow&kJ
zJjK9T^N=VD+eu%UJ+O|FDLQCUR@WGvZZ%%%!C~>L`5c<RObG@j380Dx`>V>|3$48}
zojkDr05=bf;{O0H%oWOtV5Y9Q1HM8_ms`n7x~PNnz`BNsV^@q61j-3o)CV6ekK>Ii
z#~aELNSPd{q+2yyi|>5z&P51CQ7?wE$h28^pc}Xx9^VWv8J!|#4IFDq?jr+Zz5Ac_
zfQsc<>OiX?;11l5{@CCpiL~jZr34XrNZfOK4e?=r2ua~9tbo}(kOd#iWJ5?J7i0Ul
z+XF-|AZO4Vw1BA!Z^}=;{OQBg%+A_n)?Y#oI)PLNr)tP57EMZ`tZLM1uIq02>2gT!
z0boHpjl1{CI7ng!P~~JMtGM9Zd~%^CLL^eJ1Wr@VEk>cudx7|SU|l9rBLYJPAfDvd
z-xf7>rABf}n<{GjyNmc_5}8&w!l70gbrZn^o<9r-M|~iw+V8*be09~Sw3}+Cv#R@T
z*zMl~XjxGui^#WIX(w*yD6FZdj}VllP)V)E)M#_J*Pi&!QVyHMj@iV385u(jxBws5
z(=(D@Qi!C6prEzar#{<ddQe$hQ4s_z)&~BZ@xInM;{rvH!UeV6X#=+W<z<1yJv@?-
zQNsaEsg*&k$8K;mZ!C?}NX50WB(T%X@BaW;vfAo+n3N=jW!u+pg$xIZ4>(s0!cQcA
zYUKUzhIINN>N<#t)#0{~bpi-eR1f&dH2pj#MST)6Un`>%O|h^~zQ=Eeu0$A@r!#nn
z&cvyYLA4&Y$8+?^1ZV#MmjWn!>ma7SY;j+%Bw@@&O1GSXwZWiA*L*Dc+xiMX1ih%E
z{{TX<z;2YsFlJyy6#|H(!9NP)*C^>acUE{~5fBFC9jpO$@A>9*I=3KsPXt~3a)fD?
z;sS@95x$=P04m0hRLZnM6jn3^1s|>e1oZT(Kr$|u0PY3weuF5l5DVfPQ`im2-p2b6
z$B~^gu9MTp97-9BS^`_p3*_;~`Nb$=Sf-*$y&;s1hkxIu1mspaNvm(WeDnJltr@LB
zbppDH1CBFPj|80}G-hAsT1_nw2TqUyR=-k9ZSc<NdRLxL4nl79F1FGVh`ajWAXa#%
zaH5q1uwz?T<K|ak>*<-8Dx#8n_H9NvU_7YzVBe+Xj9ZN@<H#5P0H#f-03BR${tg8u
z078(gT4jygJdC6o+JWDlj^6ndSwpOm2UkEwq`$m5H~@C(*ytryfp!CMPZ#a}@r2r~
zk~N8f*(<mrtB-y6z=0vS?rf9r%0{WogfOcEza!JXv8*MXV_7t+cTzd@KbBEeFXb0c
ziTukxm0bX-LMq3-isSLXo~J8P1<)-=J9pdh`r|@KW+_Xo5$mz_J-MtsObgRU@G*9l
zJ5~<5bWu0AKU(jTbx8b%LIs;%NH`rVizA0DC|UBT1RtlvY!E>sgo$@DI0~0mPS!hn
zVgik7Z`Wb;$1__h(9(dY40yhI;`#aE9Ui`(VCZFzbs(jB{Bc$%1P7ob2AailTl!;}
z-ZwxTpo#S>5lk<G>zo*>aE_Kn%rE2XTzqh##mQS#Qg;eFZTjUkM-zsOgb1p1mL!*|
zBy2c4*XNRkUkh;($!bGiYwkVqbQvC<ShorQ+@DMbVWl18BqN;`M#iZB0K5>SlTs>K
zC&^n^{o_cwor#H%5<)7HKsGk_+w{OlWL1@!c@}r$fCtwAvd9&5Xefk@h_hSo>+$+x
zN#ZEg;sL1ml)aAi@W*2Ao)W6C*zr|EeZPO6A~bPp)DguM8yfiG3?#NxI%8zq$ftHU
z-|O4c6iiyinANpjt|(Un_vxJ+Z8=09XL17aPdsgbLR}RG?x@wA3p&K$Qpl#pvPTEF
zuTB2|eWl_eHiC;G+*#uckif1LCSsvMEm!8P$JcB@5q51WYNFVWPkaZAp^3afz}kl!
zj9LExsnnK;0jaG*u8=-mvD)2aSV;)Sbli{t<ojSrR6Ur*?M1f<xZb!vlyEyiMOSmF
zfeNa4uUh^0$g+>@Z9osER$T-F3z9&vNUQHv+a%>x*hWoV3-rRMzIV97uEf(3Uk&g)
zZM{5xQDg=mrWq8%?u@!wKm<74Wx7|Fz?Z`cN`Oh#MQW&zUx)a}GvA6=O4&YL&gADY
zW(v06LrOp5JK)`Hnm)F1n^u%oO*>z`9q%eR<ykzsLUF%uOFy0>mr_8ZwGanv=_C#1
z3IMz3Z-!IDRg5(-a<-zjVYnyiFcyMPA%k<jrghV?M%Z^4XKylw)L)ijdBZB{3SYw{
zkN%k(4}W|Bx|)`Np|JpdIEp~x*z>E?8dck8R&7UCo(6D^z-2v!kT@r{19)KSDiw;T
zHVuE-&XUqb(Hkm-78vdgeptREQw>Cgpb6O4D0VuOo3U6G>LU@I1teA!Kz>5i@sYbF
zg@8B*oOuGMQZ_n#!FysIhT^;3U^SGJOEL8g?TX%4)TDq;#P`l6Nl|2z&5khZr}KHm
z@qp+W810&gKSAq=l)9ORl%1OyOE!f?F5=1B><?}+ns$;s8Z_xPD)#wcL^hyDC$@5(
zBjMlEJ5HZl=NrS3%`gD$0Pb(L2P}RlVxXNO&2|_h6m=B|dx{l}AXu#imc6dHI81KA
zNDRz)?l3uI{-81dNfc}Ye_SZbN@M}!kNZZ~eXkX_)UE?J8isLVy3mAWY8O;j;ehU7
zVun8vS4h+tgJ-=}ZIUF_iVNIcb1S7Wr4B4tahwX0EkGUcIaNF+wmR%k9mYK=3+Dy+
zB8}qd)2m2Qb~k5i>p>pu`tPvVU~rJAX4Kk-!?r5XVZ9T{JPhY3Xw!T@-Z|1r20zmz
z7ScDbYym7~04zfidmA{WFc03fJ;$yzx)*5Jn;Y1y5wS+rjiuLnz*2>58w6(+3Yxhm
z9#+>SxU1&7VzUsXbv0erYyz^pEKE<P*GaEK$T%xXweNNF!j=bS1XkU!qP*6r8Eqo=
z><1?SV`WlVha+vTd}?M2)&K&w=O>_z$i`iouD|<TunMVW@&bL2Clkyzua;UyS7lV#
zR_EU&2`tBQ#{;~_%numUNVCBfEc1ZT7p9nPSj>#>6w;p7b{GMr20a=8H+uWmrU=|4
zk{EzRAABmNh_EZy0+m%DkEp=wF)<yn2Ih$O$0g;Y7C^E-7^RuP2ar2pD*gI5Uf9D_
zZbp&~@!V%{LE8J?ae89PYXE|5y8Y~(n#M~2oB4X@Rf0eVetj?iBaShuJvLd1zr#2i
zP&9&g70z%%8oTfZI18z`x&sI_X}8~O1x*pCXDKK{Dd7C@f~Kt2F0XCy>L&dT3gC)6
zafK1ZV(v(#zicLg?xW**(LaSCVu7o(U=W1cC_4@Purm|f?f7FUW2lbY=SaFyTGW;o
z<ve_Fh9x{T8hpc@`N@U~*FcX$-x&a9I)V7!DN@(H)(0>fR^Fos8jW2a&jO<XuEl(C
zF}?Wjg*KArm!4}9#qVd^3YHc?*owtEl$#sieS*A_qV)C|Q1<@-IiY$b=}37TH;7F}
zr+<&bGE|z)kWEkuIK!`CFYfxB4b2isR6r`U2V<F}fl-jD8x8vp-^UeO`H2e}EI<cH
zs`kdvuQKZ(AmYD#;5MXYWHk3*Ojj|=Lw(V!%*SA({NOCoOC)jmQ&nx)d~nGK4yp(=
zpzXQ8%J45Fojgpx%A*vaWxu%mKYV6>xDvuo5eu*+h1f4)cwH7QnT0rgR5sXp@A_fs
z(mBbA?!G(Z6M!<p(&=hnyufF4)1ZpZqrcr8{c`<BhUCE+5=Nlu+>LG6{{H}6k4};F
z#Iw;OZ6l1K(5|8g3*0Yd8MYbKK~pY}$O|>q4fYx3^+^6PE3%#S4h`eS2B;mTkOI36
zN1x9knN=L>MJH1md*BY=?<mG3jl(J4z^WfJ>y+tZfJRi7G9LYgPpRpiHF-+V6uPdr
zz-Xlb5E}<#%ugPl49%flX9mPTa1O?YufF*+qyXB;^Kd(5R_7nn1P$+h-Qf?>q@E41
z(zZ(N_lW1|c~j8%AV_sz-eKGhcPHAh%uP(C*s_g<fCkvHOB=+IQ3^>8-|{E)$`&`%
z8ciTw7D!&?ZIkLcvDHXCDApu98rYrvKTOoUGxY;hOe%(^;4iZGJ7hnWngeJ^uQsoa
z2Spr)U6+Bqn%jPTvXG4rI!SiMn1Q|o(W%x}Wp3bdbGlgiR!KvnhgK%9)3z0v2_wV1
zH%u4z@WC3G<|R{DG(5erng#KJnRFK4W5Db(?=(>>7#7=#H|1LA>yRf>n%<FhjsF0q
zq@6#z{4<>lT`}rOi&E?pmM3f-J3AqTOm^-4#;WsV@$}t4M5?k0r|}1zUxuJ^Yrg*7
zurhd0)aZCZ#^?pnt@{s-aq0wNqb#G1N4Xt_EN<#NNf>NHXuaH@hEuC$fy0QrHk4{n
z?RB@)1Ej8=7gmY2kVprb?me!@*E95!in6q<cM7~#;ClZ6)>Mg1g){_b7R*7t_v7W1
z>7tHKm5>9a4xuA|ao&Y`cm3`X4d6$y20cKiBkvx^1d-IfF;F!c9;cow)Ah{}^!_Lk
z^)7%}DyM}#&1O+K9Ykv<-9cb`oFS){NM$<W0!AcTb~nGbZZbumraA(Z4s?cLyI1(z
z@XF09NRmB<bz(y?z0MdUStO2GqY`OQqgM7$f6wWKH%H<m@$~XBP~%G1JN5&M!x?Us
zrG{sX&fqXQg8V(N2U`(?!0~jMUfHREBewOy_QaN0qeKD_%_Y%1F4Papd<8&|(GRX?
zqFVSo;|`VD25SL4PZ8LWXKlV;=i!lxKjxY)jcIi5U5VfQd@<umq-{K%Vw4-z?fdk=
zW)ep)jT<Osrcejn9lw70(n?4yz<7+>uJ*IZKM(VV?FErKl~23>03ZO{>G9z4nWru^
z0Hth@FP*l)(gu^EOEQu-BXeBP$ytTjiXDkNo-d0(Og<q+rMs$cQSFZtqv+}5k5e=1
zzfuPu4bA+r2kD}1YR<}#Y9uih1r5)+-|BJ?BAFdoO^OM9_@I7Wvu{|D&8|i$rDO;^
zJ^Vvv^p3)h;h1M;@tRPGBMb{x;A-vf{;;Y@pUVadFq2Bv`}eK?030#171WP%-7I8w
zBlF)mVKdA8!*8wVcVq8f+kHkxF*5anIw6&{9TdcmUAC;Kq)Jy<Z#zg0l^ZX${y5Hy
z9O2e#Z8hf=UB}^HUxp66GIY)xTFP8`ZmVui-;OFKn2=1$L$EAr*ml@=?||}jv9z(e
z%Kj9DX(w{WzTc<H^0KdqA6X|;Cb`y?Y;MGCZ_`az%iDZYNh}>#j}w*fTl#iKlzI<;
zT(~JTMqPC%9D0-9{#g_{0bO;<x~v3J<7oYM`qo7CN2uy_Duyga9=Ey5^%5WEVjArP
zVAas7%>5&}PbY^P00A^P<Dbmo7nur0EU~ay%#;_oJofLm%O?a*{VcOn6}vv)A5MQ9
zNflZc{L*MbOoVY;ZavTV%?ecX{seL|B$OMtG<*JkETczKvvrQk7!%Q5Oukh+P(Hw3
z-orD5Rq7EGv&OW8NV3Ocu*yR(Qvq1x>PUpkWvGw}_xC%2{{VT@JiS=BmhQj`w5p?%
z@3-fWLQa*~HpH=QR>r&Szs~cBX6f0wh{Fg}L;{+--+z97n1iX1$)Yq1+OF(g_I>uo
zmPpts-@{uafcwPqP5}O4=SGw%@O1@iKX{LR+jjo|80!?$#APlth6lq#<^T)7fF1C~
z(?ZZIDuzoe;ZEf4cK89EBdl_RPK!Y#P&T7md}w7Eo>L<DU?^0gO7CZy{BgR1pr?dJ
zr`+f#a(4rNPxI}CB4zQGU+9SUCH7-{Eq!v@81(7Y_#Recqtd_x{A&03{X&H#lf;H+
zYlLdHZOakA>-5P?^7UOu^J^PN3%`ftU8=Yr{my6Vnc3uP@g!z0N{Uf?-ZXtnqA8e2
z(1fI;Kr!w<pN2tL+F2t0pn6~G5Jt^MpQb=F#{r>i9@LGfozLU|_-9Ebvhq7>(m+*H
zK-lByd3g0S@fo>dX(OU+j@_?u^B5V?BpotLx|E?~XSw$D_W9*HnNm)k5Ek|<=BV9)
zUZ%GEcFXl0WW8TbmYy7OBF5TI&OttJk3Wu0x<R1Fq^x8LC5aYClvi`l=YX9wOJy0t
ziY%^n8+IR$#MU{F!7CcHg<b5178!dm@7&<(!YqvyzlNZ0NCb{6Z;8#CVR1Ylq-gZf
zxj%4G^53POiLZPN-U<$?5fiqSD#A$^00$In>wcA!g=KjqXyILyj}5i}kVTJix%quW
zN`IBo71)KdA?7<Zb?IAg>yj`mFf$39m7p|@fF$$iO&ltv-eV+_OkBEZ)c1BrZ-4WM
zBi9H4{6>Aso=Ku_<$0kDMl%p}V$KbnhLr^FeTf@)uWXDxN)DCaSnH{BRa*C>To0E%
z_y%M#%I`C*frp8%_Hk!n@gVP-VvO}YY)RHk@8ZY-kq)9p%U~acQS{F}5-`eGu;1?2
zwf_K&xhvxI@(DZ@B#Y&Ty?hD4(>G7lP125-$kM|YX=9ByDqCPrxuN)GC!N!$4WK%*
z@881&@$ANr$mY4am=w$Wq%05?YGcSDXdi(D`<%p`Au>WIB?Ox}JA?%8#1Dtya5Qx9
z6BYiui3)(~g46;k!0y8M_BoP8WJ4TU*~uvD&2QNE_s!uvKOByrMtV|OG7^hvD7E<?
zk<7Bs5Qxgk%OESYY;T>r?OXhPaEh!bohSoh>=VSX+R5AL^~|r;k<<vHllozme51HG
z^s-KA>j^Q&dSfw=Q#7WA^fZB9fM#zjG@=o&PkqJu{vVD8y6GZKaP>~A3wa9J3B``q
zK|f545wC}-BvqJFEMy%<$R7?bpHuCN(_3|6WL9wCC5{F1K9|S(!Xi$Gss=^z6?b$k
z+UrR_4)_%v6ZO49bZg<P#FS?zV%BcY2aew>%!8+S9aWW=QkFvdYF);!hTn!?rk+@1
zc7TL8_t0(yoBH43nr4Ms4xVK;stS>$0tjZ?W4NF!pN17UV`)0Lx?|KchG*LMEJrqb
z8XruQjGZ?^v1n5ytYj`XbpqE<!@Ybx@!8Bx6eSFT(anADx@wQ1v5Ngf?Bx)|%{7u}
z5g61--?x4JFo-Hfvnr?z7!4x6@v*V=syS({Hv(p0v>gSDVAb;C{+O`ECsQKC#35!2
z9IR+4B$7|JJL7$&;&`ZfiAg#a!@bEtKwq_0dthhkZDx_A)RL*#6&1<9o&NUC4bw>!
z?6q?&g6hd;v%jXt^BB=IZPGXM5)@R7yj~g&*p&n^=Yf6b*23~}xMXPKVES0IKZZ*I
zdwX|3PlgpUA!GwvX>b)-_gzD`!i`~@s&D2@vs0NPBXUUwh#!_#KBZubXuRbJI=9@|
zCca~S+C~V$4DS-6nHN$a+y%O!eej2YI&mNKGZZ>p1%ZhS;DSl`Uw?hGJj#3>2ne?=
zs{IEazg%w_x~b7@H2}JpY1E@|TE0U${8)TtWBo`;U0@pm=z;S;jsX5#_^OE7pGY-a
zkVS#?{d?yE!d=LHXG<tIr_2f8w)i@E%zbQgk|R?3iDCHVQ>uw#(uc5Pq-kr~#rGQx
z{kYua9OXw+hHY~w1#5nH*nG*vX`iSn%@}_(xs3&B?ex8<b{L&siPLonOKt+lNCa+o
zug5F=s-((gn?#IS^lmJ6_}<wBSHp_lN7AHfMIRpizjyH&(#}{$j2S{5^tGM_;Cj%*
z)OcaqF{(fvw8+avhX9e=f%U`E$09p2MkOICkCYNl!{2fEWgSn`bnJ!W@fnq>iEX#9
zO5f@-@O2#*h34tnH%P*<cQq$G3fTSA^7q|jR57npO1j<Lxl%zsUnuQER!UoG)${`!
zko92Q@7s;4@Cw8vc3F$Bhaghl+Bw+##!guhX;`SDNIF2=9f_gszsnm)NZAyt0z(BC
zU=Lrf?(zER5hVb`W0Za2#{U4_W89y>;B?Uc04`QpHEMP8inDcl{XoBt7D=Oh1~A%`
zIi}li4f=7ld*aV2E>YtPAT_E>Iz<6T;e|A$YUqo)f){;2h35SY-Ftj6rDiEHf_JAt
zRl5XWPTu>Rk$}l0wn80#YuicQ^F>26F+9eAM<Eo^6bZ6VHhu4Gm~yg16BDgwrvwgc
zeSUaEV|8~3e5%SU-2i=mEwcSWyQhufiFGsUU~SD-=i*PUG)WrBf<WFK)3%V*H{e*l
z_=yrPR3Yj$M6uei19c+*02~U#AqbB1OXhJKs5Pl;&A8*R_umRh;l$lEEfaW(+T=0t
z0lEj8@~OXnjpp(+46f{j_l$b)-1=;Oc+WG%{T2?P36994K<+;*p`Jn3LaR4W5W^mr
zkc+=H*E@2@et6D~X6Wis)4sV7cn@T0-n9>255SY?GGS6e8hH^Sb4Nmg$^aYJzxm2J
zc{+AwAQo_|7&l_J{PGAon=F!TB6l0m+P@6b(#DfYkV?_U0+Fv(1If1Mi|xMDH^~mO
zM1^EgDJ~qapicXMNZ5YsC!usZ%4JzE`e*<m{p{_=1=1#snNL-w10ac*15CGe2PAoa
zENEtzrjdjW)TPF;!zr*wy^XRE4-BK5*wX;iNF;+^n`ISMV?9xnA@Lb>Y9-0!A4<C4
z0gREw(?=RHG+CQ&6z$J9&5wpnHO(m~y0i^m8UsZ@CeN<I$;BvQERIbin}y=I`TqdC
z3oF48jIklqx0b#8_v4RqfU)b1{EbIVnj?(67m6rhi3+rfteQ5!kwbpKt%~(H5=vnr
zoh!eH;X%`>XpTNL>DxMIbO`!hJw9D-O|@^Q(`~lEiG4twL>6ld$B$jVd}m22s=5o1
z6$MTG)8B8dRzox|U?35NVde!#9ByvT_3_BMF_1ct#emabb6-mM@81E0f*9SAnS4Ym
zCz|ye2W`F>q!`=o22!JgV{u@7cH<rNB84Tj+Jz-{u1$RSKA2)uLnAe*08!-KjmOaa
za5^ZwD34H*jYm*7zODfk{{Y>6FBhejHKvv%VuT9Z6TSBKv3~g1EE-)}HYyc>*@b(L
z&hqM>6j5oGBCH0Yu0d^Mk5UD1@AAqbq(>NJaMnwBe2umQ{Z8NK3!QyNqU^NV*_&br
z{{VTyew;-bM*&8ShlwGO)BL*~kAC>9(UkHbA$L0V+Q+}G;A!f5ww3y4Gsa#x)M|_f
z-B=QL(^hY}-!g<^q_ZDT2j}qH8gge<MGUCBg3b8XZGar&%!V0SIGxxKRc(1*e!HKB
z14$5yKqMepx6mvFAW#JU_rT!9#Ssi-uyoYM`-<b|^29|zr8JPt09|M5a{W|LL|J-y
zXP8!zBd(QTELa@ZAD3&ufQ`c$8LlJ+b(^5nNE>^Nu*izBs>V`HDgf~Ai8punV30=?
zS_`X|0Qnfu{qOb1>6N9oSJ_dRqOH;6e%DrS+W-`vM3by^GDi_qW(z<XAy;lb>D${D
z0^U07L{O*h-jHnfzT5pUYK}Gv2bQUshUa_SUwyI4G>tsr7{wU`7XZ*E#s2-U4w?Fo
z=|iSKkD+v~omPD+&h^gw;GbQSGnbT-B-i(W_b1=p_Q5Qwb-7VnXd`VV&pcl_HPs_2
zQr6ybPjWCQkpVr$B4{?sWT9XJXpdiPQ1X8<t56PTu_`yeW41F$s04l!ML6;{o4N+g
z+2`=vCPk|wi*(yjZhbwgV}RW}noAh=Ay`=#&lT_abAZnyF+y}G-$M51Z^tPYO7lq!
zDI&Cv-*wwcq3>ku2dUePL{%~`PVTExd88YPHTA&b{YgX$ff%>m=DmRQywL3oJ`Yg@
z?<0`SCe#(~w2imgj@Plt&KJTkiIIhZb)_}>ULcKNC1z65vg!qPH(PVs>i+=V1FQ;~
z%;|0AVj9J%-1hYSoanTxwYe!E1o&k60pI3o#`z)CN|MIrwIBn|H3}R84%M|*D#TgK
zU-au!Z?G3x1L%#SLlZN|#Fs<ceXG}O6U%XUW;F2t(ntef4;*vvc|aCuOlcrQB$_9Z
z0PZ*6(<9-qUm->!*jXG={{ROlSk#FXiV~KgtG{~77m;RbT?1s)cPciop4mh_Jdt?4
zM^iAG#f4F&hkrHmzo%@1I!Im2ZRJ}&Vb34Fc)$w5CRSD~PUP1A01W3?!l(-<ZTv#V
z`>(gPS3dY!c1=DMfH9^e1!+6%4?X_??;1%SSXCV(3#hieG)}`~Uk}Fs*iM`k1(d1W
zil#pUzXzNw6e>n~gmksBWL581^Td%NK<bQ*Tau)mjct5w@b$ovBdUrZo>-l);e-oN
zEn@}lyh3ijdwnscgh%JoaTBC4J24#A!)@|nSv0aM22yC6+>O7+8JwM4Y);$Q7w>@G
zJ19m~n?>$*3SEIb^Lq;SImTBhdP`~-Wq928@A3I|!xNRz!EKSX0tnyJYQ*s*SR8nY
z1e-FBb~pLqT&1-r)>4k3$NNvO$80??M(Uu8tCmFR!+^{eQANGzSo&DS8cZ%j9khZC
zS@#*uATAgM76296yWlj4pUf2wr8UrEXc6!7#bsGV03!nXZSB8vfwToIrJR=7)oqU=
zq7-0!#A-M3p;$u3qBd#)tM2OIvT^xNq8965cf!pjErJ4*SCtyHGlAq^BX9T&2_lk)
zfiwwkY-M>NMAAZ=uxt`{*x(X8LDe;BBrpK|FE}wLM2tXSHwU-)z!d36g5FY1e*5Fb
zjitt(<P%mnz}-birZlY=r*pT%;ea?J{{V1`72f{<>-=DJYQ^;_8k7J9{ur)|j6nny
zJNspPc0?dDom-j$x1&IOuxM`zM+!tm^y^{0^IsqFkwR8xUFeApvqtFeLpoWMs6|>;
z;GR#%w%N|Bz-0qtWAebllqxVO_r7^S>LzZYSskNP)xBNN$5Yd<M8qtg%m!Lw!%12;
zE1SCS#!aK};zk8nw>8^-G0-6COC*Y}NZ9f@+V6}6H5Y`)?pcPWB#n)ow%-fM<FbNA
zz$)!j229#o*lssdjIj!4E{aC<PdtC0!w6DKmU81#*S+D9ck+?jgLy&>Lct2)Qt2BV
zx98gw$j=Z>U;rwses2S#jK7!eFlr>8FV{JMK%w;0Z{%P|9-iCwIDwTz22x3?KAFm@
ztVZMkziPsOhSymjEr5M@%IPryaI+~}03E(36cI$S4MwWAA54D`tU(x(1AX1A@bA76
zElguIA1Ch}_ru~lsze0<N#nV%@tmt6+&HQ{{4=9zEXQi9-N^iKInkM{0e3-1BOTXV
zW<?4G)puN&1Md6tig_%gfDQx1`W94YBTxWoAcAje{BfockXu%U8wBU)c(ON&1c4M9
z^ALGHxpfDqjRK2w1hCU%PdEGYz<`d>k)%)r@3_u|Ws$<7voPFg<ZaKx{AB^URaF(J
zmpqaC7_sW|cskka?4xnpw)j(Qs`SK>%M;1;7<xXbx^EjyG00vrmg4jeQSXRkbRG_%
zErBMx;<QYct!qirK|9~WA}YcuWN8!yQa<g~8pzNDog;HwU_7uRNv<%&03pliE58@;
z$^#?OW>Z6B?Se!xlB^1q<Q{J<8c*fic*99;T0Ku2Vl19gc4Jg*ar>+VN(#Z*fHlGA
zIz>9H@3!6XTG_bY8N)_&Fd&Qr<p>Uj)Z1D6r{RbR4?|<y9+aXgmgmiUe6TEQ;%PE~
zF0~MA<AC0H7%>9D<ckOEh)H72LsvLeX@E6E)t)ez)gG0Ld*CXkhz(ZTlZ=s>6fUr|
zcC(zssj#Qm)mX$9Zj=Ge;{vj(MIi{TR1NiWeez+MH5DWujutL=vwRVpfEV3>C))uB
ziNNE&H4-Qb!i*4;dykeB*CdpHweCm50HZ1?VnIEuViy{<DAL~9%}=na?VT8if*!%6
zxIOR&?$l1_YbOh>DDznyisKY%0?)2Ji1h|dRw!BH-v9tWJf7yatX5vzA8>G4^}l~i
zQ|VxLz;<TR4xPBaTx4A_vw`iuY(*_WY?0VuEK`G9@mK{>ox<4o;yr5E?cW?bS2Rzj
z<%-NMm~YLFFdTS7GpIe+mwx!8OCcJl1F${un28lcaa9fI-_H;zC0Fqq;0?-Mfxj5S
zL*eM5xx4S2;cNkQ#{IEK)3to?8FfhdSC+*n6j`u+#&9H!^>4Aj#i$G001>v>+D_Y5
zVu7~DVTV%zwfbNdQXgvEUidcLnkNNW?oK;_R6Q^do(~?_+N~>U9=N(|za6uy&A$G)
zKqOcfj0w8r90GyTKOFD=&g6Pva}M|P#&;|Q`eN=IRd0m2JLyq=g9=bV*zsRHKXm=j
zN3IgKci-WPD3CcgN7f{)>;kB|vTKZUAPC8%b9KQufSb2dY<b{jj|mi80DIN!K6qAi
z>LiV0bg=uI^v6jR!7j&BSiD){BA7a=p4Yj;nm_?Y_wzUffPszO8oYlRMJ1s|zBuiM
zNu!-tR{C~T1oP{Zng;0OiR4heEuVV$U_6qjfFz7rzv4LGAiXx7K#j;I!M(8~B)X6T
zR~P!@ypn3SC425F@D?tW(X}xPxTPoa!!Px8yC@6mR8Ib$xRRH7Qmm<4J8_--#<Xa~
zof|K<L0P7LsUwH(qBW{0+Wmewjsc5MI|6BaPr3PJA!SJHxDD;O%(B2q)=sM7SJU=z
ztIAmxDF)0q^}5A@-e%U-M{v*gMSEp>V(blp<QtMV8PBDMhCJ*SWdhCRL>e`b-N&3R
z_C;U0%Rtf~XwQ_L{Wt6mOaL7CheE9y8{fw%{M3aQFf1zg@9KXHD8;HmLy$om7Bnl1
z#*LzlBvM80H65?h;gPb!<l4^ng`y21m73J<Sc|WG3jLiVu^C)5Dv&^}sCtZ~A7~h&
zWCT+NR%7NMAAFBXABtsbusGCt+tVxm0Lw?>c$?atD!XbukFdYX=Y&NV$_a#NBYN*v
zclO0wg5wFPn2Yms^usYmflOhw0p}yX{bb-rne{4>w;z^3lLn2|BnVh2W9GfR>kMV&
zTS6AN+mn^?I(dOQ1ub{>7D?}nhBwq5mNf^;0NsV~Jw86zR%oHsBHL*kl6JA1gmOb7
zI~es49xzU#DEA+ZMlP9Ul)RD%)GwCJo2`X=k%<Us`kR)??nvUtI1Lt;@Wew?3pRf|
zv|>4Wkn&utKol%@<M->F1atVS)2sL>KdSZSJ%_+wZ+y)nXgXsh2GzfA_&}MZiP|J!
zD#e4g<9+`C4AU1_I(W1wU0~2Zzm_bqMDQS4JTeyClV{=nhGd3N-8$+U*`fOUc)+PH
z%_GQ3Qgv>7li%x%y*kULTU9J-j=&AO`t#^E%?T|kte563T8;8KuUy5{i<3$MBUb+a
zmEX_41N8kmvg!(T3Z?Ez{{UZ1ih~#%wxV`WGSNFpDP%)r0C%8!eK9&|3w1tcRdRmu
z7hd=jMktaQW7K5ws}Jqq*T#i=WV(pdbpcVtnyX+q_Wk<iwT@<-#IiF+9IR!$yZZVI
zz4JMb`8RYd3#|e{_-*_2!jfK}OKVpFtm;1wGT+fC%@Y?oDO&29_c<xh%_wEmBSo@q
z?|<`^XsA4<Gv!~q9`&}v@ZaZ!XIWiIP(01at_QYgR5GuKyT}Mt4^#o$=6~<D3mrS8
z<pI_;QQ&X4H@CO8NXizS93D-MZ@0g5glK=WS~BY#i!l-FdOIofzUPmb$UBJIINT2@
zK2U$h!}H27i8Yv+nP_ZHS^oe7zGHimG%2tRdw2Q$G7nAq&^lS-Wi=rh2_PC9{D-jT
z*D@-|AW0P3-TDn*=Bw$7^CRjTY1kGgu=L8LtKfAl;{iYjhMVTDy*NAN4KG+_v{hIl
zAT2J{L+X2<b6(k<<dQjmoebo$0jzECuha6)E7C_7Ngr0txndMC?_Qn$KDn2z>I=$?
z8XY?VA8T&s+x=l$dcL6by+2XZ7i;B9@<^|#+xJ^R<YrGClH`HqCim@son<9~7B_yS
z&cKZoN0ZN{{{TG5gqTT0G^VVb_w>Rl-`CR|k*fq26?>lcewbn~LhiE0Tg#wbjR)7`
z+<w7?Q%E|A3In8_Rdg@k=Ybj2F!2NLsqAuZ-}1;dJicp)$8l+5+IAJd_vG#ChAE~o
zNz_L&EUd*&qq`{^{Ht$!_sK~z$)+YiV>{~N$Q%Co-`^|MMGK-T>W!6EYN+mPl0Sb;
zp=Nb?+90AB!c`M`o7d~~$#nfLqG2w~H#WSGFN^KYQ>xK2c#QfJPJuvqkEs3ndu0lk
zI%vovRDjr4`>X!z=soZuCyFD99T+0VYDw7cZoYXzJkabJm?G)(9tU7Pc%4+Q<7?dl
zZ5mY-QOED&n%ARQV`hznPqVaQ$yMwWcQt1J04?w`ZweO*M5(bSonPo;^z$+WeF8uq
zd%7pn=Zx-+6onO(&{likUjG0a$@J>*7G<!5W2pN70MW=b9;$fZm&J|<+I2cYiqmbq
zdJVptaCgSdGelB33A5rkBX5a6T+=X@t&%CxjcL-r1NUqG{x_1EMeqVdbeSBb9zv7f
z<3sVln@04#Q;^EdWD~oQ$vLC>fh0=GtklNUb_V&b!=I<7DAChCj~N`5)3TGdaz8Jw
z60VD6g+lgE{zuc;UQo`)K9$~5v`V4{?XbU%00*_?UJWrvrM0Z5N`G|?{JzJ7^TLtC
z)3S&2u~5P>!jp6_(}VAn>0piAERr$=Viiff$m~0x_1hqW2-an#Qp@HYtoA>R{uyVe
zkysr>oekQKp;htq_~InSE}_WNt-QAT_OgEu&k-HE+gV*yv8`VC3)C{hI`ryGhHp6y
zYR3ClwrWU8(q@pAVnVlIM+W@`=0X%s<c$Pw7z1PAKYZnqWBpYYBk<V{qh^U8js}J3
zBN0K>7C?^LJTPt45AQ2`j!)t6%Gw<N07cnOmJAsG0LyK?=>F>%%OI4pMx?}|Vo0&L
z9lOx_?}^sN@HvE(w%=Nf?29Ae=D@!})b$+;GQ{zdEKRA41F3B7?bz4D<CBA@6DRWn
zsf`@S#75_kEBv3PN%~euj=$`sYHGe~<zs({$s+4*3RDd~P)}}2!1PtRaSV$xvVT!s
ziji!fo3H->7jJ9Gw6k?RR8gwO3&yOvwo5j9{`kuodUs@fT687T4OB_q{dn)(jLX!j
zFI}n?5@>ya-&Xry?|dqe^-dN|qXm;nkhVzG!1U(wQS{L?QoOPg;jpE>jop#(^u&di
zr)QAqVo(yNf<p`AG#H}mBb8xU29RW1J17g^;(nP?FDuN!iw_vC!pS$^-0%41I^Pxu
zV0i_2;egV7<N^Q$cJKJ-e>$*B60~YedTBtvPseWlxRa|$?$R-GfPhPRK@EEkd;D@J
zKqFZlP=ZQ;jNB9HUYy`qkAf4yUCR?Cec?dS^aFqQoF)>O)DmJq&tG&a9^XY=v{Oo}
zBbeiOoPuluK^u;E8`t54LIyoPmDf)yTP+IS#d~ev-#NOcnH$AWj7ODGLWU&o_~Z&I
z!>q7(04W4<vETRU@0OVz!Z}cohW?U~UQ$i(`{w|wG;?{>p-{!N?iAL;+j_ittEeI4
zfU2Zp#2Tws^nHf*K=jP*CWT^S4B(T+fqQ=bS*A(kXva*%7?n#uhAf`s->|SdY<+hN
z2>NH7q%%s6!qPQ5gB@HGwRvp!+;+XDI+^+yyawtS(ny}xI%)(RkK=yFAr#_1nF(MU
zwOy{{pVPm5n#CtqJZ*Y)Fcc53{{Y>ESNVfYAPX9@X+<Yd17UmoGenNFc%4c?5Jnzi
zMFnj;)ocaX`3%WCWoOWb#6&IcxxLTND<@MF$uuTbkEYeGINx%$dUvmLd~!`;3p}z!
zvPB|Pma(&uWp*P^pxV8~V4f$5x`lZXa|}Qh)u;hrRr^@u(zwTmq@S$Ti4w~ypApIX
z-+N7al2~@V@=MeNF5VF_$y$_;ya!`m<MqIK1W=?gNBv11e8SG1=zs^zAD^~TKCWN0
zdbvzeJaVqMi;_~UNIMTv`DHptx`<XDwU@+Ln0c<iK3cFi;Mc7mOjmcCt!}C<D%0z6
z8<N2lxVB^NXr1sPkT3GjBd9ErBJ12(V18fQkJGa({yGE<K`9Mt0B$?_3nRVeaO}~S
z*3C?yB41&#KaamSkh;axX_Z`40KgjCxb`?6g7rX6EU>|2T9}shLw2Bw--@qunV?CJ
zQzVSmqf?OE>NH9A?SD)QJIoQLZAiL7P@ri55I^6olZtw&97oeep?ta%wQBeH-#)oT
zondaBWKph0J{bzOC;{~T(e=r@#?p9UKn%ng0oj1#;6Kh6@new@<1r*fe2IQzvXVVX
ztImwFJg6BO_hP_rq?17U5G!tWz@&1=6sBk%ON6OSZKd^sypKWVtdWUUSYy;uNe$Wb
zYOjXhJ@GX7lezHUMX~fcdtbwo@yei6JZHo6_=_6H_d_oH*8ZE1d@G^p8>rV4bqb@B
zKpNPex(CN^hW?o_^c19eN|3wmFaAdUe+;~%#9(SQGXj=a8q;^c8<WNV0KA+`(X*4F
z#>iv^lo3}zpQU`yt`MD6+M`sDSA|DPjlnnfkD=r6#r|VVawDZz8-3aoFEo9go;OL<
zM<mFv9Bm|Oz<JGr!%;qpO?uD+e9nsyF0-tK=1@bau)bksy>`E@0|$6n2HLh(8fYE(
zvCjAO7>Zg#T}WG{Yc|^fXXZnFa<QjQlc<(PM3T!lhFGZFiuOAW-<}AO`dXNe=`k9@
z_5+Ul6JL%6)<H2{Dkg#;!9x+Pj`g>G+i$gRnBqPptfdOcAR%h*$>VeK$30Y%LmRS2
zG^kZNN8JX6j{g82_`3ClD;e>@{+xh?1X(;*=W+DFd1HwxEo{*sZBKhK?L+B_EN4j6
z<jW(GultCyH~5qIWSyMEigwez-#eYoIzr|*>KGRDX(VvFSp1Ld;5?TIWR9Ci06N$k
z{6}je8Dpr%yDah`Eq#bLe*1p!5<?`@7bwprm0c({6aXJRzPToeq9BLznie*{h6Qy0
z05Rv5Kv?cTW2=4c&fJ{i6HcBp+>F5T<C~#f$>jRtG8vrp0T`<u6;7Mn*T`ia%w7~|
z%^{+|07xTN!n<+xzzT+A8b%2Upw(`qEw{^``WZ%vr;xK0GP?pqR0fa@o8Wyre6jS!
zA3-$H$)Z6@Ly`-UD1ZjkH#hLxAq3_m6oFg=s2$6j=Z|spyr9cZ3p*F_QnU>qZCjFk
zsC{#tfA(jG#ZrYs7p>&8-{pJz`eQWfGyvQ{Bfk->aIcX-vOwI~JP)2s%AuI)oB30*
zp}@1pG<L`lyf#A0-`oa+#n(Td*BRPP3tC5plq_D_j{gAt@i}HG)QF6VZBPwLp?9hm
zzZL+$Ow1!P5ug*XvPRrr>45!AsC+ab#-F`ntKsqY#gWX0A>!%Mnp6ce0N=N+_$0ot
zA$b>8g;GGS1p)LKLRzEn)CnVP1wcES@9TG19n*C2FpxaJlxtX&8<^c}Yp^%Jz6WRO
zU&N3La$K?45CO0U#Ahn1uZWJ`KC^1Vl|>RrH|_Z2N2GL;H}esatS%ZLviGA~b6&gP
zO{0QyJc}S%0R>bF6i5^W^SQ@@UkJ%58i8L71F&Lt1pGE5+zbd%n99917GqQgVe#y7
z+o<WsNFsinns*~am-kcBxIZ6!1nMBtu(%<$CZZL?Fc(|;RdMNAA`G%RuBiwD!y4Fo
zcFM;b3?yAt%AlDp>(mchBz-bzENj!9OzPTz48C72Q3koavWirQKq#aIHaMf}zt04*
z#jFUYNvbvB3eh!Ve?#9YdS?hCGBjpV9IpsL7A)Vt?y_+qi(AlLNKmoZZAOLn;|N~`
z6{P9fNc5or*;r9wd>-STIm#?xr}HlMgUaV(%f9<w=Wu=Z^vv)^s6)yaDcn^9^2;)+
z8KPwbs+;pz8}{|*3QnEG-Bey66tpOczfL|l@h6QWx|pj`WxcP|Zgv%ZwrF?AvXycX
zkN|l-yMDQ#8CrQ|Pcd}dfveMhVSHpnr3NBcQxjWOz<mA#o%g}j82ncX90ICTu-ubZ
zu;6Y_(<#(QyG$*la>cc7F3l2qp7_zS1^#EKJ|?0-(tO&8BpdHXe||Q~AtJPBk0Bae
zK~|z~wSIq3o&_?KrZPcct6)KDzANH+%8(=y&I1H3<uAi}?ti;*ei=qj0R)5#)BPZX
z?PTw_zhmizOu9>^AOvxj1(}DM$nJdxKDS<l<4HDV;F0FN$@Q(5JExdANV>Vthc=sa
z8jMx2BzK|P(<EXj(lC&ORw=kQM*f%rQz}McjgN<5u>!RbfA0~KN}<(qa8#`Y0=~cN
z2_ej3o=pG&>$UG)hbQZe6kp6prAZ3JFPnuv_4C35PH97tpf!R81@#|F`ei!#VKci&
z6G9m3D<hU+X2$d{YW(tY1$PmUQBv(|?veYfo5V=AS{oB*kN2^{o5b;1wo_p5TY<^_
zoaAVlU}ZNFu)5yB=D7Vbr@&sDLqrUq>SIJOtMZNOd%imle3Vfvtcq<=)wS#aHFyI>
zH<`KLO&jB#@CyW;G#u=w)88~O-XKw?jR7SBl_hMFZoNC?U4wNSG-Buy7s{fmk8jfh
zof%S|Jx5QLzqf<=etAZbd_czB1p!9@5TJ4N#FPS{rj#Fch&sD&aEN47n7zhRV|!lU
zRtF=bXssAh;fP?$H(Km|zrH8s)CmBn+hJFaFNS(@UBb#-+IV$Bg;Dq4Z*1)^;g-}E
zHf@J;KgamU7LlRSg^zY5PzSL0{{Vbv1n{HQvLRz)wm#KgJS`rcoDEhP?Nv{p-{Hu~
zB`b>+d;|IA6;%G1AJenkcB9`p;qZeb$8dHC-0xcvx6=5-KUVX>3@!H|O$ulOxhJr*
zxjf!1B!gO4OYAjoUHR?)@Q%?Wv5gTa5v?-<Xz$6rhhg-_@CaC*Ld7pkhJn-Ve*ke}
z@C32{05Gz6I)&&vk?ZlzU&<b;WrL-W773j~Jglk{kTo9N`M`%q5PqaF0h0HRRT86f
zy=}1P6yCB>qQ>X$-OwiM6`V)pM&y9UxdRNcYXr9PGh3ZCr{#cDN9I-=fKHRO8~*?w
z3=%3uVWVLov80kKeT{u_8UFzJhIS%BXMM%{=83wwB<crMAYT(!u)21;<os&`JY)rM
zXp^_5bZZ+SrYhro{(p}c{X}rZEP5mo>P2=cXaYr%$6|A}OVR+)$N{P@p5lo55<a;U
zp#)NBoeF6-SBuNR&`b80+A;LKA{UZo(-<R7`W^P)B=VpU0tq@axd3|h#9azCHlTJZ
zTYPXR#wVDCR#XdQ0tqY!>T*NwGX-kkwe8N<K3EZiY#Ce3hQhGMiNtdf-ck+y&}j3<
zP|V<k5rqb<zTl6?5GfJ)YRMPuGK(Q(Q6mtdODcB)>dkzI1GYDd<4-)ZsS3fEtYb>q
z+zK2m*4YMkbEGPeR2@K8b&n7K04-O(QBZ2q;Oqlf;0}K*X`udEMhta|1$V8D5PpX$
z5;){CUrdbb2CpjJZD((;AX-vb62iIf^ZI3?l|(K8V<S~CYSYd9Zt+iuu$e3cZz&_!
zpVK0yHK!Y`gSusWMmn9-`fSI6OMe0Bc`++KqFk`r@7s^26k;76NG#^Juf2bO$~s8d
zG)Jjinq>%Xta0)7#W4hrP;FPS+JO1x6gQ9MTXNo0#T&&{B+*?#Y}NO|0)UK33JUgN
z&Jjw?8FdOYZoUTtGON=lVgT)3y|6TrOS4;=0dIN(07WK{!HK36MeK2xW-qLbyK+VW
z{THcY?ZFku*#20dyrcpFBw$u{>6$a)2Q7OSJ-cn|&M1yWjhM$u+iGvq0!yP=VX2sM
zcn6!TX8!=$GKX7dBS<`Z*QWb?FchI{VA{4Enm_M4N<*b6>_Iio1(2B-zTomsQY9Li
z)#|J=?_VqgH5Qs6u@`rH9@y&%c%9b7Ysn;8JLgD>OkdSj8U>YF)9iNV0cK}1Sqo%&
zMFH>_5-RAUZO^t*6*RTp!*T`vbCJTR7C}237q%{~AOX0mrW;^9WNf4r73ONhMKThq
zK&|&U1F%L=+czWE3Yh>gDvvR~H^5@<$e~h#jXVwa!l9B~WRxJ^l+j=Dk^_qbweALX
z!B02H!mTTRNeR2FqBaNH>649KQV_DLlUCdheB&XI5bi)5fCkrsH4MNO+=Ey{$h1UY
zsUu_Q^~42%QCx6H?SWJWrej<ZGOZw1xa6i_Ll7$gNx29l`HlH|8~}i5qCJZ5`@9-i
zDaarluh%ORj-AAf8cGP+Sn=<-ae%SL%(?&?nvIjd^u&>e{6*gVuR6mepS%t<axwz+
z7&4Xf3&3p=G$v5=;O>XN!v{|;h8knkZp{trI7H1IDGW*bqqf+JHu8c9JcEGDJXcVw
zy>Wz_UE=^Q*YA^ZF4Qn?eKDO-$w=g=7jNY^Ti_Ksg*hg;-+RQ~GemASqnz$ZCHG^=
z&TlmxM6nnJ+%W|Cg?#glk)-Js4*T<+8$3=$>Ai`pMY49Q2LQJ3x{>Xd((tR96;%Du
zt~VaJA{A+imNjI1;CT#<sf!=}(Yyv}BQYQmQ-W=Q``FRL9E=rRgEjWL+a}vpErK|#
zKpgqE+r9$;ECWPd<BTrHuwP6H0W3|Qe@qlMp>@s!B$^SILiww5Hy=EivOR`cR`AfE
z3PImcAFgL7jsd{Cm1+nG+ZBj<y&{Eg-w-k2oxT{rT9LJ001On~ki?3kg<DZRMgIU8
zwm9vD){h5C<F()wET}*vA8ce#7gH8GhV@+HH<W1%O>R9fX>Wh70diy|h}`YAI96EI
zt$n?Ic`|m>!3UgWW@=XR4%dJSsnP;~2XVFF05g5+7rl%w0061KQCwi~$pnk8{@4@=
z;1x1P7%;F2=M{#eB~(@X#wlRRpbk0TlY|nY_9M{uz+Lp+R`r~ujz_~AT86b04`aS^
zglD2yd<GH9%5PHH^#>4(8y@&XdfkAnx90(E8*_kFOL||vbaMD)Pz-(Xc*X;21LuGV
zz3%Vu#R^Zy2?n;R&I)U_A8Z1Vv)NEhdUhD6V?(}Dm3Kxwd<f2RRP1m*u_r>-7RVK2
zwlwY?lt!eGFPzSk2<<}H<KvYMSwkoQj(yG)@GFqUKx|dtVUD3S$l#sD`M1eL7~3?4
z$^3s@NoFt|x8!q$RS{KnF&C(Lc|Q~Ff<n{NNGK@d+dHICU}mxFXDB5@3oia)UTuZo
zMgm!lc|kc-ZQ=puDmE?YnW816WhYAecgHf7E~MBy5#I<B$si-JVW#_#GKzTcz~ZW`
zoDu41g6W}qoal6{-O3Zd?~zQep<hy~GXe#jh3$CIA<ztt!A{1uv6S#{sMR7ALf>>A
z$I~O!LSvkibsE=o9IwX${XB6Jz&fJXHrtP$W_@cR5t;{L2HDKM6k17O#0FaBzt(ch
zrBO!m{siF@kyuS{Y}IvKW|;bjiUsiXIpWU4D5Xb<E2(#I0~htIiHE}|#k7;T_a6)^
zq%9~3TeWNk<NRe3Hi*j;m0+T%Hpl0SCtex`i$Gp`Zg#GId}P6vc&K09t+_q&qUkIx
z2%%IDmwz$8Ura-yUZiSLwPf$P9=V+r!|sGox;?!z=!08KeB_z{@yDhFiIO;q@1^|@
zC%$s^57Q{VUvM(LQ<)Wml8n?(HbyR$R30+Z1v?$i{<sli<EFB85O?e=*Dhj6Towv-
zE~*W{-(!K}fqG<-SchY>4eM>O;D{=MKw`&|F19>>oP(8@!Hr+A?X|Y!@XE3>T*c{_
z0Dv#v{@NbfbC8}Ul2%<!cdJt!&M^%us)-d!DD&RSzv6x#xK?4}bfwTep=)FB@0;W4
z(pfxInP0<FX|^5v_wDt}JyartDFh9fd;b0#WqKuKLZOvIR;O;m+v&~(j6<mE+z?!|
zpD@{d{{TEkLmRmvZA~b<tn?aa*<_TdEoBf{P?xp*voDCO$QCtK+RbiA_rU1-kYu@k
zsM}uM{{T$9YR6Q4K?tl1jkiCoUMocosDg5eHMeFr`Be{%`rwnN9bAs<F(#{xw%`xl
z3=V^)A-u#WZIe*HopFX}WR4*uk%x8jF$DQ|*#7(a;fzHoK_edx0M<a-yM1=}oX^#D
za!7Q$=te$OQONcBlavSQWu22yD;jJ7^}`x8vyPqSMNNx2JbL{%$}2F1(lP+rwzKYk
zeXk(#phbNp%eUS;e(xZ!PNVs#qMg|~da<_cy=I=Hs80%bVsji4H38fxJ^uj4Wj!3e
zB8FkfG^g&+9G=|aSU`-(G}Te9$oLQ6Yzs>qadfdu=8{GrXd}0)dTra&F^Lso(vb$X
z2T|l#U_CPPERys@E1w)15va2Ecki&{Zuvfz6ELJrz@}@kJ6S!30_a&tReugY?j+a7
z{{Y5Qsp;T{`Y<~@R7jADv0aD8>*Ij*t3X+6yH(&<@AAiWPX|B)Q2=TN{#W$C$}~v9
zyea`o)$RWB#bQXqYXs=>t$p6v-D=2%1EEcd3KR`<k{vU`buyg{x{Gk2dwSq(@wzyA
z4+#0Xfgo`p;Rf~y?ri=8-!rbZSDF@9F?q%Aet5k!9XC<c2)dVOkOQiPvGyPDAP~l`
zg7@w=2D=Oj^$^P|mT5`;;z`)Qr@uJtf0cz$#O(7?Lwt6+`sI_TM(N{)!X#m@QL=s~
z;n-r%uPiAlTBAD_ZT8z>ena!XpIaD#fTcztHj%jl_r6%H3#_PWa5gkft-oFV8IfU<
zX4ZV#b~XCt;E@DEBxMh(yk_Bd?SQ=;5XmH-B*X}ixZ3v|C?8Go!>Z|1p=io9olMq4
zZDqR)>^)C@Hs3RJ@c<ch676MKhi_WreCLt82qj<%9#Bst-xcY<=YYDAdR;RRUO`^#
zzo%@|{J}_tgW<%*W7~TmS@`kr$i2sL&arC*$limUuh#L~Us2K^5UMC7mcHM!_?&~f
zjWWq2Dg&yOMym_AKK}sqk37&v6jH-6W^XKjf;Dkqo=BiSX7XRn82Um2f(Zz$2IHPT
zAFeaTk;xP-3P#imUGHM;iT18GtO3=<)O2z5?7>7+j}R#!>ZT&d^sssK_+r8$>R#q0
zBSJM0E`?RsfBVbyQA5<2#LcHs({e3<2LKDRx5MR$(+T>B-YDc$*3?Z>n)Ub%{--FX
zMb)aTmZWKL>dm<)u&zD-0Q;Pj`Z|uWR-_7KB)B)Lo&NwT_<Q0Qmswd|o&e!#d1LB7
zFP<q$AaqF)wFdJbJML?Ig8d*CvY3>X2AlpPllV~i;Qo}zL3K@Pe(ICK+u>*E1{o!1
z>13HgDT&8Ui>ip{ayyg0{{GpVbq&%-p<oQEKrDDQy?pQ=$8#dF0i@XptFuG&q4LBO
zdelJd2n*-B-?{zz40vRePyED6JZOr#s*3@E6l>{(Jdr4wlm?jCAa1+*`t4r}z^_}-
zIQv2R7~x=JeFjNXs~zj^o;l-@UmQ-FG2_G2Yeg~<<|cr%>*-&a%k>>xP`ej0X)&`d
z_o>LLByc&*##s7?ED^O;sjc=E^uBN>IR2?v0<vqU+f8xX;l4Vev${(rph2T&%0b(Y
zf&4Rs#wmkoR|r8w8-m~CkB)G87DmvarDZlpCe3Z{#s+?nH1iN-(yXOlzn2(C;B^QY
z!#R2gPSibe@D!N@72!p!7my9Wy6w+@&p33?)<@LLv4bEw!PEgF&44~t_4UA~Sji*+
zNoqkB;V)5OSlRXV_~d*@+2fC=rF9xo)6U?N^0R-2NF<#sQAF&_&cw7-b~mQJJmvJr
zV3(<nOiqPu!*(}7SE(Jnur1X_@p#ba($0g&GK*m1?0b2E<9-3j%hJsnFj`b%L1!Q_
zbx~mV?g{?@J7;x06#D4BIHqkT^tBFueX<I&J3LCv&J$DWI}cO&4_+{-Dl+RD3G$aJ
zMSwr-eRA<EYVk(b;g$z-RY=>v*WrH0EepnaPb0{V6h|tsyS8F}hKOG0e1y@$Q%fZ5
zqN9ngU~C%tYU93C2**w1%`2f*^D+)W{{YAF#_(pD5d@|*CsWHPBXLVW`+5&-0T5Y{
z!HEE3w@k*j1L3|TXQ`SNiaR7QVdmLJ<LSQV3V6C@ku)#$83Vi7(_jI|zdLu^8Kdzh
zmR_8+eK~am)##&jSHJJM!P4~FSHS9IP$sPo8*8Kb>HNL~cwGdI8n}I0RF+z%<cjt;
zzp%(B)+rIKB{3T0+K45H`E6L;LFwnv$npr(C?Ja@o=EwQJ{Z$TlB+1RNfby+o3c2w
z`{d?eS(TWDCD68!ww`NmU9Sk@BS-3JIf!{vP|``&wU2<~+uJk=V|7JnV@-NvW=pOP
z``vCYZrFNPkNSFvjz%I>C(WsVHTaLmw)sw{?BOwrZlA0&N4qsC4G>jZV!t}~qk$ft
zIHd97Rb5Pll(On1?Xcpx=OG7Dv4ki;s;oTSuWH-memLeg=sX5uJXZ?I9-9uk@_Y8%
z{;~efZBxV+IJ`%(si+lU!*A$E(0kxzjmTDvEQU%TdAJv2Vf(zlPg1MK(Ek8mMXNcx
zy8H&;D>=o-PU`Ec$8zAH<Tr2MzG&(?nEFnm`Go0~G+^Em88v8Hq4V1QSQ!>JRuiKJ
z^J&)mg5QN*6P*<}q91Ewy0nu+pWf#xiaN!PG>oU0Q1j5Mu1~%E$;2@iC4`5>jhj_9
z*cC*4Nx<%>tdU?|om4FVj26X_X2|Y*)$q=OSt04VgQ1-y3m&t$UU&2yZHVfsur+Si
zszONwov8YE`r+`(kr{F<ZVJ_n&HRS{027pS5zW&?9oA0(xdg3%Tv4m<vHWpfG>EFn
z<t#<ns|+k3hFU4QsTm<cUA0=PixxZY{{Y$NCnTC?ON2=}`A4OVg<m{;FdaIr4!uJd
z(b7RCl7Njy&DB+G1#!MSaZU%13^A2rltS27Ccxidb~}1sY&}e{$JDBwp&Cf?S=<0g
z-;rD#jPlCkz*q9CNJ8`RC*}I&S0`07$qet)B!O)JqhEH1A2VLJ&NR|W>#jyw1X?Y{
z5;oEl9{XY-K`@RYW?0w|;85gq`C~kdB+Sl-#H}j6!9WK{6es~_{pCY+qCSnhZAmJt
zuBhEk_72C`5rWsm*0M2>N8ynmvYSz_VZC?GnPeLJWLgSKNM4BrLH__G{Qa{%GR9n%
zR%$BE%WuE=`CwXM7%e0cvqal!aYV5M@qLZ&?mciwI*G`6&-Efupqkl6-<YhMktB$b
zu9S&;?oWOF$@*Rs)IV1ui3&#>6<Jva-t!Y@ea`;?fWV}%&m@uuDC^>#UKkYCccMFU
zSx91zRNb_ux>Y9J5<RydY4qnO)kmf^k`EOlc4G`}MEH7$A3Gf2Zj-`xf=O3gNJ-Jj
zZp(e>f%xDgqBUk6GZ}`3+$kPnH{00Q!xW7lP8vsVGkH(|K^0n#_h8W%j=f7l)0pH4
z(o(X5dAkSd0N>Y-PU-=Tq(@c}g(Y^aM37G&-%JZ6;zvsYF;VL(poLYfwCoAs`=6d?
z(8RK|ilz{(s4m=ppl>H6iqbJU;s#AZHT%CWeg*>bPGcw>I@+iMa5?=>0r5nEQGCy&
zAo7KxMQ(l_@F_8Y8xj!);2I<vvH0_v#F4YI1VS}xwgeCjfTMe&D}H$2Bi49HFcC+f
z1XZ%yix51`e&+V=u<dvf@uqbxtgfoqdXKsWQOm}^%f%;&_lqj7ttN%h_-%db3I0^{
z>d~z+C1_c0c|DEU8+u?zNVJIEbutiG6MNXN^YXxCnkZvP)VS&OJ2fZ_cA-alvGJ@@
z?F=B%C2Ru6w&0Im=Q>c(E5}Wt^xS-syA?OU=kfQ-sVz?H8DOqMF~1O2kOKBMsM+<u
zh)BTg3?%qhAtz=4kOl5<ZvL1=MmbtXqGLpMQrcO8)36=SoAvFId4$pFVHyRy@`~K*
z09U~Cfu$0{0<pCqDD|>W;A;Yn(n318;DMZ$38=_IfW%qvRlQmG?S?tp7gtXVXmO=n
zY5;*?k-;1H2NEeuyH16WqHJiJAPxPuz#Z76F2*I;63utp@CW6-1tX77NbK$ARtV9S
z^Rk`x6~G|<M&0oYh_U|wa@~@pNz{EiRerb?bVaO<nY9Kdaa<3M`0_d`22zCpQSPR<
z0C%zh`fq?FRT8LKVUf{Rf-No9<9g%QzrQ(M4I+i{k#yQUSSN5pHrv@dciR#UndJUy
z?t~)Q*L6+Baq4Ifjs<9*A}U6aok~$2UtM1OSI+?^>1F8%QWwQ$D#5uG@%`2-7>SYe
znKhs3g1`}5l0f=pCh+4&U>N9a3+DUW?nlDDnK-0Hv*xy6?LK8S&H7*AwgU!PWF0_2
z!_4j%Py+jHz`eHh=Mkk>Ms%|3-``cFPyl}a04%>x*Rn?R%B>-%wXI-o0RVBR0)29B
zV~oUNI-CtpW6E01e5>`q={k8}nDp`myVT6L#a|qI@pvNX;g_gZbEl>rX5VnP{_@ci
z)JP(U9L!G9Y1OQn6ad_wb0?kxM-n4<?0;OLnKYMEsf!ata!A~thxp1n2P75Hj5UQV
zcHQgeXW%))I$;sAtf~OLSGgj<_P?(9iVsSLMcIjDJ8%bK+#g?#0qP`WlHQ4o1OruW
z0RxXp{{VS6krjcAu?FtX<Bcy+B~hw0Pyhg^qJ1ylDGsRR5=L~bi}4f?PTrv4Cs0~N
zDhdIr*;E?39=!gT(Q1JzHf1v<Xa<9e9Q#<~)ME7=M7>0lNacJ<q%7iyDtRLsE|KTy
zq>&LdL^U&N0>K~v0pyGAzW&()bxa|44kDH4f<Y7sJc`@&#Ec1)>QJFUAP(m`Sf!S7
z()py2-Ig1Yc_+3NO;a&C^r$45&)wT^mDW&XQ#vCHAc8c8vtVv(u)_T-^wy0_UTeR-
zV#QZ~^Mzu0BRXvWBm}-ltG|&s&7skl?!^nx6sl|r{Qm$9g1$6O3PO@cq$ovDv~1ZV
zpZ?WfwN}}jO43NNNZNI{)ZiWc&#rU4ui`NUq-WH}K%=*(>}4J$SQ1$#1eDoB3ji9b
z?b~lmq1?iS84Qvjk*OPCWA(3617FKCI_usu#jyhJtncy|;#k7Oh&%~7c?$}v+P2$k
z?rz3%u}Iu8vP*1x*dONuqcS`$3nGA|DfJg*an9ov<kc9GMlwjm^43B1Kfc%&JyBnr
zxgvpGfc3wP3<d}Ony#iVz#rZ({b3IAt22QlY^%8>?8JIr{`fkAj?u>ss}u+RUG}ez
zS<*T5EE1t`r%<gThq>hb`{r46?ct9zTN>ZsJ~f3_Nn~IYK9D@7&ie}I71`28rvCum
z8ns=qvU&KNV;wJ>%*si0;=Va19ucp-tWuCUz_(V)Wez1$#3*G^TY<RzK6s<34HLyA
zCP@l`8?%4y?_`1A_sPi^)IA6UoD4LO)=N;_;9Yz&vA<BlS2tiCzyr%?<?*bU1tu&s
z$))s-JFm;z8a9n%mKTNEMhm5h3#Yl-x3N{Y`QB5gNTV?y6&-Yf6$cA{+(&)L`D6ll
z30(*Z#Dsu^@2h?9zDN}dR8$c|R{sF8gtAC9xzM8g%BG7}+kP1*EeI&liwBd)_WUxU
zok@sHL~=B!QEkGJzMd=Fi~=&#l!OP>L0If7>$lGarejFqXlekF#cnV3##byP5x9sj
z`-8t5d_Tqq77Xa0(ry4@w|npOyt=9)yT>8(F$=LR7zdJeqwvh6q-R!@HMJi0ImL{#
z8ZK2pCyT(SL*f|;cU?de-LL+RTc_$HjxM4pBXi=ARfE!@7es(JJLYdFkiN2`PQ-y{
zZZ^h})ikgKloT8LK{vO@^~j`i5M~HYo3zzeUieEav5j6*paVyC-}kmWF`WZbB7h0l
zSs2kWFN*BJBOvXj*|!FP?f7kD+bSfnmQ56)t5=|^zHyOZXsEeTNVYr<dw1k<@01g%
ziIl>0FbW9dwcY(YVn{($jx<KC><#bZg(#23U;`RFP@p|>(R9t#30%4{jSC+U!t4R#
zea^#S&Ua9=bW)SyKT6`%uH&^HclG+@5!HOG4G=uHd-{xkGSDOt3X^8@o<?#tN?z1&
zXPWo)$113Fp|DQsPdF~vuu3Cf7mL8}DO0Igw*LT?S@k)_LRA8=APTKDea-sf2&66N
z4dnv;uZ&>IB-K=-+UwsaF~TK<$Y2|9DF<=f-yWD*VqTItR7v8OD@{d60B`jt5Garz
zI3PFS>M`{zP+-&n7EOz-zY;Pb6depS{oU@3k8j_mbUHl5s~4k03^7FPtl?-4wNau^
z0{eIRWm-vOMUYKpBhW!$2pmxM-zuWXraeS#b{^*hih)9)1&7`vzr!f~Lp*4PM=KqL
zQg2BA0JD)~Dt0$`1>BIDsD)jCJPYFu*<e9bYanuchFloLeh`i~W}~cwWB&jVy;sWi
z`o)SRc}w3Q8s7*KuqR{+yKFO=+^A4|q;9px?z5DdD8khm$pBvd`Na@2YBU>>{{S2U
zdZ&;O`gc6{tW%_m6i;$E7{q9r<c(WM9$M3TY=2w^Ru-}80c`3EMBV~0RdOqDjpce`
zqEq6qja(6_l$>1*6{N7W*z$fE(aP(pQ6SX3Ugv(}0g0MMShcg8Brm!Bj0i|#3acIY
zJZ+2OGLlL2UdJsv#$%7dB@3tZ2V%gVrr#d_01OGRF$7}4gAck0GzVkp@XlgdHzDZ>
z1gN?v{bHR78fgq(t%2kBRh$)AP%JjwA6zPvJhCEcP&XUt1GQk;V<C_OWEQh`>4@uW
zbnXQXdCDCN5DFX3wXwZEryz)CM$)HoM#pTYS0S2E-V#J~fK@J!zW2@qD;}*is12Ix
z{uqVzZ@6u^<0>p7JvzlCu@k<nCdQ%9Io)@M{L4t4Gj#De)RAk|q;?j0$#|uJ6iElT
zz-+kOAIAc*N+6iFgm5f*g^l*a3>e6&qKLi69}EXlJv#Y;ubw)cDJPgK8V2uH1e6wF
zqjo3078+y<QkZOa!={06y563n0HO-M#0vzDPo@JZBON7o2eHnQF{!|718@S><k=iG
zf$z>a((${rpVS0xN6bDr5(J9|x6LrlVgtopY6p>ZR+H<I17;&|qnho6D>4_L6-Rsn
z;)k5cAS4rJxyKG6Qb!IC0}<Smp|=|^A3O~yW<V~K055z3(rSz-C(!%ge=y)}xz1`N
z0J=@@>5nqUrhx`Q$p*uGJv(4cf2g4V8ixM>9BCyolc*>@!mANieSzD*rZFBPc~tst
za63StK_rv7z*kEU2bgR~J7;me{@8%gz<Ahd^VtAU!e${IIMue@@CH!88zQ;%z<@a*
zlC|Ej9LT~HK)!Iqh6j92)e0~m-J8NlBvpg!-wQ~hJsT2FJ@6C~1#&M3B({<lgPcvS
zzzRIp9ZcW~8*^Ro6_}7eT;m%BR%O`tu5p-J>~{EXcpZ+NEY=4b@qh^+ZU_gAWMCD5
zG)UiTzii;gNU?o}*nxK2p7<Q98G?<0<oaVvW%Q{mtFS)Upf|So$XqJ`N7DgWfi@J?
z<H<l+2JeDyvSiSq&Qb&nPP0P0oCMNE4gt<BMEQQ0=8=dUw)MbEX+<Ck;DOJ_0aty1
zJK+zZfg4fgv7On9`4tL^wb-2NDtAEJaC`gUBQayPk!N}vVBB$q(4f?KZ+zoHbc0~-
zO<@B_E-k2f;VJ<%!`po3rBFBc=L%I9z2QhM_uJnZ@8EgPkwPCUYhG@!QPZmcx@kKb
z9=HP%03Y{^U6fa@B@y2M)m`7$IH@DHE$!-Xkw6>Y2q4>wy7cwIB^M<@uS1-+t?is`
zhO0OqUa_oHRY9*PB=_~pN(8Q<MwC(gpbI_nFpWU70k-%WYM3Li0`%9Xz7<&%QZo%G
zNuleRWQaVq<~{i1HN0yx6BuHuHY|5Pz41&<5G^RSaj5%t-~IYvRw$$C6h_oqLFN_r
zckOwcsGX_=HVx`My)%+%+ovVl`hahI{01a5zfMU5NIL_~ZGh<-!_<Q3$~pA>GPA<0
z%0d3ZKs+txl!grvmZ>B^*bd9_%ziJ3L%Q0A`=k54?*cC|Dg_d3ayxqEV^gRL-0xS$
zKUnoRVzi-0kZqmQ!sbIGn$#>Q$fa`X<qfH;vU?v)Mgd$pwJ-icul(aR%I;ZN?2x<J
zKRo4$bPzyht?z+=vp%3*4S)vc;gv~(Dzyq<yIs9;x_+5fBdvojpeTBG&S-VYv8UW!
z)K`2Vo>{v26&_MTEh?T7K->PYW{1FVRENJSKOmoMJzP*mk_Tq->}<3G`rocaJkqLw
zSwY+1Z}WlCL#5q_kgmeiao(>Ew^eBo#a7?~O>LbwPzz{f0Y}|alZgvQL;wldxC7VY
z+XA7$kTZFP#qWZDT!1DQK!<b4AC^4ImUOvoARR<kZZgcSs*aJU2Z|ey-DMfs-Zv$b
ztc1{7-zn3_Cs0c@C?|bio<H)>9E&8#0+LRiPx`!WrO1#L6t(41x0lcluj7ETJTN;!
z8Pufg)wvhXwc`m}QSh`Y01l(u=bh9*0_%;Eq}@Q|4}U?4B=JVkD#or*o3XQ>e)s}N
zW&rp_U6>78w>D3|e1v74#7yM4v#9Vgy-S%CGT2}NJNgdz%hD_Kf<<s;V{J>asPs7o
zm?4Tzhp3iW2DBki1J2^l(=t%%BMN{=qkGM8MyVdAERmrWTYi17G4#mlH9D6TScdO~
z2u7bIvH)1$7eh7l1~z%tW&$=FIRLTmu=v(1nYzBD^(_czBY-FX2cYZ+<&hmJi>0Cq
zNveS-wcvAwR1G7YL1-fOAZ#(d&+8@WBXlUbBx`L#^==3a>%VMR(IQ<A%1Aa?aJ=0P
z=ZZKYn4Yvb8e<>(YEHoa0GtbTODXDDOD4TUGbkG=-*1rHwn9${A%74%F(jtj93kdt
zi^i%ITkkiiKeL(jEQXjDAl{;Q_R2JPT}FWKt3gme93ATYD<>*wJ}s96fHKJ=JaR@~
zXYzz6W*6V#&&w6j;wVd-W3s5&HbC&sdTCYFHQw(VA1NM(zwBY_`mp^>l9+%pF=qiZ
zi#*UA4DT6qE5x8Ok-($36nVYw{l-VAK_^zRn?P6oB-tPA)(0$~%d@bP{{V3aCaXw0
zQ2Bm&Nu!!5Rz94tiHJH+GBEb^-)w~Q0LQ{pp+=T!vd8>w^ulF$RzC{VlX|=S1_hi=
z(@!9uVwV#jKYEVi;mzbDm7<m}5ZbY}0B{GkQQV=5L$gpRexAQu#62-+)fC$cr8`jM
zllTFFtEe%3q1HPrj-51WbTpf=UC2NOC%4Z#r84#6K8&kA>WP1KE4lbt`ka=ehDc<H
zvrr1!2L#>xPCE57#7d(tPa1*({{X}uetdi|G07UU$v22VQ(t#`{{X8wbdDw}Wb&aD
zUy^;7-m5fpvIy3B9TcMtDrFZ}wxACtxXjX*S-NtKsMeGm3;zJS-vS~tBRVbVRj>x+
zP~Y{(Gqdz!BnQEXi%~lZ@A2CxAyn}InN?22i>4#ny<{9R%@Qgf3-3_ohjaA6=s=lR
zhtPzdDc|Q=PKp6LEL@~&&g7a4^F8}y86;`TtLSGor@6eeek8N_2z8dBplzs(3M)Li
zfs#8=!5r`_eTTkJq(<rrK_daaplfknnOzbNnY!~DcqPh`2bWi;;g8Wu&(Xh$rA(43
zQb4w0+u#8|T!K?{g}PzXNL52U^SRpi!TiF<&8UrRA?{6c^4|d}%dTBiHc&Xdtdslg
zl+h1aJZS1wcugM;Ec^0(vWs;QK!;RpO`&MTee0?o+!OTMF_{GO8Js+;Ls@Ol6}RX+
zW^HBU2^x?tg7SSb>}HEZz^c$R7hpSW`g}4DldKf9x)s=KVa<QUdu^2r-A7DP5XwVp
zW$xVVV}Ldl@0q4VX^4!{n$%lrZcSxht?CjTDnhoM>-&ZG_7uB+ybf-$UQJ~gB~~j)
zG^%g4eD}>O;q>A~CFPxy`fR)@CzE{blhgdN!z3jfY1Yi&+Q(sj`6$uEXH1&(k^mcO
zCvT-+*8-*C>myE<7<@9M$m~w;{{H}td`@L!GfL)xRNq0|SmgWh^Q`F$^va3|)L-ud
z#{K?zYMB$v<HIJrKtAvl_;Euh9WV0`>X6uSq?J?7#`pLi#OHLKM^ei_NP!qOmenHL
zAqMs*kKd`wx+Gn1hvGWNC}Il`)Cn}EyOKG@jv%l|_7C+mn`&kq$@b#?+uI<QSJJOe
ziv-1{m6G(Kv8dj}`vGSV&nnEYuw{<4GLH4Vd@l!qCxTsAA3X!yE%RQO#GvbnNb;DO
z#*xc>KNEnRLPsoyUYxLj+VrriA1}yewJrS87_>7>81VIM1AW`yw#52=Sw4y2icr$9
z05MlnwXIuk+hJQ|x<eOH;jE?1VSp!+tA5{?zENk6PqS_bWn^N%cyhq+L)eP<#rrut
zNS<bI48%m5la=)RYw^WC3k8`$V25{pUA-&y_+zosjr_3i*H)`>ySCdN)nskkd&nm$
z$uosAIaMJEE3%LCxj8AOmJbRBQQ_*;7!X*E=zD$R@V{)cOEi;6-9+V?wL4bDnYlmb
z+VXvJD!7RmTYX{f$OH|K@4f|yc;yY#$jGdqGGCR5Ab@`ZzotpjSejYpwlW=LlXeLp
z?f(GU%k>jQCrYs=iE2DneIv}qho#V}1KgaHC#i;Fg<44f0EXOcz&|?tFsiyiJ1U8z
zQh>2n8bh1lS8hLbkn2)NBoXx+5W7Yiz+h{)z~rSQO6e)_w2-1f#=^GtuhSXeW`aUU
zGAU$r2FVA%!()FOp{Fu+PK3Z1Dgh^(?+|w<(~<uGc@-fe@j+okgQtB%(z8OwU`S=L
z8-%?iStiDtA6{_;FqzDtGDqUx=Ez<^_|^psFm(+HQn0&H6ds{|_qCe(98RU4UXC~<
z4&EEHpjFz4TVi?OU&A!@x{DsAmNnNk=o~8&e4$5R2>5I=PY+WxLIih~KwHSGWD*xu
zSANIgkVQ)d4+Ti6_X8!`?_~Wk9$g?;ok$v}@K3+X@xcm@5-{=wLTIoX4Y>Es5cJD4
zst{?lSsat1?E4L{iTKbSqf!PDMmBn)2n3T};>H*2HNuP}Dj0x5`cd5a{o|3+f0oiC
zvE^oavI!dxrT#vc$EW^TS$1?_%BHCE&*y>9{WwmEJVIZ|e|zJP4~CsNlf*tZ-Hih9
zJl*|ntK-_SVGQ7xqaXnIg#FQ6d~&hAnL^Arg<7-@NV9kGKaK>1(H^i!5GsY!Prl%D
z^Ujh_8IU}Ka3g1NWkpr}KTI&i8%!d3HI10E_a=$w(|iD{M4@ZMH9$3%JJCLsu&<s4
zWtF@s9f6PfiryNiutEJVjBb)8D;bU!b0}qx&G(ytK2{H=Mt0R2xppd0sbYV-YXEi|
zkH;USjIctQK|&YIcH@$JZhssJ^$K8-3sImXTl=iXpK1gV^2jT*Nu(>5dJM;MM;m-|
zcUIj$P?6apOJY=?EeZgQzCXT1&kPSw8ubiC2D3^)Abe{mmsN9gX!4CNX40ccAKEP6
z9-jEk)qgE2=qe|JPKR3*%f0=5eR2~_8QGM#HY1}*$C?M&SJNvv>F1hhBJmX-O|_6%
zA+x=Fx8r;Va~!=o$s&iHi^xKo3Oy)yy;~l}@JA4Z3akGBSfd$FJg&+QeUHoIlj%^*
zJg}Y}h%H`FKRkKiSkai>1<*<lAZ;Yo`u;@wWDp8vW)Y1je8g1%eLoD?lSaKO%{$8S
zi%5#H)|L&ZSFP9XvmSvHf~@VSPlj%+alhk~lU#Aat01LTJN6}x{{V(iI?%;@Ru?Ri
zIXZy5{{VQxIAiGvF00fi2(`YjO9rvqYWjQOgQJtHo2bzN289jIgJ4<u{y4NhmYL>8
zwRNTh5KWzq{2w>d0*U1kL|a$@@-`dk=eKS0Fm&kJ4~S{?0(95|jjxlv)%s&a)ySSA
zYe>Yg1Z4}krUs9_s6Y3e7fjtqa{*J~#<E`lR52e@YJb_lnOTI)sCH6T?(d#I9IU-G
zY$unZm4rwOT!xO4e52jHYu_U1Ck#=Kgr08<9sz2vd}(KRhz`b;bd~4Lz1{Qa@W7;+
zBk;<`2nSBGx_m|*{uNt$`{YWQo<Pisq>X^Hzy025o@eT0)jI@^Y5{=KgJ3R)z}`uj
z5l2iEhglesH#-49d`Lfr5PF$pVp;lx)%WiE_xO`nj`K=OM+&Zjb@*b6p$tIPe#WT!
zjF(DZsAnU?A}e)A9M`bt-!7dx^-@a2z=TJs!pH`o6dkXVe1YEzSmAhjXyq~LGN5G|
zg&)2yxiv@ja!F*gdPI)JMxnU#8`$>r`ubukh-GrYk=FE}9B;w)=WG(Qq)Lk_ko&N$
zmam_yeQ-4N3(+@FPgx9}7*_x*fow%4<aQ>{u*SCQ9a&U((JJ|(P^bc^qqlklow>4d
zP|ZBi2m`-_hQfov?04I8e+=oO{$0=xp?t_#lxkK4RbQ^;5$*4Q&EY{q#u5irEFy8e
zf_Lq)s~I=&;blP2AynP$)e*&e5=W*}t?5XS<mq)h2uJk*0A8J2emJqgCsP-X;WNVk
zQp69rs^}B-{BRHnAcjcfh>c(dAZ=IA#>OJFa5&MatP!~4!3XooH&H1*6S*zncxqX#
zLiVfsqPNMzq^MF~NoucsxcOjo%&QIRapq+NT`&M~`|pj^$|M0J^O9_~k>=)&cI4oS
z3A(nAriiqK#m0-dH@$ppW{6irZ7aNL``xhA`~p5cZ>8W$M*eYh!_$;lV*mhdg_}3?
zzn`GV$07>^H(&tZAN#@#v5}&1y1^1M?X{7oZpZb`ns}Ngjy+x@wU!D6ucykt90TB?
z0pse)Vm!!2TWlzL)&3ZhDP)bDglYsR6cKe0emn1v5rjpqWpglbz~FCt-#mUeu9lA0
z+DQW0Xp`J`;L!SUfDyE$iD5uu-haA#P#(MO^UAvP^2(218nHK`!rklvB<uwn_sLLI
zcv-9)YbT5+sF@;21dMuPtNLrOHg`LXiPFCyFgZXv7Drc&SB2zV?Y>f2K#nFV%2^F6
zF3Y(TP3}!M*C(PV<3|o$z3)PoZuj5xIb|pLb<o}%kgkxf+mcUiz*GJQ0b-ZN>Xu1-
zr2zn;((HF2k~`TSmQ07g3&KGpV4);)M3eLX02P!k36&z8p^OUFqNtE7w)95-06d)J
zDJekeHiu>0_is&)<$$23mkM>*wgZz!fxn&>lR*pN*1FV4^DTOQc?BM1wbe$5?UoZV
zh3XKJQT(=Os1@}3;AkwpT%?^y6+*_5r+t9n)seYAx0CCo{%5P6SxX5W%Q(}gzdA=9
z_Q*8PBfQQ_m*&p@0Kf5-eyB~;s+f@(M=P;30Nnh)6O<z=hIu^IdQd%Ee12FwQb_Rw
zG<G#2k}rNf7nYtU=|~_-tE`CS(np9cj`*pepir_ZySY-$*c$o%_Q0IVf*o4C!0GVl
zjWt~TNckM*ji!XkSrh^lM#JZ~rr7FYkfdw~N*YG3_~VY}^T|mWEMf&%UWH&N9r?&B
z(?rZ+JwRazYu2D@BUKu@1oC${fx?Fh!Iw_T=YQXN!WF6_QllSqu)ay>=y8uuz5`B<
z9b6H<#cIC3m=%@MDFBJVPz#w6NE(O+x$VYFrjkixc+`T$NoCSWlD{ehpZ@11;>g`T
zgDV)Ld+@ayv&&bhtl<!N9#v`~z%kzSzW)FL_*lTC>fS7!L%)hk4MvBUo4z>U<XI}q
z0-d+J$}0knp-U(PsR_R$WBc!uj6Sdxf$VR$`pOzPWCWtfN*f9rWALunl7k$qrAW})
zNbWN4FHfYQjxa-tbW`VAqu<yc{^<NL^z*1PGe!(ygA`T)xHJcP{{R?7S!99QH%|@J
z>MB44SLKD{9u!-RPQ-*3cH8~^FnC?0V)~O%t2%#U8bm>&L@YrH2K7t;zsB$xWQ<KF
zvm=YPA&4!`pbdA<4-Ebe!XgPQ>DW-My>>nKzSyQ#oeH%mCj7rnKA7LkH;l^~C{tDf
z`9)Ql`CuwUrZ;0`e{aJ706bSqU>aSG0(mL`8&(IAv@B{tL?>`4pP!}_{;!pE3f}(!
z&P8x{lr*L`DgahsO>wpT4l9HuMbh)lk$dGM)QGaE42Z*8o)4vut^o_hWn~q^FlyM1
z_U8enU|EtN%(hB~``UY7=Z_>)$00pP8Ydz}W&|tm$ghd~d*r2+9z}4WR<zm@ECE3L
zPdM_4rGg`|j0OnTz#EZ7?Uf45#BUM`v$EG0<-Tithl#n;p?y9$OEN92zG7={Px~3(
z5OPkS7;mS!^{fiWS-dom{{TmoqqhTp%N4+dYBn-E3bHul9ln^FVlK8xj1jD<+>dN}
zRtG_Lb@LPGJ8#;sp$e&m*vN|LKniZnp5F|ls(fa4Wg&%<N3S0P`DBEOTG(q+Hw5o~
zzg*WRQv^am1Zkny%i<t?7H)wcZU)y}jjIDZCNRW1GN}iR&$c&HsLSD`gvJ3>W;#h<
zhik=D3?x-F%igbQ-!r;~mAo+8IZ(#Udz>RgvVgR&A}Aq(jstsd_~N9jh;+LGMIZc!
zrYK!-`LAO^&mRmg4wR>AV4;BQZof~<3UYi|$(BRmu@+oi50*_)OsdST(SzpFcdu-5
z<d4jSgDr;KcdPds5uDOcbGQx&0=cvKU`dXWK^}E$Eq{mm&3!*k3_@wA@O6eOwdyOq
ze9e7xAYB062JR21`Nuj@7flww-Qf)6v}KHrU8oKJ0Jr|~XsQ`WET~Nrni#SXr%4*f
z5$fP~Qg-KzoyO)gC;?rG<8$kQCkizMKMKx|OFFBvs&ix<pkZ<-8cEo&J5_P@uck@W
zl!8SPEPOC1L$8)O2~c&=+i++a?0?QO#;qGUASf57n<KFuzBq^;IE2GsPMh^Um{>55
zIT|&qt3Tb}0acVo_fD-xYuFFn;aHnXT_~W%ub)rPD0(T<C6SP>p{NEGYjtDSf6D}p
z(<tFlXaKxjf2@HOjGC+~F(mKbY<YS&>DCz@NZZ9v5GpVv3#vYxagr(v5;q&ss=~^^
z4VtQr_Pn90PLbF;fJpD(;xNu5c~(WWL$;E42fp5!FadqY(_-zb6|@xq0thDPbLoLe
z84HjDG3<SYbfPwOAdrTEEI&*DH-uh?I!%r-ql9>F$HHn*;1k-w+u!_PBdlaFS7u<;
zyHF$7{a|Rq0t<P8qA`qT!BeSgbMwaV&XqD2N?k)x=WE;IFcZV5gN-J^{_Xylsta$x
z12|O@Hm)<GG|ET~M)aOAFFfx&vPe;BzwrWq^sX{YBStz{mE;roVJ_;fR@GRLLZ8Fo
zlNP751F*ab%NxQ3Y@{=Q`}$VZ^2BD=NTM%(cFr;Gqfi&?+c_B7IzbgxfC@Z%Z0vUj
z3)Qe75`705M)N?37J>pvEq7-m!$K<`yTBuy4vjTyI<(NfFvp<3oD!fO4sp~_oj?k@
z;GE}<loCeb@C&nP&`4oow%lPx5i0-#NDYSKv0-@iDVRGT<SC=|`e!IIv0eSE(*w1<
zm#Nt8KwbQ>4aWEFzC1CjtgdFz=|x3-{rC7B5(1;mt5FyVSc6JPt@ri9@*~j*6}G+X
z9GKNZf!Lg)GDf7(c0GvO0U4aBO|;$N?4YPU_P|LZhy&q=?$~X~{4fCkwE%ZG%DRV{
zw+6lN7B_r*j3lL!ZC19x6chpvm{>RZV(#0I#~2$zs=ALm_RiI>O@O6EU@?%!gblA_
z@c#f9mVWo;hQKxl9;Z32*ps9d-_rp_Htn}z=x~_WD7zr<UYN)gfv`^4-XW1oO76}E
zk$#v8#YkGAwog`@3y#s#4=^~PY=P^5LDgja?{l0`nkIla7zO*M=bZ9*j2Y~nFd2@J
z6g7{i#a?!$v(7Zqq>ueID4m7g4-D!6*t5yNQlwt|9y5b~_ui)qH5C8=M<)@y&Bx0E
zmwo)8ZS9?{m<W)PtVM&|-~~yoC+o%l`Wou+306iUg1qN4ykIk_P{PHIadi#~(_ZHp
zSxEt`sO&HRO+`ahduI`+%0UEn!dFc&*d7h>f%P%ePO9&KG@8|5gWCZtKm?i{j&L?c
z*+3)mk-7Yi1odhFaYvjw<R|YPxF@zUx~!L^1>lOjRvYhL+h7B2y;%KonCvW3$6X@X
ziS(}dJ(;&B>43#SpbyUi)zLMBfOq!JP@vHx1Dc4h!#TLF!vItN09b0+14i%y)$S~D
zjsOEu+#c6~RGVF}Y_;aUYz5qKKh83ZO}^WAz=W>lLk=<g_I(KMFod8++ni>XUcnR!
z+zdk0c*bK&0a0gzf%TGg05z|A*!Ie|PSXu-AO^2-u*r2AG%A8DRx`}+8paJS<oe-G
zvIq$gmSJ14;2(|&7gaUCn{YWN-zO(h%@~La08mlJH91kKii-5WM}+xY6|3A1c+D_$
zN2uwgk=-H*{{SxLzUcSKAu`PxA`-lDl@5tHRbxsBCj0wfMo8WVQNp)!ab#H{>NVBs
zK3%!a>ZL5`#epMw89?$*S6~{vxBa6426?)LcZ|mw8}}{n%Z7l;RtrHyvlF?<ctM+K
z4vO86e}+X-#ec=N1J~07crioMmRT8{jU78s`1|jZGArqhB@14Ik(ttxHYVEm9={CX
z1FT1I9MC)Qky<)&tr#dOqknT;-Xe7isU%k>zW1ee0}?RtF#`0ltyQrYVn-_Milc2s
zy*?iP*axX$*2r5xTRpbDu)8lt=wmv(mi?&UCe*6=o3XpC@r0=o6krCSzM*9I!a8WY
zXITIQIV*oIGeam0y*!6yLBYE9%x^Y=th`;1@t2Nx$Yz&I5;q)I(*YuJ5B0($0Mr9-
ztL2kUrmeLdN^73jk3WkWI0`I)LW<z_$_U_^HDpkgv2stC<r?~)u=S-pD94Z}peo3*
zXVmY`XL*3ugc3@X)_V%X@Z?#H5rgIy2=BjayfC1M%O{-OD)LG7{O|`%t2$`fGZ-YZ
zorkCI-yr~JnZbdJFeSF$hWB3#)V)uLp;Z87Hfy)H`NjK2Mjb&Rfl_ITpS(|RakfD<
zxrph4FE>QppMQs@UMG#Ae;hWH1TThb&F)WZ%Mdz?X*YFU&io9disn5Hs4}*Z8Q>62
ziao|rojQbw5dLCL%h+Bt-Bb8R_a?~~mFl4oX#s(8=Vl+;NaFpmSE8S&k4H}&lSu5N
z!$mE~+vaixf?lq45C(q?d6@yBL%uKbDJM`~MF1KKFWRjAGMyA|r38|sX&?c~7IgEO
zS~C760CXK%&wD#%R+W_wqNtX-iLecvSbAhgOr$QbX<d&e8Gs!sh=%%9Yz_bcLH@qv
zo=?)hX3|F`f=M6-I|OrQzW5Hc(ZoDEl&dn4r)4$I$DgKT>C^{GQsvmtKXji@#2mDQ
z$m<&t0_;a~-2C#rLqRlP^x~C30{COM)RWr?>1A1_J1T_)vyFouY*z!20PTonhA1Qo
zpvSORW9GZ;2gARw!#XaVyfza9pdBX74O`XyI2jZK^(h$|6Ynu2YUA|CqP{9PEXE}j
zMD{+vzf9BDBqEt)CBNiP1AV_!n3-ByW@F}U`v5N~)WsV0W+irL)`GcOE$g=Z?0)M4
zjzm2sg;()z+%cu0umE>C6-0PejmSAYfEH`xl%6KgtcOgB2`2YEWRRGdQ%3&)@*Do@
z@GaF)iYS;jj-uS2z-@vL3#sa8K8sOj)Yq@?jFYjRU?E4<VL%&_Z-MWOfF#A3=#W_>
znqk}GNcap3T#6n87lAY-hlW;)9yj#kzZIFfd0WI*b&k+dj>Gr*<1vvMO-jil8f{xw
zs6W2hI%rL@pXzKqNWJUnfv2lkff36h86;pC^;uoG`D{LzuhW>@NL5FK1qW4@CcQle
zrc0;@y+Z{fQ&j=If4}#d`c9GwqhTzhfOL5Ul4z4(y6@>>mN-msHHDF#Zin{Q_^bI0
z0$84Q9s>o501JDX^*-l(b+}`brDxPttgt(A#dkQ5(8&g?z1Lgsz^erQ7#3AY5ev|L
z*s|^Gzr!OD5p^2S5vI)^NdEw=C5k%*Eu|EBNdr@R`wo6s({*r8py=@QC-#k*y-)A_
zU}=}EPNo)ElSFFD5(Bup7q`oQh|E&-<-!J#2IPhQ!Rxl)Om*twGbGOsl*Ujls<T7_
zeiz1A7~|<4XrwCg100G6-5<TH+n#a^?2<}|Jkmyf=p3E+`2PTrm6aueG?G9RD(Fx@
zw(tGqc8V_#RDqO$z@NKZkIw#CH;~MvNvesk3D{*7M2(g=XH+$(Q*cS-pKsk~GfmV@
z7Qej87BB^I!OmG?k^%iTX9G$T+u!gwd{SkFk=VF3W0CAWU!D+UNF<eFj2OxmEXQy+
z{HnhnfKL%mQe~AGF#g5ZY3=jQ)LJ!SEpFuPs_;y{JFynFH5%{!fc$bQomKU-&iycG
zdS)854ipWK%Jv_QWt9pvdXbfpMxak4vH6VjqUlUM19cIUrydI{5?J@JJvJNr?ZxJ4
zx|Wtzc2LWxjbw5*zlr1PlugNa%7Ph>-dfmSf0i`eIT7gup8*w!C!0Q>JNn~v`k;5}
zV~wQg)Kjx?F6bY9v!<F!CvUjDn@tP$KEv>=07;T%mO#Z0$~X&DdG-GQIh&}c`kxLd
z1d2$esswueIiSlCwDAvywgZ8EyMB1Zf0m2FngYZS@>kyV)9g3jz2J9B@x-d>ZWu8j
zx80%1_!>VfPM#ywp?JoYMJx$Bs*UgU&UlYXWMTq%qf3oDr?<A%`DGWWJuIiGMPUrS
zK)uMSBE3KBAkF-!Bh1PJP$Rng<>iiUnl>@$Xvhm{DRuE<)PZ9Ca?-w#?cu7(SIlp6
zZ@1t!>@rYSP1GVx$^QTn2bdrr*&gElqXRq4vC34aRzOq$Yr}6}jo;5N6P-F*f~At}
zyAA&Ue?yBPEb?g3f0yKw_q_+_lxaG8PM#!X@h`-7G|W9c0Ne4(5$0IY(l9m2wT;UY
z`g67~ODhi&2W3FxLY5ravTyg!B$Fv(@xFl@4I~ZrG(Q2q%NM7R*mkB07z5msx6hG~
zTc`pqrH!;Q#7?Ck>_ztNTYSz;y!}R^vk>+Tp5p9$O`G{+bn*w9^a;x;Pzd72#{M|+
ze?i%|Z!;lLu=3ahA5H%NJfo*E4xSc)M~c?02;hCtPrV!ZWnLn&9+n7>r}7FOW?{CU
zts3<|41hrjq=1cbQ>u;1-xu#gE7EmmqM9O2(F0NY(Y1nf`X6)Za5HrhERx!zlgy09
z$#3zFQ>KC_BohfFksTyWKXcQ5<emM7JRM3ejv0Y1LNzPCy05~?_}8XFX(j4RXJl0x
zBz^+f@A0e1G=DoR(FuwZDytJEbLd5JUf7QF2}H0kjX)Zh9!af_so+)#)^7?ZqZ*S*
zRBcuW=TF3H7BX?45gSsfs300A%)=<FbklTwL&GGYUL8fy(F)6Ay*+os3oz?lCYic+
zWo9&MVhJPXRrASo@c|Ta#>P&duqzoCf9HPP?-ZlIQ69dW6$eSPMW_q1c=h?@4FUdH
zDdH+M=^*z6ANP&nD;HCvLIzcpKe$~JN8|Y9S}_bjBOP|h;tQfUpgw;>G0T5dV{{?i
zLX+4LRDL^t>nK0W%?wnrqJ~i$+VSx8KK|z^)3_6BNCdqkWHg9x%sYa64%=p9DUz>T
zluIxd<=_6ZR*45kBA%VrH6Bv8xzpVIH~HXAVU8tP<N>54m5Eqs3N-=`p}MbZE7K_H
zVDQ|DjoP-uNnMZEZ;fIzG~Q$i03-__YQAyc>X)aUMCv2)Rbymcb|UEfi6`O)1e2!{
zEO4W#b(rcbz$qJ1v%uK>afp%nmpw5GrHX-cKqiI!s~AEcfhKto9UW;7`pFgv_5!)d
zq+l>ra0n!`3K~YLHS5Uya1~65#z&9DL}RiORd#pp&*PUJJkoVhbf!>>0A(y`My9>~
zWPGwLOcE7G)(9l(;ENy;`Ta49Yh@C<yG0;DYeP>UlicsepvWJiB0ip9>Y)e9RoCy(
zH`|@|{{S_T>E=JoDkBBdJkkMm&7Yw-ol3{z$>GULNjhq@onLp2^07S7F#}X`s@WPv
zd1!!rHx_b)@Lm{1wCk)Ag}=Pm9RB#k@h0ioXtfZ8vamaWb!X$o`JsAA-F3*sBu3iF
zJ6&zt)b_~8@%dRJ*QaJA*kfntHy95b#z_g40F41)q3V}wQS#g8oO*}qE>=>yRQNz{
z04?`Nw&#3@QWP;hABN|0yX<!L?cW*@dii5XCRkF{Se<|t2BY=DG({g&>m;$fn&wi>
z7yF0aH}YHfjFPd`trnC89Sb^w827K22j43@#V=9e#ic}GgfXdL?Xd5?8Yk<KL<A~*
z=LD*+0`H&SrWDO8bqrm}NYPY<t=WQrP5f~ciK!z|uUfJx;0`}J%k|wznTp7<I21>M
zD@~}{`}XI!KDeDULJ1>jfC$7os}ogqezpEE1Zzl9O1NOPr|%O-%00Kt{Z6Ne5Xer8
zrEb81N8&|&GVd{xF{UMpLNFwsGlFZsJ^uh4JyUdmyO2z;ASj5|5q3QHJJ-tr=`<?M
zai~E+5<xU9`(E{p(#_#bH-{2W)7P1f#_S!Kiv*GJtHg*&ObRQjN}-KVw%mNEACblB
z9!FVvQ749uM2t$<wYonY$ob$*$*fHrVHZ;d3<Xf!5q^fp(+5nUdV>s(z_B*U0lNmp
zpO$Qf2>NJxy&^YR6lu1$L8(Y24*uU9&C|%RNW}zfjtYYy7e~|3`}VvDmJb~OR`yU2
zu-o_Rk0C81tp#Nsc0JAh9f!*cD3KSzT{5Fzl-nOu>MKq2-!ye_#IUr{Cr}QU%IX)W
zmGiN0ikcpuh#-|uP>L8zNTLWJDBM+d>~AO#Yj}u_)zzd$SJbho8i*C&U_M!qLm8uG
z(Hy5rg$BD;U3!V&>fUaiM~XnYL0VQJhLXE`5-ZaHP1Pg3F%)Q`3bqL?xY)5CyK#}~
z6&jWmYG9Tta%-^kyZVf>sp=wBR$02vqH6<|dmr3(9Fbo;?UHGxEM}xKF|gon4c(5w
z*sq2IiP|uXh$FqUR>zv#zD_cZB3TqhN%OmlUAPtLxccM5jWm(6oez88x9f_gUa3(7
zQmU}7Hv7bUe>@62=sH*+5k#*TCt8|gWDtG!+Z7;3m_}KqL3_l#hUD+gz?=@M(BBA@
zZAacW*!J)A#y@FI{HOBeiz{hr3O6bU7HalZBLPgMHOQcNTc>Uf{ySlsZkl1KBk<gK
zYKdpe0H!By{QU5&<N0C;ZxnGv5Kh%&+kdVXNc_5@bdp59s1Vo57kiI~H~@~4MQsS-
z(FG_w6Knoo=rg1&ksg|iimj?MLvnWPEZ<>!eRH+L7-fnl(W#XsZHeEVyVZMSx^XUv
zL~<4yH&)+*59xm_2k<oXDC~h*nb0^ZxfRIm&pBR>KM+Q*rDKtoazW4yfG^UCzm`P@
zi5sVf87#V1@9$XS)Yr?LS6Nba>3riugkVJwZnw%BZAi)qMpXrs0@<r3o9TP+heVQy
zge(bEE}#K)4%hGP@XD%17fRwt(7H1yCd2pn9oxTU%<D3ZMxHGy0AMx@H`~)7E*;z_
zibDl$UR}q3na1g&c9j#u)ksKCwYHK=AC~u=7D+XA3Fl^8ZS9L28{et3og5OsN|Q<o
zL~J7w_p6=z;3bA~P*h-28}GH{-}y;;DJ7Ct3?x|LQUE14vPE_Qd-uo?j~QSH3;m#d
zPq5q%pSDgS%`${dOcu|3HP5j8urxxkM+?Z>(X{NzT0)yrZ11_QJx{hr`EUU$be%@j
z8=+fY@3s_?d;*UWvjJ-$K5pB72ajA}q9u|-tEiy>5J(s3N#>1=pgT8-DJ>+nq=_7#
zUU&8VaQF)kQQ^DlU_Sbr7ejBB`}<+(P?ULD4vPp~g^0(m$81TurI@3`(<C}I092Aq
zl6NPP0R!YP86u3Nfa~!Ts-vrUSJwXk)@DbMCRbJ}>$;P%S{r5bC{QWTGOJS%MxRoC
zID{)mSjNd44M5$R$cw_>6o3G;5~>ug^?RL&-0nxF_>xNohLK<b+#9oK4=O($&Pc#W
z41j4<Y-;w~pWl3>&YBr?rm#q_d*{#%{{RfCoP<dPA)!PxZI_ZPn{R*6XDYkSqA&v;
zGyt)9Cyiry5SF_EENn-ww%B6+obfnClrx4XeUAs@fvI|#q-gqQW=IRQ?Xs34_OW$K
z->}Te&Sf&kenkt#-R;|NT+!6aJIFOg6_<Mvh1W#cuKa!(oJflc24@UFpu8~VkEZzt
zMk(S)VzCkdWdgvx{{TEbJ2s^<DIatae(H;{w{8Cb43rTGrBr!DK=SN19~`{hEmX0_
z%@I-0Vs5W)b|)x^g`Ipuvio{}fn)2Gj!5J2Qhj9As$BqTtox0>9E#c2>;To}0>?iO
zmQuCIT_an&2uH5pt`OZs4bv7zbZUJiqifVfaDI4M&AUku6&MtxRnQml!qUql%OjG_
zCwD=)Cwj@lu7c5U3EGd8)nChO1oI?eY}5I;-1GkOsIkQqjUtmPmC-`9_d9#yOC>2r
z15kPd?nQ0Sr})doylo-swFU-1x(T5~Q9N)5t$N*LR$?3k1O~CO<oxq@+MQIB$jjoS
z<=JFu6xk(|QlC-=-y7#K$s%dcj0)-}P~`h!nRUyopaGjv3M#kkKDk1epLNkpD$Upf
z<&<cqi8oV5`-?kS#aR&*?MW;R@5iU(mmU*BT2@zf1dlessB`uDj3Nr>!6`tts|5NE
z*{OPzl^Dq36t|m22j5o1+K=U#UOx_YjaHWEfOS{B*W-eNN_DoSQNTYzcoSVJ+KDA^
zdd)GI(WaL`b!h2X%@sB`6}M`w_9rA$Q9z@6q6w=wz8MN$(T$r>Zm=&D<}FBo7H<BZ
z55qfYP_)9AQiepNECB2)pMP9LmC?~%*+Di={#*Twr&ZN;8lFC(43e5tBNM0v+fSu&
z^uUnu324-m4YLB;Z;o#SVOmO2U;;opisrCIJHp`bXs+Y26@hj-N3B`dU{R5Z7V#BD
zlcXEE?^W;LB*$6a%8i%)@{%hFoN1=g124E6?~^qqkZEgczIo>XnRGN^!3sbl)UES}
zPKqv6g&<HiNX~evv=`k;0A2q8tmX{!=u`?$z;kB3@F^cGPKgYs%ErYVT>SSN`sC#?
z`3!PyZJBhC5Z=Iiv7%`rZ5*wu6hC#3Yxe&DIJ3u0+iBlrCvY$yrj2E74P@^^{_*Yj
z;xsZSke1n42Kby2mLL>fMI1&fNi0Y=zkC7(fSw|O&7RptNZugoX@Xl{bM5lQ37{+9
zt-Ut=-U#9{2R<UGUCsP(1Y}m1K2yyLCn&%=wvx1huIq1F!xPj&9gl_{$nJO>Wb_Kw
zyD&T+2fhXRZlxokG!4{5yr#0DjSvm?tH~i6=r)ul&tP!~RV*z}!+cgO0+t4b!`}d#
zAiD$p^0f?%!5czVgC{rXwho`DJwAy7D-d=JEPIN{h6Izx_iuniOcPlk1HnJtSkjda
z2q8!SY%0xnz|t#3iB%vZ9kv5%-|L(M7V@sM$-VFc>ndEntwzm$zg#N%NF*oSBh9~V
zabygH9s#qbiuTSMxOy6W4+ne&a!$b7`qf@pG)oxdI^L^05na9gv5}&dWe&+2fxTH4
z1%5dai%X=C53g@r1!17jVBZYwC0GXA^~aExc6G2=@HgAzfU2v7a&~Vp9M%ICR!xqc
z$9>!7ivUKDc#cs)7C_v5Gme+lpy>;BtGNFFIm*i9B#cCNz~p=|IH@M8$rsKt(<@u)
z<7(#=wb+mD@yBfC(hvjpuI~GKVNEMY08-`Ec2>Qs+ak6e$=n;?F2dsu&A8gD5=2#y
zQ-TinggvH}D9T@g59U2Ho=DmRN~XJZAXz`-{p7d=4gv3sKxHAyp;Ko0I18`HM`5@*
z#kEn>Ukqr}g&?Tkabp$9W%L7YYy+rj1O=hZ_xRw{=V52%hFKO;0>-OAY`yEg7@9@%
zt7z;^_rU1m6U!WGAIwGf-x%#972QWPb|Vwa7_g#!aH#&J8r<$%kB$OZ@eYx(JY@q4
z6u`ajXKKfrPQ58Y#_R{zzC`&!6b<*lG96CTss-#9kAT4>o>g6qcf~89gQV}i0(GCd
zD*@G%vag6h?rU-Dg^jtU*1QWea$#(ZsQP2F1U3m|9mWH!tKn9FTpzqg7>*f0BwdU4
zz+4s6XC7$UDB~>X!Pdr;bUpnrCJ6`7o-oMwRafg+p64vFzlEeal_arS-)sr)7h|04
zg@%P74#fAtq}U`74;WZ7ub5V@53T?gt9k>|30h7@_y`^tC57i&_*|V`g<x?5NFWev
zzkKaX-R`|GttybiP$O=3_rOTyN#6mq5<`9E9Ff}>i#!q7=O`m#wf;EFfDvRB_4UA=
z_Tb?=k-yUmY1QQv4!~X3aa}xZfI%<0HhuAQ&?oT1#DVa^>%Iq3VYuJh0&r;UTkVc?
zg#v}u^NPD!UB|Ws1Zf}&Tt-6O{{YDPWSt7pBoXXzfIE_Nl&K^YKGlGrjt&_Z6S3N`
z(I<|0!WKPL_M*FXI0_El+09#TewZ}+9sM(p-uA%Zx2VUKRgtYwC$QruX87%ff(^mD
z`e6=)foebuH(y)@ZkY+O^%#Y=+qN>Qh4XV;3<Y3Rf?KxZz84^cp+>MgrJHhfdf+6p
zStEP~RXP}fu;k|lY5)_@t_0j2==S%{Ec6EZU>!AOoP+SrQqhp=!pE-oq?;GLXCIyi
z)XcPq;I8`x_;=0`lSHxH)?O}<$ugiNm>u`V>LUtBMrr_pYJonORJ@`5w?nrX(?-H*
z*pfq7<7`3>prLDS`0U@;15l+qR~Q;oPf0*o2XR7&*COF3m5QlfWx`47T$I~Lp}*bu
zemNNBF|Z*{qrk7n0^_7*MGQ2D+S{CwJ`IIyCvTQ(Ny5bLzy=`h-k#Z#cQU5BDz{{D
zz5|H~0ejW%HUlJF$iOk!P`_;9;uwo*D|-?~Xh>2>2{tGSu1UZ`1bP`>&ii_NPw$Lr
z9pjA|0Sattuf6MtW_aR3pityi$DC=0h*jF}&<gnhfl1JRFXAZ$z}k-0>@s~jYK@D@
zqPvm#3^GVrkdQ)yrmt%KGBU*}kqgqREvlWi!kQ_(H`TFGKq>U~+d64HexqKJbrD1l
z)3z9)L#fLWqk~_2*X4m+MCVZ&j_d7^Sy5U~x)w9<xva8Ay+aU+kwX}#Z(j6$PG*3#
z5(g@>SlLLh54i7-H%k3E5xX^w>Z<Q>YqnHpKv*9rP)8o$9B7lo6bKA9P(3r5+Rm_a
zj@`Y#Je)Sp#Bc?WeK0EM=`n3=SC0|<{67q*Pt-C?=a7XwS3fLAo5c#U4ODMP>^ls1
zWjdZn^p!RO(6jz97p0F*t$KnXpsG3g<>s0wk~q~yrUdsSbM)gfO+1VYgoxOS8~xGk
z@BVRCv>_nS^}x~*MuQuaaC;617Ek!c`$wc`iZ_g<h&w6VQQzmu$5<n1HCwjYm?-#)
zzo*wA9ynujA@Z*qS-!&kw!*qN*ZE%($zXO{=i0mW{BnuaO$6RM%6$8>>fh(|?U941
zZ6aid0zT@2b^G<gVv=Mxw%fCwJ{bi|KvG9xU{{bGiND{zEC`bw1QmVRn2SEZ51`EQ
z6VrqQfUSB*emObJCWu9({q2Z2My|W4SL&jU1N|gWyMej&KRk@6vCaK9G87iZwg<n*
zoOW3Ja?V+tklcOh=i&Y_d@!uV+R)HZ-H-0DpxUIS4@~Pr)ZSCU3jtoA%)zL!HQ3qz
z0C_nkg=1ui1&Y+|xnemZ(0=>YFHJhc{vo+V4=LcE-{pYv!65TdpaBE5n(~i*_sB}J
zYZJL$E#<Z1y}x_qx{jdrX(7_yAfZY&1B(4Hj-6mshIVDYy1-Z`zW)ICxXJ{vykP`F
z$XjbQM4!&9>xi<ePacTFY1n8Vc;7zfEj&^!^!k@j19Q)<d~>Jj)29J?MFA0X87N!W
z-+#z@eDVZWk!953it1s%AF-M`ZwIBBCXD#Af(jBXLFDo`Hhv!*%Eg`}Yb*}Qw%6Q#
zxuc~<k|Kd^mfRMuN8_-)vIs;}b*U(QJL#o1LG}3e!7~2<^QBRItV>43*-`3!_`jYG
zpf`@;-J=XERRBmEReZ6M6C<pkgi}h2$8A6IC$P#TU{XvK+fkqn$I~_}YZwKIl4ep^
z5ACtX`N*L`J1k&2wTq+Y-p0pz`1)e$mJX&!7C@G|C2~Q%&F}bafV1?6$Iv8KWfy8_
z00!Hid-`QQ%8jO!LXGFsxpPYx?tc%*9%xX*6GoewCPp=?fhXb59qTbf<$9M9fT$1t
z-u_|ka*l|jPWqm<B#=KZe9_XkRn$9<pHmprvF=3+C)fZE{{Rfn)I%zDGCrLxLBKmu
zuTO?kr-_&B`Feo*4xp|sw%=eo@G=LJq)`FZl`GVM0&h>h$KTT;x_r!2Py|^AVe4ME
zUo2*hc~*!Dl2R5YZ>}VXqF?31YlS&#tw4V31CXM+v#BACn;+Zl@yZKjK20zynG}2R
z`~Lt~8c2~@h_^cechWD6?QbL{S5~81O;7{(e_RFWqIb~l)Fo{+qR92z_r5XdmVIC|
zE|5sFE{8YryhLVA(AZu*&vW==M2X?58&_x4#0#<50rLIU10Y#Cg@OoIT#e<kuwLHW
zdf@1KZl&ivPfp4VHrwm~qHq1=o@i3!gv!#g?oVUA*UN9I%^fFHsnhj{WRf89Dv+a}
zFx%LFfq@6q?y;>IF57Cm<8Pi`c*+p17*|VHTFIeNDMXCBxX^<8{_h*8fuUtis>8U{
zR`@4j@~!>wE{uEv-YN+t02Nb98V!y7N9J=G2_YRY2Xa|#^Lzk5eBql;upBEf*ag@C
zHXnxn06aZ2H%K~}l&-kci0odQ*pcoyybkJs>E0xcM<{;qKX9JxJ$JvRXzIFdn9dp*
zLanS|o(T!&Z<(t2@!K&p$nnJ!79}~<cD(3a%R;744Qz!hINzVH1!xE)ECMK`CbtCH
zAbwv=Fsgqm8D?+lAq~HN-;VzPER>xz%__ret@lc|BjP`NV1TlM`oWGPs_)}pJOSfN
z7@8N<x`&-lAcK4QZU$A?r|M!<j4<#c-+#PGC-nmlQPioBIY{qAGc6x}Pt)atr&Wq~
zdsU3@bwqX)J$=8%1*ddQrWsD2qy-iZ%19f6Ij-LR*_JM$x?Z48B35=*BUrF6Ypl^1
zi2}NZZA^Sdy1VW9{eBr3!D(JOSS<!8ZUF;N@3+qi3f=_G5Io7LowzGti}c?fNm2Ti
zWzxw?rK@m9Kas?g1_-IA#8m{K?l1A%d~S@0XK5mk*;a2VgQStb`ty+run5b^B9c81
z{Ep*n>Doq8i3-LdEAhJA`(N*jzf&V2MnaJiNYkp%$LL7;VCoi5ogO(*+LdZFJj9DX
zmfoLCp&<*=M6y?kQgB@e^0JP={eGBch=-bUF*6cf*OI^7P5v1PXX+$Vs0|V^YO%SZ
zK3iUTe__D~+72Ok85&4r*0r|FYw|ipp1^T|=ORX8*EfqBBa5N11Ygwc_~n$s-87D2
zI@l_yVZZ{(9^}yYUS#S7iPPwkW&z(;f!@23>$&}$(qs_y;vH-}KnP>K4mbH(`HTsF
zE~>xQRVf#k>22tZzuq2~rFVu&G<guJ$!C&m-FKi5(*~)>P=E!v*Z~`Gcs56I@yp5o
z0LemC%eZl9t5>A9<olf?W7yz2=#ArI?682rS$Sryi1xa(@0t7n=fW}=*cLBhwDUmw
zn*2r)(o5C5ODPem1#dCgR>J-kGM!}cD@CDG#8XAi<^2b_?tRV#pFo|;q_LF*E|It(
zZTQund_`+#(gx~5wgBzFK7xnG9U&$*kywZH{^Cih-`jtW!!vkHbvaEj&``tD{{TD-
z^xa5`Cv}fs^vW%@6tlVd6ZQ7abdoA~fQY*)=^k$X0Ouebq6i9DVS0$?;q8~{Bw^M&
zq<W%_i-1jOJSp`wNZSHPtsApO$Hb7ddO_SN6mRRBKF{mSa6Av<2xVnyQZNZ+R^SuH
z*Yp`U-f4)F!)t*6P^n<|v-|CmpHG5hL@6j?d+v56jd5Fy29aR}q(@VwnRK?+DuLVI
zC(|pufr$ZG#-^=CiLO6P<qP4tC3Pj(Z;%!1x%vzwA$2Pu9X_oVb|4Z+`SXEkL3EXt
z%u+ERH?X0<uqQFod0j`C8)7~_r@tRu(F`(mo+pVSiiuGd<y?Hf9E&ugr;#m`4=jh&
zjtAf{AHs;UE~YwAorcypA0w4sk*N{nqg<EMp{UsS`us+6bmDG}I)u>*G^7+KWE+(i
z$+{!ui4;CO9Za5MEouv1tN}O**9_>;t-8OEFtT^MuUwk5bu3j5l7Ndm)$A~-Z84Hq
zEN%Cy{59N)KV7}EUsAm^9X8T0^9?CRjYkWn%WC6tK=~hRf-fY618HQ0mQg~Cpj}_X
zY%irlM|#3WLq3|Jd=HI`Ms|r{iWk;YYNNOfsO&wc44Ie2jM|d!Hh)rD@`{~C7*5C?
z8rjM7D7yTs5+G-v!&`}Dy*<L-$}erV8|J>Br0P1@WHV{e)2acefT2y*eQvw%b27#Y
zkRC9)%7!O_WBh(N7wL(YsaU#bC3zXuN=A2cxS?LQ2iGUmLQ_MxhFZe0jPKa6KKs@f
zCrKC+DUL-XhZdv|JiCv8uXFRv@|$3?tI#xj=83({_V4t_Ei7bo&(tB0!*?ptFDbs(
zJ@>DN!xk>7MD|k9u9ac;lDm&iclqSdlC7$01(##Cs{H^TmTD10D$CT!?y{CTV?-CA
z>m-xfh*9uwYz+D(idkep35l&ke`wW1@gpVS*##T=mtcEcUTEp{%IqDZ5tj(<Ckn>s
zn%;)z<&$ken5?R?@pLY({{TMOK{7A`QDm0UYz-RjJ_3i&5tJ;XuA-IZW4DxkwVbR>
zOw{iLV$=h^qM%>kGK?b7OEWH_bc5!tjRVE<0X?t;$qT&UWnm8NwZw+aU)HfN#FZpi
zz(BMVweAHE#9-2jOhDRKmdE2?TrsdM;kzp9p>1@7ZT;{ZD2xe@nb`moY+dd@8}`T7
zH(C6@O)pfDA}a(gXaVMG`jgMDW?-PJ#;i$F$B*4+sggNV$r*YKBZ<ucKzXmd{oiZ}
ztVvA*%7igndLWKFe19X5B(nz8TS@!mZ@2mxtEi1*NZ2&PsAeS;t$Gz8@^>fj&Vi6J
zG?Jr8Ba+qkQRVXS{lwni4sZ&zaV*4i!f1_3#;Zpl4UXS<AEqtz<D+XVl1SScuor&+
z02=MvCmJkEDUnn)SOgk78vIAk5>Frsz-na{K(IaQ0LouVT$+IX(dd1B_s(LGbn!HI
zqyuaL*@-(7>p*e-ar$EY6UiehIbS0My{y)j^so*VpkgHm4#cu48`<nDZfoRlB2)#`
z`ixGYx7xrpL-*^ISChe0rk0B-8x^ryPp;pd67l$ot>jT9Fs)ielg}piyb6=2NRlyS
zjU3Zz73SNIO`Cs~0?Is*1f^|dOki<TZ2I%~W{I^*6=Pxy39^N{Ax677nNf(5<81|0
zms7B<LWjQf^vAMdcMC{K(Z1%-eZ4mMU@NGXSS(A2R2%zHu6;N8VMwNV8WSIcOZZ?v
zlma;)FV`#JgpDUF8<~p$G@1keYyn=i@;MnLGjzA96}&>>RB@`WbK7C~;1!BFodhSr
zF@;jrNp~!F_S^6SzAArGa$_hJ3uy%D1!$AMucv-7`e}3|lR0wYl}hrfxGner{{Y=&
z;)!F08T6HEYX?zYMOFKL11O`rn7qu4s(kED?8f)2yv`CvMhv80;1Oqj<LUV3xffBE
zc^sJ)xU2WO_<`FqM$<HbLldzqq}8b3e{6t9;esp9%m`@f?)n?=>yEEChGS)Rfd~MS
zbjN;!fpz#|$gd)VMLLg}wD<J<{{S3j@#JY0i+PTw)M(#rup+Dh)Bz-uOisj%+LB0}
zLh7V;3artMIzao!<3n@qazYmC8Il%41+p}rP!s}4-*5UDlMq>%WM*Q3UGcS7(uNRM
zPlnEsuzfV1Ywfu|Abz-}R4Nse_-u9@=^y7|iZsUCux>SQNUibRLm1>#b%>Fw$YHl6
zRd>J3Dyr)+f{9@pf^BT;s<qqGY)|IG74VZpWkR}H0mTcx^hn6UfK3>aP*dh1MX?pO
zUSlIP)6EzK<P5>KK44APrvCtz0G(r&d7dbQU>!=T#H!ij<?o7sbuuVovBZnT>EIGT
z=W;>$oMS6%nDnyAA5Ww!*OyY*K43ZCx%3$)3;e-o8bYD19mO#ni5|EPAyrfYV9wwY
zwXhrPP4=Oa4kUGsk}WDhVlL=k8Bp30)!huL3h2{&8?%1AV)UIm^%HnXv6p``pIyG_
zuIJO&0%+8&8}6dmUnaKO_uDGwMuobNp<)iGL2h49HD4dCVd@Wv<h)`KR0UNgf$mL`
zcjw}9U1jQ|RUs|T{%s%~`6q*rEULN#5=-jRJqYCfCp)P=5}4zV6p$+$N<Y8P14hiI
zKQp;Ja&N!uhIo^w)T-+t6jDKScHDeLkER5fnUFIvHL`#<uZ~gVMQF@!#ZH?Hdx5^*
zmvx;WM<}871EdQScJ}y_jVo*b(02qIpgsfTl?^9Q^UQ)2jRbTRbOC#lzppj$tPwJ4
zm`I~j3m^^Z?APJ+!350{_=svn`=kz7o=Nt;eX->wVOYsRuEg4qSaHv<&jKkL8N_9z
z7gSE?<~|rGtVrt2tQdkp@9T;fylk6ozN5&m`^H@?R5KM*$@i=U>RIKT<dCzLI^CJ9
zu{)Aaz7|FVhF~<BVPhz>wa22hFOY5Y`QG@5jVsDV`iGglEc0I+0<Mu3)&uAyDdZEj
z5=s?3sUo>LeZL%3DDt41J6(k?)HuJ7d`57u<P28F%L39xBg}e#2$@vYnx?z%J|_{;
zQX;K>BDU+e(N|+BBrO^<$fa3AwXvp<Hva&Z=a6!t+np?IYTVKM&H;^rA$zF_8gGi;
z{{T#QL<GngiUPh}tdsL2>x&x3rJU}fz}Wn-Nh?T<ye0hT4TsABJ8EE5(E_#=#yDdm
zv#ATW&n*+is+L$%onl4X{{XTm@3+H~kSt`>SSZpD%z9uZtxQW@fwA?*k(rQ4?8UZK
zE$Qe!AFeltzPDCHs{wmo9OAqyp-7cZ*QK`j;3|Yk0AuC^9Y=xwb3+Xc8x4$uQ7gF{
zk@DLTIjyzs6e&=^ZUt;Bj&MaA7F2CkK{UIay}no+s~oE#X(@)|Z@hjuiKqsoLJbS_
z_<Cm}6jfn#H>>aatUzfO&9a^{3W%6)ZAl|d>?_wCbf8KhXH}dz1hWkz=ZQa2Cs6w2
zA(#pTkBR+p8HTH4WB|53hqh7HPhv<OzL`m3V53M^p=}^GH{QP-22_wNdJ5ALSOaG3
zpN1J#qX9_J01SKXM?XGrCaP;!i&es%ui>2{_+)Sa-;2evACO4zXFE>d-o)~KFb&9#
zZp9Cg7}|V<yAMz?LjuGHpbY{})t2cx*660z0yzPwFa%i@cvm5ec<$)Z0Gd<F!R$>R
zj!p>Xl_gbK7zNbd_<(soKhG$WHkPt&>rwSRvTW?CL;dmssXl|f{D8od7G@@tA7NPV
z#AhtJz@;op8u<Ki0+!ef>yeD8$sk?qbAOf)WQ_Spt;dv(F;U8Iq#trKNCICF#|coN
zl^5k*x98jEkyy|ac?r^6aJ<*Iz6BwL<d8)gmwhFgi0lb9^3G{w*4;sH9mRQe)Ci;g
z@O3dbSmYo8!i9GOz9om`lc$Y`7zSN!An^rQ*nYSbd?|{yqoAHU9^CulNJ(-{QQpAY
z1Aw)qjUDXZFn!LzfNuNc8Bm5Ab-MuGUf7Q9A_Qeo;jIlTN7sK`2*|LwHdxk^>Fba(
zgz#@wHPsxNuBP+7dRF5dwCRq3H^{)sQbQOj^{^|rIY9^tl@6nSu1!EJFV_#54*cWF
zOCJy*MLba2>i{qcHYV?|+OR5YUaq#|Ez@-gADz%jN|hnT!)g?NAC^P~Aai??YYOWD
zd)@Kd9wqTrqM%&SUH<@FUkUUEDs+?0ZHSD@$5qwc;T7=XNMtgzc-Az5xUKI001w9`
z#4%D$ez@QJjsR=yJ7Y=H%N&Im16}ULd~g)WD=Ld>91?MC(FH*szL?Zl(vS!p&J}T5
zNUA-~0Eo0rtxGF*Bb)_PZcU#;ah*WD7pL6kD=1fH1h@9l;{k0&C}Zj`YR)9FW9DY{
zyeRfdJMISCU7RWc`PqoowE=(%x{w%qsOIy#5vOzNc)&v~5N!7L#~`5wUp4PQ;1bE<
z1Tl?QyWal*44%M(yk5sRnkQlb;2ddSWGl5;8+Y7b1TFz!r%5!-M%dC6Ye1!FSoJuF
zpwhg76}h{tC2!2fgIEC(hnY%)bw@26K0I<2L*y5?rbVPXQ!%5p;f<>Q0IJGB+PnV%
zj0x2eHm`i{<9>T%bLJ+u!1l#OmLONl1FeDhVX{?$BE2!0RHCq9XZw9I3D#`zdz=8u
zrl=o##*q{#Wjyi^AmW9#+Q{_IlV&$q0MP=C?T2&&;eQO}H(^IS;3C1Tz9#^vx4l|x
z0}xxbGH9?Fh#l)Vs+Ir~UZ(*x*{!jZS@Uh)j&m-NeE$H9c?4n<pyAKnv9b7IbCAia
zP-ftY;C93wQC-ga;YKkV(l_-Ohkq%+V3wWr3|+^>dSwc#M^*{^a&=tqfJoZxS?z!t
z_V>y<=oCP@zg$HttIW1Ag|p7*2tOn6!m4C#A%fp#HH@*2H2~VGn_=<5P^wp-J?sF^
zFR1P*k9_7DM>c&knRFU$usDTV-iYG{?a9B61|X1Y0XqOV!n>Z|EN2u!-j5ZERQBUK
zh_lET9I2?Cz^`8U+<oEl!n!o?XWt5eL^sC9_zJ8SkO<B<&%P0{+v8ZwQP_nHJpum!
zI7Iz;&Z2kigq<eF-wXhdXrHHi53!O{3+e>v9M&^+DIiY`EvSN6>@$v;+T4Xo?sgTC
z{*hwdWI|4mPVI$Jv>lk(suVF+AmZu0&Im%cQmScDX#8_mTPbjcFp8_?8g@TC3_6S_
zO7YJ5tE1Irm?|3Fw_)(b>EJRraKLRtxhFZ}lc$xQLJ1>L2Y=bXjG)KWTQ!5e;=c@|
zNJ?l`B(c5s`sBPO>IrhhxikSbSm9PNv0clk8~R{qMM^67Bb&cMar$1GLuIXYCfi|I
zi3E|IV1ZXcxjDKy2T+=%l!{s+tg{XV-LeR?2SIc-8{Bb`Rq+XO+*#*qt}>z~2*k32
zd2dVXGrS<Qu?<KoYN3Im1xM+_X$8jT{{Ru0`j(Dn4{UbQXzj+|6NvsKT7w$Bh##gr
zV6XO_J&6^*RUmRak@DLNUkO=u7RURlhFTRJI=MPs*b!t{AHQ4y5tLgEda8#N?SwjX
z{ueA5iX+zYkiMxeSDMfD8`IQ}Uu=kX@tGvq$8WrGTc?mg;+CQ;S06#n0iJO(d7EQE
z`zZYP$)MDwRB2K<J+T_JjbnD&hEU1kz*Q+i4eOI#up3W>8ixePzz|3FkB6>XsOjU1
zR9OQH7pJ{*edzc3=69Li2+KE-Z%7`!{{T(#rDEz0jaO%F>)haQiCr{-RpukQj9#);
zIs|CN6NAN$-w)3_OGgp10y})pG4n?rfOXw^0gxEPtP8s;M|YrdKYsbrM6aoofvg=W
zf91dK@}R{Kk!8JFe4rjLzsDe&bnCNV(C1<6g$|Zkw4R<bq&JkBqDOl^nZKeMqi1AN
z0+0g>+t=|M{WAdR+(6w<v%3LZ&o}ygaprb%ixG7M4P}nRk56m{l}}OB_>*Z>9#cRI
zpa#R~zH@Zq7{eAPQ94H@kFT$w$;^(b44{HVfOa*_*QPr-mN7QLfd~OLx2MQuL|KqJ
znHZKIc=~%~Sro_OB8qMG9qPM$?-nw#f{qdBlB98&l)Ao_YhD)k+rB|b8FlJot5Ki;
z*!$t|nI#aah9;|iHoUQchL9IjY%5q^52c@KIRtG)1r=S+_!sHrcwUpsF!KvuJJ=sQ
zJwcaFgl$?X*neQZ%%4y5h>PO&6KZl9_SR43Ukq?zkUGXrr4<+(0ta*N{&1+VLVQgO
z`hNAEdBVLEy;HG)kSYrrjURlXv@yg%7Qkt0;?Hlu<j+*F#v+a|1e6Z<SI;;R>3WG;
zGa8LX?MT|F=9d15{{Y-N^xdy=dlTuM)I1QmFriVWfBesXhx*7Wzfi%ea(tuvMgfvZ
zI)#E3AjKPOIMh!+fX!cMOAJ#~M9ZXUV%uv!4$3&M^O=?s?OraWUTfFbV@oN9L}_8#
ztO7pq?ayoj6pnoSTWANlHD4YDdSt{d&hj`VN1^9>+Pi<8nU-P#vw4`2e?8B>RzDFW
z+_8kVkl<`<)8S(R{bNh~pk+{wDfEv+#rk|Z^XZw`YAGn7Q2{3Q=lAu^PZ=b~EPFEw
z1ni=&&3Enf%x)&?ufo_~qhhRH+kTiAYnnCc8Okm0@BQcZ@#8Uxo@NbN2xDOS`q$Gm
zx)~!#<X6~@8n*KK*Qv=fF1HAlhJe4s{P+6cT2&v*#H%Q^29S2X{{SELlF;tawxRbx
zCAJ)zuU}t@$WDAtr$Q?LYe?({+l<^{4>~DQ?H}J!d=7Z*02hHZ5wgV;x`HLu4*vkZ
z(=|cYI*5_uLcKc|4H%+shd#gxuUqFcNz_IpXO$XbT9^S;Pi?(0$1xE(SnEhu0ZF9a
zzdp5qdXAn?=46aUBXTr|BmTg9AACsOIC?mkn~@my<eoS70OUM(Gdzb;W+!&{=jV?)
zl~g2Fw)><|7!{lOcAbPO!7Gk+A75dTK;>AV6%yG}K7X%#X*z<#!x5}t0d@VywffM`
zqX<iV$n&rKyY78&@E8c4P%|Jgl+ZzWJB_%*=4WY+pz8Hc_qBhcjDZ6z;#JgSvI32O
zullcS3PZf|Nkkv{9qgWO@xWiRp=o9jE|zHqkj_O5+V|s}0sQj7>URnPjvI0Q&T0^j
zo25NuF$R(+0NLAp#eVz!GIZomDV604>UA+9_x}JlfFxFqQp_~iAUCP+mnuB2WK@wD
zGDk!ZKTn1!4Lgz)mml1F0&nYQ^7P3nNi>rziryf7{dT(-`JZeH1dzr$g|fsKX8!<)
zCb#t7@&O77lUn#FbtzG^8vXrFJWA4Z?WGDSHrKa${LT)Sr<bWw{Xoke)pQ6Zw)Ncp
zxD^fIFnI#BlA+Oi+1Oe5Z;^>WD<a5EX(3y=zCIaw%y#Hw@`L3UWM2aL{{VS8x@v*C
zidBnWhNS)Du{#f^!;B8<WK^9ZLHAGz4?gGH+vSB75(Ydpt);Jf0N>M#_-Ayn8T#0o
zflCa;4n48@d7c@3u&Zi89=86`ex9cRVrUDqX>DWs*!|y^%zi%Elcj;qsDNM(EymaR
zX6~W)WspW?kySyDfCmF_mHXs+xnHYPnU0nU5Rke?l@<8`@!tR<2QD5a8bB&;fbK8k
zGTl0e6iqCxE4nZ(UR7oUQNI5F0OKa*`lSu1DyR%g8>Jir@BXrC#02U5%%y`7UGJO?
zQx2XvT*lriBejLSB#tQe+>!9JnV^*-mM1DnRnkWTd#(HW;>jDM)s+FxrT+kr9On7w
z>7WvHN+aqbV!zi=Muwqv@HRd9^uWQ@ygf%#)XuR=ku-#=GioD#3GQ*a;o`Awo)wNT
zv{Y|Z>-88;mM%kTiV{e%Oyc&h!|}^>@<5OVCdz;GwEg3`-{uD2;{pe%5%n>$M96}b
ziyhl)$2~NI&WzH8Qp`^J^tW$n-{qYQQa4qp2uVzUX_2Ta6UisA+c>jyu|$t01}4W9
z!42>u@*cSbSFG{+X?l3)SffbFzOlT9$-k`+q3xMuiTY_w+JcA*=p<gV`v>Wb6T|$c
zP{kSLnbd1wZ1PV0RsLTb<?%X@d{!m*?gD@T+~73bDOgviGa|`g2=1S7clZzSoz-;A
z1nI4WF*#L0z@1xx@fZ2+lj&iRrSPTG{Y570iU9n-*~@i|?JOcTWztmYeYdT@5^x0F
zDUKLpd1LWkQ#$urAbE#jwE^+S$3KT45ukcHnRy3pPs8=g%MbFsMwy*_RFJFA33}d%
zAM&mD?|C4p(@hJ=i&nA`b*)GTe{7>du#QP%>1L4;kVHua+!KBM^zF@HevVi_m5~@~
znk{58x+RDkd@DPpLDuyv(`t@GB<isZT0ta{SKDJ>PfSpQq#aCBe=hUu&^Em^58e3w
zgXR()JZ5%{9ICvUOpZARVSb!mN2rm^r5{O9NF_kr4TV>2vD2tn<N`tB2Oty+L8yBB
zlh4N{q&)KK0<V?eZ`%UBQFVQ5r^BjR{{ZR$e=WY56qE?BNo@_fv8y&e##P)jh>H;l
zRD}*t7q{WJ*Ez_Sq;(1efcUgN=mdo|+?%hV!a1Ge>52kOO|T9(=Ki~WSnz3`I)f69
zR3fvTKwocNx%lTt)iU)l%_|{jLYu1<#>3R&KThjBv3M&3M$GJ`u7y}yK9%)2RitS8
zf>lV3X;g;qSLP$Pu*p2C;u7H=Lm_Vr0Yi^ZTvX~(E~R9RSg_f{4tAr+@4g6pIJ`Mo
zKp=oY76+lP#=WpQ7mN_^uf*4=*`U`|@bACAcDm`>H*i#o8oL_j^cloFN`YxmIrFdH
zCu8_+oz(Q=ILMc2l1&l~j-Ewr@ceKL5wpiM=4A+jNLOv>iUbbzh7PTr4^3_1N_3Em
zWG<_r>&M_R(gy3gr;;HV5yoYDAwsII;9sW$<&%w|SXJ~9FeDMqtG)fdv{q25(+H%K
z#*iX}Ce(s;QK9u8j!&qao?`A!<gh8QB%AqXbq;0FXhs5n+w(%dOm&f_DKf5-p^MjW
zPV_z-WEAPT1?wb;G{O{>w1<;r0B%Y7S^8plvB1-+r->O-1?@wHJAHmwU&Lrs%tn<I
zyX>L2<JWBO4mE~Ek;S1j$Pb%wUw|ZW-ylZSB1&{EubhB9+tnY(@y=q>#3E39wn~$?
zb6|WkN=Fe08GvCNhDx$omd$+t-{X=IiPcP>`|`6@P$ZBv*Py(jA~?K2sUw)tDah``
zecy(yujh{{GSbN7LoT3qs@zx4PI8%gR8?AV7!nTv@qd;WWia%q)JCdgieN(#d|9d@
zxxc0ZLXnQL7oNl;mO-e2WD=t2*Qd5jKaLDyJ#45zZU&L5zJK+cVU0R>E@T#bo9#p2
z;zn33U(EEu@2G%jET9PXr38cSY+tqazz{46Gz{fTEN!;kS6vX*>^~e1BaVKdS@obA
zl~(kIBa!gq3{e|0POLg`O>PFGO{d~5axW+KKc+MwPA=%szo{4Vz?#SklJa@4%R<jL
zjT}tVXpKu9M(E`_Sz<2X`d=PUYyx&7t8ww8oUJ5BL1kwEpD+Aq5()SYFgvY|F!KKZ
zEYi15k`-SUchWf3TU`&&6@QmmgR;m|&1k2ATMOFvHI?c}>CBL%f$RcGHHsD}`rmvC
zy(7bBK?I&3mOnEWe<-qQfF!efQ688PZBndgp|!Uv4?6$_4*ca4tUWWp=_Q!F%D|fj
z?!Bn*woK>(+>%Z3HYTh5emLm_j*_p3eo?8Iaa)@D90aL)h9Or|Hsz~({{TPd97tLg
zR+^(MHAX+Yi=$juZ=L{-LK4J)qzY44$Oq;}*AatCC6yHsN&B_3*}5K_df-+`7Fc?C
z5(EV`7Io%Ju6`6~VDTO>-9C~~5LBIkqDVFHC+m$2az`0E_<w(L0lk2tNBoZ-gXfLY
zo|<zgl4&E+x&v>o%m5eKh40?0C`kH(#wlWE1|dan-0*vHcKG};VVJh@4KgbNi>AY6
zQhy7jMGAxsU@@)B0e>Bh53Wu*qlRmhd{DL&D`^+K9y=N}kat$kB!re#ZsawBI}_O7
zKK$W$U0OpSw{lz^BXP(z?ms*oXNKKOwGV)+Azupq=r>!QNaK82-gX`#npSXu8~*^Z
z1ps}jh66_H7MR_H-Xf1Muwx+J!)x1Z_T2hjEMUzOD>PA^OjI{KS>MxY7`oZUqIU{O
z+UODc_-8OL3P`}HHoCalhxz<)EYQmW$)TO3BTSS{GLe5Df0iukDjja5O|$Q@V0XR#
zE0XFRWqsn)Yp`ASp|`^tB)Eyv(mgO5cc2B6b=&g5((!c@K^!1C)#6Ho5#}5ntN#E7
z#h;^f>Z0i#qm0Snu|L?Ls3D0Ryu|UwW?6Mi&nRa#q}if2pndy&F=lY=<y<P+rCR{~
zaEIy=UV@=<8waOWT5ALY&(mx%A!bA+0+JLeo>Y?D`+tm9j1|%YG6vElBkqsi<&=(C
zx_+wS3)HTgUlB-9#Ba9TZ|!5az)7QanH6M>g=z&J_8V_s4luZuLa)@jYjg^w_5>-=
zK3-qL3~^{B)mRWInD7noJ$C%@=j%+JOujaSjz(rGi{)NwhiX5W$}?*xVgOgMq;@{I
zW*Qs-vM~e7NTNsf_xNQc2y}%2j|?yXfI$Ea{)GJTWDb`PgwYX113-rKyn;*x?3AZ+
zFK}zQ%k<O9(>yF0kf!Qa%4>h_8;;`t0LDURlf)-j8xXa*JDe`As@x(L*b{B+GOI+f
zL^_>fP|*|1EfPB#y{~VsNm?@6qDNiXthWPd{eHQoQT+E>?H~TyD3$yuzyWr;18(^q
znljROVM74c3$-X3Nu%1x$Olh5N7TPj36?t~f*gZJ>=quN*S+Kngrxwi6qhPjzoq4%
zD-3`U<3x92Ji5oVj4LsU85C($asvtknmv#Bz-NkRR^^3OMU7<?1!-V3l0FCV88>Ti
z$p}SCAh!PiFGJk@bD78UTI6>$!&3ve1JmLDG34-!Xyi8p5?aA-b``b+<apL4(-@*b
zYi-H&uTOt$iAFm{3s&~Gwf6lnf};Nbb?OH1)3#C~UrKnM5U?+b7r8%6%7p=59m22t
zh~$g^0AG%Giz2F&0CKi#azP#avWe47klRFby^$|s2RrvWjFl270i{;#*Ek&!pfuQE
z3BEp<AbE8vtA$<3B-cKt<(xFKC^V%-f;m3lo;yGzjalO~>aK-az`lNaU^BW1k&JAT
zf<a(Fv7}bjw|)EGBzpREGI)D1C>U{MZa#<c&X|^Y9XsxBuD%0~*+?WXc!*<UYaxTE
zJ*bWNz?6*AQ!1Ay$!GBRVz}JdI}ipl%5;@SA~!npR>7<N^MOh61cZq+i+kSx0C#~&
zV2y$-E?JGU1|N5N0{i~}ypkdy9yf`i&jVwQvl0`-PzpBWY)$%~-#8pJY{?)p5wNrO
zdmX+w3ao{+Q)xA}uKvHjTxiryB#g{H>0(GUPoTic#kJ5jwnrZtz|2Z{HdPg1Q8(D&
z01-j%z8Gea004pp;Cd6bB(dl!tVObdX@Q`3!mM<Kr6x5a%eK}}J^9YouMtO%+-|2~
zUcVd-Jv?#s4}DXJB2^$#-LO(XtM5a9d(7T1g3Kd!{{Za{bCeR`xgh@laU+h{d_N49
zW&j%sbl7f20VKzzRFAt_yKXQr0yQA&Yv6E4t`<^(K+<)M%A4E#^MR!ZN+Kxog(sUg
zb}x($QwT-|$t3CCkFm!q8Z#YXMd|<oK_m3ZIxeF}(E8Ez&X-fUXSHMIs;r7Jy#@ek
z)F^^G=R+c)U1wH<dVO-8JZRG?qQnqNgIjHN?~`Jh$t&w)zEH2ey+DD;uUs*(iG_bt
zZP1KoaH@*hcij0wJB_#Rl445-U549(UpyeBw3<PtC!W>ml<<s;U<(7b`+DH=f(m(;
zPn*<xWsI%U#$%3R71vXEcTKk)y+}AzmOm0UVIuzkO>BZ{_pPuZ$l;``09n=FItHm0
zqVa<e1Z0w1&~3gr;GHEw2T%Z=JLCvhmDHlP7Dfl^<&dX{?;{~JT-|SfpRQ=>8a|?6
zli30`R35EINIQz(zi)<5#D$`hQnO6vfhS-+e}1?^O(|&{6Qq;5{{XBS)+YrSB%$4X
zy)ZCRR)-w>j3-HQix`WA+?|i9zg(hwk><MOV}?*Qscl1_L54u`Fg}}Ylkm$>UFy%a
z1y&O#fEjIxBF@;!)2fp5+Myc-`_@4q*QRt#A#`U})%k<QD<K<cHdksm3RP87sf#Vr
zpSo|p74X9ZB$YL0w^RD(LeYlv+M2zE+3k2GPYy%Ly~fpG@qyY7y^gR60{i?12MrXz
z@nz<{a7bRY6$%*G+i~rUEP4uR2FS8`zkCD_s8ex!<)WDs7HHAH*lOacxcqMu!e_l8
zog&Y}0;m^eo3K6bIgvu%plh}XBn1&x_U?E80IcG9u~pvko*I;}_Ec;J1^U)QFNB>-
zNfL_;e7Co!Y{;Y+C5a2^g@^{p1+Q_OBNA>64(HPX&_IUd0g50uLiC#2{jVjc8x5!u
zcRsk9hP}lD&uq6+s|xr9MxfVvNFxCtcaA_~RkN_v0sQffu9&j4V_K39rTUDMl>h<_
z`kbYPfKg^3n_Y!^Rst@TYSgPklbxWu1wp8j*l&eo9uXUz{W-;sMvaM6^1!Kdf=h`>
zt{H_9{_-yD@2v7p6guQ8%1I+__&IWX7>bHlJexMd13Mj6zni(oXc|2snQV*Z@GZE~
z7W?ch<MjYVF;$Sdk<C`$JP86(@5^|?MH;m!BeA{?C_qKn_;<oYjYv3Kt2i8rTswla
zo6{bC9=HvV4Qai{z69U$yabRa@HoH+ZSl~RCf5G|Ombsb#ZhkK7gIUZPXdi?wgR=*
z`|XEUhCtfuk=pRHkmqt#iW_2uB}-8tZGEr@JJoxfHlyy*q0TUoLWE&e++u)iH7y^e
z2PtE{f$xNn0Rc%L^29ufBY(pQ1TVG)`gw;=vL$O-7PtP>*#7-;Bq#&dzB`W+FAy|f
z16nVCjx1q7S61_b!R>)Mqv$b#WTQd7FN2REl6NOa^&wV(AEqHY8g2VvSs7vvuX4au
z9f!v!B!R1H1A*y*Y&GcQae-NDbMV0DKn;Vc#o^VY`D}yhfH45rQV6T`!ogNC{{SoG
zcffgJ@Vq${l!*n>n<La5m<Le<(-ach5qHV-!i2_2AA8pb<|OQDuqmenYR2OjY174%
zf#@(GR@`0`V_y-f>Am(Cx(hG__vZ=IK!9()3$RUmh6DISTd1{OZ_^d`zf3CY;psZH
zUdHyXO2lDjZSaCs6%?x-UBMW;``^AiMw;|$`0t9umN-xYn;%?tdf0(n5)LNh;{~Ro
zJ~#o_PZmMW&~(^4`eEO(+Wl}a;<&(K&JFB+@k^8C09FMoyQ$cA&ils5_}0e=?Z)P?
zfo93$k$~REdcnhNei&ETtPA0)sROfF?~tENN65!*i6X1_dC^Vbk`FwOYy}z8$tBMO
z{BQwqTbmt@HQL#_v&XJXs)MAiqBu9kH;PayQ0D$P6)w^J#?sxr1`#W|yNymrt}ky~
zjG+RpwXxic0%o&bRp3`R8enr2h$FpE^CJUE6lqASsT+1XljuGeknbCKg}o?lPqpM&
zh?`~ejgPms1I}7WDYmhD`g+!07p<1a+!kKr+aVmUAZ5}O4&>JOz&d~mm1Y-Q?SMjw
zq$)VAfd2q_tEYg8f;P+#7m!&@bjz?EiQJrFGIdT>ysvi7-TwgAL0Lpf;n3^XV^_a=
z$;BjU>?Nivz~mF}k#PPdkf%zGkNCqXi?tN2DTwdi0T*1(R5rx?2RUXDL-%zv8v}YD
zzHsP`&^%x(0CgS7W0~X+JareCgFsg~Lm3!LsdZh|fxcKszx%Ix6jF}l@4v?KJvl&(
zWZ^izFFFQk%QaY|M2iCgZ7J~e8`Mu5lZ_LiFjftx{{SBNBfk-g0b2v_+OmwrVsaP@
zp>@q3*aA?k_h?rudu0SGD+Lcged2SvL}*maB9AH5S%vO+`1;_CP5ikkq>fLoJfGie
z1Zd`I3$WR@(p!4{GSE$~LnMGLttzi?mIxbD9}|nRazU0!SR(=Ey<}B<ur<t#le^9n
zK=U8`jSanfjKkCtW74LSSJJVjEb2imrvC92cshb%SVE0NZhbl1<B&XTS4>2x6;@9k
zxYNea^&v}GUIEBk_?|1-B<gQ`dFELNV08Kc-`4_)Oysnzsz9Nu+qcgaPN6!7Lq$TG
z1J^jJs)x`@)lu$p!I`2n=~(xmd;07-z=X@@1TfVlkXY|ss1M%xSynkARRH**hTh+^
ziyUR9wnlO)lD8-PVn)p5vI3`IPjY|jD1N1<WBj+3Lh^55eXF(zm%~JAT@6atwxj+r
zWhGSTQb;-pBW=46TyC0pV?nJ$u-soCOen~@-Hnq7A#HZOxERYE772{43p>!D4nw9=
zM}@AL_tZz=Gfc72DD@j43Pzf}?{05y{jv=6803`B+Xp1lEm`&+nOAa=Bf}4xBVpJ6
zL{KFDSs9FLDgxn^lkS1{eUGl&{POTS$pZ+gNaOybx|)L#$L0lPM?{Mn1wKa`>IZwR
zz7?6YOA~l@#;j^y4R!~;WoK3XVZhW5o3rHrk<Y^tEgFivhe+YV-I4vH>M|;V803Op
zpg4@60b}H`vHDrY>pGR4RFw?C1PpfqyAQ7z@x+S7RM~xlb_Zf_)L-vxi^jbS{t$GO
zh5O)81AXZF>~MwZV^}3Hv#9|`-R-yMkm;OAJU3?8P_N(b<(gBaNaTs9Agh9O-y85x
z<MYnyLj*d&SM0S%bNTatk;sfR>vBVJe|zWKwpxC?2Au>UTqr=+KwdWk;kF))L`yRT
zD<Vf=gIZf{&(4R&u^K2kkPMDP9>;|E`u?X1lNXjYo<htR&|}>5UreV?x}gWdRdP)O
zxF)##e;l7w!Yb3NPZ2MAzfQ*%KA<XUay+A8e}5belA)WcGBYSD6f1BW;pjH6fyks2
zI+GGIE7Wp09=p}{z42mk)k@RKp^_nLybARAWd~Q(MbbzaKcgctUOx4Ij0}B6Mb&s>
zjA5>a4Vz;+p_+YFA#i*s`S&N#3m>tO@P}0{rB)F|r8QrtsrRpzKUX=9T|GM=G4oKX
z?lvD?{jf8TU{-Y+l(vz7+szNA_`+i(WYOpEH}`Bu<WJWMtey;Hs`zZ=g(sh1_ku~o
z!bkvEt0Qsn^#1@D2pk!g%RrDrHv|0T`iQxNhFK#!3*N}?eR%jA%(F!#x>&K?d2g`a
zH1yLtbx<;C{+((rF3-6AJ{U(s)2B*`LTdu(p2ya|Pi*Pf8BhgO6-=wS2Fc&w^aBk2
zSx0vWFMe;!@A3D^_-h|VC6Y@r5*2LU7EiYzVN`-v>sgG%2<Ysz0-b>UJ~df084|o~
zq-h5Bq9}ik-uPqcDP_~873r8)q1*nwu_k?G%E;2YolJd6+@Gxv``9fc)eI8E3}r7+
z19EQf^7>>8EYGRDg-O&#<d4{|iOP7t%0yu*OR(PiAAf+qnZwgGa|vZ=ij~qvorMFr
zC-?YZPDuO-!cOc$ieRVi_ph%%JfBt_dWkh7tVy^Ec-wA1BPs(riJL$#Y&`()x6}4;
zLT2h#K9S@K3leqg6S*hefcjw(Wp_j6y(y{M?@y=bK6t@cfU*N+LtlQ|53Y1!ksESM
zfKVUWFViUwsLGAhma$^a+!O2$2P3Qw8Od0ql9(ynjwpUO#xXZn6)OdkW}&cSzQfpL
z=TkD5Dp5fS5be(&I>r+p1SEkFmI>ls;8*3v{4k*?7Q_?btYXR9j~QrsH`13Is1Bn`
z19U+o*Pt8x#$}CKT@KHw73f(0)gS9B@;v=Z9a3td7zX5%-1=Gkusf)UVx42@nOP?Q
z(A+8RKTns>Ezot1({&QKD4jy>8=4_#n<Mnh>(dBbwaCh~p_q%Uukpp|^!TY5T_k{{
z-v)rJ1J-op1eCcRI1(MfBFWtSd*cHfN+4ekM652w(cD@29A<^$=_QN;5m*^-V_?t&
z=6D{MfT@xgyhZ?RsYc`2518KrVOZdba-kVn{4uF$g#;4b)@zSi^~pl<{hskm(6rIB
zD@wd+U{1jNj{g7=nR;mlh*-wV<%W`Y`gh7BIDoXS9b9;Ep#I9Ee+|#q0i>VD6D@2c
z40MY-1Hts%3;1S#5qgFmEszI4_<_Lrewf+?vc~Niy+*+7J-%J=!m&M&29xDbPWRsZ
zu!Gai=cJM&87nIQg7~g?_#4Xg1Hy_xk8DvWt#5QlKRV2vS5lJ5L{XKdq+a1judQa7
zRyg{XldMJo)VGEQ-fHrXg^}{Whfl6FS((>J-<{ZRx2YDV_H$eH9Y0Xe&akQKBxZR4
z*$@ILK=uK>tKpLIQ1t8qtg2XrAKVE90q_@p6YY}GQOz=_ArK1HN07hg>5)kyYI_dy
z#-uK-{NE3m!pq`IAeqEys7eFhZMgN@HS~YW4w@#CSy0Hw#TB=PG@Bl#?{EBbJkZH9
zY@LjaFKYDsD+8((>S0n5!BM49&?dIC?0NURjJ-U`)<+ahuOM&(DWDtU`uk?v>H2kz
zUKH{AMN^~@RgIEw>Icfb@=<jttrE!^ldYYBK1RMjQU3sWMWjxjr-@>pr_(4JrDffK
zqw?Ot`3%N{OA?YiD2Bw2=eO&Yh_Ihb<S3StQ5uL+yBhVbFwCm5&K^1dHiZ?XPT+h-
z#{pBpi>z3tkjV>`4J>B#jftz|jJ)j+P!PuvUn2kw0>s$_k4mq@F+_$|VyZ}t0KS)~
z3pnc&GqJnUHymA%YummNorv)4n!mkSt~fM!v8pSxvW1fP0PnYQcKmX2h?023+KO5i
zDlUbKuYPfxQ}qN!ij2z2wrZ$v`r$<oJkLIo(a~pDzDN5bC)G;8#H|X%qA;gPK4Vp=
z-*Pdaexs_9<_x+NmneSeHGF^fBX5R8OX0}LBxLRwS>V_2>40IA`fno*w2-QPBkB7Y
zLj>JGVGsm)SkTmW1b!#;7#Ql1!z_*AY2+^VTMwuL{&}nH>6$K<exyk(XT(JzPmzEO
z)Ij${_+Vs?Rf&lyL=Q6d8ww}ta80IpmT6oC(_TSec7WT|=C$#9Xn*#>@#AVuAd}AL
z(yX75#EbgzEKn$RjSSA<cd=lfK|;UY25{aSXU2>%Y6KHPx%~zsti3#p1xBZ0x~zpe
z*WxjyX&fYy62XWeM<i7OeuweHs*H^3Qf(O1+Nga<z}F|)&*u_#Fl%6sraC`(8UPOb
zd^0e9oqDy7SfqHBj=d&{1OC4pVt_N45VnSYD+}6=<og0E-|^|AERq<BWQ5bWJcG9$
z{{X%)32!wlYTi;zgpeP4y7~(L0C=#(dVt8O;z?>l>IxTe>)U^>N2NuTU(Z1SCu=v@
ze*N>KW@n#3uxrYvwckF}KA1t5Tc~MS)Lq7>Zy_Z7_sUGMySv0hQR><ue|LK$;0FHy
zAC7lREMh}D#3l<&V|K6Z7y14;-Czl!A}Kn=K=B2IJ;(s=cP7ua6$WNyjR-O#gJ7N5
z0qfgu%Pff+fh(A&4*Mdp)F_J;+U~wb7p9Iko6V`6ii8?=VgCSih#lf+$4ci|H>g#H
zx&$9g3xtYZiREcgB#5kQ4(!E9B(U_Nzy3C7Qm?HD2XjmonY}+OaTIMaAJt?ES;B&8
zwBG*!JHJXfX%!=kvcup`laMX>4RyC*wfNv?RA{bVnU9Dhq&9U09=*GdrZcIRs0UEt
zuSlXU$p_bK#p#{;bwH9RVQ!+h^&dg_RyXxy=#0_2`5XqJ=HJx%cCU^CE{I+-@d6Zr
z%749Vk$;EFJE=nmSo8#19*0q`b$kfhD2~9Hd?fKv!;4=iQ^4Pm#>d|z!fvHdk^(8P
z8iml`^1!cCFp&hYE|V?F$_?ojKo}+JB`6q8t~QLOnhHR(K>l~~#etwc0#1@iQV;2?
zRi|-&r))hQrkp|HpjRM+Ap4+?@NeWWJF2Li)jE$9IwKZRXte`CdlE(-tu#uJ!v0wb
zKc9hW2>MwY`eeFea61Q7aCtq3-|sKf7$oVEi7t!W^SgdEUr&Yt%3@*Rs*uDlncM#W
z9rmv0jDpPOS9g>vg-|SR)I|V&cKkB`0L(y3sfmfyG#7oq90RuYD0@~$SU;8~Cybd?
z0>`qR*bOgCf+UzL#tEPp@+<s|ZoBzVM}U&YN`{<*OBJ>^>3k1-=GJ<2EwYxAaBLnp
z9l8D1EKPF*p>(0~G(GM%G)~umkVv8J;}S-cDS`6~{4wHqn8qGLh{w!E;dk`!hE{|)
zVRp<*0zvP#{=0tf1g+yLwFLxQw%&HTC-A^h{xitWBS=ek{_c17!>Xm#GFcX+e7X5^
zoU;}VsG&s_vU~o<1?m<wXx<QYXtw_0Lwfk${{R7jtEi1vryW#MA#$QU1f6UD0GRc<
zKU~fxD(m5phd~XbP;2J?wUo4sq_L#BC;&<0elER^EFC;%Wz_DgcG3~Dk5lb<0yiRP
zb;gfm77U?50RI4if_T)_wXh&*99R4Oaie1CB#Ic7`>ah+=kmxhj|@7Suy0ZHJAN1x
z>EwB4F4O4Tm(l<sPu`)h;PI4|OLe-siU`hBl~A?5`d5vzT`}-nG-5Vo-^{mvBeodQ
zIi1f??4eZYZS9y@udnBXJSF;GmS-v%U4&;;WcRyP>~^n)NmvL9q=G{FOX?I9{P#Sb
zF{%1VS|?cM)8#7X%XRE|7mpe{^zp?UL6{RoH?nGle2!5y>GVYM%;~RRhvDvAZF;MU
z?S);0Oad!|L|XZU0&IJ4zrzyPYm}(uk2kNUz7)A>&9D}vl(4%W`}trG24IcVKa>Nv
z{zUo@Oab0lUL}YUtQ@%9f%@fPRgPqRG0LhMKqNFA4%K{E_5T1EzB{i^Cr{zUqE|@^
z1@kQeC?8Gt_za4tM><0+u?u7<@dBesdj`4pua;(#P|5%ddA+OHZ~NyO1y+#}kA|hU
zW4Jr>lyvG0emt?<EI_r`UGcYljsYcPG6jw@LS2%4lzAUR&Fpe;n50t~)}_b_H0tlZ
z{{T!$Br;6WG;u1uzJ%Bf&+f5^(x^iZ4EJ6C0DlYt01R9_th79&Z@rG$SX0b3yB1pV
zr~<h4^%wNt6hh0>uTU8&q$)QBlz<5}$Qz12*fliErF04vWov8o@7tWCloUl!$kJ?A
zYtlC-{N%Mrp<0gTVnx}!Wja+^fMQPKxEOpg%J3M-kQ=kyR~ZBJ><3O)Q<nb9HU|5O
z^*ensAQ05dXfEBmafU_k)G0LE5};Lje*N*^L&X>@1yHlwd?0k~98xKp%^mrIa(;fe
z$*n_1$l-`z4FK<UKLd*+>R}Xj;Hfox@^L_A1S9N*%P+^A1|hYxuwcXQS@RR~#b%Vb
z5(;JJ&pAXZ+GdZ;7&C*p{{X!1zo>qqSoH#JLlVGQCw3%{d-z}@%wz!R0I1k-K3`0{
zJsIjcX*z=}Dxt~*ECKtZ-Fj_b9Gb?cWLZpXL}N~qwS!;h^TZ`xNd!kjVOz2EAD#l3
zq*(-YWRbF)yyDFxXnQoKh#U7mnZqk9=rvR=fIa<x0h|NK-gBfzq<KdCZGVPPtrvpM
ztPP<eyMv4*jY1UCuinXPKDEcU%Mc-0^%1e}`eG>1%HMo<7!GcXkErV;*&LkU&AaSQ
zlXbS-XF3J@ui{6|t@B>_!X|GKfF%GQbnp+Z0U|i`kX}H`ZaAaq@b~x1JfT?<a?-{W
zQloG;AP-H+KRl3=O@=l|uYkrPifjp8wEqChd;M|&Y8Xn$1)DM5U--_FF(GG0Q9v3S
z3-lhfjnp!`7LL^o0;Jix-{sD8I;18jh1*$gQa>(E0^1-38&!%mh|J|Io_%r8i4<t1
z7Mxf;&%QF~00O#+*tPAr{3|M^4w`EQ&m!z&YAYd=Sk-nfd-cN<aV&r^B#=Q1zniz|
zoO*{Lg(ERi7%~lq8++jsMe!Pxc$K|zu;)1>5v!s8?rnQt;l^4S0FiG|md26@6<l`C
zm1B-ltll9FMS-A31mk%YH;yVIKs8!|MS33D(X5iL{{V48Bj2{zW9keS;c8Yk1s$}W
zLG{}mVpftr>Z;wAyQTKOd<m<0qDD~`lSP4}&*znvPZ4}HDimFMw)rVpq|y)FRp1IW
zzUMj+sPVL?P;1y4$OMYW<WUT!iT4;$JYXD<D23Q=ep%BwV3r6_paJXe^T3icWp`le
zO?nNm46<rEbqxc9Kz6KI7&vAC(KXKh08CH3+j4&#)WS7|3r1E@19BN#bI+%3y^aJ7
zjk!8S_5+W6<<$$Ws$@IYV}ek~<!Fy)8{;z|jy(g-!vcRSpfhdvD)_U=_Qr88lykYS
zD7ztl$2m42&;*lT{q8z~6ftm}x7_@&5mwsE1;-2G4O-5iE6jUhm8K-Hu1P)c0kOT$
zYz_v2)Bz`OPh*r>U4R6ZDk(`k4^8nN*GbUGtT-p1-#A(!sS(&M(Yw09;6R0ftLwWY
z9kl0B3Z>18+rD$KP@py5#1Bt==2q~7gXPpf7rqB8E0!(^ByC=}009k>7<_2^XGN!2
zW*%D?>5n6%a=S!L8x`B(@W3k!YPyLM6I%nu-Twf6vO3O+t?$z>9GWc=kOmx)$F?_6
zu=MNU#OpC8{6e%VwG0TT)}-nd2KF~N8&fW~ELn|>M{}JH(f~~<*zc5|&pQNi%h<Oy
z?|>0e;{cy9>`!k@5-e(gW7HnbpiO`~Rs>tJLB7?4?>W-Dp2M~RtGcCcSM)ekcuuV9
z8uy}k`d}mwe`f-#Fcp6vOb65~u>;V0j51!3HC}S5jgiLY>~MD-@JQN=6(qA8BCs9;
zpq3=4?0bXy;!g3BLW&2u$$_X<agG=k-E4bc0bm_l(B}ez=DU+a7&BS3Rx9OzXcCJj
zKqBkY0ZK3@)NFFiaE4h{-i2QDGKNtbl<C`4XMn?z@9&TVsnk!Ic;9h=nuefgVGX2z
z$R6I9+dFEj7wMd!p&;xpU~m+*fEw%#vxBgVuK=4kd^4|tM<i!P36O7J90m?u79grO
z`}M!q(-%`lN}4^e)iFjUho&LZU~%v3fz}l5y=OdyfL_B4iJ^+Ayahe@<ls9pGJqr8
zEfNnW*CYW92frsY!_&s$nWXZr#<@8Xo?=Go4Q;jqJ2IOKr*6k47LAoWZJgUxUNoR8
zfvDg7Ymc4)LQ7CIeesNS2ykrP{@F5X{b5#7_pkN9;t1pbaf+5z^0I-=;QsY*zC8)X
zX8Xi>KsFcC0a)%df<W(_1%v6>oD9SR=-c7e%!g1102)vQ9YeS|*RRZe_ph#Z-Cc>?
zZ--C{6y0~*09w&dE9Zcr3JA`TKp-ix?~cWh6cAJqV4Mj6SWp;hh2P5?O(l{x?TSU&
zz<Axz($}~+KJ$BE<Sj8I;W5aR#8%{10<!69_vbq3P$1rMwynh+0M*#~U~s)yNYi&$
zfGz9>HoE{Yush)aMy-glbDGy+Ha}eDW{yDW4#vR;IGeU(z2FbHw6<@MM;HM21blnp
zQK%jMI2M=F3i_C1@yimyYkh|`>y{`iI?1X300EPZITEaZ7}xLHDhz!q(YXolz`%=m
zpUen`qW*)nD|wg-1+J>EG$H<`xfmckfH}YOlM=>~fQlBy5WW4d0z)H$6>I^$b{R;3
z@W>V~YwuXXV2@h`BCFF9N7Cb23;?nRYwhvCpc(*CwOPEHMdHjBB`vJ(Jx{&k_+nZt
ze1uy8>5UV{9hNY68xw%CvYOBo71_w|TUIJa#I&<&DmDNfbEYLHSU`BkG&v%(yr$uD
zINgA{`Cv*VG8P8)pS!&a#_)^*<!J*IAx8fImI#oox$VWBfXdC&r}F6{fL-`o;CwJC
z(!63znTU+@UGqOwS>`dqjIiCJ-RU13s3J(gY8rh7oSAP9K=o{Q7rhJ$B(2h`rGc?i
z>4F%YP)+@Yg@Hg`{{SqHi1Hl;G}CZK=QYt@kz-aZX6PP0>*jDePX(d^w2J+4QG;(p
zC>7=7Ch0S{Sfgt`UC%hox)ipt{Wb#s0OWm#rUE^rwWEVz4e)uomki~P=1pt{X^uf4
zW1u?)qA1^`<h)@L_;9FFY#Zm}fyLA>gyg$}V|xJm=BVM8*c0I{kXfH#0owBcxWQp=
z#BrVDJFs@3!)v><?}6Pzs{tBuKv4G05_Ibahgx+>zLn?aS)Lx48A5}ln1ij)Y^y2<
zb&QuGN~<=<+}G4#CsiW_0V$O^JkazW*}$XJ?nMRryl=(gpa|?A&)TbRrd)LKD2U#Y
zz?ufnI1y-xI$eoo8mMwf;?6WH5RfeNp<B#URS!(2qvJT1z^WVW2OE3j=0ycifGw;6
z_eS{y<}OvAR)j6(zmGWJ>LBVoZh5m`mTBuCjbQ?rLe|H-AIN4YXA#QUXo8>te|P@!
zilnTih$U@_4R%jEWgwYhgsLa?HGSf2FT>xR^CqzF4BG`-0_aw0MVG7a)+D_OJgc$z
z;B<_t8<uC=ZTGvfaza#rd?WzvyZX241!oyTzLo()4M*5r{#n)}0+1@7F(-vz*C1Au
zB=N|kv59GYFFJH?p;k{6c&<sHH#t(F;30GYb`r_lj!tGO#z?dqaK4pX@r4+)yx=kq
z4nA!C<Id+VC_O%?l2XvI3<qL+6ZOF0%L2rqRL9(ZclyEnw~UJ;)7HwCbvM7mfq`8{
zYto>#7HK<*-*3YQPK9BTO-hC%rEKqZIP~?(KZPGm`eX%zC?cqxj<3gT#~U<(w1P<*
z{{RDDJR@{)$vlV~s2YjUOnkAYYxd;UW_3pn(f<HaP{+;vr+v1qhdla>%OV6JT0yD2
z#DmAM%A>R~F=9eUKnrz$>hggsrfC(NmUG|Kdu3&eg2q-Mlnub%&u^!E&L(3fy@sMZ
zqtny(>7JaE2qPv>Jk}&~O_FP1ejNOUL4|y=89<~hu)ExU-ZF(?(#lBH$FT36sVFOv
zZ@nq|oBn_2I%x#bv|^Qg0N4)S6UG$sL?$fktjeO4n+i7jxAVV-AcLmx<&ob?1p+lZ
zvvK}Ue#13&GHNl26-uuFZdlhO{C_O-<Pvp?8&O!p0bc#K{ctt?p8Zct;=fD|nE^p&
zjW*wiBp++c-ZRFF8>&n}WK|-<+1&nrv4v!mxP5F8kO>Cs_AeW#5hRTiNWs|M1A7`Z
z@$L1%Y2tYLWKDY;me2Pwt?SeC&WczSgne2%jRd!bMyDiL7r^a{5Hm!qL$kS|@XGX>
z97xX^H4Q=7o_#OB`S@UG^G6(h8W%ij9gnxCC+UwLP*E9BD{BE*4ez~Q#;@U&b8aF4
zs4Z;6kiLW1aqp27l01<ik3|&)w^hC`*8@O?Lo}ilzX5=vY_U65-`!{M`s8(zC7iMT
zrlJT_d>!}3LnINIqJ1pS<*vuq;4d^s)O7Kv9uZbW(tTXroFgQV%0o285VU&0?nTvC
z%f38_l9Y@vHi4OsYTW)q8b=FqsPh%wPxju`^!)Nf>I7_P*}nU6_#dtm&jf5_NXz&@
zfUMgRYjg0s#a9UoM1Z4p<8wyr`(1rLIeBFT;gB-9jeN)s!p|R%@0=~u#*-avS=a~C
zqWKmV@%dmc^(E?V^>Xa>$*cMQ0Gvb~98VPSs5M5<Cwd=U{utePXu6-})vLodYIX-}
z{D;#U`CT$WDU(!FGb(8twH?o{_qXeSKGF>oo+_fp2}RHV;cS7oy=35)FA*E4Lg>co
z_tSQF^**@$WPMa!L-hSbgUCb#D_vJ@yA6&Of;nW02wTgrEc6K^*dE(e{12uOu*g<G
z3u#z@K3-e6`R+~%9bA(-+-VvGRVK+EpEJMLB$Alb%EqqO-@T8>Z<<yz{WOv)pm$>s
zQhdaLy^o3fFsy{hEQ%SnQL~=Fe(xFKVH@?46lkK8LI*pz+}(cp7-UTnBxlb-T&O&f
zER5PZHI&Hn%pxo`gwwUP(E4wXWsXN~fX1SRyV9eY@A&>1(90?@WF|HP`e2_m^JCv(
zh2<SIXQNSUUsFh@&0q2Tepx+E6icLqHp<7JPo<yTWe+o?vAcujZ78v^-hkZtcA@Q^
z)=sU~sDcR7N@ywtSp#<XlX)_dG?6xiCsqFd_P6i*^}(q1GQ8nD%>GmAZvOyZ-QXUg
zH$@&Jl2q;i<oCRF=xQ+{v)oY!m~d^406lqMsr1H#!_>1kQo$K?Dk}c~aK7j3zD6{V
zD>!x~THgDgPs;&XNkcmw2)pb6HFy4Uq{k#^KxHQEf8r{?0g8$yXqb^0lKjVTdEUEl
zar%Cp-@)^%G=Q%(7WS`@1pM%hXq%}5q-BmrRT}oPD*i(9CMceABeF=c4;-Juv!&`K
zpTkyALh3~TZhMpQyh4DMa<3g#(e3N--vOh7Q0Xe6P~fVcQ^EZI036pU8T!WYT17>x
zl0a=!U_T0>=~%AJq%>&B8i1;-Y_R|meiy!IpY0XumR*AxZCd%2?_z)Z?}wCNW0R&Z
zC;?l=G{yTUHB3H4V#@}USZt|MY_|>j-weqhc6E~A)!~L+!)!MCeKV%&m#XSujS9y4
zllp{glmNe$6uL~IV@*X9Q9;RO>?`-qRwizpSO;Z|mh`US$lxEH{c}8WmUmdHj>_aw
z*xmabhHGw+BNkaaZl9+F_=;!{8<Fuf&#1^E(63L^kizHlYeTkx0I$UU2P7j{0>vWe
zE{Du_+qT`eAC6zBZw7XON18#Ujfx;q{A%!ZQ~2)>P;~`F0d*TCY~R%1*C>O)(lbpX
zEMR~@zSmo2B@+&n)<8V&t`SeDKaT$ZhCJWZks^t8$W$(XKe&Pa09c>P%BcJ@?5(GA
zx5>a>pQ@5JNuqBFqH9(H{KAO*MhPWmI$4CQK?g{!$*@Vn9l{uP(yd_W=VAI+)aANk
z7f%OMB+_Y;DFZ4Mu_Ir9g?>LAA!bOrUZf{Z=0!UnFK~N%af{Xo;gO-1MJ6jNTh{b{
zFTiGK=W^B~QG7ApkM6SZcrv@l%1nZ(Zigej6kv&hgjOoV_Zu$-PuB#}#V1iR>SjXz
zR$eRqN8|eEMc0TTXvD2@8ulM{zBON#H&q-eO2a0nV8LB>RsoObFeM}Z05nN7p-?J?
z6gD0GPW<8V+e38dK@sXy-(WfUleom46+%Xe`jG~*c`SWC7Ba~Moh-3Dk*h-}qH5?h
zjy-lHeQ+egS?AUj>32GII}0cG>y_!}JvUmeu_K7q^hh-Zt299E>zoIP3$INXI#HTd
zeZ_Be=qkQr8^!V20F@!(4VnW|jYR!7$RZKI4<WLnT~_6J{W6j(Lbt2P3D%qt%iR3Q
z{{UEj`FUVeP|MVoI-T!HS`-I;g`CRD;li^6pwX@msmdA|m>C;bb6bKoBQ>Z~(vGGX
zG|H>txF)O>+P(HS@gBJaWP_?_5j2qo1gn}3wl@4fJa^Q{3o_Y2>WTfew*LSi595G~
zrYPPJKqa)24%cUMhA|M5QKpf+psyF{xw`F>WQmoxbqsYWCj7KXzjL+?ZPd=6)Mj#3
zH6Km9#NZzZlr)7xB54E=Jl+2QA(ernF(mH3AVLbJt%~2=IC{8YMnba5r$ey?MJcnS
zdx9%}d|3ohKZKqlxCtVVyV+1p4%_~jKpkUvqFqX@3Q`KaHLxF3dC@#jN8>UmWnHWL
zw_Uxv?~>_=OJ<K*4O&X=Rlm<I)<&u&g~(|Hj*QFqNCZ$7&fxwT2SXTHfp%9QP*ra2
z#@?J>2qO=#`FPpPg-|Pw=e_phCcZYQG}WNg+tI#v_rjhhOcj}RDRJjxvsK_1c^jw<
zD^pV`L-%an!}rO?5k(6i45fv$7va>90I#pejG8J<;#c(+DmtuyM#I0)D=hItG_46z
ztf2sPqd+YmVtK$)rZ9@g4cl>Caxdlh=5~*J8@DP4YNLOj(>6&TQaYHv&zGnUVUYNL
z@v=pce*yH#o~cZbM(M3mwUNs&p!pMC=K)q0>Sbim6ol4GH4ClJ#NbtuX|8q%(hy9K
zdkXdRtg5e%Jj>Ihz7&t)qPO1O^oFi?1L=dNNLo|;%gD+_1V*k1*pq#M{4gOOP5o7m
zT7-HwO;wuwF~*rXHf0JlJr}<@uxJ74vHIeUn8*M{1YUr3Rg>}k?T<H4;B?VC6>@KK
z2qK$pju9pbCR+=nE~2M#u<!ftnmU2vbu%k02qd`xL$Y50epQeHH;gINUdh<(1%KXf
zkflDfP)I^l?^XUVHFZ5t^AV>@(!j((rDQ1EI)*KOA75G-80U#)*ED`2=rq12<*I=v
z*wOiCLcm01pv)XK5zT>BUq8bn@Vqes$y&vOe&l|K3ed(G8DwaYP=E-GZVh(lbEN%o
z3dEC-5oeA8A<!6kwBH_={!T&&*_deuRT~7?V`u4_e0Q0NZ3e=k>f2WQ^Ul~2f^dlR
zN1E?g2eB7lGw{xT>c*s!RgS?<;NSZEvTYxSv+fugAYRwE<CRn5cthXrfCqd1a2h#`
zVpLd$klt2fy7m|+j8>g$%}UJ7Z;^HI^~5Do(W0$F!40_D$LMgTogoVlcOVPZ-)sey
z)fC2{I0DC}s~29lSX6qH5Or8yKmdE>*fOVj6|3JhbkLrm5QSGES$_2pJ@4bT26EbH
z#*V*s^&6%g{{TEtS(HQoVhLhz*0=mIjD(#G<STibd*bk^h%S#H1l`q|17Z91%80RK
za0^g7gO`G7`gXXcWMBX!6Lt>Y=Q=M4&mW47ApYeBwgcDq#!$fC7mXZl1b${9jh56{
zzD=A2a+2#`6GolX0r$76zg$;WRVb_oyE;zCZhss)b_~h@d(~rLIKN@Ob9C~?T<HvB
z7Ef+K$Q9+dRRH^|xxK}n2h`&o21PP!Vh}HoRd)QZ>yQfG7%V{44{z5i4DzD}MqtW8
z)vBoW+~rdzgv?7Uf-)GWunmFhlMYO0!dZN+sGHe#{Qdp0gtAIRYz%>KPWz4d%A-F_
zll1BvOpK<rSRh#!T=qB%Bz_AY5r_-_0JNi%WRI6~k}*jYN}5ig_pfX8tYq;PWtGWR
zu_mB*=bU9&+GSUENQd7e&7|L9@EAm5)aoPf*6(H_jrwCQsGdbu&<g22>{vB_A&&$u
z8&FXqfo6uP2WundGSERERU|N|k|0rw7UOFqkC6N@sZ7FkA|whKK`ICLdt?O7t&yVv
zSXPUwHL?70!0=@ZYz}rmEwbHsf_+o;<%2hvsT&}=pl^Mv@$|@v#L&dZQBb|}CgXnp
z00EA|DF}&3+Pv-ntLEzLSs5aM)GSfHv0<-$_n<yl7C}|!1Pz<L{{Y?v{F27fGsOsu
zg%PcS)(+r&h5T`C78xOR5t2g<K;2f{ZQk%jGLDhZq49Ntt7_9*f@=FMeDZ!9OSqzF
z(XsL0@xbJN38Iq8QA7t8EFa4s#tIrrMwF04?`i4>*BN|Rf}#-AK{2re8YJ<OW{^g0
zN13dX&i?@QfZ>s0S7t{gbSN8<RA`T%KO952W>pFp@7}K$N(&^K01dr=f0l7|RZ@Yq
zo^q<w1n^y47L{Zg*mqtwIVMwE9c8yCe*M3GnEg6N7gWX7OKi%we!mm`aRkH%04P>A
zb^!d3Y#^x-TDW!|gMfa!<3vGIZB_x?&^z&19yt6UT2@&J0f85{s5v4l`eI8$dF(JM
zQZ|iEOCILQ78~L4;N{+U<|au{nOl>xs|y{4R@Z#<nN_qnjp^c6;Bb9wIiEzXK&`yB
z*x&|40ZKKo8{Y%l8YU>pRlMNpR~+rzCUuGrscT`j6m~+aH`C^$!N7H9c=Ro;UaCE~
z7x`qA?no8CW0gl#0MauRB884e>4~J0Q%N#i5&B>hEL(7`Un{I`p->3)7c5X20}c)L
z_Nu@N#?A)qLac4@&Ur&1vc-jNe}0vKo*|72fqJOz$Ri$o5y~D0C0vpN0jLY_?~-QP
zfULhxS}4rRR*s_kuYHHh0JKpV_H+uu%Tc8@b&7#QA#hnw-avfc92yzRIs;m_E5-=O
zSxMBC38LH|Y=K?Wu+p?U{{XCa3n8Rsp<r)UlrRy~_|yO=O^;gt0C}BOMsiovx2L8B
zV+rB6h}th<TkqfV$hMY!NlH5mc%~6csHAcN2r9#FKRjatFHSm*NXTDJ6TQ{(^U4r8
zdPBhA40iBcv_zYHcfsL!WBQtukQf8~z~EFOKmr1J)9Zi=suAY*^7h68*xifVvkV|3
zNm4H)?RCHX;u1-wdjja4{#YF(uRF82)a33)Q^9R9$`w4#LeD277#fbN<6t}Ea03V2
zQKNxh6Zxk8tctW*i;-4qjlLM9mXAqj&gcICwSpMlcUZ%P@fZ&=+vAgXnOvndplZGF
z7yzy22ZQqe09dy~4YGg<Srikjnk4a9vB*%C6f70`^LP}LvvlYS-SAH%+XJcq%n4;s
z0BX~}`Nf>6AVj1@cNg1>z{HwDbg1^g=>%XQReS#9dma0FVUQ$_NT}3{1AnG)1jKh5
zLsee+#wc_em4ge|kG=l+z$p=!k~Hd3U~#J^9d--=v-hhgtUxOtm=13y<f>`go^ULV
zBkCh`VWz0o+Z~8MAJ-ObGRP^bPTp_B97ExhNr78Xz^!fwzsobRx4XXk^MKA{2o#nq
z8+_&{-e9K5<eUM(ZPashfO)pupI&PL!<f@%6n6u-KG`xzCv(3(`9a~DG(h100Gv%U
zXg9gQZG=04sGG2H(OClkR2mgcw*LU@Bjzk98|Nr=iH3#L4Q<D41Y@PPAd$A+^OcI5
z(?Yk--CF1Y#xtEz&;!bOu5cO<vBn+7pu~#YemOQ_$XXm@#F~@_bK&;`vBhIRry5T_
zxC(VwH+`_hBS7L%sz@hhTLfdqIdb7hJ69*+i6aJLM#HzZ02ag_Q^q-iP3mRaeIVk-
z#YqQo++#DdusT3$+K)H}7+XnjQFM8LJfDV5%M+;XFtah#%u5sa;d61S00FxMd-lLB
zKZv%#nKfRc!5)|iBo+zt7=vSY-Yb+5sXA`!-`4<8Ah!E=z;wF+29fWKP=yXGuB!Op
zk-S5%NKktLLj$y`kON-Z-UU-ckz()#JMqPl>y8UJ)2sv=(e=Oq2Q+pY)_0k;F+2Ww
z&g@AlH$2dxg6WR`0QZ5!2Cb<3VwN0M5P$C&s6TbL9PNOibhnvq_pIWgfxdfV$n7m^
zBn1>bGJFrcSRCWcyItTm4pUvO`b~E4h!ohaPZ$od23rT~it*^!8^26qS#=<zw&&Lo
zPLd6hJunqbH6Hn=s_GJP9+e7Jbdo#dPnewwXmg8OZ@<R@m(Arn+2aI^FGwc6Fm3Og
z6qD#MI`ofP&Nh2zebPrG+c|Xrc)$t;ir{5U0jF?%@d|>rHet`cI<ZvL6d!Zj0!Ly6
zQSXcx4eRH4tlG}3?!iV7##3Bxio2UXOgab_encEnnz*xpMh1uvU~j%51XTiat6)VF
z>3reVLAxQnMh9&}YWe3d1XvV3dA#BaZb<(CdBNL7Sg%gw1M1?GfB;ZmlkoWCv`-`I
zcGTzBU@su6rXuU*vsYMvNn=qYlgG9cXM#fBMzsf?0sjCw-V=eTMf#fC;fv!tk_p%k
zT+-4q!l6!%_1xf3chaPJ$ok$}zzhs&q>;;ZCltY;EfJ}?H+6zZf2^8Lr5g~uU>K=M
zgs?TaH_qH(j^cHZXkXnY7pzt@+R-G7J%%&Ks+^ry!R>(a*0yxEW3hizf)IhUz3s{M
z$%4vJUdE~*dW`9ji-jhL<afY%x|ri|5eK!6zL_?EB?h}7VU`7qqm?D-?0GxmN7A^a
zKY6$nzvF?%DKr8I-?x9BS4^?Q3xWmq$g-HqQTzMt$<C49W(BMPTV4eNGnS~xARYPn
zoL?2zMMBgozhQ<+7&}QC04ltKg#o$D>l~7kE0PNlLzBh^j;dhbG<UVx7$b6u5p<Ku
zzwO28$`Ad<6gM8&UrWZ)gJQ{R<dcDJo}#5Tbq%YNiPeb-y*^d!r*DZks^>|O>W~ve
z)%#<3!H{chiMj)GfUzqv2{Y-8ki;+EKM%tP@{IBmx`ABw_s*RN3ii6Ys6TWMT(b27
z61qaUApPNW?_3-Jp?q!#p|$K=-`HR%$jZr7z|cRANUK9OvUQu^e5Y8TM;yAA*q<+T
z9{sn#;~9RSmLaSItFZU>#1bG-?##|f=VE`r$J4oHVnG0$fD7UP>IgfL>wxXlXk+1@
zIXks%1|)Kc1F>sv2XammQ7ov)NPoIWs~BO0WFmmnMGnAVbEA03ScX$tf#H5QBZ1@|
zGk~#^WL;?&Tw}2k!fbi$Z`!xq`|*nE>j`MskjG(t@0^1De?U5DBGOANo0YpDk6)4b
zW^SG2Ms-u=Z~?B_sz+#gJrhP*)rFIL6TtcAXJn72q5&sm(mC}$=O_!)ER0E%4s|tO
zAD(eCMdb5tz5P4>{jqvk7)W#mO<=8#+i#a7{{T`q20b8)E4>5X-ymh_z>i!_Zb2k_
zcgevhC{{HZnCT7w02}Y|$S$I~M1?=(eX9>kCx*Ut;Q17tuhigbl2(LxHK-||2G{O=
zNy#d_QL}x<2FSmr1&T?fB)MiDVn?qwbB|PA6sWy43wn`wQF3EhT7pPE@%WFrJ^gWd
zcJS3iq<}$S2XY4Ajb$d4WJK1M7PTAu$J61R;)RV(SW75t;4kpoDkQK4>S@lV8@2X6
zpIXaG@JkY|nk!yo-1k2W=4j`QUsi&uK;D4#`IDJrh!xo0kV!TNAHSXjS^_1|o9}w~
z0Q^s;__~&)GO=~nyRG@h&)1#t<5?#~h&7<L(cGVx?uIlC;Y84qrbS|P6G3a!)Zj_k
zBUt9GTAPjcs>WS2Apt>^-of-Ar$2@>LcL0g{+wz;`;pzZ_~qb-r-CLjxAedV*IC%<
z2jE4YmwXJ2lJw<~n@h6T9Fet*S2|%)M6oohTYmol-fxse)<C`|kwVitjmZR(dEC*j
z`podU!{L=>CORs$_m8jT^vI<Qy+=-}2b~z(AAZ9YKR1W~B$4IPXy3j+MIVa<u}AlV
ziXN?ee0j(`>XD<t<&x^_f$NnGCyK0NO|+;4k^tMV&F8C{53`R(=@>xXHCNs>N>9KO
zUHr#9`8<r8!5V(}y~+3V$C;Vr@nf_}H#feK>-n1Pwna`ECJ5Bzc$B1$^}ZF2rJGZs
z(|aQBO%L(DQavigqdRCcPYZi}YW}%bo>>?<MN|kAO8)@H?vK~;z>-NT5@1$lV@wow
z{{W8PrWhHbjpRDxM;bMEBVtF>1VTuf#ll%{Vg0_iCY8E{DEHx|n)v?!p@C>7StXo4
zg@u8u;1CGg*j-?qJX)M0{lYvt<6=p#VPA%24v4N1e4uT8uP@VeArhbZfC3gWc_)+k
zeFg+#SisU%gH@IX@csH_r*`StWL+fbuowGB74-aZ%Jm63FXhm!uv;33Z$sNAdT?W9
zlF^lQIa6YdSMT2gx|no?k~>snU3b7grY}sa7Abr}7Bl4}dT+K>I+*%pXk$?+Dhbp!
zus<3k{XOv#7w{WQi=rSLE$&Goz9(~(1q_}ij>UR{#Ia*%z2Cq4$?ATbI7bXvZhZkC
z<M24Ass5yl>SaS@mfY8K@&5ogrGre4b`NH+pKOC?O0jr~fT#>e{{ZaRpv3!bYY`Kt
zi>)k@vc<}hEsFa5awQ4}W)u{F!;AG8B$Q1ghgXJ_18sM>*nK|?4GOyDGe;8d=F)cn
zZhm9^U~awDAEod^w}_9dpD>}t{(lU9ouXJ}ZEQM)-2vlBADK1u%>EU!N=Ym%o%uZc
z{{YFrXu5d}iz}&Zc36MH%~|~LuT3XWAykOzBm@Ux-oCrzq`g5R6edP4S&$uxu1~`I
z@%6#c{h=}Gzmt&MK$jQEW3eaKYp;$3Zcd&@8<`mGUWecJ&OcEbM;wUMWJwKGQSD>#
ztXUO$$)uJ|P{?f2<6+0js|J{fXJ%li6l&+pM<1Wl2wt7Kb{eFC+ff#8w%mL6yl7fB
zmO$?43h6+<bTO+Z*bDqJ({za(akMYuNZ^)Q`=D>P)9}L4bjqYKcj_fTwgA!^$EW^3
ziNd7>@W<0UB}pMzs}9F%{49L(!=!KJld4xpklaKKj~3sU`izc<7E&NA@hbpGT4!75
z*zNe_zR~MM)0PNh14#-F+;{vije1$<g}Qjb;y8_L!~hAea!zJ5O{gZ2q=9;mdj|7V
z6T~DPK$caGEh04UTVKO{{v>8zq9y*EjK|LyZTJU&-^TJQOkyz9#4W_eJ2pum4gEjX
zWSoC1Fp*bD2&|;?Z-2`gXxXKI5Vg={wWeWPe5-uvzpK_K^E!k~s$17hYzL*+<CIMw
z`G#15WG`AT?u$H}69qsSSeaVG5I7V+-_sB)tmerDPMbd8^^Y5puW^Eso>!1Xj1EW`
zJgob8Y*2y4@A~1KsU!gY7*#K)Z94&fGx?0w9I>p>#9$Ju$Vt{un^xCd{c(CerY@Jm
zVbb`mtvpEGtz-a`^!vMDXYiINA}pZGD{KpFS9=H2=zh*tK8Yl7qJIqmDz4y#unzvi
zZ^tRpcoFq6zgg4k>2;4YnkRxqk6~WG`sA0am&1_j){-&P9c_E>_@Ax-Nk>i{0;97E
z4iDTk4#(^D!jlPSpTcF0B-{WGZUuYS<MGM#(9JMdV~xzykQG&Ik+&Fnc!6hdOk+?Q
z+iI|D@;^)pbaOXHAeJe7`dBKu>g8yUZchH$oRWHwy3DF>M%!j@-q=_x7t+oYs;0BZ
z+RYD$+c_g56p}O}QPel$m=Dhay%f-~iD#-B)a|e)>5r`we<6@_Bn6|;73AC+-$}sh
z{JVr`H8qmU`e8=#A}i(b3$Bvi+P-VALAb!DQhZbq=~U7MJy9S~s_pB7HAH2!2SVKw
z-p2m`Ofv}*Rq=H?s4J_pcjx8~a3iS`MpMJOkwxvj0cY3~fhV1xsb-OMi3nxww`?*?
zEYU2Hvld1QyNjX6(uM{^nCjL;Cfb{gAOJpi7}K#zW%RDwZ-GvtLOMvwOzmk>17CYl
z+u>fh(R9x1;+3eFh}DG(J0G6ck<$J~C~Aod*pHW~8EG7NO6w^aWYUYLiyQt!0)}}t
zbd1&D!e{_ND^yt5xi|8z*$9~$Ql;!U<Nf>P(UJ)fj7msAT|ho%t<TI8h<Y_%p%k*J
zG;1cJDy(16pThvNM%^$LMC|@;U6+sn_p^B^6&;w1Q$&61)Ng;4-^)5#VzDGnOMmCy
zxWNJy>LH2Q5o|Fn{kAWETn!yJM%_T2p_VWpPZQ2Ul9mUQ9!Vr@GCeGYHg-V3DFI6C
zLG6?=D1`Maz?DQRM!&d@Kl_{c;-FOV0y?g^O%@yg-<hw+0XmMZIox=0vP2k=tk!hi
zz@Fq@D#-9i^Xdm!BjMX`)8Uke!6ZyNrz+?Nh5!`DP$yTlU*VI{3d*P%iiWpg!57H+
zZ}ZA2(?DjO5<P6L7?KY37kl>S428N`Xj)Y~WbL5d#QWFhhElyFMK4NaMj>Q!MQCGW
z0qt2Cj-+WCK_;W9?XV|v_*OuCBWeLdH@wJ>gg%kqeot?E8B}<D86cO=@+c9VR2R$-
z9l-#Po-7R0$n23^sx@j2-p2m`Tr&pgLM&bjv0*2OyXXL#7w^y00#HU?P_~GyLYHlq
z-+!IupQ=L?(WG#&4i2~b<N_&g({I4$aNZnru8a#Sn+Iy`@ZTsQW`)R+09FQ=jmabT
z@;DWkv@AN3q)2rjM;5^80f`;ACx2gtW?2+S&Q{6V>bUMbIKu3{7!oinq=8(Ld*eKf
z1g@y2NWjpxHm_a1_xRxt(3M%E0K{3FNG@nA9fKc-IP(;eaw3Q+lfzMF#-atA`2Kjd
z2{N)B+-XC$-yZk+d*ymrOdUy!TqZc_&91P-ZDZHh(AE_sk$O`sOt(C85R!swse=LQ
zWR3l@bF|#HlG;@KM<0b&S>TX$4-~49Ng9h*`^L`zdeQtc4y!83FNjMqB`kg5IsEW6
z$23d3M7==pg7|!CB~O?U=uP}{4AFVQ4bg0h^yL2loV%-dfeL6SccEl2C-cD~h67Wp
zh6I(W(s=x6VGOc>hCL`59UD;O*J1c%r7|N|h-L9q>jV2v^?!lG1A#0iRZ$#_4&s0p
z&*z3nUOt_lQL?~*eF(e!u%?~LfAaFLo;KFUNU%r%gWtE}atbOp3Ko{0%Gb3Iu4pd|
zjHSsE0&MfB@(;%(K_wecik?!-*bc)0$W+FGPWo4$?KQakFXxGDoJ2_)Shscd+t)1B
zBS=y!rO+4CYQK;9!Ee*MyEdm*7R)%Yz68u{RbG?^JQI6<#&g7i$Rx32Puus#bWXZH
z?!<0=c>P8X>LRr;&=?9E?_Rh?%<nTPmrJQtO~3>N*bk!CEQX~zSu};zMV+W@J~=p%
zL3d^<%e4{Q-}u1jL$O&SD7*dc^fn#I{{R_7#AE(kJ0whPwQfr&uTP%e41{!E(CKBi
z4e%LPllpcvC?|9Wat{9hPbkVxL~)2pD$1-Cm~Y(P{{S(OQd3W?1+oAGnmD>y=3vqX
z4P#qh<=Y-NXi<u*GC8X!`@KN={c=jEk@@TrK@VRYz8w89jR?}o6po4jR02f?j*vj!
z`(0oT%>%ZuDO4Ujz?<LKx8aioikBrxkTNxpNZb;Ce)!R-@txGhP#vso?S9!r)tWMF
zhdY2z75l8?BP}de(iSRo{niIzx7RKLFfxOwiSx!(_r1rU8+~x~2_z5#2}PMip-#ns
zY8C6f;7$!tuxP<qkcLzL02A2fK_~Kq#ZpOAVA&Mije3eX67?nWZmoZN<)VI`B#_sM
zD=5-feb&`?^cBCZ0=rB6yk<>)6WIXXliL3P3@IS#+~{r1s<7aiBacE3N!VB_7zL{x
zxcyEU7#6lr8i5*3jrqTP2a-<_n1V%{Vn4h6VW~|bF<=IT1mAnx(|^|%YgZ1h8<!f$
zQ9xMxwc4?w>Kj`yj7GXDxdUpyt`x~A>NGPoh?h+}Sz&w+uj_~Tc_!4cg0V&CV}EpA
zZ~O0vs+tfAZ#Lt9Hrddtsg<N+peSODc5n|K{jvcI%9AQ5mFVy5{_=>^J3EjWVj6D6
z0mTf649b$Tvj!wkJBr7WS9FRbQZ!%O?oRf7`1)ZJU`P?h#`RGIY<&;naRsKNB<TcQ
z;|9=3XRBT4{P)Uq?G=}h32MngNZ4`t{uxBr*2VM_RrT+cjl5tYj1ugCS^nPUzCW%_
zo}B|A(?@z1FW(AOVa}%2rqf98V*daP1<(jmQS{#fitqE=9RO_%(wL|Y6ngf+tmznK
zpvA0KMZ>#=VA_V-PdFD7wW&sDiYD@@YXjVUF(hNGhK#6U2_46MzPJ>a*+@XaeE$G;
z@8j)`l0Q$PXxRfP1y68(A1noZ+f8k^n~*)R-X&NA5CPU!yMinH;(t<A465E68X<qU
z{?0oMaW0-6t&nbZ?tZ5r1<Eq4Xso=^UP%;jogO6ekWPSnr-9rb-)xv?jl5R1V`WG*
zZ`TBo>5M(lI}i_l-DMnY*t+X6^XBAZ%NimbIvZ_>yBMZNkt0TLEL$n;2IjuFuFBV@
z_}^|m0|84G3JTQ@M|^fk6}3|ZvO^yK0KKsZ(yLWxzj2kGZlkGS^1C}5Yi+f9pMF0K
z0?NU4s7RO{RHW)$MOKlO041*W9PQf`9hJ`HiYk2w!WGF?R|M^(4sbehts<TEAHVK>
zMhOCn39h!V-o5z3v7JZCti*jVsZmX<%y}Kb_WIrwvK=4<a=?7QeCJ6MqUtrI*O+cN
zy1!lUtbh?^PyYaHY%`?{v4s+;U7JWf$if7Z2Sr^7x(4M%7RnBzL;+SkPAZLk&CcJh
zBdSLVGPp7|h6Awo$*E>E4##>J7g&5)Osc55NELkEO~$q&G$4b;ebbJD%Euw3s};%H
zx8aGZSYJ|WMjZC60vV*z2;5(o{#dMmU(DN!usP0WLKFgZe|G%gj<*iHgZ<T8cfbw+
zrV=S9x26!zv5}w!zH($~H)?)&S!-EVIJQe57AIrwa3{XuhR1!ekShi+*igRb6_iHg
z6Lc_|C{P2r1#bhJd1wK93I_x0)nt)gg9^q8rXdKveQ`iK2`qHq9=Ht@j~AIXuvC%U
z9znq*dU*v%?0e(8>HB~MJJA@f!PQuuL~M5YU^k3Ss9j4yDej{X0#2>yWny)Rc$yTk
z1XFg%f>>SA9AHqD(QFj4J5k>hh{}dnC5Jb)Z}{Vw%0884(%X6g@$|^DQw7)_J{T63
zFq%RzV?yZn_V&r?C8^0<?^lHusG1wmyai3r7sXM$0@fS)mRf-pdtsJu8Qw)ik5~4f
zpgv#Y6h!5;kacGuK6MsUZq<Rq`j%Yo1q=@4urxp&h7oLRQ68A)Wku4#T#Ke0`(P=$
zEHu?#-LZFi3_f6Qg_C8lLlJa#z>+k45((Px0J&ufpzJr}gNo6eUZmqmERzt@HPF*w
zdJJ}AAyPEay@B5U089vm^4S-S=oN_vk;W8}qYM<-VOxu_lPb!5+#gH}Aql8Rr;jaq
z<keS6ChLpsjU%+pMA-wA-x8b4xTCqiAOOH_M<)$(rAEh->4SA^6+_p)a^A%54`I2$
zEeQiqBaX+MSI`kiHr>T>oCwqo;ctIz;Gmt(l|Aq{-B#dwW7{ZFHrtcmIzoj3-(C7_
zMoqz>YKOiDD6&C66O0H$$2$>#9}EL~k-dx*!_IzK49<nD3hzMeoEU)1{ik}wu6P%m
z)Kni%a5~5Y1F_138bwuZP5iz&GpA$tXHhIj8(?rCw$>Mc?SY%iRbLEZ+SNcCgH|vY
zh+r&P_rO%4Wv|+?lxtua^eOImz(X&!b6v8=9Z>6645O9rezk-|k~ZXgaMh-xUfc1D
zum{)E8G)e0RgJI^t&_Ek;{G8Qz~kE=MT^u2$81qx-E-}M!M3BEgofBz&ZEt3+W-RV
z3M==C6bQ~Mxf#?;bHBcGT^6&qae!i=cR<3ceC3cSY8xC~TvqtYvXv|U0Noq~ZHXV2
za0Q65zpil|_QI@51Cj55S~pNFPWj3y2@XBiI`*Q+W5=c`S_Fbf!U;mE3e#<SU^=eO
z_xNG+4Yvod&bk_O(e=PxW~#X33oAqcBCl|8Y!qGmFzU6VzWZPe`BHDV#&THOFC&Zu
z_PvJ~C;?1O_Q35rtZ;ojbBPMITl)7HG?F&6+W}F%>iA%NLN<io&qr<Ve0UTw4CizG
zqnw(htrnr|c{rw12>^LP+uYU_tO%9%P^*7;pZmvkjo8S<tZ~%~+~lMu!BHC0fw?B^
z;0dlUtVmEnB=S%Az^bmO%W3fH=-1#fQ6i&R2G92Vvt*r82vuW1beq^&zkH0!nifS2
zUQO8WJ%GTRr4U>0O%1XU7nFc^H}uQN;VfEBnJfSa_rz8a%wu0YjmYeM1_qD|5LH7J
zqel1n<fZDtBT>8L`d49<mM7_^K`Vo(3sv85Ov@}Gq`FldfbD?qG;>zl`kl|iHJNH5
zrRX&c`}^hu?jstB?l8fsNkm|hNv~3H9VEH}*?~3dku$f7&A}$XBQG=zok5N|Qlg0B
zk9)rP2_bkN%0~MVIl!wUByFghJP-4eQ$t4<Zu^stqfw2))kfO=F*=45I8={M74AK7
zD`q~PkPbN`obL(51eT;Ghq>*O3e=|SdJA>*!19_2WRbmg7#d?M(-K$$&9Jk2cHifS
z@rF}6utXdJKJoqUjnY#i2>>iqgw@#Kex67zCnZ>RZ|&Onz&%Vz@QD?G2VxtO@9@aT
zs~<`vTWJSj*n8lUa1lu-lYO$T2<h|%@~E<-*R`ApKuI9^nU3D)IoW5BAUgxLAaYiy
zhTLuN%R-2X06X_1(*fI8ilA<8mATv72@wRi^)#wz0kE#;Hbo>bMKiQ1{{Y~DJC{Em
z*X`J5MOA`P5n{opwvo?z9{sW?QR?8Es6`}3px7IGU!dD1Buy$Kqa9B`SAXy^-I@rU
z6_`NA*d6qX+Q{VMpw|^fYj3Z%5iX#tY$J`el^c=0oOleLab&R@4}X7Qi=#_k!nn?1
zAq>iNm)H~i$GFNKDH=%1EdmH_O}YO7yquZ?#;R<t$IxTJ6GsyXlB6bu>~8U)LL`)J
zYpS@b9CyG3j~uc_NBl+pIagNdA(4<BDmQU^4(H}`I|o(RwU5TnY;io0B#}1Y`G^~P
z?|}Uyq*2S_An^v)ccFj3$1_xVnWPQDDgp1?AE(vS&UR3(<|DG=N}?&k`CLiB;QakE
z3UrO(#`@eXtzWOG$~=sbMj{$gD<GciYR&@~g$U3|2WvH}ak=%(@=Me^>2ELg=^O!t
zQbt&zEUpU!vaq`+z8;PvGOvhfD($zgbBmxeGMzycXp$@G?|E2M_-P8R_e1{xBhTTs
z5TSHPU8B1PN`J&2{{X*CAJX!I!+vkqD>2gQN%6>Q)z1F_4*A_kib%xBq`Ms^&e#5c
zA6%kq6PRorF&5gnG&%fokm(&OiXh0q0qDE)`|p#6C4QdWh}3J?47~LlBoa_jTa&*R
zffdxuMx;;xyFUY8zf2uVc!0~Xjv=HL6{~Z-eDdnC6FE2H(>QJj91n-X*CLA_g&-xv
z54x3hZ;JZhMdEMeY_-M)qwFvB%}~PxaTbxwH~<6#mOE~Jg?)1>A&yiM`89yRH>Yd-
z{u#+FE|er{+}#iQz-20hl}l2PNgD!x?;EFBgb|%!%3SJS?NB)1>$k%fst%JZER;^e
zVzj>ujB#7YsP?Kgd}{*FQ36G_qEy)X$GQ0N^~HiIStO1}qyz@vfBNr%<q&{CI(1jA
z*5`kYGfXCJOe{Iwcm{^U0lHb32WM0;uaqe}l6^j$<fM=^QD|aHw&Zcf$MwO|!X}so
zVzHg?xgQVTI6|`_5shAIzQfxfDb>rN`2nbEBYh*V&J&2;){pfUk3pI`kq|1j2q+5J
z*@)Zc$F>BHDWiEMeI#tFLeICie4%=DkHIX>L>geLc2DK$fhlzrRV77p#{U4H_`wt}
z6fzkky>{A97wdl67mP!;qFk>7BCRh{z$U2KP}nT{>h-UlKS=@WdWKXMvI4@|xCHJ`
z!2L5PQ0Gi7A><k!fO}=1tdU(zNI?`wYN5B&2+=eP(e-N_>qr0+3IMH-%D2S^KB<`^
zD-?1&GHN>j2G{V;((}ObI3=8$W;R&zZ|ZL|hfst_MS((x0{wowf1CvA<9NsQ0n*2g
z=iBwiG6Ne+8kQGK4`J93!!$)SU&^wOH8=x})D6vh@HYPdHxPU;36()%<}tS(_w>Ne
zB&_p3mMcca`JogDizsbOFN+*+^S!>f?GKK!%^I=@i4;e-f1l%s(!$3?2*vdfs!eQv
zW9fl2JHZM@%Bn#Jk1;j1{cq=uA}e(BI?>SKQG<2>{{AN#X<w=89kc;<?P7wCHpAeg
zvpC^MZ6Itl5$%O&j(BGggoMX3t7|F!_5y%Eeb2UL5wk?k7zI_pQV-s3xb+wL<FwGA
za}n4mRX4ezM!r1zWu88hrDYu_Q>j%_%WdZZ*bjl*+>9d}gmqI8Eg5#9{meQ1e>~(+
zTlrTcIdNofz0v)5$6Ya$nlwf(8I~?|(A<&fx8c9MdX*wXkhs>0H38g^PwRnrz;217
zNUr1u#3#(VZay3D^7O|qC)vG1v=T;SPwrEGYV3WkzFgv3s8Z3p>b}$n{h!Adr-?}n
z%%yZ|@|)5RufTpJ3<a6UXNr~}#>rkPsD8M@c^oW6EM-Xr_#pC0KTM307lcMh-TYQ3
zzo+Uxc(L@}CD1yWi5IxM4J|B7<3p!ZNTpH0tKPx+n)z*y)35&kB}@jHHdk~102(9@
z{`h@!DMZj#BF+}bCu`sL^~)>5@wo8<v|~^pY)LzT@Y^Dc-As{6WLe}g8;@AwfB*sP
z03c);OnpF*jciR{zr#A2BUh0__?A##0_dN^@W<)lPNS)XN;aiFBa}R-7JmWz+bCy|
zWa)e{8IMk>T;1J}0R8@$w&7!CVx=P*N`ZQ|{{VkXnJBT!0x>cW6c*cW&mX025((W@
zM)m?82gd^Obp|Hs<eDhvNRTlFwEqD1K_lzipL|aQqa=uq>QlwiwhaJH{TB1Oo~K;0
zGk9c3i>XvlqDJ1^0rbR2>UyrAER5$`odG-FYWLiH@GaH9PYUT+kBI0=7iyzO;Ck3M
z@yx~`u%Q+Xi)QpURqfmBi5z9!%@ZL)2h%omo+0}>S}PERyk8KV-mA(!f4#5-vZNBc
zeK%7fG0|xV)3<Ot@^NSCTgU#YTOuO1p<E?!K3N3nQaPjQ1R;tL?1b#w@%d#xnMNPi
zwP{;fAYS^e>%PLP-`fG8GO%SD5R@VHaKS~<{03!<t9X;ahK~Brp#y*O^~dn~g1#gw
z?HHis0zf)Xf06neF{e(zE5{-N95#+i3!(7bU(X1OOCWy{ShLpN#;fweU@=PeMwpZn
zzpY;W#MWD=>Eni9DPr`j6pAf%upeK;*Ai5Cq9SB}5P%g~XeXH8{{XT#_~2=q!FH7t
z6j!#5Nz_)zp??GTWM;Xw%L+D%B(rkEkIWpHF6@)A52S#~`v#$P{(d=Gd}xArz@mW4
z)x$9tztjr$z!D8|(x#X~-rNhUMU=+iw1>s9$k>1d50!p7IlrekWCE1v1Xva}1paw>
z*TJ0@MiMtHLA~0Ie*4}O;o5tRI&mbDe@%SULu@{L;&lpR&`H=KUF&0YL*y|`Zv9w^
z=8YsW0A#-+@6O$?07&GPKA%?V0M>iA=mq{5MY`ElWD~BP4648npkKh>!ywViETsTq
z?WKUR#aaCFokD+H!!qe8O6m)^0Gr$Ai!w<QBY*A4$|M1{@>P$h?dez<<V2CeAYrhg
z+i)`R!iH8eGbLFRc{RTNpPmR1l?FxuWI6?&;B)x?Cn)iFpn^uF32oU%{{W#MOaLGN
zLXRDJ428+E%Vb#g6n>avOJc)iWh_fA)eVQ&Z<xdUx)K!0CY?lhm1?L4{{UP4-Yk-V
z94sc(#2rdO@`K06*9yk5i3)2WS5OCkujiI=vq%)aid$py73;A4FeFi)m&NfaMQu7x
z_9)rMqRkw79hi>{0sjCXf5E~YDB_+?5;l`Ak#0%QyYuq=1|(G+z)KmWy@;;g;9w>a
zp+hngA=XOWFKYa7vdtstbE)dd-s*`tMWlsioS1;8K2<@eZ&bgS%+oA-O2)-j+QB>y
z!uy=D>LW-?K+O)fQDd-CzWuk~B^xuhhSC23OK=CNHNE!UvMSO^)3h^qrQ@0<5uz&W
z&8*ozlrJWRNL-Sk^;4;<z4`nr46&Y;Nd%xPuvSt}1L5n8j6|9dRHl{|LEIkrL_|(M
z`Hd~4SUcIhyL`q~S~#TA-c?m9{%h8M?{V<Rg;eT7sb@oBM+Ev`zWJh9oe)JT1kyEt
z)GdLde@-%mmSW5Imq{{IVC<xdzu%@ImewU=G%DyDZZ65MUCG3e4uqVm3p{~W>+-DU
zjmwa0WDP*@2nXxG=aEaT-NcMbQ6L`V;qi4kfC6b!EqE8(^Tei(PrNBul0h4hUxxXk
z!HqhW5rHAHc5RzZ<lmtH;T2w*7wHmIoOq1o3Nv~30?GC|sCv=Nv8n=8GX=dxg4rLA
zS{|7uX-duEqA4YtYawq>#>Hbr2}F`eq>KdA1c3hl?rs18e)hl-%?iX<s8C`7iUdAw
zL=Zk!qVg>2+PqRt)c}0jM!<UvtX>z29HoE_1UuLq@7n7Ac_x?o&eNv0k@Yd5d)?6e
z@qpqe-Mkj4%Miv!+N!wq^~EZvJd9gaQ19*V?~+YEAtI`{ZrN_0SB~XqkC>1N>~<#o
zcKq-Z)J>p0ms`ESQV;shm6kmy7CAJXSN{MlKv&3qxQ?+4W-MF#hsOT^3^H{Ds;G!Y
z3IOEUCXIvb*nF~!JWU+(K_B%H1|T7@Hokp9ABG~7FoB_+-NheIP(Ap=Jf~GH=qqN8
z9zRToj@_dKs_GO--`fLHbkk1@^(wMFagtc7-=XK%{A5-)O)sU?0thwhWM;_v$LTtC
z9W0Wotckt(Re+&mi@jNzX&fq<Sh8yhbove}0?~b!E5z<3L@JEt&X5oQb|;c-Rz?&>
zX|?Ju0TG8B@5%K4064MCBk7$T73Q_j+P>=d6gD?w;aIOLM(b=OQ@x+M+x}P_SS+G|
z(xiO_V@P1M3ces%g@R8#&$VCI5Xo|QVOI2kxY(NK0!H#ncBn|QNuV#`fR8FN0;{C=
z?}8R4U%EHFy-jVDmOza0#NW{j4PAmp*Z7~V2;uQi%0`sqSG`?ebW()}R}EtCd#}qm
zkUU6ZV$3KVUqA8q;)qnE($bGGvqX$|iU>$xzH72gkSu)<I0MbrI*X1r1SkVwJ@Lvq
z!qXBI7x3KJz6S%g2%=Yq#ITjOBG09F_53j%qohz-ovgmTF3%Vb(se4GEU-xwEv=W%
z<II)lef#9PL^3%IGQ^ro65E4YfnMZRbYKUN$yZ)bHx_cQD$%q{)1Zwtr{5rU>K3Qd
z;Z&im)kqwI03Ej(3bhVtK^^eM##IrGC;==z39nz33`NxH)pzpaDALlzf;vS333?W6
zp4aR%A&{{k0DBAc$Bc;NA%WFbOfr(Hn!52FY!S7OU(W-I#8J_FO+ac&8y&YlhD<Y2
zAXx8xvF4SF>t;0DilMj55<4=51zkugH8lZ$mIXR^Ox6Had1(<??oVp^SIl8PCx;%d
z2~1;Bk<IEH`{yV~dV*pjs1dE*8U&Bf{c>keV(kIv<#&K4>P&>W0Pr~9Y<VPA6-;9r
zt@Hk_htnq#$uk6wHPiuOeSp8v<DxS^hZ~J9LfaY@W1m5Q4C?k2gi0G%dKdX%@l#1u
z2T>;8xf#|YB~F$q*XlBo6FbS&1XL_el|iuY$E9t6147;=qoUMl5sj~IeYrmzM+P-k
zAxY=Wz49`~AUbH|5~yYjwWw?b9sZ{hSi>qR%EhEzP6(hH$f5Gz=a3+x%ThAXyY3D4
z$-U_SJ&<=iQTD~s(Qd-|6i(wbhi;`KKqyB_qJZ3+-`8`LXVK>#BXT}DWk6VvqCuy6
z{@dFNME*34zy=5IuLBVP1=>PJ+X1mYpN0U4vN$5Q*xv^zReD*<vWC)k?m6Qi8|FE$
ze6&Yt3rXREwS3<A3nMJV1yH3$00%!GOkpIVFsgtCKYFZ^2LAw_7*aMMl62i_y5AO9
z$_16A1)QCQeDErPmq;W;e(OCOQNgj1)=L*rWL1;N<2p7j^)8|T+ylSU4^W;0s1nBE
zlsAx*RyaQ3;4&qRdXx(`P4ihcjFL5l1pfebp+n<=Etrr(f+*Go7v)o8`4|pa1SMHD
zKB1+(2Y=HQ^(;!PfD0_F2IuGLj$$f1i1#3!_{gy(fcfAP831b1FMs>O;33@EBXjF`
z`b0~vL~THdUtf+Z5LmYV00KF{?Rr;B0CiPgBhv|H5*FQ5l02ryOcH>wvA5SPs@KF}
zsMS&9(*jZ(H$i)Cj|{pM!HpYT0OyqWVwjxAsZ{AFP5PYe3Wken9jgJP15fsavq}!*
z<DDcxI)x$pwkYw6QaeRg0FX6m?0#Lb<92F5RS6y*s@kuUfU7A(umPx#uQ(ZlHPPcA
zsftdHLllKIZMqP^j&>svTH<5_lXu+URm@S4V<t^W=hQ1pf2@-d!Bp<6-vJ(5FL(9F
zNac_fL@W?lHNe0`Q%uM1uGCNAjEo~|K3hA1*m~j;%B4sg@tn<H-FJalh!(OTWE+EZ
zkzF@LY<)8FKByHG8v}5EJd%YJP1x*4)qs3L30AH#blC*)>~lyB7epjtg=Ax}+=4xG
zGV^tGc=f<y;n=eiwQay7I5L?x7CR4244TU_D^iO$+YD@Dq8HZ9>~IK8K<T2~?SLU_
zAR9c^7GR>Q+@I4sRUuFT)ketNU=@Lu9~QvhV0({Thy?08SUE#wm+vy(z~M!<)<7MA
zBkxyi1ObaBscyg$PBw&c1%ODQw|ou>k=+!kjrRWBF~(c(qYD-fp!L869itQve|(y=
zBVAp5@yZGWpOy2Bz#(L{ZRly=0UgWLg<2hkGqBPCBI}%1cU3W#B}uyNc(tm@+t3UG
zMv^aV1HMqWWIzQKHD?rpq>uq8wg9rxfJxho<yum9+us=irtYMU!`J7W0A?X5ciiAF
z_HqUH&Xz*v$+PNxGLy2-%43Ko)Kz%+jPC)PQAJ`EbsZyt>wt}7fMQ2$?SjV)Pdl6l
z3+g0|h3<LAX-NSUKpuzu;By4rdAZ`Tt4N^MxTfi~f?KipVuH#lz3@1YO^;uu5<!x{
z1P$xg6y4U}TqKROpN`lKD=XUs3BAzcIrV5)0+io;nE;*1-yd4|dQ@-R-Ul!W2Nr$t
zZu#Ta3l;FduQ1z=bG)Spt;YBY*H_5xfD=?K9Acns+;+u0&>Q;U94w2%9f}3)4#NQ)
z5HYzcx0v&Q(Uc#29k6}t8ZY#~>e21CD*Ec9fy2soIoCjX`r&&U8#jTRl67u<aHFh|
zUygCzLGF3LfFAdpFHrOt1j%)DI}$MIAwj-&!14zJ$_081D%!?^2>$?&#{+<1bhy*;
z&Qcc8sUx??Inl#Y^XciF+H1;5KKMd}B;nFyG{E1X#oT#;ZS$<y2hD(P&5HOQ*jd<*
zHvRB5F$U{8g=}j8X*4U3ZrQ+jh}iyF#MN#$_0FOJrPz1C;!W|tY%L=)X<>E7+l&Z#
zwFhe4@tnnu)vEzbsXS*lnDd3m*nxlxG<H1TeGo}uaQmC$@x=u$PWQKSju{`w+jB?0
zDJu&CtYkk9FdO-q3aT|O_GoX0NrRG9n)f@Ln@U<b2}GUGu1#EOTjuNmg=q0qDI1ba
z^R`tbmQ5tCr5q1TlNIq4Z?Uske;O5aRelz<jt8+g5|tWWqs1O(Cvc;0kjq9{85X_B
z19EYUs}z91-`igevN|3hS=?%Ug?{+LFV$I9a8$7+n1jA&G7k^VX@4EFl1GhMLs4q&
zWZ{xFZ9Frb>>Yr@gbwKBs@rmJfHJW;1iFE!ZU?`v1eH=IQ(B$3HR+R?-C|@1LYlho
z?SaIZ36wAZ8Yb^kWmYLAQe-|=7tTrq`>Q8oU<0trG?pYg1UFT_1-e-ZLn21Nc%RcM
zr*p^Qn6!j0tSzjC0D?Zgnadl-Rks57Cz3LS5HF}cgO82^y*jRgMRq=?5(wmAT}PBv
z`}{F9EQIMi@239%Jk<wT{RV+fkajFLKP&+5T18;0p$3{BzWA#@^$Rf6NFY$}>xL;K
zJ22Bi=z9M9Vlpa{?PGn1di1~y?XY#w)nI&koaUNBM0~CD@B28xR#~iz{{X~y&TkmG
zNY~7KqtswGQPX&AtKzFZkXT;8p4iYrG_lkf#^bOb?~KZjl_6QJx4Jih9C)HK-urgI
zxsz8?6dhVyV^#AQ-CcC@g+|my<o^K2)B~My24;07hZNioddU{?<t`%tZ?^#8X@*GV
zl^XN}=J)y5b2$Q8X_&WvPg}@E{U`Gq0<{lAjG?E6!IFqKTv_z^;0c3GB9cjRK{dx2
z&pX)(L5R`-94~)``rvMsXiAyb2YvM3>OBvk_ReVDIkf^%(B7z%&(i?}jPeNx+A&_s
znxuHu5tyU1UZwW!XERxmM0<p0vs)G;{_(t3Kmzu$ciZFd#szhF=mct8!z8nlK#S}!
zb+bn-j_KwB1rjRj*mlDV(Zr=#5vWqFUHo!I&b8^1ir8!51MlmBG?k{(fR$Ra{{WHo
z_++$bm>uu8wt5|GO9ZNs*<veEA9=lprum82LddfVVQZ*vFf@XqJ83nR6bSy?z$aN_
zkd;vDynF16d;Cer!o_K{f(WsEWAva!BRvOI8vNDI>%VM*5l1BRn`Y8&i9g(aIkp)J
zl+qVPkSy_B-G0tzhf$F=UXi_DBKXZN!9&jBONJDqakkfddJjwmGlX?iwcBQ@AfN67
zBh*NcMu}F{vW&NgWRbdwQH)=BY30Zxlh|MQ$@S7lI;6TlbLCJ6YqEa3e6Rw^De2TR
z0IcH2zWdk1^Tq26D=m`xO&Z(}a(#WXmL+so4pb<%Cy#7l)5_}YL_n0R-qtz%GKQAr
zPZ0oJ32c6Qd`?9jeD+u|UA@n@)M1*X0wiVt04VQ%zz*kZ8j!Ln@<u$QUf_QBz!PaO
z2^<1;QD=gCpMV)iCml01N-xA(EOsP+i_Yu92@3@aV4W+%*xMx0v5pi0SeCY4=h)zD
zc%h7}lpd68W45Eu9MIT*-XM`;R*m*eT8#nNY(Lld#wF%~rDJ3@S9U($-LL79nVv;J
z#4;}g9f$92{#gX&uBvFt54~Umo4=tOM=Wd`!xjk?IoogdnN?AvS(4PD&;akvoOK>E
zKAO;21osL#_;K~ZpwerSo;I_+di$K$(KIrIfx{4hyE^jCTMvi(^v+(ISs8kG(6fi&
ze|X>gV|33L>D{&tBo^C^x7Z)Y<?n%w-a^eCPz+Ufz4qky?VS`sj^}fHeKSOzOmZZ}
zQ%bPX#DVeKZMac>-iEPZDF{Fqj?VS>0q^t&0ScIwL^fH45>Esk2k)Hjo_I`=__m+`
zfVUcNf0yTzl0zqv%K*2edIEX<`s4KCC3TKf+_=_2whB9bJYfm;iAkg`OMzsrz<F-?
z?03Ti*2q{>3I)eu?Tyx4E=-2O;E#=(_;HgOD4YAh?Ptn=)!+wtSEyj8QtB+Fjoq8y
z*Y(P*UM%4(J=JYM5_iAH430Wg5rsPVV&jedK11@w@hM&=jY}}qtR0kppV+`+h*5O;
zW!L5;&{11`H~M6v0Y<MB6LdX*_55;?5K)zW>kDQhkKgZ{lIo3~RF6tY<k()2dk>fA
zfYM0HvP44xtZsG$4%PeP4@DBRk}x0=4wgIvu=-Xslg7>B6cYfNEcb3~;&ieVifBrC
z?6IoY0sB88g&{_HCV5yb&^5WOj!pWL5i#i`1t<wT6Uq8m%1NwkADFsbd^Y_tCH|Ut
zWf2)0c0BAqF8D>_M9|tJ4B7{notF1Mpu;Ch7#Ygi1}MIVO4%du_}&2uuTLqCK#a%%
zQg>_L^2h0?ba><QIcVuMcDont{)SN$jkGJNqo<m^zkRTDvMe$;iyw;o8#FBMXA#Mc
zITaY!0AX0^mNg>k=<-j$@4i6&S}9<`iP#c71#mwcoa-bI#>|us>Z`#7_xcRFlnE-m
z0O_SbI<)RLIE>S3@UGS(Sjk)Izrb!jcoc!wMl!u8h$xbNb}x)nvDRw8DjUA$#eh$I
z&ZIMc$x`$R_wSXSN0LAcL3M6Q*5F_7<S;4Vq>=e;UNjqBf^NzDYO_3Xu7jz9lE&EZ
z7xqq9sfFCTD!Bv!8z`W6p|`+(83vG~ETMn^0!OL6hvR|Ju`@WZN~vH^2V?qi@0V$j
zkC3*d+_4p?nicRA*ogv0@%ZlO11miZz$AT7wmUaW%2^P!qCo6yonZF(kIbAax}z4Y
zDdrKMzD*Lx+pyp8KPBoQNc5;=kbywm0p9-r9PbI9Nt{MWX&9KJ8w0u9*kTyGeyDWf
zDspu5xjX^z!YLdDVwe^hC`bw0P`caKeZIb#KAX&iqgH8+1ps}~w*LSVu=(ZP8X(Kn
zsi<2>t--7EgXw?gCFf--wj{C`1)<L0i9bvN#zie6k2x*oA9PsU52*YyZy$!M5s_)e
z#`YbF{68F^ko4+feTouAwTsh7^ZYY4tdYh@A%)TQ{r-3l)9w*9gz*mN*bJkh&bp9D
zB#d%S!9Wx~fc$R*nG;cwG?i^5PXKNY=Z!RG3Dp+NPUHq3-T|xm;Z&YuDQ0awI#OIo
zus&VC0r=*3mPnQ_FjZS%pmCM)BT40mmX*9cC|GI(Yq9wZSs6NrAxMb=H6@R$8Xx2F
zz|s8AN%oIWdYN_f?xHn1P3^-qbA9W!W}ShY>1L4uWeq1Z59e6{JaL4jW26p6Yv%XL
zbp1;tN(5>`h6I(nBoHu*34fR!NQ97~i>>cNYx(TBdPrsJo#J;3Cx%KB!xBKR#PN{n
z*Tax82f>W4tNPc()>aASjv10g-ZddTL19;X_rI<bl7a$|fe5z>cN-JGzZkQ0qh8Vm
zVOpr}4(I2v%9;9YQ7Mnj5&%acR@G-$wGuvAG@UwQsz_E}>QLLzf0KVK3bW})RAqB4
zWetk*gR5imBN7-1bOA*x0#2=f1P1*wbAw6ZBN~hp1G4YA{r-67An`;YIwRA&HE!Nr
zSM?tufzrs+%v)J!Yb3WO&g7r2PpH&Qkio?ZZr#3{AEqFVq8e{e*qh|t40UqSnMt-(
z72mh`!YYxd`_ckLdXBBQy@B{vQg0P!nk_M~Qgu+S*Yw!^b3avc5~IwK{liA|_TSqn
z1OEUoGYOEtiMGdzufnjVgQ*|MOB{e93QDs5=Om4r*a63`XGq9U{DppNn%=WQ>6$*E
z5<Fl1!&`S8{6AcrD#;N5YE@uCB#;U2ewBcFN%~mjxz&tlYE1xYab)dyW<S%2#R!b3
z169#1c|V1GvLwl+(N;SWGa3|4(68UVAu?*zOA?36{{V@<_xR-%ib7a0sLKGL0eX!A
zUpqVCS?WO?au}9RBT3&$##p>o>4ND3Pa>PDYwz&P&PBB-pw>6Nzki+)ugv{1)R8Jc
z;Q&8*`Td`W&i-LRLg>tis+D}YN!TB)WTh15APH5ym8^S_^uQ)D#L7U_4Td7mZvOyW
zg0VpTT!uzuR*uNCKpVV%u|JpVB<Z1)Opz#!m{yZpnmxv=qu(bh{{U5_K4M8?0HDpQ
z(00m5W9j-x{23L5sZ)7;z}YqVeK0$wjaF~wW>pcWt6)eh7SA8O#%5{RgX~BHQZYA2
z_J15`rY#iF09xsz`qBJ9EG^U-EXkom0Cp9ofuZ?*GJw!ZT_KJ~u%l4oi3Z2#^v+(T
zp=ORU3lA=)0NoMzY%oSqi4sP1veRih@z2(=dZmp>ju_aTWCkYn42owGIYd-M4!y+z
zz3=oGVKKX+%cv-2)K{|q0CrS#-Ba}yG4RR)G|1KWSMJx!tK4Ei)}#{3#vO4m*?;1|
zc~8I}t_0DW&Y%lLK0+)D*qnI8aKy4wyA!}X5&nqDESBR+0twvkPqE5}fk0I%EC5Lc
z&4GVP{BRl>lq}K75pWk$vXC^J1Li8ld;4Nat<;bqT8_r%teW-u=NVPn9STT6OiOIc
zNj>-+50)%W{&=KT3Ov9ATh#-8n~VpR6VtbbSQaFT6l>?}iz_jTB%lg_N5I*?bN(}<
z@++M{m0>}S{2To-2@0toRwOahLG>FC&nh3pUl7Zts1g4F+1r7WK`gM67g7Qgn&9tW
zk;=3(yph9RX}3|ZyVwto28i_W9b?Wu>Z#z}QTl#3203CeG$B|!GL1vcV|$_QYj14j
zR-J~2RPezBJ5gdmB>tcGh8Y;Ahu|@NU(;Ysj%W_to5@1n1m%M`LNu_TTTgrrODv$d
zAw`NC1AXyClDaWf))&2ApWo?)=Q9^Xh%%jkU8;ox@vKPXXaIF$JBr_bd<R$vRyu$u
zu|2lm6`Z1IK&%50U)L!SVI!z$m7NJCxUOh>;>Qb0b)6!tkWCk@`1oKIQ3?l=EmAQI
z4cM#n`5causZ=mLaqpUEa=-vs><~41O08GV*Ch+n5CPI@w&&~HoC3`sgdzwSs}fuj
zxUGlb_~0+%M#uq3*|tDzEq|kp8!DL2z-k(R`EEuiP&KQM5R*#Us=faJ3<7#^TA-B~
zK(g0XJ^uhNo(SPz0Fvg(04;6vIDA+UfkZS=hSjwb+<S0-Sy(*aDPpudwd?Qe?eWMG
zZjob2B#pzyk3iKEV(z)DfB`O51dzKM@323fST|9kRRxG;3f<0-MSeAtjZ}ry>=B3#
zK<(dd_zfc@t9}p&fB*&ZPZ#n(T(m11va0}mPR+et^Y~_QF*2Z_7g!_<-o76^X}mPq
zBzKXV`HcX}+iu644tT<V!OpVYWv)Ma;~2v(h~xgFF$I{_0bRRy#E>iuw9NJa3^w2P
zbEbJ5*^n1DOONh1eD}aBBy7WzV3W1{zbxSB7$6BCETl0N$8U!J0EP&<c|k6!!%BFU
z><w7?;8zl9jZ`&|G}T$E$_lx4cVyJVO&j~53dw_@3fZiiAC_~mQ=yTCuVaj;k8LEL
zcHXPk0^M9q0;Fhm@WZf1)OYnizD7zpq*#|kntt-o=7^(z9BnG)q-JPSP!u;be?Bry
z5uAWFt*Zj7Jdjy|$fPPs09K(y3=x=+O1fOR0Z{rIAD}pj;bUZE9%2|1&3b+#>4dYe
zapHy#Qa8C5_=`9kfl`)FUBKrl6$y-ND2pDu*F5ALX<`b4bVsn~DyPJM3fE20cJk1^
za1&3A6-9%3RFVL~(S?mjd$U5C$ggjnR%lp870;QMUYe>Mi1t3&E|@T$JuBikVM;(c
zjsi^X%}->V^&U;*v;@DFRAy7AiK2b~0Djn7(ZF%$qQITW1Z+3L5>B4HKqG6fH$BDI
z*8vsCAd_k~YCE0qctxBo*&@fbKZC2oNc`qahzEwc$)iZJX-0j2cJ7bE1D-UE!AS(7
zhX8|h$IEf@&d}|$>7(Ym<7^^CX)pf(Z+jFr8Ne9>up+MapiTuMks@MBhhu(L<9pxb
z+Ym-xL``S`Bn?Mp7vIx3!c_}$PULf2{&=wpeZe>Nyb5&@9-F9SI$XxoNZcQAd*VpC
zJTe$IpcvLRxg=IrW(s?^8x6mH`Pwui+ScG%+za2ITn<RTsHo^z4>pltk@3y|AUg{K
zft+P52)b1JpmByJi%^@yRUyFe?zTLe>^A&xB%qd6T_a7KzH*AOyu)LoU>AdAf1F7p
zI^K?;KjYgGi5f<b2*7hEhbw{RI&|6n{ICGBBNk(*Rd3EHO>J8X+nNU-PT*;+xE$b4
z!3#`pD=wr%6Oe1rez>$xo5~0lN3JoeTL9Vh?||9}iDK~^{zY$Kdwv-rrAJ~;R#x#H
z&xQ~YwUb+VWS2;NG<5EMI2^#RqAJbU!6A6tdIWk5s!SOKZ5`IC-jBD?;c=lASr}T{
z78QRFQSXp1h73ksRaLir@FUb@1s2Bl_8qglLkoFdR@KM17=`F4ssn#~p@dU1Gk8{m
z`@JxuvHp^Z4?y~yC|AI8+O=(@gRuDL6)hMlnrPOqTm(&a$QMyJuv;Rrpov>ha(-RD
zxFM0?kVuTm{g@ge@x)>{$Rzl;$UobFuO%*$ScTbp5rL#>mNgWiR=zvobq)PZb!5=*
ze)xpD`Mto~*8$Z`i>8I$00!p)K!Ule+qlBuwK?zD9{3(ZGZtzT0I)I!5+RRE8oS_c
z#@qU2#RMk!INm0f5;9-0?|`t>)~9|w22tBR*I{Sh8I@KsRjG|p?Z+7)LhJ_Z+~p;V
zAt)VKFZT=%dQt}`xxDMC12EVduUr8dQeSdFvx2$Q)J6lzBNw6N41F<4k#zvp2HzYE
zQIrd=_g(!kAS~dkZ+jjn;BdDW*mfAvN#Qvq5v&!a?e0DB5_K?Q2|dOtjazSc4H;9c
zupEugY%Qf}bp{^WQN<Dj6bARsa8V&<B8cAr0p%nfJ#m^>c)+hH;_w>1ARYS+^MbOG
zPQIe>4yR_)0J_Ce95E)FwlgatgFtHBd@)gVF(;2vfMl7Ti2zWcr#d-VD1t|*zHv$d
z+An_F?VQ4zzFS}uA`;{&Qrr&M1qK2482%G!VQ31`=bT8>#F1A}P)!nhU^cQGFxrmC
zA770qG7Sn%mIHDxbMeH`RG%>0@y=G%0OJ5XD-{Hl>`3S3j0bY0u@<BpLe|7~?SzqH
zwGWSM1m9nnoL~z#l!8YXP^r{N-+^AZ1BEN(zgs-u3*<KbnOGsH+G|6nZ7g@(b6AB-
zsdYSZJuz0!+i!#dgi}!~b$+<gFNVPK2)pf^3n`&^<;h^@OKRj+!~9@NlZ_krZU`G4
zjs{Vvo3WiifddLV2R2ErGn$Cle6Xkr2_}g4$(siKFc^~Cv9nplKvGK!x)p#10{a~5
zB-aA~s8SnUt5((PichW`z#^>hFg2F<!0QKr$iuz)Zifc|8o$mEN-(YO1BoZ^9sTo&
zAoklin6p{f`{322Y(*Woz+g}h{Jk+4-uOWSk!RzIcI4p<R))s#1U=0T#|XWLVS$Yr
z0Q@iwZO0f;JK0s>Z(XyzLRUqM2*q!HMh7qoYjA$K)k9Dqj%XdmEt)s-#t)<^pi1&9
h^T3%KUmf$e$~2(KsZ&q>Ben%qCw8G+*MCe8|Ji78FQ)(i

diff --git a/.gitignore b/.gitignore
index 44757d0..9b6ef9b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -33,5 +33,5 @@ src-tauri/target/
 src-tauri/gen/
 src-tauri/WixTools/
 
-# Full-size camera originals in print findings (compressed copies are committed)
-.agents/print-findings/**/DSC*.JPG
+# Agent workspace files
+.agents/

From e37b7d1d700f2b23092c931d0d9455d3062a7015 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Mon, 6 Jul 2026 23:17:07 +0300
Subject: [PATCH 56/81] Fix auto-paint calibration cache state

---
 CHANGELOG.md                                 |  2 +-
 src/components/FilamentCalibrationDialog.tsx |  3 +-
 src/lib/optimizer.ts                         | 35 +++++++++---
 tests/optimizer.test.ts                      | 60 ++++++++++++++++++++
 4 files changed, 89 insertions(+), 11 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c20bfb8..5abd5f2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,7 +26,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
 - **Auto-paint calibration confidence** - Color edits that deactivate a calibration now re-anchor the filament's estimated hiding distance to the new color without deleting the stored calibration, and result confidence now scores the filament sequence actually printed after variable-length optimization omits unused filaments.
-- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters and tuning inputs, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
+- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, and active calibration state, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
 ## v3.1.0 - 2026-06-18
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index f506371..07d32b8 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -34,6 +34,7 @@ import {
 import { cn } from '@/lib/utils';
 import type { Filament } from '../types';
 import {
+    activeFrontlitCalibration,
     channelHds,
     computeFrontlitCalibration,
     computeFrontlitCalibrationSession,
@@ -672,7 +673,7 @@ export function FilamentCalibrationDialog({
                 <div className="max-h-[22rem] space-y-2 overflow-y-auto pr-1">
                     {filaments.map((filament) => {
                         const selected = selectedIds.has(filament.id);
-                        const isCalibrated = !!filament.calibration;
+                        const isCalibrated = !!activeFrontlitCalibration(filament);
                         return (
                             <button
                                 key={filament.id}
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index ae0042b..dafb18f 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -16,6 +16,7 @@ import {
     scoreSequenceAgainstImage,
     type WeightedLab,
 } from './autoPaint';
+import { activeFrontlitCalibration, channelHds } from './calibration';
 
 // ============================================================================
 // Type Definitions
@@ -181,6 +182,29 @@ function tuningFingerprint(options: OptimizerOptions) {
     };
 }
 
+function filamentOpticalFingerprint(filament: Filament) {
+    const activeCalibration = activeFrontlitCalibration(filament);
+    return {
+        id: filament.id,
+        color: filament.color,
+        td: filament.td,
+        channelHds: channelHds(filament),
+        activeCalibrationColor:
+            activeCalibration?.filamentColor ?? (activeCalibration ? '__legacy__' : null),
+    };
+}
+
+function filamentOpticalKey(filament: Filament): string {
+    const fingerprint = filamentOpticalFingerprint(filament);
+    return [
+        fingerprint.id,
+        fingerprint.color,
+        fingerprint.td,
+        ...fingerprint.channelHds,
+        fingerprint.activeCalibrationColor ?? '',
+    ].join(':');
+}
+
 function canonicalOptimizerInput(
     filaments: Filament[],
     context: ScoringContext,
@@ -189,12 +213,7 @@ function canonicalOptimizerInput(
     seed?: number
 ): string {
     return JSON.stringify({
-        filaments: filaments.map((filament) => ({
-            id: filament.id,
-            color: filament.color,
-            td: filament.td,
-            calibrationTd: filament.calibration?.td ?? null,
-        })),
+        filaments: filaments.map(filamentOpticalFingerprint),
         clusters: context.imageColors.map((color) => ({
             L: color.L,
             a: color.a,
@@ -230,9 +249,7 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
     return (filaments) => {
         if (filaments.length === 0) return Infinity;
         const sequenceKey = filaments
-            .map((filament) =>
-                [filament.id, filament.color, filament.td, ...(filament.calibration?.td ?? [])].join(':')
-            )
+            .map(filamentOpticalKey)
             .join('|');
         let palette = paletteCache.get(sequenceKey);
         if (!palette) {
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 1440206..124ee54 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -209,6 +209,66 @@ test('cache keys include all weighted clusters and optimizer tuning', async () =
     assert.equal(getOptimizerCacheStats().size, 4);
 });
 
+test('cache keys distinguish active and inactive calibrated swatch colors', async () => {
+    const { clearOptimizerCache, optimizeFilamentOrder } = await loadOptimizerModule();
+    clearOptimizerCache();
+
+    const calibration = {
+        opacityLayers: 5,
+        layerHeight: 0.1,
+        firstLayerHeight: 0.2,
+        td: [2, 2, 2] as [number, number, number],
+        tdSingleValue: 0.5,
+        jnd: 2,
+        baseColor: '#000000',
+        confidence: 1,
+        basis: 'frontlit' as const,
+        calibrationDate: '2026-07-02T00:00:00.000Z',
+    };
+    const activeFilaments = [
+        {
+            id: 'white',
+            color: '#ffffff',
+            td: 0.5,
+            calibration: { ...calibration, filamentColor: '#ffffff' },
+        },
+        { id: 'black', color: '#000000', td: 0.2 },
+    ];
+    const inactiveFilaments = [
+        {
+            id: 'white',
+            color: '#ffffff',
+            td: 0.5,
+            calibration: { ...calibration, filamentColor: '#000000' },
+        },
+        { id: 'black', color: '#000000', td: 0.2 },
+    ];
+    const grayContext = {
+        imageColors: [{ L: 73, a: 0, b: 0, weight: 1 }],
+        layerHeight: 0.1,
+        firstLayerHeight: 0.2,
+    };
+    const options = {
+        algorithm: 'balanced' as const,
+        seed: 1234,
+        cachingEnabled: true,
+    };
+
+    const active = optimizeFilamentOrder(activeFilaments, grayContext, options);
+    const inactive = optimizeFilamentOrder(inactiveFilaments, grayContext, options);
+    const inactiveUncached = optimizeFilamentOrder(inactiveFilaments, grayContext, {
+        ...options,
+        cachingEnabled: false,
+    });
+    const inactiveCached = optimizeFilamentOrder(inactiveFilaments, grayContext, options);
+
+    assert.equal(active.cacheHit, undefined);
+    assert.equal(inactive.cacheHit, undefined, 'inactive calibration state must miss cache');
+    assert.equal(inactiveCached.cacheHit, true);
+    assert.equal(inactive.score, inactiveUncached.score);
+    assert.notEqual(active.score, inactive.score);
+});
+
 test('default optimizer seeds are stable and cacheable', async () => {
     const { clearOptimizerCache, optimizeFilamentOrder } = await loadOptimizerModule();
     clearOptimizerCache();

From a33ebab835d1c3c55e09a1baf922c1262d9ec067 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Tue, 7 Jul 2026 18:56:04 +0300
Subject: [PATCH 57/81] Fix next-best-color channel HD blending

---
 CHANGELOG.md                |  2 +-
 src/lib/nextBestColor.ts    | 60 ++++++++++++++++++++++++++-----------
 tests/nextBestColor.test.ts | 59 ++++++++++++++++++++++++++++++++++++
 3 files changed, 102 insertions(+), 19 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5abd5f2..2ce1e06 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,7 +15,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
-- **Hiding Distance replaces TD** - Filament opacity is now expressed as a frontlit **Hiding Distance (HD)** in millimetres: the depth at which a filament visually hides what's beneath it, matching how prints are actually viewed. Stored values become single-meaning (profile schema v2): uncalibrated values from older profiles, `.kfil`/`.kapp` files, and saved app state are converted automatically (×0.1, one time) on load or import, and the old internal frontlit scaling layer is removed — this also fixes calibrated filaments being double-scaled in the recommended-height estimate. A convert button on each filament row accepts conventional backlit/lithophane TD values (≈10× the HD) and converts them on entry, the wand estimate now produces HD directly, and per-channel values are visible in tooltips. Uncalibrated filaments now blend with per-channel hiding distances estimated from their color (previously channel-uniform), so uncalibrated previews and stacks are more color-faithful; the next-filament suggestion simulates blends in linear light and recommends HDs on the stored scale.
+- **Hiding Distance replaces TD** - Filament opacity is now expressed as a frontlit **Hiding Distance (HD)** in millimetres: the depth at which a filament visually hides what's beneath it, matching how prints are actually viewed. Stored values become single-meaning (profile schema v2): uncalibrated values from older profiles, `.kfil`/`.kapp` files, and saved app state are converted automatically (×0.1, one time) on load or import, and the old internal frontlit scaling layer is removed — this also fixes calibrated filaments being double-scaled in the recommended-height estimate. A convert button on each filament row accepts conventional backlit/lithophane TD values (≈10× the HD) and converts them on entry, the wand estimate now produces HD directly, and per-channel values are visible in tooltips. Uncalibrated filaments now blend with per-channel hiding distances estimated from their color (previously channel-uniform), so uncalibrated previews and stacks are more color-faithful; the next-filament suggestion simulates blends in linear light with the same per-channel hiding distances auto-paint renders with (measured channels when calibrated, color-derived otherwise) and recommends HDs on the stored scale.
 - **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
 - **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Legacy saved values migrate to the nearest current tier.
 - **Auto-paint optical model** - Beer-Lambert blending now runs in linear-light sRGB, and calibrated filaments use measured RGB-channel TDs for blend simulation and transition-zone thickness. Recalibrate profiles created with earlier releases before using them for new prints.
diff --git a/src/lib/nextBestColor.ts b/src/lib/nextBestColor.ts
index d793d9f..5bc572d 100644
--- a/src/lib/nextBestColor.ts
+++ b/src/lib/nextBestColor.ts
@@ -1,4 +1,5 @@
 import type { Filament } from '../types/index.ts';
+import { channelHds, deriveChannelTds, type CalibrationRgb } from './calibration.ts';
 
 // ---------------------------------------------------------------------------
 // Minimal color math — inlined to avoid pulling in autoPaint's optimizer dep.
@@ -122,26 +123,41 @@ function linearChannelToSrgb(channel: number): number {
 
 // Beer-Lambert layer blend in linear light: matches autoPaint's blendColors /
 // colorSpace.blendSrgbChannel (composite the transmissive foreground over the
-// background in linear light, then re-encode to sRGB).
-export function blendRgb(bg: RGB, fg: RGB, td: number, thickness: number): RGB {
-    if (td <= 0 || thickness <= 0) return bg;
-    const t = Math.pow(0.1, thickness / td);
-    const blendChannel = (bgC: number, fgC: number) =>
-        linearChannelToSrgb(
+// background in linear light, then re-encode to sRGB). Accepts a scalar HD or
+// the per-channel R, G, B hiding distances auto-paint blends with.
+export function blendRgb(
+    bg: RGB,
+    fg: RGB,
+    td: number | CalibrationRgb,
+    thickness: number
+): RGB {
+    if (thickness <= 0) return bg;
+    const channelTd: CalibrationRgb = typeof td === 'number' ? [td, td, td] : td;
+    if (channelTd.some((v) => !Number.isFinite(v) || v <= 0)) return bg;
+    const blendChannel = (bgC: number, fgC: number, tdC: number) => {
+        const t = Math.pow(0.1, thickness / tdC);
+        return linearChannelToSrgb(
             srgbChannelToLinear(fgC) * (1 - t) + srgbChannelToLinear(bgC) * t
         );
-    return { r: blendChannel(bg.r, fg.r), g: blendChannel(bg.g, fg.g), b: blendChannel(bg.b, fg.b) };
+    };
+    return {
+        r: blendChannel(bg.r, fg.r, channelTd[0]),
+        g: blendChannel(bg.g, fg.g, channelTd[1]),
+        b: blendChannel(bg.b, fg.b, channelTd[2]),
+    };
 }
 
 const BLEND_CURVE_STEPS = 16;
 
 /**
- * Pre-compute the Lab values along a Beer-Lambert blend curve (bg→fg over 3×fgTd).
- * Call once per filament pair, then use minCurveDE for each swatch — avoids repeating
- * the expensive rgbToLab conversion M times for the same blend curve.
+ * Pre-compute the Lab values along a Beer-Lambert blend curve (bg→fg over 3× the
+ * most transmissive channel HD). Call once per filament pair, then use minCurveDE
+ * for each swatch — avoids repeating the expensive rgbToLab conversion M times
+ * for the same blend curve.
  */
-function buildBlendCurve(bgRgb: RGB, fgRgb: RGB, fgTd: number): Lab[] {
-    const maxT = 3 * Math.max(fgTd, 0.01);
+function buildBlendCurve(bgRgb: RGB, fgRgb: RGB, fgTd: number | CalibrationRgb): Lab[] {
+    const maxChannelTd = typeof fgTd === 'number' ? fgTd : Math.max(...fgTd);
+    const maxT = 3 * Math.max(maxChannelTd, 0.01);
     const labs: Lab[] = [rgbToLab(bgRgb)];
     for (let i = 1; i <= BLEND_CURVE_STEPS; i++) {
         labs.push(rgbToLab(blendRgb(bgRgb, fgRgb, fgTd, (i / BLEND_CURVE_STEPS) * maxT)));
@@ -226,6 +242,9 @@ export function nextBestColor(
     const filamentRgbs: RGB[] = filaments.map((f) => hexToRgb(f.color));
     const filamentLabs: Lab[] = filamentRgbs.map((rgb) => rgbToLab(rgb));
     const filamentTds: number[] = filaments.map((f) => f.td);
+    // Per-channel hiding distances — measured when calibrated, color-derived
+    // otherwise — so blend curves match what auto-paint actually renders.
+    const filamentHds: CalibrationRgb[] = filaments.map((f) => channelHds(f));
     const swatchLabs: Lab[] = imageSwatches.map((s) => rgbToLab(hexToRgb(s.hex)));
     const counts: number[] = imageSwatches.map((s) => s.count ?? 1);
 
@@ -241,8 +260,8 @@ export function nextBestColor(
     const pairCurves: Lab[][] = [];
     for (let fi = 0; fi < filamentRgbs.length; fi++) {
         for (let fj = fi + 1; fj < filamentRgbs.length; fj++) {
-            pairCurves.push(buildBlendCurve(filamentRgbs[fi], filamentRgbs[fj], filamentTds[fj]));
-            pairCurves.push(buildBlendCurve(filamentRgbs[fj], filamentRgbs[fi], filamentTds[fi]));
+            pairCurves.push(buildBlendCurve(filamentRgbs[fi], filamentRgbs[fj], filamentHds[fj]));
+            pairCurves.push(buildBlendCurve(filamentRgbs[fj], filamentRgbs[fi], filamentHds[fi]));
         }
     }
 
@@ -339,12 +358,16 @@ export function nextBestColor(
             if (de < nearestFilamentDE) { nearestFilamentDE = de; estimatedTd = filamentTds[fi]; }
         }
         const candidateRgb = hexToRgb(hex);
+        // The candidate is a hypothetical uncalibrated filament, so model it the
+        // way auto-paint would once added: channel HDs derived from its color
+        // around the borrowed scalar HD.
+        const candidateHds = deriveChannelTds(hex, estimatedTd);
 
         // Pre-compute candidate↔filament blend curves once, then check all swatches against them.
         const candCurves: Lab[][] = [];
         for (let fi = 0; fi < filamentRgbs.length; fi++) {
-            candCurves.push(buildBlendCurve(filamentRgbs[fi], candidateRgb, estimatedTd));
-            candCurves.push(buildBlendCurve(candidateRgb, filamentRgbs[fi], filamentTds[fi]));
+            candCurves.push(buildBlendCurve(filamentRgbs[fi], candidateRgb, candidateHds));
+            candCurves.push(buildBlendCurve(candidateRgb, filamentRgbs[fi], filamentHds[fi]));
         }
 
         let weightedGain = 0;
@@ -383,10 +406,11 @@ export function nextBestColor(
 
     // Pixel capture: swatches whose blend-aware reachable error improves with the winner.
     const winnerRgb = hexToRgb(winner.hex);
+    const winnerHds = deriveChannelTds(winner.hex, winner.estimatedTd);
     const winnerCurves: Lab[][] = [];
     for (let fi = 0; fi < filamentRgbs.length; fi++) {
-        winnerCurves.push(buildBlendCurve(filamentRgbs[fi], winnerRgb, winner.estimatedTd));
-        winnerCurves.push(buildBlendCurve(winnerRgb, filamentRgbs[fi], filamentTds[fi]));
+        winnerCurves.push(buildBlendCurve(filamentRgbs[fi], winnerRgb, winnerHds));
+        winnerCurves.push(buildBlendCurve(winnerRgb, filamentRgbs[fi], filamentHds[fi]));
     }
     let pixelsCaptured = 0;
     for (let i = 0; i < swatchLabs.length; i++) {
diff --git a/tests/nextBestColor.test.ts b/tests/nextBestColor.test.ts
index aea8369..b54ba92 100644
--- a/tests/nextBestColor.test.ts
+++ b/tests/nextBestColor.test.ts
@@ -337,6 +337,65 @@ test('blendRgb composites in linear light like blendSrgbChannel', async () => {
     assert.ok(Math.abs(blended.g - blended.r) < 1e-9 && Math.abs(blended.b - blended.r) < 1e-9);
 });
 
+test('blendRgb applies per-channel hiding distances independently', async () => {
+    const { blendRgb } = await import('../src/lib/nextBestColor.ts');
+    const white = { r: 255, g: 255, b: 255 };
+    const black = { r: 0, g: 0, b: 0 };
+    const thickness = Math.log10(2);
+    // A uniform triple must match the scalar path exactly.
+    const scalar = blendRgb(white, black, 1, thickness);
+    const uniform = blendRgb(white, black, [1, 1, 1], thickness);
+    assert.deepEqual(uniform, scalar);
+    // Asymmetric HDs: the channel with the smaller HD hides the background
+    // faster, so it must come out darker than the more transmissive channel.
+    const asymmetric = blendRgb(white, black, [0.2, 1, 1], thickness);
+    assert.ok(
+        asymmetric.r < asymmetric.g - 10,
+        `expected r (HD 0.2) to hide faster than g (HD 1): got r=${asymmetric.r}, g=${asymmetric.g}`
+    );
+    assert.ok(Math.abs(asymmetric.g - asymmetric.b) < 1e-9);
+});
+
+test('measured calibration channels change the blend-aware baseline', () => {
+    // A calibrated teal whose measured channels ([0.35, 0.12, 0.12]) invert the
+    // color-derived heuristic (~[0.068, 0.354, 0.373]): red hides slowest, not
+    // fastest. The swatch #32b8c4 sits exactly on the measured teal-over-white
+    // blend curve, so the calibrated model reaches it (error → 0 under the
+    // coverage floor) while the derived model reports a real residual.
+    const measured: [number, number, number] = [0.35, 0.12, 0.12];
+    const calibratedTeal: Filament = {
+        id: 'teal',
+        color: '#00b8c4',
+        td: 0.35,
+        calibration: {
+            opacityLayers: 5,
+            layerHeight: 0.08,
+            firstLayerHeight: 0.16,
+            td: measured,
+            tdSingleValue: 0.35,
+            jnd: 2,
+            baseColor: '#000000',
+            confidence: 0.8,
+            basis: 'frontlit',
+            calibrationDate: '2026-07-02T00:00:00.000Z',
+        },
+    };
+    const uncalibratedTeal = filament('teal', '#00b8c4', 0.35);
+    const white = filament('white', '#ffffff', 0.51);
+    const swatches = [
+        { hex: '#00b8c4', count: 100 }, // covered — on the teal filament
+        { hex: '#ffffff', count: 100 }, // covered — on the white filament
+        { hex: '#32b8c4', count: 100 }, // on the measured teal-over-white curve
+    ];
+    const calibrated = nextBestColor([calibratedTeal, white], swatches);
+    const derived = nextBestColor([uncalibratedTeal, white], swatches);
+    assert.ok(
+        calibrated.baselineAvgDeltaE < derived.baselineAvgDeltaE,
+        `measured channel HDs must feed the blend curves: ` +
+            `calibrated ${calibrated.baselineAvgDeltaE} vs derived ${derived.baselineAvgDeltaE}`
+    );
+});
+
 test('recommended hiding distance is borrowed on the stored (frontlit) scale', () => {
     // Calibrated-profile-like HD values (~0.3–0.6 mm). The suggestion must come
     // back on the same scale so the added filament simulates correctly.

From bac56617bef24557cd3e91a67531c2d09d18e9c2 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Tue, 7 Jul 2026 19:35:57 +0300
Subject: [PATCH 58/81] Fix code-review findings across optimizer, calibration,
 and profiles

- Disclose the estimated base-order count when the Exact optimizer tier
  is selected (getExactBaseOrderCount wired into the tier picker)
- Include the resolved preserve-separation mode in the optimizer cache
  key and default-seed input regardless of how callers pass it
- Freeze the calibration dialog's read entry to the downloaded wedge's
  base filaments and print settings so later setting edits do not
  reinterpret the physical print
- Make blendRgb treat zero/invalid hiding distances as immediately
  opaque, matching blendColors
- Reject non-positive hiding distances in profile filament sanitizing
- Reuse the initial default-JND residual and memoize per-JND residuals
  in fitSessionJnd; reuse channelHds results in calculateIdealHeight
- Clamp center-weight strength below 1 to keep weights finite
- Drop stale generateAutoLayers arguments from the goldens script
---
 CHANGELOG.md                                 |   7 +-
 scripts/generate-auto-paint-goldens.ts       |   4 +-
 src/components/AutoPaintTab.tsx              |  34 ++++-
 src/components/FilamentCalibrationDialog.tsx |  96 +++++++++-----
 src/lib/autoPaint.ts                         |  58 ++++-----
 src/lib/calibration.ts                       |  20 +--
 src/lib/nextBestColor.ts                     | 129 ++++++++++++-------
 src/lib/optimizer.ts                         |  61 ++++-----
 src/lib/profileManager.ts                    |   3 +-
 src/lib/regionWeighting.ts                   |  14 +-
 tests/nextBestColor.test.ts                  |  68 ++++++----
 tests/optimizer.test.ts                      |  34 +++--
 tests/profileManager.test.ts                 |  15 ++-
 tests/regionWeighting.test.ts                |  10 ++
 14 files changed, 350 insertions(+), 203 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2ce1e06..7eb1ef5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
@@ -17,7 +17,7 @@ All notable changes to Kromacut are documented in this file.
 
 - **Hiding Distance replaces TD** - Filament opacity is now expressed as a frontlit **Hiding Distance (HD)** in millimetres: the depth at which a filament visually hides what's beneath it, matching how prints are actually viewed. Stored values become single-meaning (profile schema v2): uncalibrated values from older profiles, `.kfil`/`.kapp` files, and saved app state are converted automatically (×0.1, one time) on load or import, and the old internal frontlit scaling layer is removed — this also fixes calibrated filaments being double-scaled in the recommended-height estimate. A convert button on each filament row accepts conventional backlit/lithophane TD values (≈10× the HD) and converts them on entry, the wand estimate now produces HD directly, and per-channel values are visible in tooltips. Uncalibrated filaments now blend with per-channel hiding distances estimated from their color (previously channel-uniform), so uncalibrated previews and stacks are more color-faithful; the next-filament suggestion simulates blends in linear light with the same per-channel hiding distances auto-paint renders with (measured channels when calibrated, color-derived otherwise) and recommends HDs on the stored scale.
 - **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
-- **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Legacy saved values migrate to the nearest current tier.
+- **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Selecting Exact base order shows the estimated number of base orders it will score before running. Legacy saved values migrate to the nearest current tier.
 - **Auto-paint optical model** - Beer-Lambert blending now runs in linear-light sRGB, and calibrated filaments use measured RGB-channel TDs for blend simulation and transition-zone thickness. Recalibrate profiles created with earlier releases before using them for new prints.
 - **Height dithering kernel** - Height dithering now uses an error-conserving Stucki kernel instead of Floyd-Steinberg, spreading quantization error over a wider area while keeping the existing block-aware dot sizing and edge protection.
 
@@ -26,7 +26,8 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
 - **Auto-paint calibration confidence** - Color edits that deactivate a calibration now re-anchor the filament's estimated hiding distance to the new color without deleting the stored calibration, and result confidence now scores the filament sequence actually printed after variable-length optimization omits unused filaments.
-- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, and active calibration state, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
+- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, preserve-separation mode, and active calibration state, zero-HD blend helpers agree on the opaque-filament limit, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
+- **Filament profile validation** - Imported `.kfil`/`.kapp` profile filaments now reject zero or negative hiding distances instead of letting invalid raw HD values reach the UI.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
 ## v3.1.0 - 2026-06-18
diff --git a/scripts/generate-auto-paint-goldens.ts b/scripts/generate-auto-paint-goldens.ts
index 6c60be8..e42bf81 100644
--- a/scripts/generate-auto-paint-goldens.ts
+++ b/scripts/generate-auto-paint-goldens.ts
@@ -39,9 +39,7 @@ const goldens = Object.fromEntries(
             undefined,
             scenario.enhancedColorMatch,
             scenario.allowRepeatedSwaps,
-            { algorithm: 'balanced', seed: scenario.seed },
-            'uniform',
-            scenario.imageDimensions
+            { algorithm: 'balanced', seed: scenario.seed }
         );
 
         return [
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 0e2da72..31aff5e 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -28,8 +28,12 @@ import type { AutoPaintResult, TransitionZone } from '../lib/autoPaint';
 import type { AutoPaintProfile } from '../lib/profileManager';
 import type { AutoPaintRepeatLimit, AutoPaintTransitionOpacity, Filament, Swatch } from '../types';
 import FilamentRow from './FilamentRow';
-import { FilamentCalibrationDialog, type CalibrationApplyUpdate } from './FilamentCalibrationDialog';
+import {
+    FilamentCalibrationDialog,
+    type CalibrationApplyUpdate,
+} from './FilamentCalibrationDialog';
 import { getConfidenceLabel, getConfidenceColor } from '../lib/calibration';
+import { getExactBaseOrderCount } from '../lib/optimizer';
 import { useNextBestColorWorker } from '../hooks/useNextBestColorWorker';
 
 /** Percentage stat tile with a slim progress bar, colored by confidence band. */
@@ -81,6 +85,12 @@ const OPTIMIZER_TIERS: readonly OptimizerTierMeta[] = [
     },
 ];
 
+function formatBaseOrderCount(count: number): string {
+    if (count >= 1_000_000_000) return `${(count / 1_000_000_000).toFixed(1)}B`;
+    if (count >= 1_000_000) return `${(count / 1_000_000).toFixed(1)}M`;
+    return count.toLocaleString();
+}
+
 interface AutoPaintSliceData {
     virtualSwatches: Swatch[];
     colorSliceHeights: number[];
@@ -237,6 +247,11 @@ export default function AutoPaintTab({
     const [localOptimizerSeed, setLocalOptimizerSeed] = React.useState(
         optimizerSeed?.toString() ?? ''
     );
+    const exactBaseOrderCount = React.useMemo(
+        () => getExactBaseOrderCount(filaments.length),
+        [filaments.length]
+    );
+    const exactBaseOrderIsLarge = exactBaseOrderCount >= 1_000_000 || filaments.length >= 9;
 
     // Calibration dialog state
     const [calibrationDialogOpen, setCalibrationDialogOpen] = React.useState(false);
@@ -814,6 +829,19 @@ export default function AutoPaintTab({
                                         </SelectContent>
                                     </Select>
                                 </div>
+                                {optimizerAlgorithm === 'exact' && (
+                                    <div
+                                        className={`rounded-md border px-2 py-1.5 text-[10px] sm:ml-[7.5rem] ${
+                                            exactBaseOrderIsLarge
+                                                ? 'border-amber-500/30 bg-amber-500/10 text-amber-700 dark:text-amber-300'
+                                                : 'border-border/50 bg-muted/30 text-muted-foreground'
+                                        }`}
+                                    >
+                                        Exact base order will score about{' '}
+                                        {formatBaseOrderCount(exactBaseOrderCount)} base orders
+                                        before repeat refinement.
+                                    </div>
+                                )}
                                 <div className="flex items-center gap-2">
                                     <Label
                                         htmlFor="region-weighting"
@@ -967,7 +995,9 @@ export default function AutoPaintTab({
                                     </div>
                                     <div className="flex justify-between text-[9px] text-muted-foreground/70">
                                         <span>0 mm (plate)</span>
-                                        <span>{autoPaintResult.totalHeight.toFixed(2)} mm (top)</span>
+                                        <span>
+                                            {autoPaintResult.totalHeight.toFixed(2)} mm (top)
+                                        </span>
                                     </div>
                                 </div>
 
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 07d32b8..2feaedb 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -75,6 +75,20 @@ interface FilamentCalibrationDialogProps {
     onApply: (updates: CalibrationApplyUpdate[]) => void;
 }
 
+interface CalibrationTarget {
+    key: string;
+    filament: Filament;
+    base: Filament;
+}
+
+interface CalibrationPrintPlan {
+    targets: CalibrationTarget[];
+    printOptions: CalibrationPrintOptions;
+    layerHeight: number;
+    firstLayerHeight: number;
+    maxLayers: number;
+}
+
 const MIN_MAX_LAYERS = 4;
 const MAX_MAX_LAYERS = 40;
 const MAX_BASES_PER_FILAMENT = 3;
@@ -170,6 +184,7 @@ export function FilamentCalibrationDialog({
     const [isSaving, setIsSaving] = useState(false);
     // filament id -> chosen base filament ids (defaults are auto-picked).
     const [baseChoices, setBaseChoices] = useState<Record<string, string[]>>({});
+    const [printedPlan, setPrintedPlan] = useState<CalibrationPrintPlan | null>(null);
     const wasOpenRef = useRef(open);
 
     const darkestFilamentId = useMemo(() => {
@@ -328,7 +343,7 @@ export function FilamentCalibrationDialog({
         [filaments, selectedIds]
     );
 
-    const calibrationTargets = useMemo(() => {
+    const calibrationTargets = useMemo<CalibrationTarget[]>(() => {
         return selectedFilaments.flatMap((filament) =>
             resolveBaseIds(filament.id)
                 .map((baseId) => {
@@ -353,6 +368,17 @@ export function FilamentCalibrationDialog({
         }),
         [calibrationLayerHeight, firstLayerHeight, maxLayers]
     );
+    const currentPrintPlan = useMemo<CalibrationPrintPlan>(
+        () => ({
+            targets: calibrationTargets,
+            printOptions,
+            layerHeight: calibrationLayerHeight,
+            firstLayerHeight,
+            maxLayers,
+        }),
+        [calibrationTargets, printOptions, calibrationLayerHeight, firstLayerHeight, maxLayers]
+    );
+    const activeMeasurePlan = printedPlan ?? currentPrintPlan;
     const firstLayerPrintHeight = Math.max(calibrationLayerHeight, firstLayerHeight);
     const swapZ = calibrationBaseHeight(printOptions);
 
@@ -369,6 +395,7 @@ export function FilamentCalibrationDialog({
         setMergeReads({});
         setIsSaving(false);
         setBaseChoices({});
+        setPrintedPlan(null);
     }, [layerHeight]);
 
     useEffect(() => {
@@ -397,7 +424,8 @@ export function FilamentCalibrationDialog({
     }, [filaments]);
 
     const handleDownload = useCallback(async () => {
-        const tiles: CalibrationTile[] = calibrationTargets.map(({ filament, base }) => ({
+        const plan = currentPrintPlan;
+        const tiles: CalibrationTile[] = plan.targets.map(({ filament, base }) => ({
             filamentId: filament.id,
             color: filament.color,
             baseFilamentId: base.id,
@@ -409,8 +437,8 @@ export function FilamentCalibrationDialog({
         if (format === 'stl') {
             // The wedge geometry is identical for every filament, so one STL is
             // printed once per filament (swapping the color above the base).
-            const blob = generateCalibrationStl(printOptions);
-            downloadBlob(blob, `kromacut-calibration-${maxLayers}layers.stl`);
+            const blob = generateCalibrationStl(plan.printOptions);
+            downloadBlob(blob, `kromacut-calibration-${plan.maxLayers}layers.stl`);
         } else {
             // Slots follow the full profile order so they map to the user's machine.
             const profileFilaments = filaments.map((f) => ({
@@ -418,10 +446,15 @@ export function FilamentCalibrationDialog({
                 color: f.color,
                 name: filamentLabel(f),
             }));
-            const blob = await generateCalibration3mf(tiles, printOptions, profileFilaments);
+            const blob = await generateCalibration3mf(tiles, plan.printOptions, profileFilaments);
             downloadBlob(blob, `kromacut-calibration-${tiles.length}reads.3mf`);
         }
-    }, [calibrationTargets, filaments, format, printOptions, maxLayers]);
+        setPrintedPlan(plan);
+    }, [currentPrintPlan, filaments, format]);
+
+    const handleEnterMeasure = useCallback(() => {
+        setStep('measure');
+    }, []);
 
     const setRead = useCallback((key: string, value: string) => {
         setReads((prev) => ({ ...prev, [key]: value }));
@@ -434,10 +467,20 @@ export function FilamentCalibrationDialog({
     // Complete read inputs per filament (merge reads excluded — they never
     // affect the fit, only the saved record).
     const readInputs = useMemo(() => {
-        return selectedFilaments.map((filament) => {
-            const targets = calibrationTargets.filter(
-                (target) => target.filament.id === filament.id
-            );
+        const grouped = new Map<string, { filament: Filament; targets: CalibrationTarget[] }>();
+        for (const target of activeMeasurePlan.targets) {
+            const entry = grouped.get(target.filament.id);
+            if (entry) {
+                entry.targets.push(target);
+            } else {
+                grouped.set(target.filament.id, {
+                    filament: target.filament,
+                    targets: [target],
+                });
+            }
+        }
+
+        return [...grouped.values()].map(({ filament, targets }) => {
             const readValues: FrontlitCalibrationRead[] = [];
             let complete = targets.length > 0;
             for (const target of targets) {
@@ -455,23 +498,16 @@ export function FilamentCalibrationDialog({
                 ? {
                       filamentColor: filament.color,
                       opacityLayers: readValues[0]?.opacityLayers,
-                      layerHeight: calibrationLayerHeight,
-                      firstLayerHeight,
+                      layerHeight: activeMeasurePlan.layerHeight,
+                      firstLayerHeight: activeMeasurePlan.firstLayerHeight,
                       baseColor: readValues[0]?.baseColor,
                       reads: readValues,
-                      maxLayers,
+                      maxLayers: activeMeasurePlan.maxLayers,
                   }
                 : null;
             return { filament, targets, input };
         });
-    }, [
-        selectedFilaments,
-        calibrationTargets,
-        reads,
-        calibrationLayerHeight,
-        firstLayerHeight,
-        maxLayers,
-    ]);
+    }, [activeMeasurePlan, reads]);
 
     // Session JND fit, computed once in the background when the entered reads
     // settle. Preview and Save both consume this cached result so the values
@@ -494,9 +530,7 @@ export function FilamentCalibrationDialog({
     const sessionFitEligible = useMemo(() => {
         if (readInputs.length === 0) return false;
         if (readInputs.some((entry) => entry.input === null)) return false;
-        const multiBase = readInputs.filter(
-            (entry) => (entry.input?.reads?.length ?? 0) >= 2
-        );
+        const multiBase = readInputs.filter((entry) => (entry.input?.reads?.length ?? 0) >= 2);
         return multiBase.length >= 2;
     }, [readInputs]);
 
@@ -522,7 +556,7 @@ export function FilamentCalibrationDialog({
                         if (latestSessionKeyRef.current !== key) return;
                         const session = computeFrontlitCalibrationSession({
                             filaments: ready,
-                            maxLayers,
+                            maxLayers: activeMeasurePlan.maxLayers,
                         });
                         setSessionJndFit({
                             key,
@@ -536,7 +570,7 @@ export function FilamentCalibrationDialog({
             });
         }, 800);
         return () => window.clearTimeout(timer);
-    }, [readInputs, sessionFitEligible, sessionKey, sessionJndFit, maxLayers]);
+    }, [readInputs, sessionFitEligible, sessionKey, sessionJndFit, activeMeasurePlan.maxLayers]);
 
     const activeJndFit = sessionJndFit?.key === sessionKey ? sessionJndFit : null;
     // True while an eligible session fit hasn't landed yet (debounce + search).
@@ -962,7 +996,7 @@ export function FilamentCalibrationDialog({
                     <ArrowLeft className="mr-1 h-4 w-4" />
                     Back
                 </Button>
-                <Button onClick={() => setStep('measure')}>
+                <Button onClick={handleEnterMeasure}>
                     Next: Enter Results
                     <ArrowRight className="ml-1 h-4 w-4" />
                 </Button>
@@ -1036,7 +1070,7 @@ export function FilamentCalibrationDialog({
                                                 ? predictFrontlitColor(
                                                       filament.color,
                                                       opacityLayers,
-                                                      calibrationLayerHeight,
+                                                      activeMeasurePlan.layerHeight,
                                                       calibration.td,
                                                       target.base.color
                                                   )
@@ -1062,7 +1096,7 @@ export function FilamentCalibrationDialog({
                                                     <Input
                                                         type="number"
                                                         min={1}
-                                                        max={maxLayers}
+                                                        max={activeMeasurePlan.maxLayers}
                                                         value={reads[target.key] ?? ''}
                                                         onChange={(e) =>
                                                             setRead(target.key, e.target.value)
@@ -1072,14 +1106,14 @@ export function FilamentCalibrationDialog({
                                                         className="h-8 w-20 text-sm"
                                                     />
                                                     <span className="text-[11px] text-muted-foreground">
-                                                        / {maxLayers}
+                                                        / {activeMeasurePlan.maxLayers}
                                                     </span>
                                                 </div>
                                                 <div className="flex items-center gap-1.5">
                                                     <Input
                                                         type="number"
                                                         min={1}
-                                                        max={maxLayers}
+                                                        max={activeMeasurePlan.maxLayers}
                                                         value={mergeReads[target.key] ?? ''}
                                                         onChange={(e) =>
                                                             setMergeRead(target.key, e.target.value)
diff --git a/src/lib/autoPaint.ts b/src/lib/autoPaint.ts
index 93ad108..617953a 100644
--- a/src/lib/autoPaint.ts
+++ b/src/lib/autoPaint.ts
@@ -270,7 +270,7 @@ export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
     const a2 = (1 + g) * lab2.a;
     const adjustedChroma1 = Math.hypot(a1, lab1.b);
     const adjustedChroma2 = Math.hypot(a2, lab2.b);
-    const hue = (a: number, b: number) => (Math.atan2(b, a) * 180 / Math.PI + 360) % 360;
+    const hue = (a: number, b: number) => ((Math.atan2(b, a) * 180) / Math.PI + 360) % 360;
     const hue1 = hue(a1, lab1.b);
     const hue2 = hue(a2, lab2.b);
     const deltaL = lab2.L - lab1.L;
@@ -284,7 +284,9 @@ export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
                 ? hue2 - hue1 + 360
                 : hue2 - hue1 - 360;
     const deltaHue =
-        2 * Math.sqrt(adjustedChroma1 * adjustedChroma2) * Math.sin((hueDifference / 2) * Math.PI / 180);
+        2 *
+        Math.sqrt(adjustedChroma1 * adjustedChroma2) *
+        Math.sin(((hueDifference / 2) * Math.PI) / 180);
     const meanL = (lab1.L + lab2.L) / 2;
     const meanChroma = (adjustedChroma1 + adjustedChroma2) / 2;
     const meanHue =
@@ -297,17 +299,17 @@ export function deltaE2000Lab(lab1: Lab, lab2: Lab): number {
                 : (hue1 + hue2 - 360) / 2;
     const hueWeight =
         1 -
-        0.17 * Math.cos((meanHue - 30) * Math.PI / 180) +
-        0.24 * Math.cos(2 * meanHue * Math.PI / 180) +
-        0.32 * Math.cos((3 * meanHue + 6) * Math.PI / 180) -
-        0.2 * Math.cos((4 * meanHue - 63) * Math.PI / 180);
-    const lightnessScale = 1 + 0.015 * (meanL - 50) ** 2 / Math.sqrt(20 + (meanL - 50) ** 2);
+        0.17 * Math.cos(((meanHue - 30) * Math.PI) / 180) +
+        0.24 * Math.cos((2 * meanHue * Math.PI) / 180) +
+        0.32 * Math.cos(((3 * meanHue + 6) * Math.PI) / 180) -
+        0.2 * Math.cos(((4 * meanHue - 63) * Math.PI) / 180);
+    const lightnessScale = 1 + (0.015 * (meanL - 50) ** 2) / Math.sqrt(20 + (meanL - 50) ** 2);
     const chromaScale = 1 + 0.045 * meanChroma;
     const hueScale = 1 + 0.015 * meanChroma * hueWeight;
     const rotation =
         -2 *
         Math.sqrt(meanChroma ** 7 / (meanChroma ** 7 + 25 ** 7)) *
-        Math.sin((60 * Math.exp(-(((meanHue - 275) / 25) ** 2))) * Math.PI / 180);
+        Math.sin((60 * Math.exp(-(((meanHue - 275) / 25) ** 2)) * Math.PI) / 180);
 
     return Math.sqrt(
         (deltaL / lightnessScale) ** 2 +
@@ -349,19 +351,14 @@ function realizedColorError(left: Lab, right: Lab): number {
  * @param thickness - Layer thickness (mm)
  * @returns Opacity value (0-1); calibrated TDs return the least-opaque channel
  */
-export function getOpacity(
-    filamentTD: number | CalibrationRgb,
-    thickness: number
-): number {
+export function getOpacity(filamentTD: number | CalibrationRgb, thickness: number): number {
     if (thickness <= 0) return 0;
 
     const channelTds: CalibrationRgb =
         typeof filamentTD === 'number' ? [filamentTD, filamentTD, filamentTD] : filamentTD;
     if (channelTds.some((td) => !Number.isFinite(td) || td <= 0)) return 0;
 
-    return Math.min(
-        ...channelTds.map((td) => 1 - Math.pow(0.1, thickness / td))
-    );
+    return Math.min(...channelTds.map((td) => 1 - Math.pow(0.1, thickness / td)));
 }
 
 // =============================================================================
@@ -495,9 +492,10 @@ export function calculateIdealHeight(
     //   0.05 = 10^(-thickness/TD)  →  thickness = TD × log10(20) ≈ TD × 1.3
     // Dark filaments have low TD (e.g. 0.5mm) → foundation ≈ 0.65mm
     const firstFilament = sortedFilaments[0];
+    const foundationTdChannels = channelHds(firstFilament);
     // Use the least-opaque (largest) channel hiding distance so every channel
     // reaches ~95% opacity.
-    const foundationTd = Math.max(...channelHds(firstFilament));
+    const foundationTd = Math.max(...foundationTdChannels);
     const opacityThickness = foundationTd * 1.3; // 95% opaque
     // Ensure at least the base thickness (avoid unnecessary extra layers)
     const foundationThickness = Math.max(baseThickness, opacityThickness);
@@ -506,7 +504,7 @@ export function calculateIdealHeight(
         filamentId: firstFilament.id,
         filamentColor: firstFilament.color,
         filamentTd: firstFilament.td,
-        filamentTdChannels: channelHds(firstFilament),
+        filamentTdChannels: foundationTdChannels,
         startHeight: 0,
         endHeight: foundationThickness,
         idealThickness: foundationThickness,
@@ -548,7 +546,7 @@ export function calculateIdealHeight(
             filamentId: filament.id,
             filamentColor: filament.color,
             filamentTd: filament.td,
-            filamentTdChannels: channelHds(filament),
+            filamentTdChannels: transitionTd,
             startHeight: currentHeight,
             endHeight: currentHeight + transitionThickness,
             idealThickness: transitionThickness,
@@ -640,9 +638,7 @@ export function ceilAutoPaintHeightToPrintableStack(
     const first = printableFirstLayerHeight(layerHeight, firstLayerHeight);
     if (height <= first + PRINTABLE_HEIGHT_EPSILON) return roundPrintableHeight(first);
 
-    const regularLayers = Math.ceil(
-        (height - first - PRINTABLE_HEIGHT_EPSILON) / layerHeight
-    );
+    const regularLayers = Math.ceil((height - first - PRINTABLE_HEIGHT_EPSILON) / layerHeight);
     return roundPrintableHeight(first + Math.max(0, regularLayers) * layerHeight);
 }
 
@@ -665,9 +661,7 @@ export function floorAutoPaintHeightToPrintableStack(
     // Return zero rather than silently exceeding the caller's maximum.
     if (maxHeight < first - PRINTABLE_HEIGHT_EPSILON) return 0;
 
-    const regularLayers = Math.floor(
-        (maxHeight - first + PRINTABLE_HEIGHT_EPSILON) / layerHeight
-    );
+    const regularLayers = Math.floor((maxHeight - first + PRINTABLE_HEIGHT_EPSILON) / layerHeight);
     return roundPrintableHeight(first + Math.max(0, regularLayers) * layerHeight);
 }
 
@@ -1044,7 +1038,9 @@ function mapTargetsWithSeparation(
     const result = new Array<MappedTarget>(imageTargets.length);
     const used = new Set<number>();
     // Assign dominant colors first.
-    const order = imageTargets.map((_, i) => i).sort((a, b) => imageTargets[b].weight - imageTargets[a].weight);
+    const order = imageTargets
+        .map((_, i) => i)
+        .sort((a, b) => imageTargets[b].weight - imageTargets[a].weight);
     for (const i of order) {
         const target = imageTargets[i];
         let bestJ = -1;
@@ -1403,9 +1399,9 @@ function findBestFilamentOrderWithOptimizer(
         allowRepeatedSwaps,
     });
 
-    const sortedFilaments = result.order.map((sf) =>
-        filaments.find((f) => f.id === sf.id)
-    ).filter((f): f is Filament => f !== undefined);
+    const sortedFilaments = result.order
+        .map((sf) => filaments.find((f) => f.id === sf.id))
+        .filter((f): f is Filament => f !== undefined);
 
     return { sortedFilaments, result };
 }
@@ -1498,7 +1494,6 @@ export function generateAutoLayers(
 
         sortedFilaments = orderingResult.sortedFilaments;
         optimizerResult = orderingResult.result;
-
     } else {
         // Standard: sort by luminance (dark to light)
         sortedFilaments = [...filaments].sort((a, b) => {
@@ -1565,7 +1560,8 @@ export function generateAutoLayers(
     // Add optimizer metadata if available
     if (optimizerResult) {
         result.optimizerMetadata = {
-            algorithm: optimizerResult.resolvedAlgorithm || optimizerOptions?.algorithm || 'balanced',
+            algorithm:
+                optimizerResult.resolvedAlgorithm || optimizerOptions?.algorithm || 'balanced',
             score: optimizerResult.score,
             iterations: optimizerResult.iterations,
             converged: optimizerResult.converged,
@@ -1688,7 +1684,7 @@ function calculateAutoConfidence(
     // 1. CALIBRATION QUALITY
     // Average confidence of all filament calibrations using actual calibration data
     let calibrationQuality = 0.5; // Default baseline for uncalibrated filaments
-    
+
     if (printedFilaments.length > 0) {
         const confidences = printedFilaments.map((f) =>
             computeProfileConfidence({
diff --git a/src/lib/calibration.ts b/src/lib/calibration.ts
index a5d3bea..227c735 100644
--- a/src/lib/calibration.ts
+++ b/src/lib/calibration.ts
@@ -597,10 +597,7 @@ export function channelHds(filament: {
     td: number;
     calibration?: unknown;
 }): CalibrationRgb {
-    return (
-        activeFrontlitCalibration(filament)?.td ??
-        deriveChannelTds(filament.color, filament.td)
-    );
+    return activeFrontlitCalibration(filament)?.td ?? deriveChannelTds(filament.color, filament.td);
 }
 
 function frontlitConfidence(opacityLayers: number, tdSingle: number, maxLayers?: number): number {
@@ -783,19 +780,27 @@ function fitSessionJnd(
     });
     if (eligible.length < 2) return undefined;
 
-    const evaluate = (jnd: number) =>
-        eligible.reduce(
+    const residualCache = new Map<number, number>();
+    const evaluate = (jnd: number) => {
+        const key = Number(jnd.toFixed(6));
+        const cached = residualCache.get(key);
+        if (cached !== undefined) return cached;
+        const residual = eligible.reduce(
             (sum, input) =>
                 sum +
                 calibrationFitResidualForJnd(
                     { ...input, maxLayers: input.maxLayers ?? maxLayers },
-                    jnd
+                    key
                 ),
             0
         );
+        residualCache.set(key, residual);
+        return residual;
+    };
 
     let bestJnd = OPACITY_JND;
     let bestResidual = evaluate(OPACITY_JND);
+    const defaultResidual = bestResidual;
     for (let jnd = JND_FIT_MIN; jnd <= JND_FIT_MAX + 1e-9; jnd += 0.2) {
         const rounded = Number(jnd.toFixed(2));
         const residual = evaluate(rounded);
@@ -815,7 +820,6 @@ function fitSessionJnd(
         }
     }
 
-    const defaultResidual = evaluate(OPACITY_JND);
     const improvement = defaultResidual - bestResidual;
     if (improvement < Math.max(0.1, eligible.length * 0.04)) return undefined;
     if (bestJnd <= JND_FIT_MIN + 1e-9 || bestJnd >= JND_FIT_MAX - 1e-9) return undefined;
diff --git a/src/lib/nextBestColor.ts b/src/lib/nextBestColor.ts
index 5bc572d..7a394df 100644
--- a/src/lib/nextBestColor.ts
+++ b/src/lib/nextBestColor.ts
@@ -5,8 +5,16 @@ import { channelHds, deriveChannelTds, type CalibrationRgb } from './calibration
 // Minimal color math — inlined to avoid pulling in autoPaint's optimizer dep.
 // ---------------------------------------------------------------------------
 
-interface RGB { r: number; g: number; b: number }
-interface Lab { L: number; a: number; b: number }
+interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+interface Lab {
+    L: number;
+    a: number;
+    b: number;
+}
 
 function hexToRgb(hex: string): RGB {
     const h = hex.replace(/^#/, '');
@@ -19,31 +27,43 @@ function hexToRgb(hex: string): RGB {
 
 // IEC 61966-2-1 sRGB linearisation thresholds and coefficients.
 const SRGB_LINEARISE_THRESHOLD = 0.04045;
-const SRGB_LINEARISE_SCALE     = 12.92;
-const SRGB_LINEARISE_OFFSET    = 0.055;
-const SRGB_LINEARISE_DENOM     = 1.055;
-const SRGB_LINEARISE_GAMMA     = 2.4;
+const SRGB_LINEARISE_SCALE = 12.92;
+const SRGB_LINEARISE_OFFSET = 0.055;
+const SRGB_LINEARISE_DENOM = 1.055;
+const SRGB_LINEARISE_GAMMA = 2.4;
 
 // IEC 61966-2-1 sRGB → CIE XYZ (D65) matrix row coefficients.
-const M_RX = 0.4124564, M_GX = 0.3575761, M_BX = 0.1804375;
-const M_RY = 0.2126729, M_GY = 0.7151522, M_BY = 0.0721750;
-const M_RZ = 0.0193339, M_GZ = 0.1191920, M_BZ = 0.9503041;
+const M_RX = 0.4124564,
+    M_GX = 0.3575761,
+    M_BX = 0.1804375;
+const M_RY = 0.2126729,
+    M_GY = 0.7151522,
+    M_BY = 0.072175;
+const M_RZ = 0.0193339,
+    M_GZ = 0.119192,
+    M_BZ = 0.9503041;
 
 // CIE XYZ (D65) → sRGB inverse matrix row coefficients.
-const M_INV_XR =  3.2404542, M_INV_YR = -1.5371385, M_INV_ZR = -0.4985314;
-const M_INV_XG = -0.9692660, M_INV_YG =  1.8760108, M_INV_ZG =  0.0415560;
-const M_INV_XB =  0.0556434, M_INV_YB = -0.2040259, M_INV_ZB =  1.0572252;
+const M_INV_XR = 3.2404542,
+    M_INV_YR = -1.5371385,
+    M_INV_ZR = -0.4985314;
+const M_INV_XG = -0.969266,
+    M_INV_YG = 1.8760108,
+    M_INV_ZG = 0.041556;
+const M_INV_XB = 0.0556434,
+    M_INV_YB = -0.2040259,
+    M_INV_ZB = 1.0572252;
 
 // CIE standard illuminant D65 tristimulus values (normalises XYZ to [0,1]).
 const D65_X = 0.95047;
-const D65_Y = 1.00000;
+const D65_Y = 1.0;
 const D65_Z = 1.08883;
 
 // CIE L*a*b* cube-root approximation thresholds and coefficients (CIE 1976).
-const LAB_EPSILON     = 0.008856; // (6/29)³
-const LAB_KAPPA       = 7.787;    // (29/6)² / 3  — slope of the linear segment
-const LAB_DELTA_16    = 16 / 116; // y-intercept of the linear segment
-const LAB_INV_CBRT    = 6 / 29;   // cbrt(LAB_EPSILON) — Lab→XYZ cube-root threshold
+const LAB_EPSILON = 0.008856; // (6/29)³
+const LAB_KAPPA = 7.787; // (29/6)² / 3  — slope of the linear segment
+const LAB_DELTA_16 = 16 / 116; // y-intercept of the linear segment
+const LAB_INV_CBRT = 6 / 29; // cbrt(LAB_EPSILON) — Lab→XYZ cube-root threshold
 
 // Threshold for linear RGB values in the sRGB de-linearisation step.
 // Derived from SRGB_LINEARISE_THRESHOLD / SRGB_LINEARISE_SCALE ≈ 0.0031308.
@@ -56,13 +76,15 @@ function rgbToLab(rgb: RGB): Lab {
             ? s / SRGB_LINEARISE_SCALE
             : Math.pow((s + SRGB_LINEARISE_OFFSET) / SRGB_LINEARISE_DENOM, SRGB_LINEARISE_GAMMA);
     };
-    const r = linearise(rgb.r), g = linearise(rgb.g), b = linearise(rgb.b);
+    const r = linearise(rgb.r),
+        g = linearise(rgb.g),
+        b = linearise(rgb.b);
 
     const fx = (r * M_RX + g * M_GX + b * M_BX) / D65_X;
     const fy = (r * M_RY + g * M_GY + b * M_BY) / D65_Y;
     const fz = (r * M_RZ + g * M_GZ + b * M_BZ) / D65_Z;
 
-    const f = (t: number) => t > LAB_EPSILON ? Math.cbrt(t) : LAB_KAPPA * t + LAB_DELTA_16;
+    const f = (t: number) => (t > LAB_EPSILON ? Math.cbrt(t) : LAB_KAPPA * t + LAB_DELTA_16);
     return { L: 116 * f(fy) - 16, a: 500 * (f(fx) - f(fy)), b: 200 * (f(fy) - f(fz)) };
 }
 
@@ -71,7 +93,7 @@ function labToHex(lab: Lab): string {
     const fy = (lab.L + 16) / 116;
     const fx = lab.a / 500 + fy;
     const fz = fy - lab.b / 200;
-    const invF = (f: number) => f > LAB_INV_CBRT ? f * f * f : (f - LAB_DELTA_16) / LAB_KAPPA;
+    const invF = (f: number) => (f > LAB_INV_CBRT ? f * f * f : (f - LAB_DELTA_16) / LAB_KAPPA);
     const X = D65_X * invF(fx);
     const Y = D65_Y * invF(fy);
     const Z = D65_Z * invF(fz);
@@ -125,15 +147,10 @@ function linearChannelToSrgb(channel: number): number {
 // colorSpace.blendSrgbChannel (composite the transmissive foreground over the
 // background in linear light, then re-encode to sRGB). Accepts a scalar HD or
 // the per-channel R, G, B hiding distances auto-paint blends with.
-export function blendRgb(
-    bg: RGB,
-    fg: RGB,
-    td: number | CalibrationRgb,
-    thickness: number
-): RGB {
+export function blendRgb(bg: RGB, fg: RGB, td: number | CalibrationRgb, thickness: number): RGB {
     if (thickness <= 0) return bg;
     const channelTd: CalibrationRgb = typeof td === 'number' ? [td, td, td] : td;
-    if (channelTd.some((v) => !Number.isFinite(v) || v <= 0)) return bg;
+    if (channelTd.some((v) => !Number.isFinite(v) || v <= 0)) return fg;
     const blendChannel = (bgC: number, fgC: number, tdC: number) => {
         const t = Math.pow(0.1, thickness / tdC);
         return linearChannelToSrgb(
@@ -283,7 +300,7 @@ export function nextBestColor(
     // blend-line midpoints (which land within ~0.5 ΔE of their segment) don't
     // show up as a meaningful gap.
     const COVERAGE_FLOOR = 1.0;
-    const effectiveReachable = currentReachable.map(e => e >= COVERAGE_FLOOR ? e : 0);
+    const effectiveReachable = currentReachable.map((e) => (e >= COVERAGE_FLOOR ? e : 0));
 
     const baselineTotal = effectiveReachable.reduce((s, e, i) => s + e * counts[i], 0);
     const baselineAvgDeltaE = totalPixels > 0 ? baselineTotal / totalPixels : 0;
@@ -307,10 +324,13 @@ export function nextBestColor(
 
     // These thresholds are still on raw error, used only for scoring weights (not filtering).
     const sortedReachable = [...effectiveReachable].sort((a, b) => a - b);
-    const p90Threshold = sortedReachable[Math.floor(sortedReachable.length * 0.90)];
-    const maxReachable  = sortedReachable[sortedReachable.length - 1];
+    const p90Threshold = sortedReachable[Math.floor(sortedReachable.length * 0.9)];
+    const maxReachable = sortedReachable[sortedReachable.length - 1];
 
-    interface LabCandidate { lab: Lab; hex: string }
+    interface LabCandidate {
+        lab: Lab;
+        hex: string;
+    }
     const seen = new Set<string>();
     const pool: LabCandidate[] = [];
 
@@ -347,7 +367,14 @@ export function nextBestColor(
     // -------------------------------------------------------------------------
     // Score every candidate.
     // -------------------------------------------------------------------------
-    interface CandidateScore { lab: Lab; hex: string; weightedGain: number; rawGain: number; nearestFilamentDE: number; estimatedTd: number }
+    interface CandidateScore {
+        lab: Lab;
+        hex: string;
+        weightedGain: number;
+        rawGain: number;
+        nearestFilamentDE: number;
+        estimatedTd: number;
+    }
     const scores: CandidateScore[] = [];
 
     for (const { lab, hex } of pool) {
@@ -355,7 +382,10 @@ export function nextBestColor(
         let estimatedTd = filaments[0].td;
         for (let fi = 0; fi < filamentLabs.length; fi++) {
             const de = deltaELab(lab, filamentLabs[fi]);
-            if (de < nearestFilamentDE) { nearestFilamentDE = de; estimatedTd = filamentTds[fi]; }
+            if (de < nearestFilamentDE) {
+                nearestFilamentDE = de;
+                estimatedTd = filamentTds[fi];
+            }
         }
         const candidateRgb = hexToRgb(hex);
         // The candidate is a hypothetical uncalibrated filament, so model it the
@@ -380,11 +410,14 @@ export function nextBestColor(
             }
             const improvement = effectiveReachable[i] - newReachable;
             if (improvement > 0) {
-                const w = effectiveReachable[i] >= maxReachable ? 3.0
-                        : effectiveReachable[i] >= p90Threshold ? 2.0
-                        : 1.0;
+                const w =
+                    effectiveReachable[i] >= maxReachable
+                        ? 3.0
+                        : effectiveReachable[i] >= p90Threshold
+                          ? 2.0
+                          : 1.0;
                 weightedGain += improvement * counts[i] * w;
-                rawGain      += improvement * counts[i];
+                rawGain += improvement * counts[i];
             }
         }
 
@@ -398,7 +431,10 @@ export function nextBestColor(
     const maxIsolation = Math.max(...scores.map((s) => s.nearestFilamentDE));
 
     // Rank by weighted gain; report improvement from unweighted gain so improvementPct ∈ [0,100].
-    const winner = scores.reduce((best, s) => s.weightedGain > best.weightedGain ? s : best, scores[0]);
+    const winner = scores.reduce(
+        (best, s) => (s.weightedGain > best.weightedGain ? s : best),
+        scores[0]
+    );
 
     // -------------------------------------------------------------------------
     // Build the result for the winning candidate.
@@ -429,7 +465,10 @@ export function nextBestColor(
     let nearestDE = Infinity;
     for (let fi = 0; fi < filamentLabs.length; fi++) {
         const de = deltaELab(winner.lab, filamentLabs[fi]);
-        if (de < nearestDE) { nearestDE = de; nearestFilamentIdx = fi; }
+        if (de < nearestDE) {
+            nearestDE = de;
+            nearestFilamentIdx = fi;
+        }
     }
     const recommendedTd = filaments[nearestFilamentIdx].td;
 
@@ -438,20 +477,20 @@ export function nextBestColor(
 
     console.group(
         `[NextBestColor] ${filaments.length} filament${filaments.length !== 1 ? 's' : ''} → ` +
-        `${imageSwatches.length} image colors | ${totalPixels.toLocaleString()} px | ` +
-        `${pool.length} candidates (${scores.length} scored)`
+            `${imageSwatches.length} image colors | ${totalPixels.toLocaleString()} px | ` +
+            `${pool.length} candidates (${scores.length} scored)`
     );
     console.log(`  Baseline avg ΔE:  ${baselineAvgDeltaE.toFixed(2)}  (blend-aware)`);
     console.log(`  Suggestion:       ${winner.hex.toUpperCase()}  HD ${recommendedTd.toFixed(2)}`);
     console.log(
         `  Accuracy gain:    +${improvementPct.toFixed(1)}%  ` +
-        `(${pixelsCaptured.toLocaleString()} px / ` +
-        `${((pixelsCaptured / totalPixels) * 100).toFixed(1)}% of image improve)`
+            `(${pixelsCaptured.toLocaleString()} px / ` +
+            `${((pixelsCaptured / totalPixels) * 100).toFixed(1)}% of image improve)`
     );
     console.log(
         `  Isolation:        ${isolationScore.toFixed(3)}  ` +
-        `(nearest filament ΔE ${winner.nearestFilamentDE.toFixed(1)} / ` +
-        `max ${maxIsolation.toFixed(1)})`
+            `(nearest filament ΔE ${winner.nearestFilamentDE.toFixed(1)} / ` +
+            `max ${maxIsolation.toFixed(1)})`
     );
     console.groupEnd();
 
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index dafb18f..4a52a6f 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -248,9 +248,7 @@ export function createSequenceScorer(context: ScoringContext): (filaments: Filam
 
     return (filaments) => {
         if (filaments.length === 0) return Infinity;
-        const sequenceKey = filaments
-            .map(filamentOpticalKey)
-            .join('|');
+        const sequenceKey = filaments.map(filamentOpticalKey).join('|');
         let palette = paletteCache.get(sequenceKey);
         if (!palette) {
             palette = buildAchievableColorPalette(
@@ -359,10 +357,7 @@ function maxSequenceLength(filaments: Filament[], maxExtraRepeats: number): numb
     return filaments.length + maxExtraRepeats;
 }
 
-function isBetterCandidate(
-    candidate: ScoredSequence,
-    current: ScoredSequence | null
-): boolean {
+function isBetterCandidate(candidate: ScoredSequence, current: ScoredSequence | null): boolean {
     if (!current) return true;
     if (candidate.score !== current.score) return candidate.score < current.score;
     return sequenceKey(candidate.order) < sequenceKey(current.order);
@@ -377,11 +372,7 @@ function reportProgress(
     options.onProgress?.(Math.min(iteration, total), Math.max(total, 1), bestScore);
 }
 
-function withProgressSpan(
-    options: OptimizerOptions,
-    start: number,
-    end: number
-): OptimizerOptions {
+function withProgressSpan(options: OptimizerOptions, start: number, end: number): OptimizerOptions {
     if (!options.onProgress) return { ...options, onProgress: undefined };
 
     return {
@@ -540,8 +531,7 @@ function optimizeBeamSearch(
     const allowRepeatedSwaps = maxExtraRepeats > 0;
     const maximumLength = maxSequenceLength(filaments, maxExtraRepeats);
     const beamWidth = options.beamWidth ?? BALANCED_BEAM_WIDTH;
-    const totalIterations =
-        filaments.length + (maximumLength - 1) * beamWidth * filaments.length;
+    const totalIterations = filaments.length + (maximumLength - 1) * beamWidth * filaments.length;
     let iterations = 0;
     let best: ScoredSequence | null = null;
     reportProgress(options, 0, totalIterations, Infinity);
@@ -689,7 +679,10 @@ function buildVariableLengthNeighbor(
             candidate[position] = eligible[rng.nextInt(0, eligible.length)];
         }
 
-        if (isValidSequence(candidate, allowRepeatedSwaps) && !sequenceEquals(candidate, sequence)) {
+        if (
+            isValidSequence(candidate, allowRepeatedSwaps) &&
+            !sequenceEquals(candidate, sequence)
+        ) {
             return candidate;
         }
     }
@@ -722,12 +715,7 @@ function runAnneal(
     while (iterations < maxIterations && temperature > SA_MIN_TEMPERATURE) {
         iterations++;
 
-        const newOrder = buildVariableLengthNeighbor(
-            currentOrder,
-            filaments,
-            maxExtraRepeats,
-            rng
-        );
+        const newOrder = buildVariableLengthNeighbor(currentOrder, filaments, maxExtraRepeats, rng);
         if (sequenceEquals(newOrder, currentOrder)) {
             temperature *= coolingRate;
             onStep?.(best.score);
@@ -848,9 +836,7 @@ function optimizeHybrid(
     // seeded-random starts. Keep the global best across all restarts.
     for (let restart = 0; restart < plan.restarts; restart++) {
         const initialOrder =
-            restart === 0
-                ? best.order
-                : randomInitialSequence(filaments, maxExtraRepeats, rng);
+            restart === 0 ? best.order : randomInitialSequence(filaments, maxExtraRepeats, rng);
 
         const outcome = runAnneal(
             initialOrder,
@@ -917,11 +903,7 @@ function optimizeExactBase(
     }
 
     const deep = optimizeDeep(filaments, scoreSequence, withProgressSpan(options, 0, 0.4));
-    const exact = optimizeExhaustive(
-        filaments,
-        scoreSequence,
-        withProgressSpan(options, 0.4, 1)
-    );
+    const exact = optimizeExhaustive(filaments, scoreSequence, withProgressSpan(options, 0.4, 1));
     const exactCandidate = { order: exact.order, score: exact.score };
     const deepCandidate = { order: deep.order, score: deep.score };
     const best = isBetterCandidate(deepCandidate, exactCandidate) ? deepCandidate : exactCandidate;
@@ -986,14 +968,24 @@ export function optimizeFilamentOrder(
     };
 
     const resolved = resolveAlgorithm(opts.algorithm, filaments.length);
+    const scoringContext: ScoringContext = {
+        ...context,
+        preserveSeparation: opts.preserveSeparation ?? context.preserveSeparation ?? false,
+    };
+    opts.preserveSeparation = scoringContext.preserveSeparation;
 
     // Tiers share the same automatic seed so higher effort builds directly on
     // comparable deterministic search paths. The cache key still includes the
     // requested tier because their budgets and outputs can differ.
-    const defaultSeedInput = canonicalOptimizerInput(filaments, context, 'tier-comparison', opts);
+    const defaultSeedInput = canonicalOptimizerInput(
+        filaments,
+        scoringContext,
+        'tier-comparison',
+        opts
+    );
     const seed = opts.seed ?? stableHash32(defaultSeedInput);
     opts.seed = seed;
-    const cacheKey = canonicalOptimizerInput(filaments, context, opts.algorithm, opts, seed);
+    const cacheKey = canonicalOptimizerInput(filaments, scoringContext, opts.algorithm, opts, seed);
 
     if (opts.cachingEnabled) {
         const cached = globalCache.get(cacheKey);
@@ -1004,12 +996,7 @@ export function optimizeFilamentOrder(
     }
 
     let result: OptimizerResult;
-    // The scoring mode lives in OptimizerOptions; mirror it into the context the
-    // scorer reads so callers only need to set it in one place.
-    const scoreSequence = createSequenceScorer({
-        ...context,
-        preserveSeparation: opts.preserveSeparation ?? context.preserveSeparation,
-    });
+    const scoreSequence = createSequenceScorer(scoringContext);
 
     switch (resolved) {
         case 'exhaustive':
diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 1a3e7cc..3256a67 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -42,7 +42,8 @@ export function sanitizeProfileFilament(value: unknown): Filament | null {
         typeof value.id !== 'string' ||
         typeof value.color !== 'string' ||
         typeof value.td !== 'number' ||
-        !Number.isFinite(value.td)
+        !Number.isFinite(value.td) ||
+        value.td <= 0
     ) {
         return null;
     }
diff --git a/src/lib/regionWeighting.ts b/src/lib/regionWeighting.ts
index 5e8d8db..dd224d9 100644
--- a/src/lib/regionWeighting.ts
+++ b/src/lib/regionWeighting.ts
@@ -21,6 +21,7 @@ export interface RegionWeightOptions {
 }
 
 const DEFAULT_CENTER_WEIGHT_STRENGTH = 0.5;
+const MAX_CENTER_WEIGHT_STRENGTH = 0.999;
 
 /** A spatial weight lookup bound to a fixed image size. */
 export type SpatialWeight = (x: number, y: number) => number;
@@ -32,6 +33,11 @@ function nearestCenterDistance(width: number, height: number): number {
     return maxDistance > 0 ? Math.hypot(nearestX, nearestY) / maxDistance : 0;
 }
 
+function normalizeCenterStrength(strength: number): number {
+    if (!Number.isFinite(strength)) return DEFAULT_CENTER_WEIGHT_STRENGTH;
+    return Math.min(MAX_CENTER_WEIGHT_STRENGTH, Math.max(0, strength));
+}
+
 /**
  * Build a center-priority weight function for a fixed image size. Every term
  * that depends only on the size (fall-off denominator, normalization bounds,
@@ -43,10 +49,11 @@ export function createCenterWeight(
     height: number,
     strength: number = DEFAULT_CENTER_WEIGHT_STRENGTH
 ): SpatialWeight {
+    const resolvedStrength = normalizeCenterStrength(strength);
     const centerX = width / 2;
     const centerY = height / 2;
     const maxDistance = Math.hypot(centerX, centerY);
-    const denominator = 2 * (1 - strength);
+    const denominator = 2 * (1 - resolvedStrength);
     const min = Math.exp(-1 / denominator);
     const max = Math.exp(-(nearestCenterDistance(width, height) ** 2 / denominator));
     const range = max - min;
@@ -149,6 +156,7 @@ function generateCenterWeightedMap(
     weights: Float32Array,
     strength: number
 ): void {
+    const resolvedStrength = normalizeCenterStrength(strength);
     const centerX = width / 2;
     const centerY = height / 2;
     const maxDist = Math.sqrt(centerX * centerX + centerY * centerY);
@@ -162,7 +170,9 @@ function generateCenterWeightedMap(
 
             // Gaussian fall-off: weight = 1 at center, decreases with distance
             // strength controls how quickly weight falls off
-            const weight = Math.exp(-((normalizedDist * normalizedDist) / (2 * (1 - strength))));
+            const weight = Math.exp(
+                -((normalizedDist * normalizedDist) / (2 * (1 - resolvedStrength)))
+            );
 
             weights[y * width + x] = weight;
         }
diff --git a/tests/nextBestColor.test.ts b/tests/nextBestColor.test.ts
index b54ba92..638d27d 100644
--- a/tests/nextBestColor.test.ts
+++ b/tests/nextBestColor.test.ts
@@ -1,17 +1,16 @@
 import assert from 'node:assert/strict';
 import test from 'node:test';
-import { nextBestColor} from '../src/lib/nextBestColor.ts';
+import { nextBestColor } from '../src/lib/nextBestColor.ts';
 import type { Filament } from '../src/types/index.ts';
 
-
 function filament(id: string, color: string, td: number): Filament {
     return { id, color, td };
 }
 
 const BLACK = filament('black', '#000000', 1.0);
 const WHITE = filament('white', '#ffffff', 2.0);
-const RED   = filament('red',   '#ff0000', 1.5);
-const BLUE  = filament('blue',  '#0000ff', 2.5);
+const RED = filament('red', '#ff0000', 1.5);
+const BLUE = filament('blue', '#0000ff', 2.5);
 
 // ---------------------------------------------------------------------------
 // Edge cases
@@ -34,7 +33,6 @@ test('returns null candidate when all swatches are already covered', () => {
     assert.equal(r.candidate, null);
 });
 
-
 test('returns null candidate when image palette exactly matches the filament set', () => {
     // Every image swatch is one of the existing filaments — nothing to add.
     const r = nextBestColor(
@@ -76,7 +74,7 @@ test('blend-aware: far candidate wins when its segment covers the common color t
         [BLACK],
         [
             { hex: '#888888', count: 1000 }, // common mid-grey
-            { hex: '#eeeeee', count: 1 },    // rare near-white
+            { hex: '#eeeeee', count: 1 }, // rare near-white
         ]
     );
     assert.ok(r.candidate !== null);
@@ -93,12 +91,12 @@ test('pixel count weighting: common color beats rare one when blend segments div
     const r = nextBestColor(
         [BLACK, WHITE],
         [
-            { hex: '#606060', count: 1 },    // grey — on L-axis blend, covered
-            { hex: '#808080', count: 1 },    // grey — covered
-            { hex: '#a0a0a0', count: 1 },    // grey — covered
-            { hex: '#c0c0c0', count: 1 },    // grey — covered
+            { hex: '#606060', count: 1 }, // grey — on L-axis blend, covered
+            { hex: '#808080', count: 1 }, // grey — covered
+            { hex: '#a0a0a0', count: 1 }, // grey — covered
+            { hex: '#c0c0c0', count: 1 }, // grey — covered
             { hex: '#ff6666', count: 1000 }, // desaturated red — common
-            { hex: '#00ffff', count: 1 },    // cyan — opposite hue, rare
+            { hex: '#00ffff', count: 1 }, // cyan — opposite hue, rare
         ]
     );
     assert.ok(r.candidate !== null);
@@ -120,12 +118,12 @@ test('p100 weighting tips ranking: rare maximally-underserved color beats common
     const r = nextBestColor(
         [BLACK, WHITE],
         [
-            { hex: '#606060', count: 1 },   // grey — covered by L-axis blend
-            { hex: '#808080', count: 1 },   // grey — covered
-            { hex: '#a0a0a0', count: 1 },   // grey — covered
-            { hex: '#c0c0c0', count: 1 },   // grey — covered
-            { hex: '#ff8888', count: 5 },   // desaturated red — moderate distance
-            { hex: '#0000ff', count: 1 },   // blue — maximum distance (p100)
+            { hex: '#606060', count: 1 }, // grey — covered by L-axis blend
+            { hex: '#808080', count: 1 }, // grey — covered
+            { hex: '#a0a0a0', count: 1 }, // grey — covered
+            { hex: '#c0c0c0', count: 1 }, // grey — covered
+            { hex: '#ff8888', count: 5 }, // desaturated red — moderate distance
+            { hex: '#0000ff', count: 1 }, // blue — maximum distance (p100)
         ]
     );
     assert.ok(r.candidate !== null);
@@ -147,8 +145,10 @@ test('improvementPct stays ≤ 100 when p100 weighting selects the winner', () =
         ]
     );
     assert.ok(r.candidate !== null);
-    assert.ok(r.candidate.improvementPct <= 100,
-        `expected ≤ 100, got ${r.candidate.improvementPct}`);
+    assert.ok(
+        r.candidate.improvementPct <= 100,
+        `expected ≤ 100, got ${r.candidate.improvementPct}`
+    );
 });
 
 // ---------------------------------------------------------------------------
@@ -165,7 +165,10 @@ test('improvementPct is > 0 and ≤ 100', () => {
     );
     assert.ok(r.candidate !== null);
     assert.ok(r.candidate.improvementPct > 0, `expected > 0, got ${r.candidate.improvementPct}`);
-    assert.ok(r.candidate.improvementPct <= 100, `expected ≤ 100, got ${r.candidate.improvementPct}`);
+    assert.ok(
+        r.candidate.improvementPct <= 100,
+        `expected ≤ 100, got ${r.candidate.improvementPct}`
+    );
 });
 
 // ---------------------------------------------------------------------------
@@ -181,8 +184,10 @@ test('isolationScore is in [0, 1]', () => {
         ]
     );
     assert.ok(r.candidate !== null);
-    assert.ok(r.candidate.isolationScore >= 0 && r.candidate.isolationScore <= 1,
-        `expected 0–1, got ${r.candidate.isolationScore}`);
+    assert.ok(
+        r.candidate.isolationScore >= 0 && r.candidate.isolationScore <= 1,
+        `expected 0–1, got ${r.candidate.isolationScore}`
+    );
 });
 
 test('single viable candidate always gets isolationScore 1.0', () => {
@@ -190,8 +195,8 @@ test('single viable candidate always gets isolationScore 1.0', () => {
     const r = nextBestColor(
         [BLACK],
         [
-            { hex: '#000000', count: 10 },  // covered — skipped
-            { hex: '#ffffff', count: 90 },  // sole viable candidate
+            { hex: '#000000', count: 10 }, // covered — skipped
+            { hex: '#ffffff', count: 90 }, // sole viable candidate
         ]
     );
     assert.ok(r.candidate !== null);
@@ -209,9 +214,9 @@ test('blend-aware: both candidates produce a candidate with valid isolation scor
     const r = nextBestColor(
         [BLACK],
         [
-            { hex: '#000000', count: 1   },  // covered
-            { hex: '#444444', count: 500 },  // common, moderate isolation
-            { hex: '#ffffff', count: 1   },  // rare, maximum isolation
+            { hex: '#000000', count: 1 }, // covered
+            { hex: '#444444', count: 500 }, // common, moderate isolation
+            { hex: '#ffffff', count: 1 }, // rare, maximum isolation
         ]
     );
     assert.ok(r.candidate !== null);
@@ -356,6 +361,15 @@ test('blendRgb applies per-channel hiding distances independently', async () =>
     assert.ok(Math.abs(asymmetric.g - asymmetric.b) < 1e-9);
 });
 
+test('blendRgb treats zero or invalid hiding distances as immediately opaque', async () => {
+    const { blendRgb } = await import('../src/lib/nextBestColor.ts');
+    const background = { r: 255, g: 255, b: 255 };
+    const filament = { r: 20, g: 80, b: 140 };
+
+    assert.deepEqual(blendRgb(background, filament, 0, 0.2), filament);
+    assert.deepEqual(blendRgb(background, filament, [0.2, 0, 0.2], 0.2), filament);
+});
+
 test('measured calibration channels change the blend-aware baseline', () => {
     // A calibrated teal whose measured channels ([0.35, 0.12, 0.12]) invert the
     // color-derived heuristic (~[0.068, 0.354, 0.373]): red hides slowest, not
diff --git a/tests/optimizer.test.ts b/tests/optimizer.test.ts
index 124ee54..500eaeb 100644
--- a/tests/optimizer.test.ts
+++ b/tests/optimizer.test.ts
@@ -119,7 +119,10 @@ test('optimizer progress is monotonic and completes for every algorithm', async
         onProgress: (iteration, total) =>
             exactRepeatSamples.push(total > 0 ? iteration / total : 0),
     });
-    assert.ok(exactRepeatSamples.length > 2, 'exact repeat refinement must report intermediate progress');
+    assert.ok(
+        exactRepeatSamples.length > 2,
+        'exact repeat refinement must report intermediate progress'
+    );
     assert.equal(exactRepeatSamples.at(-1), 1);
     assert.ok(
         exactRepeatSamples.every(
@@ -207,6 +210,18 @@ test('cache keys include all weighted clusters and optimizer tuning', async () =
         'changed per-channel calibration TDs must miss cache'
     );
     assert.equal(getOptimizerCacheStats().size, 4);
+
+    const contextPreserveSeparation = optimizeFilamentOrder(
+        filaments,
+        { ...manyClusters, preserveSeparation: true },
+        options
+    );
+    assert.equal(
+        contextPreserveSeparation.cacheHit,
+        undefined,
+        'context preserve-separation mode must miss cache'
+    );
+    assert.equal(getOptimizerCacheStats().size, 5);
 });
 
 test('cache keys distinguish active and inactive calibrated swatch colors', async () => {
@@ -337,7 +352,10 @@ test('exhaustive search evaluates ordered subsets and drops a strictly worse fil
     });
 
     assert.equal(result.iterations, 15, 'three filaments have 15 ordered non-empty subsets');
-    assert.deepEqual(result.order.map((filament) => filament.id), ['white']);
+    assert.deepEqual(
+        result.order.map((filament) => filament.id),
+        ['white']
+    );
 });
 
 test('repeats can close the RGB color path to reach the missing magenta blend', async () => {
@@ -465,11 +483,8 @@ test('fast uses a narrow beam while explicit exhaustive remains exact', async ()
 });
 
 test('effort tiers are deterministic and preserve the previous tier best result', async () => {
-    const {
-        getExactBaseOrderCount,
-        normalizeOptimizerTier,
-        optimizeFilamentOrder,
-    } = await loadOptimizerModule();
+    const { getExactBaseOrderCount, normalizeOptimizerTier, optimizeFilamentOrder } =
+        await loadOptimizerModule();
     const mediumProfile = [
         ...filaments,
         { id: 'green', color: '#42a85f', td: 1.6 },
@@ -511,7 +526,10 @@ test('effort tiers are deterministic and preserve the previous tier best result'
     assert.deepEqual(deepAgain, deep, 'same seed must reproduce the Deep tier');
 
     const ids = deep.order.map((filament) => filament.id);
-    assert.ok(ids.every((id, index) => index === 0 || id !== ids[index - 1]), 'no adjacent duplicates');
+    assert.ok(
+        ids.every((id, index) => index === 0 || id !== ids[index - 1]),
+        'no adjacent duplicates'
+    );
     assert.equal(new Set(ids).size, ids.length, 'no repeats without allowRepeatedSwaps');
 
     assert.ok(
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index dbdb5f8..1625fac 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -376,12 +376,10 @@ test('v2 profile imports are not re-scaled (double-import idempotence)', async (
 });
 
 test('calibrated frontlit fixture imports without rescaling measured hiding distances', async () => {
-    const { importProfiles, parseProfileFile, CURRENT_PROFILE_VERSION } = await loadProfileManager();
+    const { importProfiles, parseProfileFile, CURRENT_PROFILE_VERSION } =
+        await loadProfileManager();
     const raw = readFileSync(
-        resolve(
-            process.cwd(),
-            'tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil'
-        ),
+        resolve(process.cwd(), 'tests/assets/filament-profiles/8_Colors_Calibrated_Frontlit.kfil'),
         'utf8'
     );
     const parsed = parseProfileFile(raw);
@@ -500,3 +498,10 @@ test('loading a calibrated filament backfills the calibrated swatch color', asyn
     });
     assert.equal(stamped!.calibration!.filamentColor, '#ffffff');
 });
+
+test('loading a filament rejects non-positive hiding distances', async () => {
+    const { sanitizeProfileFilament } = await loadProfileManager();
+
+    assert.equal(sanitizeProfileFilament({ id: 'zero', color: '#ffffff', td: 0 }), null);
+    assert.equal(sanitizeProfileFilament({ id: 'negative', color: '#ffffff', td: -0.1 }), null);
+});
diff --git a/tests/regionWeighting.test.ts b/tests/regionWeighting.test.ts
index 1545620..9a14964 100644
--- a/tests/regionWeighting.test.ts
+++ b/tests/regionWeighting.test.ts
@@ -69,6 +69,16 @@ test('center and edge weights favor opposite image regions', () => {
     assert.ok(edgeCorner > edgeCenter, 'edge mode should favor the border');
 });
 
+test('center weight strength of one remains finite', () => {
+    const center = createCenterWeight(4, 4, 1);
+    const values = Array.from({ length: 16 }, (_, index) =>
+        center(index % 4, Math.floor(index / 4))
+    );
+
+    assert.ok(values.every((value) => Number.isFinite(value)));
+    assert.ok(values.every((value) => value >= 0 && value <= 1));
+});
+
 test('spatial color totals prioritize a center disc or an edge border as selected', async () => {
     const { clusterImageColors, deltaELab, hexToRgb, rgbToLab } = await loadAutoPaintModule();
     const width = 25;

From 2a1167370857ec3d6993eb4b31a324d790d841ae Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Tue, 7 Jul 2026 23:03:12 +0300
Subject: [PATCH 59/81] Fix deterministic optimizer tie breaks

---
 CHANGELOG.md                     |  2 +-
 src/lib/optimizer.ts             | 13 ++++++++++---
 tests/autoPaintGoldenFixtures.ts | 24 +++++++++++-------------
 3 files changed, 22 insertions(+), 17 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7eb1ef5..69880e2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -26,7 +26,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
 - **Auto-paint calibration confidence** - Color edits that deactivate a calibration now re-anchor the filament's estimated hiding distance to the new color without deleting the stored calibration, and result confidence now scores the filament sequence actually printed after variable-length optimization omits unused filaments.
-- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, preserve-separation mode, and active calibration state, zero-HD blend helpers agree on the opaque-filament limit, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
+- **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, preserve-separation mode, and active calibration state, beam-search ties use locale-independent ordering, exact base-order search discloses its estimated base-order count before running, zero-HD blend helpers agree on the opaque-filament limit, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
 - **Filament profile validation** - Imported `.kfil`/`.kapp` profile filaments now reject zero or negative hiding distances instead of letting invalid raw HD values reach the UI.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
 
diff --git a/src/lib/optimizer.ts b/src/lib/optimizer.ts
index 4a52a6f..e62eb34 100644
--- a/src/lib/optimizer.ts
+++ b/src/lib/optimizer.ts
@@ -330,6 +330,13 @@ function sequenceKey(sequence: Filament[]): string {
     return sequence.map((filament) => filament.id).join('|');
 }
 
+function compareSequenceKeys(left: Filament[], right: Filament[]): number {
+    const leftKey = sequenceKey(left);
+    const rightKey = sequenceKey(right);
+    if (leftKey === rightKey) return 0;
+    return leftKey < rightKey ? -1 : 1;
+}
+
 function hasConsecutiveDuplicates(sequence: Filament[]): boolean {
     return sequence.some((filament, index) => index > 0 && filament.id === sequence[index - 1].id);
 }
@@ -360,7 +367,7 @@ function maxSequenceLength(filaments: Filament[], maxExtraRepeats: number): numb
 function isBetterCandidate(candidate: ScoredSequence, current: ScoredSequence | null): boolean {
     if (!current) return true;
     if (candidate.score !== current.score) return candidate.score < current.score;
-    return sequenceKey(candidate.order) < sequenceKey(current.order);
+    return compareSequenceKeys(candidate.order, current.order) < 0;
 }
 
 function reportProgress(
@@ -545,7 +552,7 @@ function optimizeBeamSearch(
     });
     beam.sort((left, right) =>
         left.score === right.score
-            ? sequenceKey(left.order).localeCompare(sequenceKey(right.order))
+            ? compareSequenceKeys(left.order, right.order)
             : left.score - right.score
     );
     beam = beam.slice(0, beamWidth);
@@ -578,7 +585,7 @@ function optimizeBeamSearch(
         beam = [...candidates.values()]
             .sort((left, right) =>
                 left.score === right.score
-                    ? sequenceKey(left.order).localeCompare(sequenceKey(right.order))
+                    ? compareSequenceKeys(left.order, right.order)
                     : left.score - right.score
             )
             .slice(0, beamWidth);
diff --git a/tests/autoPaintGoldenFixtures.ts b/tests/autoPaintGoldenFixtures.ts
index 4fcf653..d70638b 100644
--- a/tests/autoPaintGoldenFixtures.ts
+++ b/tests/autoPaintGoldenFixtures.ts
@@ -1,10 +1,7 @@
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 
-import {
-    CURRENT_PROFILE_VERSION,
-    migrateLegacyFilamentTd,
-} from '../src/lib/profileManager.ts';
+import { CURRENT_PROFILE_VERSION, migrateLegacyFilamentTd } from '../src/lib/profileManager.ts';
 import {
     colorSwatchesFromJpegBlocks,
     logoFixturePath,
@@ -18,7 +15,6 @@ export interface AutoPaintGoldenScenario {
     name: string;
     filaments: Array<{ id: string; color: string; td: number }>;
     imageSwatches: Array<{ hex: string; count: number }>;
-    imageDimensions: { width: number; height: number };
     enhancedColorMatch: boolean;
     allowRepeatedSwaps: boolean;
     seed: number;
@@ -38,7 +34,9 @@ const SWATCH_CAP = 2 ** 14;
 
 function readProfile(fileName: string, expectedFilamentCount: number): FilamentProfileFixture {
     const profilePath = resolve(testAssetsRoot, 'filament-profiles', fileName);
-    const parsed = JSON.parse(readFileSync(profilePath, 'utf8')) as Partial<FilamentProfileFixture> & {
+    const parsed = JSON.parse(
+        readFileSync(profilePath, 'utf8')
+    ) as Partial<FilamentProfileFixture> & {
         version?: number;
     };
 
@@ -63,9 +61,7 @@ function readProfile(fileName: string, expectedFilamentCount: number): FilamentP
 }
 
 function rgbToHex(r: number, g: number, b: number) {
-    return `#${[r, g, b]
-        .map((value) => value.toString(16).padStart(2, '0'))
-        .join('')}`;
+    return `#${[r, g, b].map((value) => value.toString(16).padStart(2, '0')).join('')}`;
 }
 
 function pngSwatches(image: PngImage): Array<{ hex: string; count: number }> {
@@ -84,7 +80,12 @@ function pngSwatches(image: PngImage): Array<{ hex: string; count: number }> {
         .map(([hex, count]) => ({ hex, count }));
 }
 
-function scenarioSeed(profileIndex: number, fixtureIndex: number, enhanced: boolean, repeats: boolean) {
+function scenarioSeed(
+    profileIndex: number,
+    fixtureIndex: number,
+    enhanced: boolean,
+    repeats: boolean
+) {
     return (
         0x4b524f4d +
         profileIndex * 1009 +
@@ -100,12 +101,10 @@ export function autoPaintGoldenScenarios(): AutoPaintGoldenScenario[] {
         {
             name: 'logo-png',
             imageSwatches: pngSwatches(png),
-            imageDimensions: { width: png.width, height: png.height },
         },
         {
             name: 'large-jpeg',
             imageSwatches: colorSwatchesFromJpegBlocks(largeIssueFixturePath),
-            imageDimensions: { width: 3888, height: 2916 },
         },
     ];
 
@@ -118,7 +117,6 @@ export function autoPaintGoldenScenarios(): AutoPaintGoldenScenario[] {
                     name: `${profile.name} / ${fixture.name} / enhanced=${enhancedColorMatch} / repeats=${allowRepeatedSwaps}`,
                     filaments: profile.filaments,
                     imageSwatches: fixture.imageSwatches,
-                    imageDimensions: fixture.imageDimensions,
                     enhancedColorMatch,
                     allowRepeatedSwaps,
                     seed: scenarioSeed(

From 185305b7018433ec0e986c7e8d0f952898611d47 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 9 Jul 2026 20:26:07 +0300
Subject: [PATCH 60/81] Update dependencies to resolve Dependabot security
 alerts

---
 CHANGELOG.md         |   1 +
 package-lock.json    | 672 ++++++++++++++++++++++---------------------
 src-tauri/Cargo.lock |  75 ++---
 3 files changed, 372 insertions(+), 376 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 69880e2..8ad70ad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Changed
 
+- **Dependency security updates** - Updated the desktop runtime to Tauri 2.11.1, fixing an origin-confusion issue that could let a crafted remote page invoke local-only IPC commands on Windows, along with patched openssl, rustls-webpki, and rand crates. Development tooling moved to patched releases (Vite 7.3.6, Rollup, PostCSS, esbuild, Babel, and friends), clearing every Dependabot alert that is fixable without a Tauri major upgrade.
 - **Hiding Distance replaces TD** - Filament opacity is now expressed as a frontlit **Hiding Distance (HD)** in millimetres: the depth at which a filament visually hides what's beneath it, matching how prints are actually viewed. Stored values become single-meaning (profile schema v2): uncalibrated values from older profiles, `.kfil`/`.kapp` files, and saved app state are converted automatically (×0.1, one time) on load or import, and the old internal frontlit scaling layer is removed — this also fixes calibrated filaments being double-scaled in the recommended-height estimate. A convert button on each filament row accepts conventional backlit/lithophane TD values (≈10× the HD) and converts them on entry, the wand estimate now produces HD directly, and per-channel values are visible in tooltips. Uncalibrated filaments now blend with per-channel hiding distances estimated from their color (previously channel-uniform), so uncalibrated previews and stacks are more color-faithful; the next-filament suggestion simulates blends in linear light with the same per-channel hiding distances auto-paint renders with (measured channels when calibrated, color-derived otherwise) and recommends HDs on the stored scale.
 - **Auto-paint enhanced matching** - Optimizer scoring now follows the same layer-snapped, Max Height-compressed printable stack used by preview and export, scores realized print error in CIEDE2000 with a weighted p95 tail term, and uses complete target-color/cache inputs so repeated runs are deterministic.
 - **Auto-paint optimizer controls** - Replaced the older optimizer choices with deterministic effort tiers (Fast, Balanced, Thorough, Deep, and Exact base order), selector-based repeated swaps, transition-detail endpoints, and explicit stable seed handling. Selecting Exact base order shows the estimated number of base orders it will score before running. Legacy saved values migrate to the nearest current tier.
diff --git a/package-lock.json b/package-lock.json
index 9e0073a..2859075 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -61,13 +61,13 @@
             }
         },
         "node_modules/@babel/code-frame": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz",
-            "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
+            "integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/helper-validator-identifier": "^7.28.5",
+                "@babel/helper-validator-identifier": "^7.29.7",
                 "js-tokens": "^4.0.0",
                 "picocolors": "^1.1.1"
             },
@@ -76,9 +76,9 @@
             }
         },
         "node_modules/@babel/compat-data": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.0.tgz",
-            "integrity": "sha512-T1NCJqT/j9+cn8fvkt7jtwbLBfLC/1y1c7NtCeXFRgzGTsafi68MRv8yzkYSapBnFA6L3U2VSc02ciDzoAJhJg==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/compat-data/-/compat-data-7.29.7.tgz",
+            "integrity": "sha512-locTkQyKvwIEgBzVrn8693ebc97F2U8ZHjbXwDXJ5Fn2TCpNwTlKcaKLkdHop5c/icOFE7qt7Q9JC5hnKNa6Gg==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -86,21 +86,21 @@
             }
         },
         "node_modules/@babel/core": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.0.tgz",
-            "integrity": "sha512-CGOfOJqWjg2qW/Mb6zNsDm+u5vFQ8DxXfbM09z69p5Z6+mE1ikP2jUXw+j42Pf1XTYED2Rni5f95npYeuwMDQA==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/core/-/core-7.29.7.tgz",
+            "integrity": "sha512-RgHBCvtjbOK2gXSNBNIkNoEc9qoVEtau3hj8gEqKQuL3HZAibKarWFEI3Lfm6EYKkLalOh8eSrj9b+ch9H/VBA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/code-frame": "^7.29.0",
-                "@babel/generator": "^7.29.0",
-                "@babel/helper-compilation-targets": "^7.28.6",
-                "@babel/helper-module-transforms": "^7.28.6",
-                "@babel/helpers": "^7.28.6",
-                "@babel/parser": "^7.29.0",
-                "@babel/template": "^7.28.6",
-                "@babel/traverse": "^7.29.0",
-                "@babel/types": "^7.29.0",
+                "@babel/code-frame": "^7.29.7",
+                "@babel/generator": "^7.29.7",
+                "@babel/helper-compilation-targets": "^7.29.7",
+                "@babel/helper-module-transforms": "^7.29.7",
+                "@babel/helpers": "^7.29.7",
+                "@babel/parser": "^7.29.7",
+                "@babel/template": "^7.29.7",
+                "@babel/traverse": "^7.29.7",
+                "@babel/types": "^7.29.7",
                 "@jridgewell/remapping": "^2.3.5",
                 "convert-source-map": "^2.0.0",
                 "debug": "^4.1.0",
@@ -117,14 +117,14 @@
             }
         },
         "node_modules/@babel/generator": {
-            "version": "7.29.1",
-            "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.1.tgz",
-            "integrity": "sha512-qsaF+9Qcm2Qv8SRIMMscAvG4O3lJ0F1GuMo5HR/Bp02LopNgnZBC/EkbevHFeGs4ls/oPz9v+Bsmzbkbe+0dUw==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/generator/-/generator-7.29.7.tgz",
+            "integrity": "sha512-DkXD5OJQaAQIdZ1bt3UZdEnHAn9Imd3IVBdX03UFe+ony9Ojw5pzr9YVKGDY1jt+Gcn/FnGkNf8r+Vj5NOJWtQ==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/parser": "^7.29.0",
-                "@babel/types": "^7.29.0",
+                "@babel/parser": "^7.29.7",
+                "@babel/types": "^7.29.7",
                 "@jridgewell/gen-mapping": "^0.3.12",
                 "@jridgewell/trace-mapping": "^0.3.28",
                 "jsesc": "^3.0.2"
@@ -134,14 +134,14 @@
             }
         },
         "node_modules/@babel/helper-compilation-targets": {
-            "version": "7.28.6",
-            "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.28.6.tgz",
-            "integrity": "sha512-JYtls3hqi15fcx5GaSNL7SCTJ2MNmjrkHXg4FSpOA/grxK8KwyZ5bubHsCq8FXCkua6xhuaaBit+3b7+VZRfcA==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-compilation-targets/-/helper-compilation-targets-7.29.7.tgz",
+            "integrity": "sha512-wem6WaBj4NaVYVdNhLPPVacES6ZJ+KBBfSkTMD3YZxbP3rm3Di85tJU5ljaUNhaOynt+Aj0xruhYuzQBt8n71g==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/compat-data": "^7.28.6",
-                "@babel/helper-validator-option": "^7.27.1",
+                "@babel/compat-data": "^7.29.7",
+                "@babel/helper-validator-option": "^7.29.7",
                 "browserslist": "^4.24.0",
                 "lru-cache": "^5.1.1",
                 "semver": "^6.3.1"
@@ -151,9 +151,9 @@
             }
         },
         "node_modules/@babel/helper-globals": {
-            "version": "7.28.0",
-            "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.28.0.tgz",
-            "integrity": "sha512-+W6cISkXFa1jXsDEdYA8HeevQT/FULhxzR99pxphltZcVaugps53THCeiWA8SguxxpSp3gKPiuYfSWopkLQ4hw==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-globals/-/helper-globals-7.29.7.tgz",
+            "integrity": "sha512-3nQVUAtvkKH9zahfWgw96Jc/uFOmjACE1kQz82E2lqWmHBgjzbNlsC22nuQTfahmWeQtTq5nQ/4Nnd2A1wj4zA==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -161,29 +161,29 @@
             }
         },
         "node_modules/@babel/helper-module-imports": {
-            "version": "7.28.6",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.28.6.tgz",
-            "integrity": "sha512-l5XkZK7r7wa9LucGw9LwZyyCUscb4x37JWTPz7swwFE/0FMQAGpiWUZn8u9DzkSBWEcK25jmvubfpw2dnAMdbw==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-module-imports/-/helper-module-imports-7.29.7.tgz",
+            "integrity": "sha512-ejHwrQQYcm9xnTivShn2IDOlIzInN34AXskvq9QicvCtEzq1Vzclu/tKF8Jq1Cg8JG2GL6/EmjgsCT7lXepE3g==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/traverse": "^7.28.6",
-                "@babel/types": "^7.28.6"
+                "@babel/traverse": "^7.29.7",
+                "@babel/types": "^7.29.7"
             },
             "engines": {
                 "node": ">=6.9.0"
             }
         },
         "node_modules/@babel/helper-module-transforms": {
-            "version": "7.28.6",
-            "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.28.6.tgz",
-            "integrity": "sha512-67oXFAYr2cDLDVGLXTEABjdBJZ6drElUSI7WKp70NrpyISso3plG9SAGEF6y7zbha/wOzUByWWTJvEDVNIUGcA==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-module-transforms/-/helper-module-transforms-7.29.7.tgz",
+            "integrity": "sha512-UPUVSyXbOh627KiCIGQSgwWzGeBKLkaJ9PJEdrngIwMSzxLR4jS4+f1f1jb7VzBbg8nFLaYotvVPFCTqdrmTAg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/helper-module-imports": "^7.28.6",
-                "@babel/helper-validator-identifier": "^7.28.5",
-                "@babel/traverse": "^7.28.6"
+                "@babel/helper-module-imports": "^7.29.7",
+                "@babel/helper-validator-identifier": "^7.29.7",
+                "@babel/traverse": "^7.29.7"
             },
             "engines": {
                 "node": ">=6.9.0"
@@ -203,9 +203,9 @@
             }
         },
         "node_modules/@babel/helper-string-parser": {
-            "version": "7.27.1",
-            "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.27.1.tgz",
-            "integrity": "sha512-qMlSxKbpRlAridDExk92nSobyDdpPijUq2DW6oDnUqd0iOGxmQjyqhMIihI9+zv4LPyZdRje2cavWPbCbWm3eA==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-string-parser/-/helper-string-parser-7.29.7.tgz",
+            "integrity": "sha512-Pb5ijPrZ89GDH8223L4UP8i6QApWxs04RbPQJTeWDV0/keR2E36MeKnyr6LYmUUvqRRI+Iv87SuF1W6ErINzYw==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -213,9 +213,9 @@
             }
         },
         "node_modules/@babel/helper-validator-identifier": {
-            "version": "7.28.5",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz",
-            "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
+            "integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -223,9 +223,9 @@
             }
         },
         "node_modules/@babel/helper-validator-option": {
-            "version": "7.27.1",
-            "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.27.1.tgz",
-            "integrity": "sha512-YvjJow9FxbhFFKDSuFnVCe2WxXk1zWc22fFePVNEaWJEu8IrZVlda6N0uHwzZrUM1il7NC9Mlp4MaJYbYd9JSg==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helper-validator-option/-/helper-validator-option-7.29.7.tgz",
+            "integrity": "sha512-N9ZErrD+yW5geCDtBqnOoxmR8+tNKiGuxKlDpuJxfsqpa2dFcexaziGAE/qoHLiDDreVNMupxGmSoNlyvsA3gw==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -233,27 +233,27 @@
             }
         },
         "node_modules/@babel/helpers": {
-            "version": "7.28.6",
-            "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.28.6.tgz",
-            "integrity": "sha512-xOBvwq86HHdB7WUDTfKfT/Vuxh7gElQ+Sfti2Cy6yIWNW05P8iUslOVcZ4/sKbE+/jQaukQAdz/gf3724kYdqw==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/helpers/-/helpers-7.29.7.tgz",
+            "integrity": "sha512-1k2lAGRMfHTcwuNYcCNUmaUffmQv8KWMfh2iJUUeRlwlwH4FdNG7mfPI10NPfLHJFThE4Tyr4mv7kTNZOiPuBg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/template": "^7.28.6",
-                "@babel/types": "^7.28.6"
+                "@babel/template": "^7.29.7",
+                "@babel/types": "^7.29.7"
             },
             "engines": {
                 "node": ">=6.9.0"
             }
         },
         "node_modules/@babel/parser": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.0.tgz",
-            "integrity": "sha512-IyDgFV5GeDUVX4YdF/3CPULtVGSXXMLh1xVIgdCgxApktqnQV0r7/8Nqthg+8YLGaAtdyIlo2qIdZrbCv4+7ww==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/parser/-/parser-7.29.7.tgz",
+            "integrity": "sha512-hnORnjP/1P/zFEndoeX+n+t1RwWRJiJpM/jO7FW32Kn9r5+sJB2JWOdYo4L6k78j15eCwY3Gm/7364B1EMwtNg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/types": "^7.29.0"
+                "@babel/types": "^7.29.7"
             },
             "bin": {
                 "parser": "bin/babel-parser.js"
@@ -295,33 +295,33 @@
             }
         },
         "node_modules/@babel/template": {
-            "version": "7.28.6",
-            "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.28.6.tgz",
-            "integrity": "sha512-YA6Ma2KsCdGb+WC6UpBVFJGXL58MDA6oyONbjyF/+5sBgxY/dwkhLogbMT2GXXyU84/IhRw/2D1Os1B/giz+BQ==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/template/-/template-7.29.7.tgz",
+            "integrity": "sha512-puq+Gf35oI24FeN11LkoUQFqv9uwNeWpxXZi/Ji3rRIoKAzKnxRaZ+Gkj0vKS9ZCiTESfng1N9LyOyXvo+m+Gg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/code-frame": "^7.28.6",
-                "@babel/parser": "^7.28.6",
-                "@babel/types": "^7.28.6"
+                "@babel/code-frame": "^7.29.7",
+                "@babel/parser": "^7.29.7",
+                "@babel/types": "^7.29.7"
             },
             "engines": {
                 "node": ">=6.9.0"
             }
         },
         "node_modules/@babel/traverse": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.0.tgz",
-            "integrity": "sha512-4HPiQr0X7+waHfyXPZpWPfWL/J7dcN1mx9gL6WdQVMbPnF3+ZhSMs8tCxN7oHddJE9fhNE7+lxdnlyemKfJRuA==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/traverse/-/traverse-7.29.7.tgz",
+            "integrity": "sha512-EhlfNQtZ+NK22w5BM61ciuiq1m58ed33Wr1Xan//ZRTy6hgjnwyCffRYwzsGXdASJSUJ1guZILsErh1eQcl+zw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/code-frame": "^7.29.0",
-                "@babel/generator": "^7.29.0",
-                "@babel/helper-globals": "^7.28.0",
-                "@babel/parser": "^7.29.0",
-                "@babel/template": "^7.28.6",
-                "@babel/types": "^7.29.0",
+                "@babel/code-frame": "^7.29.7",
+                "@babel/generator": "^7.29.7",
+                "@babel/helper-globals": "^7.29.7",
+                "@babel/parser": "^7.29.7",
+                "@babel/template": "^7.29.7",
+                "@babel/types": "^7.29.7",
                 "debug": "^4.3.1"
             },
             "engines": {
@@ -329,14 +329,14 @@
             }
         },
         "node_modules/@babel/types": {
-            "version": "7.29.0",
-            "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.0.tgz",
-            "integrity": "sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==",
+            "version": "7.29.7",
+            "resolved": "https://registry.npmjs.org/@babel/types/-/types-7.29.7.tgz",
+            "integrity": "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@babel/helper-string-parser": "^7.27.1",
-                "@babel/helper-validator-identifier": "^7.28.5"
+                "@babel/helper-string-parser": "^7.29.7",
+                "@babel/helper-validator-identifier": "^7.29.7"
             },
             "engines": {
                 "node": ">=6.9.0"
@@ -417,9 +417,9 @@
             }
         },
         "node_modules/@esbuild/aix-ppc64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.3.tgz",
-            "integrity": "sha512-9fJMTNFTWZMh5qwrBItuziu834eOCUcEqymSH7pY+zoMVEZg3gcPuBNxH1EvfVYe9h0x/Ptw8KBzv7qxb7l8dg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.1.tgz",
+            "integrity": "sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==",
             "cpu": [
                 "ppc64"
             ],
@@ -434,9 +434,9 @@
             }
         },
         "node_modules/@esbuild/android-arm": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.3.tgz",
-            "integrity": "sha512-i5D1hPY7GIQmXlXhs2w8AWHhenb00+GxjxRncS2ZM7YNVGNfaMxgzSGuO8o8SJzRc/oZwU2bcScvVERk03QhzA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.1.tgz",
+            "integrity": "sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==",
             "cpu": [
                 "arm"
             ],
@@ -451,9 +451,9 @@
             }
         },
         "node_modules/@esbuild/android-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.3.tgz",
-            "integrity": "sha512-YdghPYUmj/FX2SYKJ0OZxf+iaKgMsKHVPF1MAq/P8WirnSpCStzKJFjOjzsW0QQ7oIAiccHdcqjbHmJxRb/dmg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.1.tgz",
+            "integrity": "sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==",
             "cpu": [
                 "arm64"
             ],
@@ -468,9 +468,9 @@
             }
         },
         "node_modules/@esbuild/android-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.3.tgz",
-            "integrity": "sha512-IN/0BNTkHtk8lkOM8JWAYFg4ORxBkZQf9zXiEOfERX/CzxW3Vg1ewAhU7QSWQpVIzTW+b8Xy+lGzdYXV6UZObQ==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.1.tgz",
+            "integrity": "sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==",
             "cpu": [
                 "x64"
             ],
@@ -485,9 +485,9 @@
             }
         },
         "node_modules/@esbuild/darwin-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.3.tgz",
-            "integrity": "sha512-Re491k7ByTVRy0t3EKWajdLIr0gz2kKKfzafkth4Q8A5n1xTHrkqZgLLjFEHVD+AXdUGgQMq+Godfq45mGpCKg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.1.tgz",
+            "integrity": "sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==",
             "cpu": [
                 "arm64"
             ],
@@ -502,9 +502,9 @@
             }
         },
         "node_modules/@esbuild/darwin-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.3.tgz",
-            "integrity": "sha512-vHk/hA7/1AckjGzRqi6wbo+jaShzRowYip6rt6q7VYEDX4LEy1pZfDpdxCBnGtl+A5zq8iXDcyuxwtv3hNtHFg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.1.tgz",
+            "integrity": "sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==",
             "cpu": [
                 "x64"
             ],
@@ -519,9 +519,9 @@
             }
         },
         "node_modules/@esbuild/freebsd-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.3.tgz",
-            "integrity": "sha512-ipTYM2fjt3kQAYOvo6vcxJx3nBYAzPjgTCk7QEgZG8AUO3ydUhvelmhrbOheMnGOlaSFUoHXB6un+A7q4ygY9w==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.1.tgz",
+            "integrity": "sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==",
             "cpu": [
                 "arm64"
             ],
@@ -536,9 +536,9 @@
             }
         },
         "node_modules/@esbuild/freebsd-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.3.tgz",
-            "integrity": "sha512-dDk0X87T7mI6U3K9VjWtHOXqwAMJBNN2r7bejDsc+j03SEjtD9HrOl8gVFByeM0aJksoUuUVU9TBaZa2rgj0oA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.1.tgz",
+            "integrity": "sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==",
             "cpu": [
                 "x64"
             ],
@@ -553,9 +553,9 @@
             }
         },
         "node_modules/@esbuild/linux-arm": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.3.tgz",
-            "integrity": "sha512-s6nPv2QkSupJwLYyfS+gwdirm0ukyTFNl3KTgZEAiJDd+iHZcbTPPcWCcRYH+WlNbwChgH2QkE9NSlNrMT8Gfw==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.1.tgz",
+            "integrity": "sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==",
             "cpu": [
                 "arm"
             ],
@@ -570,9 +570,9 @@
             }
         },
         "node_modules/@esbuild/linux-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.3.tgz",
-            "integrity": "sha512-sZOuFz/xWnZ4KH3YfFrKCf1WyPZHakVzTiqji3WDc0BCl2kBwiJLCXpzLzUBLgmp4veFZdvN5ChW4Eq/8Fc2Fg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.1.tgz",
+            "integrity": "sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==",
             "cpu": [
                 "arm64"
             ],
@@ -587,9 +587,9 @@
             }
         },
         "node_modules/@esbuild/linux-ia32": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.3.tgz",
-            "integrity": "sha512-yGlQYjdxtLdh0a3jHjuwOrxQjOZYD/C9PfdbgJJF3TIZWnm/tMd/RcNiLngiu4iwcBAOezdnSLAwQDPqTmtTYg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.1.tgz",
+            "integrity": "sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==",
             "cpu": [
                 "ia32"
             ],
@@ -604,9 +604,9 @@
             }
         },
         "node_modules/@esbuild/linux-loong64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.3.tgz",
-            "integrity": "sha512-WO60Sn8ly3gtzhyjATDgieJNet/KqsDlX5nRC5Y3oTFcS1l0KWba+SEa9Ja1GfDqSF1z6hif/SkpQJbL63cgOA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.1.tgz",
+            "integrity": "sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==",
             "cpu": [
                 "loong64"
             ],
@@ -621,9 +621,9 @@
             }
         },
         "node_modules/@esbuild/linux-mips64el": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.3.tgz",
-            "integrity": "sha512-APsymYA6sGcZ4pD6k+UxbDjOFSvPWyZhjaiPyl/f79xKxwTnrn5QUnXR5prvetuaSMsb4jgeHewIDCIWljrSxw==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.1.tgz",
+            "integrity": "sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==",
             "cpu": [
                 "mips64el"
             ],
@@ -638,9 +638,9 @@
             }
         },
         "node_modules/@esbuild/linux-ppc64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.3.tgz",
-            "integrity": "sha512-eizBnTeBefojtDb9nSh4vvVQ3V9Qf9Df01PfawPcRzJH4gFSgrObw+LveUyDoKU3kxi5+9RJTCWlj4FjYXVPEA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.1.tgz",
+            "integrity": "sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==",
             "cpu": [
                 "ppc64"
             ],
@@ -655,9 +655,9 @@
             }
         },
         "node_modules/@esbuild/linux-riscv64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.3.tgz",
-            "integrity": "sha512-3Emwh0r5wmfm3ssTWRQSyVhbOHvqegUDRd0WhmXKX2mkHJe1SFCMJhagUleMq+Uci34wLSipf8Lagt4LlpRFWQ==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.1.tgz",
+            "integrity": "sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==",
             "cpu": [
                 "riscv64"
             ],
@@ -672,9 +672,9 @@
             }
         },
         "node_modules/@esbuild/linux-s390x": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.3.tgz",
-            "integrity": "sha512-pBHUx9LzXWBc7MFIEEL0yD/ZVtNgLytvx60gES28GcWMqil8ElCYR4kvbV2BDqsHOvVDRrOxGySBM9Fcv744hw==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.1.tgz",
+            "integrity": "sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==",
             "cpu": [
                 "s390x"
             ],
@@ -689,9 +689,9 @@
             }
         },
         "node_modules/@esbuild/linux-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.3.tgz",
-            "integrity": "sha512-Czi8yzXUWIQYAtL/2y6vogER8pvcsOsk5cpwL4Gk5nJqH5UZiVByIY8Eorm5R13gq+DQKYg0+JyQoytLQas4dA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.1.tgz",
+            "integrity": "sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==",
             "cpu": [
                 "x64"
             ],
@@ -706,9 +706,9 @@
             }
         },
         "node_modules/@esbuild/netbsd-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.3.tgz",
-            "integrity": "sha512-sDpk0RgmTCR/5HguIZa9n9u+HVKf40fbEUt+iTzSnCaGvY9kFP0YKBWZtJaraonFnqef5SlJ8/TiPAxzyS+UoA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.1.tgz",
+            "integrity": "sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==",
             "cpu": [
                 "arm64"
             ],
@@ -723,9 +723,9 @@
             }
         },
         "node_modules/@esbuild/netbsd-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.3.tgz",
-            "integrity": "sha512-P14lFKJl/DdaE00LItAukUdZO5iqNH7+PjoBm+fLQjtxfcfFE20Xf5CrLsmZdq5LFFZzb5JMZ9grUwvtVYzjiA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.1.tgz",
+            "integrity": "sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==",
             "cpu": [
                 "x64"
             ],
@@ -740,9 +740,9 @@
             }
         },
         "node_modules/@esbuild/openbsd-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.3.tgz",
-            "integrity": "sha512-AIcMP77AvirGbRl/UZFTq5hjXK+2wC7qFRGoHSDrZ5v5b8DK/GYpXW3CPRL53NkvDqb9D+alBiC/dV0Fb7eJcw==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.1.tgz",
+            "integrity": "sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==",
             "cpu": [
                 "arm64"
             ],
@@ -757,9 +757,9 @@
             }
         },
         "node_modules/@esbuild/openbsd-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.3.tgz",
-            "integrity": "sha512-DnW2sRrBzA+YnE70LKqnM3P+z8vehfJWHXECbwBmH/CU51z6FiqTQTHFenPlHmo3a8UgpLyH3PT+87OViOh1AQ==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.1.tgz",
+            "integrity": "sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==",
             "cpu": [
                 "x64"
             ],
@@ -774,9 +774,9 @@
             }
         },
         "node_modules/@esbuild/openharmony-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.3.tgz",
-            "integrity": "sha512-NinAEgr/etERPTsZJ7aEZQvvg/A6IsZG/LgZy+81wON2huV7SrK3e63dU0XhyZP4RKGyTm7aOgmQk0bGp0fy2g==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.1.tgz",
+            "integrity": "sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==",
             "cpu": [
                 "arm64"
             ],
@@ -791,9 +791,9 @@
             }
         },
         "node_modules/@esbuild/sunos-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.3.tgz",
-            "integrity": "sha512-PanZ+nEz+eWoBJ8/f8HKxTTD172SKwdXebZ0ndd953gt1HRBbhMsaNqjTyYLGLPdoWHy4zLU7bDVJztF5f3BHA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.1.tgz",
+            "integrity": "sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==",
             "cpu": [
                 "x64"
             ],
@@ -808,9 +808,9 @@
             }
         },
         "node_modules/@esbuild/win32-arm64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.3.tgz",
-            "integrity": "sha512-B2t59lWWYrbRDw/tjiWOuzSsFh1Y/E95ofKz7rIVYSQkUYBjfSgf6oeYPNWHToFRr2zx52JKApIcAS/D5TUBnA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.1.tgz",
+            "integrity": "sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==",
             "cpu": [
                 "arm64"
             ],
@@ -825,9 +825,9 @@
             }
         },
         "node_modules/@esbuild/win32-ia32": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.3.tgz",
-            "integrity": "sha512-QLKSFeXNS8+tHW7tZpMtjlNb7HKau0QDpwm49u0vUp9y1WOF+PEzkU84y9GqYaAVW8aH8f3GcBck26jh54cX4Q==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.1.tgz",
+            "integrity": "sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==",
             "cpu": [
                 "ia32"
             ],
@@ -842,9 +842,9 @@
             }
         },
         "node_modules/@esbuild/win32-x64": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.3.tgz",
-            "integrity": "sha512-4uJGhsxuptu3OcpVAzli+/gWusVGwZZHTlS63hh++ehExkVT8SgiEf7/uC/PclrPPkLhZqGgCTjd0VWLo6xMqA==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.1.tgz",
+            "integrity": "sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==",
             "cpu": [
                 "x64"
             ],
@@ -2123,9 +2123,9 @@
             "license": "MIT"
         },
         "node_modules/@rollup/rollup-android-arm-eabi": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.57.1.tgz",
-            "integrity": "sha512-A6ehUVSiSaaliTxai040ZpZ2zTevHYbvu/lDoeAteHI8QnaosIzm4qwtezfRg1jOYaUmnzLX1AOD6Z+UJjtifg==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.62.2.tgz",
+            "integrity": "sha512-6o7ZLZK+BeenkZCFNDXqpbjw9bD6nuWonvS/lwQJp7NoVVxm6p3qE7qQ5jGuBjiFsgvqjD8mZAU5oWxTmbOeOg==",
             "cpu": [
                 "arm"
             ],
@@ -2137,9 +2137,9 @@
             ]
         },
         "node_modules/@rollup/rollup-android-arm64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.57.1.tgz",
-            "integrity": "sha512-dQaAddCY9YgkFHZcFNS/606Exo8vcLHwArFZ7vxXq4rigo2bb494/xKMMwRRQW6ug7Js6yXmBZhSBRuBvCCQ3w==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.62.2.tgz",
+            "integrity": "sha512-BaH7BllCACHoH1LguOU56UItGfUWjujlO65kS9LAodViaN4bwIKd7oeW/ZHJ/4ljr/7MIiENnNy3HJ0zXv8Zkw==",
             "cpu": [
                 "arm64"
             ],
@@ -2151,9 +2151,9 @@
             ]
         },
         "node_modules/@rollup/rollup-darwin-arm64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.57.1.tgz",
-            "integrity": "sha512-crNPrwJOrRxagUYeMn/DZwqN88SDmwaJ8Cvi/TN1HnWBU7GwknckyosC2gd0IqYRsHDEnXf328o9/HC6OkPgOg==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.62.2.tgz",
+            "integrity": "sha512-v39RCCvj4He82I9sFmk+M1VZ0PLM9sfsLVikjfx2hYBNALhrrOR2D3JjQA6AhlaSOgcR+RzrKY7e1+bT6SUO/A==",
             "cpu": [
                 "arm64"
             ],
@@ -2165,9 +2165,9 @@
             ]
         },
         "node_modules/@rollup/rollup-darwin-x64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.57.1.tgz",
-            "integrity": "sha512-Ji8g8ChVbKrhFtig5QBV7iMaJrGtpHelkB3lsaKzadFBe58gmjfGXAOfI5FV0lYMH8wiqsxKQ1C9B0YTRXVy4w==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.62.2.tgz",
+            "integrity": "sha512-yl0y2vq3S3lHeuXhEdss6TWfKW8vkujImO12tn4ZkG/4oghr09LvdYm2RElVjokTQiUvDUGXLGsYeLqUMCKpGA==",
             "cpu": [
                 "x64"
             ],
@@ -2179,9 +2179,9 @@
             ]
         },
         "node_modules/@rollup/rollup-freebsd-arm64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.57.1.tgz",
-            "integrity": "sha512-R+/WwhsjmwodAcz65guCGFRkMb4gKWTcIeLy60JJQbXrJ97BOXHxnkPFrP+YwFlaS0m+uWJTstrUA9o+UchFug==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.62.2.tgz",
+            "integrity": "sha512-tT4pvt4qXD+vEoezupCWi+a1F0vvDiksiHc+PxRlYTOH1I6/X4id9jPxTP+Fg+545euaFT1jJVs4CEdHZAU1vw==",
             "cpu": [
                 "arm64"
             ],
@@ -2193,9 +2193,9 @@
             ]
         },
         "node_modules/@rollup/rollup-freebsd-x64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.57.1.tgz",
-            "integrity": "sha512-IEQTCHeiTOnAUC3IDQdzRAGj3jOAYNr9kBguI7MQAAZK3caezRrg0GxAb6Hchg4lxdZEI5Oq3iov/w/hnFWY9Q==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.62.2.tgz",
+            "integrity": "sha512-6nU5F2wCW+qvCBhTn1pdIU3bzsIoF7EUwsCDRxilWGprQR6yd508YnH9+OKFCwpfS8pjZqDUmnCAr7exax0XCg==",
             "cpu": [
                 "x64"
             ],
@@ -2207,9 +2207,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-gnueabihf": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.57.1.tgz",
-            "integrity": "sha512-F8sWbhZ7tyuEfsmOxwc2giKDQzN3+kuBLPwwZGyVkLlKGdV1nvnNwYD0fKQ8+XS6hp9nY7B+ZeK01EBUE7aHaw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.62.2.tgz",
+            "integrity": "sha512-n1GJHPOvpIfhi3TmrCeh6S6URt9BFCt0KQE3qvexyGCTAKpR4Lg+eWvNZEqu7epxwus/8ElT3hacYEucm49SZg==",
             "cpu": [
                 "arm"
             ],
@@ -2221,9 +2221,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm-musleabihf": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.57.1.tgz",
-            "integrity": "sha512-rGfNUfn0GIeXtBP1wL5MnzSj98+PZe/AXaGBCRmT0ts80lU5CATYGxXukeTX39XBKsxzFpEeK+Mrp9faXOlmrw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.62.2.tgz",
+            "integrity": "sha512-JqgflS8wEB+UXV/vS1RpRbifGBeN4D5lz8D8oOFbFZw4vedvdOgCFAjfBmIMdW3yL10XpQQ0Ambepw6MXrhOnA==",
             "cpu": [
                 "arm"
             ],
@@ -2235,9 +2235,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.57.1.tgz",
-            "integrity": "sha512-MMtej3YHWeg/0klK2Qodf3yrNzz6CGjo2UntLvk2RSPlhzgLvYEB3frRvbEF2wRKh1Z2fDIg9KRPe1fawv7C+g==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.62.2.tgz",
+            "integrity": "sha512-wnFJkogWvN4jm/hQRF2UBaeUmk20j5+DmHvoyWii2b8HJDyvz1MF2OU/6ynXt2KR63rbZLWkFpoytpdc/yBuSA==",
             "cpu": [
                 "arm64"
             ],
@@ -2249,9 +2249,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-arm64-musl": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.57.1.tgz",
-            "integrity": "sha512-1a/qhaaOXhqXGpMFMET9VqwZakkljWHLmZOX48R0I/YLbhdxr1m4gtG1Hq7++VhVUmf+L3sTAf9op4JlhQ5u1Q==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.62.2.tgz",
+            "integrity": "sha512-HVu2bp0zhvJ8xHEV9+UUs7S90VadmBSY3LcIMvozbPo4AuMGDWlz3ymHLHZPX4hR67TKTt8Qp5PJ5RBg/i+RMQ==",
             "cpu": [
                 "arm64"
             ],
@@ -2263,9 +2263,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-loong64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.57.1.tgz",
-            "integrity": "sha512-QWO6RQTZ/cqYtJMtxhkRkidoNGXc7ERPbZN7dVW5SdURuLeVU7lwKMpo18XdcmpWYd0qsP1bwKPf7DNSUinhvA==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.62.2.tgz",
+            "integrity": "sha512-mQqqAV8QaoSgr9I2fKDLY2BAVvmKjWoGiu/cSYQonsLvtqwEn1E4QYfnCOcp5zoEqNhsDYin1s6jx/VJmrxlZg==",
             "cpu": [
                 "loong64"
             ],
@@ -2277,9 +2277,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-loong64-musl": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.57.1.tgz",
-            "integrity": "sha512-xpObYIf+8gprgWaPP32xiN5RVTi/s5FCR+XMXSKmhfoJjrpRAjCuuqQXyxUa/eJTdAE6eJ+KDKaoEqjZQxh3Gw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.62.2.tgz",
+            "integrity": "sha512-IxKLoxCQ2IWi6bT2akyDUBGsOImDKB+sPp4EsTmwFQ/fMwpCKm8uLSSgP/Kx/QYUgKis6SEZ5/Nlhup0DIA0PQ==",
             "cpu": [
                 "loong64"
             ],
@@ -2291,9 +2291,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-ppc64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.57.1.tgz",
-            "integrity": "sha512-4BrCgrpZo4hvzMDKRqEaW1zeecScDCR+2nZ86ATLhAoJ5FQ+lbHVD3ttKe74/c7tNT9c6F2viwB3ufwp01Oh2w==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.62.2.tgz",
+            "integrity": "sha512-Mk5ha2RQSgyFfmYYLkBpPnUk8D8FriBxesO1u9O75X0mHgXL1UQcH5Itl2lurWL2tj0RxV9b9tJgipac0hRY9A==",
             "cpu": [
                 "ppc64"
             ],
@@ -2305,9 +2305,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-ppc64-musl": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.57.1.tgz",
-            "integrity": "sha512-NOlUuzesGauESAyEYFSe3QTUguL+lvrN1HtwEEsU2rOwdUDeTMJdO5dUYl/2hKf9jWydJrO9OL/XSSf65R5+Xw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.62.2.tgz",
+            "integrity": "sha512-CjvEnqJL/0/TQ3TXX3OPIJ/kmBellrWd4heXUmHeJlTnmwjKpSJzoehLaL6Xk0ZnMHBu9dZuFADNOrtjF4v+2w==",
             "cpu": [
                 "ppc64"
             ],
@@ -2319,9 +2319,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-riscv64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.57.1.tgz",
-            "integrity": "sha512-ptA88htVp0AwUUqhVghwDIKlvJMD/fmL/wrQj99PRHFRAG6Z5nbWoWG4o81Nt9FT+IuqUQi+L31ZKAFeJ5Is+A==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.62.2.tgz",
+            "integrity": "sha512-1SiZbzwdkaDURsew/tSOrooKiYy7EQGT6m8ufavAi9NEyQb/6VuIxFXAL1fqa4iZe3g4NbNk4P7J32z2tw5Mgg==",
             "cpu": [
                 "riscv64"
             ],
@@ -2333,9 +2333,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-riscv64-musl": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.57.1.tgz",
-            "integrity": "sha512-S51t7aMMTNdmAMPpBg7OOsTdn4tySRQvklmL3RpDRyknk87+Sp3xaumlatU+ppQ+5raY7sSTcC2beGgvhENfuw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.62.2.tgz",
+            "integrity": "sha512-nQts12zJ3NQRoE6uYljOH89v7szzLDvG2JD/vsX+vGXU8w/At1GowTZ5/7qeFQ8m7L55rpR8Okugnuo5bgjy2Q==",
             "cpu": [
                 "riscv64"
             ],
@@ -2347,9 +2347,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-s390x-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.57.1.tgz",
-            "integrity": "sha512-Bl00OFnVFkL82FHbEqy3k5CUCKH6OEJL54KCyx2oqsmZnFTR8IoNqBF+mjQVcRCT5sB6yOvK8A37LNm/kPJiZg==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.62.2.tgz",
+            "integrity": "sha512-E9/ll019jhPIJgpzfZoIkBGhcz+kKNgVWYRY0zr9srBdPPFVpvOKW8VaJKUbeK+eZXyQF9ltME+Kk6affeaPgg==",
             "cpu": [
                 "s390x"
             ],
@@ -2361,9 +2361,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.57.1.tgz",
-            "integrity": "sha512-ABca4ceT4N+Tv/GtotnWAeXZUZuM/9AQyCyKYyKnpk4yoA7QIAuBt6Hkgpw8kActYlew2mvckXkvx0FfoInnLg==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.62.2.tgz",
+            "integrity": "sha512-5BqxR/pshjey51iliyzTD5Xi3EN0aLmQ2lZ3lvefVV9c82BvrLo2/6OT55iifpWBufs6kdwWbuOKS841DrmK9A==",
             "cpu": [
                 "x64"
             ],
@@ -2375,9 +2375,9 @@
             ]
         },
         "node_modules/@rollup/rollup-linux-x64-musl": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.57.1.tgz",
-            "integrity": "sha512-HFps0JeGtuOR2convgRRkHCekD7j+gdAuXM+/i6kGzQtFhlCtQkpwtNzkNj6QhCDp7DRJ7+qC/1Vg2jt5iSOFw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.62.2.tgz",
+            "integrity": "sha512-uNN83XxQrRAh/w0/pmAfibcwyb6YWt4gP+dpnQKPVJshAloQ785ii8CT8ZCIxkGg9opVsvAlGhFitSm6D1Jjpg==",
             "cpu": [
                 "x64"
             ],
@@ -2389,9 +2389,9 @@
             ]
         },
         "node_modules/@rollup/rollup-openbsd-x64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.57.1.tgz",
-            "integrity": "sha512-H+hXEv9gdVQuDTgnqD+SQffoWoc0Of59AStSzTEj/feWTBAnSfSD3+Dql1ZruJQxmykT/JVY0dE8Ka7z0DH1hw==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.62.2.tgz",
+            "integrity": "sha512-srjEIxSH3LRnJN6THczDHWQplqEMFiAJrTab0msUryh9kwNpkICf3Ea6q6MN/2cZwRFUNx5w+h6Hpi4QuHS6Zg==",
             "cpu": [
                 "x64"
             ],
@@ -2403,9 +2403,9 @@
             ]
         },
         "node_modules/@rollup/rollup-openharmony-arm64": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.57.1.tgz",
-            "integrity": "sha512-4wYoDpNg6o/oPximyc/NG+mYUejZrCU2q+2w6YZqrAs2UcNUChIZXjtafAiiZSUc7On8v5NyNj34Kzj/Ltk6dQ==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.62.2.tgz",
+            "integrity": "sha512-8hOJnxgbyObnCm5AlRA3A931xX19xq80RjVTKgJOvEKWqJruP/Uf12IbAOaDjjEXYRewwHLfmF0YRIdK3OwKWA==",
             "cpu": [
                 "arm64"
             ],
@@ -2417,9 +2417,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-arm64-msvc": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.57.1.tgz",
-            "integrity": "sha512-O54mtsV/6LW3P8qdTcamQmuC990HDfR71lo44oZMZlXU4tzLrbvTii87Ni9opq60ds0YzuAlEr/GNwuNluZyMQ==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.62.2.tgz",
+            "integrity": "sha512-mmF4AY1i0hG/bLWUctUq59gtmgaSIRa3cu/A3JFRp/sCNEme2bgDEiDS22P9FbnJB8NJNF4jPJiSP5RHQpUTDg==",
             "cpu": [
                 "arm64"
             ],
@@ -2431,9 +2431,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-ia32-msvc": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.57.1.tgz",
-            "integrity": "sha512-P3dLS+IerxCT/7D2q2FYcRdWRl22dNbrbBEtxdWhXrfIMPP9lQhb5h4Du04mdl5Woq05jVCDPCMF7Ub0NAjIew==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.62.2.tgz",
+            "integrity": "sha512-DZgkknc6jhHrk46V25vbAM0zZkyP0nSDkJB8/dRkLTxv470dOmWDqGoEJl/9A0dFfS7yE3REOwNDxpHwSLSt0Q==",
             "cpu": [
                 "ia32"
             ],
@@ -2445,9 +2445,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-x64-gnu": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.57.1.tgz",
-            "integrity": "sha512-VMBH2eOOaKGtIJYleXsi2B8CPVADrh+TyNxJ4mWPnKfLB/DBUmzW+5m1xUrcwWoMfSLagIRpjUFeW5CO5hyciQ==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.62.2.tgz",
+            "integrity": "sha512-T6xr6ucWSFto+VGajA8YH26LdpHRuP4YLHEKAtCWvJDOlnmWcDZVCI2Jmjr+IFHDlt2zRaTAKE4tfjTaWLgJBg==",
             "cpu": [
                 "x64"
             ],
@@ -2459,9 +2459,9 @@
             ]
         },
         "node_modules/@rollup/rollup-win32-x64-msvc": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.57.1.tgz",
-            "integrity": "sha512-mxRFDdHIWRxg3UfIIAwCm6NzvxG0jDX/wBN6KsQFTvKFqqg9vTrWUE68qEjHt19A5wwx5X5aUi2zuZT7YR0jrA==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.62.2.tgz",
+            "integrity": "sha512-BfzEnDJOt9T8M989/lA37EcJgat01wLRnoi5dQf3QzOH7jzpqTAzdDbVfRljVr5r+jzKqpbHeyOfAaXxAd0PAA==",
             "cpu": [
                 "x64"
             ],
@@ -3122,9 +3122,9 @@
             }
         },
         "node_modules/@types/estree": {
-            "version": "1.0.8",
-            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
-            "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
+            "version": "1.0.9",
+            "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz",
+            "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==",
             "dev": true,
             "license": "MIT"
         },
@@ -3393,9 +3393,9 @@
             }
         },
         "node_modules/@typescript-eslint/typescript-estree/node_modules/brace-expansion": {
-            "version": "2.0.2",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
-            "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
+            "version": "2.1.2",
+            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.2.tgz",
+            "integrity": "sha512-w5JZcKgdhDOgOwm8H+KgbosopHMuGcl6qbulwjtz3SM7I7P3yW1eAjzMPLrIE+NQ9vjgANKHWeMHnrT0OXW1oA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
@@ -3403,13 +3403,13 @@
             }
         },
         "node_modules/@typescript-eslint/typescript-estree/node_modules/minimatch": {
-            "version": "9.0.5",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
-            "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+            "version": "9.0.9",
+            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.9.tgz",
+            "integrity": "sha512-OBwBN9AL4dqmETlpS2zasx+vTeWclWzkblfZk7KTA5j3jeOONz/tRCnZomUyvNg83wL5Zv9Ss6HMJXAgL8R2Yg==",
             "dev": true,
             "license": "ISC",
             "dependencies": {
-                "brace-expansion": "^2.0.1"
+                "brace-expansion": "^2.0.2"
             },
             "engines": {
                 "node": ">=16 || 14 >=14.17"
@@ -3538,9 +3538,9 @@
             }
         },
         "node_modules/ajv": {
-            "version": "6.12.6",
-            "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz",
-            "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==",
+            "version": "6.15.0",
+            "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz",
+            "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
@@ -3705,9 +3705,9 @@
             }
         },
         "node_modules/brace-expansion": {
-            "version": "1.1.12",
-            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
-            "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
+            "version": "1.1.16",
+            "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.16.tgz",
+            "integrity": "sha512-IDw48K2/2kRkg9LdJxurvq3lV3aBgq0REY89duEqFRthjlPdXHKMj7EnQOXVckxzgisinf3nHfrcE2FufFLXMw==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
@@ -4036,9 +4036,9 @@
             }
         },
         "node_modules/esbuild": {
-            "version": "0.27.3",
-            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.3.tgz",
-            "integrity": "sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==",
+            "version": "0.28.1",
+            "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz",
+            "integrity": "sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==",
             "dev": true,
             "hasInstallScript": true,
             "license": "MIT",
@@ -4049,32 +4049,32 @@
                 "node": ">=18"
             },
             "optionalDependencies": {
-                "@esbuild/aix-ppc64": "0.27.3",
-                "@esbuild/android-arm": "0.27.3",
-                "@esbuild/android-arm64": "0.27.3",
-                "@esbuild/android-x64": "0.27.3",
-                "@esbuild/darwin-arm64": "0.27.3",
-                "@esbuild/darwin-x64": "0.27.3",
-                "@esbuild/freebsd-arm64": "0.27.3",
-                "@esbuild/freebsd-x64": "0.27.3",
-                "@esbuild/linux-arm": "0.27.3",
-                "@esbuild/linux-arm64": "0.27.3",
-                "@esbuild/linux-ia32": "0.27.3",
-                "@esbuild/linux-loong64": "0.27.3",
-                "@esbuild/linux-mips64el": "0.27.3",
-                "@esbuild/linux-ppc64": "0.27.3",
-                "@esbuild/linux-riscv64": "0.27.3",
-                "@esbuild/linux-s390x": "0.27.3",
-                "@esbuild/linux-x64": "0.27.3",
-                "@esbuild/netbsd-arm64": "0.27.3",
-                "@esbuild/netbsd-x64": "0.27.3",
-                "@esbuild/openbsd-arm64": "0.27.3",
-                "@esbuild/openbsd-x64": "0.27.3",
-                "@esbuild/openharmony-arm64": "0.27.3",
-                "@esbuild/sunos-x64": "0.27.3",
-                "@esbuild/win32-arm64": "0.27.3",
-                "@esbuild/win32-ia32": "0.27.3",
-                "@esbuild/win32-x64": "0.27.3"
+                "@esbuild/aix-ppc64": "0.28.1",
+                "@esbuild/android-arm": "0.28.1",
+                "@esbuild/android-arm64": "0.28.1",
+                "@esbuild/android-x64": "0.28.1",
+                "@esbuild/darwin-arm64": "0.28.1",
+                "@esbuild/darwin-x64": "0.28.1",
+                "@esbuild/freebsd-arm64": "0.28.1",
+                "@esbuild/freebsd-x64": "0.28.1",
+                "@esbuild/linux-arm": "0.28.1",
+                "@esbuild/linux-arm64": "0.28.1",
+                "@esbuild/linux-ia32": "0.28.1",
+                "@esbuild/linux-loong64": "0.28.1",
+                "@esbuild/linux-mips64el": "0.28.1",
+                "@esbuild/linux-ppc64": "0.28.1",
+                "@esbuild/linux-riscv64": "0.28.1",
+                "@esbuild/linux-s390x": "0.28.1",
+                "@esbuild/linux-x64": "0.28.1",
+                "@esbuild/netbsd-arm64": "0.28.1",
+                "@esbuild/netbsd-x64": "0.28.1",
+                "@esbuild/openbsd-arm64": "0.28.1",
+                "@esbuild/openbsd-x64": "0.28.1",
+                "@esbuild/openharmony-arm64": "0.28.1",
+                "@esbuild/sunos-x64": "0.28.1",
+                "@esbuild/win32-arm64": "0.28.1",
+                "@esbuild/win32-ia32": "0.28.1",
+                "@esbuild/win32-x64": "0.28.1"
             }
         },
         "node_modules/escalade": {
@@ -4433,9 +4433,9 @@
             }
         },
         "node_modules/flatted": {
-            "version": "3.3.3",
-            "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz",
-            "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==",
+            "version": "3.4.2",
+            "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz",
+            "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==",
             "dev": true,
             "license": "ISC"
         },
@@ -4744,10 +4744,20 @@
             "license": "MIT"
         },
         "node_modules/js-yaml": {
-            "version": "4.1.1",
-            "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz",
-            "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==",
+            "version": "4.3.0",
+            "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.3.0.tgz",
+            "integrity": "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q==",
             "dev": true,
+            "funding": [
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/puzrin"
+                },
+                {
+                    "type": "github",
+                    "url": "https://github.com/sponsors/nodeca"
+                }
+            ],
             "license": "MIT",
             "dependencies": {
                 "argparse": "^2.0.1"
@@ -5229,9 +5239,9 @@
             }
         },
         "node_modules/minimatch": {
-            "version": "3.1.2",
-            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
-            "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+            "version": "3.1.5",
+            "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz",
+            "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==",
             "dev": true,
             "license": "ISC",
             "dependencies": {
@@ -5249,9 +5259,9 @@
             "license": "MIT"
         },
         "node_modules/nanoid": {
-            "version": "3.3.11",
-            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
-            "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
+            "version": "3.3.15",
+            "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.15.tgz",
+            "integrity": "sha512-y7Wygv/7mEOvxTuEQDB8StXdMRBWf1kR/tlhAzBRUFkB2jfcLOAxO/SHmOO2zgz1pVgK29/kyupn059/bCHdjA==",
             "dev": true,
             "funding": [
                 {
@@ -5487,9 +5497,9 @@
             "license": "ISC"
         },
         "node_modules/picomatch": {
-            "version": "4.0.3",
-            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
-            "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
+            "version": "4.0.5",
+            "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.5.tgz",
+            "integrity": "sha512-RvwwcruNjI1ncT5xRakeyS9Lf8lcItv34KD+aif+VH9kduAyfYBipGh12274xtenIPZ119/R9BdTBa8gAwSh0A==",
             "dev": true,
             "license": "MIT",
             "engines": {
@@ -5547,9 +5557,9 @@
             }
         },
         "node_modules/postcss": {
-            "version": "8.5.6",
-            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.6.tgz",
-            "integrity": "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg==",
+            "version": "8.5.16",
+            "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.16.tgz",
+            "integrity": "sha512-vuwillviilfKZsg0VGj5R/YwwcHx4SLsIOI/7K6mQkWx+l5cUHTjj5g0AasTBcyXsbfTgrwsUNmVUb5xVwyPwg==",
             "dev": true,
             "funding": [
                 {
@@ -5567,7 +5577,7 @@
             ],
             "license": "MIT",
             "dependencies": {
-                "nanoid": "^3.3.11",
+                "nanoid": "^3.3.12",
                 "picocolors": "^1.1.1",
                 "source-map-js": "^1.2.1"
             },
@@ -5817,13 +5827,13 @@
             }
         },
         "node_modules/rollup": {
-            "version": "4.57.1",
-            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.57.1.tgz",
-            "integrity": "sha512-oQL6lgK3e2QZeQ7gcgIkS2YZPg5slw37hYufJ3edKlfQSGGm8ICoxswK15ntSzF/a8+h7ekRy7k7oWc3BQ7y8A==",
+            "version": "4.62.2",
+            "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.62.2.tgz",
+            "integrity": "sha512-RFnrW4lhXA3s3eqHDZvN654g8OTjzRfqpIRJYczCGB6HzphckVAi/Qh4tbPUbRuDi7s1Llv8g/NspLkttY3gTA==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "@types/estree": "1.0.8"
+                "@types/estree": "1.0.9"
             },
             "bin": {
                 "rollup": "dist/bin/rollup"
@@ -5833,31 +5843,31 @@
                 "npm": ">=8.0.0"
             },
             "optionalDependencies": {
-                "@rollup/rollup-android-arm-eabi": "4.57.1",
-                "@rollup/rollup-android-arm64": "4.57.1",
-                "@rollup/rollup-darwin-arm64": "4.57.1",
-                "@rollup/rollup-darwin-x64": "4.57.1",
-                "@rollup/rollup-freebsd-arm64": "4.57.1",
-                "@rollup/rollup-freebsd-x64": "4.57.1",
-                "@rollup/rollup-linux-arm-gnueabihf": "4.57.1",
-                "@rollup/rollup-linux-arm-musleabihf": "4.57.1",
-                "@rollup/rollup-linux-arm64-gnu": "4.57.1",
-                "@rollup/rollup-linux-arm64-musl": "4.57.1",
-                "@rollup/rollup-linux-loong64-gnu": "4.57.1",
-                "@rollup/rollup-linux-loong64-musl": "4.57.1",
-                "@rollup/rollup-linux-ppc64-gnu": "4.57.1",
-                "@rollup/rollup-linux-ppc64-musl": "4.57.1",
-                "@rollup/rollup-linux-riscv64-gnu": "4.57.1",
-                "@rollup/rollup-linux-riscv64-musl": "4.57.1",
-                "@rollup/rollup-linux-s390x-gnu": "4.57.1",
-                "@rollup/rollup-linux-x64-gnu": "4.57.1",
-                "@rollup/rollup-linux-x64-musl": "4.57.1",
-                "@rollup/rollup-openbsd-x64": "4.57.1",
-                "@rollup/rollup-openharmony-arm64": "4.57.1",
-                "@rollup/rollup-win32-arm64-msvc": "4.57.1",
-                "@rollup/rollup-win32-ia32-msvc": "4.57.1",
-                "@rollup/rollup-win32-x64-gnu": "4.57.1",
-                "@rollup/rollup-win32-x64-msvc": "4.57.1",
+                "@rollup/rollup-android-arm-eabi": "4.62.2",
+                "@rollup/rollup-android-arm64": "4.62.2",
+                "@rollup/rollup-darwin-arm64": "4.62.2",
+                "@rollup/rollup-darwin-x64": "4.62.2",
+                "@rollup/rollup-freebsd-arm64": "4.62.2",
+                "@rollup/rollup-freebsd-x64": "4.62.2",
+                "@rollup/rollup-linux-arm-gnueabihf": "4.62.2",
+                "@rollup/rollup-linux-arm-musleabihf": "4.62.2",
+                "@rollup/rollup-linux-arm64-gnu": "4.62.2",
+                "@rollup/rollup-linux-arm64-musl": "4.62.2",
+                "@rollup/rollup-linux-loong64-gnu": "4.62.2",
+                "@rollup/rollup-linux-loong64-musl": "4.62.2",
+                "@rollup/rollup-linux-ppc64-gnu": "4.62.2",
+                "@rollup/rollup-linux-ppc64-musl": "4.62.2",
+                "@rollup/rollup-linux-riscv64-gnu": "4.62.2",
+                "@rollup/rollup-linux-riscv64-musl": "4.62.2",
+                "@rollup/rollup-linux-s390x-gnu": "4.62.2",
+                "@rollup/rollup-linux-x64-gnu": "4.62.2",
+                "@rollup/rollup-linux-x64-musl": "4.62.2",
+                "@rollup/rollup-openbsd-x64": "4.62.2",
+                "@rollup/rollup-openharmony-arm64": "4.62.2",
+                "@rollup/rollup-win32-arm64-msvc": "4.62.2",
+                "@rollup/rollup-win32-ia32-msvc": "4.62.2",
+                "@rollup/rollup-win32-x64-gnu": "4.62.2",
+                "@rollup/rollup-win32-x64-msvc": "4.62.2",
                 "fsevents": "~2.3.2"
             }
         },
@@ -6248,13 +6258,13 @@
             "license": "MIT"
         },
         "node_modules/vite": {
-            "version": "7.3.1",
-            "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz",
-            "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==",
+            "version": "7.3.6",
+            "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.6.tgz",
+            "integrity": "sha512-4XP60spRGjSZFf1qYH+dJIkK2znL3zQfl9KkOV9MkkRR/3Dls0dxaBsQPTloEc5BLXWPL9vsOxopxyKoMmDueg==",
             "dev": true,
             "license": "MIT",
             "dependencies": {
-                "esbuild": "^0.27.0",
+                "esbuild": "^0.27.0 || ^0.28.0",
                 "fdir": "^6.5.0",
                 "picomatch": "^4.0.3",
                 "postcss": "^8.5.6",
diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock
index 61370cc..e145829 100644
--- a/src-tauri/Cargo.lock
+++ b/src-tauri/Cargo.lock
@@ -892,7 +892,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
 dependencies = [
  "libc",
- "windows-sys 0.61.2",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -2442,15 +2442,14 @@ checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
 
 [[package]]
 name = "openssl"
-version = "0.10.76"
+version = "0.10.81"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "951c002c75e16ea2c65b8c7e4d3d51d5530d8dfa7d060b4776828c88cfb18ecf"
+checksum = "77823a27f0babb03091cb9ed9ef80af3b39dbc82f97e8fa530374b7dafd87a45"
 dependencies = [
  "bitflags 2.11.0",
  "cfg-if",
  "foreign-types 0.3.2",
  "libc",
- "once_cell",
  "openssl-macros",
  "openssl-sys",
 ]
@@ -2474,9 +2473,9 @@ checksum = "7c87def4c32ab89d880effc9e097653c8da5d6ef28e6b539d313baaacfbafcbe"
 
 [[package]]
 name = "openssl-sys"
-version = "0.9.112"
+version = "0.9.117"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57d55af3b3e226502be1526dfdba67ab0e9c96fc293004e79576b2b9edb0dbdb"
+checksum = "b47e7e6bb2c38cd930d25a23b40fa52e068c10e85f3e03a7f5ba5aaca5713695"
 dependencies = [
  "cc",
  "libc",
@@ -2570,7 +2569,6 @@ version = "0.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1fd6780a80ae0c52cc120a26a1a42c1ae51b247a253e4e06113d23d2c2edd078"
 dependencies = [
- "phf_macros 0.11.3",
  "phf_shared 0.11.3",
 ]
 
@@ -2632,7 +2630,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5d5285893bb5eb82e6aaf5d59ee909a06a16737a8970984dd7746ba9283498d6"
 dependencies = [
  "phf_shared 0.10.0",
- "rand 0.8.5",
+ "rand 0.8.6",
 ]
 
 [[package]]
@@ -2642,7 +2640,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3c80231409c20246a13fddb31776fb942c38553c51e871f8cbd687a4cfb5843d"
 dependencies = [
  "phf_shared 0.11.3",
- "rand 0.8.5",
+ "rand 0.8.6",
 ]
 
 [[package]]
@@ -2669,19 +2667,6 @@ dependencies = [
  "syn 1.0.109",
 ]
 
-[[package]]
-name = "phf_macros"
-version = "0.11.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f84ac04429c13a7ff43785d75ad27569f2951ce0ffd30a3321230db2fc727216"
-dependencies = [
- "phf_generator 0.11.3",
- "phf_shared 0.11.3",
- "proc-macro2",
- "quote",
- "syn 2.0.116",
-]
-
 [[package]]
 name = "phf_macros"
 version = "0.13.1"
@@ -2962,9 +2947,9 @@ dependencies = [
 
 [[package]]
 name = "rand"
-version = "0.8.5"
+version = "0.8.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
+checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
 dependencies = [
  "libc",
  "rand_chacha 0.3.1",
@@ -3262,7 +3247,7 @@ dependencies = [
  "borsh",
  "bytes",
  "num-traits",
- "rand 0.8.5",
+ "rand 0.8.6",
  "rkyv",
  "serde",
  "serde_json",
@@ -3293,7 +3278,7 @@ dependencies = [
  "errno",
  "libc",
  "linux-raw-sys",
- "windows-sys 0.61.2",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -3320,9 +3305,9 @@ dependencies = [
 
 [[package]]
 name = "rustls-webpki"
-version = "0.103.9"
+version = "0.103.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d7df23109aa6c1567d1c575b9952556388da57401e4ace1d15f79eedad0d8f53"
+checksum = "61c429a8649f110dddef65e2a5ad240f747e85f7758a6bccc7e5777bd33f756e"
 dependencies = [
  "ring",
  "rustls-pki-types",
@@ -4011,9 +3996,9 @@ checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
 
 [[package]]
 name = "tauri"
-version = "2.11.0"
+version = "2.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d059f2527558d9dba6f186dec4772610e1aecfd3f94002397613e7e648752b66"
+checksum = "b93bd86d231f0a8138f11a02a584769fe4b703dc36ae133d783228dbc4801405"
 dependencies = [
  "anyhow",
  "bytes",
@@ -4062,9 +4047,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-build"
-version = "2.6.0"
+version = "2.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be9aa8c59a894f76c29a002501c589de5eb4987a5913d62a6e0a47f320901988"
+checksum = "bc9ce40b16101cb6ea63d3e221567affd1c3a9205f95d7bc574941a10636b632"
 dependencies = [
  "anyhow",
  "cargo_toml",
@@ -4083,9 +4068,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-codegen"
-version = "2.6.0"
+version = "2.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d3e4e8230d565106aa19dfbaa01a7ed01abf78047fe0577a83377224bd1bf20e"
+checksum = "08279169ff42f8fc45a1dbc9dcae888893ba95288142e5880c59b93a26d2cfc5"
 dependencies = [
  "base64 0.22.1",
  "brotli",
@@ -4110,9 +4095,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-macros"
-version = "2.6.0"
+version = "2.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc8de2cddbbc33dbdf4c84f170121886595efdbcc9cb4b3d76342b79d082cedc"
+checksum = "e8b394794f399a421811d06966343e7933fcae92d59f5180b9388d1174497a45"
 dependencies = [
  "heck 0.5.0",
  "proc-macro2",
@@ -4205,9 +4190,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-runtime"
-version = "2.11.0"
+version = "2.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e42bbcb76237351fbaa02f08d808c537dc12eb5a6eabbf3e517b50056334d95"
+checksum = "b0b4bc95aed361b0019067d189a1174a603d460d0f6c72606512d59fc9c12ec8"
 dependencies = [
  "cookie",
  "dpi",
@@ -4230,9 +4215,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-runtime-wry"
-version = "2.11.0"
+version = "2.11.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2cadb13dad0c681e1e0a2c49ae488f0e2906ded3d57e7a0017f4aaf46e387117"
+checksum = "4e6fac707727b7a2f48e4ded90976324267371073edbb415ffb73bb0458d203f"
 dependencies = [
  "gtk",
  "http",
@@ -4256,9 +4241,9 @@ dependencies = [
 
 [[package]]
 name = "tauri-utils"
-version = "2.9.0"
+version = "2.9.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "55f61d2bf7188fbcf2b0ed095b67a6bc498f713c939314bb19eb700118a573b7"
+checksum = "3e176a18e67764923c4f1ce66f25ae4abe5f688384d5eb1a0fa6c77f3d90f887"
 dependencies = [
  "anyhow",
  "brotli",
@@ -4274,7 +4259,7 @@ dependencies = [
  "kuchikiki",
  "log",
  "memchr",
- "phf 0.11.3",
+ "phf 0.13.1",
  "plist",
  "proc-macro2",
  "quote",
@@ -4315,7 +4300,7 @@ dependencies = [
  "getrandom 0.4.1",
  "once_cell",
  "rustix",
- "windows-sys 0.61.2",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -5165,7 +5150,7 @@ version = "0.1.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c2a7b1c03c876122aa43f3020e6c3c3ee5c05081c9a00739faf7503aeba10d22"
 dependencies = [
- "windows-sys 0.61.2",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]

From 67a39e62ea7813fad65f856ef9f580ffe5714960 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Thu, 9 Jul 2026 22:14:31 +0300
Subject: [PATCH 61/81] Add collapsible control groups

---
 CHANGELOG.md                         |   1 +
 package-lock.json                    | 201 +++++++++++++++++++++++++++
 package.json                         |   1 +
 src/components/AdjustmentsPanel.tsx  |  24 ++--
 src/components/AutoPaintTab.tsx      |  28 ++--
 src/components/CollapsibleCard.tsx   |  97 +++++++++++++
 src/components/ControlsPanel.tsx     |  85 +++++------
 src/components/DeditherPanel.tsx     | 201 ++++++++++++++-------------
 src/components/ImageResizePanel.tsx  | 135 +++++++++---------
 src/components/PrintInstructions.tsx |  28 ++--
 src/components/PrintSettingsCard.tsx |  44 +++---
 src/components/SwatchesPanel.tsx     |  22 +--
 src/components/ThreeDControls.tsx    |  90 ++++++++----
 src/components/ui/collapsible.tsx    |   9 ++
 src/index.css                        |  20 +++
 src/lib/collapsedGroups.ts           |  35 +++++
 tests/collapsedGroups.test.ts        |  84 +++++++++++
 17 files changed, 815 insertions(+), 290 deletions(-)
 create mode 100644 src/components/CollapsibleCard.tsx
 create mode 100644 src/components/ui/collapsible.tsx
 create mode 100644 src/lib/collapsedGroups.ts
 create mode 100644 tests/collapsedGroups.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8ad70ad..66079d2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
 - **Filament profile import fixture** - Added a schema-v2 frontlit-calibrated 8-color `.kfil` fixture with import coverage to guard against accidental hiding-distance rescaling.
+- **Collapsible control groups** - Every settings card in 2D and 3D mode (Adjustments, Resize Image, Dedither, Quantization Settings, Image colors, 3D Print Settings, Auto-paint, Color Slice Heights, and Print Instructions) can now be collapsed from its header to save sidebar space. Collapsed groups are remembered across sessions, and important indicators stay visible while collapsed: color counts, busy spinners, modified-settings dots, unsaved-profile markers, and quick actions like reset and copy.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
diff --git a/package-lock.json b/package-lock.json
index 2859075..cb57d41 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -14,6 +14,7 @@
                 "@dnd-kit/sortable": "^10.0.0",
                 "@dnd-kit/utilities": "^3.2.2",
                 "@radix-ui/react-alert-dialog": "^1.1.15",
+                "@radix-ui/react-collapsible": "^1.1.16",
                 "@radix-ui/react-label": "^2.1.7",
                 "@radix-ui/react-popover": "^1.1.15",
                 "@radix-ui/react-select": "^2.2.6",
@@ -1252,6 +1253,206 @@
                 }
             }
         },
+        "node_modules/@radix-ui/react-collapsible": {
+            "version": "1.1.16",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-collapsible/-/react-collapsible-1.1.16.tgz",
+            "integrity": "sha512-opfXRe6nnzyGmCDPx+l1Aqo/RbqWtQal2FnsBqF9hhePp6j0LsRoBaRxcMOlTv+uYTJVtWYZKg9t9wTe+BA/ZA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/primitive": "1.1.5",
+                "@radix-ui/react-compose-refs": "1.1.3",
+                "@radix-ui/react-context": "1.2.0",
+                "@radix-ui/react-id": "1.1.2",
+                "@radix-ui/react-presence": "1.1.7",
+                "@radix-ui/react-primitive": "2.1.7",
+                "@radix-ui/react-use-controllable-state": "1.2.3",
+                "@radix-ui/react-use-layout-effect": "1.1.2"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "@types/react-dom": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc",
+                "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                },
+                "@types/react-dom": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/primitive": {
+            "version": "1.1.5",
+            "resolved": "https://registry.npmjs.org/@radix-ui/primitive/-/primitive-1.1.5.tgz",
+            "integrity": "sha512-d86WIWFYNtGA0H/d8exstrTRTp7eWJYlYJbtNofxr/3ljupZYn6EFDG/Qgu/0Kc8v7yMUxySagqJsL1+PdYjWg==",
+            "license": "MIT"
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-compose-refs": {
+            "version": "1.1.3",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-compose-refs/-/react-compose-refs-1.1.3.tgz",
+            "integrity": "sha512-rYOP8OMnuuPMQF1uhPVlGNcCDlkokKqGFE3JcxFViIkAXP7EvFWUliJAstrapypaBLJNHbZL6jGhbVDGTwmVhA==",
+            "license": "MIT",
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-context": {
+            "version": "1.2.0",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-context/-/react-context-1.2.0.tgz",
+            "integrity": "sha512-fOE+JtN9rygNZkCnHRBEP0TAvLldlhyOxMsbwFvTP4nAs+nBmfnna+o/Zski2wkmY1YMrFC0aSzsHoLY47iLrg==",
+            "license": "MIT",
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-id": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-id/-/react-id-1.1.2.tgz",
+            "integrity": "sha512-orBC88futVpqCmhX1p4cvquNHsELQ+w+vBJnuj3ftETI5bJb0bZn3Tqu3SWN2IOcPycTnMGnhwoermvISt72sA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-use-layout-effect": "1.1.2"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-presence": {
+            "version": "1.1.7",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-presence/-/react-presence-1.1.7.tgz",
+            "integrity": "sha512-zBZ4QM5XG3JRanDmqXYf3MD6th4AFXFmgU6KNMFzUaV6F3uw9I5/zjMUvFriSEn5ewo1nxuibvyxJdmLlDcslA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-use-layout-effect": "1.1.2"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "@types/react-dom": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc",
+                "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                },
+                "@types/react-dom": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-primitive": {
+            "version": "2.1.7",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-primitive/-/react-primitive-2.1.7.tgz",
+            "integrity": "sha512-bC3NiwsprbxKjuon9l7X6BUTw7FPVzEYaL92MPEY5SCd/9hUTPXVFtVwRix7778wtRsVao+zE062gL79FZleeQ==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-slot": "1.3.0"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "@types/react-dom": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc",
+                "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                },
+                "@types/react-dom": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-slot": {
+            "version": "1.3.0",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-slot/-/react-slot-1.3.0.tgz",
+            "integrity": "sha512-MojKku4U/miO8Av4Dkb+ctMAQx7JmY96LmtDQlAarCRtd7rN52QCSzBF+XAvr5S6coSVj9HEPBgHAHKEJVk/WA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-compose-refs": "1.1.3"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-use-controllable-state": {
+            "version": "1.2.3",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-use-controllable-state/-/react-use-controllable-state-1.2.3.tgz",
+            "integrity": "sha512-PLzC90MS+ReootmjC597dvopoelpZ8Q61HJkDXZSExitIq7PL55vHNnesAHwguHK0aPfBnpdNzQtv1uliaqQrA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-use-effect-event": "0.0.3",
+                "@radix-ui/react-use-layout-effect": "1.1.2"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-use-effect-event": {
+            "version": "0.0.3",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-use-effect-event/-/react-use-effect-event-0.0.3.tgz",
+            "integrity": "sha512-6c8ZqvPTWILEKnyVkP53EGRCcpnJiKTC21sS/6R1GF5xKyHJJWQEPfkqlcgUkdRQivd6tb23abUwe4ngWmY0JA==",
+            "license": "MIT",
+            "dependencies": {
+                "@radix-ui/react-use-layout-effect": "1.1.2"
+            },
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
+        "node_modules/@radix-ui/react-collapsible/node_modules/@radix-ui/react-use-layout-effect": {
+            "version": "1.1.2",
+            "resolved": "https://registry.npmjs.org/@radix-ui/react-use-layout-effect/-/react-use-layout-effect-1.1.2.tgz",
+            "integrity": "sha512-jrBWOxZITuGcnjRCM2t2U5ZPkCLxD+Ym6DjfssS5haTj2iiak/DOb64JeN6OdLfLgptb6/e2kKR+ZuTrGoZTPA==",
+            "license": "MIT",
+            "peerDependencies": {
+                "@types/react": "*",
+                "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc"
+            },
+            "peerDependenciesMeta": {
+                "@types/react": {
+                    "optional": true
+                }
+            }
+        },
         "node_modules/@radix-ui/react-collection": {
             "version": "1.1.7",
             "resolved": "https://registry.npmjs.org/@radix-ui/react-collection/-/react-collection-1.1.7.tgz",
diff --git a/package.json b/package.json
index e3aa684..f113fcd 100644
--- a/package.json
+++ b/package.json
@@ -29,6 +29,7 @@
         "@dnd-kit/sortable": "^10.0.0",
         "@dnd-kit/utilities": "^3.2.2",
         "@radix-ui/react-alert-dialog": "^1.1.15",
+        "@radix-ui/react-collapsible": "^1.1.16",
         "@radix-ui/react-label": "^2.1.7",
         "@radix-ui/react-popover": "^1.1.15",
         "@radix-ui/react-select": "^2.2.6",
diff --git a/src/components/AdjustmentsPanel.tsx b/src/components/AdjustmentsPanel.tsx
index dd69e0d..e62baf2 100644
--- a/src/components/AdjustmentsPanel.tsx
+++ b/src/components/AdjustmentsPanel.tsx
@@ -1,7 +1,7 @@
 import React, { useCallback, useEffect, useRef, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { Slider } from '@/components/ui/slider';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { Check, RotateCcw } from 'lucide-react';
 
 export type SliderDef = {
@@ -120,12 +120,14 @@ export const AdjustmentsPanel: React.FC<Props> = React.memo(
         }, [onBake, onCommit]);
 
         return (
-            <Card className="p-4 border border-border/50 space-y-4">
-                <div className="flex items-start justify-between gap-2">
-                    <div className="space-y-1">
-                        <h3 className="text-sm font-semibold text-foreground">Adjustments</h3>
-                        <p className="text-xs text-muted-foreground">Fine-tune image properties</p>
-                    </div>
+            <CollapsibleCard
+                id="adjustments"
+                title="Adjustments"
+                subtitle="Fine-tune image properties"
+                collapsedSummary={
+                    !allDefault ? <DirtyDot title="Adjustments modified" /> : undefined
+                }
+                actions={
                     <button
                         type="button"
                         onClick={handleResetAll}
@@ -136,8 +138,8 @@ export const AdjustmentsPanel: React.FC<Props> = React.memo(
                     >
                         <RotateCcw className="w-4 h-4" />
                     </button>
-                </div>
-                <div className="h-px bg-border/50" />
+                }
+            >
                 <div className="space-y-4">
                     {defs.map((s) => {
                         const displayVal = values[s.key];
@@ -188,7 +190,7 @@ export const AdjustmentsPanel: React.FC<Props> = React.memo(
                         );
                     })}
                 </div>
-                <div className="h-px bg-border/50" />
+                <div className="h-px bg-border/50 my-4" />
                 <Button
                     type="button"
                     onClick={handleBake}
@@ -199,7 +201,7 @@ export const AdjustmentsPanel: React.FC<Props> = React.memo(
                     <Check className="w-4 h-4" />
                     <span>Apply</span>
                 </Button>
-            </Card>
+            </CollapsibleCard>
         );
     }
 );
diff --git a/src/components/AutoPaintTab.tsx b/src/components/AutoPaintTab.tsx
index 31aff5e..7f80882 100644
--- a/src/components/AutoPaintTab.tsx
+++ b/src/components/AutoPaintTab.tsx
@@ -1,5 +1,5 @@
 import React from 'react';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { NumberInput, Input } from '@/components/ui/input';
 import { Button } from '@/components/ui/button';
 import {
@@ -286,12 +286,24 @@ export default function AutoPaintTab({
 
     return (
         <TabsContent value="autopaint" forceMount className="data-[state=inactive]:hidden">
-            <Card className="p-4 border border-border/50">
-                <div className="space-y-1">
-                    <h3 className="text-sm font-semibold text-foreground">Auto-paint</h3>
-                </div>
-                <div className="h-px bg-border/50 my-4" />
-
+            <CollapsibleCard
+                id="autopaint"
+                title="Auto-paint"
+                collapsedSummary={
+                    <>
+                        {isComputing && (
+                            <Loader2
+                                className="w-4 h-4 animate-spin text-muted-foreground"
+                                aria-label="Computing auto-paint layers"
+                            />
+                        )}
+                        {error && !isComputing && <DirtyDot title={`Auto-paint error: ${error}`} />}
+                        {activeProfileId && isDirty && (
+                            <DirtyDot title="Filament profile has unsaved changes" />
+                        )}
+                    </>
+                }
+            >
                 {/* Profiles Section */}
                 <div className="space-y-2 mb-4">
                     <div className="flex items-center gap-2">
@@ -1264,7 +1276,7 @@ export default function AutoPaintTab({
                         </div>
                     )}
                 </div>
-            </Card>
+            </CollapsibleCard>
 
             {/* Calibration Dialog */}
             <FilamentCalibrationDialog
diff --git a/src/components/CollapsibleCard.tsx b/src/components/CollapsibleCard.tsx
new file mode 100644
index 0000000..1757325
--- /dev/null
+++ b/src/components/CollapsibleCard.tsx
@@ -0,0 +1,97 @@
+import React, { useCallback, useState } from 'react';
+import { ChevronDown } from 'lucide-react';
+import { Card } from '@/components/ui/card';
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/components/ui/collapsible';
+import { cn } from '@/lib/utils';
+import { isGroupCollapsed, setGroupCollapsed } from '@/lib/collapsedGroups';
+
+interface CollapsibleCardProps {
+    /** Stable identifier used to persist the collapsed state across sessions. */
+    id: string;
+    title: React.ReactNode;
+    subtitle?: React.ReactNode;
+    /** Preserve the heading hierarchy of the panel being wrapped. */
+    headingLevel?: 3 | 4;
+    /**
+     * Right side of the header. Always visible, so status badges, counts,
+     * warnings, and quick actions stay discoverable while collapsed.
+     */
+    actions?: React.ReactNode;
+    /** Extra indicators rendered in the header only while the card is collapsed. */
+    collapsedSummary?: React.ReactNode;
+    className?: string;
+    children: React.ReactNode;
+}
+
+/** Small amber dot for "this group has non-default/dirty settings" while collapsed. */
+export const DirtyDot: React.FC<{ title: string }> = ({ title }) => (
+    <span
+        role="status"
+        aria-label={title}
+        title={title}
+        className="w-2 h-2 rounded-full bg-amber-500 flex-shrink-0"
+    />
+);
+
+export const CollapsibleCard: React.FC<CollapsibleCardProps> = ({
+    id,
+    title,
+    subtitle,
+    headingLevel = 3,
+    actions,
+    collapsedSummary,
+    className,
+    children,
+}) => {
+    const [open, setOpen] = useState(() => !isGroupCollapsed(id));
+    const Heading = headingLevel === 4 ? 'h4' : 'h3';
+
+    const handleOpenChange = useCallback(
+        (next: boolean) => {
+            setOpen(next);
+            setGroupCollapsed(id, !next);
+        },
+        [id]
+    );
+
+    return (
+        <Card className={cn('p-4 border border-border/50', className)}>
+            <Collapsible open={open} onOpenChange={handleOpenChange}>
+                <div className="flex items-start justify-between gap-2">
+                    <Heading className="flex-1 min-w-0">
+                        <CollapsibleTrigger asChild>
+                            <button
+                                type="button"
+                                className="group flex w-full items-start gap-1.5 text-left select-none cursor-pointer min-w-0"
+                            >
+                                <ChevronDown className="w-4 h-4 mt-0.5 flex-shrink-0 text-muted-foreground transition-transform duration-200 group-data-[state=closed]:-rotate-90" />
+                                <span className="space-y-1 min-w-0">
+                                    <span className="block text-sm font-semibold text-foreground">
+                                        {title}
+                                    </span>
+                                    {subtitle && (
+                                        <span className="block text-xs text-muted-foreground">
+                                            {subtitle}
+                                        </span>
+                                    )}
+                                </span>
+                            </button>
+                        </CollapsibleTrigger>
+                    </Heading>
+                    {(actions || collapsedSummary) && (
+                        <div className="flex items-center gap-2 flex-shrink-0">
+                            {!open && collapsedSummary}
+                            {actions}
+                        </div>
+                    )}
+                </div>
+                <CollapsibleContent className="overflow-hidden data-[state=open]:animate-collapsible-down data-[state=closed]:animate-collapsible-up">
+                    <div className="h-px bg-border/50 my-4" />
+                    {children}
+                </CollapsibleContent>
+            </Collapsible>
+        </Card>
+    );
+};
+
+export default CollapsibleCard;
diff --git a/src/components/ControlsPanel.tsx b/src/components/ControlsPanel.tsx
index f502461..29dd8e8 100644
--- a/src/components/ControlsPanel.tsx
+++ b/src/components/ControlsPanel.tsx
@@ -2,7 +2,7 @@ import React, { useEffect, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { NumberInput } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { Check, Loader, RotateCcw } from 'lucide-react';
 import {
     Select,
@@ -86,31 +86,36 @@ export const ControlsPanel: React.FC<Props> = ({
         selectedPalette === 'auto';
 
     return (
-        <Card className="p-4 border border-border/50 space-y-4">
-            <div>
-                <div className="flex items-start justify-between gap-2">
-                    <div className="space-y-1">
-                        <h3 className="text-sm font-semibold text-foreground">
-                            Quantization Settings
-                        </h3>
-                        <p className="text-xs text-muted-foreground">
-                            Configure palette and reduce colors
-                        </p>
-                    </div>
-                    {onReset && (
-                        <button
-                            type="button"
-                            onClick={onReset}
-                            disabled={allDefault}
-                            title="Reset quantization settings to default"
-                            aria-label="Reset quantization settings"
-                            className="h-7 w-7 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
-                        >
-                            <RotateCcw className="w-4 h-4" />
-                        </button>
-                    )}
-                </div>
-                <div className="h-px bg-border/50 my-4" />
+        <CollapsibleCard
+            id="quantization"
+            title="Quantization Settings"
+            subtitle="Configure palette and reduce colors"
+                collapsedSummary={
+                    applying ? (
+                        <Loader
+                            className="w-4 h-4 animate-spin text-muted-foreground"
+                            aria-label="Applying quantization"
+                        />
+                    ) : !allDefault ? (
+                        <DirtyDot title="Quantization settings modified" />
+                    ) : undefined
+                }
+            actions={
+                onReset && (
+                    <button
+                        type="button"
+                        onClick={onReset}
+                        disabled={allDefault}
+                        title="Reset quantization settings to default"
+                        aria-label="Reset quantization settings"
+                        className="h-7 w-7 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
+                    >
+                        <RotateCcw className="w-4 h-4" />
+                    </button>
+                )
+            }
+        >
+            <div className="space-y-4">
                 <div className="space-y-4">
                     <div className="space-y-2">
                         <Label htmlFor="palette-select" className="font-medium">
@@ -282,21 +287,21 @@ export const ControlsPanel: React.FC<Props> = ({
                         </Select>
                     </div>
                 </div>
+                <Button
+                    onClick={onApply}
+                    data-testid="quantize-apply"
+                    disabled={disabled || applying}
+                    className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
+                >
+                    {applying ? (
+                        <Loader className="w-4 h-4 animate-spin" />
+                    ) : (
+                        <Check className="w-4 h-4" />
+                    )}
+                    <span>{applying ? 'Applying...' : 'Apply'}</span>
+                </Button>
             </div>
-            <Button
-                onClick={onApply}
-                data-testid="quantize-apply"
-                disabled={disabled || applying}
-                className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
-            >
-                {applying ? (
-                    <Loader className="w-4 h-4 animate-spin" />
-                ) : (
-                    <Check className="w-4 h-4" />
-                )}
-                <span>{applying ? 'Applying...' : 'Apply'}</span>
-            </Button>
-        </Card>
+        </CollapsibleCard>
     );
 };
 
diff --git a/src/components/DeditherPanel.tsx b/src/components/DeditherPanel.tsx
index 1a6a471..f3fc7ff 100644
--- a/src/components/DeditherPanel.tsx
+++ b/src/components/DeditherPanel.tsx
@@ -2,7 +2,7 @@ import React, { useCallback, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { Slider } from '@/components/ui/slider';
 import { Label } from '@/components/ui/label';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { RotateCcw, Check, Loader } from 'lucide-react';
 import type { CanvasPreviewHandle } from './CanvasPreview';
 import { deditherRowProgress } from '../lib/progress';
@@ -218,12 +218,21 @@ export const DeditherPanel: React.FC<Props> = ({
     }, []);
 
     return (
-        <Card className="p-4 border border-border/50 space-y-4">
-            <div className="flex items-start justify-between gap-2">
-                <div className="space-y-1">
-                    <h3 className="text-sm font-semibold text-foreground">Dedither</h3>
-                    <p className="text-xs text-muted-foreground">Smooth dithered patterns</p>
-                </div>
+        <CollapsibleCard
+            id="dedither"
+            title="Dedither"
+            subtitle="Smooth dithered patterns"
+            collapsedSummary={
+                working ? (
+                    <Loader
+                        className="w-4 h-4 animate-spin text-muted-foreground"
+                        aria-label="Applying dedither"
+                    />
+                ) : !allDefault ? (
+                    <DirtyDot title="Dedither settings modified" />
+                ) : undefined
+            }
+            actions={
                 <button
                     type="button"
                     onClick={handleResetAll}
@@ -234,102 +243,102 @@ export const DeditherPanel: React.FC<Props> = ({
                 >
                     <RotateCcw className="w-4 h-4" />
                 </button>
-            </div>
-
-            <div className="h-px bg-border/50" />
-
-            <div className="space-y-2">
-                <div className="flex justify-between items-center text-sm gap-2">
-                    <Label htmlFor="weight-slider" className="font-medium">
-                        Weight
-                    </Label>
-                    <div className="flex items-center gap-2">
-                        <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
-                            {weight}
-                        </span>
-                        <button
-                            type="button"
-                            onClick={(e) => {
-                                e.preventDefault();
-                                e.stopPropagation();
-                                setWeight(DEFAULT_WEIGHT);
-                            }}
-                            disabled={weight === DEFAULT_WEIGHT}
-                            title="Reset weight to default"
-                            aria-label="Reset weight"
-                            className="h-5 w-5 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
-                        >
-                            <RotateCcw className="w-3.5 h-3.5" />
-                        </button>
+            }
+        >
+            <div className="space-y-4">
+                <div className="space-y-2">
+                    <div className="flex justify-between items-center text-sm gap-2">
+                        <Label htmlFor="weight-slider" className="font-medium">
+                            Weight
+                        </Label>
+                        <div className="flex items-center gap-2">
+                            <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
+                                {weight}
+                            </span>
+                            <button
+                                type="button"
+                                onClick={(e) => {
+                                    e.preventDefault();
+                                    e.stopPropagation();
+                                    setWeight(DEFAULT_WEIGHT);
+                                }}
+                                disabled={weight === DEFAULT_WEIGHT}
+                                title="Reset weight to default"
+                                aria-label="Reset weight"
+                                className="h-5 w-5 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
+                            >
+                                <RotateCcw className="w-3.5 h-3.5" />
+                            </button>
+                        </div>
                     </div>
+                    <Slider
+                        id="weight-slider"
+                        data-testid="dedither-weight-slider"
+                        aria-label="Dedither weight"
+                        min={1}
+                        max={9}
+                        step={1}
+                        value={[weight]}
+                        onValueChange={(value) => setWeight(value[0])}
+                        className="w-full"
+                    />
                 </div>
-                <Slider
-                    id="weight-slider"
-                    data-testid="dedither-weight-slider"
-                    aria-label="Dedither weight"
-                    min={1}
-                    max={9}
-                    step={1}
-                    value={[weight]}
-                    onValueChange={(value) => setWeight(value[0])}
-                    className="w-full"
-                />
-            </div>
 
-            <div className="space-y-2">
-                <div className="flex justify-between items-center text-sm gap-2">
-                    <Label htmlFor="passes-slider" className="font-medium">
-                        Passes
-                    </Label>
-                    <div className="flex items-center gap-2">
-                        <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
-                            {passes}
-                        </span>
-                        <button
-                            type="button"
-                            onClick={(e) => {
-                                e.preventDefault();
-                                e.stopPropagation();
-                                setPasses(DEFAULT_PASSES);
-                            }}
-                            disabled={passes === DEFAULT_PASSES}
-                            title="Reset passes to default"
-                            aria-label="Reset passes"
-                            className="h-5 w-5 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
-                        >
-                            <RotateCcw className="w-3.5 h-3.5" />
-                        </button>
+                <div className="space-y-2">
+                    <div className="flex justify-between items-center text-sm gap-2">
+                        <Label htmlFor="passes-slider" className="font-medium">
+                            Passes
+                        </Label>
+                        <div className="flex items-center gap-2">
+                            <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
+                                {passes}
+                            </span>
+                            <button
+                                type="button"
+                                onClick={(e) => {
+                                    e.preventDefault();
+                                    e.stopPropagation();
+                                    setPasses(DEFAULT_PASSES);
+                                }}
+                                disabled={passes === DEFAULT_PASSES}
+                                title="Reset passes to default"
+                                aria-label="Reset passes"
+                                className="h-5 w-5 flex-shrink-0 flex items-center justify-center rounded-md text-muted-foreground hover:text-amber-600 hover:bg-amber-600/15 transition-colors disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:bg-transparent disabled:hover:text-muted-foreground select-none cursor-pointer"
+                            >
+                                <RotateCcw className="w-3.5 h-3.5" />
+                            </button>
+                        </div>
                     </div>
+                    <Slider
+                        id="passes-slider"
+                        data-testid="dedither-passes-slider"
+                        aria-label="Dedither passes"
+                        min={1}
+                        max={10}
+                        step={1}
+                        value={[passes]}
+                        onValueChange={(value) => setPasses(value[0])}
+                        className="w-full"
+                    />
                 </div>
-                <Slider
-                    id="passes-slider"
-                    data-testid="dedither-passes-slider"
-                    aria-label="Dedither passes"
-                    min={1}
-                    max={10}
-                    step={1}
-                    value={[passes]}
-                    onValueChange={(value) => setPasses(value[0])}
-                    className="w-full"
-                />
-            </div>
 
-            <div className="h-px bg-border/50" />
+                <div className="h-px bg-border/50" />
 
-            <Button
-                onClick={handleApply}
-                data-testid="dedither-apply"
-                disabled={working}
-                className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
-            >
-                {working ? (
-                    <Loader className="w-4 h-4 animate-spin" />
-                ) : (
-                    <Check className="w-4 h-4" />
-                )}
-                <span>{working ? 'Applying...' : 'Apply'}</span>
-            </Button>
-        </Card>
+                <Button
+                    onClick={handleApply}
+                    data-testid="dedither-apply"
+                    disabled={working}
+                    className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
+                >
+                    {working ? (
+                        <Loader className="w-4 h-4 animate-spin" />
+                    ) : (
+                        <Check className="w-4 h-4" />
+                    )}
+                    <span>{working ? 'Applying...' : 'Apply'}</span>
+                </Button>
+            </div>
+        </CollapsibleCard>
     );
 };
 
diff --git a/src/components/ImageResizePanel.tsx b/src/components/ImageResizePanel.tsx
index 4afca35..c6aa8f6 100644
--- a/src/components/ImageResizePanel.tsx
+++ b/src/components/ImageResizePanel.tsx
@@ -2,7 +2,7 @@ import React, { useMemo, useState } from 'react';
 import { Button } from '@/components/ui/button';
 import { Label } from '@/components/ui/label';
 import { Slider } from '@/components/ui/slider';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { Check, Loader, RotateCcw } from 'lucide-react';
 import type { ImageDimensions } from '../hooks/useSwatches';
 import {
@@ -59,12 +59,21 @@ export const ImageResizePanel: React.FC<Props> = ({
     };
 
     return (
-        <Card className="p-4 border border-border/50 space-y-4">
-            <div className="flex items-start justify-between gap-2">
-                <div className="space-y-1">
-                    <h3 className="text-sm font-semibold text-foreground">Resize Image</h3>
-                    <p className="text-xs text-muted-foreground">Downscale pixel resolution</p>
-                </div>
+        <CollapsibleCard
+            id="resize-image"
+            title="Resize Image"
+            subtitle="Downscale pixel resolution"
+            collapsedSummary={
+                working ? (
+                    <Loader
+                        className="w-4 h-4 animate-spin text-muted-foreground"
+                        aria-label="Resizing image"
+                    />
+                ) : !allDefault ? (
+                    <DirtyDot title="Resize percentage modified" />
+                ) : undefined
+            }
+            actions={
                 <button
                     type="button"
                     onClick={() => commitPercent(DEFAULT_IMAGE_RESIZE_PERCENT)}
@@ -75,66 +84,66 @@ export const ImageResizePanel: React.FC<Props> = ({
                 >
                     <RotateCcw className="w-4 h-4" />
                 </button>
-            </div>
-
-            <div className="h-px bg-border/50" />
-
-            <div className="space-y-3">
-                <div className="flex justify-between items-center gap-2">
-                    <Label htmlFor="image-resize-percent-slider" className="font-medium">
-                        Scale
-                    </Label>
-                    <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
-                        {percent}%
-                    </span>
+            }
+        >
+            <div className="space-y-4">
+                <div className="space-y-3">
+                    <div className="flex justify-between items-center gap-2">
+                        <Label htmlFor="image-resize-percent-slider" className="font-medium">
+                            Scale
+                        </Label>
+                        <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold">
+                            {percent}%
+                        </span>
+                    </div>
+                    <Slider
+                        id="image-resize-percent-slider"
+                        data-testid="image-resize-percent-slider"
+                        aria-label="Resize percentage"
+                        min={MIN_IMAGE_RESIZE_PERCENT}
+                        max={MAX_IMAGE_RESIZE_PERCENT}
+                        step={1}
+                        value={[percent]}
+                        onValueChange={(value) => commitPercent(value[0])}
+                        className="w-full"
+                        disabled={working}
+                    />
                 </div>
-                <Slider
-                    id="image-resize-percent-slider"
-                    data-testid="image-resize-percent-slider"
-                    aria-label="Resize percentage"
-                    min={MIN_IMAGE_RESIZE_PERCENT}
-                    max={MAX_IMAGE_RESIZE_PERCENT}
-                    step={1}
-                    value={[percent]}
-                    onValueChange={(value) => commitPercent(value[0])}
-                    className="w-full"
-                    disabled={working}
-                />
-            </div>
 
-            <div className="rounded-md border border-border/60 bg-background/60 px-3 py-2 text-xs">
-                <div className="flex items-center justify-between gap-2">
-                    <span className="text-muted-foreground">Current</span>
-                    <span className="font-mono text-foreground">
-                        {imageDimensions
-                            ? `${imageDimensions.width}x${imageDimensions.height} px`
-                            : 'No image'}
-                    </span>
+                <div className="rounded-md border border-border/60 bg-background/60 px-3 py-2 text-xs">
+                    <div className="flex items-center justify-between gap-2">
+                        <span className="text-muted-foreground">Current</span>
+                        <span className="font-mono text-foreground">
+                            {imageDimensions
+                                ? `${imageDimensions.width}x${imageDimensions.height} px`
+                                : 'No image'}
+                        </span>
+                    </div>
+                    <div className="mt-1 flex items-center justify-between gap-2">
+                        <span className="text-muted-foreground">After resize</span>
+                        <span className="font-mono text-primary font-semibold">
+                            {targetDimensions
+                                ? `${targetDimensions.width}x${targetDimensions.height} px`
+                                : '-'}
+                        </span>
+                    </div>
                 </div>
-                <div className="mt-1 flex items-center justify-between gap-2">
-                    <span className="text-muted-foreground">After resize</span>
-                    <span className="font-mono text-primary font-semibold">
-                        {targetDimensions
-                            ? `${targetDimensions.width}x${targetDimensions.height} px`
-                            : '-'}
-                    </span>
-                </div>
-            </div>
 
-            <Button
-                onClick={handleApply}
-                data-testid="image-resize-apply"
-                disabled={applyDisabled}
-                className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
-            >
-                {working ? (
-                    <Loader className="w-4 h-4 animate-spin" />
-                ) : (
-                    <Check className="w-4 h-4" />
-                )}
-                <span>{working ? 'Resizing...' : 'Apply'}</span>
-            </Button>
-        </Card>
+                <Button
+                    onClick={handleApply}
+                    data-testid="image-resize-apply"
+                    disabled={applyDisabled}
+                    className="w-full bg-green-600 hover:bg-green-700 text-white font-semibold disabled:bg-green-600/50 disabled:cursor-not-allowed transition-all duration-200 shadow-md hover:shadow-lg active:scale-95 gap-1.5"
+                >
+                    {working ? (
+                        <Loader className="w-4 h-4 animate-spin" />
+                    ) : (
+                        <Check className="w-4 h-4" />
+                    )}
+                    <span>{working ? 'Resizing...' : 'Apply'}</span>
+                </Button>
+            </div>
+        </CollapsibleCard>
     );
 };
 
diff --git a/src/components/PrintInstructions.tsx b/src/components/PrintInstructions.tsx
index 477ea7b..f2b55c9 100644
--- a/src/components/PrintInstructions.tsx
+++ b/src/components/PrintInstructions.tsx
@@ -1,4 +1,4 @@
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import type { SwapEntry } from '../hooks/useSwapPlan';
 
 interface PrintInstructionsProps {
@@ -24,14 +24,16 @@ export default function PrintInstructions({
     flatPaint = false,
 }: PrintInstructionsProps) {
     return (
-        <Card className="p-4 border border-border/50 mt-6">
-            <div className="flex justify-between items-start mb-4">
-                <div>
-                    <h4 className="font-semibold text-foreground">Print Instructions</h4>
-                    <p className="text-xs text-muted-foreground mt-1">
-                        Generated swap plan for your printer
-                    </p>
-                </div>
+        <CollapsibleCard
+            id="print-instructions"
+            title="Print Instructions"
+            subtitle="Generated swap plan for your printer"
+            headingLevel={4}
+            className="mt-6"
+            collapsedSummary={
+                tooManyColors ? <DirtyDot title="Too many colors for a swap plan" /> : undefined
+            }
+            actions={
                 <button
                     type="button"
                     onClick={onCopy}
@@ -46,10 +48,8 @@ export default function PrintInstructions({
                 >
                     {copied ? '✓ Copied!' : 'Copy'}
                 </button>
-            </div>
-
-            <div className="h-px bg-border/50 mb-4" />
-
+            }
+        >
             <div className="space-y-4 text-sm">
                 {/* Recommended Settings */}
                 <div className="p-3 rounded-lg bg-primary/5 border border-primary/20">
@@ -200,6 +200,6 @@ export default function PrintInstructions({
                     </span>
                 </div>
             </div>
-        </Card>
+        </CollapsibleCard>
     );
 }
diff --git a/src/components/PrintSettingsCard.tsx b/src/components/PrintSettingsCard.tsx
index 713e0fd..33576ef 100644
--- a/src/components/PrintSettingsCard.tsx
+++ b/src/components/PrintSettingsCard.tsx
@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import { Input } from '@/components/ui/input';
 import { Switch } from '@/components/ui/switch';
 import { RotateCcw } from 'lucide-react';
@@ -127,14 +127,14 @@ export default function PrintSettingsCard({
     );
 
     return (
-        <Card className="p-4 border border-border/50">
-            <div className="flex items-start justify-between gap-2">
-                <div className="space-y-1">
-                    <h3 className="text-sm font-semibold text-foreground">3D Print Settings</h3>
-                    <p className="text-xs text-muted-foreground">
-                        Configure your printing parameters
-                    </p>
-                </div>
+        <CollapsibleCard
+            id="print-settings"
+            title="3D Print Settings"
+            subtitle="Configure your printing parameters"
+            collapsedSummary={
+                !allDefault ? <DirtyDot title="Print settings modified" /> : undefined
+            }
+            actions={
                 <button
                     type="button"
                     onClick={onReset}
@@ -145,8 +145,8 @@ export default function PrintSettingsCard({
                 >
                     <RotateCcw className="w-4 h-4" />
                 </button>
-            </div>
-            <div className="h-px bg-border/50 my-4" />
+            }
+        >
             <div className="space-y-4">
                 {/* Pixel size (XY scaling) */}
                 <div className="space-y-3">
@@ -205,7 +205,11 @@ export default function PrintSettingsCard({
                             type="text"
                             inputMode="decimal"
                             value={layerHeightInput.value}
-                            className={layerHeightInput.error ? 'border-red-500 focus-visible:ring-red-500' : ''}
+                            className={
+                                layerHeightInput.error
+                                    ? 'border-red-500 focus-visible:ring-red-500'
+                                    : ''
+                            }
                             onChange={(e) => layerHeightInput.onChange(e.target.value)}
                             onFocus={layerHeightInput.onFocus}
                             onBlur={layerHeightInput.onBlur}
@@ -232,13 +236,19 @@ export default function PrintSettingsCard({
                             type="text"
                             inputMode="decimal"
                             value={firstLayerHeightInput.value}
-                            className={firstLayerHeightInput.error ? 'border-red-500 focus-visible:ring-red-500' : ''}
+                            className={
+                                firstLayerHeightInput.error
+                                    ? 'border-red-500 focus-visible:ring-red-500'
+                                    : ''
+                            }
                             onChange={(e) => firstLayerHeightInput.onChange(e.target.value)}
                             onFocus={firstLayerHeightInput.onFocus}
                             onBlur={firstLayerHeightInput.onBlur}
                         />
                         {firstLayerHeightInput.error && (
-                            <span className="text-xs text-red-500">{firstLayerHeightInput.error}</span>
+                            <span className="text-xs text-red-500">
+                                {firstLayerHeightInput.error}
+                            </span>
                         )}
                     </label>
                 </div>
@@ -248,8 +258,8 @@ export default function PrintSettingsCard({
                     <div>
                         <span className="font-semibold text-foreground">Smooth Meshing</span>
                         <p className="text-xs text-muted-foreground">
-                            Smooth connected color boundary edges with fast welded topology.
-                            Turning this on disables Flat Paint.
+                            Smooth connected color boundary edges with fast welded topology. Turning
+                            this on disables Flat Paint.
                         </p>
                     </div>
                     <Switch
@@ -260,6 +270,6 @@ export default function PrintSettingsCard({
                     />
                 </div>
             </div>
-        </Card>
+        </CollapsibleCard>
     );
 }
diff --git a/src/components/SwatchesPanel.tsx b/src/components/SwatchesPanel.tsx
index 2fad766..b29971d 100644
--- a/src/components/SwatchesPanel.tsx
+++ b/src/components/SwatchesPanel.tsx
@@ -3,6 +3,7 @@ import { RgbaColorPicker } from 'react-colorful';
 import { Button } from '@/components/ui/button';
 import { Input } from '@/components/ui/input';
 import { Card } from '@/components/ui/card';
+import { CollapsibleCard } from '@/components/CollapsibleCard';
 import { X } from 'lucide-react';
 
 interface SwatchEntry {
@@ -57,13 +58,12 @@ export const SwatchesPanel: React.FC<Props> = ({
     const closeModal = () => setOpenSwatch(null);
 
     return (
-        <Card className="p-4 border border-border/50 space-y-4">
-            <div className="flex justify-between items-center">
-                <div>
-                    <h3 className="text-sm font-semibold text-foreground">Image colors</h3>
-                    <p className="text-xs text-muted-foreground mt-1">Detected color palette</p>
-                </div>
-                <div className="flex items-center gap-2">
+        <CollapsibleCard
+            id="image-colors"
+            title="Image colors"
+            subtitle="Detected color palette"
+            actions={
+                <>
                     <span
                         className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-semibold font-mono"
                         aria-hidden
@@ -76,9 +76,9 @@ export const SwatchesPanel: React.FC<Props> = ({
                             Updating…
                         </span>
                     )}
-                </div>
-            </div>
-            <div className="h-px bg-border/50" />
+                </>
+            }
+        >
             <div
                 className="grid gap-2 p-3 rounded-lg bg-muted/30"
                 style={{ gridTemplateColumns: 'repeat(auto-fill, minmax(15px, 1fr))' }}
@@ -290,7 +290,7 @@ export const SwatchesPanel: React.FC<Props> = ({
                     </Card>
                 </div>
             )}
-        </Card>
+        </CollapsibleCard>
     );
 };
 
diff --git a/src/components/ThreeDControls.tsx b/src/components/ThreeDControls.tsx
index fa11b1c..0cd0379 100644
--- a/src/components/ThreeDControls.tsx
+++ b/src/components/ThreeDControls.tsx
@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useMemo, useState } from 'react';
-import { Card } from '@/components/ui/card';
+import { CollapsibleCard, DirtyDot } from '@/components/CollapsibleCard';
 import ThreeDColorRow from './ThreeDColorRow';
 import { Sortable, SortableContent, SortableOverlay } from '@/components/ui/sortable';
 import { Button } from '@/components/ui/button';
@@ -60,7 +60,14 @@ export default function ThreeDControls({
     persisted,
 }: ThreeDControlsProps) {
     // --- Filaments ---
-    const { filaments, setFilaments, addFilament, addFilamentWithProps, removeFilament, updateFilament } = useFilaments({
+    const {
+        filaments,
+        setFilaments,
+        addFilament,
+        addFilamentWithProps,
+        removeFilament,
+        updateFilament,
+    } = useFilaments({
         initial: persisted?.filaments?.length ? persisted.filaments : undefined,
     });
 
@@ -115,7 +122,9 @@ export default function ThreeDControls({
     );
     const [paintMode, setPaintMode] = useState<'manual' | 'autopaint'>(initialPaintMode);
     const [autoPaintMaxHeight, setAutoPaintMaxHeight] = useState<number | undefined>(undefined);
-    const [enhancedColorMatch, setEnhancedColorMatch] = useState(persisted?.enhancedColorMatch ?? false);
+    const [enhancedColorMatch, setEnhancedColorMatch] = useState(
+        persisted?.enhancedColorMatch ?? false
+    );
     const initialPreserveSeparation = persisted?.preserveSeparation ?? false;
     const [preserveSeparation, setPreserveSeparation] = useState(initialPreserveSeparation);
     const [maxRepeatedSwaps, setMaxRepeatedSwaps] = useState<AutoPaintRepeatLimit>(
@@ -133,9 +142,7 @@ export default function ThreeDControls({
     // --- Optimizer Options ---
     const [optimizerAlgorithm, setOptimizerAlgorithm] = useState<
         'fast' | 'balanced' | 'thorough' | 'deep' | 'exact'
-    >(
-        persisted?.optimizerAlgorithm ?? 'balanced'
-    );
+    >(persisted?.optimizerAlgorithm ?? 'balanced');
     const [optimizerSeed, setOptimizerSeed] = useState<number | undefined>(
         persisted?.optimizerSeed
     );
@@ -196,11 +203,30 @@ export default function ThreeDControls({
             regionWeightingMode,
             smoothMeshing,
         });
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [paintMode, filaments, enhancedColorMatch, preserveSeparation, maxRepeatedSwaps, transitionOpacity, heightDithering, ditherLineWidth, flatPaint, optimizerAlgorithm, optimizerSeed, regionWeightingMode, smoothMeshing]);
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [
+        paintMode,
+        filaments,
+        enhancedColorMatch,
+        preserveSeparation,
+        maxRepeatedSwaps,
+        transitionOpacity,
+        heightDithering,
+        ditherLineWidth,
+        flatPaint,
+        optimizerAlgorithm,
+        optimizerSeed,
+        regionWeightingMode,
+        smoothMeshing,
+    ]);
 
     useEffect(() => {
-        savePrintSettingsToStorage({ layerHeight, slicerFirstLayerHeight, pixelSize, smoothMeshing });
+        savePrintSettingsToStorage({
+            layerHeight,
+            slicerFirstLayerHeight,
+            pixelSize,
+            smoothMeshing,
+        });
     }, [layerHeight, slicerFirstLayerHeight, pixelSize, smoothMeshing]);
 
     // --- Color Slicing ---
@@ -313,7 +339,7 @@ export default function ThreeDControls({
     const instructionFlatPaint = builtState ? builtFlatPaint : flatPaintActive;
     const instructionColorCount =
         instructionPaintMode === 'autopaint'
-            ? instructionAutoPaintResult?.layers.length ?? 0
+            ? (instructionAutoPaintResult?.layers.length ?? 0)
             : instructionColorOrder.length;
     const isInstructionOverLimit = instructionColorCount > 64;
 
@@ -524,17 +550,18 @@ export default function ThreeDControls({
 
                 {/* Manual Tab */}
                 <TabsContent value="manual" forceMount className="data-[state=inactive]:hidden">
-                    <Card className="p-4 border border-border/50">
-                        <div className="flex justify-between items-center mb-4">
-                            <div>
-                                <h4 className="font-semibold text-foreground">
-                                    Color Slice Heights
-                                </h4>
-                                <p className="text-xs text-muted-foreground mt-1">
-                                    Drag to reorder, adjust sliders to customize
-                                </p>
-                            </div>
-                            <div className="flex items-center gap-2">
+                    <CollapsibleCard
+                        id="color-slice-heights"
+                        title="Color Slice Heights"
+                        subtitle="Drag to reorder, adjust sliders to customize"
+                        headingLevel={4}
+                        collapsedSummary={
+                            !isResetState ? (
+                                <DirtyDot title="Color heights or order modified" />
+                            ) : undefined
+                        }
+                        actions={
+                            <>
                                 <button
                                     type="button"
                                     onClick={handleResetHeights}
@@ -548,22 +575,25 @@ export default function ThreeDControls({
                                 <span className="px-2 py-1 rounded-full bg-primary/10 text-primary text-xs font-semibold">
                                     {filtered.length} colors
                                 </span>
-                            </div>
-                        </div>
-                        <div className="h-px bg-border/50 mb-4" />
+                            </>
+                        }
+                    >
                         <Sortable
                             value={displayOrder.map(String)}
                             onValueChange={handleColorOrderChange}
-                            orientation="vertical">
+                            orientation="vertical"
+                        >
                             <SortableContent asChild>
                                 <div className="space-y-2">
                                     {displayOrder.length > 64 ? (
                                         <div className="p-4 bg-destructive/10 border border-destructive/20 rounded-md text-sm text-destructive-foreground">
-                                            <p className="font-semibold mb-2">Too many colors ({displayOrder.length})</p>
+                                            <p className="font-semibold mb-2">
+                                                Too many colors ({displayOrder.length})
+                                            </p>
                                             <p>
-                                                The image has more than 64 unique colors. Please reduce
-                                                the image to fewer colors in 2D mode using the quantization
-                                                tools before switching to 3D mode.
+                                                The image has more than 64 unique colors. Please
+                                                reduce the image to fewer colors in 2D mode using
+                                                the quantization tools before switching to 3D mode.
                                             </p>
                                         </div>
                                     ) : (
@@ -593,7 +623,7 @@ export default function ThreeDControls({
                                 <div className="rounded-lg bg-primary/10 h-11" />
                             </SortableOverlay>
                         </Sortable>
-                    </Card>
+                    </CollapsibleCard>
                 </TabsContent>
             </Tabs>
 
diff --git a/src/components/ui/collapsible.tsx b/src/components/ui/collapsible.tsx
new file mode 100644
index 0000000..9605c4e
--- /dev/null
+++ b/src/components/ui/collapsible.tsx
@@ -0,0 +1,9 @@
+import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
+
+const Collapsible = CollapsiblePrimitive.Root;
+
+const CollapsibleTrigger = CollapsiblePrimitive.CollapsibleTrigger;
+
+const CollapsibleContent = CollapsiblePrimitive.CollapsibleContent;
+
+export { Collapsible, CollapsibleTrigger, CollapsibleContent };
diff --git a/src/index.css b/src/index.css
index d071026..4097868 100644
--- a/src/index.css
+++ b/src/index.css
@@ -8,6 +8,8 @@
     --animate-ping: ping 1s cubic-bezier(0, 0, 0.2, 1) infinite;
     --animate-pulse: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;
     --animate-bounce: bounce 1s infinite;
+    --animate-collapsible-down: collapsible-down 0.2s ease-out;
+    --animate-collapsible-up: collapsible-up 0.2s ease-out;
 }
 
 :root {
@@ -203,6 +205,24 @@
     }
 }
 
+@keyframes collapsible-down {
+    from {
+        height: 0;
+    }
+    to {
+        height: var(--radix-collapsible-content-height);
+    }
+}
+
+@keyframes collapsible-up {
+    from {
+        height: var(--radix-collapsible-content-height);
+    }
+    to {
+        height: 0;
+    }
+}
+
 /* Ensure box-sizing is border-box everywhere */
 *,
 *::before,
diff --git a/src/lib/collapsedGroups.ts b/src/lib/collapsedGroups.ts
new file mode 100644
index 0000000..7df8877
--- /dev/null
+++ b/src/lib/collapsedGroups.ts
@@ -0,0 +1,35 @@
+const KEY = 'kromacut.ui.collapsedGroups.v1';
+
+export function loadCollapsedGroups(): Record<string, boolean> {
+    try {
+        const raw = localStorage.getItem(KEY);
+        if (!raw) return {};
+        const parsed: unknown = JSON.parse(raw);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) return {};
+        const groups: Record<string, boolean> = {};
+        for (const [id, collapsed] of Object.entries(parsed)) {
+            if (typeof collapsed === 'boolean') groups[id] = collapsed;
+        }
+        return groups;
+    } catch {
+        return {};
+    }
+}
+
+export function isGroupCollapsed(id: string): boolean {
+    return loadCollapsedGroups()[id] === true;
+}
+
+export function setGroupCollapsed(id: string, collapsed: boolean): void {
+    try {
+        const groups = loadCollapsedGroups();
+        if (collapsed) {
+            groups[id] = true;
+        } else {
+            delete groups[id];
+        }
+        localStorage.setItem(KEY, JSON.stringify(groups));
+    } catch {
+        // Storage unavailable; the in-memory React state still tracks the session.
+    }
+}
diff --git a/tests/collapsedGroups.test.ts b/tests/collapsedGroups.test.ts
new file mode 100644
index 0000000..3ccd245
--- /dev/null
+++ b/tests/collapsedGroups.test.ts
@@ -0,0 +1,84 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+// Minimal localStorage mock for Node.js. Another test file in the same process
+// may already have installed one (the property is not configurable), so only
+// define it when missing and use whichever mock is active.
+if (!('localStorage' in globalThis)) {
+    const store: Record<string, string> = {};
+    Object.defineProperty(globalThis, 'localStorage', {
+        value: {
+            getItem: (key: string) => store[key] ?? null,
+            setItem: (key: string, value: string) => {
+                store[key] = value;
+            },
+            removeItem: (key: string) => {
+                delete store[key];
+            },
+            clear: () => {
+                for (const k of Object.keys(store)) delete store[k];
+            },
+        },
+    });
+}
+const mockLocalStorage = (globalThis as { localStorage: Storage }).localStorage;
+
+const { loadCollapsedGroups, isGroupCollapsed, setGroupCollapsed } =
+    await import('../src/lib/collapsedGroups.ts');
+
+const KEY = 'kromacut.ui.collapsedGroups.v1';
+
+test('groups default to expanded when nothing is stored', () => {
+    mockLocalStorage.clear();
+    assert.equal(isGroupCollapsed('quantization'), false);
+    assert.deepEqual(loadCollapsedGroups(), {});
+});
+
+test('collapsing a group persists it', () => {
+    mockLocalStorage.clear();
+    setGroupCollapsed('quantization', true);
+    assert.equal(isGroupCollapsed('quantization'), true);
+    assert.equal(isGroupCollapsed('adjustments'), false);
+});
+
+test('expanding a group removes it from storage', () => {
+    mockLocalStorage.clear();
+    setGroupCollapsed('quantization', true);
+    setGroupCollapsed('quantization', false);
+    assert.equal(isGroupCollapsed('quantization'), false);
+    assert.equal(mockLocalStorage.getItem(KEY), '{}');
+});
+
+test('multiple groups persist independently', () => {
+    mockLocalStorage.clear();
+    setGroupCollapsed('adjustments', true);
+    setGroupCollapsed('dedither', true);
+    setGroupCollapsed('adjustments', false);
+    assert.deepEqual(loadCollapsedGroups(), { dedither: true });
+});
+
+test('corrupt stored JSON falls back to expanded', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(KEY, 'not json{');
+    assert.deepEqual(loadCollapsedGroups(), {});
+    assert.equal(isGroupCollapsed('quantization'), false);
+});
+
+test('non-object stored JSON falls back to expanded', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(KEY, '["quantization"]');
+    assert.deepEqual(loadCollapsedGroups(), {});
+});
+
+test('non-boolean entries are dropped on load', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(KEY, '{"quantization":true,"weird":"yes","n":1}');
+    assert.deepEqual(loadCollapsedGroups(), { quantization: true });
+});
+
+test('setGroupCollapsed repairs corrupt storage instead of throwing', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(KEY, 'not json{');
+    setGroupCollapsed('swatches', true);
+    assert.deepEqual(loadCollapsedGroups(), { swatches: true });
+});

From 2671f0f80edca5b94821b9c095a1fa83734d086b Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Fri, 10 Jul 2026 10:34:55 +0300
Subject: [PATCH 62/81] feat: 3D inspection view modes - The 3D preview toolbar
 now offers Shaded, Transparent, and Wireframe modes for inspecting surfaces,
 layers, and mesh edges. Wireframe uses thin, layer-colored feature edges, and
 the selected view is remembered without changing print settings or STL/3MF
 export content.

---
 CHANGELOG.md                      |   3 +-
 src/App.tsx                       |  11 ++
 src/components/PreviewActions.tsx |  81 ++++++++
 src/components/ThreeDView.tsx     | 167 +++++++++++++++-
 src/docs/3d-mode.md               |   1 +
 src/hooks/useThreeScene.ts        |  11 +-
 src/lib/meshing.ts                | 306 +++++++++++++++++++++++++---
 src/lib/previewPrefs.ts           |  24 +++
 src/lib/previewRenderMode.ts      | 189 ++++++++++++++++++
 src/lib/previewWireframe.ts       | 317 ++++++++++++++++++++++++++++++
 src/types/index.ts                |   3 +
 tests/export3mf.test.ts           |  46 +++++
 tests/meshing.test.ts             |  90 +++++++++
 tests/previewPrefs.test.ts        |  51 +++++
 tests/previewRenderMode.test.ts   | 109 ++++++++++
 tests/previewWireframe.test.ts    | 196 ++++++++++++++++++
 16 files changed, 1570 insertions(+), 35 deletions(-)
 create mode 100644 src/lib/previewPrefs.ts
 create mode 100644 src/lib/previewRenderMode.ts
 create mode 100644 src/lib/previewWireframe.ts
 create mode 100644 tests/previewPrefs.test.ts
 create mode 100644 tests/previewRenderMode.test.ts
 create mode 100644 tests/previewWireframe.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 66079d2..0c66870 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
 - **Filament profile import fixture** - Added a schema-v2 frontlit-calibrated 8-color `.kfil` fixture with import coverage to guard against accidental hiding-distance rescaling.
 - **Collapsible control groups** - Every settings card in 2D and 3D mode (Adjustments, Resize Image, Dedither, Quantization Settings, Image colors, 3D Print Settings, Auto-paint, Color Slice Heights, and Print Instructions) can now be collapsed from its header to save sidebar space. Collapsed groups are remembered across sessions, and important indicators stay visible while collapsed: color counts, busy spinners, modified-settings dots, unsaved-profile markers, and quick actions like reset and copy.
+- **3D inspection view modes** - The 3D preview toolbar now offers Shaded, Transparent, and Wireframe modes for inspecting surfaces, layers, and mesh edges. Wireframe uses thin, layer-colored feature edges, and the selected view is remembered without changing print settings or STL/3MF export content.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
@@ -63,7 +64,7 @@ All notable changes to Kromacut are documented in this file.
 - **Project license** - Kromacut is now licensed under `AGPL-3.0-only` instead of MIT so redistributed or hosted modified versions must stay open under the same copyleft terms
 - **Web metadata** - Improved the page title, search description, canonical URL, social preview tags, and web app manifest metadata for hosted Kromacut pages
 - **Filament profile extension** - Auto-paint filament profile exports now use `.kfil` by default while continuing to import legacy `.kapp` files
-- **Smooth meshing performance** - Smooth mesh generation now uses one fast welded-grid algorithm with deterministic boundary-chain smoothing in a bounded sub-pixel envelope and fan-triangulated caps instead of contour tracing and cap cleanup, avoiding hangs and browser memory blowups on complex image layers
+- **Smooth meshing performance** - Smooth mesh generation now uses one fast welded-grid algorithm with deterministic boundary-chain smoothing in a bounded sub-pixel envelope and boundary-preserving caps validated at slicer precision, avoiding inverted preview faces, open exports, hangs, and browser memory blowups on complex image layers
 
 ### Fixed
 
diff --git a/src/App.tsx b/src/App.tsx
index c2c3187..47320ad 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -5,6 +5,7 @@ import {
     AUTO_PAINT_TRANSITION_OPACITIES,
     type AutoPaintRepeatLimit,
     type AutoPaintTransitionOpacity,
+    type PreviewRenderMode,
     type ThreeDControlsStateShape,
 } from './types';
 import ThreeDView from './components/ThreeDView';
@@ -41,6 +42,7 @@ import ProgressOverlay from './components/ProgressOverlay';
 import DocsPage from './components/docs/DocsPage';
 import { defaultDocSlug } from './docs';
 import { loadCameraMode, saveCameraMode } from './lib/cameraPrefs';
+import { loadPreviewRenderMode, savePreviewRenderMode } from './lib/previewPrefs';
 import { buildDocsPath, parseDocsLocation } from './lib/docs/navigation';
 import { applyHomeSeo } from './lib/seo';
 import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
@@ -252,6 +254,9 @@ function App(): React.ReactElement | null {
     const [mode, setMode] = useState<'2d' | '3d'>('2d');
     const [docsOpen, setDocsOpen] = useState(() => parseDocsLocation(window.location) !== null);
     const [isOrtho, setIsOrtho] = useState(loadCameraMode);
+    const [previewRenderMode, setPreviewRenderMode] = useState<PreviewRenderMode>(
+        loadPreviewRenderMode
+    );
     const [exportingSTL, setExportingSTL] = useState(false);
     const [exportProgress, setExportProgress] = useState(0); // 0..1
     const [exportStep, setExportStep] = useState<ExportProgressStep>({
@@ -738,6 +743,7 @@ function App(): React.ReactElement | null {
                                             smoothMeshing={builtModelState.smoothMeshing}
                                             isOrtho={isOrtho}
                                             flatPaint={builtFlatPaint}
+                                            previewRenderMode={previewRenderMode}
                                         />
                                         {exportingSTL && (
                                             <ProgressOverlay
@@ -783,6 +789,11 @@ function App(): React.ReactElement | null {
                                     onExport3MF={onExport3MF}
                                     flatPaintModel={builtFlatPaint}
                                     isOrtho={isOrtho}
+                                    previewRenderMode={previewRenderMode}
+                                    onPreviewRenderModeChange={(next) => {
+                                        setPreviewRenderMode(next);
+                                        savePreviewRenderMode(next);
+                                    }}
                                     onToggleCamera={() =>
                                         setIsOrtho((v) => {
                                             const next = !v;
diff --git a/src/components/PreviewActions.tsx b/src/components/PreviewActions.tsx
index fbe504b..7b281db 100644
--- a/src/components/PreviewActions.tsx
+++ b/src/components/PreviewActions.tsx
@@ -1,6 +1,7 @@
 import React from 'react';
 import { Button } from '@/components/ui/button';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
+import type { PreviewRenderMode } from '@/types';
 import {
     RotateCcw,
     RotateCw,
@@ -16,6 +17,8 @@ import {
     FileType,
     Box,
     Camera,
+    Check,
+    Eye,
 } from 'lucide-react';
 
 export interface PreviewActionsProps {
@@ -42,6 +45,8 @@ export interface PreviewActionsProps {
     flatPaintModel?: boolean;
     isOrtho?: boolean;
     onToggleCamera?: () => void;
+    previewRenderMode?: PreviewRenderMode;
+    onPreviewRenderModeChange?: (mode: PreviewRenderMode) => void;
 }
 
 export const PreviewActions: React.FC<PreviewActionsProps> = ({
@@ -67,9 +72,85 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
     flatPaintModel = false,
     isOrtho = false,
     onToggleCamera,
+    previewRenderMode = 'shaded',
+    onPreviewRenderModeChange,
 }) => {
+    const [previewModeMenuOpen, setPreviewModeMenuOpen] = React.useState(false);
+    const PreviewModeIcon =
+        previewRenderMode === 'wireframe'
+            ? Grid3x3
+            : previewRenderMode === 'transparent'
+              ? Eye
+              : Box;
+    const previewRenderModeLabel =
+        previewRenderMode === 'wireframe'
+            ? 'Wireframe'
+            : previewRenderMode === 'transparent'
+              ? 'Transparent'
+              : 'Shaded';
+    const previewModeOptions: Array<{
+        value: PreviewRenderMode;
+        label: string;
+        icon: React.ReactNode;
+    }> = [
+        { value: 'shaded', label: 'Shaded', icon: <Box className="w-4 h-4" /> },
+        { value: 'transparent', label: 'Transparent', icon: <Eye className="w-4 h-4" /> },
+        { value: 'wireframe', label: 'Wireframe', icon: <Grid3x3 className="w-4 h-4" /> },
+    ];
+
     return (
         <div className="absolute top-4 right-4 flex flex-wrap gap-2 z-[60]">
+            {mode === '3d' && onPreviewRenderModeChange && (
+                <Popover open={previewModeMenuOpen} onOpenChange={setPreviewModeMenuOpen}>
+                    <PopoverTrigger asChild>
+                        <Button
+                            size="icon"
+                            title={`3D preview view: ${previewRenderModeLabel}`}
+                            aria-label={`Choose 3D preview view (currently ${previewRenderModeLabel})`}
+                            data-testid="preview-render-mode-trigger"
+                            className="bg-primary hover:bg-primary/80 text-primary-foreground"
+                        >
+                            <PreviewModeIcon className="w-4 h-4" />
+                        </Button>
+                    </PopoverTrigger>
+                    <PopoverContent align="start" className="w-44 p-1.5">
+                        <div role="radiogroup" aria-label="3D preview view" className="grid gap-1">
+                            {previewModeOptions.map(({ value, label, icon }) => {
+                                const selected = previewRenderMode === value;
+                                return (
+                                    <label
+                                        key={value}
+                                        onClick={() => {
+                                            if (selected) setPreviewModeMenuOpen(false);
+                                        }}
+                                        className={`flex h-9 cursor-pointer items-center gap-2 rounded-sm px-2 text-sm transition-colors focus-within:ring-1 focus-within:ring-ring ${
+                                            selected
+                                                ? 'bg-primary/10 text-primary'
+                                                : 'text-foreground hover:bg-accent'
+                                        }`}
+                                    >
+                                        <input
+                                            type="radio"
+                                            name="preview-render-mode"
+                                            value={value}
+                                            checked={selected}
+                                            onChange={() => {
+                                                onPreviewRenderModeChange(value);
+                                                setPreviewModeMenuOpen(false);
+                                            }}
+                                            className="sr-only"
+                                            data-testid={`preview-render-mode-${value}`}
+                                        />
+                                        {icon}
+                                        <span className="flex-1">{label}</span>
+                                        {selected && <Check className="w-4 h-4" aria-hidden />}
+                                    </label>
+                                );
+                            })}
+                        </div>
+                    </PopoverContent>
+                </Popover>
+            )}
             {mode === '3d' && onToggleCamera && (
                 <Button
                     size="icon"
diff --git a/src/components/ThreeDView.tsx b/src/components/ThreeDView.tsx
index b530081..0757b62 100644
--- a/src/components/ThreeDView.tsx
+++ b/src/components/ThreeDView.tsx
@@ -1,4 +1,4 @@
-import { useEffect, useMemo, useRef, useState } from 'react';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import type { PointerEvent } from 'react';
 import * as THREE from 'three';
 import * as SliderPrimitive from '@radix-ui/react-slider';
@@ -19,6 +19,16 @@ import {
     layeredBuildScanProgress,
     progressInSpan,
 } from '../lib/progress';
+import {
+    applyPreviewRenderMode,
+    createPreviewMaterialBaselines,
+} from '../lib/previewRenderMode';
+import {
+    clearPreviewWireframeOverlay,
+    rebuildPreviewWireframeOverlay as buildPreviewWireframeOverlay,
+    syncPreviewWireframeOverlayVisibility as syncPreviewWireframeVisibility,
+} from '../lib/previewWireframe';
+import type { PreviewRenderMode } from '../types';
 import { Layers } from 'lucide-react';
 import ProgressOverlay from './ProgressOverlay';
 
@@ -47,6 +57,7 @@ interface ThreeDViewProps {
     smoothMeshing?: boolean; // Smooth connected boundaries using welded grid topology
     isOrtho?: boolean;
     flatPaint?: boolean; // Build a flat face-down slab (Flat Paint style, auto-paint only)
+    previewRenderMode?: PreviewRenderMode;
 }
 
 // Convert hex color to RGB tuple
@@ -346,6 +357,7 @@ export default function ThreeDView({
     smoothMeshing = false,
     isOrtho = false,
     flatPaint = false,
+    previewRenderMode = 'shaded',
 }: ThreeDViewProps) {
     const mountRef = useRef<HTMLDivElement | null>(null);
     const [isBuilding, setIsBuilding] = useState(false);
@@ -365,10 +377,111 @@ export default function ThreeDView({
         xPercent: number;
     } | null>(null);
     const previewTrackRef = useRef<HTMLDivElement | null>(null);
-    const { cameraRef, controlsRef, modelGroupRef, materialRef, requestRender, switchCamera } = useThreeScene(
-        mountRef,
-        setIsBuilding
-    );
+    const {
+        sceneRef,
+        cameraRef,
+        controlsRef,
+        modelGroupRef,
+        materialRef,
+        requestRender,
+        switchCamera,
+    } = useThreeScene(mountRef, setIsBuilding);
+    const previewRenderModeRef = useRef(previewRenderMode);
+    const previewMaterialBaselinesRef = useRef(createPreviewMaterialBaselines());
+    const wireframeOverlayRef = useRef<THREE.Group | null>(null);
+    const wireframeBuildGenerationRef = useRef(0);
+    previewRenderModeRef.current = previewRenderMode;
+
+    const clearWireframeOverlay = useCallback(() => {
+        wireframeBuildGenerationRef.current += 1;
+        const overlay = wireframeOverlayRef.current;
+        if (overlay) clearPreviewWireframeOverlay(overlay);
+    }, []);
+
+    const ensureWireframeOverlay = useCallback(() => {
+        const existing = wireframeOverlayRef.current;
+        if (existing) return existing;
+
+        const scene = sceneRef.current;
+        if (!scene) return null;
+
+        const overlay = new THREE.Group();
+        overlay.name = 'KromacutPreviewWireframe';
+        scene.add(overlay);
+        wireframeOverlayRef.current = overlay;
+        return overlay;
+    }, [sceneRef]);
+
+    const syncWireframeOverlayVisibility = useCallback(() => {
+        const overlay = wireframeOverlayRef.current;
+        if (!overlay) return;
+
+        syncPreviewWireframeVisibility(overlay);
+    }, []);
+
+    const rebuildWireframeOverlay = useCallback(async () => {
+        const modelGroup = modelGroupRef.current;
+        const overlay = ensureWireframeOverlay();
+        if (!modelGroup || !overlay) return 'cancelled';
+
+        const generation = wireframeBuildGenerationRef.current + 1;
+        wireframeBuildGenerationRef.current = generation;
+
+        return buildPreviewWireframeOverlay(modelGroup, overlay, {
+            isCurrent: () =>
+                wireframeBuildGenerationRef.current === generation &&
+                previewRenderModeRef.current === 'wireframe',
+            onYield: () => new Promise<void>((resolve) => requestAnimationFrame(() => resolve())),
+            onLayerBuilt: () => {
+                syncPreviewWireframeVisibility(overlay);
+                requestRender();
+            },
+        });
+    }, [ensureWireframeOverlay, modelGroupRef, requestRender]);
+
+    useEffect(() => {
+        return () => {
+            wireframeBuildGenerationRef.current += 1;
+            const overlay = wireframeOverlayRef.current;
+            if (!overlay) return;
+
+            clearPreviewWireframeOverlay(overlay);
+            overlay.parent?.remove(overlay);
+            wireframeOverlayRef.current = null;
+        };
+    }, []);
+
+    useEffect(() => {
+        const modelGroup = modelGroupRef.current;
+        if (!modelGroup) return;
+
+        if (previewRenderMode !== 'wireframe') {
+            clearWireframeOverlay();
+            applyPreviewRenderMode(modelGroup, previewRenderMode, previewMaterialBaselinesRef.current);
+            requestRender();
+            return;
+        }
+
+        applyPreviewRenderMode(modelGroup, 'wireframe', previewMaterialBaselinesRef.current);
+        requestRender();
+
+        let active = true;
+        void rebuildWireframeOverlay().then(() => {
+            if (active) requestRender();
+        });
+
+        return () => {
+            active = false;
+            clearWireframeOverlay();
+        };
+    }, [
+        clearWireframeOverlay,
+        modelGroupRef,
+        previewRenderMode,
+        rebuildWireframeOverlay,
+        requestRender,
+    ]);
+
     useEffect(() => {
         switchCamera(isOrtho);
     }, [isOrtho, switchCamera]);
@@ -419,8 +532,15 @@ export default function ThreeDView({
             }
         });
 
+        syncWireframeOverlayVisibility();
         requestRender();
-    }, [previewHeight, previewMinHeight, modelGroupRef, requestRender]);
+    }, [
+        previewHeight,
+        previewMinHeight,
+        modelGroupRef,
+        requestRender,
+        syncWireframeOverlayVisibility,
+    ]);
 
     const snapPreviewHeight = (value: number): number => {
         const bounded = Math.max(0, Math.min(maxModelHeight, value));
@@ -551,6 +671,7 @@ export default function ThreeDView({
                 window.clearTimeout(debounceTimerRef.current);
                 debounceTimerRef.current = null;
             }
+            clearWireframeOverlay();
             modelGroup.clear();
             clearLastMeshRef();
             setIsBuilding(false);
@@ -569,6 +690,7 @@ export default function ThreeDView({
                 window.clearTimeout(debounceTimerRef.current);
                 debounceTimerRef.current = null;
             }
+            clearWireframeOverlay();
             modelGroup.clear();
             clearLastMeshRef();
             setIsBuilding(false);
@@ -592,6 +714,7 @@ export default function ThreeDView({
                 window.clearTimeout(debounceTimerRef.current);
                 debounceTimerRef.current = null;
             }
+            clearWireframeOverlay();
             modelGroup.clear();
             clearLastMeshRef();
             setIsBuilding(false);
@@ -694,6 +817,7 @@ export default function ThreeDView({
                 const { data } = ctx.getImageData(0, 0, fullW, fullH);
 
                 // Clear current model
+                clearWireframeOverlay();
                 modelGroup.clear();
                 clearLastMeshRef();
 
@@ -1754,6 +1878,35 @@ export default function ThreeDView({
 
                 if (token !== buildTokenRef.current) return;
 
+                const activePreviewRenderMode = previewRenderModeRef.current;
+                if (activePreviewRenderMode === 'wireframe') {
+                    applyPreviewRenderMode(
+                        modelGroup,
+                        'wireframe',
+                        previewMaterialBaselinesRef.current
+                    );
+                    requestRender();
+                    await rebuildWireframeOverlay();
+                    if (token !== buildTokenRef.current) return;
+
+                    const latestPreviewRenderMode = previewRenderModeRef.current;
+                    if (latestPreviewRenderMode !== 'wireframe') {
+                        clearWireframeOverlay();
+                        applyPreviewRenderMode(
+                            modelGroup,
+                            latestPreviewRenderMode,
+                            previewMaterialBaselinesRef.current
+                        );
+                    }
+                } else {
+                    clearWireframeOverlay();
+                    applyPreviewRenderMode(
+                        modelGroup,
+                        activePreviewRenderMode,
+                        previewMaterialBaselinesRef.current
+                    );
+                }
+
                 try {
                     (
                         window as unknown as { __KROMACUT_LAST_MESH?: THREE.Object3D }
@@ -1936,6 +2089,8 @@ export default function ThreeDView({
         materialRef,
         modelGroupRef,
         requestRender,
+        clearWireframeOverlay,
+        rebuildWireframeOverlay,
     ]);
 
     const currentBuildOverlayStep =
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index e6cb25d..16cc946 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -145,6 +145,7 @@ Low confidence usually means you should calibrate filaments, add a missing filam
 
 The toolbar in the top-right corner of the 3D preview contains controls for the active view:
 
+- **Preview view** — choose **Shaded**, **Transparent**, or **Wireframe** to inspect the generated model's surfaces, layers, and edges. Wireframe uses thin, layer-colored feature edges. The selection is remembered and changes only the on-screen preview; it never changes print settings or STL/3MF exports.
 - **Camera toggle** — switches between perspective and orthographic projection. Perspective gives a natural depth effect; orthographic removes foreshortening and is useful for checking layer alignment. The button icon reflects the current mode, and the camera position is preserved when toggling.
 - **Undo / Redo** — steps through changes to the 3D settings.
 - **Download** — exports the current model as a .stl or a .3mf.
diff --git a/src/hooks/useThreeScene.ts b/src/hooks/useThreeScene.ts
index c1afe52..0b6ed2c 100644
--- a/src/hooks/useThreeScene.ts
+++ b/src/hooks/useThreeScene.ts
@@ -1,4 +1,4 @@
-import { useEffect, useRef } from 'react';
+import { useCallback, useEffect, useRef } from 'react';
 import * as THREE from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 
@@ -17,6 +17,11 @@ export function useThreeScene(
 
     const requestRenderRef = useRef<(() => void) | null>(null);
     const switchCameraRef = useRef<((isOrtho: boolean) => void) | null>(null);
+    const requestRender = useCallback(() => requestRenderRef.current?.(), []);
+    const switchCamera = useCallback(
+        (isOrtho: boolean) => switchCameraRef.current?.(isOrtho),
+        []
+    );
 
     useEffect(() => {
         const el = mountRef.current;
@@ -205,8 +210,8 @@ export function useThreeScene(
         controlsRef,
         modelGroupRef,
         materialRef,
-        requestRender: () => requestRenderRef.current?.(),
-        switchCamera: (isOrtho: boolean) => switchCameraRef.current?.(isOrtho),
+        requestRender,
+        switchCamera,
     } as const;
 }
 
diff --git a/src/lib/meshing.ts b/src/lib/meshing.ts
index 2490a01..e5b6449 100644
--- a/src/lib/meshing.ts
+++ b/src/lib/meshing.ts
@@ -50,6 +50,7 @@ type PixelMask = Uint8Array | Uint8ClampedArray | boolean[];
 const SMOOTH_VERTEX_MAX_MOVE = 0.49;
 const SMOOTH_BOUNDARY_ITERATIONS = 10;
 const SMOOTH_BOUNDARY_STRENGTH = 0.75;
+const THREE_MF_COORD_SCALE = 100_000;
 
 function progressInUnitSpan(index: number, count: number, start: number, span: number) {
     const fraction = (Math.max(0, Math.floor(index)) + 1) / Math.max(1, count);
@@ -125,10 +126,257 @@ function meshLabel(mesher: 'greedy' | 'smooth', label: string) {
     return mesher === 'smooth' ? label.replace('mesh', 'smooth mesh') : label;
 }
 
+function triangleArea2(a: Vector2, b: Vector2, c: Vector2) {
+    return (
+        (b.x - a.x) * (c.y - a.y) -
+        (b.y - a.y) * (c.x - a.x)
+    );
+}
+
+function pointInsideTriangle(
+    point: Vector2,
+    a: Vector2,
+    b: Vector2,
+    c: Vector2,
+    areaEpsilon: number
+) {
+    return (
+        triangleArea2(a, b, point) >= -areaEpsilon &&
+        triangleArea2(b, c, point) >= -areaEpsilon &&
+        triangleArea2(c, a, point) >= -areaEpsilon
+    );
+}
+
+function triangulateBoundaryByEarClipping(
+    points: Vector2[],
+    roundedPoints: Vector2[],
+    areaEpsilon: number
+) {
+    const remaining = points.map((_, index) => index);
+    const faces: Array<[number, number, number]> = [];
+
+    while (remaining.length > 3) {
+        let clippedEar = false;
+
+        for (let offset = 0; offset < remaining.length; offset++) {
+            const previous = remaining[(offset - 1 + remaining.length) % remaining.length];
+            const current = remaining[offset];
+            const next = remaining[(offset + 1) % remaining.length];
+            const a = points[previous];
+            const b = points[current];
+            const c = points[next];
+            if (
+                triangleArea2(a, b, c) <= areaEpsilon ||
+                triangleArea2(
+                    roundedPoints[previous],
+                    roundedPoints[current],
+                    roundedPoints[next]
+                ) <= Number.EPSILON
+            ) {
+                continue;
+            }
+
+            let containsBoundaryVertex = false;
+            for (const candidate of remaining) {
+                if (candidate === previous || candidate === current || candidate === next) continue;
+                if (pointInsideTriangle(points[candidate], a, b, c, areaEpsilon)) {
+                    containsBoundaryVertex = true;
+                    break;
+                }
+            }
+            if (containsBoundaryVertex) continue;
+
+            if (remaining.length === 4) {
+                const finalTriangle = remaining.filter((_, index) => index !== offset);
+                if (
+                    triangleArea2(
+                        points[finalTriangle[0]],
+                        points[finalTriangle[1]],
+                        points[finalTriangle[2]]
+                    ) <= areaEpsilon ||
+                    triangleArea2(
+                        roundedPoints[finalTriangle[0]],
+                        roundedPoints[finalTriangle[1]],
+                        roundedPoints[finalTriangle[2]]
+                    ) <= Number.EPSILON
+                ) {
+                    continue;
+                }
+            }
+
+            faces.push([previous, current, next]);
+            remaining.splice(offset, 1);
+            clippedEar = true;
+            break;
+        }
+
+        if (!clippedEar) return null;
+    }
+
+    if (
+        remaining.length !== 3 ||
+        triangleArea2(points[remaining[0]], points[remaining[1]], points[remaining[2]]) <=
+            areaEpsilon ||
+        triangleArea2(
+            roundedPoints[remaining[0]],
+            roundedPoints[remaining[1]],
+            roundedPoints[remaining[2]]
+        ) <= Number.EPSILON
+    ) {
+        return null;
+    }
+
+    faces.push([remaining[0], remaining[1], remaining[2]]);
+    return faces;
+}
+
+/**
+ * Earcut may omit collinear boundary vertices. Restore those vertices so cap
+ * edges still pair exactly with wall edges, then validate both mesh and slicer precision.
+ */
+function triangulateBoundaryPreservingVertices(
+    points: Vector2[],
+    roundedPoints: Vector2[],
+    areaEpsilon: number
+) {
+    const fastFaces = ShapeUtils.triangulateShape(roundedPoints, []).map(
+        ([a, b, c]) => [a, b, c] as [number, number, number]
+    );
+    const boundaryEdgeKeys = new Set<string>();
+    const edgeKey = (a: number, b: number) => (a < b ? `${a}|${b}` : `${b}|${a}`);
+    for (let index = 0; index < points.length; index++) {
+        boundaryEdgeKeys.add(edgeKey(index, (index + 1) % points.length));
+    }
+    const triangulateFallback = () =>
+        triangulateBoundaryByEarClipping(points, roundedPoints, areaEpsilon);
+
+    const findBoundaryChain = (start: number, end: number) => {
+        const a = roundedPoints[start];
+        const b = roundedPoints[end];
+        const segmentX = b.x - a.x;
+        const segmentY = b.y - a.y;
+        const segmentLengthSquared = segmentX * segmentX + segmentY * segmentY;
+        const collinearEpsilon = Math.max(areaEpsilon * 16, Number.EPSILON);
+
+        const collect = (step: 1 | -1) => {
+            const chain = [start];
+            let cursor = start;
+            for (let guard = 0; guard < points.length; guard++) {
+                cursor = (cursor + step + points.length) % points.length;
+                chain.push(cursor);
+                if (cursor === end) break;
+            }
+            if (chain[chain.length - 1] !== end || chain.length <= 2) return null;
+
+            let previousProjection = -Infinity;
+            for (const vertex of chain) {
+                const point = roundedPoints[vertex];
+                if (Math.abs(triangleArea2(a, point, b)) > collinearEpsilon) return null;
+                const projection =
+                    (point.x - a.x) * segmentX + (point.y - a.y) * segmentY;
+                if (
+                    projection < previousProjection - collinearEpsilon ||
+                    projection < -collinearEpsilon ||
+                    projection > segmentLengthSquared + collinearEpsilon
+                ) {
+                    return null;
+                }
+                previousProjection = projection;
+            }
+            return chain;
+        };
+
+        return collect(1) ?? collect(-1);
+    };
+
+    const edgeUses = new Map<string, { count: number; start: number; end: number }>();
+    for (const face of fastFaces) {
+        for (let offset = 0; offset < 3; offset++) {
+            const start = face[offset];
+            const end = face[(offset + 1) % 3];
+            const key = edgeKey(start, end);
+            const use = edgeUses.get(key);
+            if (use) use.count++;
+            else edgeUses.set(key, { count: 1, start, end });
+        }
+    }
+
+    const faces = fastFaces.slice();
+    for (const use of edgeUses.values()) {
+        if (use.count !== 1) continue;
+        if (boundaryEdgeKeys.has(edgeKey(use.start, use.end))) continue;
+        const chain = findBoundaryChain(use.start, use.end);
+        if (!chain) continue;
+
+        let targetFaceIndex = -1;
+        let targetEdgeOffset = -1;
+        let directedChain = chain;
+        for (let faceIndex = 0; faceIndex < faces.length && targetFaceIndex < 0; faceIndex++) {
+            const face = faces[faceIndex];
+            for (let offset = 0; offset < 3; offset++) {
+                const start = face[offset];
+                const end = face[(offset + 1) % 3];
+                if (start === use.start && end === use.end) {
+                    targetFaceIndex = faceIndex;
+                    targetEdgeOffset = offset;
+                    break;
+                }
+                if (start === use.end && end === use.start) {
+                    targetFaceIndex = faceIndex;
+                    targetEdgeOffset = offset;
+                    directedChain = chain.slice().reverse();
+                    break;
+                }
+            }
+        }
+        if (targetFaceIndex < 0) {
+            return triangulateFallback();
+        }
+
+        const targetFace = faces[targetFaceIndex];
+        const opposite = targetFace[(targetEdgeOffset + 2) % 3];
+        const replacements: Array<[number, number, number]> = [];
+        for (let index = 0; index + 1 < directedChain.length; index++) {
+            replacements.push([directedChain[index], directedChain[index + 1], opposite]);
+        }
+        faces.splice(targetFaceIndex, 1, ...replacements);
+    }
+
+    const finalEdgeCounts = new Map<string, number>();
+    for (const [a, b, c] of faces) {
+        if (
+            triangleArea2(points[a], points[b], points[c]) <= areaEpsilon ||
+            triangleArea2(roundedPoints[a], roundedPoints[b], roundedPoints[c]) <= Number.EPSILON
+        ) {
+            return triangulateFallback();
+        }
+        for (const [start, end] of [
+            [a, b],
+            [b, c],
+            [c, a],
+        ]) {
+            const key = edgeKey(start, end);
+            finalEdgeCounts.set(key, (finalEdgeCounts.get(key) ?? 0) + 1);
+        }
+    }
+    for (const [key, count] of finalEdgeCounts) {
+        if (count !== (boundaryEdgeKeys.has(key) ? 1 : 2)) {
+            return triangulateFallback();
+        }
+    }
+    for (const key of boundaryEdgeKeys) {
+        if (finalEdgeCounts.get(key) !== 1) {
+            return triangulateFallback();
+        }
+    }
+
+    return faces;
+}
+
 /**
  * Smooth meshing uses the same welded topology as greedy meshing, then moves only
- * shared boundary grid vertices inward at corners. That keeps runtime linear in
- * the grid scan and avoids contour triangulation stalls on dither-heavy images.
+ * shared boundary grid vertices inward at corners. This avoids tracing whole-mask
+ * contours; each welded rectangle cap is triangulated independently below.
  */
 function createGridVertexMapper(
     meshingPixels: PixelMask,
@@ -325,12 +573,6 @@ async function generateGridMesh(
         indices.push(v0, v1, v2);
         indices.push(v0, v2, v3);
     };
-    const addLooseVertex = (x: number, y: number, isTop: boolean) => {
-        const idx = vertCount++;
-        positions.push(x * pixelSize, y * pixelSize, isTop ? zTop : zBottom);
-        return idx;
-    };
-
     const rectangles: Rect[] = [];
     const visited = new Uint8Array(width * height);
     reportProgress({
@@ -492,25 +734,39 @@ async function generateGridMesh(
             bottomLoop[i] = getOrAddVertex(vx, vy, false);
         }
 
-        if (options.smoothBoundary) {
-            const centerX = x + w / 2;
-            const centerY = y + h / 2;
-            const topCenter = addLooseVertex(centerX, centerY, true);
-            const bottomCenter = addLooseVertex(centerX, centerY, false);
+        const facePoints = boundary.map(([vx, vy]) => {
+            if (!options.smoothBoundary) return new Vector2(vx, vy);
 
-            for (let i = 0; i < boundary.length; i++) {
-                const next = (i + 1) % boundary.length;
-                indices.push(topCenter, topLoop[i], topLoop[next]);
-                indices.push(bottomCenter, bottomLoop[next], bottomLoop[i]);
-            }
-        } else {
-            const facePoints = boundary.map(([vx, vy]) => new Vector2(vx, vy));
-            const faces = ShapeUtils.triangulateShape(facePoints, []);
+            const [mappedX, mappedY] = getGridVertexXY(vx, vy);
+            return new Vector2(
+                Math.fround(mappedX * pixelSize),
+                Math.fround(mappedY * pixelSize)
+            );
+        });
+        const roundedFacePoints = options.smoothBoundary
+            ? facePoints.map(
+                  (point) =>
+                      new Vector2(
+                          Math.round(point.x * THREE_MF_COORD_SCALE) / THREE_MF_COORD_SCALE,
+                          Math.round(point.y * THREE_MF_COORD_SCALE) / THREE_MF_COORD_SCALE
+                      )
+              )
+            : facePoints;
+        const capAreaEpsilon = Math.max(Number.EPSILON, 1e-8 * pixelSize * pixelSize);
+        const faces = options.smoothBoundary
+            ? triangulateBoundaryPreservingVertices(
+                  facePoints,
+                  roundedFacePoints,
+                  capAreaEpsilon
+              )
+            : ShapeUtils.triangulateShape(facePoints, []);
+        if (!faces) {
+            throw new Error('Unable to triangulate a smoothed cap without breaking topology');
+        }
 
-            for (const [a, b, c] of faces) {
-                indices.push(topLoop[a], topLoop[b], topLoop[c]);
-                indices.push(bottomLoop[a], bottomLoop[c], bottomLoop[b]);
-            }
+        for (const [a, b, c] of faces) {
+            indices.push(topLoop[a], topLoop[b], topLoop[c]);
+            indices.push(bottomLoop[a], bottomLoop[c], bottomLoop[b]);
         }
 
         await maybeYield();
diff --git a/src/lib/previewPrefs.ts b/src/lib/previewPrefs.ts
new file mode 100644
index 0000000..f8d6c8b
--- /dev/null
+++ b/src/lib/previewPrefs.ts
@@ -0,0 +1,24 @@
+import type { PreviewRenderMode } from '../types';
+
+export const PREVIEW_RENDER_MODE_STORAGE_KEY = 'kromacut:3d-preview-mode';
+
+export function isPreviewRenderMode(value: unknown): value is PreviewRenderMode {
+    return value === 'shaded' || value === 'transparent' || value === 'wireframe';
+}
+
+export function loadPreviewRenderMode(): PreviewRenderMode {
+    try {
+        const stored = localStorage.getItem(PREVIEW_RENDER_MODE_STORAGE_KEY);
+        return isPreviewRenderMode(stored) ? stored : 'shaded';
+    } catch {
+        return 'shaded';
+    }
+}
+
+export function savePreviewRenderMode(mode: PreviewRenderMode): void {
+    try {
+        localStorage.setItem(PREVIEW_RENDER_MODE_STORAGE_KEY, mode);
+    } catch {
+        // The in-memory preview state remains usable when storage is unavailable.
+    }
+}
diff --git a/src/lib/previewRenderMode.ts b/src/lib/previewRenderMode.ts
new file mode 100644
index 0000000..ad2ee85
--- /dev/null
+++ b/src/lib/previewRenderMode.ts
@@ -0,0 +1,189 @@
+import * as THREE from 'three';
+import type { PreviewRenderMode } from '../types';
+
+export const TRANSPARENT_PREVIEW_OPACITY = 0.28;
+
+type PreviewMaterial = THREE.Material & {
+    transparent: boolean;
+    opacity: number;
+    depthWrite: boolean;
+    depthTest: boolean;
+    colorWrite: boolean;
+    side: THREE.Side;
+    wireframe: boolean;
+};
+
+interface PreviewMaterialBaseline {
+    transparent: boolean;
+    opacity: number;
+    depthWrite: boolean;
+    depthTest: boolean;
+    colorWrite: boolean;
+    side: THREE.Side;
+    wireframe: boolean;
+}
+
+interface PreviewMeshBaseline {
+    renderOrder: number;
+}
+
+export interface PreviewMaterialBaselines {
+    materials: WeakMap<THREE.Material, PreviewMaterialBaseline>;
+    meshes: WeakMap<THREE.Mesh, PreviewMeshBaseline>;
+}
+
+function isPreviewMaterial(material: THREE.Material): material is PreviewMaterial {
+    return 'wireframe' in material && 'colorWrite' in material;
+}
+
+function readBaseline(material: PreviewMaterial): PreviewMaterialBaseline {
+    const baseline: PreviewMaterialBaseline = {
+        transparent: material.transparent,
+        opacity: material.opacity,
+        depthWrite: material.depthWrite,
+        depthTest: material.depthTest,
+        colorWrite: material.colorWrite,
+        side: material.side,
+        wireframe: material.wireframe,
+    };
+    return baseline;
+}
+
+function renderStateForMode(
+    mode: PreviewRenderMode,
+    baseline: PreviewMaterialBaseline
+): PreviewMaterialBaseline {
+    switch (mode) {
+        case 'transparent':
+            return {
+                ...baseline,
+                transparent: true,
+                opacity: TRANSPARENT_PREVIEW_OPACITY,
+                depthWrite: false,
+                depthTest: false,
+                colorWrite: true,
+                side: THREE.DoubleSide,
+                wireframe: false,
+            };
+        case 'wireframe':
+            return {
+                ...baseline,
+                transparent: false,
+                opacity: 1,
+                depthWrite: false,
+                depthTest: false,
+                colorWrite: false,
+                side: THREE.DoubleSide,
+                wireframe: false,
+            };
+        case 'shaded':
+            return baseline;
+    }
+}
+
+function applyRenderState(
+    material: PreviewMaterial,
+    next: PreviewMaterialBaseline
+): boolean {
+    const changed =
+        material.transparent !== next.transparent ||
+        material.opacity !== next.opacity ||
+        material.depthWrite !== next.depthWrite ||
+        material.depthTest !== next.depthTest ||
+        material.colorWrite !== next.colorWrite ||
+        material.side !== next.side ||
+        material.wireframe !== next.wireframe;
+
+    if (!changed) return false;
+
+    material.transparent = next.transparent;
+    material.opacity = next.opacity;
+    material.depthWrite = next.depthWrite;
+    material.depthTest = next.depthTest;
+    material.colorWrite = next.colorWrite;
+    material.side = next.side;
+    material.wireframe = next.wireframe;
+    material.needsUpdate = true;
+    return true;
+}
+
+function applyMeshRenderOrder(
+    mesh: THREE.Mesh,
+    mode: PreviewRenderMode,
+    baselines: PreviewMaterialBaselines,
+    inspectionOrder: number
+): boolean {
+    let baseline = baselines.meshes.get(mesh);
+    if (!baseline) {
+        baseline = { renderOrder: mesh.renderOrder };
+        baselines.meshes.set(mesh, baseline);
+    }
+
+    const nextRenderOrder = mode === 'shaded' ? baseline.renderOrder : 1000 + inspectionOrder;
+    if (mesh.renderOrder === nextRenderOrder) return false;
+
+    mesh.renderOrder = nextRenderOrder;
+    return true;
+}
+
+export function createPreviewMaterialBaselines(): PreviewMaterialBaselines {
+    return {
+        materials: new WeakMap(),
+        meshes: new WeakMap(),
+    };
+}
+
+/**
+ * Applies an inspection-only rendering style to preview materials. Geometry,
+ * visibility, colors, and export metadata are deliberately left untouched.
+ */
+export function applyPreviewRenderMode(
+    root: THREE.Object3D,
+    mode: PreviewRenderMode,
+    baselines: PreviewMaterialBaselines
+): boolean {
+    let changed = false;
+    const meshes: Array<{ mesh: THREE.Mesh; baseZ: number; traversalIndex: number }> = [];
+
+    root.traverse((child) => {
+        if (!(child as THREE.Mesh).isMesh) return;
+
+        const mesh = child as THREE.Mesh;
+        meshes.push({
+            mesh,
+            baseZ: Number(mesh.userData.baseZ),
+            traversalIndex: meshes.length,
+        });
+    });
+
+    meshes.sort((left, right) => {
+        const leftHasBaseZ = Number.isFinite(left.baseZ);
+        const rightHasBaseZ = Number.isFinite(right.baseZ);
+        if (leftHasBaseZ && rightHasBaseZ && left.baseZ !== right.baseZ) {
+            return left.baseZ - right.baseZ;
+        }
+        if (leftHasBaseZ !== rightHasBaseZ) return leftHasBaseZ ? -1 : 1;
+        return left.traversalIndex - right.traversalIndex;
+    });
+
+    for (let inspectionOrder = 0; inspectionOrder < meshes.length; inspectionOrder++) {
+        const { mesh } = meshes[inspectionOrder];
+        changed = applyMeshRenderOrder(mesh, mode, baselines, inspectionOrder) || changed;
+
+        const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        for (const material of materials) {
+            if (!isPreviewMaterial(material)) continue;
+
+            let baseline = baselines.materials.get(material);
+            if (!baseline) {
+                baseline = readBaseline(material);
+                baselines.materials.set(material, baseline);
+            }
+
+            changed =
+                applyRenderState(material, renderStateForMode(mode, baseline)) || changed;
+        }
+    }
+
+    return changed;
+}
diff --git a/src/lib/previewWireframe.ts b/src/lib/previewWireframe.ts
new file mode 100644
index 0000000..5ce25f1
--- /dev/null
+++ b/src/lib/previewWireframe.ts
@@ -0,0 +1,317 @@
+import * as THREE from 'three';
+
+const FALLBACK_WIREFRAME_COLOR = 0xffffff;
+const FEATURE_EDGE_THRESHOLD_DEGREES = 15;
+const FEATURE_EDGE_THRESHOLD_DOT = Math.cos(
+    THREE.MathUtils.DEG2RAD * FEATURE_EDGE_THRESHOLD_DEGREES
+);
+// Match THREE.EdgesGeometry so split face vertices share one logical edge.
+const VERTEX_WELD_PRECISION = 10_000;
+const DEFAULT_YIELD_INTERVAL_MS = 8;
+const WIRE_SOURCE_MESH_KEY = 'kromacutPreviewSourceMesh';
+
+export type PreviewWireframeStyle = 'overlay' | 'empty' | 'cancelled';
+
+export interface PreviewWireframeBuildOptions {
+    /** Stops stale work after a mode change, rebuild, or unmount. */
+    isCurrent?: () => boolean;
+    /** Gives the browser a frame between long feature-edge scans. */
+    onYield?: () => Promise<void>;
+    /** Lets the caller render completed layers progressively. */
+    onLayerBuilt?: () => void;
+    yieldIntervalMs?: number;
+}
+
+interface PendingEdge {
+    index0: number;
+    index1: number;
+    normalX: number;
+    normalY: number;
+    normalZ: number;
+}
+
+interface OrderedMesh {
+    mesh: THREE.Mesh;
+    baseZ: number;
+    traversalIndex: number;
+}
+
+type ColorMaterial = THREE.Material & { color: THREE.Color };
+
+function isColorMaterial(material: THREE.Material): material is ColorMaterial {
+    return 'color' in material && material.color instanceof THREE.Color;
+}
+
+function wireframeColorForMesh(mesh: THREE.Mesh): THREE.Color {
+    const material = Array.isArray(mesh.material) ? mesh.material[0] : mesh.material;
+    return isColorMaterial(material)
+        ? material.color.clone()
+        : new THREE.Color(FALLBACK_WIREFRAME_COLOR);
+}
+
+function collectMeshes(modelGroup: THREE.Object3D): THREE.Mesh[] {
+    const meshes: OrderedMesh[] = [];
+    modelGroup.traverse((child) => {
+        if (!(child as THREE.Mesh).isMesh) return;
+
+        const mesh = child as THREE.Mesh;
+        meshes.push({
+            mesh,
+            baseZ: Number(mesh.userData.baseZ),
+            traversalIndex: meshes.length,
+        });
+    });
+
+    meshes.sort((left, right) => {
+        const leftHasBaseZ = Number.isFinite(left.baseZ);
+        const rightHasBaseZ = Number.isFinite(right.baseZ);
+        if (leftHasBaseZ && rightHasBaseZ && left.baseZ !== right.baseZ) {
+            return left.baseZ - right.baseZ;
+        }
+        if (leftHasBaseZ !== rightHasBaseZ) return leftHasBaseZ ? -1 : 1;
+        return left.traversalIndex - right.traversalIndex;
+    });
+
+    return meshes.map(({ mesh }) => mesh);
+}
+
+function appendSegment(
+    vertices: number[],
+    position: THREE.BufferAttribute | THREE.InterleavedBufferAttribute,
+    index0: number,
+    index1: number
+): void {
+    vertices.push(
+        position.getX(index0),
+        position.getY(index0),
+        position.getZ(index0),
+        position.getX(index1),
+        position.getY(index1),
+        position.getZ(index1)
+    );
+}
+
+function isBuildCurrent(options: PreviewWireframeBuildOptions): boolean {
+    return options.isCurrent?.() ?? true;
+}
+
+/**
+ * Builds Three-style hard and boundary edges, yielding inside the scan so
+ * large preview models remain interactive.
+ */
+async function createFeatureEdgeGeometry(
+    geometry: THREE.BufferGeometry,
+    options: PreviewWireframeBuildOptions
+): Promise<THREE.BufferGeometry | 'cancelled' | null> {
+    const position = geometry.getAttribute('position');
+    if (!position || position.itemSize < 3) return null;
+
+    const index = geometry.getIndex();
+    const indexCount = index ? index.count : position.count;
+    const edgeKeyStride = position.count + 1;
+    const edgeData = new Map<number, PendingEdge>();
+    const canonicalIdByPosition = new Map<string, number>();
+    const canonicalVertexIds = new Int32Array(position.count);
+    canonicalVertexIds.fill(-1);
+    const vertices: number[] = [];
+    const yieldIntervalMs = options.yieldIntervalMs ?? DEFAULT_YIELD_INTERVAL_MS;
+    let lastYieldAt = performance.now();
+    let nextCanonicalId = 0;
+
+    const canonicalVertexId = (sourceIndex: number) => {
+        const cachedId = canonicalVertexIds[sourceIndex];
+        if (cachedId >= 0) return cachedId;
+
+        const x = Math.round(position.getX(sourceIndex) * VERTEX_WELD_PRECISION);
+        const y = Math.round(position.getY(sourceIndex) * VERTEX_WELD_PRECISION);
+        const z = Math.round(position.getZ(sourceIndex) * VERTEX_WELD_PRECISION);
+        const positionKey = `${x},${y},${z}`;
+        const existingId = canonicalIdByPosition.get(positionKey);
+        const canonicalId = existingId ?? nextCanonicalId++;
+        if (existingId === undefined) canonicalIdByPosition.set(positionKey, canonicalId);
+        canonicalVertexIds[sourceIndex] = canonicalId;
+        return canonicalId;
+    };
+
+    const registerEdge = (
+        edgeStart: number,
+        edgeEnd: number,
+        normalX: number,
+        normalY: number,
+        normalZ: number
+    ) => {
+        const canonicalStart = canonicalVertexId(edgeStart);
+        const canonicalEnd = canonicalVertexId(edgeEnd);
+        if (canonicalStart === canonicalEnd) return;
+
+        const edgeKey = canonicalStart * edgeKeyStride + canonicalEnd;
+        const reverseKey = canonicalEnd * edgeKeyStride + canonicalStart;
+        const sibling = edgeData.get(reverseKey);
+
+        if (sibling) {
+            const normalDot =
+                normalX * sibling.normalX +
+                normalY * sibling.normalY +
+                normalZ * sibling.normalZ;
+            if (normalDot <= FEATURE_EDGE_THRESHOLD_DOT) {
+                appendSegment(vertices, position, edgeStart, edgeEnd);
+            }
+            edgeData.delete(reverseKey);
+        } else if (!edgeData.has(edgeKey)) {
+            edgeData.set(edgeKey, {
+                index0: edgeStart,
+                index1: edgeEnd,
+                normalX,
+                normalY,
+                normalZ,
+            });
+        }
+    };
+
+    const yieldIfNeeded = async () => {
+        if (performance.now() - lastYieldAt < yieldIntervalMs) return true;
+        await options.onYield?.();
+        lastYieldAt = performance.now();
+        return isBuildCurrent(options);
+    };
+
+    for (let triangleOffset = 0; triangleOffset + 2 < indexCount; triangleOffset += 3) {
+        if (!isBuildCurrent(options)) return 'cancelled';
+
+        const index0 = index ? index.getX(triangleOffset) : triangleOffset;
+        const index1 = index ? index.getX(triangleOffset + 1) : triangleOffset + 1;
+        const index2 = index ? index.getX(triangleOffset + 2) : triangleOffset + 2;
+        const ax = position.getX(index0);
+        const ay = position.getY(index0);
+        const az = position.getZ(index0);
+        const bx = position.getX(index1);
+        const by = position.getY(index1);
+        const bz = position.getZ(index1);
+        const cx = position.getX(index2);
+        const cy = position.getY(index2);
+        const cz = position.getZ(index2);
+        const abx = bx - ax;
+        const aby = by - ay;
+        const abz = bz - az;
+        const acx = cx - ax;
+        const acy = cy - ay;
+        const acz = cz - az;
+        let normalX = aby * acz - abz * acy;
+        let normalY = abz * acx - abx * acz;
+        let normalZ = abx * acy - aby * acx;
+        const normalLength = Math.hypot(normalX, normalY, normalZ);
+
+        if (normalLength > Number.EPSILON) {
+            normalX /= normalLength;
+            normalY /= normalLength;
+            normalZ /= normalLength;
+            registerEdge(index0, index1, normalX, normalY, normalZ);
+            registerEdge(index1, index2, normalX, normalY, normalZ);
+            registerEdge(index2, index0, normalX, normalY, normalZ);
+        }
+
+        if ((triangleOffset / 3 + 1) % 512 === 0 && !(await yieldIfNeeded())) {
+            return 'cancelled';
+        }
+    }
+
+    let pendingCount = 0;
+    for (const edge of edgeData.values()) {
+        appendSegment(vertices, position, edge.index0, edge.index1);
+
+        pendingCount++;
+        if (pendingCount % 512 === 0 && !(await yieldIfNeeded())) return 'cancelled';
+    }
+
+    if (!isBuildCurrent(options)) return 'cancelled';
+    if (vertices.length === 0) return null;
+
+    const edgeGeometry = new THREE.BufferGeometry();
+    edgeGeometry.setAttribute('position', new THREE.Float32BufferAttribute(vertices, 3));
+    return edgeGeometry;
+}
+
+export function clearPreviewWireframeOverlay(overlay: THREE.Group): void {
+    for (const child of overlay.children) {
+        if (!(child as THREE.LineSegments).isLineSegments) continue;
+
+        const lines = child as THREE.LineSegments;
+        lines.geometry.dispose();
+        const materials = Array.isArray(lines.material) ? lines.material : [lines.material];
+        for (const material of materials) material.dispose();
+    }
+    overlay.clear();
+}
+
+function clearOwnedWireframeLines(
+    overlay: THREE.Group,
+    linesBuiltByThisRun: THREE.LineSegments[]
+): void {
+    for (const lines of linesBuiltByThisRun) {
+        if (lines.parent !== overlay) continue;
+        overlay.remove(lines);
+        lines.geometry.dispose();
+        const materials = Array.isArray(lines.material) ? lines.material : [lines.material];
+        for (const material of materials) material.dispose();
+    }
+}
+
+/**
+ * Builds thin, unlit, per-layer feature edges in a scene-only overlay. The
+ * source meshes retain their real layer colors and are never changed for export.
+ */
+export async function rebuildPreviewWireframeOverlay(
+    modelGroup: THREE.Object3D,
+    overlay: THREE.Group,
+    options: PreviewWireframeBuildOptions = {}
+): Promise<PreviewWireframeStyle> {
+    clearPreviewWireframeOverlay(overlay);
+    const meshes = collectMeshes(modelGroup);
+    modelGroup.updateMatrixWorld(true);
+    const linesBuiltByThisRun: THREE.LineSegments[] = [];
+    let layerIndex = 0;
+
+    for (const mesh of meshes) {
+        if (!isBuildCurrent(options)) {
+            clearOwnedWireframeLines(overlay, linesBuiltByThisRun);
+            return 'cancelled';
+        }
+
+        const geometry = await createFeatureEdgeGeometry(mesh.geometry, options);
+        if (geometry === 'cancelled' || !isBuildCurrent(options)) {
+            if (geometry instanceof THREE.BufferGeometry) geometry.dispose();
+            clearOwnedWireframeLines(overlay, linesBuiltByThisRun);
+            return 'cancelled';
+        }
+        if (!geometry) continue;
+
+        const material = new THREE.LineBasicMaterial({
+            color: wireframeColorForMesh(mesh),
+            transparent: true,
+            opacity: 0.95,
+            depthTest: false,
+            depthWrite: false,
+            linewidth: 1,
+            toneMapped: false,
+        });
+        const lines = new THREE.LineSegments(geometry, material);
+        lines.matrixAutoUpdate = false;
+        lines.matrix.copy(mesh.matrixWorld);
+        lines.matrixWorldNeedsUpdate = true;
+        lines.visible = mesh.visible;
+        lines.renderOrder = 2000 + layerIndex++;
+        lines.userData[WIRE_SOURCE_MESH_KEY] = mesh;
+        overlay.add(lines);
+        linesBuiltByThisRun.push(lines);
+        options.onLayerBuilt?.();
+    }
+
+    return layerIndex > 0 ? 'overlay' : 'empty';
+}
+
+export function syncPreviewWireframeOverlayVisibility(overlay: THREE.Group): void {
+    for (const child of overlay.children) {
+        const sourceMesh = child.userData[WIRE_SOURCE_MESH_KEY] as THREE.Mesh | undefined;
+        if (sourceMesh?.isMesh) child.visible = sourceMesh.visible;
+    }
+}
diff --git a/src/types/index.ts b/src/types/index.ts
index ce31f97..3bf2378 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -7,6 +7,9 @@ export type AutoPaintRepeatLimit = (typeof AUTO_PAINT_REPEAT_LIMITS)[number];
 export const AUTO_PAINT_TRANSITION_OPACITIES = [0.8, 0.9, 0.95] as const;
 export type AutoPaintTransitionOpacity = (typeof AUTO_PAINT_TRANSITION_OPACITIES)[number];
 
+/** Visual inspection style for the 3D preview. Never changes the printable model. */
+export type PreviewRenderMode = 'shaded' | 'transparent' | 'wireframe';
+
 export type Swatch = {
     hex: string;
     a: number;
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index 0a24f02..330412e 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -21,6 +21,7 @@ import { inspectMeshIntegrity, type MeshIntegrityReport } from './meshDiagnostic
 
 type Export3mfModule = typeof import('../src/lib/export3mf.ts');
 type Export3MFOptions = Parameters<Export3mfModule['exportObjectTo3MFBlob']>[1];
+type PreviewRenderModeModule = typeof import('../src/lib/previewRenderMode.ts');
 type MeshGenerator = typeof generateSmoothMesh;
 type OptimizerAlgorithm = 'fast' | 'balanced' | 'thorough';
 
@@ -101,6 +102,7 @@ interface FilamentProfileFixture {
 }
 
 let export3mfModule: Promise<Export3mfModule> | null = null;
+let previewRenderModeModule: Promise<PreviewRenderModeModule> | null = null;
 let autoPaintModule: Promise<AutoPaintModule> | null = null;
 const filamentProfilesRoot = resolve(testAssetsRoot, 'filament-profiles');
 
@@ -237,6 +239,14 @@ async function loadExport3mfModule(): Promise<Export3mfModule> {
     return export3mfModule;
 }
 
+async function loadPreviewRenderModeModule(): Promise<PreviewRenderModeModule> {
+    previewRenderModeModule ??= loadViteModule<PreviewRenderModeModule>(
+        '/src/lib/previewRenderMode.ts'
+    );
+
+    return previewRenderModeModule;
+}
+
 async function loadAutoPaintModule(): Promise<AutoPaintModule> {
     autoPaintModule ??= loadViteModule<AutoPaintModule>('/src/lib/autoPaint.ts');
 
@@ -1409,6 +1419,42 @@ test('3MF export keeps generated meshes as separate layer objects', async () =>
     );
 });
 
+test('preview inspection modes leave STL and 3MF export data unchanged', async () => {
+    const { applyPreviewRenderMode, createPreviewMaterialBaselines } =
+        await loadPreviewRenderModeModule();
+    const root = new THREE.Group();
+    root.add(createLayerMesh(createSharedCubeGeometry(), 0x2266aa));
+    const carrier = createLayerMesh(createSharedCubeGeometry(), 0xeeddcc);
+    carrier.position.z = 1;
+    root.add(carrier);
+
+    const snapshot = async () => {
+        const archive = await exportArchiveXml(root);
+        const meshObjects = parseMeshObjects(archive.modelXml);
+        const stl = await parseSingleBinaryStlMesh(await exportObjectToStlBlob(root));
+        return {
+            materialColors: parseBaseMaterialColors(archive.modelXml),
+            objectCount: meshObjects.length,
+            objectTriangleCounts: meshObjects.map((object) => object.triangleCount),
+            stlTriangleCount: stl.triangleCount,
+        };
+    };
+
+    const expected = await snapshot();
+    const baselines = createPreviewMaterialBaselines();
+
+    const previewModes = [
+        { label: 'transparent', mode: 'transparent' },
+        { label: 'wireframe overlay', mode: 'wireframe' },
+        { label: 'shaded', mode: 'shaded' },
+    ] as const;
+
+    for (const { label, mode } of previewModes) {
+        applyPreviewRenderMode(root, mode, baselines);
+        assert.deepEqual(await snapshot(), expected, `${label} must remain preview-only`);
+    }
+});
+
 test('3MF export streams generated model XML without FileReader', async () => {
     const { exportObjectTo3MFBlob } = await loadExport3mfModule();
     const previousFileReader = globalThis.FileReader;
diff --git a/tests/meshing.test.ts b/tests/meshing.test.ts
index 08f188d..9b9eef5 100644
--- a/tests/meshing.test.ts
+++ b/tests/meshing.test.ts
@@ -68,12 +68,55 @@ function reportForMessage(report: MeshIntegrityReport) {
     );
 }
 
+function inspectCapWinding(mesh: MeshData) {
+    let minZ = Infinity;
+    let maxZ = -Infinity;
+    for (let offset = 2; offset < mesh.positions.length; offset += 3) {
+        minZ = Math.min(minZ, mesh.positions[offset]);
+        maxZ = Math.max(maxZ, mesh.positions[offset]);
+    }
+
+    let reversedTopCount = 0;
+    let reversedBottomCount = 0;
+    for (let offset = 0; offset + 2 < mesh.indices.length; offset += 3) {
+        const a = mesh.indices[offset] * 3;
+        const b = mesh.indices[offset + 1] * 3;
+        const c = mesh.indices[offset + 2] * 3;
+        const za = mesh.positions[a + 2];
+        const zb = mesh.positions[b + 2];
+        const zc = mesh.positions[c + 2];
+        const area2 =
+            (mesh.positions[b] - mesh.positions[a]) *
+                (mesh.positions[c + 1] - mesh.positions[a + 1]) -
+            (mesh.positions[b + 1] - mesh.positions[a + 1]) *
+                (mesh.positions[c] - mesh.positions[a]);
+        const isTop =
+            Math.abs(za - maxZ) <= 1e-7 &&
+            Math.abs(zb - maxZ) <= 1e-7 &&
+            Math.abs(zc - maxZ) <= 1e-7;
+        const isBottom =
+            Math.abs(za - minZ) <= 1e-7 &&
+            Math.abs(zb - minZ) <= 1e-7 &&
+            Math.abs(zc - minZ) <= 1e-7;
+
+        if (isTop && area2 < -1e-10) reversedTopCount++;
+        if (isBottom && area2 > 1e-10) reversedBottomCount++;
+    }
+
+    return { reversedTopCount, reversedBottomCount };
+}
+
 function assertHealthyMesh(label: string, mesh: MeshData) {
     const report = inspectMeshIntegrity(mesh);
+    const capWinding = inspectCapWinding(mesh);
 
     assert.ok(report.vertexCount > 0, `${label} should contain vertices`);
     assert.ok(report.triangleCount > 0, `${label} should contain triangles`);
     assert.equal(report.isValid, true, `${label} integrity failed:\n${reportForMessage(report)}`);
+    assert.deepEqual(capWinding, {
+        reversedTopCount: 0,
+        reversedBottomCount: 0,
+    });
 
     return report;
 }
@@ -475,6 +518,53 @@ test('smooth caps stay inside the bounded smoothing envelope', async () => {
     assert.equal(countCapCentroidsOutsideExpandedMask(mesh, mask, 0.4, 0.5), 0);
 });
 
+test('smooth caps avoid reversed center-fan triangles after boundary movement', async () => {
+    const mask = maskFromRows(['#...', '##.#', '#.#.', '.#..', '#...', '#...', '#...', '#...']);
+    const mesh = await generateSmoothMesh(
+        mask.activePixels,
+        mask.width,
+        mask.height,
+        0.2,
+        0,
+        1,
+        1,
+        noYieldOptions
+    );
+
+    assertHealthyMesh('smooth moved-boundary cap mesh', mesh);
+});
+
+test('smooth caps avoid export-degenerate final ears after boundary movement', async () => {
+    const mask = maskFromRows([
+        '...#..',
+        '..#.#.',
+        '.#.#.#',
+        '.#.#..',
+        '..#.#.',
+        '.###..',
+        '#...#.',
+        '#..#..',
+        '####..',
+    ]);
+    const mesh = await generateSmoothMesh(
+        mask.activePixels,
+        mask.width,
+        mask.height,
+        0.2,
+        0,
+        0.4,
+        1,
+        noYieldOptions
+    );
+
+    assertHealthyMesh('smooth rounded-boundary cap mesh', mesh);
+    assert.deepEqual(inspectRoundedExportTopology(mesh), {
+        boundaryEdgeCount: 0,
+        overusedEdgeCount: 0,
+        skippedTriangleCount: 0,
+    });
+});
+
 test('smooth metrics stay on the smooth algorithm without mesher substitution state', async () => {
     const smoothMask = maskFromRows(['##', '##']);
     const smoothMesh = await generateSmoothMesh(
diff --git a/tests/previewPrefs.test.ts b/tests/previewPrefs.test.ts
new file mode 100644
index 0000000..d354c65
--- /dev/null
+++ b/tests/previewPrefs.test.ts
@@ -0,0 +1,51 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+
+if (!('localStorage' in globalThis)) {
+    const store: Record<string, string> = {};
+    Object.defineProperty(globalThis, 'localStorage', {
+        value: {
+            getItem: (key: string) => store[key] ?? null,
+            setItem: (key: string, value: string) => {
+                store[key] = value;
+            },
+            removeItem: (key: string) => {
+                delete store[key];
+            },
+            clear: () => {
+                for (const key of Object.keys(store)) delete store[key];
+            },
+        },
+    });
+}
+
+const mockLocalStorage = (globalThis as { localStorage: Storage }).localStorage;
+
+const {
+    PREVIEW_RENDER_MODE_STORAGE_KEY,
+    isPreviewRenderMode,
+    loadPreviewRenderMode,
+    savePreviewRenderMode,
+} = await import('../src/lib/previewPrefs.ts');
+
+test('preview render mode defaults to shaded', () => {
+    mockLocalStorage.clear();
+    assert.equal(loadPreviewRenderMode(), 'shaded');
+});
+
+for (const mode of ['shaded', 'transparent', 'wireframe'] as const) {
+    test(`preview render mode persists ${mode}`, () => {
+        mockLocalStorage.clear();
+        savePreviewRenderMode(mode);
+        assert.equal(mockLocalStorage.getItem(PREVIEW_RENDER_MODE_STORAGE_KEY), mode);
+        assert.equal(loadPreviewRenderMode(), mode);
+    });
+}
+
+test('invalid preview render modes fall back to shaded', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(PREVIEW_RENDER_MODE_STORAGE_KEY, 'overlay');
+    assert.equal(loadPreviewRenderMode(), 'shaded');
+    assert.equal(isPreviewRenderMode('wireframe'), true);
+    assert.equal(isPreviewRenderMode('overlay'), false);
+});
diff --git a/tests/previewRenderMode.test.ts b/tests/previewRenderMode.test.ts
new file mode 100644
index 0000000..e4a7930
--- /dev/null
+++ b/tests/previewRenderMode.test.ts
@@ -0,0 +1,109 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import * as THREE from 'three';
+import {
+    applyPreviewRenderMode,
+    createPreviewMaterialBaselines,
+    TRANSPARENT_PREVIEW_OPACITY,
+} from '../src/lib/previewRenderMode.ts';
+
+function createPreviewRoot() {
+    const root = new THREE.Group();
+    const geometry = new THREE.BoxGeometry(1, 1, 1);
+    const normal = new THREE.MeshStandardMaterial({ color: 0x2266aa });
+    const carrier = new THREE.MeshStandardMaterial({
+        color: 0xeeddcc,
+        transparent: true,
+        opacity: 0.3,
+    });
+    const normalMesh = new THREE.Mesh(geometry, normal);
+    const carrierMesh = new THREE.Mesh(geometry.clone(), carrier);
+    carrierMesh.position.z = 1;
+    normalMesh.userData.baseZ = 0.2;
+    carrierMesh.userData.baseZ = 0.4;
+    root.add(normalMesh, carrierMesh);
+    return { root, normal, carrier, normalMesh, carrierMesh };
+}
+
+test('preview render modes preserve material colors, geometry, visibility, and shaded baselines', () => {
+    const { root, normal, carrier, normalMesh, carrierMesh } = createPreviewRoot();
+    const normalColor = normal.color.getHex();
+    const carrierColor = carrier.color.getHex();
+    const normalGeometry = normalMesh.geometry;
+    const carrierGeometry = carrierMesh.geometry;
+    const baselines = createPreviewMaterialBaselines();
+
+    assert.equal(applyPreviewRenderMode(root, 'transparent', baselines), true);
+    for (const material of [normal, carrier]) {
+        assert.equal(material.transparent, true);
+        assert.equal(material.opacity, TRANSPARENT_PREVIEW_OPACITY);
+        assert.equal(material.depthWrite, false);
+        assert.equal(material.depthTest, false);
+        assert.equal(material.colorWrite, true);
+        assert.equal(material.side, THREE.DoubleSide);
+        assert.equal(material.wireframe, false);
+    }
+    assert.ok(normalMesh.renderOrder < carrierMesh.renderOrder);
+
+    assert.equal(applyPreviewRenderMode(root, 'wireframe', baselines), true);
+    for (const material of [normal, carrier]) {
+        assert.equal(material.transparent, false);
+        assert.equal(material.opacity, 1);
+        assert.equal(material.depthWrite, false);
+        assert.equal(material.depthTest, false);
+        assert.equal(material.colorWrite, false);
+        assert.equal(material.side, THREE.DoubleSide);
+        assert.equal(material.wireframe, false);
+    }
+
+    assert.equal(applyPreviewRenderMode(root, 'shaded', baselines), true);
+    assert.equal(normal.transparent, false);
+    assert.equal(normal.opacity, 1);
+    assert.equal(normal.depthWrite, true);
+    assert.equal(normal.depthTest, true);
+    assert.equal(normal.colorWrite, true);
+    assert.equal(normal.side, THREE.FrontSide);
+    assert.equal(normal.wireframe, false);
+    assert.equal(carrier.transparent, true);
+    assert.equal(carrier.opacity, 0.3);
+    assert.equal(carrier.depthWrite, true);
+    assert.equal(carrier.depthTest, true);
+    assert.equal(carrier.colorWrite, true);
+    assert.equal(carrier.side, THREE.FrontSide);
+    assert.equal(carrier.wireframe, false);
+    assert.equal(normal.color.getHex(), normalColor);
+    assert.equal(carrier.color.getHex(), carrierColor);
+    assert.equal(normalMesh.geometry, normalGeometry);
+    assert.equal(carrierMesh.geometry, carrierGeometry);
+    assert.equal(normalMesh.visible, true);
+    assert.equal(carrierMesh.visible, true);
+    assert.equal(normalMesh.renderOrder, 0);
+    assert.equal(carrierMesh.renderOrder, 0);
+    assert.equal(applyPreviewRenderMode(root, 'shaded', baselines), false);
+});
+
+test('inspection ordering remains unique for meshes at the same physical height', () => {
+    const root = new THREE.Group();
+    const meshes = [0.2, 0.4, 0.4].map((baseZ, index) => {
+        const mesh = new THREE.Mesh(
+            new THREE.BoxGeometry(1, 1, 1),
+            new THREE.MeshBasicMaterial({ color: 0x2266aa + index })
+        );
+        mesh.userData.baseZ = baseZ;
+        root.add(mesh);
+        return mesh;
+    });
+    const baselines = createPreviewMaterialBaselines();
+
+    applyPreviewRenderMode(root, 'transparent', baselines);
+    assert.deepEqual(
+        meshes.map((mesh) => mesh.renderOrder),
+        [1000, 1001, 1002]
+    );
+
+    applyPreviewRenderMode(root, 'shaded', baselines);
+    assert.deepEqual(
+        meshes.map((mesh) => mesh.renderOrder),
+        [0, 0, 0]
+    );
+});
diff --git a/tests/previewWireframe.test.ts b/tests/previewWireframe.test.ts
new file mode 100644
index 0000000..ec3b3ef
--- /dev/null
+++ b/tests/previewWireframe.test.ts
@@ -0,0 +1,196 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import * as THREE from 'three';
+import {
+    clearPreviewWireframeOverlay,
+    rebuildPreviewWireframeOverlay,
+    syncPreviewWireframeOverlayVisibility,
+} from '../src/lib/previewWireframe.ts';
+
+function createLayerMesh(color: number) {
+    return new THREE.Mesh(
+        new THREE.BoxGeometry(1, 1, 1),
+        new THREE.MeshStandardMaterial({ color })
+    );
+}
+
+function createIsolatedTriangleGeometry(triangleCount: number) {
+    const positions = new Float32Array(triangleCount * 9);
+    for (let triangle = 0; triangle < triangleCount; triangle++) {
+        const offset = triangle * 9;
+        const x = triangle * 2;
+        positions[offset] = x;
+        positions[offset + 3] = x + 1;
+        positions[offset + 6] = x;
+        positions[offset + 7] = 1;
+    }
+
+    const geometry = new THREE.BufferGeometry();
+    geometry.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    return geometry;
+}
+
+test('wireframe overlay uses thin unlit layer-colored lines outside the export group', async () => {
+    const modelGroup = new THREE.Group();
+    const redLayer = createLayerMesh(0xff0000);
+    const darkLayer = createLayerMesh(0x080808);
+    const purpleLayer = createLayerMesh(0x391182);
+    darkLayer.position.set(0, 0, 1);
+    purpleLayer.position.set(0, 0, 2);
+    modelGroup.add(redLayer, darkLayer, purpleLayer);
+
+    const overlay = new THREE.Group();
+    assert.equal(await rebuildPreviewWireframeOverlay(modelGroup, overlay), 'overlay');
+    assert.equal(modelGroup.children.length, 3);
+    assert.equal(overlay.children.length, 3);
+
+    const lines = overlay.children as THREE.LineSegments[];
+    for (const line of lines) {
+        assert.equal(line.isLineSegments, true);
+        assert.ok(line.geometry.getAttribute('position').count > 0);
+        const material = line.material as THREE.LineBasicMaterial;
+        assert.equal(material.isLineBasicMaterial, true);
+        assert.equal(material.linewidth, 1);
+        assert.equal(material.toneMapped, false);
+        assert.equal(material.depthTest, false);
+        assert.equal(material.depthWrite, false);
+    }
+    assert.equal((lines[0].material as THREE.LineBasicMaterial).color.getHex(), 0xff0000);
+    assert.equal((lines[1].material as THREE.LineBasicMaterial).color.getHex(), 0x080808);
+    assert.equal((lines[2].material as THREE.LineBasicMaterial).color.getHex(), 0x391182);
+    assert.equal(lines[1].matrix.elements[14], 1);
+
+    darkLayer.visible = false;
+    syncPreviewWireframeOverlayVisibility(overlay);
+    assert.equal(lines[0].visible, true);
+    assert.equal(lines[1].visible, false);
+
+    clearPreviewWireframeOverlay(overlay);
+    assert.equal(overlay.children.length, 0);
+});
+
+test('wireframe overlay welds split vertices before matching feature edges', async () => {
+    const geometry = new THREE.BoxGeometry(1, 1, 1);
+    const modelGroup = new THREE.Group();
+    modelGroup.add(new THREE.Mesh(geometry, new THREE.MeshStandardMaterial({ color: 0x2266aa })));
+    const overlay = new THREE.Group();
+
+    assert.equal(await rebuildPreviewWireframeOverlay(modelGroup, overlay), 'overlay');
+    const actual = (overlay.children[0] as THREE.LineSegments).geometry.getAttribute('position').count;
+    const expectedGeometry = new THREE.EdgesGeometry(geometry, 15);
+    const expected = expectedGeometry.getAttribute('position').count;
+    assert.equal(actual, expected);
+
+    expectedGeometry.dispose();
+    clearPreviewWireframeOverlay(overlay);
+    geometry.dispose();
+});
+
+test('wireframe overlay orders lines by physical layer height', async () => {
+    const higherLayer = createLayerMesh(0xff0000);
+    higherLayer.userData.baseZ = 0.4;
+    const lowerLayer = createLayerMesh(0x0000ff);
+    lowerLayer.userData.baseZ = 0.2;
+    const modelGroup = new THREE.Group();
+    modelGroup.add(higherLayer, lowerLayer);
+    const overlay = new THREE.Group();
+
+    assert.equal(await rebuildPreviewWireframeOverlay(modelGroup, overlay), 'overlay');
+    const lines = overlay.children as THREE.LineSegments[];
+    assert.equal((lines[0].material as THREE.LineBasicMaterial).color.getHex(), 0x0000ff);
+    assert.equal((lines[1].material as THREE.LineBasicMaterial).color.getHex(), 0xff0000);
+    assert.deepEqual(
+        lines.map((line) => line.renderOrder),
+        [2000, 2001]
+    );
+
+    clearPreviewWireframeOverlay(overlay);
+});
+
+test('wireframe overlay yields through large geometry instead of using dense material wireframes', async () => {
+    const geometry = createIsolatedTriangleGeometry(50_001);
+    const modelGroup = new THREE.Group();
+    modelGroup.add(new THREE.Mesh(geometry, new THREE.MeshStandardMaterial({ color: 0x2266aa })));
+    const overlay = new THREE.Group();
+    let yieldCount = 0;
+
+    assert.equal(
+        await rebuildPreviewWireframeOverlay(modelGroup, overlay, {
+            yieldIntervalMs: 0,
+            onYield: async () => {
+                yieldCount++;
+            },
+        }),
+        'overlay'
+    );
+    assert.ok(yieldCount > 0);
+    assert.equal(overlay.children.length, 1);
+
+    clearPreviewWireframeOverlay(overlay);
+    geometry.dispose();
+});
+
+test('wireframe overlay drops stale work without adding lines', async () => {
+    const geometry = createIsolatedTriangleGeometry(600);
+    const modelGroup = new THREE.Group();
+    modelGroup.add(new THREE.Mesh(geometry, new THREE.MeshStandardMaterial({ color: 0x2266aa })));
+    const overlay = new THREE.Group();
+    let current = true;
+
+    assert.equal(
+        await rebuildPreviewWireframeOverlay(modelGroup, overlay, {
+            yieldIntervalMs: 0,
+            isCurrent: () => current,
+            onYield: async () => {
+                current = false;
+            },
+        }),
+        'cancelled'
+    );
+    assert.equal(overlay.children.length, 0);
+
+    geometry.dispose();
+});
+
+test('stale wireframe work cannot clear a newer overlay build', async () => {
+    const staleGeometry = createIsolatedTriangleGeometry(600);
+    const staleModel = new THREE.Group();
+    staleModel.add(
+        new THREE.Mesh(staleGeometry, new THREE.MeshStandardMaterial({ color: 0xff0000 }))
+    );
+    const currentModel = new THREE.Group();
+    currentModel.add(createLayerMesh(0x00ff00));
+    const overlay = new THREE.Group();
+    let staleCurrent = true;
+    let releaseStaleYield: () => void = () => {};
+    let reportStaleYield: () => void = () => {};
+    const staleYielded = new Promise<void>((resolve) => {
+        reportStaleYield = () => resolve();
+    });
+    const staleYieldGate = new Promise<void>((resolve) => {
+        releaseStaleYield = () => resolve();
+    });
+
+    const staleBuild = rebuildPreviewWireframeOverlay(staleModel, overlay, {
+        yieldIntervalMs: 0,
+        isCurrent: () => staleCurrent,
+        onYield: async () => {
+            reportStaleYield();
+            await staleYieldGate;
+        },
+    });
+    await staleYielded;
+
+    staleCurrent = false;
+    assert.equal(await rebuildPreviewWireframeOverlay(currentModel, overlay), 'overlay');
+    releaseStaleYield();
+    assert.equal(await staleBuild, 'cancelled');
+    assert.equal(overlay.children.length, 1);
+    assert.equal(
+        ((overlay.children[0] as THREE.LineSegments).material as THREE.LineBasicMaterial).color.getHex(),
+        0x00ff00
+    );
+
+    clearPreviewWireframeOverlay(overlay);
+    staleGeometry.dispose();
+});

From cf3a26d6647da5fc3caaf2b6c97e78b43d46d7c1 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Fri, 10 Jul 2026 13:08:57 +0300
Subject: [PATCH 63/81] feat: auto-paint preview color toggle - The 3D preview
 toolbar now offers a Simulated/Physical color toggle for Auto-paint results,
 switching between the estimated blended appearance and the real physical
 filament colors stacked at each layer without a model rebuild. Only shown for
 Auto-paint models, the selection is remembered, and it never changes STL/3MF
 export content.

---
 CHANGELOG.md                      |  1 +
 src/App.tsx                       | 18 ++++++-
 src/components/PreviewActions.tsx | 40 +++++++++++++-
 src/components/ThreeDView.tsx     | 36 ++++++++++++-
 src/docs/3d-mode.md               |  1 +
 src/lib/previewColorMode.ts       | 43 ++++++++++++++++
 src/lib/previewPrefs.ts           | 25 ++++++++-
 src/types/index.ts                |  7 +++
 tests/export3mf.test.ts           | 45 ++++++++++++++++
 tests/previewColorMode.test.ts    | 86 +++++++++++++++++++++++++++++++
 tests/previewPrefs.test.ts        | 26 ++++++++++
 11 files changed, 324 insertions(+), 4 deletions(-)
 create mode 100644 src/lib/previewColorMode.ts
 create mode 100644 tests/previewColorMode.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0c66870..5af504e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -13,6 +13,7 @@ All notable changes to Kromacut are documented in this file.
 - **Filament profile import fixture** - Added a schema-v2 frontlit-calibrated 8-color `.kfil` fixture with import coverage to guard against accidental hiding-distance rescaling.
 - **Collapsible control groups** - Every settings card in 2D and 3D mode (Adjustments, Resize Image, Dedither, Quantization Settings, Image colors, 3D Print Settings, Auto-paint, Color Slice Heights, and Print Instructions) can now be collapsed from its header to save sidebar space. Collapsed groups are remembered across sessions, and important indicators stay visible while collapsed: color counts, busy spinners, modified-settings dots, unsaved-profile markers, and quick actions like reset and copy.
 - **3D inspection view modes** - The 3D preview toolbar now offers Shaded, Transparent, and Wireframe modes for inspecting surfaces, layers, and mesh edges. Wireframe uses thin, layer-colored feature edges, and the selected view is remembered without changing print settings or STL/3MF export content.
+- **Auto-paint preview color toggle** - The 3D preview toolbar now offers a Simulated/Physical color toggle for Auto-paint results, switching between the estimated blended appearance and the real physical filament colors stacked at each layer without a model rebuild. Only shown for Auto-paint models, the selection is remembered, and it never changes STL/3MF export content.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
diff --git a/src/App.tsx b/src/App.tsx
index 47320ad..05f58c9 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -5,6 +5,7 @@ import {
     AUTO_PAINT_TRANSITION_OPACITIES,
     type AutoPaintRepeatLimit,
     type AutoPaintTransitionOpacity,
+    type PreviewColorMode,
     type PreviewRenderMode,
     type ThreeDControlsStateShape,
 } from './types';
@@ -42,7 +43,12 @@ import ProgressOverlay from './components/ProgressOverlay';
 import DocsPage from './components/docs/DocsPage';
 import { defaultDocSlug } from './docs';
 import { loadCameraMode, saveCameraMode } from './lib/cameraPrefs';
-import { loadPreviewRenderMode, savePreviewRenderMode } from './lib/previewPrefs';
+import {
+    loadPreviewColorMode,
+    loadPreviewRenderMode,
+    savePreviewColorMode,
+    savePreviewRenderMode,
+} from './lib/previewPrefs';
 import { buildDocsPath, parseDocsLocation } from './lib/docs/navigation';
 import { applyHomeSeo } from './lib/seo';
 import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
@@ -257,6 +263,9 @@ function App(): React.ReactElement | null {
     const [previewRenderMode, setPreviewRenderMode] = useState<PreviewRenderMode>(
         loadPreviewRenderMode
     );
+    const [previewColorMode, setPreviewColorMode] = useState<PreviewColorMode>(
+        loadPreviewColorMode
+    );
     const [exportingSTL, setExportingSTL] = useState(false);
     const [exportProgress, setExportProgress] = useState(0); // 0..1
     const [exportStep, setExportStep] = useState<ExportProgressStep>({
@@ -744,6 +753,7 @@ function App(): React.ReactElement | null {
                                             isOrtho={isOrtho}
                                             flatPaint={builtFlatPaint}
                                             previewRenderMode={previewRenderMode}
+                                            previewColorMode={previewColorMode}
                                         />
                                         {exportingSTL && (
                                             <ProgressOverlay
@@ -794,6 +804,12 @@ function App(): React.ReactElement | null {
                                         setPreviewRenderMode(next);
                                         savePreviewRenderMode(next);
                                     }}
+                                    autoPaintEnabled={builtModelAutoPaint}
+                                    previewColorMode={previewColorMode}
+                                    onPreviewColorModeChange={(next) => {
+                                        setPreviewColorMode(next);
+                                        savePreviewColorMode(next);
+                                    }}
                                     onToggleCamera={() =>
                                         setIsOrtho((v) => {
                                             const next = !v;
diff --git a/src/components/PreviewActions.tsx b/src/components/PreviewActions.tsx
index 7b281db..5726298 100644
--- a/src/components/PreviewActions.tsx
+++ b/src/components/PreviewActions.tsx
@@ -1,7 +1,7 @@
 import React from 'react';
 import { Button } from '@/components/ui/button';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
-import type { PreviewRenderMode } from '@/types';
+import type { PreviewColorMode, PreviewRenderMode } from '@/types';
 import {
     RotateCcw,
     RotateCw,
@@ -19,6 +19,8 @@ import {
     Camera,
     Check,
     Eye,
+    Blend,
+    Layers,
 } from 'lucide-react';
 
 export interface PreviewActionsProps {
@@ -47,6 +49,10 @@ export interface PreviewActionsProps {
     onToggleCamera?: () => void;
     previewRenderMode?: PreviewRenderMode;
     onPreviewRenderModeChange?: (mode: PreviewRenderMode) => void;
+    /** The currently built model is an auto-paint result (has physical filament colors to show) */
+    autoPaintEnabled?: boolean;
+    previewColorMode?: PreviewColorMode;
+    onPreviewColorModeChange?: (mode: PreviewColorMode) => void;
 }
 
 export const PreviewActions: React.FC<PreviewActionsProps> = ({
@@ -74,6 +80,9 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
     onToggleCamera,
     previewRenderMode = 'shaded',
     onPreviewRenderModeChange,
+    autoPaintEnabled = false,
+    previewColorMode = 'simulated',
+    onPreviewColorModeChange,
 }) => {
     const [previewModeMenuOpen, setPreviewModeMenuOpen] = React.useState(false);
     const PreviewModeIcon =
@@ -151,6 +160,35 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
                     </PopoverContent>
                 </Popover>
             )}
+            {mode === '3d' && autoPaintEnabled && onPreviewColorModeChange && (
+                <Button
+                    size="icon"
+                    title={
+                        previewColorMode === 'physical'
+                            ? 'Showing physical filament colors — switch to simulated colors'
+                            : 'Showing simulated colors — switch to physical filament colors'
+                    }
+                    aria-label={
+                        previewColorMode === 'physical'
+                            ? 'Switch preview to simulated colors'
+                            : 'Switch preview to physical filament colors'
+                    }
+                    aria-pressed={previewColorMode === 'physical'}
+                    data-testid="preview-color-mode-toggle"
+                    onClick={() =>
+                        onPreviewColorModeChange(
+                            previewColorMode === 'physical' ? 'simulated' : 'physical'
+                        )
+                    }
+                    className="bg-primary hover:bg-primary/80 text-primary-foreground"
+                >
+                    {previewColorMode === 'physical' ? (
+                        <Layers className="w-4 h-4" />
+                    ) : (
+                        <Blend className="w-4 h-4" />
+                    )}
+                </Button>
+            )}
             {mode === '3d' && onToggleCamera && (
                 <Button
                     size="icon"
diff --git a/src/components/ThreeDView.tsx b/src/components/ThreeDView.tsx
index 0757b62..73cb050 100644
--- a/src/components/ThreeDView.tsx
+++ b/src/components/ThreeDView.tsx
@@ -23,12 +23,13 @@ import {
     applyPreviewRenderMode,
     createPreviewMaterialBaselines,
 } from '../lib/previewRenderMode';
+import { applyPreviewColorMode } from '../lib/previewColorMode';
 import {
     clearPreviewWireframeOverlay,
     rebuildPreviewWireframeOverlay as buildPreviewWireframeOverlay,
     syncPreviewWireframeOverlayVisibility as syncPreviewWireframeVisibility,
 } from '../lib/previewWireframe';
-import type { PreviewRenderMode } from '../types';
+import type { PreviewColorMode, PreviewRenderMode } from '../types';
 import { Layers } from 'lucide-react';
 import ProgressOverlay from './ProgressOverlay';
 
@@ -58,6 +59,8 @@ interface ThreeDViewProps {
     isOrtho?: boolean;
     flatPaint?: boolean; // Build a flat face-down slab (Flat Paint style, auto-paint only)
     previewRenderMode?: PreviewRenderMode;
+    /** Auto-paint 3D preview color source: simulated blend vs. physical filament colors. */
+    previewColorMode?: PreviewColorMode;
 }
 
 // Convert hex color to RGB tuple
@@ -358,6 +361,7 @@ export default function ThreeDView({
     isOrtho = false,
     flatPaint = false,
     previewRenderMode = 'shaded',
+    previewColorMode = 'simulated',
 }: ThreeDViewProps) {
     const mountRef = useRef<HTMLDivElement | null>(null);
     const [isBuilding, setIsBuilding] = useState(false);
@@ -387,10 +391,12 @@ export default function ThreeDView({
         switchCamera,
     } = useThreeScene(mountRef, setIsBuilding);
     const previewRenderModeRef = useRef(previewRenderMode);
+    const previewColorModeRef = useRef(previewColorMode);
     const previewMaterialBaselinesRef = useRef(createPreviewMaterialBaselines());
     const wireframeOverlayRef = useRef<THREE.Group | null>(null);
     const wireframeBuildGenerationRef = useRef(0);
     previewRenderModeRef.current = previewRenderMode;
+    previewColorModeRef.current = previewColorMode;
 
     const clearWireframeOverlay = useCallback(() => {
         wireframeBuildGenerationRef.current += 1;
@@ -482,6 +488,22 @@ export default function ThreeDView({
         requestRender,
     ]);
 
+    // Swaps built mesh colors between simulated and physical filament colors
+    // without a rebuild. The wireframe overlay bakes colors from the model's
+    // materials at build time, so it needs a refresh to pick up the new colors
+    // whenever it is currently showing.
+    useEffect(() => {
+        const modelGroup = modelGroupRef.current;
+        if (!modelGroup) return;
+
+        applyPreviewColorMode(modelGroup, previewColorMode);
+        requestRender();
+
+        if (previewRenderModeRef.current === 'wireframe') {
+            void rebuildWireframeOverlay().then(() => requestRender());
+        }
+    }, [modelGroupRef, previewColorMode, rebuildWireframeOverlay, requestRender]);
+
     useEffect(() => {
         switchCamera(isOrtho);
     }, [isOrtho, switchCamera]);
@@ -1568,6 +1590,9 @@ export default function ThreeDView({
                             mesh.userData.kromacutFilamentHex = part.filamentHex;
                             mesh.userData.kromacutMaterialKey = part.exportGroup;
                             mesh.userData.kromacutPartName = part.partName;
+                            // Preview-only color-mode toggle (never read by export).
+                            mesh.userData.kromacutPreviewVirtualHex = part.previewHex;
+                            mesh.userData.kromacutPreviewFilamentHex = part.filamentHex;
                             modelGroup.add(mesh);
                             pushPartDetail(partIdx, 'Part mesh complete', 1);
 
@@ -1598,6 +1623,7 @@ export default function ThreeDView({
                             const swatchIdx = colorOrder[i];
                             if (!swatches[swatchIdx]) continue;
                             const colorHex = swatches[swatchIdx].hex;
+                            const filamentColorHex = filamentSwatches?.[swatchIdx]?.hex ?? colorHex;
                             const thickness =
                                 i === 0
                                     ? Math.max(
@@ -1684,6 +1710,9 @@ export default function ThreeDView({
                             // Store layer Z range for preview slider
                             mesh.userData.baseZ = baseZ;
                             mesh.userData.topZ = topZ;
+                            // Preview-only color-mode toggle (never read by export).
+                            mesh.userData.kromacutPreviewVirtualHex = colorHex;
+                            mesh.userData.kromacutPreviewFilamentHex = filamentColorHex;
                             builtLayerMeshes[i] = mesh;
                             pushLayerDetail(buildLayerIndex, 'Layer mesh complete', 1);
 
@@ -1878,6 +1907,11 @@ export default function ThreeDView({
 
                 if (token !== buildTokenRef.current) return;
 
+                // Freshly built meshes always start with simulated colors; apply
+                // the current color mode before the wireframe overlay (below)
+                // captures colors from the model's materials.
+                applyPreviewColorMode(modelGroup, previewColorModeRef.current);
+
                 const activePreviewRenderMode = previewRenderModeRef.current;
                 if (activePreviewRenderMode === 'wireframe') {
                     applyPreviewRenderMode(
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 16cc946..f9f9ba6 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -146,6 +146,7 @@ Low confidence usually means you should calibrate filaments, add a missing filam
 The toolbar in the top-right corner of the 3D preview contains controls for the active view:
 
 - **Preview view** — choose **Shaded**, **Transparent**, or **Wireframe** to inspect the generated model's surfaces, layers, and edges. Wireframe uses thin, layer-colored feature edges. The selection is remembered and changes only the on-screen preview; it never changes print settings or STL/3MF exports.
+- **Preview colors** (Auto-paint only) — toggle between the estimated blended appearance (what the print should look like after color transmission) and the real physical filament color stacked at each layer. Useful for checking which filament goes where before printing. Only shown when the built model is an Auto-paint result; the selection is remembered and never changes STL/3MF exports.
 - **Camera toggle** — switches between perspective and orthographic projection. Perspective gives a natural depth effect; orthographic removes foreshortening and is useful for checking layer alignment. The button icon reflects the current mode, and the camera position is preserved when toggling.
 - **Undo / Redo** — steps through changes to the 3D settings.
 - **Download** — exports the current model as a .stl or a .3mf.
diff --git a/src/lib/previewColorMode.ts b/src/lib/previewColorMode.ts
new file mode 100644
index 0000000..e6c92a3
--- /dev/null
+++ b/src/lib/previewColorMode.ts
@@ -0,0 +1,43 @@
+import * as THREE from 'three';
+import type { PreviewColorMode } from '../types';
+
+type ColorMaterial = THREE.Material & { color: THREE.Color };
+
+function isColorMaterial(material: THREE.Material): material is ColorMaterial {
+    return 'color' in material && (material as ColorMaterial).color instanceof THREE.Color;
+}
+
+/**
+ * Auto-paint layer meshes are tagged at build time with both the color they
+ * were built with (simulated, blended appearance) and the physical filament
+ * color actually stacked at that layer. This swaps each mesh's material color
+ * between the two without touching geometry, so switching modes is instant and
+ * never triggers a rebuild. Meshes without both tags (manual mode, and Flat
+ * Paint's transparent carrier layer) keep their built-in color regardless of
+ * mode. Uses dedicated `kromacutPreview*` keys, distinct from the
+ * `kromacutFilamentHex`/`kromacutExportGroup` keys export3mf.ts reads, so this
+ * preview-only toggle can never influence STL/3MF export content.
+ */
+export function applyPreviewColorMode(root: THREE.Object3D, mode: PreviewColorMode): boolean {
+    let changed = false;
+
+    root.traverse((child) => {
+        if (!(child as THREE.Mesh).isMesh) return;
+        const mesh = child as THREE.Mesh;
+        const virtualHex = mesh.userData.kromacutPreviewVirtualHex;
+        const filamentHex = mesh.userData.kromacutPreviewFilamentHex;
+        if (typeof virtualHex !== 'string' || typeof filamentHex !== 'string') return;
+
+        const targetHex = mode === 'physical' ? filamentHex : virtualHex;
+        const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+        for (const material of materials) {
+            if (!isColorMaterial(material)) continue;
+            const target = new THREE.Color(targetHex);
+            if (material.color.equals(target)) continue;
+            material.color.copy(target);
+            changed = true;
+        }
+    });
+
+    return changed;
+}
diff --git a/src/lib/previewPrefs.ts b/src/lib/previewPrefs.ts
index f8d6c8b..8147ea3 100644
--- a/src/lib/previewPrefs.ts
+++ b/src/lib/previewPrefs.ts
@@ -1,4 +1,4 @@
-import type { PreviewRenderMode } from '../types';
+import type { PreviewColorMode, PreviewRenderMode } from '../types';
 
 export const PREVIEW_RENDER_MODE_STORAGE_KEY = 'kromacut:3d-preview-mode';
 
@@ -22,3 +22,26 @@ export function savePreviewRenderMode(mode: PreviewRenderMode): void {
         // The in-memory preview state remains usable when storage is unavailable.
     }
 }
+
+export const PREVIEW_COLOR_MODE_STORAGE_KEY = 'kromacut:3d-preview-color-mode';
+
+export function isPreviewColorMode(value: unknown): value is PreviewColorMode {
+    return value === 'simulated' || value === 'physical';
+}
+
+export function loadPreviewColorMode(): PreviewColorMode {
+    try {
+        const stored = localStorage.getItem(PREVIEW_COLOR_MODE_STORAGE_KEY);
+        return isPreviewColorMode(stored) ? stored : 'simulated';
+    } catch {
+        return 'simulated';
+    }
+}
+
+export function savePreviewColorMode(mode: PreviewColorMode): void {
+    try {
+        localStorage.setItem(PREVIEW_COLOR_MODE_STORAGE_KEY, mode);
+    } catch {
+        // The in-memory preview state remains usable when storage is unavailable.
+    }
+}
diff --git a/src/types/index.ts b/src/types/index.ts
index 3bf2378..e0d9ed0 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -10,6 +10,13 @@ export type AutoPaintTransitionOpacity = (typeof AUTO_PAINT_TRANSITION_OPACITIES
 /** Visual inspection style for the 3D preview. Never changes the printable model. */
 export type PreviewRenderMode = 'shaded' | 'transparent' | 'wireframe';
 
+/**
+ * Auto-paint 3D preview color source: the estimated blended appearance, or the
+ * real physical filament colors stacked at each layer. Preview-only — never
+ * changes STL/3MF export content.
+ */
+export type PreviewColorMode = 'simulated' | 'physical';
+
 export type Swatch = {
     hex: string;
     a: number;
diff --git a/tests/export3mf.test.ts b/tests/export3mf.test.ts
index 330412e..c4c9d7c 100644
--- a/tests/export3mf.test.ts
+++ b/tests/export3mf.test.ts
@@ -1487,6 +1487,51 @@ test('3MF export keeps generated model XML chunked for large models', () => {
     assert.match(source, /encodeXmlChunks\(xmlParts\.splice\(0\)\)/);
 });
 
+test('3MF export never reads the preview-only color-mode userData tags', () => {
+    // The simulated/physical preview color toggle (ThreeDView) tags meshes with
+    // kromacutPreview*Hex keys read only by src/lib/previewColorMode.ts. Export
+    // must keep sourcing colors from kromacutFilamentHex/layerFilamentColors and
+    // the mesh's live material color, never these preview-only tags, so toggling
+    // the preview can never change exported geometry or colors.
+    const source = readFileSync(resolve(process.cwd(), 'src/lib/export3mf.ts'), 'utf8');
+
+    assert.doesNotMatch(source, /kromacutPreview/);
+});
+
+test('exported filament colors are unaffected by the preview color-mode toggle', async () => {
+    // Mirrors how App.tsx exports auto-paint models: a plain (non-grouped) mesh
+    // plus the per-layer `layerFilamentColors` option, which is how these meshes
+    // actually get their exported color (not from mesh.material.color).
+    const { applyPreviewColorMode } = await import('../src/lib/previewColorMode.ts');
+
+    const root = new THREE.Group();
+    const mesh = createLayerMesh(createSharedCubeGeometry(), 0x3050c0);
+    mesh.userData.kromacutPreviewVirtualHex = '#3050c0';
+    mesh.userData.kromacutPreviewFilamentHex = '#ff8800';
+    root.add(mesh);
+
+    const { exportObjectTo3MFBlob } = await loadExport3mfModule();
+    const exportOptions = { layerFilamentColors: ['#112233'] };
+
+    const simulatedBlob = await exportObjectTo3MFBlob(root, exportOptions);
+
+    applyPreviewColorMode(root, 'physical');
+    assert.equal((mesh.material as THREE.MeshBasicMaterial).color.getHexString(), 'ff8800');
+    const physicalBlob = await exportObjectTo3MFBlob(root, exportOptions);
+
+    const readModel = async (blob: Blob) =>
+        (await JSZip.loadAsync(await blob.arrayBuffer())).file('3D/3dmodel.model')?.async('string');
+    const simulatedModel = await readModel(simulatedBlob);
+    const physicalModel = await readModel(physicalBlob);
+
+    // Both exports use layerFilamentColors regardless of the preview toggle or
+    // the mesh's live (simulated vs. physical) material color.
+    assert.ok(simulatedModel?.includes('112233'));
+    assert.ok(physicalModel?.includes('112233'));
+    assert.ok(!simulatedModel?.includes('3050C0'));
+    assert.ok(!physicalModel?.includes('FF8800'));
+});
+
 test('exports include preview-hidden layers with their original filament colors', async () => {
     const root = new THREE.Group();
     const first = createLayerMesh(createSharedCubeGeometry(), 0xff0000);
diff --git a/tests/previewColorMode.test.ts b/tests/previewColorMode.test.ts
new file mode 100644
index 0000000..49abfb2
--- /dev/null
+++ b/tests/previewColorMode.test.ts
@@ -0,0 +1,86 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import * as THREE from 'three';
+import { applyPreviewColorMode } from '../src/lib/previewColorMode.ts';
+
+function createTaggedMesh(virtualHex: string, filamentHex: string) {
+    const geometry = new THREE.BoxGeometry(1, 1, 1);
+    const material = new THREE.MeshStandardMaterial({ color: virtualHex });
+    const mesh = new THREE.Mesh(geometry, material);
+    mesh.userData.kromacutPreviewVirtualHex = virtualHex;
+    mesh.userData.kromacutPreviewFilamentHex = filamentHex;
+    return { mesh, material, geometry };
+}
+
+test('physical mode swaps tagged mesh colors to the filament hex, and back to simulated', () => {
+    const { mesh, material } = createTaggedMesh('#3050c0', '#ff8800');
+
+    assert.equal(applyPreviewColorMode(new THREE.Group().add(mesh), 'physical'), true);
+    assert.equal(material.color.getHexString(), 'ff8800');
+
+    assert.equal(applyPreviewColorMode(mesh, 'simulated'), true);
+    assert.equal(material.color.getHexString(), '3050c0');
+});
+
+test('applying the already-active mode is a no-op and reports no change', () => {
+    const { mesh, material } = createTaggedMesh('#3050c0', '#ff8800');
+
+    assert.equal(applyPreviewColorMode(mesh, 'simulated'), false);
+    assert.equal(material.color.getHexString(), '3050c0');
+
+    applyPreviewColorMode(mesh, 'physical');
+    assert.equal(applyPreviewColorMode(mesh, 'physical'), false);
+});
+
+test('untagged meshes (manual mode) are left untouched', () => {
+    const geometry = new THREE.BoxGeometry(1, 1, 1);
+    const material = new THREE.MeshStandardMaterial({ color: '#123456' });
+    const mesh = new THREE.Mesh(geometry, material);
+
+    assert.equal(applyPreviewColorMode(mesh, 'physical'), false);
+    assert.equal(material.color.getHexString(), '123456');
+});
+
+test('flat paint carrier layers with identical virtual and filament hex are stable across modes', () => {
+    const { mesh, material } = createTaggedMesh('#ffffff', '#ffffff');
+
+    assert.equal(applyPreviewColorMode(mesh, 'physical'), false);
+    assert.equal(applyPreviewColorMode(mesh, 'simulated'), false);
+    assert.equal(material.color.getHexString(), 'ffffff');
+});
+
+test('preserves geometry, visibility, and non-color material state', () => {
+    const geometry = new THREE.BoxGeometry(1, 1, 1);
+    const material = new THREE.MeshStandardMaterial({
+        color: '#3050c0',
+        transparent: true,
+        opacity: 0.3,
+    });
+    const mesh = new THREE.Mesh(geometry, material);
+    mesh.userData.kromacutPreviewVirtualHex = '#3050c0';
+    mesh.userData.kromacutPreviewFilamentHex = '#ff8800';
+
+    applyPreviewColorMode(mesh, 'physical');
+
+    assert.equal(mesh.geometry, geometry);
+    assert.equal(mesh.visible, true);
+    assert.equal(material.transparent, true);
+    assert.equal(material.opacity, 0.3);
+});
+
+test('only meshes with both preview hex tags are affected in a mixed tree', () => {
+    const tagged = createTaggedMesh('#3050c0', '#ff8800');
+    const untagged = new THREE.Mesh(
+        new THREE.BoxGeometry(1, 1, 1),
+        new THREE.MeshStandardMaterial({ color: '#00ff00' })
+    );
+    const root = new THREE.Group();
+    root.add(tagged.mesh, untagged);
+
+    assert.equal(applyPreviewColorMode(root, 'physical'), true);
+    assert.equal(tagged.material.color.getHexString(), 'ff8800');
+    assert.equal(
+        (untagged.material as THREE.MeshStandardMaterial).color.getHexString(),
+        '00ff00'
+    );
+});
diff --git a/tests/previewPrefs.test.ts b/tests/previewPrefs.test.ts
index d354c65..da0f8df 100644
--- a/tests/previewPrefs.test.ts
+++ b/tests/previewPrefs.test.ts
@@ -22,9 +22,13 @@ if (!('localStorage' in globalThis)) {
 const mockLocalStorage = (globalThis as { localStorage: Storage }).localStorage;
 
 const {
+    PREVIEW_COLOR_MODE_STORAGE_KEY,
     PREVIEW_RENDER_MODE_STORAGE_KEY,
+    isPreviewColorMode,
     isPreviewRenderMode,
+    loadPreviewColorMode,
     loadPreviewRenderMode,
+    savePreviewColorMode,
     savePreviewRenderMode,
 } = await import('../src/lib/previewPrefs.ts');
 
@@ -49,3 +53,25 @@ test('invalid preview render modes fall back to shaded', () => {
     assert.equal(isPreviewRenderMode('wireframe'), true);
     assert.equal(isPreviewRenderMode('overlay'), false);
 });
+
+test('preview color mode defaults to simulated', () => {
+    mockLocalStorage.clear();
+    assert.equal(loadPreviewColorMode(), 'simulated');
+});
+
+for (const mode of ['simulated', 'physical'] as const) {
+    test(`preview color mode persists ${mode}`, () => {
+        mockLocalStorage.clear();
+        savePreviewColorMode(mode);
+        assert.equal(mockLocalStorage.getItem(PREVIEW_COLOR_MODE_STORAGE_KEY), mode);
+        assert.equal(loadPreviewColorMode(), mode);
+    });
+}
+
+test('invalid preview color modes fall back to simulated', () => {
+    mockLocalStorage.clear();
+    mockLocalStorage.setItem(PREVIEW_COLOR_MODE_STORAGE_KEY, 'blended');
+    assert.equal(loadPreviewColorMode(), 'simulated');
+    assert.equal(isPreviewColorMode('physical'), true);
+    assert.equal(isPreviewColorMode('blended'), false);
+});

From 8b1a566a1b161ea9057e0590b45853c443e4994d Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 11 Jul 2026 09:03:23 +0300
Subject: [PATCH 64/81] feat: 2D touch-up tools - The 2D preview toolbar now
 includes five hard-edged pixel tools (Brush, Eraser, Fill, Text, and color
 picker) for direct image editing with palette-safe colors, an on-canvas text
 box you type into directly with live move, resize, and word wrap, one
 undo/redo step per edit, and live non-blocking drawing with adjustments
 staying non-destructive.

---
 CHANGELOG.md                      |   1 +
 src/App.tsx                       |  60 ++-
 src/components/CanvasPreview.tsx  | 740 ++++++++++++++++++++++++++++--
 src/components/PreviewActions.tsx | 220 ++++++++-
 src/docs/loading-images.md        |   8 +
 src/lib/touchup.ts                | 318 +++++++++++++
 src/types/index.ts                |   7 +
 tests/touchup.test.ts             | 293 ++++++++++++
 8 files changed, 1611 insertions(+), 36 deletions(-)
 create mode 100644 src/lib/touchup.ts
 create mode 100644 tests/touchup.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5af504e..e31934a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ All notable changes to Kromacut are documented in this file.
 - **Collapsible control groups** - Every settings card in 2D and 3D mode (Adjustments, Resize Image, Dedither, Quantization Settings, Image colors, 3D Print Settings, Auto-paint, Color Slice Heights, and Print Instructions) can now be collapsed from its header to save sidebar space. Collapsed groups are remembered across sessions, and important indicators stay visible while collapsed: color counts, busy spinners, modified-settings dots, unsaved-profile markers, and quick actions like reset and copy.
 - **3D inspection view modes** - The 3D preview toolbar now offers Shaded, Transparent, and Wireframe modes for inspecting surfaces, layers, and mesh edges. Wireframe uses thin, layer-colored feature edges, and the selected view is remembered without changing print settings or STL/3MF export content.
 - **Auto-paint preview color toggle** - The 3D preview toolbar now offers a Simulated/Physical color toggle for Auto-paint results, switching between the estimated blended appearance and the real physical filament colors stacked at each layer without a model rebuild. Only shown for Auto-paint models, the selection is remembered, and it never changes STL/3MF export content.
+- **2D touch-up tools** - The 2D preview toolbar now includes five hard-edged pixel tools (Brush, Eraser, Fill, Text, and color picker) for direct image editing with palette-safe colors, an on-canvas text box you type into directly with live move, resize, and word wrap, one undo/redo step per edit, and live non-blocking drawing with adjustments staying non-destructive.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
diff --git a/src/App.tsx b/src/App.tsx
index 05f58c9..cad15b4 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -1,4 +1,4 @@
-import React, { useEffect, useRef, useState } from 'react';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
 import ThreeDControls from './components/ThreeDControls';
 import {
     AUTO_PAINT_REPEAT_LIMITS,
@@ -8,6 +8,7 @@ import {
     type PreviewColorMode,
     type PreviewRenderMode,
     type ThreeDControlsStateShape,
+    type TouchUpTool,
 } from './types';
 import ThreeDView from './components/ThreeDView';
 import logo from './assets/logo.png';
@@ -213,6 +214,11 @@ function App(): React.ReactElement | null {
     const [showCheckerboard, setShowCheckerboard] = useState<boolean>(false);
     const [isCropMode, setIsCropMode] = useState(false);
     const [hasValidCropSelection, setHasValidCropSelection] = useState(false);
+    // 2D touch-up tools are session-only; image changes still use shared history.
+    const [touchUpTool, setTouchUpTool] = useState<TouchUpTool | null>(null);
+    const [touchUpColor, setTouchUpColor] = useState('#000000');
+    const [touchUpBrushSize, setTouchUpBrushSize] = useState(4);
+    const [touchUpTextSize, setTouchUpTextSize] = useState(24);
     const {
         isQuantizing,
         setIsQuantizing,
@@ -405,6 +411,7 @@ function App(): React.ReactElement | null {
             alert('Please upload an image file');
             return;
         }
+        setTouchUpTool(null);
         const url = URL.createObjectURL(file);
         invalidate();
         setImage(url, true);
@@ -413,6 +420,7 @@ function App(): React.ReactElement | null {
     // removed unused handlers (inline handlers used instead)
 
     const clear = () => {
+        setTouchUpTool(null);
         clearCurrent();
         if (inputRef.current) inputRef.current.value = '';
     };
@@ -478,6 +486,19 @@ function App(): React.ReactElement | null {
     // Layout splitter state
     const layoutRef = useRef<HTMLDivElement | null>(null);
 
+    const touchUpPaletteColors = useMemo(
+        () =>
+            Array.from(
+                new Set(swatches.filter((swatch) => swatch.a !== 0).map((swatch) => swatch.hex))
+            ),
+        [swatches]
+    );
+
+    const handleTouchUpToolChange = (nextTool: TouchUpTool | null) => {
+        if (!imageSrc) return;
+        setTouchUpTool(nextTool);
+    };
+
     const dropzone = useDropzone({ enabled: mode === '2d', onFile: handleFiles });
     const { onExportImage, onExportStl, onExport3MF, onSwatchApply, onSwatchDelete } =
         useAppHandlers({
@@ -547,17 +568,20 @@ function App(): React.ReactElement | null {
                                                 defs={SLIDER_DEFS}
                                                 initial={ADJUSTMENT_DEFAULTS}
                                                 onCommit={(vals) => {
+                                                    setTouchUpTool(null);
                                                     setAdjustments(vals);
                                                     // schedule a redraw
                                                     requestAnimationFrame(() =>
                                                         canvasPreviewRef.current?.redraw()
                                                     );
                                                 }}
-                                                onBake={async () => {
+                                                onBake={async (vals) => {
                                                     if (!canvasPreviewRef.current) return;
                                                     try {
                                                         const blob =
-                                                            await canvasPreviewRef.current.exportAdjustedImageBlob?.();
+                                                            await canvasPreviewRef.current.exportAdjustedImageBlob?.(
+                                                                vals
+                                                            );
                                                         if (!blob) return;
                                                         const url = URL.createObjectURL(blob);
                                                         invalidate();
@@ -703,6 +727,21 @@ function App(): React.ReactElement | null {
                                             showCheckerboard={showCheckerboard}
                                             adjustments={adjustments}
                                             onCropSelectionChange={setHasValidCropSelection}
+                                            touchUpTool={touchUpTool}
+                                            touchUpColor={touchUpColor}
+                                            touchUpBrushSize={touchUpBrushSize}
+                                            touchUpTextSize={touchUpTextSize}
+                                            onTouchUpCommit={(blob) => {
+                                                const url = URL.createObjectURL(blob);
+                                                invalidate();
+                                                setImage(url, true);
+                                                return url;
+                                            }}
+                                            onTouchUpPickColor={(hex) => {
+                                                setTouchUpColor(hex);
+                                                setTouchUpTool('brush');
+                                            }}
+                                            onTouchUpExit={() => setTouchUpTool(null)}
                                         />
                                         {processingActive && (
                                             <ProgressOverlay
@@ -779,7 +818,11 @@ function App(): React.ReactElement | null {
                                     exportProgress={exportProgress}
                                     onUndo={undo}
                                     onRedo={redo}
-                                    onEnterCrop={() => imageSrc && setIsCropMode(true)}
+                                    onEnterCrop={() => {
+                                        if (!imageSrc) return;
+                                        setTouchUpTool(null);
+                                        setIsCropMode(true);
+                                    }}
                                     onSaveCrop={async () => {
                                         if (!canvasPreviewRef.current) return;
                                         const blob =
@@ -810,6 +853,15 @@ function App(): React.ReactElement | null {
                                         setPreviewColorMode(next);
                                         savePreviewColorMode(next);
                                     }}
+                                    touchUpTool={touchUpTool}
+                                    onTouchUpToolChange={handleTouchUpToolChange}
+                                    touchUpColor={touchUpColor}
+                                    onTouchUpColorChange={setTouchUpColor}
+                                    touchUpBrushSize={touchUpBrushSize}
+                                    onTouchUpBrushSizeChange={setTouchUpBrushSize}
+                                    touchUpTextSize={touchUpTextSize}
+                                    onTouchUpTextSizeChange={setTouchUpTextSize}
+                                    paletteColors={touchUpPaletteColors}
                                     onToggleCamera={() =>
                                         setIsOrtho((v) => {
                                             const next = !v;
diff --git a/src/components/CanvasPreview.tsx b/src/components/CanvasPreview.tsx
index 0a7da6c..d207945 100644
--- a/src/components/CanvasPreview.tsx
+++ b/src/components/CanvasPreview.tsx
@@ -8,6 +8,18 @@ import React, {
     useMemo,
 } from 'react';
 import { applyAdjustments, isAllDefault } from '../lib/applyAdjustments';
+import { Check, Move, X } from 'lucide-react';
+import {
+    brushSpans,
+    floodFill,
+    hardenAlphaToColor,
+    parseHexColor,
+    rgbToHex,
+    stampSpansIntoSurface,
+    strokeLinePoints,
+    wrapTextLines,
+} from '../lib/touchup';
+import type { TouchUpTool } from '../types';
 
 export interface CanvasPreviewHandle {
     redraw: () => void;
@@ -18,7 +30,9 @@ export interface CanvasPreviewHandle {
     exportImageBlob: () => Promise<Blob | null>;
     hasValidCropSelection: () => boolean;
     onCropSelectionChange?: (hasValid: boolean) => void;
-    exportAdjustedImageBlob?: () => Promise<Blob | null>;
+    exportAdjustedImageBlob?: (
+        adjustmentsOverride?: Record<string, number>
+    ) => Promise<Blob | null>;
 }
 
 interface Props {
@@ -27,10 +41,63 @@ interface Props {
     showCheckerboard?: boolean;
     adjustments?: Record<string, number>;
     onCropSelectionChange?: (hasValid: boolean) => void;
+    /** Active 2D touch-up tool; while set, left-drag edits instead of panning. */
+    touchUpTool?: TouchUpTool | null;
+    touchUpColor?: string;
+    touchUpBrushSize?: number;
+    touchUpTextSize?: number;
+    /**
+     * Receives the edited full-resolution PNG after each committed edit and
+     * returns the object URL it was published under, so the preview can keep
+     * its live canvases when that same URL comes back as the new imageSrc.
+     */
+    onTouchUpCommit?: (blob: Blob) => string | void;
+    onTouchUpPickColor?: (hex: string) => void;
+    /** Called when the user presses Escape while a tool is active. */
+    onTouchUpExit?: () => void;
+}
+
+interface ActiveTouchStroke {
+    pointerId: number;
+    lastPoint: { x: number; y: number } | null;
+    spans: ReturnType<typeof brushSpans>;
+    rgba: [number, number, number, number];
+    /** CPU-side working copy of the image; stamped in JS, blitted per event. */
+    buffer: ImageData;
+    changed: boolean;
+    /** Pending region of `buffer` not yet blitted to the offscreen canvases. */
+    dirty: { x0: number; y0: number; x1: number; y1: number } | null;
+}
+
+/** In-progress text placement, in image-pixel coordinates. */
+interface TextDraft {
+    /** Monotonic id so a freshly placed box grabs keyboard focus once. */
+    id: number;
+    x: number;
+    y: number;
+    /** Wrap width of the box in image pixels. */
+    width: number;
+    text: string;
 }
 
 const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
-    ({ imageSrc, isCropMode, showCheckerboard, adjustments, onCropSelectionChange }, ref) => {
+    (
+        {
+            imageSrc,
+            isCropMode,
+            showCheckerboard,
+            adjustments,
+            onCropSelectionChange,
+            touchUpTool,
+            touchUpColor,
+            touchUpBrushSize,
+            touchUpTextSize,
+            onTouchUpCommit,
+            onTouchUpPickColor,
+            onTouchUpExit,
+        },
+        ref
+    ) => {
         const canvasRef = useRef<HTMLCanvasElement | null>(null);
         const previewContainerRef = useRef<HTMLDivElement | null>(null);
         const imgRef = useRef<HTMLImageElement | null>(null);
@@ -64,6 +131,19 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
         const originalCanvasRef = useRef<HTMLCanvasElement | null>(null);
         const processedCanvasRef = useRef<HTMLCanvasElement | null>(null);
         const lastAdjSigRef = useRef<string>('');
+        const mountedRef = useRef(true);
+        const imageLoadGenerationRef = useRef(0);
+        const activeTouchStrokeRef = useRef<ActiveTouchStroke | null>(null);
+        // Object URLs of our own pending commits. When one of them arrives back
+        // as imageSrc, the live canvases already hold exactly those pixels and
+        // are kept as-is — drawing never blocks on the round trip.
+        const selfCommitSrcsRef = useRef<Set<string>>(new Set());
+        // Bumped only when the image is replaced from outside the touch-up
+        // tools (undo, quantize, crop, …); invalidates in-flight commits.
+        const externalImageGenerationRef = useRef(0);
+        const touchUpCommitChainRef = useRef<Promise<void>>(Promise.resolve());
+        const onTouchUpCommitRef = useRef(onTouchUpCommit);
+        onTouchUpCommitRef.current = onTouchUpCommit;
 
         const hasAdjustments = useMemo(
             () => !!adjustments && !isAllDefault(adjustments),
@@ -95,8 +175,12 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
 
             const img = imgRef.current;
             if (!img) return;
-            const iw = img.naturalWidth;
-            const ih = img.naturalHeight;
+            // Prefer the live offscreen canvas dimensions: while a committed
+            // touch-up edit's image is still loading, the original canvas is
+            // the source of truth and keeps the preview from blanking out.
+            const original = originalCanvasRef.current;
+            const iw = original?.width || img.naturalWidth;
+            const ih = original?.height || img.naturalHeight;
             if (!iw || !ih) return;
 
             const baseScale = Math.min(cw / iw, ch / ih);
@@ -121,7 +205,6 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
             // to show the exact pixel values after quantization.
             ctx.imageSmoothingEnabled = false;
             // imageSmoothingQuality is not relevant when smoothing is disabled
-            const original = originalCanvasRef.current;
             if (hasAdjustments) {
                 const sig = adjustmentsSig;
                 // Recompute processed canvas only if signature changed or missing.
@@ -206,8 +289,11 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
             if (!container || !img) return null;
             const cw = container.clientWidth;
             const ch = container.clientHeight;
-            const iw = img.naturalWidth;
-            const ih = img.naturalHeight;
+            // Same fallback as drawToCanvas: the offscreen canvas keeps layout
+            // (and tool coordinates) stable while a committed edit reloads.
+            const original = originalCanvasRef.current;
+            const iw = original?.width || img.naturalWidth;
+            const ih = original?.height || img.naturalHeight;
             if (!iw || !ih) return null;
             const baseScale = Math.min(cw / iw, ch / ih);
             const dw = iw * baseScale;
@@ -218,8 +304,23 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
         };
 
         useEffect(() => {
+            const loadGeneration = ++imageLoadGenerationRef.current;
+            // Our own commits come back with canvases already holding exactly
+            // these pixels; keep the canvases (and any in-progress stroke)
+            // untouched so drawing stays continuous across history commits.
+            const isSelfCommit = !!imageSrc && selfCommitSrcsRef.current.delete(imageSrc);
+            if (!isSelfCommit) {
+                selfCommitSrcsRef.current.clear();
+                externalImageGenerationRef.current += 1;
+                activeTouchStrokeRef.current = null;
+                // A text draft's coordinates belong to the replaced image.
+                if (textDraftRef.current) setTextDraft(null);
+            }
+
             if (!imageSrc) {
                 imgRef.current = null;
+                originalCanvasRef.current = null;
+                processedCanvasRef.current = null;
                 setImageLoaded(false);
                 const canvas = canvasRef.current;
                 if (canvas) {
@@ -237,7 +338,7 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
             // available we'll fall back to the existing offset.
             const container = previewContainerRef.current;
             let prevCenterImageCoord: { x: number; y: number } | null = null;
-            if (container && imgRef.current) {
+            if (!isSelfCommit && container && imgRef.current) {
                 const rect = container.getBoundingClientRect();
                 const cx = rect.width / 2;
                 const cy = rect.height / 2;
@@ -252,8 +353,22 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
 
             const img = new Image();
             imgRef.current = img;
-            setImageLoaded(false); // Reset loading state
+            if (!isSelfCommit) setImageLoaded(false); // Reset loading state
             img.onload = () => {
+                if (
+                    !mountedRef.current ||
+                    loadGeneration !== imageLoadGenerationRef.current ||
+                    imgRef.current !== img
+                ) {
+                    return;
+                }
+                if (isSelfCommit) {
+                    // The img element only feeds the export helpers here; the
+                    // offscreen canvases already show exactly these pixels.
+                    setImageLoaded(true);
+                    drawToCanvas();
+                    return;
+                }
                 // preserve current zoom (don't reset) and try to restore the
                 // same image coordinate under the container center so the view
                 // doesn't jump when swapping the image source.
@@ -289,11 +404,24 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
 
                 drawToCanvas();
             };
+            img.onerror = () => {
+                if (
+                    !mountedRef.current ||
+                    loadGeneration !== imageLoadGenerationRef.current ||
+                    imgRef.current !== img
+                ) {
+                    return;
+                }
+                setImageLoaded(false);
+            };
             img.src = imageSrc;
             return () => {
-                imgRef.current = null;
-                originalCanvasRef.current = null;
-                processedCanvasRef.current = null;
+                img.onload = null;
+                img.onerror = null;
+                if (imageLoadGenerationRef.current === loadGeneration) {
+                    imageLoadGenerationRef.current += 1;
+                }
+                if (imgRef.current === img) imgRef.current = null;
             };
         }, [imageSrc, drawToCanvas]);
 
@@ -387,10 +515,443 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
         };
         onWheelCanvasRef.current = onWheelCanvas;
 
+        // === 2D touch-up tools ===
+
+        const touchUpActive = !!touchUpTool && !isCropMode && imageLoaded;
+        const showBrushOutline =
+            touchUpActive && (touchUpTool === 'brush' || touchUpTool === 'eraser');
+        const brushOutlineRef = useRef<HTMLDivElement | null>(null);
+        const onTouchUpExitRef = useRef(onTouchUpExit);
+        onTouchUpExitRef.current = onTouchUpExit;
+
+        // In-progress text placement: edited directly on the image, movable,
+        // and width-resizable (word wrap), then rasterized on commit.
+        const [textDraft, setTextDraft] = useState<TextDraft | null>(null);
+        const textDraftRef = useRef(textDraft);
+        textDraftRef.current = textDraft;
+        const textDraftIdRef = useRef(0);
+        const textDraftBoxRef = useRef<HTMLDivElement | null>(null);
+        const textDraftAreaRef = useRef<HTMLTextAreaElement | null>(null);
+        const commitTextDraftRef = useRef<() => void>(() => {});
+        const syncTextDraftGeometryRef = useRef<() => void>(() => {});
+        const touchUpFontSize = Math.max(4, Math.round(touchUpTextSize ?? 24));
+        const TEXT_DRAFT_LINE_HEIGHT = 1.25;
+
+        useEffect(() => {
+            if (!touchUpTool) return;
+            const onKey = (e: KeyboardEvent) => {
+                if (e.key !== 'Escape') return;
+                // First Escape discards an open text draft, second exits the tool.
+                if (textDraftRef.current) {
+                    setTextDraft(null);
+                    return;
+                }
+                onTouchUpExitRef.current?.();
+            };
+            window.addEventListener('keydown', onKey);
+            return () => window.removeEventListener('keydown', onKey);
+        }, [touchUpTool]);
+
+        // Leaving the text tool (or entering crop) commits whatever was typed
+        // instead of silently dropping it.
+        useEffect(() => {
+            if (touchUpTool === 'text' && !isCropMode) return;
+            if (textDraftRef.current) commitTextDraftRef.current();
+        }, [touchUpTool, isCropMode]);
+
+        const clientToImagePixel = (clientX: number, clientY: number) => {
+            const container = previewContainerRef.current;
+            const layout = computeImageLayout();
+            if (!container || !layout) return null;
+            const rect = container.getBoundingClientRect();
+            const scale = layout.baseScale * (zoomRef.current || 1);
+            return {
+                x: Math.floor((clientX - rect.left - (offsetRef.current.x + layout.dx)) / scale),
+                y: Math.floor((clientY - rect.top - (offsetRef.current.y + layout.dy)) / scale),
+                scale,
+            };
+        };
+
+        const isInsideImage = (x: number, y: number) => {
+            const original = originalCanvasRef.current;
+            return !!original && x >= 0 && y >= 0 && x < original.width && y < original.height;
+        };
+
+        // Invalidate the adjustments cache so the next draw recomputes the
+        // processed canvas from the freshly edited original.
+        const invalidateProcessedCache = () => {
+            processedCanvasRef.current = null;
+            lastAdjSigRef.current = '';
+        };
+
+        // Stamps one stroke point into the CPU buffer (no canvas readbacks)
+        // and grows the pending dirty rect by the stamp's clamped bounding box.
+        const stampStrokePoint = (stroke: ActiveTouchStroke, x: number, y: number) => {
+            if (!stampSpansIntoSurface(stroke.buffer, x, y, stroke.spans, stroke.rgba)) return;
+            stroke.changed = true;
+
+            let x0 = x;
+            let x1 = x;
+            let y0 = y;
+            let y1 = y;
+            for (const span of stroke.spans) {
+                if (x + span.dx0 < x0) x0 = x + span.dx0;
+                if (x + span.dx1 > x1) x1 = x + span.dx1;
+                if (y + span.dy < y0) y0 = y + span.dy;
+                if (y + span.dy > y1) y1 = y + span.dy;
+            }
+            x0 = Math.max(0, x0);
+            y0 = Math.max(0, y0);
+            x1 = Math.min(stroke.buffer.width - 1, x1);
+            y1 = Math.min(stroke.buffer.height - 1, y1);
+            if (x1 < x0 || y1 < y0) return;
+
+            const dirty = stroke.dirty;
+            if (!dirty) {
+                stroke.dirty = { x0, y0, x1, y1 };
+            } else {
+                dirty.x0 = Math.min(dirty.x0, x0);
+                dirty.y0 = Math.min(dirty.y0, y0);
+                dirty.x1 = Math.max(dirty.x1, x1);
+                dirty.y1 = Math.max(dirty.y1, y1);
+            }
+        };
+
+        // Blits the pending buffer region onto the offscreen canvases.
+        // putImageData writes raw RGBA (including transparent pixels), which
+        // is exactly right for hard-edged edits; the processed canvas gets the
+        // same raw pixels so live feedback survives active adjustments, and a
+        // single recompute at commit time reconciles the adjusted view.
+        const blitStrokeDirty = (stroke: ActiveTouchStroke) => {
+            const dirty = stroke.dirty;
+            if (!dirty) return;
+            stroke.dirty = null;
+            const w = dirty.x1 - dirty.x0 + 1;
+            const h = dirty.y1 - dirty.y0 + 1;
+            for (const canvas of [originalCanvasRef.current, processedCanvasRef.current]) {
+                const ctx = canvas?.getContext('2d');
+                if (!ctx) continue;
+                ctx.putImageData(stroke.buffer, 0, 0, dirty.x0, dirty.y0, w, h);
+            }
+            requestDraw();
+        };
+
+        // Commits are serialized so rapid strokes land in history in order.
+        // Drawing never waits on a commit: the offscreen canvases stay the
+        // source of truth, and the imageSrc round trip is absorbed by the
+        // self-commit fast path in the image-loading effect.
+        const queueTouchUpCommit = () => {
+            const externalGeneration = externalImageGenerationRef.current;
+            touchUpCommitChainRef.current = touchUpCommitChainRef.current.then(async () => {
+                const original = originalCanvasRef.current;
+                const commitCallback = onTouchUpCommitRef.current;
+                if (!original || !commitCallback || !mountedRef.current) return;
+                // The image was replaced from outside (undo, quantize, …)
+                // after this edit was made — the edit is gone by design.
+                if (externalImageGenerationRef.current !== externalGeneration) return;
+
+                const blob = await new Promise<Blob | null>((resolve) =>
+                    original.toBlob((result) => resolve(result), 'image/png')
+                );
+                if (
+                    !mountedRef.current ||
+                    externalImageGenerationRef.current !== externalGeneration
+                ) {
+                    return;
+                }
+                if (blob) {
+                    const url = commitCallback(blob);
+                    if (typeof url === 'string') selfCommitSrcsRef.current.add(url);
+                } else {
+                    // Encoding failed — restore the canvases from the last
+                    // committed image so the preview matches the history.
+                    const img = imgRef.current;
+                    const octx = original.getContext('2d');
+                    if (img && octx) {
+                        octx.clearRect(0, 0, original.width, original.height);
+                        octx.imageSmoothingEnabled = false;
+                        octx.drawImage(img, 0, 0);
+                    }
+                }
+                // One recompute per commit keeps the adjusted preview exact
+                // without paying for it on every pointer move.
+                invalidateProcessedCache();
+                requestDraw();
+            });
+        };
+
+        // Rasterizes the draft box: canvas-measured word wrap at the draft
+        // width, hardened to the exact tool color, drawn at the box origin.
+        const commitTextDraft = () => {
+            const draft = textDraftRef.current;
+            setTextDraft(null);
+            if (!draft || !draft.text.trim()) return;
+            const rgb = parseHexColor(touchUpColor ?? '#000000');
+            if (!rgb) return;
+            const original = originalCanvasRef.current;
+            const octx = original?.getContext('2d');
+            if (!original || !octx) return;
+
+            const fontSize = touchUpFontSize;
+            const lineHeight = Math.round(fontSize * TEXT_DRAFT_LINE_HEIGHT);
+            const font = `bold ${fontSize}px sans-serif`;
+            const scratch = document.createElement('canvas');
+            const measureCtx = scratch.getContext('2d');
+            if (!measureCtx) return;
+            measureCtx.font = font;
+            const lines = wrapTextLines(draft.text, draft.width, (s) =>
+                measureCtx.measureText(s).width
+            );
+            scratch.width = Math.max(1, Math.ceil(draft.width) + 2);
+            scratch.height = Math.max(1, lines.length * lineHeight + 2);
+            const sctx = scratch.getContext('2d');
+            if (!sctx) return;
+            // Resizing the canvas reset the context state — set font again.
+            sctx.font = font;
+            sctx.textBaseline = 'top';
+            const baselinePad = Math.round((lineHeight - fontSize) / 2);
+            lines.forEach((line, index) => {
+                if (line) sctx.fillText(line, 1, 1 + index * lineHeight + baselinePad);
+            });
+            // Harden anti-aliased glyph edges to the exact target color so
+            // text does not leak blended colors into the palette.
+            const stamp = sctx.getImageData(0, 0, scratch.width, scratch.height);
+            hardenAlphaToColor(stamp.data, rgb);
+            sctx.putImageData(stamp, 0, 0);
+            for (const canvas of [originalCanvasRef.current, processedCanvasRef.current]) {
+                const ctx = canvas?.getContext('2d');
+                if (!ctx) continue;
+                ctx.imageSmoothingEnabled = false;
+                ctx.drawImage(scratch, draft.x - 1, draft.y - 1);
+            }
+            requestDraw();
+            queueTouchUpCommit();
+        };
+        commitTextDraftRef.current = commitTextDraft;
+
+        // Positions the draft box over its image-pixel rect. Applied outside
+        // React so panning and zooming keep the box glued to the image.
+        const syncTextDraftGeometry = () => {
+            const el = textDraftBoxRef.current;
+            const draft = textDraftRef.current;
+            if (!el || !draft) return;
+            const layout = computeImageLayout();
+            if (!layout) return;
+            const scale = layout.baseScale * (zoomRef.current || 1);
+            el.style.left = `${draft.x * scale + offsetRef.current.x + layout.dx}px`;
+            el.style.top = `${draft.y * scale + offsetRef.current.y + layout.dy}px`;
+            el.style.width = `${draft.width * scale}px`;
+            el.style.fontSize = `${touchUpFontSize * scale}px`;
+            const area = textDraftAreaRef.current;
+            if (area) {
+                // Grow the textarea to its wrapped content.
+                area.style.height = '0px';
+                area.style.height = `${Math.max(area.scrollHeight, touchUpFontSize * scale * TEXT_DRAFT_LINE_HEIGHT)}px`;
+            }
+        };
+        syncTextDraftGeometryRef.current = syncTextDraftGeometry;
+
+        useEffect(() => {
+            syncTextDraftGeometryRef.current();
+        });
+
+        // A freshly placed draft box grabs keyboard focus so typing starts
+        // immediately after the click.
+        useEffect(() => {
+            if (textDraft?.id) textDraftAreaRef.current?.focus();
+        }, [textDraft?.id]);
+
+        // Dragging the move handle repositions the box; dragging the right
+        // edge changes its wrap width. Both are in image-pixel space.
+        const startTextDraftDrag = (
+            e: React.PointerEvent,
+            mode: 'move' | 'resize'
+        ) => {
+            const draft = textDraftRef.current;
+            if (!draft || e.button !== 0) return;
+            e.preventDefault();
+            e.stopPropagation();
+            const startClientX = e.clientX;
+            const startClientY = e.clientY;
+            const start = { x: draft.x, y: draft.y, width: draft.width };
+            const original = originalCanvasRef.current;
+            const iw = original?.width ?? draft.width;
+            const ih = original?.height ?? 0;
+
+            const onMove = (ev: PointerEvent) => {
+                const layout = computeImageLayout();
+                if (!layout) return;
+                const scale = layout.baseScale * (zoomRef.current || 1);
+                const dxImg = (ev.clientX - startClientX) / scale;
+                const dyImg = (ev.clientY - startClientY) / scale;
+                setTextDraft((current) => {
+                    if (!current) return current;
+                    if (mode === 'move') {
+                        return {
+                            ...current,
+                            x: Math.round(
+                                Math.max(
+                                    -current.width + 8,
+                                    Math.min(iw - 8, start.x + dxImg)
+                                )
+                            ),
+                            y: Math.round(
+                                Math.max(
+                                    -touchUpFontSize,
+                                    Math.min(ih - 4, start.y + dyImg)
+                                )
+                            ),
+                        };
+                    }
+                    const minWidth = Math.max(16, touchUpFontSize * 2);
+                    return {
+                        ...current,
+                        width: Math.round(
+                            Math.max(minWidth, Math.min(iw, start.width + dxImg))
+                        ),
+                    };
+                });
+            };
+            const onUp = () => {
+                window.removeEventListener('pointermove', onMove);
+                window.removeEventListener('pointerup', onUp);
+            };
+            window.addEventListener('pointermove', onMove);
+            window.addEventListener('pointerup', onUp);
+        };
+
+        const onTouchUpPointerDown = (e: React.PointerEvent<HTMLDivElement>) => {
+            const tool = touchUpTool;
+            if (!tool || !touchUpActive || e.button !== 0) return;
+            const original = originalCanvasRef.current;
+            const octx = original?.getContext('2d');
+            if (!original || !octx) return;
+            const pt = clientToImagePixel(e.clientX, e.clientY);
+            if (!pt || !isInsideImage(pt.x, pt.y)) return;
+
+            e.preventDefault();
+
+            if (tool === 'brush' || tool === 'eraser') {
+                const rgb = tool === 'eraser' ? null : parseHexColor(touchUpColor ?? '#000000');
+                if (tool === 'brush' && !rgb) return;
+                // One readback per stroke: every stamp afterwards works on this
+                // CPU buffer and is blitted back with putImageData.
+                const stroke: ActiveTouchStroke = {
+                    pointerId: e.pointerId,
+                    lastPoint: { x: pt.x, y: pt.y },
+                    spans: brushSpans(touchUpBrushSize ?? 1),
+                    rgba: rgb ? [rgb[0], rgb[1], rgb[2], 255] : [0, 0, 0, 0],
+                    buffer: octx.getImageData(0, 0, original.width, original.height),
+                    changed: false,
+                    dirty: null,
+                };
+                stampStrokePoint(stroke, pt.x, pt.y);
+                blitStrokeDirty(stroke);
+                activeTouchStrokeRef.current = stroke;
+                e.currentTarget.setPointerCapture(e.pointerId);
+                return;
+            }
+
+            if (tool === 'picker') {
+                const pixel = octx.getImageData(pt.x, pt.y, 1, 1).data;
+                if (pixel[3] > 0) onTouchUpPickColor?.(rgbToHex(pixel[0], pixel[1], pixel[2]));
+                return;
+            }
+
+            if (tool === 'fill') {
+                const rgb = parseHexColor(touchUpColor ?? '#000000');
+                if (!rgb) return;
+                const surface = octx.getImageData(0, 0, original.width, original.height);
+                if (!floodFill(surface, pt.x, pt.y, [rgb[0], rgb[1], rgb[2], 255])) return;
+                octx.putImageData(surface, 0, 0);
+                const pctx = processedCanvasRef.current?.getContext('2d');
+                if (pctx) pctx.putImageData(surface, 0, 0);
+                requestDraw();
+                queueTouchUpCommit();
+                return;
+            }
+
+            if (tool === 'text') {
+                // Clicking outside an open draft commits it, then a fresh box
+                // opens at the click point and takes keyboard focus.
+                if (textDraftRef.current) commitTextDraft();
+                const iw = original.width;
+                const ih = original.height;
+                const minWidth = Math.max(16, touchUpFontSize * 2);
+                const width = Math.max(minWidth, Math.min(iw - pt.x, Math.round(iw * 0.4)));
+                setTextDraft({
+                    id: ++textDraftIdRef.current,
+                    x: Math.max(0, Math.min(iw - minWidth, pt.x)),
+                    y: Math.max(0, Math.min(ih - touchUpFontSize, pt.y)),
+                    width,
+                    text: '',
+                });
+            }
+        };
+
+        const onTouchUpPointerMove = (e: React.PointerEvent<HTMLDivElement>) => {
+            const stroke = activeTouchStrokeRef.current;
+            if (!stroke || stroke.pointerId !== e.pointerId) return;
+            e.preventDefault();
+
+            const pt = clientToImagePixel(e.clientX, e.clientY);
+            if (!pt) return;
+            // Points outside the image are stamped too (clipped per span) so a
+            // fast stroke across the image edge stays connected.
+            const points = stroke.lastPoint
+                ? strokeLinePoints(stroke.lastPoint.x, stroke.lastPoint.y, pt.x, pt.y)
+                : [[pt.x, pt.y] as [number, number]];
+            for (const [x, y] of points) stampStrokePoint(stroke, x, y);
+            stroke.lastPoint = { x: pt.x, y: pt.y };
+            blitStrokeDirty(stroke);
+        };
+
+        const finishTouchUpStroke = (e: React.PointerEvent<HTMLDivElement>) => {
+            const stroke = activeTouchStrokeRef.current;
+            if (!stroke || stroke.pointerId !== e.pointerId) return;
+
+            activeTouchStrokeRef.current = null;
+            if (e.currentTarget.hasPointerCapture(e.pointerId)) {
+                e.currentTarget.releasePointerCapture(e.pointerId);
+            }
+            blitStrokeDirty(stroke);
+            if (stroke.changed) queueTouchUpCommit();
+        };
+
+        // Size-accurate hover outline for brush/eraser, updated via direct DOM
+        // writes on pointermove to avoid re-rendering per pointer event.
+        const updateBrushOutline = (clientX: number, clientY: number) => {
+            const el = brushOutlineRef.current;
+            if (!el) return;
+            const pt = clientToImagePixel(clientX, clientY);
+            const layout = computeImageLayout();
+            if (!pt || !layout || !isInsideImage(pt.x, pt.y)) {
+                el.style.display = 'none';
+                return;
+            }
+            const size = Math.max(1, Math.floor(touchUpBrushSize ?? 1));
+            const originX = pt.x - Math.floor((size - 1) / 2);
+            const originY = pt.y - Math.floor((size - 1) / 2);
+            el.style.display = 'block';
+            el.style.left = `${originX * pt.scale + offsetRef.current.x + layout.dx}px`;
+            el.style.top = `${originY * pt.scale + offsetRef.current.y + layout.dy}px`;
+            el.style.width = `${size * pt.scale}px`;
+            el.style.height = `${size * pt.scale}px`;
+        };
+
+        const hideBrushOutline = () => {
+            const el = brushOutlineRef.current;
+            if (el) el.style.display = 'none';
+        };
+
         const startPan = (e: React.MouseEvent) => {
             // prevent browser's native drag behavior when dragging quickly
             e.preventDefault();
-            if (e.button !== 0) return;
+            if (e.button === 0 && touchUpActive) {
+                return;
+            }
+            // Middle-drag always pans, so the view stays movable with a tool active.
+            if (e.button !== 0 && e.button !== 1) return;
             panningRef.current = true;
             panStartXRef.current = e.clientX;
             panStartYRef.current = e.clientY;
@@ -406,6 +967,8 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
                     y: panStartOffsetRef.current.y + dy,
                 };
                 drawToCanvas();
+                // Keep the text draft box glued to the image while panning.
+                syncTextDraftGeometryRef.current();
             };
             const onUp = () => {
                 panningRef.current = false;
@@ -576,12 +1139,23 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
         }, [adjustmentsSig, requestDraw]);
 
         useEffect(() => {
+            mountedRef.current = true;
             return () => {
+                mountedRef.current = false;
+                imageLoadGenerationRef.current += 1;
+                externalImageGenerationRef.current += 1;
+                activeTouchStrokeRef.current = null;
+                originalCanvasRef.current = null;
+                processedCanvasRef.current = null;
                 if (drawRafRef.current !== null) {
                     cancelAnimationFrame(drawRafRef.current);
+                    // Reset so requestDraw works again after a StrictMode
+                    // remount; a stale id here permanently gates scheduling.
+                    drawRafRef.current = null;
                 }
                 if (selectionRafRef.current !== null) {
                     cancelAnimationFrame(selectionRafRef.current);
+                    selectionRafRef.current = null;
                 }
             };
         }, []);
@@ -662,7 +1236,9 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
                     outCanvas.toBlob((b) => resolve(b), 'image/png')
                 );
             },
-            exportAdjustedImageBlob: async (): Promise<Blob | null> => {
+            exportAdjustedImageBlob: async (
+                adjustmentsOverride?: Record<string, number>
+            ): Promise<Blob | null> => {
                 const img = imgRef.current;
                 if (!img) return null;
                 const iw = img.naturalWidth;
@@ -675,14 +1251,26 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
                 if (!ctx) return null;
                 ctx.imageSmoothingEnabled = false;
                 ctx.imageSmoothingQuality = 'low';
-                // Prefer processed canvas if exists, else original or image element
-                if (processedCanvasRef.current) {
-                    ctx.drawImage(processedCanvasRef.current, 0, 0, iw, ih);
-                } else if (originalCanvasRef.current) {
-                    ctx.drawImage(originalCanvasRef.current, 0, 0, iw, ih);
-                } else {
-                    ctx.drawImage(img, 0, 0, iw, ih);
+
+                let source = originalCanvasRef.current;
+                if (!source) {
+                    source = document.createElement('canvas');
+                    source.width = iw;
+                    source.height = ih;
+                    const sourceCtx = source.getContext('2d');
+                    if (!sourceCtx) return null;
+                    sourceCtx.imageSmoothingEnabled = false;
+                    sourceCtx.drawImage(img, 0, 0, iw, ih);
                 }
+                const sourceCtx = source.getContext('2d');
+                if (!sourceCtx) return null;
+                const sourceData = sourceCtx.getImageData(0, 0, iw, ih);
+                const values = adjustmentsOverride ?? adjustments ?? {};
+                ctx.putImageData(
+                    isAllDefault(values) ? sourceData : applyAdjustments(sourceData, values),
+                    0,
+                    0
+                );
                 return await new Promise<Blob | null>((resolve) =>
                     canvas.toBlob((b) => resolve(b), 'image/png')
                 );
@@ -693,18 +1281,116 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
             <div
                 ref={previewContainerRef}
                 className="w-full h-full relative overflow-hidden bg-background"
+                onPointerDown={onTouchUpPointerDown}
+                onPointerMove={(e) => {
+                    onTouchUpPointerMove(e);
+                    if (showBrushOutline) updateBrushOutline(e.clientX, e.clientY);
+                }}
+                onPointerUp={finishTouchUpStroke}
+                onPointerCancel={finishTouchUpStroke}
+                onPointerLeave={showBrushOutline ? hideBrushOutline : undefined}
                 onMouseDown={startPan}
                 onDragStart={(e) => e.preventDefault()}
-                style={
-                    showCheckerboard
+                style={{
+                    ...(showCheckerboard
                         ? {
                               background:
                                   'repeating-conic-gradient(rgba(255,255,255,0.1) 0% 25%, rgba(0,0,0,0.1) 0% 50%) 50% / 16px 16px',
                           }
-                        : undefined
-                }
+                        : null),
+                    ...(touchUpActive
+                        ? {
+                              cursor: touchUpTool === 'text' ? 'text' : 'crosshair',
+                              touchAction: 'none',
+                          }
+                        : null),
+                }}
             >
                 <canvas ref={canvasRef} style={{ imageRendering: 'pixelated' }} />
+                {showBrushOutline ? (
+                    <div
+                        ref={brushOutlineRef}
+                        className="absolute pointer-events-none rounded-full border border-white mix-blend-difference"
+                        style={{ display: 'none' }}
+                        aria-hidden
+                    />
+                ) : null}
+                {touchUpActive && touchUpTool === 'text' && textDraft ? (
+                    <div
+                        ref={textDraftBoxRef}
+                        className="absolute z-20"
+                        data-testid="touchup-text-draft"
+                        onPointerDown={(e) => e.stopPropagation()}
+                        onMouseDown={(e) => e.stopPropagation()}
+                    >
+                        <div className="absolute -top-8 left-0 flex items-center gap-0.5 rounded-md border border-border/40 bg-card p-0.5 shadow-md select-none">
+                            <button
+                                type="button"
+                                title="Drag to move the text"
+                                aria-label="Move text"
+                                onPointerDown={(e) => startTextDraftDrag(e, 'move')}
+                                className="h-6 w-6 flex items-center justify-center rounded cursor-move text-muted-foreground hover:bg-accent hover:text-foreground"
+                            >
+                                <Move className="w-3.5 h-3.5" />
+                            </button>
+                            <button
+                                type="button"
+                                title="Apply text (Ctrl+Enter)"
+                                aria-label="Apply text"
+                                data-testid="touchup-text-apply"
+                                onClick={commitTextDraft}
+                                className="h-6 w-6 flex items-center justify-center rounded cursor-pointer text-primary hover:bg-accent"
+                            >
+                                <Check className="w-3.5 h-3.5" />
+                            </button>
+                            <button
+                                type="button"
+                                title="Discard text (Esc)"
+                                aria-label="Discard text"
+                                onClick={() => setTextDraft(null)}
+                                className="h-6 w-6 flex items-center justify-center rounded cursor-pointer text-muted-foreground hover:bg-accent hover:text-destructive"
+                            >
+                                <X className="w-3.5 h-3.5" />
+                            </button>
+                        </div>
+                        <textarea
+                            ref={textDraftAreaRef}
+                            value={textDraft.text}
+                            onChange={(e) => {
+                                const value = e.target.value;
+                                setTextDraft((current) =>
+                                    current ? { ...current, text: value } : current
+                                );
+                            }}
+                            onKeyDown={(e) => {
+                                if (e.key === 'Enter' && (e.ctrlKey || e.metaKey)) {
+                                    e.preventDefault();
+                                    commitTextDraft();
+                                }
+                            }}
+                            placeholder="Type…"
+                            aria-label="Text to place on the image"
+                            spellCheck={false}
+                            className="block w-full resize-none overflow-hidden bg-transparent outline-none border border-dashed border-white/80 mix-blend-normal placeholder:text-white/40"
+                            style={{
+                                color: touchUpColor,
+                                fontFamily: 'sans-serif',
+                                fontWeight: 700,
+                                lineHeight: TEXT_DRAFT_LINE_HEIGHT,
+                                padding: 0,
+                                whiteSpace: 'pre-wrap',
+                                wordBreak: 'break-word',
+                                caretColor: 'white',
+                            }}
+                        />
+                        <div
+                            title="Drag to change the wrap width"
+                            aria-label="Resize text box"
+                            onPointerDown={(e) => startTextDraftDrag(e, 'resize')}
+                            className="absolute top-0 -right-1.5 h-full w-1.5 cursor-ew-resize rounded bg-primary/70 hover:bg-primary"
+                        />
+                    </div>
+                ) : null}
                 {/* small HUD showing image size and crop size (when active) */}
                 {imageLoaded && imgRef.current ? (
                     <div
@@ -713,8 +1399,8 @@ const CanvasPreview = forwardRef<CanvasPreviewHandle, Props>(
                     >
                         {(() => {
                             const img = imgRef.current!;
-                            const iw = img.naturalWidth;
-                            const ih = img.naturalHeight;
+                            const iw = originalCanvasRef.current?.width || img.naturalWidth;
+                            const ih = originalCanvasRef.current?.height || img.naturalHeight;
                             let text = `Image: ${iw}×${ih}`;
                             if (isCropMode && selection) {
                                 const layout = computeImageLayout();
diff --git a/src/components/PreviewActions.tsx b/src/components/PreviewActions.tsx
index 5726298..d34d72e 100644
--- a/src/components/PreviewActions.tsx
+++ b/src/components/PreviewActions.tsx
@@ -1,7 +1,10 @@
 import React from 'react';
+import { HexColorPicker } from 'react-colorful';
 import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { Slider } from '@/components/ui/slider';
 import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
-import type { PreviewColorMode, PreviewRenderMode } from '@/types';
+import type { PreviewColorMode, PreviewRenderMode, TouchUpTool } from '@/types';
 import {
     RotateCcw,
     RotateCw,
@@ -21,6 +24,11 @@ import {
     Eye,
     Blend,
     Layers,
+    Brush,
+    Eraser,
+    PaintBucket,
+    Pipette,
+    Type,
 } from 'lucide-react';
 
 export interface PreviewActionsProps {
@@ -53,6 +61,17 @@ export interface PreviewActionsProps {
     autoPaintEnabled?: boolean;
     previewColorMode?: PreviewColorMode;
     onPreviewColorModeChange?: (mode: PreviewColorMode) => void;
+    /** 2D touch-up tools shown alongside crop while in 2D mode */
+    touchUpTool?: TouchUpTool | null;
+    onTouchUpToolChange?: (tool: TouchUpTool | null) => void;
+    touchUpColor?: string;
+    onTouchUpColorChange?: (hex: string) => void;
+    touchUpBrushSize?: number;
+    onTouchUpBrushSizeChange?: (size: number) => void;
+    touchUpTextSize?: number;
+    onTouchUpTextSizeChange?: (size: number) => void;
+    /** Current image palette for palette-aware color selection */
+    paletteColors?: string[];
 }
 
 export const PreviewActions: React.FC<PreviewActionsProps> = ({
@@ -83,8 +102,23 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
     autoPaintEnabled = false,
     previewColorMode = 'simulated',
     onPreviewColorModeChange,
+    touchUpTool = null,
+    onTouchUpToolChange,
+    touchUpColor = '#000000',
+    onTouchUpColorChange,
+    touchUpBrushSize = 4,
+    onTouchUpBrushSizeChange,
+    touchUpTextSize = 24,
+    onTouchUpTextSizeChange,
+    paletteColors = [],
 }) => {
     const [previewModeMenuOpen, setPreviewModeMenuOpen] = React.useState(false);
+    // Local color while the picker popover is open: react-colorful fires
+    // onChange continuously during drags, and pushing every sample into app
+    // state re-renders the whole app. The chosen color is committed on close.
+    const [colorPopoverOpen, setColorPopoverOpen] = React.useState(false);
+    const [draftColor, setDraftColor] = React.useState(touchUpColor);
+    const shownTouchUpColor = colorPopoverOpen ? draftColor : touchUpColor;
     const PreviewModeIcon =
         previewRenderMode === 'wireframe'
             ? Grid3x3
@@ -106,9 +140,34 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
         { value: 'transparent', label: 'Transparent', icon: <Eye className="w-4 h-4" /> },
         { value: 'wireframe', label: 'Wireframe', icon: <Grid3x3 className="w-4 h-4" /> },
     ];
+    const touchUpToolOptions: Array<{
+        value: TouchUpTool;
+        label: string;
+        icon: React.ReactNode;
+    }> = [
+        { value: 'brush', label: 'Brush', icon: <Brush className="w-4 h-4" /> },
+        { value: 'eraser', label: 'Eraser', icon: <Eraser className="w-4 h-4" /> },
+        { value: 'fill', label: 'Fill', icon: <PaintBucket className="w-4 h-4" /> },
+        { value: 'text', label: 'Text', icon: <Type className="w-4 h-4" /> },
+        { value: 'picker', label: 'Pick color from image', icon: <Pipette className="w-4 h-4" /> },
+    ];
+    const showTouchUpTools = mode === '2d' && !isCropMode && !!onTouchUpToolChange;
+    const touchUpColorRelevant =
+        touchUpTool === 'brush' ||
+        touchUpTool === 'fill' ||
+        touchUpTool === 'text' ||
+        touchUpTool === 'picker';
+    // Every tool's options row reads the same left-to-right: chip, size, hint.
+    const touchUpHints: Record<TouchUpTool, string> = {
+        brush: 'Drag over the image to paint',
+        eraser: 'Drag over the image to erase',
+        fill: 'Click a color region to fill it',
+        text: 'Click the image and start typing',
+        picker: 'Click the image to pick a color',
+    };
 
     return (
-        <div className="absolute top-4 right-4 flex flex-wrap gap-2 z-[60]">
+        <div className="absolute top-4 right-4 flex flex-wrap justify-end gap-2 z-[60]">
             {mode === '3d' && onPreviewRenderModeChange && (
                 <Popover open={previewModeMenuOpen} onOpenChange={setPreviewModeMenuOpen}>
                     <PopoverTrigger asChild>
@@ -192,8 +251,12 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
             {mode === '3d' && onToggleCamera && (
                 <Button
                     size="icon"
-                    title={isOrtho ? 'Switch to perspective camera' : 'Switch to orthographic camera'}
-                    aria-label={isOrtho ? 'Switch to perspective camera' : 'Switch to orthographic camera'}
+                    title={
+                        isOrtho ? 'Switch to perspective camera' : 'Switch to orthographic camera'
+                    }
+                    aria-label={
+                        isOrtho ? 'Switch to perspective camera' : 'Switch to orthographic camera'
+                    }
                     onClick={onToggleCamera}
                     className="bg-primary hover:bg-primary/80 text-primary-foreground"
                 >
@@ -221,6 +284,30 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
                 <RotateCw className="w-4 h-4" />
             </Button>
 
+            {showTouchUpTools &&
+                touchUpToolOptions.map(({ value, label, icon }) => {
+                    const active = touchUpTool === value;
+                    return (
+                        <Button
+                            key={value}
+                            size="icon"
+                            title={label}
+                            aria-label={label}
+                            aria-pressed={active}
+                            data-testid={`touchup-tool-${value}`}
+                            disabled={!imageAvailable}
+                            onClick={() => onTouchUpToolChange?.(active ? null : value)}
+                            className={
+                                'bg-primary hover:bg-primary/80 text-primary-foreground disabled:opacity-50 disabled:cursor-not-allowed' +
+                                (active
+                                    ? ' ring-2 ring-ring ring-offset-2 ring-offset-background'
+                                    : '')
+                            }
+                        >
+                            {icon}
+                        </Button>
+                    );
+                })}
             {mode === '2d' &&
                 (!isCropMode ? (
                     <Button
@@ -336,7 +423,7 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
                         title="Choose file"
                         aria-label="Choose file"
                         onClick={onPickFile}
-                        className="bg-primary hover:bg-primary/80 text-primary-foreground"
+                        className="bg-primary hover:bg-primary/80 text-primary-foreground disabled:opacity-50 disabled:cursor-not-allowed"
                     >
                         <Upload className="w-4 h-4" />
                     </Button>
@@ -352,6 +439,129 @@ export const PreviewActions: React.FC<PreviewActionsProps> = ({
                     </Button>
                 </>
             )}
+            {showTouchUpTools && touchUpTool && imageAvailable && (
+                <div className="w-full flex justify-end">
+                    <div
+                        className="flex items-center gap-2 p-2 rounded-md border border-border/40 bg-card shadow-md"
+                        data-testid="touchup-options"
+                    >
+                        {touchUpColorRelevant && onTouchUpColorChange && (
+                            <Popover
+                                open={colorPopoverOpen}
+                                onOpenChange={(open) => {
+                                    setColorPopoverOpen(open);
+                                    if (open) {
+                                        setDraftColor(touchUpColor);
+                                    } else if (draftColor !== touchUpColor) {
+                                        onTouchUpColorChange(draftColor);
+                                    }
+                                }}
+                            >
+                                <PopoverTrigger asChild>
+                                    <button
+                                        type="button"
+                                        title="Change tool color"
+                                        aria-label="Change tool color"
+                                        data-testid="touchup-color-chip"
+                                        className="w-8 h-8 rounded-full border-2 border-border shadow-sm flex-shrink-0 focus:outline-none focus:ring-2 focus:ring-primary/20 transition-transform hover:scale-105 cursor-pointer"
+                                        style={{ backgroundColor: shownTouchUpColor }}
+                                    />
+                                </PopoverTrigger>
+                                <PopoverContent
+                                    className="w-auto p-3"
+                                    align="end"
+                                    onEscapeKeyDown={(e) => e.stopPropagation()}
+                                >
+                                    <div className="space-y-3">
+                                        <h4 className="font-medium text-sm">Pick Color</h4>
+                                        <HexColorPicker
+                                            color={draftColor}
+                                            onChange={setDraftColor}
+                                        />
+                                        {paletteColors.length > 0 && (
+                                            <div className="space-y-1.5">
+                                                <span className="text-xs text-muted-foreground">
+                                                    Image colors
+                                                </span>
+                                                <div className="grid grid-cols-8 gap-1.5 max-h-24 overflow-y-auto pr-1">
+                                                    {paletteColors.map((hex) => (
+                                                        <button
+                                                            key={hex}
+                                                            type="button"
+                                                            title={hex}
+                                                            aria-label={`Use color ${hex}`}
+                                                            onClick={() => setDraftColor(hex)}
+                                                            className="w-5 h-5 rounded-full border border-border shadow-sm cursor-pointer transition-transform hover:scale-110"
+                                                            style={{ backgroundColor: hex }}
+                                                        />
+                                                    ))}
+                                                </div>
+                                            </div>
+                                        )}
+                                        <div className="flex gap-2 items-center">
+                                            <span className="text-xs text-muted-foreground">
+                                                Hex
+                                            </span>
+                                            <Input
+                                                value={draftColor}
+                                                onChange={(e) => setDraftColor(e.target.value)}
+                                                className="h-7 text-xs font-mono"
+                                            />
+                                        </div>
+                                    </div>
+                                </PopoverContent>
+                            </Popover>
+                        )}
+                        {touchUpTool === 'eraser' && (
+                            <div
+                                title="The eraser paints transparent pixels"
+                                aria-label="Eraser color: transparent"
+                                className="w-8 h-8 rounded-full border-2 border-border shadow-sm flex-shrink-0"
+                                style={{
+                                    background:
+                                        'repeating-conic-gradient(rgba(255,255,255,0.35) 0% 25%, rgba(90,90,90,0.35) 0% 50%) 50% / 10px 10px',
+                                }}
+                            />
+                        )}
+                        {(touchUpTool === 'brush' || touchUpTool === 'eraser') &&
+                            onTouchUpBrushSizeChange && (
+                                <>
+                                    <Slider
+                                        value={[touchUpBrushSize]}
+                                        min={1}
+                                        max={64}
+                                        step={1}
+                                        onValueChange={([v]) => onTouchUpBrushSizeChange(v)}
+                                        aria-label="Brush size"
+                                        className="w-28 cursor-pointer"
+                                    />
+                                    <div className="flex-shrink-0 px-2.5 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold whitespace-nowrap">
+                                        {touchUpBrushSize} px
+                                    </div>
+                                </>
+                            )}
+                        {touchUpTool === 'text' && onTouchUpTextSizeChange && (
+                            <>
+                                <Slider
+                                    value={[touchUpTextSize]}
+                                    min={6}
+                                    max={128}
+                                    step={1}
+                                    onValueChange={([v]) => onTouchUpTextSizeChange(v)}
+                                    aria-label="Text size"
+                                    className="w-28 cursor-pointer"
+                                />
+                                <div className="flex-shrink-0 px-2.5 py-1 rounded-full bg-primary/10 text-primary text-xs font-mono font-semibold whitespace-nowrap">
+                                    {touchUpTextSize} px
+                                </div>
+                            </>
+                        )}
+                        <span className="text-xs text-muted-foreground whitespace-nowrap">
+                            {touchUpHints[touchUpTool]}
+                        </span>
+                    </div>
+                </div>
+            )}
         </div>
     );
 };
diff --git a/src/docs/loading-images.md b/src/docs/loading-images.md
index 6b2ba7b..7caebbf 100644
--- a/src/docs/loading-images.md
+++ b/src/docs/loading-images.md
@@ -29,6 +29,14 @@ Click **Crop** to enter crop mode. Drag the crop rectangle or its handles, then
 
 Cropping is useful before color reduction because it removes background areas that would otherwise influence the palette.
 
+## Touch Up Pixels
+
+The 2D preview toolbar includes five hard-edged tools for direct pixel editing. All edits are palette-safe: they use exact colors without blending, so no stray gradient pixels sneak into your palette. **Brush** paints with the selected color, **Eraser** makes pixels transparent, and **Fill** replaces a contiguous region of one exact color. **Text** creates bold, hard-edged lettering: click the image and type directly in an on-canvas text box that appears at that spot. The **color picker** lets you sample a color directly from the image and switches to Brush.
+
+Set the Brush and Eraser size with a slider (1–64 image pixels), with a size-accurate cursor outline to guide you. For Text, the text box supports multiple lines (press Enter) and word-wraps at its width—drag the handle on its right edge to adjust the wrap width, and drag the move handle (arrows icon) above the box to reposition it. The size slider and color control update your text draft live. Apply your text with the check button or Ctrl+Enter, or discard it with the X button or Escape; clicking elsewhere on the image or switching tools also applies the current text. Choose your color from the current image palette, use a custom color input, or use the color picker tool to sample from the image.
+
+Each completed stroke, fill, or text placement is exactly one **Undo** or **Redo** step. Drawing is live and never blocks the app. Press **Escape** to leave the active tool; while editing, middle-drag still pans and the mouse wheel still zooms. Image adjustments remain non-destructive: touch-up edits apply to the underlying source, and the active adjustments reapply on top.
+
 ## Resize The Image
 
 Use **Resize Image** to reduce the source image resolution by percentage. This changes the actual pixel dimensions of the current image, so a 1000x800 image resized to 50% becomes 500x400 pixels.
diff --git a/src/lib/touchup.ts b/src/lib/touchup.ts
new file mode 100644
index 0000000..c44bdcc
--- /dev/null
+++ b/src/lib/touchup.ts
@@ -0,0 +1,318 @@
+/**
+ * Hard-edged pixel algorithms for the 2D touch-up tools (brush, eraser, fill,
+ * text). Every tool is deliberately aliased: the 2D image is usually quantized
+ * to a small palette, and anti-aliased edges would leak blended colors into
+ * the palette that then flow into color slicing and the 3D model.
+ */
+
+/** A canvas-free view of RGBA pixel data (structurally matches ImageData). */
+export interface PixelSurface {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+
+/**
+ * One horizontal run of a brush stamp, relative to the cursor pixel:
+ * paint columns `dx0..dx1` (inclusive) on row `dy`.
+ */
+export interface BrushSpan {
+    dy: number;
+    dx0: number;
+    dx1: number;
+}
+
+/** A brush span clipped and positioned within an image. */
+export interface PositionedBrushSpan {
+    y: number;
+    x0: number;
+    x1: number;
+}
+
+/** Parses a six-digit brush color into RGB channels. */
+export function parseHexColor(hex: string): [number, number, number] | null {
+    const match = /^#?([0-9a-f]{6})$/i.exec(hex);
+    if (!match) return null;
+    const value = Number.parseInt(match[1], 16);
+    return [(value >> 16) & 0xff, (value >> 8) & 0xff, value & 0xff];
+}
+
+/**
+ * Hard-edged circular brush footprint for a given diameter in image pixels.
+ * A pixel is included when its center lies inside the circle of radius
+ * `size / 2` centered on the stamp box, so size 1 is a single pixel, size 2 a
+ * 2x2 square, and larger sizes progressively rounder aliased discs.
+ */
+export function brushSpans(size: number): BrushSpan[] {
+    const s = Math.max(1, Math.floor(size));
+    const offset = Math.floor((s - 1) / 2);
+    const center = (s - 1) / 2;
+    const radiusSq = (s / 2) ** 2;
+    const spans: BrushSpan[] = [];
+
+    for (let j = 0; j < s; j++) {
+        let first = -1;
+        let last = -1;
+        for (let i = 0; i < s; i++) {
+            const distSq = (i - center) ** 2 + (j - center) ** 2;
+            if (distSq > radiusSq) continue;
+            if (first === -1) first = i;
+            last = i;
+        }
+        if (first === -1) continue;
+        spans.push({ dy: j - offset, dx0: first - offset, dx1: last - offset });
+    }
+
+    return spans;
+}
+
+/** Positions a brush footprint and clips every span to the image bounds. */
+export function clipBrushSpans(
+    spans: readonly BrushSpan[],
+    centerX: number,
+    centerY: number,
+    width: number,
+    height: number
+): PositionedBrushSpan[] {
+    if (width <= 0 || height <= 0) return [];
+
+    const clipped: PositionedBrushSpan[] = [];
+    for (const span of spans) {
+        const y = centerY + span.dy;
+        if (y < 0 || y >= height) continue;
+
+        const x0 = Math.max(0, centerX + span.dx0);
+        const x1 = Math.min(width - 1, centerX + span.dx1);
+        if (x0 <= x1) clipped.push({ y, x0, x1 });
+    }
+    return clipped;
+}
+
+/**
+ * Stamps a brush footprint into a CPU-side pixel buffer. An alpha of 0 writes
+ * the canonical transparent pixel (0,0,0,0) used across the app. Returns true
+ * when any pixel actually changed, so no-op strokes (painting a color onto
+ * itself) can skip creating a history entry — without any canvas readbacks.
+ */
+export function stampSpansIntoSurface(
+    surface: PixelSurface,
+    centerX: number,
+    centerY: number,
+    spans: readonly BrushSpan[],
+    rgba: [number, number, number, number]
+): boolean {
+    const { data, width, height } = surface;
+    const [r, g, b, a] = rgba[3] === 0 ? [0, 0, 0, 0] : rgba;
+    let changed = false;
+
+    for (const span of clipBrushSpans(spans, centerX, centerY, width, height)) {
+        let idx = (span.y * width + span.x0) * 4;
+        for (let x = span.x0; x <= span.x1; x++, idx += 4) {
+            if (
+                data[idx] !== r ||
+                data[idx + 1] !== g ||
+                data[idx + 2] !== b ||
+                data[idx + 3] !== a
+            ) {
+                data[idx] = r;
+                data[idx + 1] = g;
+                data[idx + 2] = b;
+                data[idx + 3] = a;
+                changed = true;
+            }
+        }
+    }
+
+    return changed;
+}
+
+/**
+ * Scanline flood fill, 4-connected, matching the seed pixel's exact RGBA.
+ * A fill alpha of 0 writes the canonical transparent pixel (0,0,0,0). Returns
+ * false without touching pixels when the seed is out of bounds or already has
+ * the fill color.
+ */
+export function floodFill(
+    surface: PixelSurface,
+    x: number,
+    y: number,
+    fill: [number, number, number, number]
+): boolean {
+    const { data, width, height } = surface;
+    if (x < 0 || y < 0 || x >= width || y >= height) return false;
+
+    const seedIdx = (y * width + x) * 4;
+    const sr = data[seedIdx];
+    const sg = data[seedIdx + 1];
+    const sb = data[seedIdx + 2];
+    const sa = data[seedIdx + 3];
+    const [fr, fg, fb, fa] = fill[3] === 0 ? [0, 0, 0, 0] : fill;
+    if (sr === fr && sg === fg && sb === fb && sa === fa) return false;
+
+    const matches = (idx: number) =>
+        data[idx] === sr && data[idx + 1] === sg && data[idx + 2] === sb && data[idx + 3] === sa;
+
+    const stack: number[] = [x, y];
+    while (stack.length > 0) {
+        const sy = stack.pop() as number;
+        let sx = stack.pop() as number;
+        let idx = (sy * width + sx) * 4;
+
+        // Walk to the left edge of this run of seed-colored pixels.
+        while (sx > 0 && matches(idx - 4)) {
+            sx--;
+            idx -= 4;
+        }
+
+        let spanAbove = false;
+        let spanBelow = false;
+        while (sx < width && matches(idx)) {
+            data[idx] = fr;
+            data[idx + 1] = fg;
+            data[idx + 2] = fb;
+            data[idx + 3] = fa;
+
+            if (sy > 0) {
+                const above = matches(idx - width * 4);
+                if (above && !spanAbove) {
+                    stack.push(sx, sy - 1);
+                    spanAbove = true;
+                } else if (!above) {
+                    spanAbove = false;
+                }
+            }
+            if (sy < height - 1) {
+                const below = matches(idx + width * 4);
+                if (below && !spanBelow) {
+                    stack.push(sx, sy + 1);
+                    spanBelow = true;
+                } else if (!below) {
+                    spanBelow = false;
+                }
+            }
+
+            sx++;
+            idx += 4;
+        }
+    }
+
+    return true;
+}
+
+/** Alpha cutoff above which a rendered text pixel is kept as fully opaque. */
+export const TEXT_ALPHA_THRESHOLD = 128;
+
+/**
+ * Hardens anti-aliased RGBA pixels (e.g. rendered text) into exactly two
+ * values: the given opaque color where alpha reaches the threshold, and the
+ * canonical transparent pixel (0,0,0,0) everywhere else.
+ */
+export function hardenAlphaToColor(data: Uint8ClampedArray, rgb: [number, number, number]): void {
+    for (let i = 0; i < data.length; i += 4) {
+        if (data[i + 3] >= TEXT_ALPHA_THRESHOLD) {
+            data[i] = rgb[0];
+            data[i + 1] = rgb[1];
+            data[i + 2] = rgb[2];
+            data[i + 3] = 255;
+        } else {
+            data[i] = 0;
+            data[i + 1] = 0;
+            data[i + 2] = 0;
+            data[i + 3] = 0;
+        }
+    }
+}
+
+/**
+ * Greedy word wrap matching a `white-space: pre-wrap; word-break: break-word`
+ * text box: explicit newlines are kept, lines break at spaces when the next
+ * word would overflow `maxWidth`, and a single word wider than the box is
+ * broken mid-word. `measure` returns the rendered width of a string, so the
+ * committed canvas text wraps like the on-screen draft box it previews.
+ */
+export function wrapTextLines(
+    text: string,
+    maxWidth: number,
+    measure: (s: string) => number
+): string[] {
+    const lines: string[] = [];
+
+    const pushBrokenWord = (word: string): string => {
+        // Break an over-wide word into full-width chunks; the remainder
+        // becomes the start of the current line.
+        let chunk = '';
+        for (const char of word) {
+            if (chunk && measure(chunk + char) > maxWidth) {
+                lines.push(chunk);
+                chunk = char;
+            } else {
+                chunk += char;
+            }
+        }
+        return chunk;
+    };
+
+    for (const paragraph of text.split('\n')) {
+        let current = '';
+        for (const word of paragraph.split(' ')) {
+            const candidate = current ? `${current} ${word}` : word;
+            if (measure(candidate) <= maxWidth) {
+                current = candidate;
+                continue;
+            }
+            if (current) {
+                lines.push(current);
+                current = '';
+            }
+            current = measure(word) > maxWidth ? pushBrokenWord(word) : word;
+        }
+        lines.push(current);
+    }
+
+    return lines;
+}
+
+/** Formats RGB channels as a lowercase `#rrggbb` string. */
+export function rgbToHex(r: number, g: number, b: number): string {
+    const channel = (v: number) =>
+        Math.max(0, Math.min(255, Math.round(v)))
+            .toString(16)
+            .padStart(2, '0');
+    return `#${channel(r)}${channel(g)}${channel(b)}`;
+}
+
+/**
+ * Integer points of a stroke segment (Bresenham), inclusive of both
+ * endpoints, so stamping every point leaves no gaps between pointer samples.
+ */
+export function strokeLinePoints(
+    x0: number,
+    y0: number,
+    x1: number,
+    y1: number
+): Array<[number, number]> {
+    const points: Array<[number, number]> = [];
+    const dx = Math.abs(x1 - x0);
+    const dy = -Math.abs(y1 - y0);
+    const sx = x0 < x1 ? 1 : -1;
+    const sy = y0 < y1 ? 1 : -1;
+    let err = dx + dy;
+    let x = x0;
+    let y = y0;
+
+    for (;;) {
+        points.push([x, y]);
+        if (x === x1 && y === y1) break;
+        const e2 = 2 * err;
+        if (e2 >= dy) {
+            err += dy;
+            x += sx;
+        }
+        if (e2 <= dx) {
+            err += dx;
+            y += sy;
+        }
+    }
+
+    return points;
+}
diff --git a/src/types/index.ts b/src/types/index.ts
index e0d9ed0..33c78f9 100644
--- a/src/types/index.ts
+++ b/src/types/index.ts
@@ -17,6 +17,13 @@ export type PreviewRenderMode = 'shaded' | 'transparent' | 'wireframe';
  */
 export type PreviewColorMode = 'simulated' | 'physical';
 
+/**
+ * 2D touch-up tool active in the preview toolbar. Every tool edits the
+ * unadjusted source image and commits through the shared image history, so
+ * undo/redo treats each stroke, fill, or text stamp as one edit.
+ */
+export type TouchUpTool = 'brush' | 'eraser' | 'fill' | 'text' | 'picker';
+
 export type Swatch = {
     hex: string;
     a: number;
diff --git a/tests/touchup.test.ts b/tests/touchup.test.ts
new file mode 100644
index 0000000..12ef881
--- /dev/null
+++ b/tests/touchup.test.ts
@@ -0,0 +1,293 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {
+    brushSpans,
+    clipBrushSpans,
+    floodFill,
+    hardenAlphaToColor,
+    parseHexColor,
+    rgbToHex,
+    stampSpansIntoSurface,
+    strokeLinePoints,
+    TEXT_ALPHA_THRESHOLD,
+    wrapTextLines,
+    type PixelSurface,
+} from '../src/lib/touchup.ts';
+
+/** 10px per character, like a monospace font. */
+const measure10 = (s: string) => s.length * 10;
+
+type Rgba = [number, number, number, number];
+
+function makeSurface(width: number, height: number, fill: Rgba = [0, 0, 0, 0]): PixelSurface {
+    const data = new Uint8ClampedArray(width * height * 4);
+    for (let i = 0; i < data.length; i += 4) {
+        data[i] = fill[0];
+        data[i + 1] = fill[1];
+        data[i + 2] = fill[2];
+        data[i + 3] = fill[3];
+    }
+    return { data, width, height };
+}
+
+function setPx(surface: PixelSurface, x: number, y: number, rgba: Rgba): void {
+    surface.data.set(rgba, (y * surface.width + x) * 4);
+}
+
+function getPx(surface: PixelSurface, x: number, y: number): Rgba {
+    const i = (y * surface.width + x) * 4;
+    return [surface.data[i], surface.data[i + 1], surface.data[i + 2], surface.data[i + 3]];
+}
+
+const RED: Rgba = [255, 0, 0, 255];
+const GREEN: Rgba = [0, 255, 0, 255];
+const BLUE: Rgba = [0, 0, 255, 255];
+
+test('brush colors parse only complete six-digit hex values', () => {
+    assert.deepEqual(parseHexColor('#3050c0'), [0x30, 0x50, 0xc0]);
+    assert.deepEqual(parseHexColor('FF8800'), [0xff, 0x88, 0x00]);
+    assert.equal(parseHexColor('#fff'), null);
+    assert.equal(parseHexColor('#zzzzzz'), null);
+});
+
+test('brush size 1 stamps exactly the cursor pixel', () => {
+    assert.deepEqual(brushSpans(1), [{ dy: 0, dx0: 0, dx1: 0 }]);
+});
+
+test('brush size 2 stamps a 2x2 square anchored at the cursor pixel', () => {
+    assert.deepEqual(brushSpans(2), [
+        { dy: 0, dx0: 0, dx1: 1 },
+        { dy: 1, dx0: 0, dx1: 1 },
+    ]);
+});
+
+test('brush size 4 is a hard-edged disc with cut corners', () => {
+    const spans = brushSpans(4);
+    const pixels = spans.reduce((sum, span) => sum + (span.dx1 - span.dx0 + 1), 0);
+    assert.equal(pixels, 12);
+    assert.deepEqual(
+        spans.find((span) => span.dy === -1),
+        { dy: -1, dx0: 0, dx1: 1 }
+    );
+    assert.deepEqual(
+        spans.find((span) => span.dy === 0),
+        { dy: 0, dx0: -1, dx1: 2 }
+    );
+});
+
+test('odd brush sizes are symmetric around the cursor pixel', () => {
+    for (const size of [3, 5, 9]) {
+        const spans = brushSpans(size);
+        for (const span of spans) {
+            assert.equal(span.dx0, -span.dx1, `size ${size} row ${span.dy}`);
+            const mirrored = spans.find((candidate) => candidate.dy === -span.dy);
+            assert.ok(mirrored, `size ${size} row ${span.dy} has mirror`);
+            assert.equal(mirrored.dx0, span.dx0);
+            assert.equal(mirrored.dx1, span.dx1);
+        }
+    }
+});
+
+test('non-positive and fractional brush sizes clamp to whole pixels', () => {
+    assert.deepEqual(brushSpans(0), brushSpans(1));
+    assert.deepEqual(brushSpans(-3), brushSpans(1));
+    assert.deepEqual(brushSpans(2.9), brushSpans(2));
+});
+
+test('brush spans clip cleanly at image edges', () => {
+    assert.deepEqual(clipBrushSpans(brushSpans(3), 0, 0, 4, 4), [
+        { y: 0, x0: 0, x1: 1 },
+        { y: 1, x0: 0, x1: 1 },
+    ]);
+});
+
+test('brush spans outside the image produce no writes', () => {
+    const stamp = brushSpans(3);
+    assert.deepEqual(clipBrushSpans(stamp, -3, 2, 4, 4), []);
+    assert.deepEqual(clipBrushSpans(stamp, 2, 5, 4, 4), []);
+    assert.deepEqual(clipBrushSpans(stamp, 0, 0, 0, 4), []);
+});
+
+test('stroke line points include both endpoints and leave no gaps', () => {
+    assert.deepEqual(strokeLinePoints(0, 0, 3, 0), [
+        [0, 0],
+        [1, 0],
+        [2, 0],
+        [3, 0],
+    ]);
+    assert.deepEqual(strokeLinePoints(0, 0, 3, 3), [
+        [0, 0],
+        [1, 1],
+        [2, 2],
+        [3, 3],
+    ]);
+
+    const points = strokeLinePoints(0, 0, 7, 3);
+    assert.deepEqual(points[0], [0, 0]);
+    assert.deepEqual(points[points.length - 1], [7, 3]);
+    for (let index = 1; index < points.length; index++) {
+        assert.ok(Math.abs(points[index][0] - points[index - 1][0]) <= 1);
+        assert.ok(Math.abs(points[index][1] - points[index - 1][1]) <= 1);
+    }
+});
+
+test('single-point stroke yields exactly one point', () => {
+    assert.deepEqual(strokeLinePoints(5, 5, 5, 5), [[5, 5]]);
+});
+
+test('stamping writes the brush color and reports the change', () => {
+    const surface = makeSurface(4, 4, RED);
+    assert.equal(stampSpansIntoSurface(surface, 1, 1, brushSpans(2), BLUE), true);
+    assert.deepEqual(getPx(surface, 1, 1), BLUE);
+    assert.deepEqual(getPx(surface, 2, 2), BLUE);
+    assert.deepEqual(getPx(surface, 0, 0), RED);
+    assert.deepEqual(getPx(surface, 3, 3), RED);
+});
+
+test('stamping the same color again reports no change', () => {
+    const surface = makeSurface(4, 4, RED);
+    assert.equal(stampSpansIntoSurface(surface, 1, 1, brushSpans(3), RED), false);
+    assert.equal(stampSpansIntoSurface(surface, 1, 1, brushSpans(3), BLUE), true);
+    assert.equal(stampSpansIntoSurface(surface, 1, 1, brushSpans(3), BLUE), false);
+});
+
+test('stamping with alpha 0 erases to the canonical transparent pixel', () => {
+    const surface = makeSurface(2, 2, RED);
+    assert.equal(stampSpansIntoSurface(surface, 0, 0, brushSpans(1), [99, 99, 99, 0]), true);
+    assert.deepEqual(getPx(surface, 0, 0), [0, 0, 0, 0]);
+    assert.deepEqual(getPx(surface, 1, 0), RED);
+});
+
+test('stamps overlapping the image edge clip instead of wrapping', () => {
+    const surface = makeSurface(3, 3, RED);
+    assert.equal(stampSpansIntoSurface(surface, 0, 0, brushSpans(3), BLUE), true);
+    // Only the in-bounds quadrant changed; the far edge stayed intact.
+    assert.deepEqual(getPx(surface, 0, 0), BLUE);
+    assert.deepEqual(getPx(surface, 1, 0), BLUE);
+    assert.deepEqual(getPx(surface, 0, 1), BLUE);
+    assert.deepEqual(getPx(surface, 2, 0), RED);
+    assert.deepEqual(getPx(surface, 0, 2), RED);
+    assert.deepEqual(getPx(surface, 2, 2), RED);
+});
+
+test('flood fill replaces the whole connected region', () => {
+    const surface = makeSurface(4, 4, RED);
+    assert.equal(floodFill(surface, 1, 1, BLUE), true);
+    for (let y = 0; y < 4; y++) {
+        for (let x = 0; x < 4; x++) {
+            assert.deepEqual(getPx(surface, x, y), BLUE);
+        }
+    }
+});
+
+test('flood fill stops at differently colored boundaries', () => {
+    // Red | green wall at x=2 | red
+    const surface = makeSurface(5, 5, RED);
+    for (let y = 0; y < 5; y++) setPx(surface, 2, y, GREEN);
+
+    assert.equal(floodFill(surface, 0, 2, BLUE), true);
+    for (let y = 0; y < 5; y++) {
+        assert.deepEqual(getPx(surface, 0, y), BLUE);
+        assert.deepEqual(getPx(surface, 1, y), BLUE);
+        assert.deepEqual(getPx(surface, 2, y), GREEN);
+        assert.deepEqual(getPx(surface, 3, y), RED);
+        assert.deepEqual(getPx(surface, 4, y), RED);
+    }
+});
+
+test('flood fill is 4-connected and does not leak diagonally', () => {
+    const surface = makeSurface(2, 2, GREEN);
+    setPx(surface, 0, 0, RED);
+    setPx(surface, 1, 1, RED);
+
+    assert.equal(floodFill(surface, 0, 0, BLUE), true);
+    assert.deepEqual(getPx(surface, 0, 0), BLUE);
+    assert.deepEqual(getPx(surface, 1, 1), RED);
+    assert.deepEqual(getPx(surface, 1, 0), GREEN);
+    assert.deepEqual(getPx(surface, 0, 1), GREEN);
+});
+
+test('flood fill treats same RGB with different alpha as a boundary', () => {
+    const surface = makeSurface(3, 1, [10, 20, 30, 255]);
+    setPx(surface, 1, 0, [10, 20, 30, 128]);
+
+    assert.equal(floodFill(surface, 0, 0, BLUE), true);
+    assert.deepEqual(getPx(surface, 0, 0), BLUE);
+    assert.deepEqual(getPx(surface, 1, 0), [10, 20, 30, 128]);
+    assert.deepEqual(getPx(surface, 2, 0), [10, 20, 30, 255]);
+});
+
+test('flood fill is a no-op when the seed already has the fill color', () => {
+    const surface = makeSurface(3, 3, RED);
+    const before = Array.from(surface.data);
+    assert.equal(floodFill(surface, 1, 1, RED), false);
+    assert.deepEqual(Array.from(surface.data), before);
+});
+
+test('flood fill rejects out-of-bounds seeds', () => {
+    const surface = makeSurface(3, 3, RED);
+    assert.equal(floodFill(surface, -1, 0, BLUE), false);
+    assert.equal(floodFill(surface, 3, 0, BLUE), false);
+    assert.equal(floodFill(surface, 0, 3, BLUE), false);
+});
+
+test('flood fill with alpha 0 writes the canonical transparent pixel', () => {
+    const surface = makeSurface(2, 1, RED);
+    assert.equal(floodFill(surface, 0, 0, [99, 99, 99, 0]), true);
+    assert.deepEqual(getPx(surface, 0, 0), [0, 0, 0, 0]);
+    assert.deepEqual(getPx(surface, 1, 0), [0, 0, 0, 0]);
+});
+
+test('flood fill can fill a transparent region with a solid color', () => {
+    const surface = makeSurface(3, 1, [0, 0, 0, 0]);
+    setPx(surface, 2, 0, RED);
+    assert.equal(floodFill(surface, 0, 0, GREEN), true);
+    assert.deepEqual(getPx(surface, 0, 0), GREEN);
+    assert.deepEqual(getPx(surface, 1, 0), GREEN);
+    assert.deepEqual(getPx(surface, 2, 0), RED);
+});
+
+test('hardening splits anti-aliased pixels into exact color or transparent', () => {
+    const data = new Uint8ClampedArray([
+        // one pixel per line: r, g, b, a
+        90, 90, 90, 255, // fully opaque → kept
+        50, 60, 70, TEXT_ALPHA_THRESHOLD, // exactly at threshold → kept
+        50, 60, 70, TEXT_ALPHA_THRESHOLD - 1, // just below → dropped
+        0, 0, 0, 0, // transparent → stays canonical transparent
+    ]);
+    hardenAlphaToColor(data, [17, 34, 51]);
+
+    assert.deepEqual(Array.from(data.slice(0, 4)), [17, 34, 51, 255]);
+    assert.deepEqual(Array.from(data.slice(4, 8)), [17, 34, 51, 255]);
+    assert.deepEqual(Array.from(data.slice(8, 12)), [0, 0, 0, 0]);
+    assert.deepEqual(Array.from(data.slice(12, 16)), [0, 0, 0, 0]);
+});
+
+test('text wraps greedily at spaces within the box width', () => {
+    assert.deepEqual(wrapTextLines('the quick brown fox', 100, measure10), [
+        'the quick',
+        'brown fox',
+    ]);
+});
+
+test('text that fits stays on one line', () => {
+    assert.deepEqual(wrapTextLines('hello', 100, measure10), ['hello']);
+});
+
+test('explicit newlines are preserved, including empty lines', () => {
+    assert.deepEqual(wrapTextLines('one\n\ntwo', 100, measure10), ['one', '', 'two']);
+});
+
+test('a single word wider than the box breaks mid-word', () => {
+    assert.deepEqual(wrapTextLines('abcdefghij', 50, measure10), ['abcde', 'fghij']);
+});
+
+test('an over-wide word after other words starts on its own line', () => {
+    assert.deepEqual(wrapTextLines('hi abcdefgh', 50, measure10), ['hi', 'abcde', 'fgh']);
+});
+
+test('picked colors format as lowercase hex and round-trip through parse', () => {
+    assert.equal(rgbToHex(0x30, 0x50, 0xc0), '#3050c0');
+    assert.equal(rgbToHex(-5, 300, 128), '#00ff80');
+    assert.deepEqual(parseHexColor(rgbToHex(0xa1, 0xb2, 0xc3)), [0xa1, 0xb2, 0xc3]);
+});

From 1dd7447db072ff2e8ee0da13aaa2c83eca01159c Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sat, 11 Jul 2026 21:48:19 -0500
Subject: [PATCH 65/81] feat: add calibration theory documentation and related
 diagrams for improved filament calibration understanding

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 CHANGELOG.md                                  |  1 +
 .../diagrams/06_frontlit_hiding_distance.svg  | 62 +++++++++++++++
 src/assets/diagrams/07_calibration_wedge.svg  | 64 +++++++++++++++
 src/assets/diagrams/08_opacity_solve.svg      | 48 +++++++++++
 src/components/FilamentCalibrationDialog.tsx  | 13 +++
 src/components/docs/DocsPage.tsx              |  2 +
 src/docs/3d-mode.md                           |  4 +-
 src/docs/assets.ts                            |  6 ++
 src/docs/calibration-theory.md                | 79 +++++++++++++++++++
 src/lib/docs/navigation.ts                    | 10 +++
 10 files changed, 288 insertions(+), 1 deletion(-)
 create mode 100644 src/assets/diagrams/06_frontlit_hiding_distance.svg
 create mode 100644 src/assets/diagrams/07_calibration_wedge.svg
 create mode 100644 src/assets/diagrams/08_opacity_solve.svg
 create mode 100644 src/docs/calibration-theory.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e31934a..7051dd5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,6 +15,7 @@ All notable changes to Kromacut are documented in this file.
 - **3D inspection view modes** - The 3D preview toolbar now offers Shaded, Transparent, and Wireframe modes for inspecting surfaces, layers, and mesh edges. Wireframe uses thin, layer-colored feature edges, and the selected view is remembered without changing print settings or STL/3MF export content.
 - **Auto-paint preview color toggle** - The 3D preview toolbar now offers a Simulated/Physical color toggle for Auto-paint results, switching between the estimated blended appearance and the real physical filament colors stacked at each layer without a model rebuild. Only shown for Auto-paint models, the selection is remembered, and it never changes STL/3MF export content.
 - **2D touch-up tools** - The 2D preview toolbar now includes five hard-edged pixel tools (Brush, Eraser, Fill, Text, and color picker) for direct image editing with palette-safe colors, an on-canvas text box you type into directly with live move, resize, and word wrap, one undo/redo step per edit, and live non-blocking drawing with adjustments staying non-destructive.
+- **Calibration theory docs** - New in-app documentation page explaining the science behind filament calibration: the frontlit Beer-Lambert optical model and hiding distance, why the wedge's reference-rail comparison is reliable without a camera, how a single patch read becomes a hiding distance through a just-noticeable-difference solve, per-channel measurement with multiple bases, the session JND fit, and what the confidence score reflects — illustrated with three new diagrams. The Calibrate Filaments dialog links straight to it.
 - **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
 
 ### Changed
diff --git a/src/assets/diagrams/06_frontlit_hiding_distance.svg b/src/assets/diagrams/06_frontlit_hiding_distance.svg
new file mode 100644
index 0000000..6e409e2
--- /dev/null
+++ b/src/assets/diagrams/06_frontlit_hiding_distance.svg
@@ -0,0 +1,62 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="460" viewBox="0 0 960 460">
+<defs><marker id="arr6" markerWidth="8" markerHeight="8" refX="6" refY="4" orient="auto"><path d="M0,0 L8,4 L0,8 Z" fill="#71717a"/></marker></defs>
+<rect x="0" y="0" width="960" height="460" fill="#18181b" stroke="none" rx="0" />
+<text x="480" y="42" font-size="17" fill="#e4e4e7" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">Hiding Distance — Thin Layers Only Partly Hide the Base</text>
+<text x="480" y="62" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Frontlit viewing: light passes through the filament, reflects off what is beneath, and passes back out.</text>
+<text x="480" y="78" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Transmission T = 10^(−thickness / HD) — every added layer multiplies the show-through.</text>
+
+<text x="165" y="86" font-size="9" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">what you see</text>
+
+<!-- Stack 1: 1 layer -->
+<circle cx="165" cy="114" r="22" fill="#733f11" stroke="#3f3f46" stroke-width="1"/>
+<line x1="165" y1="277" x2="165" y2="142" stroke="#71717a" stroke-width="1.2" marker-end="url(#arr6)"/>
+<rect x="100" y="300" width="130" height="28" fill="#09090b" stroke="#3f3f46" stroke-width="1"/>
+<rect x="100" y="283" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<text x="165" y="350" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">1 layer · T ≈ 50%</text>
+
+<!-- Stack 2: 2 layers -->
+<circle cx="335" cy="114" r="22" fill="#ac5e19" stroke="#3f3f46" stroke-width="1"/>
+<line x1="335" y1="260" x2="335" y2="142" stroke="#71717a" stroke-width="1.2" marker-end="url(#arr6)"/>
+<rect x="270" y="300" width="130" height="28" fill="#09090b" stroke="#3f3f46" stroke-width="1"/>
+<rect x="270" y="283" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="270" y="266" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<text x="335" y="350" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">2 layers · T ≈ 25%</text>
+
+<!-- Stack 3: 4 layers -->
+<circle cx="505" cy="114" r="22" fill="#d87620" stroke="#3f3f46" stroke-width="1"/>
+<line x1="505" y1="226" x2="505" y2="142" stroke="#71717a" stroke-width="1.2" marker-end="url(#arr6)"/>
+<rect x="440" y="300" width="130" height="28" fill="#09090b" stroke="#3f3f46" stroke-width="1"/>
+<rect x="440" y="283" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="440" y="266" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="440" y="249" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="440" y="232" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<text x="505" y="350" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">4 layers · T ≈ 6%</text>
+
+<!-- Stack 4: 8 layers -->
+<circle cx="675" cy="114" r="22" fill="#e57e22" stroke="#3f3f46" stroke-width="1"/>
+<line x1="675" y1="158" x2="675" y2="142" stroke="#71717a" stroke-width="1.2" marker-end="url(#arr6)"/>
+<rect x="610" y="300" width="130" height="28" fill="#09090b" stroke="#3f3f46" stroke-width="1"/>
+<rect x="610" y="283" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="266" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="249" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="232" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="215" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="198" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="181" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<rect x="610" y="164" width="130" height="17" fill="#e67e22" stroke="#18181b" stroke-width="1"/>
+<text x="675" y="350" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">8 layers · T &lt; 1%</text>
+
+<text x="94" y="318" font-size="9" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">black base</text>
+
+<!-- Right panel: opaque reference + formula -->
+<circle cx="850" cy="114" r="22" fill="#e67e22" stroke="#3f3f46" stroke-width="1"/>
+<text x="850" y="152" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">opaque filament color</text>
+<text x="850" y="166" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">(the wedge's reference rail)</text>
+<text x="850" y="215" font-size="13" fill="#e4e4e7" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">T = 10^(−thickness / HD)</text>
+<text x="850" y="240" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">HD (hiding distance): the depth at</text>
+<text x="850" y="254" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">which a filament visually hides</text>
+<text x="850" y="268" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">what's beneath it.</text>
+<text x="850" y="296" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Conventional backlit TD ≈ 10 × HD.</text>
+
+<text x="480" y="452" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Kromacut · frontlit calibration</text>
+</svg>
diff --git a/src/assets/diagrams/07_calibration_wedge.svg b/src/assets/diagrams/07_calibration_wedge.svg
new file mode 100644
index 0000000..f291939
--- /dev/null
+++ b/src/assets/diagrams/07_calibration_wedge.svg
@@ -0,0 +1,64 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="460" viewBox="0 0 960 460">
+<rect x="0" y="0" width="960" height="460" fill="#18181b" stroke="none" rx="0" />
+<text x="480" y="42" font-size="17" fill="#e4e4e7" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">Reading the Calibration Wedge</text>
+<text x="480" y="62" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Each tile prints patches of 1..N filament layers over a base, beside a rail of fully opaque filament.</text>
+<text x="480" y="78" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">You report one number per tile: the first patch that looks identical to the rail.</text>
+
+<!-- Reference rail -->
+<rect x="120" y="110" width="712" height="30" fill="#e67e22" stroke="#3f3f46" stroke-width="1" rx="4"/>
+<text x="840" y="122" font-size="10" fill="#71717a" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">reference rail</text>
+<text x="840" y="135" font-size="10" fill="#71717a" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">(fully opaque)</text>
+
+<!-- Orientation foot -->
+<rect x="92" y="156" width="20" height="52" fill="#3f3f46" rx="3"/>
+<text x="102" y="222" font-size="9" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">foot</text>
+
+<!-- Patches 1..12 -->
+<rect x="120" y="156" width="52" height="52" fill="#57300d" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="180" y="156" width="52" height="52" fill="#8e4e15" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="240" y="156" width="52" height="52" fill="#af601a" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="300" y="156" width="52" height="52" fill="#c46b1d" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="360" y="156" width="52" height="52" fill="#d1721f" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="420" y="156" width="52" height="52" fill="#d97720" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="480" y="156" width="52" height="52" fill="#de7a21" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="540" y="156" width="52" height="52" fill="#e17b21" stroke="#f5a623" stroke-width="2" rx="3"/>
+<rect x="600" y="156" width="52" height="52" fill="#e37c22" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="660" y="156" width="52" height="52" fill="#e47d22" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="720" y="156" width="52" height="52" fill="#e57d22" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<rect x="780" y="156" width="52" height="52" fill="#e57e22" stroke="#3f3f46" stroke-width="1" rx="3"/>
+<text x="146" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">1</text>
+<text x="206" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">2</text>
+<text x="266" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">3</text>
+<text x="326" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">4</text>
+<text x="386" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">5</text>
+<text x="446" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">6</text>
+<text x="506" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">7</text>
+<text x="566" y="222" font-size="10" fill="#f5a623" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">8</text>
+<text x="626" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">9</text>
+<text x="686" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">10</text>
+<text x="746" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">11</text>
+<text x="806" y="222" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">12</text>
+<text x="566" y="250" font-size="10" fill="#f5a623" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">first patch identical to the rail → report 8</text>
+
+<!-- Side view -->
+<text x="120" y="300" font-size="10" fill="#71717a" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">side view (single-filament STL workflow)</text>
+<rect x="120" y="358" width="59.33" height="4" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="179.33" y="354" width="59.33" height="8" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="238.67" y="350" width="59.33" height="12" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="298" y="346" width="59.33" height="16" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="357.33" y="342" width="59.33" height="20" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="416.67" y="338" width="59.33" height="24" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="476" y="334" width="59.33" height="28" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="535.33" y="330" width="59.33" height="32" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="594.67" y="326" width="59.33" height="36" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="654" y="322" width="59.33" height="40" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="713.33" y="318" width="59.33" height="44" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="772.67" y="314" width="59.33" height="48" fill="#e67e22" stroke="#18181b" stroke-width="0.5"/>
+<rect x="120" y="362" width="712" height="26" fill="#27272a" stroke="#3f3f46" stroke-width="1"/>
+<text x="476" y="379" font-size="9" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">base filament</text>
+<line x1="100" y1="362" x2="852" y2="362" stroke="#f5a623" stroke-width="1.2" stroke-dasharray="6,3"/>
+<text x="856" y="360" font-size="9" fill="#f5a623" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">single swap:</text>
+<text x="856" y="372" font-size="9" fill="#f5a623" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">base → color</text>
+
+<text x="480" y="452" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Kromacut · frontlit calibration</text>
+</svg>
diff --git a/src/assets/diagrams/08_opacity_solve.svg b/src/assets/diagrams/08_opacity_solve.svg
new file mode 100644
index 0000000..ca555d5
--- /dev/null
+++ b/src/assets/diagrams/08_opacity_solve.svg
@@ -0,0 +1,48 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="460" viewBox="0 0 960 460">
+<rect x="0" y="0" width="960" height="460" fill="#18181b" stroke="none" rx="0" />
+<text x="480" y="42" font-size="17" fill="#e4e4e7" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">From One Read to a Hiding Distance</text>
+<text x="480" y="62" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">The difference between each patch and the opaque rail shrinks as layers stack.</text>
+<text x="480" y="78" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Your read pins where that difference crosses one just-noticeable difference (JND).</text>
+
+<!-- Grid lines -->
+<line x1="140" y1="110" x2="860" y2="110" stroke="#27272a" stroke-width="1"/>
+<line x1="140" y1="193.3" x2="860" y2="193.3" stroke="#27272a" stroke-width="1"/>
+<line x1="140" y1="276.7" x2="860" y2="276.7" stroke="#27272a" stroke-width="1"/>
+
+<!-- Axes -->
+<line x1="140" y1="110" x2="140" y2="360" stroke="#3f3f46" stroke-width="1.5"/>
+<line x1="140" y1="360" x2="860" y2="360" stroke="#3f3f46" stroke-width="1.5"/>
+<text x="128" y="364" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">0</text>
+<text x="128" y="322" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">2</text>
+<text x="128" y="281" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">4</text>
+<text x="128" y="197" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">8</text>
+<text x="128" y="114" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">12</text>
+<text x="140" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">0</text>
+<text x="260" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">2</text>
+<text x="380" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">4</text>
+<text x="500" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">6</text>
+<text x="620" y="378" font-size="10" fill="#f5a623" text-anchor="middle" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">8</text>
+<text x="740" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">10</text>
+<text x="860" y="378" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">12</text>
+<text x="146" y="102" font-size="10" fill="#71717a" text-anchor="start" font-family="Inter,ui-sans-serif,sans-serif">ΔE00 difference from the opaque rail</text>
+<text x="500" y="418" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">wedge patch — layers of filament over the base</text>
+
+<!-- Difference curve -->
+<polyline points="302,110 320,134 350,169 380,199 410,224 440,245 470,263 500,278 530,291 560,302 590,311 620,318.5 680,330 740,339 800,345 860,349" fill="none" stroke="#e67e22" stroke-width="2.5"/>
+
+<!-- JND threshold -->
+<line x1="140" y1="318.3" x2="860" y2="318.3" stroke="#f5a623" stroke-width="1.5" stroke-dasharray="6,3"/>
+<text x="850" y="309" font-size="10" fill="#f5a623" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">one JND (ΔE00 ≈ 2) — “looks identical”</text>
+
+<!-- Crossing point -->
+<circle cx="620" cy="318.3" r="5" fill="#f5a623"/>
+<line x1="620" y1="318.3" x2="620" y2="360" stroke="#71717a" stroke-width="1.2" stroke-dasharray="4,3"/>
+<text x="620" y="398" font-size="10" fill="#e4e4e7" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">your read: patch 8 → d* = 8 × layer height</text>
+
+<!-- Formula -->
+<text x="850" y="140" font-size="13" fill="#e4e4e7" text-anchor="end" font-weight="bold" font-family="Inter,ui-sans-serif,sans-serif">HD = −d* / log₁₀(T*)</text>
+<text x="850" y="158" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">T* = the show-through that sits exactly one JND</text>
+<text x="850" y="172" font-size="10" fill="#71717a" text-anchor="end" font-family="Inter,ui-sans-serif,sans-serif">from opaque — solved from the colors alone</text>
+
+<text x="480" y="452" font-size="10" fill="#71717a" text-anchor="middle" font-family="Inter,ui-sans-serif,sans-serif">Kromacut · frontlit calibration</text>
+</svg>
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 2feaedb..b48b60e 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -30,8 +30,10 @@ import {
     ArrowRight,
     FlaskConical,
     AlertTriangle,
+    BookOpen,
 } from 'lucide-react';
 import { cn } from '@/lib/utils';
+import { openDocsAt } from '@/lib/docs/navigation';
 import type { Filament } from '../types';
 import {
     activeFrontlitCalibration,
@@ -676,6 +678,17 @@ export function FilamentCalibrationDialog({
                     Pick the filaments to calibrate. You&apos;ll print a small wedge for each over a
                     base layer, then read back a single number — no camera, no color picking.
                 </p>
+                <button
+                    type="button"
+                    onClick={() => {
+                        handleClose();
+                        openDocsAt('calibration-theory');
+                    }}
+                    className="inline-flex items-center gap-1.5 text-sm font-medium text-primary hover:underline"
+                >
+                    <BookOpen className="h-4 w-4" />
+                    How calibration works
+                </button>
                 {filaments.length > 0 && (
                     <button
                         type="button"
diff --git a/src/components/docs/DocsPage.tsx b/src/components/docs/DocsPage.tsx
index 7d57ef6..1d1b092 100644
--- a/src/components/docs/DocsPage.tsx
+++ b/src/components/docs/DocsPage.tsx
@@ -38,6 +38,8 @@ const DOC_NAV_GROUPS = [
             'reducing-colors',
             'dedithering-cleanup',
             '3d-mode',
+            'calibration-theory',
+            'multi-head-printing',
             'generating-exporting-output',
         ],
     },
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index f9f9ba6..6cf4d4d 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -57,6 +57,8 @@ Because the reference rail is the filament's own fully-opaque color, you are onl
 
 Each filament stores a single calibration. Calibrating a filament again **replaces** its previous value rather than averaging into it, and only the reads you enter in the current run are saved — so to combine several bases into one measurement, select them together in a single **Accurate** run instead of calibrating the same filament twice. Calibrating a different filament only updates that filament and leaves your other calibrations untouched.
 
+For the optics behind the wedge — why one read is enough and what the math does with it — see [Calibration theory](calibration-theory).
+
 ## Filament Profiles
 
 Auto-paint profiles store reusable filament sets.
@@ -159,4 +161,4 @@ Hover over color segments to see the start layer or swap layer. The preview rang
 
 In Flat Paint mode the bar shows a plain track because printed layers contain several filaments at once — there is no single swap sequence. Orbit underneath the model to inspect the artwork face.
 
-Next: [Generating and exporting output](generating-exporting-output).
+Next: [Calibration theory](calibration-theory).
diff --git a/src/docs/assets.ts b/src/docs/assets.ts
index 773c04d..c94dae9 100644
--- a/src/docs/assets.ts
+++ b/src/docs/assets.ts
@@ -1,9 +1,15 @@
 import logoImage from '@/assets/logo.png';
 import tdTestImage from '@/assets/tdTest.png';
+import diagramFrontlitHd from '@/assets/diagrams/06_frontlit_hiding_distance.svg';
+import diagramCalibrationWedge from '@/assets/diagrams/07_calibration_wedge.svg';
+import diagramOpacitySolve from '@/assets/diagrams/08_opacity_solve.svg';
 
 const DOC_ASSETS: Record<string, string> = {
     'kromacut-logo.png': logoImage,
     'td-test.png': tdTestImage,
+    '06_frontlit_hiding_distance.svg': diagramFrontlitHd,
+    '07_calibration_wedge.svg': diagramCalibrationWedge,
+    '08_opacity_solve.svg': diagramOpacitySolve,
 };
 
 export function resolveDocAsset(src: string): string | undefined {
diff --git a/src/docs/calibration-theory.md b/src/docs/calibration-theory.md
new file mode 100644
index 0000000..3f381cc
--- /dev/null
+++ b/src/docs/calibration-theory.md
@@ -0,0 +1,79 @@
+---
+title: Calibration Theory
+slug: calibration-theory
+order: 62
+description: The optics and math behind filament hiding-distance calibration.
+---
+
+# Calibration Theory
+
+Calibration measures each filament's **hiding distance (HD)**: the depth at which it visually hides what is printed beneath it. Auto-paint's color model depends on this value per filament, so a measured HD is better than an estimate. This page covers what the calibration wedge measures and how Kromacut converts a single patch read into a full optical model.
+
+For the step-by-step wizard, see [3D mode](3d-mode).
+
+## Why Thin Layers Blend
+
+A print is viewed frontlit: light enters the top surface, passes down through the filament, reflects off what is underneath, and passes back out. A thin layer only partly hides what is below it, so the color you see is a mix of the filament's own color and the color showing through from beneath. Auto-paint uses this show-through to build in-between colors from a small filament set, which is why HD has to be accurate.
+
+![Thin filament layers over a black base only partly hide it; each added layer multiplies the show-through until the stack matches the opaque filament color.](06_frontlit_hiding_distance.svg)
+
+Kromacut models the show-through with a Beer-Lambert law. A thickness `d` of filament transmits
+
+```
+T = 10^(−d / HD)
+```
+
+of the underlying color. Each added layer multiplies the show-through, so a stack reaches opacity geometrically. The rate is a material property: a dense black hides in a fraction of a millimeter, a translucent white can need ten times the depth. That rate is the hiding distance.
+
+The Transmission Distance printed on spool sheets, or measured with backlit TD test prints, describes light passing *through* the filament once (lithophane-style). Frontlit viewing passes light through the layer twice and reads it against reflection, so a conventional TD is roughly 10× the hiding distance. Kromacut accepts conventional TD as input (the convert button on each filament row) but stores and simulates with HD.
+
+## The Wedge
+
+Camera-based color measurement is unreliable: cameras auto-correct, screens differ, and lighting shifts. The wedge avoids judging any color in isolation. Each tile prints patches of 1 to N filament layers over a base, with a **reference rail** of the same filament at full opacity beside them and a foot marking the 1-layer end.
+
+![The calibration wedge: numbered patches of increasing layer count beside a fully opaque reference rail; you report the first patch that looks identical to the rail.](07_calibration_wedge.svg)
+
+You report the **first patch that looks identical to the rail beside it**. The rail is the filament's own opaque color sitting millimeters away under the same light, so the comparison holds across rooms, screens, and prints. Thin patches show the base through; at some patch the difference drops below what the eye can distinguish, and that patch number is the measurement.
+
+## From a Read to a Hiding Distance
+
+The reported patch marks the thickness at which show-through dropped below a **just-noticeable difference (JND)**: the smallest visible color difference, about 2 ΔE00 in everyday viewing.
+
+Kromacut solves this backward. For the filament color over the base color, it computes `T*`, the show-through that places the blended color exactly one JND from the opaque filament color. `T*` depends only on the two colors and the JND, with no hand-tuned opacity constant. The read gives the thickness at which the print reached that point, `d* = patch × layer height`, and Beer-Lambert inverts to:
+
+```
+HD = −d* / log10(T*)
+```
+
+![As layers stack, the color difference between patch and rail decays; the reported patch pins where it crosses one JND, and inverting the transmission law yields the hiding distance.](08_opacity_solve.svg)
+
+Base contrast matters here: a black filament over a black base never differs from its rail by a full JND, so there is nothing to measure. The wizard detects this and assigns dark filaments a lighter base.
+
+## Per-Channel Hiding Distances
+
+Filaments do not absorb red, green, and blue equally (an orange filament passes red but blocks blue), so a single scalar HD is an approximation. Kromacut blends with three per-channel hiding distances:
+
+- **One base read (Quick mode):** RGB values are estimated from the filament's swatch color, anchored so the brightest (most transmissive) channel matches the measured scalar HD.
+- **Multiple base reads (Accurate mode):** each base stresses different channels (a red base reveals red transmission, a white base exercises all three). Kromacut fits the per-channel triple that best predicts all reads at once, replacing the color estimate with a measured result.
+
+## The Session JND Fit
+
+The default JND of 2 ΔE00 is a human-vision constant, but a given viewer and lighting may sit slightly off it. When a session has at least two filaments with multi-base reads, Kromacut also fits a single shared JND (1 to 3) that best explains every read together. The fit is kept only when it clearly beats the default; otherwise the session uses the constant.
+
+## Confidence
+
+Each calibration carries a confidence score for how well the measurement was pinned down:
+
+- A read at either end of the wedge (patch 1, or the last patch) lowers confidence: the true opacity point may lie outside the printed range. Print a longer wedge or a finer layer height and recalibrate.
+- Multi-base reads that disagree under the best fit lower confidence, and the disagreement is noted on the calibration.
+- Confidence decays after six months, as filaments age and spools change.
+
+Uncalibrated filaments get a lower score based on how plausible their estimated HD is.
+
+## What Changes After Calibrating
+
+Per-channel hiding distances feed both the **colors** auto-paint predicts for each stack and the **thickness** of its transition zones. Calibrating can change generated stack heights and the swap plan, not just the preview.
+
+A calibration belongs to the material it measured: it is tied to the swatch color it was calibrated for, editing the filament's color deactivates it, and recalibrating replaces the previous measurement rather than averaging into it.
+
+Next: [Multi-head printing](multi-head-printing).
diff --git a/src/lib/docs/navigation.ts b/src/lib/docs/navigation.ts
index e88323a..2b991f7 100644
--- a/src/lib/docs/navigation.ts
+++ b/src/lib/docs/navigation.ts
@@ -30,6 +30,16 @@ export function buildDocsPath(docSlug: string, headingSlug?: string): string {
     return `${DOCS_PATH_PREFIX}/${encodedDoc}${encodedHeading}`;
 }
 
+/**
+ * Open the in-app docs at a specific page from anywhere in the app. Pushes the
+ * docs URL and fires a popstate so the App shell and DocsPage (both of which
+ * already listen for it) switch to docs and select the page.
+ */
+export function openDocsAt(docSlug: string, headingSlug?: string): void {
+    window.history.pushState(null, '', buildDocsPath(docSlug, headingSlug));
+    window.dispatchEvent(new PopStateEvent('popstate'));
+}
+
 export function parseDocsPath(pathname: string, hash = ''): DocLinkTarget | null {
     const normalizedPath = pathname.replace(/\/+$/, '') || '/';
     if (normalizedPath !== DOCS_PATH_PREFIX && !normalizedPath.startsWith(`${DOCS_PATH_PREFIX}/`)) {

From 7bdcc16bee62b315ff11c8a30ad1dbac355594f0 Mon Sep 17 00:00:00 2001
From: Brice A Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Sun, 12 Jul 2026 08:47:00 -0500
Subject: [PATCH 66/81] Update DocsPage.tsx

remove multi head ref
---
 src/components/docs/DocsPage.tsx | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/components/docs/DocsPage.tsx b/src/components/docs/DocsPage.tsx
index 1d1b092..b9fa6e8 100644
--- a/src/components/docs/DocsPage.tsx
+++ b/src/components/docs/DocsPage.tsx
@@ -39,7 +39,6 @@ const DOC_NAV_GROUPS = [
             'dedithering-cleanup',
             '3d-mode',
             'calibration-theory',
-            'multi-head-printing',
             'generating-exporting-output',
         ],
     },

From 1de89d7dc5e7a4eda8eb266fc95d7fe297c04772 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sun, 12 Jul 2026 18:37:16 +0300
Subject: [PATCH 67/81] fix: smooth meshing 3MF integrity - Smoothed cap faces
 are now validated in the 3MF exporter's exact integer coordinate units
 instead of epsilon-compared floats, so faces that would collapse at
 serialized precision get re-triangulated during meshing rather than silently
 dropped at export. This removes the pinhole open/non-manifold edges slicers
 flagged on large smooth-meshed 3MF exports (STL exports were never affected).

---
 CHANGELOG.md          |  1 +
 src/lib/meshing.ts    | 15 ++++++++--
 tests/meshing.test.ts | 68 +++++++++++++++++++++++++++++++++++++++++--
 3 files changed, 78 insertions(+), 6 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e31934a..7cf3ceb 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -34,6 +34,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint edge cases** - Blank seeds now resolve to stable cacheable values, optimizer cache keys include all target clusters, tuning inputs, preserve-separation mode, and active calibration state, beam-search ties use locale-independent ordering, exact base-order search discloses its estimated base-order count before running, zero-HD blend helpers agree on the opaque-filament limit, and exceptionally tall stacks stop at the intended 500-layer slice-data limit.
 - **Filament profile validation** - Imported `.kfil`/`.kapp` profile filaments now reject zero or negative hiding distances instead of letting invalid raw HD values reach the UI.
 - **Desktop 3MF export reliability** - 3MF model XML now streams into the archive in bounded chunks, avoiding desktop WebView `FileReader` `NotReadableError` failures and `RangeError: Invalid string length` on large exports.
+- **Smooth meshing 3MF integrity** - Smoothed cap faces are now validated in the 3MF exporter's exact integer coordinate units instead of epsilon-compared floats, so faces that would collapse at serialized precision get re-triangulated during meshing rather than silently dropped at export. This removes the pinhole open/non-manifold edges slicers flagged on large smooth-meshed 3MF exports (STL exports were never affected).
 
 ## v3.1.0 - 2026-06-18
 
diff --git a/src/lib/meshing.ts b/src/lib/meshing.ts
index e5b6449..e67fe88 100644
--- a/src/lib/meshing.ts
+++ b/src/lib/meshing.ts
@@ -256,7 +256,9 @@ function triangulateBoundaryPreservingVertices(
         const segmentX = b.x - a.x;
         const segmentY = b.y - a.y;
         const segmentLengthSquared = segmentX * segmentX + segmentY * segmentY;
-        const collinearEpsilon = Math.max(areaEpsilon * 16, Number.EPSILON);
+        // roundedPoints are exact integer coordinate units, so genuinely
+        // collinear chains have area exactly 0 and integer projections.
+        const collinearEpsilon = 0.5;
 
         const collect = (step: 1 | -1) => {
             const chain = [start];
@@ -743,12 +745,19 @@ async function generateGridMesh(
                 Math.fround(mappedY * pixelSize)
             );
         });
+        // Cap points in integer 3MF coordinate units — the exact grid the
+        // exporter serializes and welds on. Degeneracy checks on these
+        // integers agree with the exporter bit-for-bit, so every cap face the
+        // mesher accepts survives export. (Checking quantized-back floats
+        // against an epsilon lets through faces whose integer area is exactly
+        // zero; the exporter then drops them, leaving holes that slicers
+        // report as non-manifold edges.)
         const roundedFacePoints = options.smoothBoundary
             ? facePoints.map(
                   (point) =>
                       new Vector2(
-                          Math.round(point.x * THREE_MF_COORD_SCALE) / THREE_MF_COORD_SCALE,
-                          Math.round(point.y * THREE_MF_COORD_SCALE) / THREE_MF_COORD_SCALE
+                          Math.round(point.x * THREE_MF_COORD_SCALE),
+                          Math.round(point.y * THREE_MF_COORD_SCALE)
                       )
               )
             : facePoints;
diff --git a/tests/meshing.test.ts b/tests/meshing.test.ts
index 9b9eef5..25a2a4c 100644
--- a/tests/meshing.test.ts
+++ b/tests/meshing.test.ts
@@ -129,10 +129,13 @@ function inspectRoundedExportTopology(mesh: MeshData): RoundedExportTopologyRepo
 
     const getExportVertex = (sourceIndex: number) => {
         const offset = sourceIndex * 3;
+        // Integer 3MF coordinate units, exactly like export3mf's toCoordUnits:
+        // degeneracy below must be tested with exact integer arithmetic, or
+        // faces the exporter drops would pass this simulation unnoticed.
         const point = [
-            Math.round(mesh.positions[offset] * 100000) / 100000,
-            Math.round(mesh.positions[offset + 1] * 100000) / 100000,
-            Math.round(mesh.positions[offset + 2] * 100000) / 100000,
+            Math.round(mesh.positions[offset] * 100000),
+            Math.round(mesh.positions[offset + 1] * 100000),
+            Math.round(mesh.positions[offset + 2] * 100000),
         ] as [number, number, number];
         const key = point.join(',');
         const existing = vertexMap.get(key);
@@ -565,6 +568,65 @@ test('smooth caps avoid export-degenerate final ears after boundary movement', a
     });
 });
 
+test('smooth caps survive 3MF integer-precision export without dropped faces', async () => {
+    // Regression: cap degeneracy used to be checked on quantized-back floats
+    // against Number.EPSILON, while the 3MF exporter tests exact integer
+    // coordinate units. Faces with integer area exactly 0 but float area
+    // ~1e-12 passed the mesher and were then dropped by the exporter, leaving
+    // pinholes that slicers report as non-manifold/open edges. This noisy
+    // blob mask (mulberry32 seed 33 at 96px, pixel size 0.1) produced two
+    // such faces before the mesher switched to the exporter's integer grid.
+    const seed = 33;
+    const size = 96;
+    let state = seed >>> 0;
+    const rand = () => {
+        state |= 0;
+        state = (state + 0x6d2b79f5) | 0;
+        let t = Math.imul(state ^ (state >>> 15), 1 | state);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+
+    const activePixels = new Uint8Array(size * size);
+    const blobs = 3 + Math.floor(rand() * 5);
+    const centers = Array.from({ length: blobs }, () => ({
+        x: rand() * size,
+        y: rand() * size,
+        r: size * (0.1 + rand() * 0.25),
+    }));
+    for (let y = 0; y < size; y++) {
+        for (let x = 0; x < size; x++) {
+            for (const center of centers) {
+                if (Math.hypot(x - center.x, y - center.y) < center.r + (rand() - 0.5) * 3) {
+                    activePixels[y * size + x] = 1;
+                    break;
+                }
+            }
+        }
+    }
+    for (let i = 0; i < activePixels.length; i++) {
+        if (rand() < 0.02) activePixels[i] = activePixels[i] ? 0 : 1;
+    }
+
+    const mesh = await generateSmoothMesh(
+        activePixels,
+        size,
+        size,
+        0.12,
+        0.2,
+        0.1,
+        1,
+        noYieldOptions
+    );
+
+    assertHealthyMesh('smooth noisy-blob mesh', mesh);
+    assert.deepEqual(inspectRoundedExportTopology(mesh), {
+        boundaryEdgeCount: 0,
+        overusedEdgeCount: 0,
+        skippedTriangleCount: 0,
+    });
+});
+
 test('smooth metrics stay on the smooth algorithm without mesher substitution state', async () => {
     const smoothMask = maskFromRows(['##', '##']);
     const smoothMesh = await generateSmoothMesh(

From 5bbd9f8f9769072e380c3e82736a19512256ebc9 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Tue, 21 Jul 2026 10:54:56 -0500
Subject: [PATCH 68/81] feat: allow partial calibration entry

Saving a calibration run required every selected filament to have complete,
valid reads, so a wedge printed for eight filaments could not be saved until
all eight were read in one sitting.

The save path was already partial-aware: handleSave only writes entries with a
complete input and an ok result, and onApply touches only the IDs it is given,
so unread filaments were never at risk. The gate was the blocker. Save now
enables on the first usable filament and reports how many will be written.

The session JND fit previously bailed if any entry was incomplete, which would
have quietly dropped a partially-filled Accurate run to the default JND. It now
fits over the complete entries and ignores blanks.

Discarding stays visible. A filament nobody touched is marked "Not entered" and
dropped silently, which is fine. Anything typed that still cannot be saved --
an Accurate filament with some of its bases read, or a value below 1 -- is
marked "Won't save" with a reason, tracked by whether a field was touched
rather than whether it parsed.

Scoped to whole filaments: a filament is saved once all of its base reads are
in. That keeps handleSave's non-null read assertion valid, which saving from a
subset of bases would break by admitting null opacity layers into stored
calibration records.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 CHANGELOG.md                                 |  2 +-
 src/components/FilamentCalibrationDialog.tsx | 80 +++++++++++++++-----
 src/docs/3d-mode.md                          |  2 +
 3 files changed, 66 insertions(+), 18 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6417dc..d6e056b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
+- **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. Results can be entered partially: saving calibrates the filaments you finished and leaves the rest untouched, so a wedge printed for eight filaments can be read a few at a time. Filaments with nothing entered are marked and discarded on save, and one with only some of its Accurate-mode base reads filled in is flagged rather than dropped silently. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
 - **Auto-paint test and benchmark coverage** - Added deterministic stack goldens, layer-invariant regression coverage, realized CIEDE2000 quality-budget tests, and an on-demand benchmark for fixture profiles using the same printable-stack mapper as the optimizer.
diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index b48b60e..6de1a52 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -485,7 +485,11 @@ export function FilamentCalibrationDialog({
         return [...grouped.values()].map(({ filament, targets }) => {
             const readValues: FrontlitCalibrationRead[] = [];
             let complete = targets.length > 0;
+            // Whether the user typed anything at all, parseable or not. Only an
+            // untouched filament may be discarded without saying so.
+            let touched = false;
             for (const target of targets) {
+                if ((reads[target.key] ?? '').trim() !== '') touched = true;
                 const opacityLayers = parseLayerInput(reads[target.key]);
                 if (opacityLayers === null) {
                     complete = false;
@@ -507,7 +511,7 @@ export function FilamentCalibrationDialog({
                       maxLayers: activeMeasurePlan.maxLayers,
                   }
                 : null;
-            return { filament, targets, input };
+            return { filament, targets, input, filled: readValues.length, touched };
         });
     }, [activeMeasurePlan, reads]);
 
@@ -528,10 +532,9 @@ export function FilamentCalibrationDialog({
     latestSessionKeyRef.current = sessionKey;
 
     // The JND search needs at least two multi-base filaments with complete
-    // reads; anything less always resolves to the default JND.
+    // reads; anything less always resolves to the default JND. Filaments left
+    // blank are simply not part of the session — they never block the fit.
     const sessionFitEligible = useMemo(() => {
-        if (readInputs.length === 0) return false;
-        if (readInputs.some((entry) => entry.input === null)) return false;
         const multiBase = readInputs.filter((entry) => (entry.input?.reads?.length ?? 0) >= 2);
         return multiBase.length >= 2;
     }, [readInputs]);
@@ -582,23 +585,41 @@ export function FilamentCalibrationDialog({
     // Per-filament calibration computed live from the entered reads, using the
     // fitted session JND once it is available.
     const computed = useMemo(() => {
-        return readInputs.map(({ filament, targets, input }) => ({
-            filament,
-            targets,
-            input,
-            result: input
+        return readInputs.map(({ filament, targets, input, filled, touched }) => {
+            const result = input
                 ? computeFrontlitCalibration({
                       ...input,
                       jnd: activeJndFit?.jnd,
                       jndSource: activeJndFit?.jndSource,
                   })
-                : null,
-            jndSource: activeJndFit?.jndSource ?? null,
-        }));
+                : null;
+            // 'empty' filaments are dropped silently on save — the user never
+            // claimed a read for them. 'partial' covers anything they did type
+            // that still is not savable, which has to be called out rather than
+            // discarded quietly.
+            const status: 'ready' | 'failed' | 'partial' | 'empty' = result?.ok
+                ? 'ready'
+                : result
+                  ? 'failed'
+                  : touched
+                    ? 'partial'
+                    : 'empty';
+            return {
+                filament,
+                targets,
+                input,
+                result,
+                status,
+                filled,
+                jndSource: activeJndFit?.jndSource ?? null,
+            };
+        });
     }, [readInputs, activeJndFit]);
 
-    const allReadsValid =
-        computed.length > 0 && computed.every((c) => c.result !== null && c.result.ok);
+    // Partial entry is allowed: whatever is filled in gets calibrated and the
+    // rest is left untouched, so Save only needs one usable filament.
+    const readyCount = computed.filter((c) => c.status === 'ready').length;
+    const skippedCount = computed.length - readyCount;
 
     const handleSave = useCallback(() => {
         if (isSaving || sessionFitPending) return;
@@ -1025,12 +1046,20 @@ export function FilamentCalibrationDialog({
             <div className="space-y-3">
                 <p className="text-sm text-muted-foreground">
                     Enter the first patch number that matched the rail for each filament/base print.
+                    Fill in as many as you read — anything left blank is discarded on save and that
+                    filament keeps its current settings.
                     {isFittingJnd && (
                         <span className="ml-1.5 text-[11px] text-primary">
                             Fitting session JND…
                         </span>
                     )}
                 </p>
+                {readyCount > 0 && skippedCount > 0 && (
+                    <p className="rounded-md border border-border/50 bg-muted/20 px-3 py-2 text-[11px] text-muted-foreground">
+                        Saving will calibrate {readyCount} filament
+                        {readyCount === 1 ? '' : 's'} and leave {skippedCount} unchanged.
+                    </p>
+                )}
                 <div className="grid gap-1 rounded-md border border-border/50 bg-muted/20 px-3 py-2 text-[11px] text-muted-foreground sm:grid-cols-2">
                     <div>
                         <span className="font-semibold text-foreground">Match:</span> first patch
@@ -1042,7 +1071,7 @@ export function FilamentCalibrationDialog({
                     </div>
                 </div>
                 <div className="max-h-[26rem] space-y-2.5 overflow-y-auto pr-1">
-                    {computed.map(({ filament, targets, result, jndSource }) => {
+                    {computed.map(({ filament, targets, result, status, filled, jndSource }) => {
                         const calibration = result && result.ok ? result.calibration : null;
                         const errorText = result && !result.ok ? result.error : null;
                         return (
@@ -1062,6 +1091,11 @@ export function FilamentCalibrationDialog({
                                     </div>
                                     <div className="text-right text-[11px] text-muted-foreground">
                                         {targets.length} read{targets.length === 1 ? '' : 's'}
+                                        {status !== 'ready' && (
+                                            <div className="font-medium text-amber-600 dark:text-amber-400">
+                                                {status === 'empty' ? 'Not entered' : 'Won’t save'}
+                                            </div>
+                                        )}
                                     </div>
                                 </div>
 
@@ -1203,6 +1237,14 @@ export function FilamentCalibrationDialog({
                                         {errorText}
                                     </p>
                                 )}
+
+                                {status === 'partial' && (
+                                    <p className="mt-2 rounded-lg border border-amber-500/30 bg-amber-500/10 px-3 py-1.5 text-[11px] text-amber-600 dark:text-amber-400">
+                                        {filled === 0
+                                            ? 'Enter a patch number of 1 or higher to calibrate this filament.'
+                                            : `Read ${filled} of ${targets.length} bases. Fill in the rest to calibrate this filament, or clear it to skip it and keep its current settings.`}
+                                    </p>
+                                )}
                             </Card>
                         );
                     })}
@@ -1215,10 +1257,14 @@ export function FilamentCalibrationDialog({
                 </Button>
                 <Button
                     onClick={handleSave}
-                    disabled={!allReadsValid || isSaving || sessionFitPending}
+                    disabled={readyCount === 0 || isSaving || sessionFitPending}
                 >
                     <Check className="mr-1 h-4 w-4" />
-                    {isSaving || sessionFitPending ? 'Fitting...' : 'Save Calibration'}
+                    {isSaving || sessionFitPending
+                        ? 'Fitting...'
+                        : skippedCount > 0 && readyCount > 0
+                          ? `Save ${readyCount} of ${computed.length}`
+                          : 'Save Calibration'}
                 </Button>
             </AlertDialogFooter>
         </>
diff --git a/src/docs/3d-mode.md b/src/docs/3d-mode.md
index 6cf4d4d..e552a89 100644
--- a/src/docs/3d-mode.md
+++ b/src/docs/3d-mode.md
@@ -53,6 +53,8 @@ Calibration is camera-free: you print a small wedge and read back one or more op
 3. **Print** the calibration wedge. Set your layer height and the wedge length (max layers), then download an **STL** (any printer) or a multi-material **3MF** (colors and bases baked in, for AMS/multi-material). For STL, use the shown layer height and first-layer height, print one copy for each filament/base read, load the listed base filament, then swap after the shown layer/Z height to the filament being calibrated. Each print has patches from 1 layer up, with an opaque reference rail running along the edge beside the patches. A foot marks the 1-layer end.
 4. **Enter Results** by reporting, for each filament/base row, the **first patch that looks identical to the reference rail** beside it. Kromacut uses one read for quick scalar calibration, or combines multi-base reads to measure per-channel hiding distances and, when the session has enough data, fit the shared JND. The optional merge field records where adjacent steps stop looking different; it is stored as model-checking evidence and does not block saving.
 
+You do not have to finish every filament in one sitting. Saving calibrates the filaments you completed and leaves the rest exactly as they were, so you can print a wedge for eight filaments, read three of them today, and save. Filaments you have not read are marked **Not entered** and are discarded on save; a filament in **Accurate** mode still needs all of its base reads before it can be saved, and one with only some of them filled in is marked **Won't save** so it is not dropped silently. The Save button shows how many filaments will be written when any are being skipped.
+
 Because the reference rail is the filament's own fully-opaque color, you are only judging whether a patch matches the rail right next to it — a comparison that stays reliable across lighting and screens. The measured hiding distance is a material property, so it transfers to your real prints regardless of which base you calibrated against.
 
 Each filament stores a single calibration. Calibrating a filament again **replaces** its previous value rather than averaging into it, and only the reads you enter in the current run are saved — so to combine several bases into one measurement, select them together in a single **Accurate** run instead of calibrating the same filament twice. Calibrating a different filament only updates that filament and leaves your other calibrations untouched.

From b576f4783cb83aa21ea952505687123ddb8e0da5 Mon Sep 17 00:00:00 2001
From: vycdev2 <vycdev2@users.noreply.github.com>
Date: Tue, 21 Jul 2026 20:25:14 +0000
Subject: [PATCH 69/81] feat: add landing page and app route

---
 CHANGELOG.md                        |   3 +
 README.md                           |   2 +
 index.html                          |  28 ++++
 public/site.webmanifest             |   3 +-
 scripts/generate-docs-seo-pages.mjs |  32 ++++-
 src/App.tsx                         |  13 +-
 src/components/Header.tsx           | 125 ++++++++---------
 src/components/LandingPage.tsx      | 206 ++++++++++++++++++++++++++++
 src/lib/routes.ts                   |  64 +++++++++
 src/lib/seo.ts                      |  15 ++
 src/main.tsx                        |  33 ++++-
 tests/e2e/kromacut-flow.spec.ts     |   2 +-
 tests/e2e/landing.spec.ts           |  36 +++++
 tests/routes.test.ts                |  49 +++++++
 14 files changed, 532 insertions(+), 79 deletions(-)
 create mode 100644 src/components/LandingPage.tsx
 create mode 100644 src/lib/routes.ts
 create mode 100644 tests/e2e/landing.spec.ts
 create mode 100644 tests/routes.test.ts

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b6417dc..03c9e83 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,9 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
+- **Landing page and `/app` web route** - Added a responsive product landing page at `/`, moved the browser tool to `/app`, preserved `/docs/...` routes and same-origin localStorage, and added a returning-user launch preference with `/?landing=1` preview support. The landing page includes the core workflow, existing product visuals, desktop releases, documentation, GitHub, Discord, and Patreon links.
+- **Route-aware SEO and deployment output** - Added route helpers, landing structured data, app `noindex` metadata, a stable PWA manifest identity with `/app` as its start URL, and static `dist/app/index.html` output for GitHub Pages refreshes.
+- **Route and landing smoke coverage** - Added focused route-selection tests and Playwright coverage for the landing CTA, direct `/app` loading, and same-origin storage persistence.
 - **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
 - **Preserve color separation (Auto-paint)** - Enhanced color matching can keep each distinct 2D image color mapped to a distinct printable color when the stack exposes enough printable colors, preserving gradients that would otherwise collapse onto a flat surface. It is mutually exclusive with Height dithering because both modes change the same printable height map.
 - **Auto-paint optimization progress** - Enhanced matching now reports approximate search progress while the background optimizer runs.
diff --git a/README.md b/README.md
index 726cc6c..22895f2 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@
 
 Open-source HueForge-style tool for converting images into stacked, color-layered 3D prints.
 
+**Try Kromacut in your browser:** [landing page](https://kromacut.com/) · [open the app](https://kromacut.com/app) · [read the docs](https://kromacut.com/docs/overview) · [download desktop releases](https://github.com/vycdev/Kromacut/releases)
+
 Kromacut is a browser-first app that converts images into multi-color lithophane 3D prints. It offers two powerful workflows:
 
 **Auto-paint mode** — Define your actual filaments (color + hiding distance), and Kromacut automatically computes optimal layer stacks using physically accurate Beer-Lambert optical blending. Features include a calibration wizard, five deterministic optimizer effort tiers, and region weighting for spatial priority.
diff --git a/index.html b/index.html
index 10f08e3..fe4e9bb 100644
--- a/index.html
+++ b/index.html
@@ -59,6 +59,34 @@
         <meta name="twitter:image" content="https://kromacut.com/android-chrome-512x512.png" />
         <meta name="twitter:image:alt" content="Kromacut logo" />
         <title>Kromacut - Free Image-to-3D Color Layer Print Generator</title>
+        <script type="application/ld+json">
+            {
+                "@context": "https://schema.org",
+                "@graph": [
+                    {
+                        "@type": "WebSite",
+                        "@id": "https://kromacut.com/#website",
+                        "url": "https://kromacut.com/",
+                        "name": "Kromacut",
+                        "description": "Turn 2D images into stacked, color-layered 3D prints.",
+                        "potentialAction": {
+                            "@type": "CreateAction",
+                            "target": "https://kromacut.com/app"
+                        }
+                    },
+                    {
+                        "@type": "SoftwareApplication",
+                        "@id": "https://kromacut.com/#application",
+                        "name": "Kromacut",
+                        "applicationCategory": "DesignApplication",
+                        "operatingSystem": "Web, Windows, macOS, Linux",
+                        "url": "https://kromacut.com/",
+                        "description": "Browser-first image-to-3D color-layer print generator with STL and 3MF export.",
+                        "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }
+                    }
+                ]
+            }
+        </script>
     </head>
     <body>
         <div id="root"></div>
diff --git a/public/site.webmanifest b/public/site.webmanifest
index e86f10b..957d45a 100644
--- a/public/site.webmanifest
+++ b/public/site.webmanifest
@@ -2,7 +2,8 @@
     "name": "Kromacut",
     "short_name": "Kromacut",
     "description": "Turn 2D images into color-layered 3D prints for free and export STL or 3MF models.",
-    "start_url": "/",
+    "start_url": "/app",
+    "id": "/",
     "scope": "/",
     "icons": [
         {
diff --git a/scripts/generate-docs-seo-pages.mjs b/scripts/generate-docs-seo-pages.mjs
index 324095e..6f078c3 100644
--- a/scripts/generate-docs-seo-pages.mjs
+++ b/scripts/generate-docs-seo-pages.mjs
@@ -325,6 +325,28 @@ function updateDocHead(template, doc) {
     return html;
 }
 
+function updateAppHead(template) {
+    const title = 'Kromacut App - Image to 3D Print Tool';
+    const description =
+        'Create color-layered 3D prints from images with Kromacut. The browser tool runs locally and exports STL or 3MF models.';
+    const url = `${siteUrl}/app`;
+    let html = template.replace(/<title>.*?<\/title>/, `<title>${escapeHtml(title)}</title>`);
+
+    html = updateMeta(html, 'name', 'description', description);
+    html = updateMeta(html, 'name', 'robots', 'noindex,nofollow');
+    html = html.replace(
+        /<link\s+rel="canonical"\s+href="[^"]*"\s*\/?>/,
+        `<link rel="canonical" href="${url}" />`
+    );
+    html = updateMeta(html, 'property', 'og:title', title);
+    html = updateMeta(html, 'property', 'og:description', description);
+    html = updateMeta(html, 'property', 'og:url', url);
+    html = updateMeta(html, 'name', 'twitter:title', title);
+    html = updateMeta(html, 'name', 'twitter:description', description);
+
+    return html;
+}
+
 function renderStaticRoot(doc, docs, docsBySlug) {
     const nav = docs
         .map((entry) => `<li><a href="/docs/${entry.slug}">${escapeHtml(entry.title)}</a></li>`)
@@ -334,7 +356,8 @@ function renderStaticRoot(doc, docs, docsBySlug) {
     return `<div id="root">
             <main class="seo-doc-page">
                 <nav aria-label="Documentation">
-                    <a href="/">Kromacut app</a>
+                    <a href="/">Kromacut home</a>
+                    <a href="/app">Open Kromacut</a>
                     <ul>${nav}</ul>
                 </nav>
                 <article>
@@ -362,6 +385,12 @@ function writeDocPage(template, doc, docs, docsBySlug, slug = doc.slug) {
     }
 }
 
+function writeAppPage(template) {
+    const outputDir = path.join(distDir, 'app');
+    mkdirSync(outputDir, { recursive: true });
+    writeFileSync(path.join(outputDir, 'index.html'), updateAppHead(template));
+}
+
 function writeSitemap(docs) {
     const urls = ['/', ...docs.map((doc) => `/docs/${doc.slug}`)];
     const body = urls
@@ -391,5 +420,6 @@ const overviewDoc = docsBySlug.get('overview') ?? docs[0];
 
 docs.forEach((doc) => writeDocPage(template, doc, docs, docsBySlug));
 if (overviewDoc) writeDocPage(template, overviewDoc, docs, docsBySlug, '');
+writeAppPage(template);
 writeSitemap(docs);
 writeRobots();
diff --git a/src/App.tsx b/src/App.tsx
index cad15b4..1b64667 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -51,7 +51,9 @@ import {
     savePreviewRenderMode,
 } from './lib/previewPrefs';
 import { buildDocsPath, parseDocsLocation } from './lib/docs/navigation';
-import { applyHomeSeo } from './lib/seo';
+import { applyAppSeo } from './lib/seo';
+import { appPath, markLaunched } from './lib/routes';
+import { isTauri } from '@tauri-apps/api/core';
 import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
 import {
     AlertDialog,
@@ -181,6 +183,7 @@ const saveAutoPaintPersisted = (value: AutoPaintPersisted) => {
 };
 
 function App(): React.ReactElement | null {
+    const toolPath = appPath(isTauri());
     // dropzone state managed by hook below
     // `weight` is the algorithm parameter; `finalColors` is the postprocess target
     const [weight, setWeight] = useState<number>(128);
@@ -380,16 +383,20 @@ function App(): React.ReactElement | null {
         };
     }, []);
 
+    useEffect(() => {
+        markLaunched();
+    }, []);
+
     useEffect(() => {
         if (!docsOpen) {
-            applyHomeSeo();
+            applyAppSeo();
         }
     }, [docsOpen]);
 
     const backToApp = () => {
         setDocsOpen(false);
         if (parseDocsLocation(window.location)) {
-            window.history.pushState(null, '', '/');
+            window.history.pushState(null, '', toolPath);
         }
     };
 
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index b89741d..5941bbe 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -2,7 +2,6 @@ import React from 'react';
 import { Button } from '@/components/ui/button';
 import {
     AlertCircle,
-    ArrowLeft,
     BookOpen,
     CheckCircle2,
     Download,
@@ -41,6 +40,8 @@ import logo from '../assets/logo.png';
 import discordIcon from '../assets/discord.svg';
 import githubIcon from '../assets/github.svg';
 import redditIcon from '../assets/reddit.svg';
+import { appPath } from '@/lib/routes';
+import { isTauri } from '@tauri-apps/api/core';
 
 interface Props {
     docsOpen: boolean;
@@ -165,28 +166,19 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                         </span>
                     </button>
                 ) : (
-                    <>
+                    <a
+                        href={appPath(isTauri())}
+                        className="flex items-center gap-2 rounded-md p-1 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
+                        aria-label="Open Kromacut app"
+                    >
                         <img src={logo} alt="Kromacut" className="h-7 w-auto" />
                         <span className="font-extrabold text-base text-foreground tracking-wide ml-1 select-none max-md:hidden">
                             Kromacut
                         </span>
-                    </>
+                    </a>
                 )}
             </div>
             <div className="flex gap-2.5 items-center">
-                <Button
-                    size="sm"
-                    onClick={onToggleDocs}
-                    title={docsOpen ? 'Back to app' : 'Open docs'}
-                    className="bg-foreground hover:bg-foreground/90 text-background font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5 border border-foreground/20"
-                >
-                    {docsOpen ? (
-                        <ArrowLeft className="w-4 h-4" />
-                    ) : (
-                        <BookOpen className="w-4 h-4" />
-                    )}
-                    <span className="max-sm:hidden">{docsOpen ? 'Back to app' : 'Docs'}</span>
-                </Button>
                 <Button
                     size="sm"
                     asChild
@@ -205,58 +197,6 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                         <span className="max-sm:hidden">Reddit</span>
                     </a>
                 </Button>
-                <Button
-                    size="sm"
-                    asChild
-                    className="bg-gradient-to-r from-indigo-500 to-blue-600 hover:from-indigo-600 hover:to-blue-700 text-white font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
-                >
-                    <a
-                        href="https://discord.gg/nU63sFMcnX"
-                        target="_blank"
-                        rel="noopener noreferrer"
-                        aria-label="Discord"
-                        title="Discord"
-                    >
-                        <span className="flex size-4 shrink-0 items-center justify-center">
-                            <img src={discordIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
-                        </span>
-                        <span className="max-sm:hidden">Discord</span>
-                    </a>
-                </Button>
-                <Button
-                    size="sm"
-                    asChild
-                    className="bg-gradient-to-r from-purple-500 to-violet-600 hover:from-purple-600 hover:to-violet-700 text-white font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
-                >
-                    <a
-                        href="https://github.com/vycdev/Kromacut"
-                        target="_blank"
-                        rel="noopener noreferrer"
-                        aria-label="GitHub"
-                        title="GitHub"
-                    >
-                        <span className="flex size-4 shrink-0 items-center justify-center">
-                            <img src={githubIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
-                        </span>
-                        <span className="max-sm:hidden">GitHub</span>
-                    </a>
-                </Button>
-                <Button
-                    size="sm"
-                    className="bg-gradient-to-r from-rose-500 to-orange-500 hover:from-rose-600 hover:to-orange-600 text-white font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
-                    asChild
-                >
-                    <a
-                        href="https://www.patreon.com/cw/vycdev"
-                        target="_blank"
-                        rel="noopener noreferrer"
-                        aria-label="Support me"
-                        title="Support me"
-                    >
-                        <Heart className="w-4 h-4 fill-current" />
-                        <span className="max-sm:hidden">Support me</span>
-                    </a>
-                </Button>
                 <Button
                     size="icon"
                     onClick={() => setSettingsOpen(true)}
@@ -347,6 +287,55 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                             </div>
                         </section>
 
+                        <section className="mt-5 space-y-3 border-t border-border pt-5">
+                            <div>
+                                <div className="text-sm font-medium text-foreground">Resources & community</div>
+                                <p className="mt-1 text-xs leading-5 text-muted-foreground">
+                                    Guides, releases, and places to share what you make.
+                                </p>
+                            </div>
+                            <div className="grid gap-2 sm:grid-cols-2">
+                                <button
+                                    type="button"
+                                    onClick={() => {
+                                        setSettingsOpen(false);
+                                        onToggleDocs();
+                                    }}
+                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 text-left transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                >
+                                    <BookOpen className="mt-0.5 h-4 w-4 flex-shrink-0 text-primary" />
+                                    <span><span className="block text-sm font-semibold">Docs</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Learn the workflow and print settings.</span></span>
+                                </button>
+                                <a
+                                    href="https://discord.gg/nU63sFMcnX"
+                                    target="_blank"
+                                    rel="noopener noreferrer"
+                                    onClick={() => setSettingsOpen(false)}
+                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                >
+                                    <img src={discordIcon} alt="" className="mt-0.5 h-4 w-4 brightness-0 invert" /><span><span className="block text-sm font-semibold">Discord</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Join the Kromacut community.</span></span>
+                                </a>
+                                <a
+                                    href="https://github.com/vycdev/Kromacut"
+                                    target="_blank"
+                                    rel="noopener noreferrer"
+                                    onClick={() => setSettingsOpen(false)}
+                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                >
+                                    <img src={githubIcon} alt="" className="mt-0.5 h-4 w-4 brightness-0 invert" /><span><span className="block text-sm font-semibold">GitHub</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">View the source and report issues.</span></span>
+                                </a>
+                                <a
+                                    href="https://www.patreon.com/cw/vycdev"
+                                    target="_blank"
+                                    rel="noopener noreferrer"
+                                    onClick={() => setSettingsOpen(false)}
+                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                >
+                                    <Heart className="mt-0.5 h-4 w-4 flex-shrink-0 text-rose-400" /><span><span className="block text-sm font-semibold">Support Me</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Support continued open-source work.</span></span>
+                                </a>
+                            </div>
+                        </section>
+
                         {isDesktopApp && (
                             <section className="mt-5 space-y-3 border-t border-border pt-5">
                                 <div className="flex items-center justify-between gap-3">
diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
new file mode 100644
index 0000000..5bfcabe
--- /dev/null
+++ b/src/components/LandingPage.tsx
@@ -0,0 +1,206 @@
+import {
+    ArrowRight,
+    BookOpen,
+    Check,
+    ChevronDown,
+    Download,
+    Github,
+    Heart,
+    MessageCircle,
+    Play,
+    Sparkles,
+} from 'lucide-react';
+import logo from '../assets/logo.png';
+import fuji2d from '../../content/fuji2d_new.png';
+import fuji3d from '../../content/fuji3d_new.png';
+import sliced from '../../content/fuji3dsliced.png';
+import printed from '../../content/printed.jpg';
+import { APP_PATH } from '@/lib/routes';
+
+const links = {
+    releases: 'https://github.com/vycdev/Kromacut/releases',
+    github: 'https://github.com/vycdev/Kromacut',
+    discord: 'https://discord.gg/nU63sFMcnX',
+    patreon: 'https://www.patreon.com/cw/vycdev',
+};
+
+const workflow = [
+    {
+        number: '01',
+        title: 'Import an image',
+        description: 'Drop in artwork, a photo, or a pixel design and keep the original safely editable.',
+        image: fuji2d,
+        alt: 'A colorful 2D image ready to be imported into Kromacut',
+    },
+    {
+        number: '02',
+        title: 'Reduce & paint colors',
+        description: 'Tune a compact palette manually or let Auto-paint match the filaments you actually own.',
+        image: sliced,
+        alt: 'A color-layered image preview showing separate printable colors',
+    },
+    {
+        number: '03',
+        title: 'Preview every layer',
+        description: 'Inspect the stack in 3D, check transitions, and see exactly where filament swaps happen.',
+        image: fuji3d,
+        alt: 'Kromacut 3D preview of a stacked color-layer print',
+    },
+    {
+        number: '04',
+        title: 'Export and print',
+        description: 'Download a slicer-ready STL or 3MF with the print plan you need to finish the job.',
+        image: printed,
+        alt: 'A finished colorful layered print made from a Kromacut workflow',
+    },
+];
+
+function ExternalArrow() {
+    return <ArrowRight aria-hidden="true" className="h-4 w-4" />;
+}
+
+export default function LandingPage() {
+    return (
+        <main data-testid="landing-page" className="min-h-screen overflow-hidden bg-background text-foreground">
+            <a
+                href="#workflow"
+                className="sr-only z-50 rounded-md bg-primary px-4 py-2 text-primary-foreground focus:not-sr-only focus:fixed focus:left-4 focus:top-4"
+            >
+                Skip to workflow
+            </a>
+
+            <div className="relative isolate">
+                <div aria-hidden="true" className="pointer-events-none absolute inset-x-0 top-0 -z-10 h-[42rem] overflow-hidden">
+                    <div className="absolute left-[8%] top-[-13rem] h-[34rem] w-[34rem] rounded-full bg-primary/20 blur-[100px]" />
+                    <div className="absolute right-[-8rem] top-[8rem] h-[28rem] w-[28rem] rounded-full bg-fuchsia-500/10 blur-[100px]" />
+                    <div className="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,0.06)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,0.06)_1px,transparent_1px)] bg-[size:3rem_3rem] [mask-image:linear-gradient(to_bottom,black,transparent_88%)]" />
+                </div>
+
+                <header className="mx-auto flex max-w-7xl items-center justify-between gap-6 px-5 py-5 sm:px-8 lg:px-10">
+                    <a href={APP_PATH} className="flex items-center gap-3 rounded-lg focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
+                        <img src={logo} alt="Kromacut" className="h-10 w-auto" />
+                        <span className="font-sans text-lg font-extrabold tracking-[0.12em]">KROMACUT</span>
+                    </a>
+                    <nav aria-label="Main navigation" className="hidden items-center gap-7 text-sm font-semibold text-muted-foreground md:flex">
+                        <a href="#workflow" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
+                        <a href="/docs/overview" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
+                    </nav>
+                    <a
+                        href={APP_PATH}
+                        data-testid="landing-open-app"
+                        className="group inline-flex min-h-11 items-center gap-2 rounded-lg bg-foreground px-4 py-2 text-sm font-bold text-background shadow-lg shadow-foreground/10 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background active:translate-y-0"
+                    >
+                        Open Kromacut <ExternalArrow />
+                    </a>
+                </header>
+
+                <section className="mx-auto grid max-w-7xl items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
+                    <div className="max-w-2xl">
+                        <div className="mb-6 inline-flex items-center gap-2 rounded-full border border-primary/30 bg-primary/10 px-3 py-1.5 text-xs font-bold uppercase tracking-[0.16em] text-primary">
+                            <Sparkles aria-hidden="true" className="h-3.5 w-3.5" />
+                            Open source · browser first
+                        </div>
+                        <h1 className="max-w-2xl text-balance font-sans text-5xl font-extrabold leading-[0.95] tracking-[-0.045em] sm:text-6xl lg:text-7xl">
+                            Turn pixels into <span className="bg-gradient-to-r from-primary via-violet-400 to-fuchsia-400 bg-clip-text text-transparent">printable layers.</span>
+                        </h1>
+                        <p className="mt-7 max-w-xl text-lg leading-8 text-muted-foreground sm:text-xl">
+                            Kromacut transforms 2D images into stacked, color-layered 3D prints. Prepare your palette, match real filament, preview the result, and export a model ready for your slicer.
+                        </p>
+                        <div className="mt-9 flex flex-col gap-3 sm:flex-row sm:items-center">
+                            <a href={APP_PATH} className="group inline-flex min-h-12 items-center justify-center gap-2 rounded-lg bg-primary px-5 py-3 font-bold text-primary-foreground shadow-xl shadow-primary/20 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background active:translate-y-0">
+                                Start creating <ExternalArrow />
+                            </a>
+                            <a href="/docs/quick-start" className="inline-flex min-h-12 items-center justify-center gap-2 rounded-lg border border-border bg-card/60 px-5 py-3 font-bold text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
+                                <BookOpen aria-hidden="true" className="h-4 w-4" /> Read the quick start
+                            </a>
+                        </div>
+                        <div className="mt-8 flex flex-wrap gap-x-5 gap-y-3 text-sm text-muted-foreground">
+                            {['Free to use', 'No upload required', 'STL + 3MF export'].map((item) => (
+                                <span key={item} className="inline-flex items-center gap-2"><Check aria-hidden="true" className="h-4 w-4 text-emerald-400" />{item}</span>
+                            ))}
+                        </div>
+                    </div>
+
+                    <div className="relative mx-auto w-full max-w-2xl lg:ml-auto">
+                        <div aria-hidden="true" className="absolute -inset-8 rounded-[2rem] bg-primary/10 blur-3xl" />
+                        <div className="relative overflow-hidden rounded-2xl border border-white/10 bg-card/80 p-2 shadow-2xl shadow-black/30 backdrop-blur">
+                            <div className="flex items-center justify-between border-b border-border px-3 py-2.5 text-[10px] font-bold uppercase tracking-[0.18em] text-muted-foreground">
+                                <span>3D layer preview</span>
+                                <span className="inline-flex items-center gap-1.5 text-emerald-400"><span className="h-1.5 w-1.5 rounded-full bg-emerald-400" /> ready to print</span>
+                            </div>
+                            <div className="relative aspect-[1.22] overflow-hidden rounded-xl bg-black/20">
+                                <img src={fuji3d} alt="Color-layered 3D print preview" className="h-full w-full object-cover object-center" fetchPriority="high" />
+                                <div className="absolute bottom-4 left-4 right-4 flex flex-wrap gap-2">
+                                    {['#121a3a', '#3855c7', '#e14f91', '#f6ba4a'].map((color, index) => (
+                                        <span key={color} className="inline-flex items-center gap-2 rounded-md border border-white/15 bg-black/65 px-2.5 py-1.5 text-xs font-semibold text-white backdrop-blur" style={{ opacity: 1 - index * 0.04 }}>
+                                            <span className="h-3 w-3 rounded-sm" style={{ backgroundColor: color }} /> Layer {index + 1}
+                                        </span>
+                                    ))}
+                                </div>
+                            </div>
+                        </div>
+                        <div className="absolute -bottom-5 -left-4 hidden items-center gap-3 rounded-xl border border-border bg-card px-4 py-3 shadow-xl sm:flex">
+                            <div className="flex -space-x-1.5">{['#191d3d', '#5867d9', '#d64996', '#f5bd5a'].map((color) => <span key={color} className="h-7 w-7 rounded-full border-2 border-card" style={{ backgroundColor: color }} />)}</div>
+                            <div><div className="text-xs font-bold">Palette mapped</div><div className="text-[11px] text-muted-foreground">4 printable colors</div></div>
+                        </div>
+                    </div>
+                </section>
+            </div>
+
+            <section id="workflow" className="scroll-mt-8 border-y border-border/70 bg-card/30">
+                <div className="mx-auto max-w-7xl px-5 py-20 sm:px-8 lg:px-10 lg:py-28">
+                    <div className="max-w-2xl">
+                        <p className="text-xs font-bold uppercase tracking-[0.2em] text-primary">From image to object</p>
+                        <h2 className="mt-4 text-3xl font-extrabold tracking-tight sm:text-5xl">A simple workflow, with serious control.</h2>
+                        <p className="mt-5 text-lg leading-8 text-muted-foreground">Go from a flat image to a layered print without leaving your browser. Keep the creative decisions yours, while Kromacut handles the geometry and print planning.</p>
+                    </div>
+                    <div className="mt-14 grid gap-5 sm:grid-cols-2 lg:grid-cols-4">
+                        {workflow.map((step) => (
+                            <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1">
+                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover transition-transform duration-500 motion-safe:group-hover:scale-105" /></div>
+                                <div className="p-5"><div className="font-mono text-xs font-bold text-primary">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
+                            </article>
+                        ))}
+                    </div>
+                </div>
+            </section>
+
+            <section className="mx-auto grid max-w-7xl items-center gap-12 px-5 py-20 sm:px-8 md:py-28 lg:grid-cols-[1.05fr_0.95fr] lg:px-10">
+                <div className="relative grid grid-cols-2 gap-3">
+                    <div className="mt-10 overflow-hidden rounded-xl border border-border shadow-xl"><img src={fuji2d} alt="Original 2D artwork" loading="lazy" className="aspect-square h-full w-full object-cover" /></div>
+                    <div className="overflow-hidden rounded-xl border border-primary/40 shadow-xl shadow-primary/10"><img src={printed} alt="Finished Kromacut print" loading="lazy" className="aspect-square h-full w-full object-cover" /></div>
+                    <div className="absolute left-1/2 top-1/2 hidden -translate-x-1/2 -translate-y-1/2 rounded-full border border-border bg-background p-3 text-primary shadow-lg sm:block"><ArrowRight aria-hidden="true" className="h-5 w-5" /></div>
+                </div>
+                <div className="max-w-xl">
+                    <p className="text-xs font-bold uppercase tracking-[0.2em] text-primary">Built for real prints</p>
+                    <h2 className="mt-4 text-3xl font-extrabold tracking-tight sm:text-5xl">Your filament. Your palette. Your model.</h2>
+                    <p className="mt-5 text-lg leading-8 text-muted-foreground">Use manual slicing when you want pixel-level control, or let Auto-paint search for a color stack from your calibrated filament profile. Either way, inspect every layer before you export.</p>
+                    <ul className="mt-7 space-y-3 text-sm text-foreground">
+                        {['Non-destructive image adjustments', 'Three.js layer-by-layer 3D preview', 'Calibrated Auto-paint with deterministic search', 'Slicer-friendly STL and multi-material 3MF'].map((item) => <li key={item} className="flex items-start gap-3"><Check aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-emerald-400" />{item}</li>)}
+                    </ul>
+                    <a href={APP_PATH} className="mt-9 inline-flex items-center gap-2 font-bold text-primary underline decoration-primary/30 underline-offset-4 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Open the tool <ExternalArrow /></a>
+                </div>
+            </section>
+
+            <section className="border-t border-border/70 bg-muted/20">
+                <div className="mx-auto flex max-w-7xl flex-col items-start justify-between gap-8 px-5 py-14 sm:px-8 md:flex-row md:items-center lg:px-10">
+                    <div><p className="text-2xl font-extrabold tracking-tight sm:text-3xl">Ready to make a flat image physical?</p><p className="mt-2 text-muted-foreground">Start with an image. Finish with a print.</p></div>
+                    <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-primary px-5 py-2.5 font-bold text-primary-foreground shadow-lg shadow-primary/20 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
+                </div>
+            </section>
+
+            <footer className="mx-auto flex max-w-7xl flex-col gap-8 px-5 py-10 sm:px-8 md:flex-row md:items-end md:justify-between lg:px-10">
+                <div><a href={APP_PATH} className="inline-flex items-center gap-3 font-bold focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><img src={logo} alt="" className="h-8 w-auto" /> Kromacut</a><p className="mt-3 max-w-sm text-sm leading-6 text-muted-foreground">Open-source tools for turning images into color-layered 3D prints.</p></div>
+                <nav aria-label="Footer navigation" className="grid grid-cols-2 gap-x-10 gap-y-3 text-sm text-muted-foreground sm:flex sm:flex-wrap sm:justify-end sm:gap-x-6">
+                    <a href="/docs/overview" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><BookOpen aria-hidden="true" className="h-4 w-4" /> Docs</a>
+                    <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Releases</a>
+                    <a href={links.github} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Github aria-hidden="true" className="h-4 w-4" /> GitHub</a>
+                    <a href={links.discord} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><MessageCircle aria-hidden="true" className="h-4 w-4" /> Discord</a>
+                    <a href={links.patreon} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Heart aria-hidden="true" className="h-4 w-4" /> Support Kromacut</a>
+                </nav>
+            </footer>
+            <div className="sr-only"><ChevronDown aria-hidden="true" /><Play aria-hidden="true" /></div>
+        </main>
+    );
+}
diff --git a/src/lib/routes.ts b/src/lib/routes.ts
new file mode 100644
index 0000000..5c09ef5
--- /dev/null
+++ b/src/lib/routes.ts
@@ -0,0 +1,64 @@
+export const LANDING_PATH = '/';
+export const APP_PATH = '/app';
+export const DOCS_PATH = '/docs';
+
+export const HAS_LAUNCHED_STORAGE_KEY = 'kromacut.has-launched.v1';
+
+export type AppRoute = 'landing' | 'app' | 'docs';
+
+export function isDocsRoute(pathname: string): boolean {
+    const normalized = pathname.replace(/\/+$/, '') || LANDING_PATH;
+    return normalized === DOCS_PATH || normalized.startsWith(`${DOCS_PATH}/`);
+}
+
+export function selectRoute(pathname: string, isTauri = false): AppRoute {
+    if (isTauri) return 'app';
+    if (isDocsRoute(pathname)) return 'docs';
+    return pathname.replace(/\/+$/, '') === APP_PATH ? 'app' : 'landing';
+}
+
+export function hasLandingBypass(search: string): boolean {
+    return new URLSearchParams(search).get('landing') === '1';
+}
+
+export function isCrawlerUserAgent(userAgent: string): boolean {
+    return /bot|crawler|spider|crawling|slurp|bingpreview|facebookexternalhit|twitterbot|linkedinbot/i.test(
+        userAgent
+    );
+}
+
+export function hasLaunched(): boolean {
+    try {
+        return window.localStorage.getItem(HAS_LAUNCHED_STORAGE_KEY) === 'v1';
+    } catch {
+        return false;
+    }
+}
+
+export function markLaunched(): void {
+    try {
+        window.localStorage.setItem(HAS_LAUNCHED_STORAGE_KEY, 'v1');
+    } catch {
+        // A blocked storage area should not prevent the app from opening.
+    }
+}
+
+export function shouldRedirectHomeToApp(
+    location: Pick<Location, 'pathname' | 'search'>,
+    isTauri: boolean,
+    userAgent: string,
+    launched: boolean
+): boolean {
+    return (
+        !isTauri &&
+        selectRoute(location.pathname, false) === 'landing' &&
+        (location.pathname.replace(/\/+$/, '') || LANDING_PATH) === LANDING_PATH &&
+        !hasLandingBypass(location.search) &&
+        launched &&
+        !isCrawlerUserAgent(userAgent)
+    );
+}
+
+export function appPath(isTauri: boolean): string {
+    return isTauri ? LANDING_PATH : APP_PATH;
+}
diff --git a/src/lib/seo.ts b/src/lib/seo.ts
index ddef712..988e570 100644
--- a/src/lib/seo.ts
+++ b/src/lib/seo.ts
@@ -7,6 +7,9 @@ export const SOCIAL_IMAGE_URL = `${SITE_URL}/android-chrome-512x512.png`;
 const HOME_TITLE = 'Kromacut - Free Image-to-3D Color Layer Print Generator';
 const HOME_DESCRIPTION =
     'Turn 2D images into color-layered 3D prints for free with Kromacut. Reduce palettes, plan filament swaps, preview layers, and export STL or 3MF models.';
+const APP_TITLE = 'Kromacut App - Image to 3D Print Tool';
+const APP_DESCRIPTION =
+    'Create color-layered 3D prints from images with Kromacut. The browser tool runs locally and exports STL or 3MF models.';
 
 function absoluteUrl(pathname: string): string {
     return new URL(pathname, SITE_URL).toString();
@@ -49,14 +52,17 @@ function applySeo({
     description,
     url,
     type = 'website',
+    robots = 'index,follow',
 }: {
     title: string;
     description: string;
     url: string;
     type?: string;
+    robots?: string;
 }) {
     document.title = title;
     setMeta('name', 'description', description);
+    setMeta('name', 'robots', robots);
     findOrCreateCanonical().href = url;
 
     setMeta('property', 'og:title', title);
@@ -81,6 +87,15 @@ export function applyHomeSeo() {
     });
 }
 
+export function applyAppSeo() {
+    applySeo({
+        title: APP_TITLE,
+        description: APP_DESCRIPTION,
+        url: absoluteUrl('/app'),
+        robots: 'noindex,nofollow',
+    });
+}
+
 export function docSeoTitle(doc: DocRecord): string {
     return `${doc.meta.title} | Kromacut Docs`;
 }
diff --git a/src/main.tsx b/src/main.tsx
index 1bbaa06..2e28b01 100644
--- a/src/main.tsx
+++ b/src/main.tsx
@@ -1,16 +1,39 @@
 import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
+import { isTauri } from '@tauri-apps/api/core';
 import './index.css';
 import App from './App.tsx';
+import LandingPage from './components/LandingPage.tsx';
 import { applyThemeMode, getStoredThemeMode } from './lib/theme';
-import { applyHomeSeo } from './lib/seo';
+import { applyAppSeo, applyHomeSeo } from './lib/seo';
+import {
+    hasLaunched,
+    selectRoute,
+    shouldRedirectHomeToApp,
+} from './lib/routes';
 
 // Apply the saved theme preference before React paints.
 applyThemeMode(getStoredThemeMode());
-applyHomeSeo();
+
+const desktopRuntime = isTauri();
+if (
+    shouldRedirectHomeToApp(
+        window.location,
+        desktopRuntime,
+        window.navigator.userAgent,
+        hasLaunched()
+    )
+) {
+    window.history.replaceState(null, '', '/app');
+}
+
+const route = selectRoute(window.location.pathname, desktopRuntime);
+if (route === 'landing') {
+    applyHomeSeo();
+} else if (route === 'app') {
+    applyAppSeo();
+}
 
 createRoot(document.getElementById('root')!).render(
-    <StrictMode>
-        <App />
-    </StrictMode>
+    <StrictMode>{route === 'landing' ? <LandingPage /> : <App />}</StrictMode>
 );
diff --git a/tests/e2e/kromacut-flow.spec.ts b/tests/e2e/kromacut-flow.spec.ts
index c2dc50c..137f4eb 100644
--- a/tests/e2e/kromacut-flow.spec.ts
+++ b/tests/e2e/kromacut-flow.spec.ts
@@ -383,7 +383,7 @@ async function openApp(page: Page) {
         };
     });
 
-    await page.goto('/');
+    await page.goto('/app');
     await expect(page.getByTestId('image-file-input')).toBeAttached();
 }
 
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
new file mode 100644
index 0000000..fc1cf7e
--- /dev/null
+++ b/tests/e2e/landing.spec.ts
@@ -0,0 +1,36 @@
+import { expect, test } from '@playwright/test';
+
+test.describe('landing page smoke @smoke', () => {
+    test('landing CTA opens the tool and direct /app loading works', async ({ page }) => {
+        await page.addInitScript(() => localStorage.clear());
+
+        await page.goto('/');
+        await expect(page.getByTestId('landing-page')).toBeVisible();
+        await expect(page.getByRole('heading', { name: /Turn pixels into printable layers/i })).toBeVisible();
+        await expect(page.getByTestId('landing-open-app')).toHaveAttribute('href', '/app');
+
+        await page.getByTestId('landing-open-app').click();
+        await expect(page).toHaveURL(/\/app$/);
+        await expect(page.getByTestId('image-file-input')).toBeAttached();
+    });
+
+    test('landing bypass and same-origin storage survive navigation', async ({ page }) => {
+        await page.addInitScript(() => {
+            localStorage.clear();
+            localStorage.setItem('kromacut.autopaint.profiles', '[{"id":"smoke"}]');
+        });
+
+        await page.goto('/?landing=1');
+        await expect(page.getByTestId('landing-page')).toBeVisible();
+        await page.goto('/app');
+        await expect(page.getByTestId('image-file-input')).toBeAttached();
+        await expect.poll(() => page.evaluate(() => localStorage.getItem('kromacut.autopaint.profiles'))).toBe('[{"id":"smoke"}]');
+    });
+
+    test('docs direct loading keeps the docs shell', async ({ page }) => {
+        await page.goto('/docs/overview');
+        await expect(page.getByRole('main')).toBeVisible();
+        await expect(page.getByRole('heading', { name: 'Contents' })).toBeVisible();
+        await expect(page.getByText('Overview', { exact: true }).first()).toBeVisible();
+    });
+});
diff --git a/tests/routes.test.ts b/tests/routes.test.ts
new file mode 100644
index 0000000..1bdfbb8
--- /dev/null
+++ b/tests/routes.test.ts
@@ -0,0 +1,49 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+    APP_PATH,
+    DOCS_PATH,
+    LANDING_PATH,
+    appPath,
+    hasLandingBypass,
+    isCrawlerUserAgent,
+    selectRoute,
+    shouldRedirectHomeToApp,
+} from '../src/lib/routes.ts';
+
+test('selectRoute distinguishes web landing, app, docs, and desktop root', () => {
+    assert.equal(selectRoute('/'), 'landing');
+    assert.equal(selectRoute('/app'), 'app');
+    assert.equal(selectRoute('/app/'), 'app');
+    assert.equal(selectRoute('/docs'), 'docs');
+    assert.equal(selectRoute('/docs/quick-start'), 'docs');
+    assert.equal(selectRoute('/'), 'landing');
+    assert.equal(selectRoute('/', true), 'app');
+    assert.equal(selectRoute('/docs/overview', true), 'app');
+});
+
+test('route constants expose stable public paths', () => {
+    assert.equal(LANDING_PATH, '/');
+    assert.equal(APP_PATH, '/app');
+    assert.equal(DOCS_PATH, '/docs');
+    assert.equal(appPath(false), '/app');
+    assert.equal(appPath(true), '/');
+});
+
+test('returning users redirect only from the web home page', () => {
+    const returningHome = { pathname: '/', search: '' } as const;
+    assert.equal(shouldRedirectHomeToApp(returningHome, false, 'Mozilla/5.0', true), true);
+    assert.equal(shouldRedirectHomeToApp({ pathname: '/', search: '?landing=1' }, false, 'Mozilla/5.0', true), false);
+    assert.equal(shouldRedirectHomeToApp({ pathname: '/app', search: '' }, false, 'Mozilla/5.0', true), false);
+    assert.equal(shouldRedirectHomeToApp(returningHome, true, 'Mozilla/5.0', true), false);
+    assert.equal(shouldRedirectHomeToApp(returningHome, false, 'Googlebot/2.1', true), false);
+    assert.equal(shouldRedirectHomeToApp(returningHome, false, 'Mozilla/5.0', false), false);
+});
+
+test('landing bypass query parameter is explicit', () => {
+    assert.equal(hasLandingBypass('?landing=1'), true);
+    assert.equal(hasLandingBypass('?landing=0'), false);
+    assert.equal(hasLandingBypass(''), false);
+    assert.equal(isCrawlerUserAgent('facebookexternalhit/1.1'), true);
+    assert.equal(isCrawlerUserAgent('Mozilla/5.0'), false);
+});

From d0db1d507a5f4720ca2c21da99cdc6b680e6784a Mon Sep 17 00:00:00 2001
From: vycdev2 <vycdev2@users.noreply.github.com>
Date: Wed, 22 Jul 2026 01:54:05 +0000
Subject: [PATCH 70/81] fix: polish landing routes and accessibility

---
 src/components/Header.tsx       | 45 +++++++++++++++++++---
 src/components/LandingPage.tsx  | 41 +++++++++++---------
 src/lib/docs/navigation.ts      |  3 +-
 src/lib/routes.ts               |  5 +++
 src/main.tsx                    | 18 +++++++--
 tests/e2e/kromacut-flow.spec.ts |  3 +-
 tests/e2e/landing.spec.ts       | 67 ++++++++++++++++++++++++++++++---
 tests/routes.test.ts            |  3 ++
 8 files changed, 151 insertions(+), 34 deletions(-)

diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 5941bbe..9deb53f 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -5,6 +5,7 @@ import {
     BookOpen,
     CheckCircle2,
     Download,
+    Github,
     Heart,
     Loader2,
     Moon,
@@ -13,6 +14,7 @@ import {
     Settings,
     X,
     Monitor,
+    MessageCircle,
 } from 'lucide-react';
 import { cn } from '@/lib/utils';
 import { Switch } from '@/components/ui/switch';
@@ -37,8 +39,6 @@ import {
     subscribeToUpdateCheckOnStartup,
 } from '@/lib/updatePreferences';
 import logo from '../assets/logo.png';
-import discordIcon from '../assets/discord.svg';
-import githubIcon from '../assets/github.svg';
 import redditIcon from '../assets/reddit.svg';
 import { appPath } from '@/lib/routes';
 import { isTauri } from '@tauri-apps/api/core';
@@ -62,18 +62,51 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
     const settingsTitleId = React.useId();
     const updateStartupSwitchId = React.useId();
     const isDesktopApp = isDesktopUpdateSupported();
+    const settingsButtonRef = React.useRef<HTMLButtonElement>(null);
+    const settingsDialogRef = React.useRef<HTMLDivElement>(null);
 
     React.useEffect(() => {
         if (!settingsOpen) return;
 
+        const previouslyFocused = document.activeElement as HTMLElement | null;
+        const settingsTrigger = settingsButtonRef.current;
+        const dialog = settingsDialogRef.current;
+        const getFocusable = () =>
+            Array.from(
+                dialog?.querySelectorAll<HTMLElement>(
+                    'a[href], button:not([disabled]), input:not([disabled]), [tabindex]:not([tabindex="-1"])'
+                ) ?? []
+            );
+        getFocusable()[0]?.focus();
+
         const handleKeyDown = (event: KeyboardEvent) => {
             if (event.key === 'Escape') {
                 setSettingsOpen(false);
+                return;
+            }
+            if (event.key !== 'Tab') return;
+
+            const focusable = getFocusable();
+            if (focusable.length === 0) {
+                event.preventDefault();
+                return;
+            }
+            const first = focusable[0];
+            const last = focusable[focusable.length - 1];
+            if (event.shiftKey && document.activeElement === first) {
+                event.preventDefault();
+                last.focus();
+            } else if (!event.shiftKey && document.activeElement === last) {
+                event.preventDefault();
+                first.focus();
             }
         };
 
         window.addEventListener('keydown', handleKeyDown);
-        return () => window.removeEventListener('keydown', handleKeyDown);
+        return () => {
+            window.removeEventListener('keydown', handleKeyDown);
+            (previouslyFocused?.isConnected ? previouslyFocused : settingsTrigger)?.focus();
+        };
     }, [settingsOpen]);
 
     React.useEffect(() => {
@@ -198,6 +231,7 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                     </a>
                 </Button>
                 <Button
+                    ref={settingsButtonRef}
                     size="icon"
                     onClick={() => setSettingsOpen(true)}
                     title="Open settings"
@@ -213,6 +247,7 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                     onClick={() => setSettingsOpen(false)}
                 >
                     <div
+                        ref={settingsDialogRef}
                         role="dialog"
                         aria-modal="true"
                         aria-labelledby={settingsTitleId}
@@ -313,7 +348,7 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                                     onClick={() => setSettingsOpen(false)}
                                     className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
                                 >
-                                    <img src={discordIcon} alt="" className="mt-0.5 h-4 w-4 brightness-0 invert" /><span><span className="block text-sm font-semibold">Discord</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Join the Kromacut community.</span></span>
+                                    <MessageCircle aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-indigo-500" /><span><span className="block text-sm font-semibold">Discord</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Join the Kromacut community.</span></span>
                                 </a>
                                 <a
                                     href="https://github.com/vycdev/Kromacut"
@@ -322,7 +357,7 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                                     onClick={() => setSettingsOpen(false)}
                                     className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
                                 >
-                                    <img src={githubIcon} alt="" className="mt-0.5 h-4 w-4 brightness-0 invert" /><span><span className="block text-sm font-semibold">GitHub</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">View the source and report issues.</span></span>
+                                    <Github aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-foreground" /><span><span className="block text-sm font-semibold">GitHub</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">View the source and report issues.</span></span>
                                 </a>
                                 <a
                                     href="https://www.patreon.com/cw/vycdev"
diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
index 5bfcabe..691e527 100644
--- a/src/components/LandingPage.tsx
+++ b/src/components/LandingPage.tsx
@@ -15,7 +15,7 @@ import fuji2d from '../../content/fuji2d_new.png';
 import fuji3d from '../../content/fuji3d_new.png';
 import sliced from '../../content/fuji3dsliced.png';
 import printed from '../../content/printed.jpg';
-import { APP_PATH } from '@/lib/routes';
+import { APP_PATH, docsPath } from '@/lib/routes';
 
 const links = {
     releases: 'https://github.com/vycdev/Kromacut/releases',
@@ -61,7 +61,7 @@ function ExternalArrow() {
 
 export default function LandingPage() {
     return (
-        <main data-testid="landing-page" className="min-h-screen overflow-hidden bg-background text-foreground">
+        <main data-testid="landing-page" className="h-full overflow-x-hidden overflow-y-auto bg-background text-foreground">
             <a
                 href="#workflow"
                 className="sr-only z-50 rounded-md bg-primary px-4 py-2 text-primary-foreground focus:not-sr-only focus:fixed focus:left-4 focus:top-4"
@@ -76,28 +76,33 @@ export default function LandingPage() {
                     <div className="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,0.06)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,0.06)_1px,transparent_1px)] bg-[size:3rem_3rem] [mask-image:linear-gradient(to_bottom,black,transparent_88%)]" />
                 </div>
 
-                <header className="mx-auto flex max-w-7xl items-center justify-between gap-6 px-5 py-5 sm:px-8 lg:px-10">
+                <header className="mx-auto flex max-w-7xl flex-wrap items-center justify-between gap-3 px-5 py-5 sm:gap-6 sm:px-8 lg:px-10">
                     <a href={APP_PATH} className="flex items-center gap-3 rounded-lg focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
-                        <img src={logo} alt="Kromacut" className="h-10 w-auto" />
-                        <span className="font-sans text-lg font-extrabold tracking-[0.12em]">KROMACUT</span>
+                        <img src={logo} alt="" className="h-9 w-auto sm:h-10" />
+                        <span className="hidden font-sans text-lg font-extrabold tracking-[0.12em] min-[390px]:inline">KROMACUT</span>
                     </a>
                     <nav aria-label="Main navigation" className="hidden items-center gap-7 text-sm font-semibold text-muted-foreground md:flex">
                         <a href="#workflow" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
-                        <a href="/docs/overview" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                        <a href={docsPath('overview')} className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
                         <a href={links.releases} target="_blank" rel="noopener noreferrer" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
                     <a
                         href={APP_PATH}
                         data-testid="landing-open-app"
-                        className="group inline-flex min-h-11 items-center gap-2 rounded-lg bg-foreground px-4 py-2 text-sm font-bold text-background shadow-lg shadow-foreground/10 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background active:translate-y-0"
+                        className="group inline-flex min-h-11 items-center gap-2 rounded-lg bg-foreground px-3 py-2 text-sm font-bold text-background shadow-lg shadow-foreground/10 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background motion-safe:transition-transform motion-safe:hover:-translate-y-0.5 motion-safe:active:translate-y-0 sm:px-4"
                     >
                         Open Kromacut <ExternalArrow />
                     </a>
+                    <nav aria-label="Mobile navigation" className="order-last flex w-full items-center justify-between border-t border-border/70 pt-3 text-xs font-semibold text-muted-foreground md:hidden">
+                        <a href="#workflow" className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
+                        <a href={docsPath('overview')} className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
+                    </nav>
                 </header>
 
                 <section className="mx-auto grid max-w-7xl items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
                     <div className="max-w-2xl">
-                        <div className="mb-6 inline-flex items-center gap-2 rounded-full border border-primary/30 bg-primary/10 px-3 py-1.5 text-xs font-bold uppercase tracking-[0.16em] text-primary">
+                        <div className="mb-6 inline-flex items-center gap-2 rounded-full border border-primary/30 bg-primary/10 px-3 py-1.5 text-xs font-bold uppercase tracking-[0.16em] text-blue-700 dark:text-blue-300">
                             <Sparkles aria-hidden="true" className="h-3.5 w-3.5" />
                             Open source · browser first
                         </div>
@@ -108,10 +113,10 @@ export default function LandingPage() {
                             Kromacut transforms 2D images into stacked, color-layered 3D prints. Prepare your palette, match real filament, preview the result, and export a model ready for your slicer.
                         </p>
                         <div className="mt-9 flex flex-col gap-3 sm:flex-row sm:items-center">
-                            <a href={APP_PATH} className="group inline-flex min-h-12 items-center justify-center gap-2 rounded-lg bg-primary px-5 py-3 font-bold text-primary-foreground shadow-xl shadow-primary/20 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background active:translate-y-0">
+                            <a href={APP_PATH} className="group inline-flex min-h-12 items-center justify-center gap-2 rounded-lg bg-primary px-5 py-3 font-bold text-primary-foreground shadow-xl shadow-primary/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background motion-safe:transition-transform motion-safe:hover:-translate-y-0.5 motion-safe:active:translate-y-0">
                                 Start creating <ExternalArrow />
                             </a>
-                            <a href="/docs/quick-start" className="inline-flex min-h-12 items-center justify-center gap-2 rounded-lg border border-border bg-card/60 px-5 py-3 font-bold text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
+                            <a href={docsPath('quick-start')} className="inline-flex min-h-12 items-center justify-center gap-2 rounded-lg border border-border bg-card/60 px-5 py-3 font-bold text-foreground transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
                                 <BookOpen aria-hidden="true" className="h-4 w-4" /> Read the quick start
                             </a>
                         </div>
@@ -123,7 +128,7 @@ export default function LandingPage() {
                     </div>
 
                     <div className="relative mx-auto w-full max-w-2xl lg:ml-auto">
-                        <div aria-hidden="true" className="absolute -inset-8 rounded-[2rem] bg-primary/10 blur-3xl" />
+                        <div aria-hidden="true" className="absolute inset-0 rounded-[2rem] bg-primary/10 blur-3xl sm:-inset-8" />
                         <div className="relative overflow-hidden rounded-2xl border border-white/10 bg-card/80 p-2 shadow-2xl shadow-black/30 backdrop-blur">
                             <div className="flex items-center justify-between border-b border-border px-3 py-2.5 text-[10px] font-bold uppercase tracking-[0.18em] text-muted-foreground">
                                 <span>3D layer preview</span>
@@ -148,10 +153,10 @@ export default function LandingPage() {
                 </section>
             </div>
 
-            <section id="workflow" className="scroll-mt-8 border-y border-border/70 bg-card/30">
+            <section id="workflow" tabIndex={-1} className="scroll-mt-8 border-y border-border/70 bg-card/30 focus:outline-none">
                 <div className="mx-auto max-w-7xl px-5 py-20 sm:px-8 lg:px-10 lg:py-28">
                     <div className="max-w-2xl">
-                        <p className="text-xs font-bold uppercase tracking-[0.2em] text-primary">From image to object</p>
+                        <p className="text-xs font-bold uppercase tracking-[0.2em] text-blue-700 dark:text-blue-300">From image to object</p>
                         <h2 className="mt-4 text-3xl font-extrabold tracking-tight sm:text-5xl">A simple workflow, with serious control.</h2>
                         <p className="mt-5 text-lg leading-8 text-muted-foreground">Go from a flat image to a layered print without leaving your browser. Keep the creative decisions yours, while Kromacut handles the geometry and print planning.</p>
                     </div>
@@ -159,7 +164,7 @@ export default function LandingPage() {
                         {workflow.map((step) => (
                             <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1">
                                 <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover transition-transform duration-500 motion-safe:group-hover:scale-105" /></div>
-                                <div className="p-5"><div className="font-mono text-xs font-bold text-primary">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
+                                <div className="p-5"><div className="font-mono text-xs font-bold text-blue-700 dark:text-blue-300">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
                             </article>
                         ))}
                     </div>
@@ -173,27 +178,27 @@ export default function LandingPage() {
                     <div className="absolute left-1/2 top-1/2 hidden -translate-x-1/2 -translate-y-1/2 rounded-full border border-border bg-background p-3 text-primary shadow-lg sm:block"><ArrowRight aria-hidden="true" className="h-5 w-5" /></div>
                 </div>
                 <div className="max-w-xl">
-                    <p className="text-xs font-bold uppercase tracking-[0.2em] text-primary">Built for real prints</p>
+                    <p className="text-xs font-bold uppercase tracking-[0.2em] text-blue-700 dark:text-blue-300">Built for real prints</p>
                     <h2 className="mt-4 text-3xl font-extrabold tracking-tight sm:text-5xl">Your filament. Your palette. Your model.</h2>
                     <p className="mt-5 text-lg leading-8 text-muted-foreground">Use manual slicing when you want pixel-level control, or let Auto-paint search for a color stack from your calibrated filament profile. Either way, inspect every layer before you export.</p>
                     <ul className="mt-7 space-y-3 text-sm text-foreground">
                         {['Non-destructive image adjustments', 'Three.js layer-by-layer 3D preview', 'Calibrated Auto-paint with deterministic search', 'Slicer-friendly STL and multi-material 3MF'].map((item) => <li key={item} className="flex items-start gap-3"><Check aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-emerald-400" />{item}</li>)}
                     </ul>
-                    <a href={APP_PATH} className="mt-9 inline-flex items-center gap-2 font-bold text-primary underline decoration-primary/30 underline-offset-4 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Open the tool <ExternalArrow /></a>
+                    <a href={APP_PATH} className="mt-9 inline-flex items-center gap-2 font-bold text-blue-700 underline decoration-blue-700/30 underline-offset-4 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring dark:text-blue-300 dark:decoration-blue-300/30">Open the tool <ExternalArrow /></a>
                 </div>
             </section>
 
             <section className="border-t border-border/70 bg-muted/20">
                 <div className="mx-auto flex max-w-7xl flex-col items-start justify-between gap-8 px-5 py-14 sm:px-8 md:flex-row md:items-center lg:px-10">
                     <div><p className="text-2xl font-extrabold tracking-tight sm:text-3xl">Ready to make a flat image physical?</p><p className="mt-2 text-muted-foreground">Start with an image. Finish with a print.</p></div>
-                    <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-primary px-5 py-2.5 font-bold text-primary-foreground shadow-lg shadow-primary/20 transition-transform hover:-translate-y-0.5 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
+                    <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-primary px-5 py-2.5 font-bold text-primary-foreground shadow-lg shadow-primary/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-safe:transition-transform motion-safe:hover:-translate-y-0.5">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
                 </div>
             </section>
 
             <footer className="mx-auto flex max-w-7xl flex-col gap-8 px-5 py-10 sm:px-8 md:flex-row md:items-end md:justify-between lg:px-10">
                 <div><a href={APP_PATH} className="inline-flex items-center gap-3 font-bold focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><img src={logo} alt="" className="h-8 w-auto" /> Kromacut</a><p className="mt-3 max-w-sm text-sm leading-6 text-muted-foreground">Open-source tools for turning images into color-layered 3D prints.</p></div>
                 <nav aria-label="Footer navigation" className="grid grid-cols-2 gap-x-10 gap-y-3 text-sm text-muted-foreground sm:flex sm:flex-wrap sm:justify-end sm:gap-x-6">
-                    <a href="/docs/overview" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><BookOpen aria-hidden="true" className="h-4 w-4" /> Docs</a>
+                    <a href={docsPath('overview')} className="inline-flex items-center gap-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><BookOpen aria-hidden="true" className="h-4 w-4" /> Docs</a>
                     <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Releases</a>
                     <a href={links.github} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Github aria-hidden="true" className="h-4 w-4" /> GitHub</a>
                     <a href={links.discord} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><MessageCircle aria-hidden="true" className="h-4 w-4" /> Discord</a>
diff --git a/src/lib/docs/navigation.ts b/src/lib/docs/navigation.ts
index 2b991f7..e68efb1 100644
--- a/src/lib/docs/navigation.ts
+++ b/src/lib/docs/navigation.ts
@@ -1,6 +1,5 @@
 import type { DocLinkTarget, DocRecord } from '@/types/docs';
-
-const DOCS_PATH_PREFIX = '/docs';
+import { DOCS_PATH as DOCS_PATH_PREFIX } from '@/lib/routes';
 
 function cleanDocSlug(value: string): string {
     return value
diff --git a/src/lib/routes.ts b/src/lib/routes.ts
index 5c09ef5..89081f1 100644
--- a/src/lib/routes.ts
+++ b/src/lib/routes.ts
@@ -62,3 +62,8 @@ export function shouldRedirectHomeToApp(
 export function appPath(isTauri: boolean): string {
     return isTauri ? LANDING_PATH : APP_PATH;
 }
+
+export function docsPath(slug = ''): string {
+    const normalizedSlug = slug.trim().replace(/^\/+|\/+$/g, '');
+    return normalizedSlug ? `${DOCS_PATH}/${normalizedSlug}` : DOCS_PATH;
+}
diff --git a/src/main.tsx b/src/main.tsx
index 2e28b01..04536a6 100644
--- a/src/main.tsx
+++ b/src/main.tsx
@@ -1,8 +1,7 @@
-import { StrictMode } from 'react';
+import { lazy, StrictMode, Suspense } from 'react';
 import { createRoot } from 'react-dom/client';
 import { isTauri } from '@tauri-apps/api/core';
 import './index.css';
-import App from './App.tsx';
 import LandingPage from './components/LandingPage.tsx';
 import { applyThemeMode, getStoredThemeMode } from './lib/theme';
 import { applyAppSeo, applyHomeSeo } from './lib/seo';
@@ -28,6 +27,7 @@ if (
 }
 
 const route = selectRoute(window.location.pathname, desktopRuntime);
+const App = lazy(() => import('./App.tsx'));
 if (route === 'landing') {
     applyHomeSeo();
 } else if (route === 'app') {
@@ -35,5 +35,17 @@ if (route === 'landing') {
 }
 
 createRoot(document.getElementById('root')!).render(
-    <StrictMode>{route === 'landing' ? <LandingPage /> : <App />}</StrictMode>
+    <StrictMode>
+        {route === 'landing' ? (
+            <LandingPage />
+        ) : (
+            <Suspense
+                fallback={
+                    <div className="min-h-screen bg-background" aria-label="Loading Kromacut" />
+                }
+            >
+                <App />
+            </Suspense>
+        )}
+    </StrictMode>
 );
diff --git a/tests/e2e/kromacut-flow.spec.ts b/tests/e2e/kromacut-flow.spec.ts
index 137f4eb..46fcf76 100644
--- a/tests/e2e/kromacut-flow.spec.ts
+++ b/tests/e2e/kromacut-flow.spec.ts
@@ -279,7 +279,8 @@ async function runFlow(
             });
 
             await setSwitch(page, 'autopaint-enhanced-color-match', true);
-            await setSwitch(page, 'autopaint-allow-repeated-swaps', true);
+            await page.getByRole('combobox', { name: 'Extra repeated swaps' }).click();
+            await page.getByRole('option', { name: '2 extra swaps', exact: true }).click();
             await setSwitch(page, 'autopaint-height-dithering', true);
 
             await waitForAutoPaintIdle(
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
index fc1cf7e..0f21e5a 100644
--- a/tests/e2e/landing.spec.ts
+++ b/tests/e2e/landing.spec.ts
@@ -12,19 +12,76 @@ test.describe('landing page smoke @smoke', () => {
         await page.getByTestId('landing-open-app').click();
         await expect(page).toHaveURL(/\/app$/);
         await expect(page.getByTestId('image-file-input')).toBeAttached();
+        await expect.poll(() => page.evaluate(() => localStorage.getItem('kromacut.has-launched.v1'))).toBe('v1');
     });
 
     test('landing bypass and same-origin storage survive navigation', async ({ page }) => {
-        await page.addInitScript(() => {
-            localStorage.clear();
-            localStorage.setItem('kromacut.autopaint.profiles', '[{"id":"smoke"}]');
-        });
+        const persisted = {
+            'kromacut.autopaint.profiles': '[{"id":"smoke"}]',
+            'kromacut.palettes': '[{"id":"palette-smoke"}]',
+            'kromacut:3d-print-settings': '{"layerHeight":0.2}',
+            'kromacut.autopaint.v1': '{"schemaVersion":2,"filaments":[]}',
+            'kromacut:3d-preview-mode': 'layered',
+            theme: 'dark',
+        };
+        await page.addInitScript((values) => {
+            if (!sessionStorage.getItem('kromacut-e2e-seeded')) {
+                localStorage.clear();
+                Object.entries(values).forEach(([key, value]) => localStorage.setItem(key, value));
+                sessionStorage.setItem('kromacut-e2e-seeded', '1');
+            }
+        }, persisted);
 
         await page.goto('/?landing=1');
         await expect(page.getByTestId('landing-page')).toBeVisible();
         await page.goto('/app');
         await expect(page.getByTestId('image-file-input')).toBeAttached();
-        await expect.poll(() => page.evaluate(() => localStorage.getItem('kromacut.autopaint.profiles'))).toBe('[{"id":"smoke"}]');
+        await expect.poll(() => page.evaluate((keys) =>
+            keys.every((key) => localStorage.getItem(key) !== null),
+        Object.keys(persisted))).toBe(true);
+
+        await page.goto('/');
+        await expect(page).toHaveURL(/\/app$/);
+        await page.goto('/?landing=1');
+        await expect(page.getByTestId('landing-page')).toBeVisible();
+    });
+
+    test('mobile landing navigation fits and remains keyboard accessible', async ({ page }) => {
+        await page.setViewportSize({ width: 320, height: 720 });
+        await page.addInitScript(() => localStorage.clear());
+        await page.goto('/');
+
+        await expect(page.getByRole('navigation', { name: 'Mobile navigation' })).toBeVisible();
+        await expect(page.getByTestId('landing-open-app')).toBeVisible();
+        expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(320);
+        await expect.poll(() => page.getByTestId('landing-page').evaluate(
+            (landing) => landing.scrollHeight > landing.clientHeight
+        )).toBe(true);
+
+        await page.keyboard.press('Tab');
+        await expect(page.getByText('Skip to workflow', { exact: true })).toBeFocused();
+        await page.keyboard.press('Enter');
+        await expect(page.locator('#workflow')).toBeFocused();
+    });
+
+    test('settings resources are keyboard-modal and restore focus', async ({ page }) => {
+        await page.goto('/app');
+        const settingsButton = page.getByRole('button', { name: 'Open settings' });
+        await settingsButton.click();
+
+        const dialog = page.getByRole('dialog', { name: 'Settings' });
+        await expect(dialog).toBeVisible();
+        await expect(page.getByRole('button', { name: 'Close settings' })).toBeFocused();
+        await expect(dialog.getByRole('button', { name: /Docs/ })).toBeVisible();
+        await expect(dialog.getByRole('link', { name: /Discord/ })).toBeVisible();
+        await expect(dialog.getByRole('link', { name: /GitHub/ })).toBeVisible();
+        await expect(dialog.getByRole('link', { name: /Support Me/ })).toBeVisible();
+
+        await page.keyboard.press('Shift+Tab');
+        await expect(dialog.getByRole('link', { name: /Support Me/ })).toBeFocused();
+        await page.keyboard.press('Escape');
+        await expect(dialog).toBeHidden();
+        await expect(settingsButton).toBeFocused();
     });
 
     test('docs direct loading keeps the docs shell', async ({ page }) => {
diff --git a/tests/routes.test.ts b/tests/routes.test.ts
index 1bdfbb8..c4a1464 100644
--- a/tests/routes.test.ts
+++ b/tests/routes.test.ts
@@ -5,6 +5,7 @@ import {
     DOCS_PATH,
     LANDING_PATH,
     appPath,
+    docsPath,
     hasLandingBypass,
     isCrawlerUserAgent,
     selectRoute,
@@ -28,6 +29,8 @@ test('route constants expose stable public paths', () => {
     assert.equal(DOCS_PATH, '/docs');
     assert.equal(appPath(false), '/app');
     assert.equal(appPath(true), '/');
+    assert.equal(docsPath(), '/docs');
+    assert.equal(docsPath('/quick-start/'), '/docs/quick-start');
 });
 
 test('returning users redirect only from the web home page', () => {

From e0ad9a10876a928f812c4aa18aea0f848db9eb99 Mon Sep 17 00:00:00 2001
From: vycdev2 <vycdev2@users.noreply.github.com>
Date: Wed, 22 Jul 2026 07:40:33 +0000
Subject: [PATCH 71/81] fix: harden landing accessibility and static docs

---
 scripts/generate-docs-seo-pages.mjs | 81 +++++++++++++++++++++++++++--
 src/App.tsx                         |  6 ++-
 src/components/LandingPage.tsx      | 34 ++++++------
 src/index.css                       |  5 +-
 tests/e2e/landing.spec.ts           | 14 +++--
 5 files changed, 112 insertions(+), 28 deletions(-)

diff --git a/scripts/generate-docs-seo-pages.mjs b/scripts/generate-docs-seo-pages.mjs
index 6f078c3..07b3893 100644
--- a/scripts/generate-docs-seo-pages.mjs
+++ b/scripts/generate-docs-seo-pages.mjs
@@ -110,6 +110,15 @@ function resolveDocImage(src) {
     if (clean.includes('kromacut-logo.png')) {
         return findBuiltAsset('logo-') ?? clean;
     }
+    const diagramPrefixes = {
+        '06_frontlit_hiding_distance.svg': '06_frontlit_hiding_distance-',
+        '07_calibration_wedge.svg': '07_calibration_wedge-',
+        '08_opacity_solve.svg': '08_opacity_solve-',
+    };
+    const diagramName = Object.keys(diagramPrefixes).find((name) => clean.includes(name));
+    if (diagramName) {
+        return findBuiltAsset(diagramPrefixes[diagramName]) ?? clean;
+    }
     return clean;
 }
 
@@ -136,12 +145,20 @@ function resolveDocHref(href, currentDocSlug, docsBySlug) {
 
 function renderInline(markdown, currentDocSlug, docsBySlug) {
     let html = escapeHtml(markdown);
+    const protectedHtml = [];
+    const protect = (value) => {
+        const token = `\u0000${protectedHtml.length}\u0000`;
+        protectedHtml.push(value);
+        return token;
+    };
+
+    html = html.replace(/`([^`]+)`/g, (_match, code) => protect(`<code>${code}</code>`));
 
     html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, (_match, alt, rawSrc) => {
         const [srcPart, titlePart] = rawSrc.trim().split(/\s+["']/);
         const title = titlePart ? titlePart.replace(/["']$/, '') : '';
         const titleAttr = title ? ` title="${escapeHtml(title)}"` : '';
-        return `<img src="${escapeHtml(resolveDocImage(srcPart))}" alt="${escapeHtml(alt)}"${titleAttr} loading="lazy">`;
+        return protect(`<img src="${escapeHtml(resolveDocImage(srcPart))}" alt="${escapeHtml(alt)}"${titleAttr} loading="lazy">`);
     });
 
     html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_match, label, href) => {
@@ -149,16 +166,15 @@ function renderInline(markdown, currentDocSlug, docsBySlug) {
         const externalAttrs = /^(https?:|mailto:)/i.test(resolved)
             ? ' target="_blank" rel="noopener noreferrer"'
             : '';
-        return `<a href="${escapeHtml(resolved)}"${externalAttrs}>${renderInline(label, currentDocSlug, docsBySlug)}</a>`;
+        return protect(`<a href="${escapeHtml(resolved)}"${externalAttrs}>${renderInline(label, currentDocSlug, docsBySlug)}</a>`);
     });
 
-    html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
     html = html.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>');
     html = html.replace(/__([^_]+)__/g, '<strong>$1</strong>');
     html = html.replace(/\*([^*]+)\*/g, '<em>$1</em>');
     html = html.replace(/_([^_]+)_/g, '<em>$1</em>');
 
-    return html;
+    return html.replace(/\u0000(\d+)\u0000/g, (_match, index) => protectedHtml[Number(index)]);
 }
 
 function isBlockStart(line) {
@@ -409,6 +425,62 @@ function writeRobots() {
     );
 }
 
+function verifyGeneratedOutput(docs) {
+    const requiredFiles = [
+        'index.html',
+        'app/index.html',
+        'docs/index.html',
+        'robots.txt',
+        'sitemap.xml',
+        'site.webmanifest',
+        'version.json',
+    ];
+    const assertGenerated = (condition, message) => {
+        if (!condition) throw new Error(`Generated output verification failed: ${message}`);
+    };
+
+    requiredFiles.forEach((file) => {
+        assertGenerated(existsSync(path.join(distDir, file)), `missing dist/${file}`);
+    });
+
+    const rootHtml = readFileSync(path.join(distDir, 'index.html'), 'utf8');
+    const appHtml = readFileSync(path.join(distDir, 'app', 'index.html'), 'utf8');
+    const sitemap = readFileSync(path.join(distDir, 'sitemap.xml'), 'utf8');
+    const robots = readFileSync(path.join(distDir, 'robots.txt'), 'utf8');
+    const manifest = JSON.parse(readFileSync(path.join(distDir, 'site.webmanifest'), 'utf8'));
+    const version = JSON.parse(readFileSync(path.join(distDir, 'version.json'), 'utf8'));
+
+    assertGenerated(rootHtml.includes('<link rel="canonical" href="https://kromacut.com/"'), 'root canonical URL is missing');
+    assertGenerated(/(?:src|href)="\/assets\//.test(rootHtml), 'root does not use root-relative built assets');
+    assertGenerated(appHtml.includes('<meta name="robots" content="noindex,nofollow"'), '/app noindex metadata is missing');
+    assertGenerated(appHtml.includes('<link rel="canonical" href="https://kromacut.com/app"'), '/app canonical URL is missing');
+    assertGenerated(sitemap.includes('<loc>https://kromacut.com/</loc>'), 'root is missing from sitemap');
+    assertGenerated(!sitemap.includes('https://kromacut.com/app'), '/app must not appear in sitemap');
+    assertGenerated(robots.includes('Sitemap: https://kromacut.com/sitemap.xml'), 'robots.txt sitemap reference is missing');
+    assertGenerated(manifest.start_url === '/app', 'manifest start_url must be /app');
+    assertGenerated(manifest.id === '/', 'manifest id must remain stable at /');
+    assertGenerated(typeof version.version === 'string' && version.version.length > 0, 'version.json is invalid');
+
+    docs.forEach((doc) => {
+        const relativePage = path.join('docs', doc.slug, 'index.html');
+        const pagePath = path.join(distDir, relativePage);
+        assertGenerated(existsSync(pagePath), `missing dist/${relativePage}`);
+        const html = readFileSync(pagePath, 'utf8');
+        assertGenerated(
+            html.includes(`<link rel="canonical" href="${siteUrl}/docs/${doc.slug}"`),
+            `canonical URL is missing for ${doc.slug}`
+        );
+
+        for (const match of html.matchAll(/<img\s+[^>]*src="([^"]+)"/g)) {
+            const src = match[1];
+            if (/^(https?:|data:)/i.test(src)) continue;
+            assertGenerated(!src.includes('<') && !src.includes('>'), `malformed image URL in ${doc.slug}: ${src}`);
+            assertGenerated(src.startsWith('/'), `image URL is not root-relative in ${doc.slug}: ${src}`);
+            assertGenerated(existsSync(path.join(distDir, src.slice(1))), `missing image used by ${doc.slug}: ${src}`);
+        }
+    });
+}
+
 if (!existsSync(distIndexPath)) {
     throw new Error('dist/index.html was not found. Run this script after vite build.');
 }
@@ -423,3 +495,4 @@ if (overviewDoc) writeDocPage(template, overviewDoc, docs, docsBySlug, '');
 writeAppPage(template);
 writeSitemap(docs);
 writeRobots();
+verifyGeneratedOutput(docs);
diff --git a/src/App.tsx b/src/App.tsx
index 1b64667..eae9bcc 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -384,8 +384,10 @@ function App(): React.ReactElement | null {
     }, []);
 
     useEffect(() => {
-        markLaunched();
-    }, []);
+        if (!docsOpen) {
+            markLaunched();
+        }
+    }, [docsOpen]);
 
     useEffect(() => {
         if (!docsOpen) {
diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
index 691e527..f737204 100644
--- a/src/components/LandingPage.tsx
+++ b/src/components/LandingPage.tsx
@@ -64,7 +64,7 @@ export default function LandingPage() {
         <main data-testid="landing-page" className="h-full overflow-x-hidden overflow-y-auto bg-background text-foreground">
             <a
                 href="#workflow"
-                className="sr-only z-50 rounded-md bg-primary px-4 py-2 text-primary-foreground focus:not-sr-only focus:fixed focus:left-4 focus:top-4"
+                className="sr-only z-50 rounded-md bg-blue-700 px-4 py-2 font-semibold text-white focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-blue-700"
             >
                 Skip to workflow
             </a>
@@ -82,9 +82,9 @@ export default function LandingPage() {
                         <span className="hidden font-sans text-lg font-extrabold tracking-[0.12em] min-[390px]:inline">KROMACUT</span>
                     </a>
                     <nav aria-label="Main navigation" className="hidden items-center gap-7 text-sm font-semibold text-muted-foreground md:flex">
-                        <a href="#workflow" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
-                        <a href={docsPath('overview')} className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
-                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
+                        <a href="#workflow" className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
+                        <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
                     <a
                         href={APP_PATH}
@@ -94,9 +94,9 @@ export default function LandingPage() {
                         Open Kromacut <ExternalArrow />
                     </a>
                     <nav aria-label="Mobile navigation" className="order-last flex w-full items-center justify-between border-t border-border/70 pt-3 text-xs font-semibold text-muted-foreground md:hidden">
-                        <a href="#workflow" className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
-                        <a href={docsPath('overview')} className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
-                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="rounded-sm hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
+                        <a href="#workflow" className="inline-flex min-h-11 items-center rounded-md px-1 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
+                        <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-1 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
                 </header>
 
@@ -113,7 +113,7 @@ export default function LandingPage() {
                             Kromacut transforms 2D images into stacked, color-layered 3D prints. Prepare your palette, match real filament, preview the result, and export a model ready for your slicer.
                         </p>
                         <div className="mt-9 flex flex-col gap-3 sm:flex-row sm:items-center">
-                            <a href={APP_PATH} className="group inline-flex min-h-12 items-center justify-center gap-2 rounded-lg bg-primary px-5 py-3 font-bold text-primary-foreground shadow-xl shadow-primary/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background motion-safe:transition-transform motion-safe:hover:-translate-y-0.5 motion-safe:active:translate-y-0">
+                            <a href={APP_PATH} className="group inline-flex min-h-12 items-center justify-center gap-2 rounded-lg bg-blue-700 px-5 py-3 font-bold text-white shadow-xl shadow-blue-700/20 hover:bg-blue-800 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background motion-safe:transition motion-safe:hover:-translate-y-0.5 motion-safe:active:translate-y-0 motion-reduce:transition-none">
                                 Start creating <ExternalArrow />
                             </a>
                             <a href={docsPath('quick-start')} className="inline-flex min-h-12 items-center justify-center gap-2 rounded-lg border border-border bg-card/60 px-5 py-3 font-bold text-foreground transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
@@ -153,7 +153,7 @@ export default function LandingPage() {
                 </section>
             </div>
 
-            <section id="workflow" tabIndex={-1} className="scroll-mt-8 border-y border-border/70 bg-card/30 focus:outline-none">
+            <section id="workflow" tabIndex={-1} className="scroll-mt-8 border-y border-border/70 bg-card/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring">
                 <div className="mx-auto max-w-7xl px-5 py-20 sm:px-8 lg:px-10 lg:py-28">
                     <div className="max-w-2xl">
                         <p className="text-xs font-bold uppercase tracking-[0.2em] text-blue-700 dark:text-blue-300">From image to object</p>
@@ -162,8 +162,8 @@ export default function LandingPage() {
                     </div>
                     <div className="mt-14 grid gap-5 sm:grid-cols-2 lg:grid-cols-4">
                         {workflow.map((step) => (
-                            <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1">
-                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover transition-transform duration-500 motion-safe:group-hover:scale-105" /></div>
+                            <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1 motion-reduce:transition-none">
+                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover transition-transform duration-500 motion-safe:group-hover:scale-105 motion-reduce:transition-none" /></div>
                                 <div className="p-5"><div className="font-mono text-xs font-bold text-blue-700 dark:text-blue-300">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
                             </article>
                         ))}
@@ -191,18 +191,18 @@ export default function LandingPage() {
             <section className="border-t border-border/70 bg-muted/20">
                 <div className="mx-auto flex max-w-7xl flex-col items-start justify-between gap-8 px-5 py-14 sm:px-8 md:flex-row md:items-center lg:px-10">
                     <div><p className="text-2xl font-extrabold tracking-tight sm:text-3xl">Ready to make a flat image physical?</p><p className="mt-2 text-muted-foreground">Start with an image. Finish with a print.</p></div>
-                    <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-primary px-5 py-2.5 font-bold text-primary-foreground shadow-lg shadow-primary/20 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-safe:transition-transform motion-safe:hover:-translate-y-0.5">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
+                    <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-blue-700 px-5 py-2.5 font-bold text-white shadow-lg shadow-blue-700/20 hover:bg-blue-800 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-safe:transition motion-safe:hover:-translate-y-0.5 motion-reduce:transition-none">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
                 </div>
             </section>
 
             <footer className="mx-auto flex max-w-7xl flex-col gap-8 px-5 py-10 sm:px-8 md:flex-row md:items-end md:justify-between lg:px-10">
                 <div><a href={APP_PATH} className="inline-flex items-center gap-3 font-bold focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><img src={logo} alt="" className="h-8 w-auto" /> Kromacut</a><p className="mt-3 max-w-sm text-sm leading-6 text-muted-foreground">Open-source tools for turning images into color-layered 3D prints.</p></div>
                 <nav aria-label="Footer navigation" className="grid grid-cols-2 gap-x-10 gap-y-3 text-sm text-muted-foreground sm:flex sm:flex-wrap sm:justify-end sm:gap-x-6">
-                    <a href={docsPath('overview')} className="inline-flex items-center gap-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><BookOpen aria-hidden="true" className="h-4 w-4" /> Docs</a>
-                    <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Releases</a>
-                    <a href={links.github} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Github aria-hidden="true" className="h-4 w-4" /> GitHub</a>
-                    <a href={links.discord} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><MessageCircle aria-hidden="true" className="h-4 w-4" /> Discord</a>
-                    <a href={links.patreon} target="_blank" rel="noopener noreferrer" className="inline-flex items-center gap-2 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Heart aria-hidden="true" className="h-4 w-4" /> Support Kromacut</a>
+                    <a href={docsPath('overview')} className="inline-flex min-h-11 items-center gap-2 rounded-md px-1 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><BookOpen aria-hidden="true" className="h-4 w-4" /> Docs</a>
+                    <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-md px-1 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Releases</a>
+                    <a href={links.github} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-md px-1 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Github aria-hidden="true" className="h-4 w-4" /> GitHub</a>
+                    <a href={links.discord} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-md px-1 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><MessageCircle aria-hidden="true" className="h-4 w-4" /> Discord</a>
+                    <a href={links.patreon} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-md px-1 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Heart aria-hidden="true" className="h-4 w-4" /> Support Kromacut</a>
                 </nav>
             </footer>
             <div className="sr-only"><ChevronDown aria-hidden="true" /><Play aria-hidden="true" /></div>
diff --git a/src/index.css b/src/index.css
index 4097868..51df8e3 100644
--- a/src/index.css
+++ b/src/index.css
@@ -45,7 +45,7 @@
     --sidebar-accent-foreground: oklch(0.3791 0.1378 265.5222);
     --sidebar-border: oklch(0.9276 0.0058 264.5313);
     --sidebar-ring: oklch(0.6231 0.188 259.8145);
-    --font-sans: Oxanium, ui-serif, serif;
+    --font-sans: Oxanium, ui-sans-serif, system-ui, sans-serif;
     --font-serif: Source Serif 4, serif;
     --font-mono: Source Code Pro, ui-monospace, monospace;
     --radius: 0.75rem;
@@ -100,7 +100,7 @@
     --sidebar-accent-foreground: oklch(0.8823 0.0571 254.1284);
     --sidebar-border: oklch(0.2478 0 0);
     --sidebar-ring: oklch(0.6231 0.188 259.8145);
-    --font-sans: Oxanium, ui-serif, serif;
+    --font-sans: Oxanium, ui-sans-serif, system-ui, sans-serif;
     --font-serif: Source Serif 4, serif;
     --font-mono: Source Code Pro, ui-monospace, monospace;
     --radius: 0.75rem;
@@ -235,6 +235,7 @@ html,
 body,
 #root {
     height: 100vh;
+    height: 100dvh;
     width: 100%;
     min-height: 100%;
     min-width: 0;
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
index 0f21e5a..7fe522d 100644
--- a/tests/e2e/landing.spec.ts
+++ b/tests/e2e/landing.spec.ts
@@ -36,9 +36,15 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.getByTestId('landing-page')).toBeVisible();
         await page.goto('/app');
         await expect(page.getByTestId('image-file-input')).toBeAttached();
-        await expect.poll(() => page.evaluate((keys) =>
-            keys.every((key) => localStorage.getItem(key) !== null),
-        Object.keys(persisted))).toBe(true);
+        await expect.poll(() => page.evaluate((values) => {
+            const stableEntries = Object.entries(values).filter(([key]) => key !== 'kromacut.autopaint.v1');
+            const autoPaint = JSON.parse(localStorage.getItem('kromacut.autopaint.v1') ?? '{}');
+            return stableEntries.every(([key, value]) => localStorage.getItem(key) === value)
+                && autoPaint.schemaVersion === 2
+                && Array.isArray(autoPaint.filaments)
+                && autoPaint.filaments.length === 0
+                && document.documentElement.classList.contains('dark');
+        }, persisted)).toBe(true);
 
         await page.goto('/');
         await expect(page).toHaveURL(/\/app$/);
@@ -85,9 +91,11 @@ test.describe('landing page smoke @smoke', () => {
     });
 
     test('docs direct loading keeps the docs shell', async ({ page }) => {
+        await page.addInitScript(() => localStorage.clear());
         await page.goto('/docs/overview');
         await expect(page.getByRole('main')).toBeVisible();
         await expect(page.getByRole('heading', { name: 'Contents' })).toBeVisible();
         await expect(page.getByText('Overview', { exact: true }).first()).toBeVisible();
+        await expect.poll(() => page.evaluate(() => localStorage.getItem('kromacut.has-launched.v1'))).toBeNull();
     });
 });

From d699e4b03a962d0d9e466280b6270bc5b5a35fbd Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 22 Jul 2026 10:52:35 +0300
Subject: [PATCH 72/81] fix: refine landing and settings navigation

---
 CHANGELOG.md                      |   4 +-
 src/components/Header.tsx         | 130 ++++++++++++++++++------------
 src/components/LandingPage.tsx    |  45 ++++++++---
 src/docs/settings-and-controls.md |  13 ++-
 src/lib/routes.ts                 |   4 +
 tests/e2e/landing.spec.ts         |  36 +++++++++
 tests/routes.test.ts              |   3 +
 7 files changed, 161 insertions(+), 74 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 03c9e83..e4c06fe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Landing page and `/app` web route** - Added a responsive product landing page at `/`, moved the browser tool to `/app`, preserved `/docs/...` routes and same-origin localStorage, and added a returning-user launch preference with `/?landing=1` preview support. The landing page includes the core workflow, existing product visuals, desktop releases, documentation, GitHub, Discord, and Patreon links.
+- **Landing page and `/app` web route** - Added a responsive product landing page at `/`, moved the browser tool to `/app`, preserved `/docs/...` routes and same-origin localStorage, and added a returning-user launch preference with `/?landing=1` preview support. The app logo provides a direct route back to the landing page. The landing page includes the core workflow, existing product visuals, desktop releases, documentation, GitHub, Discord, and Patreon links.
 - **Route-aware SEO and deployment output** - Added route helpers, landing structured data, app `noindex` metadata, a stable PWA manifest identity with `/app` as its start URL, and static `dist/app/index.html` output for GitHub Pages refreshes.
 - **Route and landing smoke coverage** - Added focused route-selection tests and Playwright coverage for the landing CTA, direct `/app` loading, and same-origin storage persistence.
 - **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
@@ -19,7 +19,7 @@ All notable changes to Kromacut are documented in this file.
 - **Auto-paint preview color toggle** - The 3D preview toolbar now offers a Simulated/Physical color toggle for Auto-paint results, switching between the estimated blended appearance and the real physical filament colors stacked at each layer without a model rebuild. Only shown for Auto-paint models, the selection is remembered, and it never changes STL/3MF export content.
 - **2D touch-up tools** - The 2D preview toolbar now includes five hard-edged pixel tools (Brush, Eraser, Fill, Text, and color picker) for direct image editing with palette-safe colors, an on-canvas text box you type into directly with live move, resize, and word wrap, one undo/redo step per edit, and live non-blocking drawing with adjustments staying non-destructive.
 - **Calibration theory docs** - New in-app documentation page explaining the science behind filament calibration: the frontlit Beer-Lambert optical model and hiding distance, why the wedge's reference-rail comparison is reliable without a camera, how a single patch read becomes a hiding distance through a just-noticeable-difference solve, per-channel measurement with multiple bases, the session JND fit, and what the confidence score reflects — illustrated with three new diagrams. The Calibrate Filaments dialog links straight to it.
-- **Reddit community links** - Added r/kromacut links to the app header and README, and use branded Discord, Reddit, and GitHub icons in the header toolbar.
+- **Reddit community links** - Added r/kromacut links to the app settings and README.
 
 ### Changed
 
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 9deb53f..6f1cbaa 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -4,6 +4,7 @@ import {
     AlertCircle,
     BookOpen,
     CheckCircle2,
+    ChevronRight,
     Download,
     Github,
     Heart,
@@ -40,7 +41,7 @@ import {
 } from '@/lib/updatePreferences';
 import logo from '../assets/logo.png';
 import redditIcon from '../assets/reddit.svg';
-import { appPath } from '@/lib/routes';
+import { landingPath } from '@/lib/routes';
 import { isTauri } from '@tauri-apps/api/core';
 
 interface Props {
@@ -200,9 +201,10 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                     </button>
                 ) : (
                     <a
-                        href={appPath(isTauri())}
+                        href={landingPath(isTauri())}
                         className="flex items-center gap-2 rounded-md p-1 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background"
-                        aria-label="Open Kromacut app"
+                        aria-label="Kromacut home"
+                        title="Back to Kromacut home"
                     >
                         <img src={logo} alt="Kromacut" className="h-7 w-auto" />
                         <span className="font-extrabold text-base text-foreground tracking-wide ml-1 select-none max-md:hidden">
@@ -212,24 +214,6 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                 )}
             </div>
             <div className="flex gap-2.5 items-center">
-                <Button
-                    size="sm"
-                    asChild
-                    className="bg-gradient-to-r from-orange-500 to-red-500 hover:from-orange-600 hover:to-red-600 text-white font-semibold transition-all duration-200 shadow-md hover:shadow-lg hover:scale-105 active:scale-95 gap-1.5"
-                >
-                    <a
-                        href="https://www.reddit.com/r/kromacut/"
-                        target="_blank"
-                        rel="noopener noreferrer"
-                        aria-label="r/kromacut on Reddit"
-                        title="r/kromacut on Reddit"
-                    >
-                        <span className="flex size-4 shrink-0 items-center justify-center">
-                            <img src={redditIcon} alt="" className="block max-h-full max-w-full brightness-0 invert" />
-                        </span>
-                        <span className="max-sm:hidden">Reddit</span>
-                    </a>
-                </Button>
                 <Button
                     ref={settingsButtonRef}
                     size="icon"
@@ -324,50 +308,90 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
 
                         <section className="mt-5 space-y-3 border-t border-border pt-5">
                             <div>
-                                <div className="text-sm font-medium text-foreground">Resources & community</div>
+                                <div className="text-sm font-medium text-foreground">
+                                    Resources & community
+                                </div>
                                 <p className="mt-1 text-xs leading-5 text-muted-foreground">
                                     Guides, releases, and places to share what you make.
                                 </p>
                             </div>
-                            <div className="grid gap-2 sm:grid-cols-2">
+                            <div className="space-y-2">
                                 <button
                                     type="button"
                                     onClick={() => {
                                         setSettingsOpen(false);
                                         onToggleDocs();
                                     }}
-                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 text-left transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                    className="group flex w-full items-center gap-3 rounded-lg bg-muted/50 p-3 text-left transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
                                 >
-                                    <BookOpen className="mt-0.5 h-4 w-4 flex-shrink-0 text-primary" />
-                                    <span><span className="block text-sm font-semibold">Docs</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Learn the workflow and print settings.</span></span>
+                                    <span className="flex size-9 flex-shrink-0 items-center justify-center rounded-full bg-primary/10 text-primary">
+                                        <BookOpen className="h-4 w-4" />
+                                    </span>
+                                    <span className="min-w-0 flex-1">
+                                        <span className="block text-sm font-semibold text-foreground">
+                                            Docs
+                                        </span>
+                                        <span className="mt-0.5 block text-xs text-muted-foreground">
+                                            Learn the workflow and print settings.
+                                        </span>
+                                    </span>
+                                    <ChevronRight className="h-4 w-4 flex-shrink-0 text-muted-foreground transition-transform group-hover:translate-x-0.5" />
                                 </button>
-                                <a
-                                    href="https://discord.gg/nU63sFMcnX"
-                                    target="_blank"
-                                    rel="noopener noreferrer"
-                                    onClick={() => setSettingsOpen(false)}
-                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-                                >
-                                    <MessageCircle aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-indigo-500" /><span><span className="block text-sm font-semibold">Discord</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Join the Kromacut community.</span></span>
-                                </a>
-                                <a
-                                    href="https://github.com/vycdev/Kromacut"
-                                    target="_blank"
-                                    rel="noopener noreferrer"
-                                    onClick={() => setSettingsOpen(false)}
-                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-                                >
-                                    <Github aria-hidden="true" className="mt-0.5 h-4 w-4 flex-shrink-0 text-foreground" /><span><span className="block text-sm font-semibold">GitHub</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">View the source and report issues.</span></span>
-                                </a>
-                                <a
-                                    href="https://www.patreon.com/cw/vycdev"
-                                    target="_blank"
-                                    rel="noopener noreferrer"
-                                    onClick={() => setSettingsOpen(false)}
-                                    className="flex items-start gap-3 rounded-md border border-border bg-background p-3 transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
-                                >
-                                    <Heart className="mt-0.5 h-4 w-4 flex-shrink-0 text-rose-400" /><span><span className="block text-sm font-semibold">Support Me</span><span className="mt-1 block text-xs leading-5 text-muted-foreground">Support continued open-source work.</span></span>
-                                </a>
+
+                                <div className="grid grid-cols-2 gap-1 rounded-lg border border-border bg-muted/30 p-1 min-[520px]:grid-cols-4">
+                                    <a
+                                        href="https://discord.gg/nU63sFMcnX"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        onClick={() => setSettingsOpen(false)}
+                                        className="flex items-center justify-center gap-2 rounded-md px-2 py-2.5 text-sm font-medium text-muted-foreground transition-colors hover:bg-background hover:text-foreground hover:shadow-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                    >
+                                        <MessageCircle
+                                            aria-hidden="true"
+                                            className="h-4 w-4 flex-shrink-0 text-indigo-500"
+                                        />
+                                        Discord
+                                    </a>
+                                    <a
+                                        href="https://www.reddit.com/r/kromacut/"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        onClick={() => setSettingsOpen(false)}
+                                        aria-label="r/kromacut on Reddit"
+                                        className="flex items-center justify-center gap-2 rounded-md px-2 py-2.5 text-sm font-medium text-muted-foreground transition-colors hover:bg-background hover:text-foreground hover:shadow-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                    >
+                                        <img
+                                            src={redditIcon}
+                                            alt=""
+                                            className="h-4 w-4 flex-shrink-0 dark:invert"
+                                        />
+                                        Reddit
+                                    </a>
+                                    <a
+                                        href="https://github.com/vycdev/Kromacut"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        onClick={() => setSettingsOpen(false)}
+                                        className="flex items-center justify-center gap-2 rounded-md px-2 py-2.5 text-sm font-medium text-muted-foreground transition-colors hover:bg-background hover:text-foreground hover:shadow-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                    >
+                                        <Github
+                                            aria-hidden="true"
+                                            className="h-4 w-4 flex-shrink-0 text-foreground"
+                                        />
+                                        GitHub
+                                    </a>
+                                    <a
+                                        href="https://www.patreon.com/cw/vycdev"
+                                        target="_blank"
+                                        rel="noopener noreferrer"
+                                        onClick={() => setSettingsOpen(false)}
+                                        aria-label="Support Me on Patreon"
+                                        className="flex items-center justify-center gap-2 rounded-md px-2 py-2.5 text-sm font-medium text-muted-foreground transition-colors hover:bg-background hover:text-foreground hover:shadow-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                                    >
+                                        <Heart className="h-4 w-4 flex-shrink-0 text-rose-400" />
+                                        Patreon
+                                    </a>
+                                </div>
                             </div>
                         </section>
 
diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
index f737204..4dc931d 100644
--- a/src/components/LandingPage.tsx
+++ b/src/components/LandingPage.tsx
@@ -8,19 +8,20 @@ import {
     Heart,
     MessageCircle,
     Play,
-    Sparkles,
 } from 'lucide-react';
 import logo from '../assets/logo.png';
 import fuji2d from '../../content/fuji2d_new.png';
 import fuji3d from '../../content/fuji3d_new.png';
 import sliced from '../../content/fuji3dsliced.png';
 import printed from '../../content/printed.jpg';
+import redditIcon from '../assets/reddit.svg';
 import { APP_PATH, docsPath } from '@/lib/routes';
 
 const links = {
     releases: 'https://github.com/vycdev/Kromacut/releases',
     github: 'https://github.com/vycdev/Kromacut',
     discord: 'https://discord.gg/nU63sFMcnX',
+    reddit: 'https://www.reddit.com/r/kromacut/',
     patreon: 'https://www.patreon.com/cw/vycdev',
 };
 
@@ -31,6 +32,8 @@ const workflow = [
         description: 'Drop in artwork, a photo, or a pixel design and keep the original safely editable.',
         image: fuji2d,
         alt: 'A colorful 2D image ready to be imported into Kromacut',
+        imagePosition: '95% 50%',
+        imageScale: 1.65,
     },
     {
         number: '02',
@@ -38,6 +41,8 @@ const workflow = [
         description: 'Tune a compact palette manually or let Auto-paint match the filaments you actually own.',
         image: sliced,
         alt: 'A color-layered image preview showing separate printable colors',
+        imagePosition: '50% 48%',
+        imageScale: 1.08,
     },
     {
         number: '03',
@@ -45,6 +50,8 @@ const workflow = [
         description: 'Inspect the stack in 3D, check transitions, and see exactly where filament swaps happen.',
         image: fuji3d,
         alt: 'Kromacut 3D preview of a stacked color-layer print',
+        imagePosition: '95% 50%',
+        imageScale: 1.65,
     },
     {
         number: '04',
@@ -52,6 +59,8 @@ const workflow = [
         description: 'Download a slicer-ready STL or 3MF with the print plan you need to finish the job.',
         image: printed,
         alt: 'A finished colorful layered print made from a Kromacut workflow',
+        imagePosition: '55% 50%',
+        imageScale: 1.05,
     },
 ];
 
@@ -69,8 +78,8 @@ export default function LandingPage() {
                 Skip to workflow
             </a>
 
-            <div className="relative isolate">
-                <div aria-hidden="true" className="pointer-events-none absolute inset-x-0 top-0 -z-10 h-[42rem] overflow-hidden">
+            <div data-testid="landing-hero" className="relative isolate flex min-h-screen flex-col">
+                <div aria-hidden="true" className="pointer-events-none absolute inset-x-0 top-0 -z-10 h-full overflow-hidden">
                     <div className="absolute left-[8%] top-[-13rem] h-[34rem] w-[34rem] rounded-full bg-primary/20 blur-[100px]" />
                     <div className="absolute right-[-8rem] top-[8rem] h-[28rem] w-[28rem] rounded-full bg-fuchsia-500/10 blur-[100px]" />
                     <div className="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,0.06)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,0.06)_1px,transparent_1px)] bg-[size:3rem_3rem] [mask-image:linear-gradient(to_bottom,black,transparent_88%)]" />
@@ -86,6 +95,20 @@ export default function LandingPage() {
                         <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
                         <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
+                    <nav data-testid="landing-community-links" aria-label="Community links" className="hidden items-center gap-1 lg:flex">
+                        <a href={links.github} target="_blank" rel="noopener noreferrer" aria-label="Kromacut on GitHub" title="GitHub" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
+                            <Github aria-hidden="true" className="h-4 w-4" /><span className="hidden xl:inline">GitHub</span>
+                        </a>
+                        <a href={links.discord} target="_blank" rel="noopener noreferrer" aria-label="Join Kromacut on Discord" title="Discord" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
+                            <MessageCircle aria-hidden="true" className="h-4 w-4 text-indigo-400" /><span className="hidden xl:inline">Discord</span>
+                        </a>
+                        <a href={links.reddit} target="_blank" rel="noopener noreferrer" aria-label="r/kromacut on Reddit" title="Reddit" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
+                            <img src={redditIcon} alt="" className="h-4 w-4 dark:invert" /><span className="hidden xl:inline">Reddit</span>
+                        </a>
+                        <a href={links.patreon} target="_blank" rel="noopener noreferrer" aria-label="Support Kromacut on Patreon" title="Patreon" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
+                            <Heart aria-hidden="true" className="h-4 w-4 text-rose-400" /><span className="hidden xl:inline">Support</span>
+                        </a>
+                    </nav>
                     <a
                         href={APP_PATH}
                         data-testid="landing-open-app"
@@ -100,10 +123,10 @@ export default function LandingPage() {
                     </nav>
                 </header>
 
-                <section className="mx-auto grid max-w-7xl items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
+                <section className="mx-auto grid w-full max-w-7xl flex-1 items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
                     <div className="max-w-2xl">
-                        <div className="mb-6 inline-flex items-center gap-2 rounded-full border border-primary/30 bg-primary/10 px-3 py-1.5 text-xs font-bold uppercase tracking-[0.16em] text-blue-700 dark:text-blue-300">
-                            <Sparkles aria-hidden="true" className="h-3.5 w-3.5" />
+                        <div className="mb-6 flex items-center gap-3 text-xs font-bold uppercase tracking-[0.18em] text-primary">
+                            <span aria-hidden="true" className="h-px w-8 bg-primary/70" />
                             Open source · browser first
                         </div>
                         <h1 className="max-w-2xl text-balance font-sans text-5xl font-extrabold leading-[0.95] tracking-[-0.045em] sm:text-6xl lg:text-7xl">
@@ -121,7 +144,7 @@ export default function LandingPage() {
                             </a>
                         </div>
                         <div className="mt-8 flex flex-wrap gap-x-5 gap-y-3 text-sm text-muted-foreground">
-                            {['Free to use', 'No upload required', 'STL + 3MF export'].map((item) => (
+                            {['Free to use', 'Browser + desktop', 'STL + 3MF export'].map((item) => (
                                 <span key={item} className="inline-flex items-center gap-2"><Check aria-hidden="true" className="h-4 w-4 text-emerald-400" />{item}</span>
                             ))}
                         </div>
@@ -135,7 +158,7 @@ export default function LandingPage() {
                                 <span className="inline-flex items-center gap-1.5 text-emerald-400"><span className="h-1.5 w-1.5 rounded-full bg-emerald-400" /> ready to print</span>
                             </div>
                             <div className="relative aspect-[1.22] overflow-hidden rounded-xl bg-black/20">
-                                <img src={fuji3d} alt="Color-layered 3D print preview" className="h-full w-full object-cover object-center" fetchPriority="high" />
+                                <img src={fuji3d} alt="Color-layered 3D print preview" className="h-full w-full object-cover object-[95%_center]" fetchPriority="high" />
                                 <div className="absolute bottom-4 left-4 right-4 flex flex-wrap gap-2">
                                     {['#121a3a', '#3855c7', '#e14f91', '#f6ba4a'].map((color, index) => (
                                         <span key={color} className="inline-flex items-center gap-2 rounded-md border border-white/15 bg-black/65 px-2.5 py-1.5 text-xs font-semibold text-white backdrop-blur" style={{ opacity: 1 - index * 0.04 }}>
@@ -163,7 +186,7 @@ export default function LandingPage() {
                     <div className="mt-14 grid gap-5 sm:grid-cols-2 lg:grid-cols-4">
                         {workflow.map((step) => (
                             <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1 motion-reduce:transition-none">
-                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover transition-transform duration-500 motion-safe:group-hover:scale-105 motion-reduce:transition-none" /></div>
+                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover" style={{ objectPosition: step.imagePosition, transform: `scale(${step.imageScale})` }} /></div>
                                 <div className="p-5"><div className="font-mono text-xs font-bold text-blue-700 dark:text-blue-300">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
                             </article>
                         ))}
@@ -173,8 +196,8 @@ export default function LandingPage() {
 
             <section className="mx-auto grid max-w-7xl items-center gap-12 px-5 py-20 sm:px-8 md:py-28 lg:grid-cols-[1.05fr_0.95fr] lg:px-10">
                 <div className="relative grid grid-cols-2 gap-3">
-                    <div className="mt-10 overflow-hidden rounded-xl border border-border shadow-xl"><img src={fuji2d} alt="Original 2D artwork" loading="lazy" className="aspect-square h-full w-full object-cover" /></div>
-                    <div className="overflow-hidden rounded-xl border border-primary/40 shadow-xl shadow-primary/10"><img src={printed} alt="Finished Kromacut print" loading="lazy" className="aspect-square h-full w-full object-cover" /></div>
+                    <div className="mt-10 aspect-[4/3] overflow-hidden rounded-xl border border-border shadow-xl"><img src={fuji2d} alt="Original 2D artwork" loading="lazy" className="h-full w-full scale-[1.65] object-cover object-[95%_50%]" /></div>
+                    <div className="aspect-[4/3] overflow-hidden rounded-xl border border-primary/40 shadow-xl shadow-primary/10"><img src={printed} alt="Finished Kromacut print" loading="lazy" className="h-full w-full object-cover object-[58%_50%]" /></div>
                     <div className="absolute left-1/2 top-1/2 hidden -translate-x-1/2 -translate-y-1/2 rounded-full border border-border bg-background p-3 text-primary shadow-lg sm:block"><ArrowRight aria-hidden="true" className="h-5 w-5" /></div>
                 </div>
                 <div className="max-w-xl">
diff --git a/src/docs/settings-and-controls.md b/src/docs/settings-and-controls.md
index efc4da3..ed51d44 100644
--- a/src/docs/settings-and-controls.md
+++ b/src/docs/settings-and-controls.md
@@ -11,17 +11,14 @@ This page collects controls that affect the whole app or are easy to miss.
 
 ## Header Controls
 
-| Control    | What it does                                                            |
-| ---------- | ----------------------------------------------------------------------- |
-| Docs       | Opens this documentation page.                                          |
-| Discord    | Opens the community link.                                               |
-| GitHub     | Opens the project page.                                                 |
-| Support me | Opens the support link.                                                 |
-| Settings   | Opens the settings dialog, including theme and desktop update controls. |
+| Control       | What it does                                                               |
+| ------------- | -------------------------------------------------------------------------- |
+| Kromacut logo | Returns to the landing page from the web app.                              |
+| Settings      | Opens the settings dialog, including theme, resource, and update controls. |
 
 The theme selector offers **System**, **Dark**, and **Light**. **System** follows the operating system or browser color-scheme preference and updates when that preference changes. The theme choice is saved for later sessions.
 
-The settings dialog also shows the current Kromacut version.
+The settings dialog includes links to the documentation, Discord, Reddit, GitHub, and Patreon, and shows the current Kromacut version.
 
 ## Workspace Modes
 
diff --git a/src/lib/routes.ts b/src/lib/routes.ts
index 89081f1..7132b26 100644
--- a/src/lib/routes.ts
+++ b/src/lib/routes.ts
@@ -63,6 +63,10 @@ export function appPath(isTauri: boolean): string {
     return isTauri ? LANDING_PATH : APP_PATH;
 }
 
+export function landingPath(isTauri: boolean): string {
+    return isTauri ? LANDING_PATH : `${LANDING_PATH}?landing=1`;
+}
+
 export function docsPath(slug = ''): string {
     const normalizedSlug = slug.trim().replace(/^\/+|\/+$/g, '');
     return normalizedSlug ? `${DOCS_PATH}/${normalizedSlug}` : DOCS_PATH;
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
index 7fe522d..00693c4 100644
--- a/tests/e2e/landing.spec.ts
+++ b/tests/e2e/landing.spec.ts
@@ -8,6 +8,10 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.getByTestId('landing-page')).toBeVisible();
         await expect(page.getByRole('heading', { name: /Turn pixels into printable layers/i })).toBeVisible();
         await expect(page.getByTestId('landing-open-app')).toHaveAttribute('href', '/app');
+        const communityLinks = page.getByTestId('landing-community-links');
+        await expect(communityLinks).toBeVisible();
+        await expect(communityLinks.getByRole('link')).toHaveCount(4);
+        await expect(communityLinks.getByRole('link', { name: 'r/kromacut on Reddit' })).toHaveAttribute('href', 'https://www.reddit.com/r/kromacut/');
 
         await page.getByTestId('landing-open-app').click();
         await expect(page).toHaveURL(/\/app$/);
@@ -52,6 +56,36 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.getByTestId('landing-page')).toBeVisible();
     });
 
+    test('app logo returns launched users to the landing page', async ({ page }) => {
+        await page.addInitScript(() => {
+            localStorage.setItem('kromacut.has-launched.v1', 'v1');
+        });
+        await page.goto('/app');
+
+        const homeLink = page.getByRole('link', { name: 'Kromacut home' });
+        await expect(homeLink).toHaveAttribute('href', '/?landing=1');
+        await homeLink.click();
+
+        await expect(page).toHaveURL(/\/?\?landing=1$/);
+        await expect(page.getByTestId('landing-page')).toBeVisible();
+    });
+
+    test('landing hero fills 1080p and 1440p viewports', async ({ page }) => {
+        for (const viewport of [
+            { width: 1920, height: 1080 },
+            { width: 2560, height: 1440 },
+        ]) {
+            await page.setViewportSize(viewport);
+            await page.goto('/?landing=1');
+
+            const dimensions = await page.getByTestId('landing-hero').evaluate((hero) => ({
+                heroHeight: hero.getBoundingClientRect().height,
+                viewportHeight: window.innerHeight,
+            }));
+            expect(dimensions.heroHeight).toBeGreaterThanOrEqual(dimensions.viewportHeight);
+        }
+    });
+
     test('mobile landing navigation fits and remains keyboard accessible', async ({ page }) => {
         await page.setViewportSize({ width: 320, height: 720 });
         await page.addInitScript(() => localStorage.clear());
@@ -73,6 +107,7 @@ test.describe('landing page smoke @smoke', () => {
     test('settings resources are keyboard-modal and restore focus', async ({ page }) => {
         await page.goto('/app');
         const settingsButton = page.getByRole('button', { name: 'Open settings' });
+        await expect(page.getByRole('link', { name: 'r/kromacut on Reddit' })).toHaveCount(0);
         await settingsButton.click();
 
         const dialog = page.getByRole('dialog', { name: 'Settings' });
@@ -80,6 +115,7 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.getByRole('button', { name: 'Close settings' })).toBeFocused();
         await expect(dialog.getByRole('button', { name: /Docs/ })).toBeVisible();
         await expect(dialog.getByRole('link', { name: /Discord/ })).toBeVisible();
+        await expect(dialog.getByRole('link', { name: 'r/kromacut on Reddit' })).toBeVisible();
         await expect(dialog.getByRole('link', { name: /GitHub/ })).toBeVisible();
         await expect(dialog.getByRole('link', { name: /Support Me/ })).toBeVisible();
 
diff --git a/tests/routes.test.ts b/tests/routes.test.ts
index c4a1464..8c75fc5 100644
--- a/tests/routes.test.ts
+++ b/tests/routes.test.ts
@@ -8,6 +8,7 @@ import {
     docsPath,
     hasLandingBypass,
     isCrawlerUserAgent,
+    landingPath,
     selectRoute,
     shouldRedirectHomeToApp,
 } from '../src/lib/routes.ts';
@@ -29,6 +30,8 @@ test('route constants expose stable public paths', () => {
     assert.equal(DOCS_PATH, '/docs');
     assert.equal(appPath(false), '/app');
     assert.equal(appPath(true), '/');
+    assert.equal(landingPath(false), '/?landing=1');
+    assert.equal(landingPath(true), '/');
     assert.equal(docsPath(), '/docs');
     assert.equal(docsPath('/quick-start/'), '/docs/quick-start');
 });

From 4ccb6085fba450862a5beb83fcc6cbd229464dad Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 22 Jul 2026 12:02:20 +0300
Subject: [PATCH 73/81] fix: refine responsive landing layout

---
 src/components/LandingPage.tsx | 77 ++++++++++++++++++++--------------
 tests/e2e/landing.spec.ts      |  3 ++
 2 files changed, 49 insertions(+), 31 deletions(-)

diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
index 4dc931d..1257632 100644
--- a/src/components/LandingPage.tsx
+++ b/src/components/LandingPage.tsx
@@ -34,6 +34,7 @@ const workflow = [
         alt: 'A colorful 2D image ready to be imported into Kromacut',
         imagePosition: '95% 50%',
         imageScale: 1.65,
+        imageFit: 'cover',
     },
     {
         number: '02',
@@ -43,6 +44,7 @@ const workflow = [
         alt: 'A color-layered image preview showing separate printable colors',
         imagePosition: '50% 48%',
         imageScale: 1.08,
+        imageFit: 'cover',
     },
     {
         number: '03',
@@ -52,6 +54,7 @@ const workflow = [
         alt: 'Kromacut 3D preview of a stacked color-layer print',
         imagePosition: '95% 50%',
         imageScale: 1.65,
+        imageFit: 'cover',
     },
     {
         number: '04',
@@ -60,7 +63,8 @@ const workflow = [
         image: printed,
         alt: 'A finished colorful layered print made from a Kromacut workflow',
         imagePosition: '55% 50%',
-        imageScale: 1.05,
+        imageScale: 1,
+        imageFit: 'contain',
     },
 ];
 
@@ -68,6 +72,33 @@ function ExternalArrow() {
     return <ArrowRight aria-hidden="true" className="h-4 w-4" />;
 }
 
+interface CommunityLinksProps {
+    className: string;
+    labelClassName?: string;
+    testId?: string;
+}
+
+function CommunityLinks({ className, labelClassName = 'sr-only', testId }: CommunityLinksProps) {
+    const linkClassName = 'inline-flex min-h-11 items-center justify-center gap-2 rounded-md px-3 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring';
+
+    return (
+        <nav data-testid={testId} aria-label="Community links" className={className}>
+            <a href={links.github} target="_blank" rel="noopener noreferrer" aria-label="Kromacut on GitHub" title="GitHub" className={linkClassName}>
+                <Github aria-hidden="true" className="h-4 w-4" /><span className={labelClassName}>GitHub</span>
+            </a>
+            <a href={links.discord} target="_blank" rel="noopener noreferrer" aria-label="Join Kromacut on Discord" title="Discord" className={linkClassName}>
+                <MessageCircle aria-hidden="true" className="h-4 w-4 text-indigo-400" /><span className={labelClassName}>Discord</span>
+            </a>
+            <a href={links.reddit} target="_blank" rel="noopener noreferrer" aria-label="r/kromacut on Reddit" title="Reddit" className={linkClassName}>
+                <img src={redditIcon} alt="" className="h-4 w-4 dark:invert" /><span className={labelClassName}>Reddit</span>
+            </a>
+            <a href={links.patreon} target="_blank" rel="noopener noreferrer" aria-label="Support Kromacut on Patreon" title="Patreon" className={linkClassName}>
+                <Heart aria-hidden="true" className="h-4 w-4 text-rose-400" /><span className={labelClassName}>Support</span>
+            </a>
+        </nav>
+    );
+}
+
 export default function LandingPage() {
     return (
         <main data-testid="landing-page" className="h-full overflow-x-hidden overflow-y-auto bg-background text-foreground">
@@ -95,20 +126,7 @@ export default function LandingPage() {
                         <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
                         <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
-                    <nav data-testid="landing-community-links" aria-label="Community links" className="hidden items-center gap-1 lg:flex">
-                        <a href={links.github} target="_blank" rel="noopener noreferrer" aria-label="Kromacut on GitHub" title="GitHub" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
-                            <Github aria-hidden="true" className="h-4 w-4" /><span className="hidden xl:inline">GitHub</span>
-                        </a>
-                        <a href={links.discord} target="_blank" rel="noopener noreferrer" aria-label="Join Kromacut on Discord" title="Discord" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
-                            <MessageCircle aria-hidden="true" className="h-4 w-4 text-indigo-400" /><span className="hidden xl:inline">Discord</span>
-                        </a>
-                        <a href={links.reddit} target="_blank" rel="noopener noreferrer" aria-label="r/kromacut on Reddit" title="Reddit" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
-                            <img src={redditIcon} alt="" className="h-4 w-4 dark:invert" /><span className="hidden xl:inline">Reddit</span>
-                        </a>
-                        <a href={links.patreon} target="_blank" rel="noopener noreferrer" aria-label="Support Kromacut on Patreon" title="Patreon" className="inline-flex min-h-10 items-center gap-2 rounded-md px-2.5 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
-                            <Heart aria-hidden="true" className="h-4 w-4 text-rose-400" /><span className="hidden xl:inline">Support</span>
-                        </a>
-                    </nav>
+                    <CommunityLinks testId="landing-community-links" className="hidden items-center gap-1 lg:flex" labelClassName="hidden xl:inline" />
                     <a
                         href={APP_PATH}
                         data-testid="landing-open-app"
@@ -116,11 +134,15 @@ export default function LandingPage() {
                     >
                         Open Kromacut <ExternalArrow />
                     </a>
-                    <nav aria-label="Mobile navigation" className="order-last flex w-full items-center justify-between border-t border-border/70 pt-3 text-xs font-semibold text-muted-foreground md:hidden">
-                        <a href="#workflow" className="inline-flex min-h-11 items-center rounded-md px-1 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
-                        <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
-                        <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-1 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
-                    </nav>
+                    <div className="order-last w-full border-t border-border/70 pt-2 md:hidden">
+                        <nav aria-label="Mobile navigation" className="flex items-center justify-center gap-1 text-xs font-semibold text-muted-foreground">
+                            <a href="#workflow" className="inline-flex min-h-11 items-center rounded-md px-3 transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">How it works</a>
+                            <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-3 transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
+                            <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-3 transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
+                        </nav>
+                        <CommunityLinks testId="landing-mobile-community-links" className="mt-1 flex items-center justify-center gap-1 border-t border-border/50 pt-1" />
+                    </div>
+                    <CommunityLinks testId="landing-tablet-community-links" className="order-last hidden w-full items-center justify-center gap-1 border-t border-border/70 pt-3 md:flex lg:hidden" />
                 </header>
 
                 <section className="mx-auto grid w-full max-w-7xl flex-1 items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
@@ -159,13 +181,6 @@ export default function LandingPage() {
                             </div>
                             <div className="relative aspect-[1.22] overflow-hidden rounded-xl bg-black/20">
                                 <img src={fuji3d} alt="Color-layered 3D print preview" className="h-full w-full object-cover object-[95%_center]" fetchPriority="high" />
-                                <div className="absolute bottom-4 left-4 right-4 flex flex-wrap gap-2">
-                                    {['#121a3a', '#3855c7', '#e14f91', '#f6ba4a'].map((color, index) => (
-                                        <span key={color} className="inline-flex items-center gap-2 rounded-md border border-white/15 bg-black/65 px-2.5 py-1.5 text-xs font-semibold text-white backdrop-blur" style={{ opacity: 1 - index * 0.04 }}>
-                                            <span className="h-3 w-3 rounded-sm" style={{ backgroundColor: color }} /> Layer {index + 1}
-                                        </span>
-                                    ))}
-                                </div>
                             </div>
                         </div>
                         <div className="absolute -bottom-5 -left-4 hidden items-center gap-3 rounded-xl border border-border bg-card px-4 py-3 shadow-xl sm:flex">
@@ -186,7 +201,7 @@ export default function LandingPage() {
                     <div className="mt-14 grid gap-5 sm:grid-cols-2 lg:grid-cols-4">
                         {workflow.map((step) => (
                             <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1 motion-reduce:transition-none">
-                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className="h-full w-full object-cover" style={{ objectPosition: step.imagePosition, transform: `scale(${step.imageScale})` }} /></div>
+                                <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className={`h-full w-full ${step.imageFit === 'contain' ? 'object-contain' : 'object-cover'}`} style={{ objectPosition: step.imagePosition, transform: `scale(${step.imageScale})` }} /></div>
                                 <div className="p-5"><div className="font-mono text-xs font-bold text-blue-700 dark:text-blue-300">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
                             </article>
                         ))}
@@ -195,9 +210,9 @@ export default function LandingPage() {
             </section>
 
             <section className="mx-auto grid max-w-7xl items-center gap-12 px-5 py-20 sm:px-8 md:py-28 lg:grid-cols-[1.05fr_0.95fr] lg:px-10">
-                <div className="relative grid grid-cols-2 gap-3">
-                    <div className="mt-10 aspect-[4/3] overflow-hidden rounded-xl border border-border shadow-xl"><img src={fuji2d} alt="Original 2D artwork" loading="lazy" className="h-full w-full scale-[1.65] object-cover object-[95%_50%]" /></div>
-                    <div className="aspect-[4/3] overflow-hidden rounded-xl border border-primary/40 shadow-xl shadow-primary/10"><img src={printed} alt="Finished Kromacut print" loading="lazy" className="h-full w-full object-cover object-[58%_50%]" /></div>
+                <div className="relative grid grid-cols-2 items-center gap-3">
+                    <div className="aspect-[4/3] overflow-hidden rounded-xl border border-border shadow-xl"><img src={fuji2d} alt="Original 2D artwork" loading="lazy" className="h-full w-full object-cover object-[95%_50%]" style={{ transform: 'translateY(-2%) scale(1.55)' }} /></div>
+                    <div className="aspect-[4/3] overflow-hidden rounded-xl border border-primary/40 bg-muted shadow-xl shadow-primary/10"><img src={printed} alt="Finished Kromacut print" loading="lazy" className="h-full w-full object-contain object-center" /></div>
                     <div className="absolute left-1/2 top-1/2 hidden -translate-x-1/2 -translate-y-1/2 rounded-full border border-border bg-background p-3 text-primary shadow-lg sm:block"><ArrowRight aria-hidden="true" className="h-5 w-5" /></div>
                 </div>
                 <div className="max-w-xl">
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
index 00693c4..6374e6f 100644
--- a/tests/e2e/landing.spec.ts
+++ b/tests/e2e/landing.spec.ts
@@ -92,6 +92,9 @@ test.describe('landing page smoke @smoke', () => {
         await page.goto('/');
 
         await expect(page.getByRole('navigation', { name: 'Mobile navigation' })).toBeVisible();
+        const mobileCommunityLinks = page.getByTestId('landing-mobile-community-links');
+        await expect(mobileCommunityLinks).toBeVisible();
+        await expect(mobileCommunityLinks.getByRole('link')).toHaveCount(4);
         await expect(page.getByTestId('landing-open-app')).toBeVisible();
         expect(await page.evaluate(() => document.documentElement.scrollWidth)).toBeLessThanOrEqual(320);
         await expect.poll(() => page.getByTestId('landing-page').evaluate(

From d078846507a1975448a5f378e05be104d7bf4462 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Wed, 22 Jul 2026 12:53:46 +0300
Subject: [PATCH 74/81] fix: polish landing themes and docs navigation

---
 CHANGELOG.md                   |   3 +-
 src/App.tsx                    |   9 +--
 src/components/Header.tsx      |   6 +-
 src/components/LandingPage.tsx | 117 +++++++++++++++++++++++++++++----
 tests/e2e/landing.spec.ts      |  26 ++++++++
 5 files changed, 137 insertions(+), 24 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index e4c06fe..28c9cc4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,7 +6,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Added
 
-- **Landing page and `/app` web route** - Added a responsive product landing page at `/`, moved the browser tool to `/app`, preserved `/docs/...` routes and same-origin localStorage, and added a returning-user launch preference with `/?landing=1` preview support. The app logo provides a direct route back to the landing page. The landing page includes the core workflow, existing product visuals, desktop releases, documentation, GitHub, Discord, and Patreon links.
+- **Landing page and `/app` web route** - Added a responsive product landing page at `/`, moved the browser tool to `/app`, preserved `/docs/...` routes and same-origin localStorage, and added a returning-user launch preference with `/?landing=1` preview support. The app logo provides a direct route back to the landing page. The landing page includes the core workflow, existing product visuals, desktop releases, documentation, GitHub, Discord, Patreon, and Reddit links, plus persistent System, Dark, and Light theme controls with tailored styling for each theme.
 - **Route-aware SEO and deployment output** - Added route helpers, landing structured data, app `noindex` metadata, a stable PWA manifest identity with `/app` as its start URL, and static `dist/app/index.html` output for GitHub Pages refreshes.
 - **Route and landing smoke coverage** - Added focused route-selection tests and Playwright coverage for the landing CTA, direct `/app` loading, and same-origin storage persistence.
 - **Frontlit filament calibration** - Replaced the photo-based TD calibration with a camera-free workflow. Pick one or more filaments, choose the base layer each prints over (defaults to your darkest filament; dark filaments can use a lighter base for contrast), then download a calibration wedge (STL for any printer, or a multi-material 3MF for AMS) that prints 1..N filament layers over that base alongside an opaque reference rail, and report the layer count at which each filament/base patch first matches the rail. Quick mode keeps the single-base scalar calibration; Accurate mode repeats the read over multiple bases to fit measured RGB-channel TDs directly, stores the read set (plus optional merge points), and fits a shared session JND when enough multi-base data is present. Kromacut converts those reads into a frontlit Transmission Distance using a perceptual just-noticeable-difference model, with a live predicted-vs-reference preview and confidence rating. Read entry stays tied to the base filaments and print settings of the downloaded wedge, so changing layer height or max layers afterward does not reinterpret the physical print. The 3MF assigns parts to your real profile-filament slots (no invented base filament) and lays each tile out as an independently-arrangeable object. A calibration is tied to the swatch color it was measured for: editing a filament's color deactivates its calibration (the row falls back to a color-estimated hiding distance) and reverting the color reactivates it, so auto-paint never blends with measurements from a different material. The old backlit photo wizard, its image sampler, and stored RGB measurements are removed, and legacy stored RGB calibrations are stripped on load; recalibrate any previously calibrated filaments.
@@ -32,6 +32,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Fixed
 
+- **Settings documentation link** - Opening Docs from Settings now remains in the documentation when Docs is already active instead of unexpectedly returning to the app.
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.
 - **Auto-paint calibration confidence** - Color edits that deactivate a calibration now re-anchor the filament's estimated hiding distance to the new color without deleting the stored calibration, and result confidence now scores the filament sequence actually printed after variable-length optimization omits unused filaments.
diff --git a/src/App.tsx b/src/App.tsx
index eae9bcc..8dbd0c1 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -402,12 +402,7 @@ function App(): React.ReactElement | null {
         }
     };
 
-    const toggleDocs = () => {
-        if (docsOpen) {
-            backToApp();
-            return;
-        }
-
+    const openDocs = () => {
         setDocsOpen(true);
         if (!parseDocsLocation(window.location)) {
             window.history.pushState(null, '', buildDocsPath(defaultDocSlug));
@@ -542,7 +537,7 @@ function App(): React.ReactElement | null {
             <Header
                 docsOpen={docsOpen}
                 onBackToApp={backToApp}
-                onToggleDocs={toggleDocs}
+                onOpenDocs={openDocs}
             />
             {docsOpen && (
                 <div className="flex flex-1 min-h-0 w-full">
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 6f1cbaa..61750f9 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -47,13 +47,13 @@ import { isTauri } from '@tauri-apps/api/core';
 interface Props {
     docsOpen: boolean;
     onBackToApp: () => void;
-    onToggleDocs: () => void;
+    onOpenDocs: () => void;
 }
 
 const appVersion = __APP_VERSION__;
 type UpdateCheckStatus = 'idle' | 'checking' | 'available' | 'current' | 'error';
 
-export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs }) => {
+export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onOpenDocs }) => {
     const [themeMode, setThemeMode] = React.useState<ThemeMode>(() => getStoredThemeMode());
     const [settingsOpen, setSettingsOpen] = React.useState(false);
     const [checkOnStartup, setCheckOnStartup] = React.useState(() => getUpdateCheckOnStartup());
@@ -320,7 +320,7 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onToggleDocs })
                                     type="button"
                                     onClick={() => {
                                         setSettingsOpen(false);
-                                        onToggleDocs();
+                                        onOpenDocs();
                                     }}
                                     className="group flex w-full items-center gap-3 rounded-lg bg-muted/50 p-3 text-left transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
                                 >
diff --git a/src/components/LandingPage.tsx b/src/components/LandingPage.tsx
index 1257632..62b3c64 100644
--- a/src/components/LandingPage.tsx
+++ b/src/components/LandingPage.tsx
@@ -7,8 +7,12 @@ import {
     Github,
     Heart,
     MessageCircle,
+    Monitor,
+    Moon,
     Play,
+    Sun,
 } from 'lucide-react';
+import React from 'react';
 import logo from '../assets/logo.png';
 import fuji2d from '../../content/fuji2d_new.png';
 import fuji3d from '../../content/fuji3d_new.png';
@@ -16,6 +20,16 @@ import sliced from '../../content/fuji3dsliced.png';
 import printed from '../../content/printed.jpg';
 import redditIcon from '../assets/reddit.svg';
 import { APP_PATH, docsPath } from '@/lib/routes';
+import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover';
+import {
+    applyResolvedTheme,
+    applyThemeMode,
+    getStoredThemeMode,
+    saveThemeMode,
+    subscribeToSystemTheme,
+    THEME_STORAGE_KEY,
+    type ThemeMode,
+} from '@/lib/theme';
 
 const links = {
     releases: 'https://github.com/vycdev/Kromacut/releases',
@@ -73,12 +87,13 @@ function ExternalArrow() {
 }
 
 interface CommunityLinksProps {
+    children?: React.ReactNode;
     className: string;
     labelClassName?: string;
     testId?: string;
 }
 
-function CommunityLinks({ className, labelClassName = 'sr-only', testId }: CommunityLinksProps) {
+function CommunityLinks({ children, className, labelClassName = 'sr-only', testId }: CommunityLinksProps) {
     const linkClassName = 'inline-flex min-h-11 items-center justify-center gap-2 rounded-md px-3 text-sm font-semibold text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring';
 
     return (
@@ -95,13 +110,83 @@ function CommunityLinks({ className, labelClassName = 'sr-only', testId }: Commu
             <a href={links.patreon} target="_blank" rel="noopener noreferrer" aria-label="Support Kromacut on Patreon" title="Patreon" className={linkClassName}>
                 <Heart aria-hidden="true" className="h-4 w-4 text-rose-400" /><span className={labelClassName}>Support</span>
             </a>
+            {children}
         </nav>
     );
 }
 
+interface ThemePickerProps {
+    onChange: (themeMode: ThemeMode) => void;
+    themeMode: ThemeMode;
+}
+
+function ThemePicker({ onChange, themeMode }: ThemePickerProps) {
+    const [open, setOpen] = React.useState(false);
+    const ThemeIcon = themeMode === 'system' ? Monitor : themeMode === 'dark' ? Moon : Sun;
+    const options: Array<{ icon: typeof Monitor; label: string; value: ThemeMode }> = [
+        { icon: Monitor, label: 'System', value: 'system' },
+        { icon: Moon, label: 'Dark', value: 'dark' },
+        { icon: Sun, label: 'Light', value: 'light' },
+    ];
+
+    return (
+        <Popover open={open} onOpenChange={setOpen}>
+            <PopoverTrigger asChild>
+                <button
+                    type="button"
+                    aria-label={`Theme: ${themeMode}`}
+                    title="Change theme"
+                    className="inline-flex min-h-11 items-center justify-center rounded-md px-3 text-muted-foreground transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"
+                >
+                    <ThemeIcon aria-hidden="true" className="h-4 w-4" />
+                </button>
+            </PopoverTrigger>
+            <PopoverContent align="end" className="w-44 p-1.5">
+                <div className="px-2 pb-1.5 pt-1 text-xs font-semibold uppercase tracking-[0.12em] text-muted-foreground">Theme</div>
+                {options.map(({ icon: Icon, label, value }) => (
+                    <button
+                        key={value}
+                        type="button"
+                        aria-pressed={themeMode === value}
+                        onClick={() => {
+                            onChange(value);
+                            setOpen(false);
+                        }}
+                        className={`flex min-h-10 w-full items-center gap-2 rounded-md px-2.5 text-sm font-semibold transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring ${themeMode === value ? 'bg-primary text-primary-foreground' : 'text-muted-foreground hover:bg-muted hover:text-foreground'}`}
+                    >
+                        <Icon aria-hidden="true" className="h-4 w-4" />
+                        {label}
+                    </button>
+                ))}
+            </PopoverContent>
+        </Popover>
+    );
+}
+
 export default function LandingPage() {
+    const [themeMode, setThemeMode] = React.useState<ThemeMode>(() => getStoredThemeMode());
+
+    React.useEffect(() => {
+        applyThemeMode(themeMode);
+        if (themeMode !== 'system') return;
+        return subscribeToSystemTheme(applyResolvedTheme);
+    }, [themeMode]);
+
+    React.useEffect(() => {
+        const handleStorageChange = (event: StorageEvent) => {
+            if (event.key === THEME_STORAGE_KEY) setThemeMode(getStoredThemeMode());
+        };
+        window.addEventListener('storage', handleStorageChange);
+        return () => window.removeEventListener('storage', handleStorageChange);
+    }, []);
+
+    const setTheme = (nextThemeMode: ThemeMode) => {
+        saveThemeMode(nextThemeMode);
+        setThemeMode(nextThemeMode);
+    };
+
     return (
-        <main data-testid="landing-page" className="h-full overflow-x-hidden overflow-y-auto bg-background text-foreground">
+        <main data-testid="landing-page" className="h-full overflow-x-hidden overflow-y-auto bg-[#f6f8fc] text-foreground dark:bg-background">
             <a
                 href="#workflow"
                 className="sr-only z-50 rounded-md bg-blue-700 px-4 py-2 font-semibold text-white focus:not-sr-only focus:fixed focus:left-4 focus:top-4 focus:outline-none focus:ring-2 focus:ring-white focus:ring-offset-2 focus:ring-offset-blue-700"
@@ -113,10 +198,10 @@ export default function LandingPage() {
                 <div aria-hidden="true" className="pointer-events-none absolute inset-x-0 top-0 -z-10 h-full overflow-hidden">
                     <div className="absolute left-[8%] top-[-13rem] h-[34rem] w-[34rem] rounded-full bg-primary/20 blur-[100px]" />
                     <div className="absolute right-[-8rem] top-[8rem] h-[28rem] w-[28rem] rounded-full bg-fuchsia-500/10 blur-[100px]" />
-                    <div className="absolute inset-0 bg-[linear-gradient(to_right,rgba(148,163,184,0.06)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,0.06)_1px,transparent_1px)] bg-[size:3rem_3rem] [mask-image:linear-gradient(to_bottom,black,transparent_88%)]" />
+                    <div className="absolute inset-0 bg-[linear-gradient(to_right,rgba(71,85,105,0.12)_1px,transparent_1px),linear-gradient(to_bottom,rgba(71,85,105,0.12)_1px,transparent_1px)] bg-[size:3rem_3rem] [mask-image:linear-gradient(to_bottom,black,transparent_88%)] dark:bg-[linear-gradient(to_right,rgba(148,163,184,0.06)_1px,transparent_1px),linear-gradient(to_bottom,rgba(148,163,184,0.06)_1px,transparent_1px)]" />
                 </div>
 
-                <header className="mx-auto flex max-w-7xl flex-wrap items-center justify-between gap-3 px-5 py-5 sm:gap-6 sm:px-8 lg:px-10">
+                <header className="mx-auto flex max-w-7xl flex-wrap items-center justify-between gap-3 border-b border-slate-200/80 bg-white/55 px-5 py-5 backdrop-blur-xl sm:gap-6 sm:px-8 lg:px-10 dark:border-transparent dark:bg-transparent">
                     <a href={APP_PATH} className="flex items-center gap-3 rounded-lg focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-4 focus-visible:ring-offset-background">
                         <img src={logo} alt="" className="h-9 w-auto sm:h-10" />
                         <span className="hidden font-sans text-lg font-extrabold tracking-[0.12em] min-[390px]:inline">KROMACUT</span>
@@ -126,7 +211,9 @@ export default function LandingPage() {
                         <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
                         <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-2 transition-colors motion-reduce:transition-none hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                     </nav>
-                    <CommunityLinks testId="landing-community-links" className="hidden items-center gap-1 lg:flex" labelClassName="hidden xl:inline" />
+                    <CommunityLinks testId="landing-community-links" className="hidden items-center gap-1 lg:flex" labelClassName="hidden xl:inline">
+                        <ThemePicker themeMode={themeMode} onChange={setTheme} />
+                    </CommunityLinks>
                     <a
                         href={APP_PATH}
                         data-testid="landing-open-app"
@@ -140,9 +227,13 @@ export default function LandingPage() {
                             <a href={docsPath('overview')} className="inline-flex min-h-11 items-center rounded-md px-3 transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Docs</a>
                             <a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center rounded-md px-3 transition-colors hover:bg-muted/70 hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">Releases</a>
                         </nav>
-                        <CommunityLinks testId="landing-mobile-community-links" className="mt-1 flex items-center justify-center gap-1 border-t border-border/50 pt-1" />
+                        <CommunityLinks testId="landing-mobile-community-links" className="mt-1 flex items-center justify-center gap-1 border-t border-border/50 pt-1">
+                            <ThemePicker themeMode={themeMode} onChange={setTheme} />
+                        </CommunityLinks>
                     </div>
-                    <CommunityLinks testId="landing-tablet-community-links" className="order-last hidden w-full items-center justify-center gap-1 border-t border-border/70 pt-3 md:flex lg:hidden" />
+                    <CommunityLinks testId="landing-tablet-community-links" className="order-last hidden w-full items-center justify-center gap-1 border-t border-border/70 pt-3 md:flex lg:hidden">
+                        <ThemePicker themeMode={themeMode} onChange={setTheme} />
+                    </CommunityLinks>
                 </header>
 
                 <section className="mx-auto grid w-full max-w-7xl flex-1 items-center gap-14 px-5 pb-20 pt-12 sm:px-8 md:pb-28 md:pt-20 lg:grid-cols-[0.9fr_1.1fr] lg:gap-12 lg:px-10 lg:pt-24">
@@ -152,7 +243,7 @@ export default function LandingPage() {
                             Open source · browser first
                         </div>
                         <h1 className="max-w-2xl text-balance font-sans text-5xl font-extrabold leading-[0.95] tracking-[-0.045em] sm:text-6xl lg:text-7xl">
-                            Turn pixels into <span className="bg-gradient-to-r from-primary via-violet-400 to-fuchsia-400 bg-clip-text text-transparent">printable layers.</span>
+                            Turn pixels into <span className="bg-gradient-to-r from-blue-700 via-violet-600 to-fuchsia-600 bg-clip-text text-transparent dark:from-primary dark:via-violet-400 dark:to-fuchsia-400">printable layers.</span>
                         </h1>
                         <p className="mt-7 max-w-xl text-lg leading-8 text-muted-foreground sm:text-xl">
                             Kromacut transforms 2D images into stacked, color-layered 3D prints. Prepare your palette, match real filament, preview the result, and export a model ready for your slicer.
@@ -174,7 +265,7 @@ export default function LandingPage() {
 
                     <div className="relative mx-auto w-full max-w-2xl lg:ml-auto">
                         <div aria-hidden="true" className="absolute inset-0 rounded-[2rem] bg-primary/10 blur-3xl sm:-inset-8" />
-                        <div className="relative overflow-hidden rounded-2xl border border-white/10 bg-card/80 p-2 shadow-2xl shadow-black/30 backdrop-blur">
+                        <div className="relative overflow-hidden rounded-2xl border border-slate-200/90 bg-white/90 p-2 shadow-2xl shadow-slate-300/60 backdrop-blur dark:border-white/10 dark:bg-card/80 dark:shadow-black/30">
                             <div className="flex items-center justify-between border-b border-border px-3 py-2.5 text-[10px] font-bold uppercase tracking-[0.18em] text-muted-foreground">
                                 <span>3D layer preview</span>
                                 <span className="inline-flex items-center gap-1.5 text-emerald-400"><span className="h-1.5 w-1.5 rounded-full bg-emerald-400" /> ready to print</span>
@@ -183,7 +274,7 @@ export default function LandingPage() {
                                 <img src={fuji3d} alt="Color-layered 3D print preview" className="h-full w-full object-cover object-[95%_center]" fetchPriority="high" />
                             </div>
                         </div>
-                        <div className="absolute -bottom-5 -left-4 hidden items-center gap-3 rounded-xl border border-border bg-card px-4 py-3 shadow-xl sm:flex">
+                        <div className="absolute -bottom-5 -left-4 hidden items-center gap-3 rounded-xl border border-slate-200 bg-white px-4 py-3 shadow-xl shadow-slate-300/50 sm:flex dark:border-border dark:bg-card dark:shadow-black/30">
                             <div className="flex -space-x-1.5">{['#191d3d', '#5867d9', '#d64996', '#f5bd5a'].map((color) => <span key={color} className="h-7 w-7 rounded-full border-2 border-card" style={{ backgroundColor: color }} />)}</div>
                             <div><div className="text-xs font-bold">Palette mapped</div><div className="text-[11px] text-muted-foreground">4 printable colors</div></div>
                         </div>
@@ -191,7 +282,7 @@ export default function LandingPage() {
                 </section>
             </div>
 
-            <section id="workflow" tabIndex={-1} className="scroll-mt-8 border-y border-border/70 bg-card/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring">
+            <section id="workflow" tabIndex={-1} className="scroll-mt-8 border-y border-slate-200/90 bg-white/65 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-inset focus-visible:ring-ring dark:border-border/70 dark:bg-card/30">
                 <div className="mx-auto max-w-7xl px-5 py-20 sm:px-8 lg:px-10 lg:py-28">
                     <div className="max-w-2xl">
                         <p className="text-xs font-bold uppercase tracking-[0.2em] text-blue-700 dark:text-blue-300">From image to object</p>
@@ -200,7 +291,7 @@ export default function LandingPage() {
                     </div>
                     <div className="mt-14 grid gap-5 sm:grid-cols-2 lg:grid-cols-4">
                         {workflow.map((step) => (
-                            <article key={step.number} className="group overflow-hidden rounded-xl border border-border bg-background/70 shadow-sm transition-transform motion-safe:hover:-translate-y-1 motion-reduce:transition-none">
+                            <article key={step.number} className="group overflow-hidden rounded-xl border border-slate-200/90 bg-white/90 shadow-md shadow-slate-200/60 transition-transform motion-safe:hover:-translate-y-1 motion-reduce:transition-none dark:border-border dark:bg-background/70 dark:shadow-sm dark:shadow-black/20">
                                 <div className="aspect-[4/3] overflow-hidden border-b border-border bg-muted"><img src={step.image} alt={step.alt} loading="lazy" className={`h-full w-full ${step.imageFit === 'contain' ? 'object-contain' : 'object-cover'}`} style={{ objectPosition: step.imagePosition, transform: `scale(${step.imageScale})` }} /></div>
                                 <div className="p-5"><div className="font-mono text-xs font-bold text-blue-700 dark:text-blue-300">{step.number}</div><h3 className="mt-3 text-lg font-bold">{step.title}</h3><p className="mt-2 text-sm leading-6 text-muted-foreground">{step.description}</p></div>
                             </article>
@@ -226,7 +317,7 @@ export default function LandingPage() {
                 </div>
             </section>
 
-            <section className="border-t border-border/70 bg-muted/20">
+            <section className="border-t border-slate-200/90 bg-slate-100/80 dark:border-border/70 dark:bg-muted/20">
                 <div className="mx-auto flex max-w-7xl flex-col items-start justify-between gap-8 px-5 py-14 sm:px-8 md:flex-row md:items-center lg:px-10">
                     <div><p className="text-2xl font-extrabold tracking-tight sm:text-3xl">Ready to make a flat image physical?</p><p className="mt-2 text-muted-foreground">Start with an image. Finish with a print.</p></div>
                     <div className="flex flex-wrap gap-3"><a href={APP_PATH} className="inline-flex min-h-11 items-center gap-2 rounded-lg bg-blue-700 px-5 py-2.5 font-bold text-white shadow-lg shadow-blue-700/20 hover:bg-blue-800 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring motion-safe:transition motion-safe:hover:-translate-y-0.5 motion-reduce:transition-none">Open Kromacut <ExternalArrow /></a><a href={links.releases} target="_blank" rel="noopener noreferrer" className="inline-flex min-h-11 items-center gap-2 rounded-lg border border-border bg-background px-5 py-2.5 font-bold transition-colors motion-reduce:transition-none hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring"><Download aria-hidden="true" className="h-4 w-4" /> Desktop releases</a></div>
diff --git a/tests/e2e/landing.spec.ts b/tests/e2e/landing.spec.ts
index 6374e6f..d69017e 100644
--- a/tests/e2e/landing.spec.ts
+++ b/tests/e2e/landing.spec.ts
@@ -107,6 +107,22 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.locator('#workflow')).toBeFocused();
     });
 
+    test('landing theme picker persists light mode', async ({ page }) => {
+        await page.goto('/');
+        await page.evaluate(() => localStorage.clear());
+        await page.reload();
+
+        const communityLinks = page.getByTestId('landing-community-links');
+        await communityLinks.getByRole('button', { name: 'Theme: dark' }).click();
+        await page.getByRole('button', { name: 'Light', exact: true }).click();
+
+        await expect(page.locator('html')).not.toHaveClass(/dark/);
+        await expect.poll(() => page.evaluate(() => localStorage.getItem('theme'))).toBe('light');
+        await page.reload();
+        await expect(communityLinks.getByRole('button', { name: 'Theme: light' })).toBeVisible();
+        await expect(page.locator('html')).not.toHaveClass(/dark/);
+    });
+
     test('settings resources are keyboard-modal and restore focus', async ({ page }) => {
         await page.goto('/app');
         const settingsButton = page.getByRole('button', { name: 'Open settings' });
@@ -137,4 +153,14 @@ test.describe('landing page smoke @smoke', () => {
         await expect(page.getByText('Overview', { exact: true }).first()).toBeVisible();
         await expect.poll(() => page.evaluate(() => localStorage.getItem('kromacut.has-launched.v1'))).toBeNull();
     });
+
+    test('settings Docs action remains in documentation when Docs is already open', async ({ page }) => {
+        await page.goto('/docs/overview');
+        await page.getByRole('button', { name: 'Open settings' }).click();
+        await page.getByRole('dialog', { name: 'Settings' }).getByRole('button', { name: /Docs/ }).click();
+
+        await expect(page).toHaveURL(/\/docs\/overview$/);
+        await expect(page.getByRole('heading', { name: 'Contents' })).toBeVisible();
+        await expect(page.getByRole('button', { name: 'Back to app' })).toBeVisible();
+    });
 });

From 7b42c96f51a493529bf601f41420df55821e86c2 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Wed, 22 Jul 2026 22:30:15 -0500
Subject: [PATCH 75/81] feat: enhance filament calibration input handling for
 merge steps

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/components/FilamentCalibrationDialog.tsx | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/src/components/FilamentCalibrationDialog.tsx b/src/components/FilamentCalibrationDialog.tsx
index 6de1a52..a78c4ab 100644
--- a/src/components/FilamentCalibrationDialog.tsx
+++ b/src/components/FilamentCalibrationDialog.tsx
@@ -485,11 +485,18 @@ export function FilamentCalibrationDialog({
         return [...grouped.values()].map(({ filament, targets }) => {
             const readValues: FrontlitCalibrationRead[] = [];
             let complete = targets.length > 0;
-            // Whether the user typed anything at all, parseable or not. Only an
-            // untouched filament may be discarded without saying so.
+            // Whether the user typed anything at all, parseable or not, in
+            // either rail. A merge step alone cannot be calibrated, but it still
+            // means the row was entered, and only an untouched filament may be
+            // discarded without saying so.
             let touched = false;
             for (const target of targets) {
-                if ((reads[target.key] ?? '').trim() !== '') touched = true;
+                if (
+                    (reads[target.key] ?? '').trim() !== '' ||
+                    (mergeReads[target.key] ?? '').trim() !== ''
+                ) {
+                    touched = true;
+                }
                 const opacityLayers = parseLayerInput(reads[target.key]);
                 if (opacityLayers === null) {
                     complete = false;
@@ -513,7 +520,7 @@ export function FilamentCalibrationDialog({
                 : null;
             return { filament, targets, input, filled: readValues.length, touched };
         });
-    }, [activeMeasurePlan, reads]);
+    }, [activeMeasurePlan, reads, mergeReads]);
 
     // Session JND fit, computed once in the background when the entered reads
     // settle. Preview and Save both consume this cached result so the values
@@ -1241,7 +1248,7 @@ export function FilamentCalibrationDialog({
                                 {status === 'partial' && (
                                     <p className="mt-2 rounded-lg border border-amber-500/30 bg-amber-500/10 px-3 py-1.5 text-[11px] text-amber-600 dark:text-amber-400">
                                         {filled === 0
-                                            ? 'Enter a patch number of 1 or higher to calibrate this filament.'
+                                            ? 'Enter a match rail patch number of 1 or higher to calibrate this filament. A merge step on its own is not enough.'
                                             : `Read ${filled} of ${targets.length} bases. Fill in the rest to calibrate this filament, or clear it to skip it and keep its current settings.`}
                                     </p>
                                 )}

From 67233721094b4ac0c3ed9fe916283022b3246db0 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Thu, 16 Jul 2026 00:42:52 -0500
Subject: [PATCH 76/81] Add MultiImageMode and supporting hooks for multi-image
 feature

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/components/PrintUnlockEffect.tsx |  46 ++++++
 src/hooks/useSecretCode.ts           |  32 +++++
 src/hooks/useTileWorkspace.ts        |  51 +++++++
 src/index.css                        | 201 +++++++++++++++++++++++++++
 src/modes/MultiImageMode.tsx         |  15 ++
 5 files changed, 345 insertions(+)
 create mode 100644 src/components/PrintUnlockEffect.tsx
 create mode 100644 src/hooks/useSecretCode.ts
 create mode 100644 src/hooks/useTileWorkspace.ts
 create mode 100644 src/modes/MultiImageMode.tsx

diff --git a/src/components/PrintUnlockEffect.tsx b/src/components/PrintUnlockEffect.tsx
new file mode 100644
index 0000000..301fe64
--- /dev/null
+++ b/src/components/PrintUnlockEffect.tsx
@@ -0,0 +1,46 @@
+import React, { useEffect } from 'react';
+
+const DURATION_MS = 2600;
+
+function prefersReducedMotion(): boolean {
+    return (
+        typeof window !== 'undefined' &&
+        typeof window.matchMedia === 'function' &&
+        window.matchMedia('(prefers-reduced-motion: reduce)').matches
+    );
+}
+
+/**
+ * A quick, self-timing FDM "print build" flourish that plays when the hidden
+ * feat35 code (see src/hooks/useSecretCode.ts) unlocks multi-image mode. It
+ * renders a full-screen, click-through overlay of a filament object printing
+ * layer-by-layer with a sweeping nozzle, then calls `onDone` so the parent can
+ * unmount it. Bows out immediately for anyone who prefers reduced motion.
+ */
+function PrintUnlockEffect({ onDone }: { onDone: () => void }): React.ReactElement | null {
+    const reduced = prefersReducedMotion();
+
+    useEffect(() => {
+        const t = window.setTimeout(onDone, reduced ? 0 : DURATION_MS);
+        return () => window.clearTimeout(t);
+    }, [onDone, reduced]);
+
+    if (reduced) return null;
+
+    return (
+        <div className="feat35-overlay" aria-hidden="true">
+            <div className="feat35-stage">
+                <div className="feat35-object" />
+                <div className="feat35-nozzle">
+                    <div className="feat35-tip" />
+                </div>
+                <div className="feat35-caption">
+                    <span className="feat35-caption-main">MULTI-PLATE ONLINE</span>
+                    <span className="feat35-caption-sub">experimental feature</span>
+                </div>
+            </div>
+        </div>
+    );
+}
+
+export default PrintUnlockEffect;
diff --git a/src/hooks/useSecretCode.ts b/src/hooks/useSecretCode.ts
new file mode 100644
index 0000000..14e75a8
--- /dev/null
+++ b/src/hooks/useSecretCode.ts
@@ -0,0 +1,32 @@
+import { useEffect, useRef } from 'react';
+
+function isEditableTarget(target: EventTarget | null): boolean {
+    if (!(target instanceof HTMLElement)) return false;
+    const tag = target.tagName;
+    return tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || target.isContentEditable;
+}
+
+/**
+ * Fires `onMatch` the moment `code` is typed anywhere on the page, Chrome
+ * "thisisunsafe"-style — no input box, no visible prompt, keys typed into
+ * form fields don't count.
+ */
+export function useSecretCode(code: string, onMatch: () => void): void {
+    const bufferRef = useRef('');
+    const onMatchRef = useRef(onMatch);
+    onMatchRef.current = onMatch;
+    const target = code.toLowerCase();
+
+    useEffect(() => {
+        const onKeyDown = (e: KeyboardEvent) => {
+            if (isEditableTarget(e.target) || e.key.length !== 1) return;
+            bufferRef.current = (bufferRef.current + e.key.toLowerCase()).slice(-target.length);
+            if (bufferRef.current === target) {
+                bufferRef.current = '';
+                onMatchRef.current();
+            }
+        };
+        window.addEventListener('keydown', onKeyDown);
+        return () => window.removeEventListener('keydown', onKeyDown);
+    }, [target]);
+}
diff --git a/src/hooks/useTileWorkspace.ts b/src/hooks/useTileWorkspace.ts
new file mode 100644
index 0000000..7c12f92
--- /dev/null
+++ b/src/hooks/useTileWorkspace.ts
@@ -0,0 +1,51 @@
+import { useRef, useState } from 'react';
+import type { CanvasPreviewHandle } from '../components/CanvasPreview';
+import type { SwatchEntry, ImageDimensions } from './useSwatches';
+import type { TileSettings } from '../types/tileSettings';
+
+// Pins down the Step 2 common-core hook's signature ahead of its real
+// implementation (see tmp_multi_modularization.plan.txt, Step 0). Single-image
+// mode will eventually be exactly one instance of this hook; multi-image mode
+// one instance per tile plus one global-defaults instance. For now every
+// value is inert — no image processing is wired through it yet.
+export interface TileWorkspace {
+    imageSrc: string | null;
+    setImage: (url: string | null, pushHistory?: boolean) => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    undo: () => void;
+    redo: () => void;
+    swatches: SwatchEntry[];
+    swatchesLoading: boolean;
+    imageDimensions: ImageDimensions | null;
+    canvasPreviewRef: React.RefObject<CanvasPreviewHandle | null>;
+    isCropMode: boolean;
+    setIsCropMode: (value: boolean) => void;
+    showCheckerboard: boolean;
+    setShowCheckerboard: (value: boolean) => void;
+}
+
+export function useTileWorkspace(imageSrc: string | null, settings: TileSettings): TileWorkspace {
+    // Signature-only for now; real settings resolution lands in Step 2.
+    void settings;
+    const canvasPreviewRef = useRef<CanvasPreviewHandle | null>(null);
+    const [isCropMode, setIsCropMode] = useState(false);
+    const [showCheckerboard, setShowCheckerboard] = useState(false);
+
+    return {
+        imageSrc,
+        setImage: () => {},
+        canUndo: false,
+        canRedo: false,
+        undo: () => {},
+        redo: () => {},
+        swatches: [],
+        swatchesLoading: false,
+        imageDimensions: null,
+        canvasPreviewRef,
+        isCropMode,
+        setIsCropMode,
+        showCheckerboard,
+        setShowCheckerboard,
+    };
+}
diff --git a/src/index.css b/src/index.css
index 51df8e3..6b1c068 100644
--- a/src/index.css
+++ b/src/index.css
@@ -451,3 +451,204 @@ input[type='number'] {
 .side.w {
     left: -4px;
 }
+
+/* ---------------------------------------------------------------------------
+ * feat35 print-unlock effect: a quick FDM "print build" flourish that plays
+ * when the hidden code (see src/hooks/useSecretCode.ts) reveals multi-image
+ * mode. A filament object prints layer-by-layer while a nozzle sweeps, then
+ * the whole thing fades out. See src/components/PrintUnlockEffect.tsx.
+ * ------------------------------------------------------------------------- */
+.feat35-overlay {
+    position: fixed;
+    inset: 0;
+    z-index: 9999;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    pointer-events: none;
+    background: rgba(0, 0, 0, 0.55);
+    animation: feat35-fade 2.6s ease-in-out both;
+}
+
+.feat35-stage {
+    position: relative;
+    width: 260px;
+    height: 260px;
+}
+
+.feat35-object {
+    position: absolute;
+    left: 50%;
+    top: 50%;
+    width: 200px;
+    height: 160px;
+    transform: translate(-50%, -50%);
+    border-radius: 4px;
+    border: 1px solid rgba(255, 190, 130, 0.6);
+    box-shadow: 0 0 26px rgba(255, 120, 0, 0.55);
+    /* Repeating light bands read as FDM layer lines over a filament gradient. */
+    background:
+        repeating-linear-gradient(
+            0deg,
+            rgba(255, 255, 255, 0.16) 0 2px,
+            transparent 2px 6px
+        ),
+        linear-gradient(180deg, #ff9a4d, #ff6a00);
+    /* Reveal rises at a constant rate so it stays locked to the nozzle's climb
+     * (feat35-head, also linear); an eased curve here finishes the fill visually
+     * early and leaves the nozzle lagging behind. */
+    animation:
+        feat35-build 2.6s linear both,
+        feat35-pop 2.6s ease-out both;
+}
+
+.feat35-nozzle {
+    position: absolute;
+    left: calc(50% - 13px);
+    top: 50%;
+    width: 26px;
+    height: 30px;
+    background: linear-gradient(180deg, #c9ced6, #6b7280);
+    clip-path: polygon(15% 0, 85% 0, 85% 55%, 60% 100%, 40% 100%, 15% 55%);
+    animation: feat35-head 2.6s linear both;
+}
+
+.feat35-tip {
+    position: absolute;
+    bottom: -3px;
+    left: 50%;
+    width: 6px;
+    height: 6px;
+    transform: translateX(-50%);
+    border-radius: 50%;
+    background: #ffd9a3;
+    box-shadow: 0 0 12px 3px rgba(255, 140, 0, 0.9);
+}
+
+.feat35-caption {
+    position: absolute;
+    left: 50%;
+    bottom: -6px;
+    transform: translateX(-50%);
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 3px;
+    white-space: nowrap;
+    font-family: 'Oxanium', sans-serif;
+    animation: feat35-caption 2.6s ease-out both;
+}
+
+.feat35-caption-main {
+    font-weight: 700;
+    letter-spacing: 0.18em;
+    font-size: 0.95rem;
+    color: #ffcaa0;
+    text-shadow: 0 0 12px rgba(255, 120, 0, 0.7);
+}
+
+.feat35-caption-sub {
+    font-weight: 600;
+    letter-spacing: 0.26em;
+    font-size: 0.6rem;
+    text-transform: uppercase;
+    color: rgba(255, 202, 160, 0.7);
+}
+
+@keyframes feat35-fade {
+    0% {
+        opacity: 0;
+    }
+    10% {
+        opacity: 1;
+    }
+    82% {
+        opacity: 1;
+    }
+    100% {
+        opacity: 0;
+    }
+}
+
+/* Reveal bottom-up by shrinking the top inset from 100% to 0. */
+@keyframes feat35-build {
+    0% {
+        clip-path: inset(100% 0 0 0);
+    }
+    70% {
+        clip-path: inset(0 0 0 0);
+    }
+    100% {
+        clip-path: inset(0 0 0 0);
+    }
+}
+
+@keyframes feat35-pop {
+    0%,
+    70% {
+        transform: translate(-50%, -50%) scale(1);
+    }
+    80% {
+        transform: translate(-50%, -50%) scale(1.05);
+    }
+    100% {
+        transform: translate(-50%, -50%) scale(1);
+    }
+}
+
+/* Nozzle sweeps side to side while climbing with the growing top surface. */
+@keyframes feat35-head {
+    0% {
+        transform: translate(-95px, 70px);
+        opacity: 1;
+    }
+    10% {
+        transform: translate(95px, 47px);
+    }
+    20% {
+        transform: translate(-95px, 24px);
+    }
+    30% {
+        transform: translate(95px, 1px);
+    }
+    40% {
+        transform: translate(-95px, -22px);
+    }
+    50% {
+        transform: translate(95px, -45px);
+    }
+    60% {
+        transform: translate(-95px, -68px);
+    }
+    70% {
+        transform: translate(95px, -90px);
+        opacity: 1;
+    }
+    85%,
+    100% {
+        transform: translate(95px, -90px);
+        opacity: 0;
+    }
+}
+
+@keyframes feat35-caption {
+    0%,
+    62% {
+        opacity: 0;
+        transform: translate(-50%, 8px);
+    }
+    80% {
+        opacity: 1;
+        transform: translate(-50%, 0);
+    }
+    100% {
+        opacity: 1;
+        transform: translate(-50%, 0);
+    }
+}
+
+@media (prefers-reduced-motion: reduce) {
+    .feat35-overlay {
+        animation: none;
+    }
+}
diff --git a/src/modes/MultiImageMode.tsx b/src/modes/MultiImageMode.tsx
new file mode 100644
index 0000000..9b4765f
--- /dev/null
+++ b/src/modes/MultiImageMode.tsx
@@ -0,0 +1,15 @@
+import React from 'react';
+
+// Placeholder shell for issue #35 multi-image mode. See
+// tmp_multi_modularization.plan.txt, Step 0: lands the module's shape early
+// and inert; the tile rail, per-tile workspaces, and grid settings UI arrive
+// in later steps (4, 2/3, and 5 respectively).
+function MultiImageMode(): React.ReactElement {
+    return (
+        <div className="box-border text-inherit font-sans flex flex-col flex-1 min-w-0 max-w-full min-h-0 h-screen w-full items-center justify-center">
+            <p className="text-muted-foreground">Multi-image mode — coming soon.</p>
+        </div>
+    );
+}
+
+export default MultiImageMode;

From f56d9aef58f20680c8fdc512d8cca08ff25079cc Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Thu, 16 Jul 2026 01:17:45 -0500
Subject: [PATCH 77/81] Implement 3D controls and enhance image processing
 features in App component

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/App.tsx | 153 +++++++++++++++++++++++++++++-----------------------
 1 file changed, 87 insertions(+), 66 deletions(-)

diff --git a/src/App.tsx b/src/App.tsx
index 8dbd0c1..3bde4a3 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -1,4 +1,4 @@
-import React, { useEffect, useMemo, useRef, useState } from 'react';
+import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import ThreeDControls from './components/ThreeDControls';
 import {
     AUTO_PAINT_REPEAT_LIMITS,
@@ -55,6 +55,8 @@ import { applyAppSeo } from './lib/seo';
 import { appPath, markLaunched } from './lib/routes';
 import { isTauri } from '@tauri-apps/api/core';
 import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
+import PrintUnlockEffect from './components/PrintUnlockEffect';
+import { useSecretCode } from './hooks/useSecretCode';
 import {
     AlertDialog,
     AlertDialogContent,
@@ -132,12 +134,12 @@ const loadAutoPaintPersisted = (): AutoPaintPersisted | null => {
         const sanitized = parsed.filaments
             .map((filament: unknown) => sanitizeProfileFilament(filament))
             .filter(
-                (filament: ReturnType<typeof sanitizeProfileFilament>): filament is NonNullable<
-                    ReturnType<typeof sanitizeProfileFilament>
-                > => filament !== null
+                (
+                    filament: ReturnType<typeof sanitizeProfileFilament>
+                ): filament is NonNullable<ReturnType<typeof sanitizeProfileFilament>> =>
+                    filament !== null
             );
-        const persistedSchema =
-            typeof parsed.schemaVersion === 'number' ? parsed.schemaVersion : 1;
+        const persistedSchema = typeof parsed.schemaVersion === 'number' ? parsed.schemaVersion : 1;
         const filaments =
             persistedSchema >= AUTOPAINT_SCHEMA_VERSION
                 ? sanitized
@@ -184,6 +186,25 @@ const saveAutoPaintPersisted = (value: AutoPaintPersisted) => {
 
 function App(): React.ReactElement | null {
     const toolPath = appPath(isTauri());
+    // Multi-plate mode (issue #35) is still a stub. Per the plan, the flow diverges
+    // at *image upload*, not at app start — so until an image is uploaded the app
+    // must look and behave exactly like today. Typing "feat35" anywhere on the page
+    // (Chrome "thisisunsafe"-style — no box, no prompt) silently arms
+    // `multiPlateEnabled`; the future upload decider will read that flag inside the
+    // upload path to fork into multi-plate handling. Arming it plays a one-shot
+    // 3D-print flourish over the normal app as unlock feedback, then hands straight
+    // back to the untouched single-image UI. Nothing persists across a reload and
+    // there is no other trace of it.
+    const [multiPlateEnabled, setMultiPlateEnabled] = useState(false);
+    const [printing, setPrinting] = useState(false);
+
+    useSecretCode('feat35', () => {
+        if (!multiPlateEnabled) setPrinting(true); // flourish only when arming, not disarming
+        setMultiPlateEnabled((on) => !on);
+    });
+
+    const handleEffectDone = useCallback(() => setPrinting(false), []);
+
     // dropzone state managed by hook below
     // `weight` is the algorithm parameter; `finalColors` is the postprocess target
     const [weight, setWeight] = useState<number>(128);
@@ -269,12 +290,10 @@ function App(): React.ReactElement | null {
     const [mode, setMode] = useState<'2d' | '3d'>('2d');
     const [docsOpen, setDocsOpen] = useState(() => parseDocsLocation(window.location) !== null);
     const [isOrtho, setIsOrtho] = useState(loadCameraMode);
-    const [previewRenderMode, setPreviewRenderMode] = useState<PreviewRenderMode>(
-        loadPreviewRenderMode
-    );
-    const [previewColorMode, setPreviewColorMode] = useState<PreviewColorMode>(
-        loadPreviewColorMode
-    );
+    const [previewRenderMode, setPreviewRenderMode] =
+        useState<PreviewRenderMode>(loadPreviewRenderMode);
+    const [previewColorMode, setPreviewColorMode] =
+        useState<PreviewColorMode>(loadPreviewColorMode);
     const [exportingSTL, setExportingSTL] = useState(false);
     const [exportProgress, setExportProgress] = useState(0); // 0..1
     const [exportStep, setExportStep] = useState<ExportProgressStep>({
@@ -314,10 +333,8 @@ function App(): React.ReactElement | null {
                 regionWeightingMode:
                     autopaintHydrated.regionWeightingMode ?? prev.regionWeightingMode,
                 enhancedColorMatch: autopaintHydrated.enhancedColorMatch ?? prev.enhancedColorMatch,
-                preserveSeparation:
-                    autopaintHydrated.preserveSeparation ?? prev.preserveSeparation,
-                maxRepeatedSwaps:
-                    autopaintHydrated.maxRepeatedSwaps ?? prev.maxRepeatedSwaps,
+                preserveSeparation: autopaintHydrated.preserveSeparation ?? prev.preserveSeparation,
+                maxRepeatedSwaps: autopaintHydrated.maxRepeatedSwaps ?? prev.maxRepeatedSwaps,
                 transitionOpacity: autopaintHydrated.transitionOpacity ?? prev.transitionOpacity,
                 heightDithering: autopaintHydrated.heightDithering ?? prev.heightDithering,
                 ditherLineWidth: autopaintHydrated.ditherLineWidth ?? prev.ditherLineWidth,
@@ -519,10 +536,9 @@ function App(): React.ReactElement | null {
                 exportObjectTo3MFBlob(obj, {
                     layerHeight: builtModelState.layerHeight,
                     firstLayerHeight: builtModelState.slicerFirstLayerHeight,
-                    layerFilamentColors:
-                        builtModelAutoPaint
-                            ? builtModelState.autoPaintFilamentSwatches?.map((s) => s.hex)
-                            : undefined,
+                    layerFilamentColors: builtModelAutoPaint
+                        ? builtModelState.autoPaintFilamentSwatches?.map((s) => s.hex)
+                        : undefined,
                     onProgress,
                     onZipProgress,
                 }),
@@ -533,21 +549,22 @@ function App(): React.ReactElement | null {
     const processingActive = mode === '2d' && (isQuantizing || isDedithering);
 
     return (
-        <div className="box-border text-inherit font-sans flex flex-col flex-1 min-w-0 max-w-full min-h-0 h-screen w-full">
-            <Header
-                docsOpen={docsOpen}
-                onBackToApp={backToApp}
-                onOpenDocs={openDocs}
-            />
-            {docsOpen && (
-                <div className="flex flex-1 min-h-0 w-full">
-                    <DocsPage />
-                </div>
-            )}
-            <div
-                className={`${docsOpen ? 'hidden' : 'flex'} flex-1 min-h-0 w-full`}
-                ref={layoutRef}
-            >
+        <>
+            <div className="box-border text-inherit font-sans flex flex-col flex-1 min-w-0 max-w-full min-h-0 h-screen w-full">
+                <Header
+                    docsOpen={docsOpen}
+                    onBackToApp={backToApp}
+                    onOpenDocs={openDocs}
+                />
+                {docsOpen && (
+                    <div className="flex flex-1 min-h-0 w-full">
+                        <DocsPage />
+                    </div>
+                )}
+                <div
+                    className={`${docsOpen ? 'hidden' : 'flex'} flex-1 min-h-0 w-full`}
+                    ref={layoutRef}
+                >
                     <ResizableSplitter defaultSize={30} minSize={20} maxSize={50}>
                         <aside className="w-full bg-card border-r border-border flex flex-col min-h-0">
                             <ModeTabs mode={mode} onChange={setMode} />
@@ -877,38 +894,42 @@ function App(): React.ReactElement | null {
                             </div>
                         </main>
                     </ResizableSplitter>
-            </div>
+                </div>
 
-            {/* Build warning dialog */}
-            <AlertDialog
-                open={buildWarning !== null}
-                onOpenChange={(open) => !open && cancelBuild()}
-            >
-                <AlertDialogContent>
-                    <AlertDialogHeader>
-                        <AlertDialogTitle>Performance Warning</AlertDialogTitle>
-                        <AlertDialogDescription asChild>
-                            <div className="space-y-2">
-                                <p>Building the 3D model may be slow due to:</p>
-                                <ul className="list-disc pl-5 space-y-1">
-                                    {buildWarning?.warnings.map((w, i) => (
-                                        <li key={i}>{w}</li>
-                                    ))}
-                                </ul>
-                                <p>Do you want to continue?</p>
-                            </div>
-                        </AlertDialogDescription>
-                    </AlertDialogHeader>
-                    <AlertDialogFooter>
-                        <AlertDialogCancel>Cancel</AlertDialogCancel>
-                        <AlertDialogAction onClick={confirmBuild}>Build Anyway</AlertDialogAction>
-                    </AlertDialogFooter>
-                </AlertDialogContent>
-            </AlertDialog>
-
-            {/* Update checker for Tauri desktop app */}
-            <UpdateChecker />
-        </div>
+                {/* Build warning dialog */}
+                <AlertDialog
+                    open={buildWarning !== null}
+                    onOpenChange={(open) => !open && cancelBuild()}
+                >
+                    <AlertDialogContent>
+                        <AlertDialogHeader>
+                            <AlertDialogTitle>Performance Warning</AlertDialogTitle>
+                            <AlertDialogDescription asChild>
+                                <div className="space-y-2">
+                                    <p>Building the 3D model may be slow due to:</p>
+                                    <ul className="list-disc pl-5 space-y-1">
+                                        {buildWarning?.warnings.map((w, i) => (
+                                            <li key={i}>{w}</li>
+                                        ))}
+                                    </ul>
+                                    <p>Do you want to continue?</p>
+                                </div>
+                            </AlertDialogDescription>
+                        </AlertDialogHeader>
+                        <AlertDialogFooter>
+                            <AlertDialogCancel>Cancel</AlertDialogCancel>
+                            <AlertDialogAction onClick={confirmBuild}>
+                                Build Anyway
+                            </AlertDialogAction>
+                        </AlertDialogFooter>
+                    </AlertDialogContent>
+                </AlertDialog>
+
+                {/* Update checker for Tauri desktop app */}
+                <UpdateChecker />
+            </div>
+            {printing && <PrintUnlockEffect onDone={handleEffectDone} />}
+        </>
     );
 }
 

From b25e6d75cbb97e2ea5266b069fb0afc778ea4366 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Fri, 17 Jul 2026 23:54:16 -0500
Subject: [PATCH 78/81] feat: implement experimental multi-plate mode toggle
 and related functionality

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 src/App.tsx                          | 31 ++++++++-------
 src/components/Header.tsx            | 45 ++++++++++++++++++++++
 src/components/PrintUnlockEffect.tsx |  4 +-
 src/hooks/useSecretCode.ts           | 32 ----------------
 src/index.css                        |  9 +++--
 src/lib/experimentalFeatures.ts      | 57 ++++++++++++++++++++++++++++
 6 files changed, 127 insertions(+), 51 deletions(-)
 delete mode 100644 src/hooks/useSecretCode.ts
 create mode 100644 src/lib/experimentalFeatures.ts

diff --git a/src/App.tsx b/src/App.tsx
index 3bde4a3..59dcd9f 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -56,7 +56,10 @@ import { appPath, markLaunched } from './lib/routes';
 import { isTauri } from '@tauri-apps/api/core';
 import { migrateLegacyFilamentTd, sanitizeProfileFilament } from './lib/profileManager';
 import PrintUnlockEffect from './components/PrintUnlockEffect';
-import { useSecretCode } from './hooks/useSecretCode';
+import {
+    getMultiPlateEnabled,
+    subscribeToMultiPlateEnabled,
+} from './lib/experimentalFeatures';
 import {
     AlertDialog,
     AlertDialogContent,
@@ -188,20 +191,22 @@ function App(): React.ReactElement | null {
     const toolPath = appPath(isTauri());
     // Multi-plate mode (issue #35) is still a stub. Per the plan, the flow diverges
     // at *image upload*, not at app start — so until an image is uploaded the app
-    // must look and behave exactly like today. Typing "feat35" anywhere on the page
-    // (Chrome "thisisunsafe"-style — no box, no prompt) silently arms
-    // `multiPlateEnabled`; the future upload decider will read that flag inside the
-    // upload path to fork into multi-plate handling. Arming it plays a one-shot
-    // 3D-print flourish over the normal app as unlock feedback, then hands straight
-    // back to the untouched single-image UI. Nothing persists across a reload and
-    // there is no other trace of it.
-    const [multiPlateEnabled, setMultiPlateEnabled] = useState(false);
+    // must look and behave exactly like today. The experimental "Multi-plate mode"
+    // toggle in Settings arms the flag; the future upload decider will read it (via
+    // `getMultiPlateEnabled()`) inside the upload path to fork into multi-plate
+    // handling. The toggle persists (localStorage) like the other settings. Flipping
+    // it on plays a one-shot 3D-print flourish as feedback, then hands straight back
+    // to the untouched single-image UI; a persisted-on flag on a fresh load does not
+    // replay the flourish, so App only reacts to off→on transitions.
+    const multiPlateEnabledRef = useRef(getMultiPlateEnabled());
     const [printing, setPrinting] = useState(false);
 
-    useSecretCode('feat35', () => {
-        if (!multiPlateEnabled) setPrinting(true); // flourish only when arming, not disarming
-        setMultiPlateEnabled((on) => !on);
-    });
+    useEffect(() => {
+        return subscribeToMultiPlateEnabled((enabled) => {
+            if (enabled && !multiPlateEnabledRef.current) setPrinting(true); // flourish only on off→on
+            multiPlateEnabledRef.current = enabled;
+        });
+    }, []);
 
     const handleEffectDone = useCallback(() => setPrinting(false), []);
 
diff --git a/src/components/Header.tsx b/src/components/Header.tsx
index 61750f9..b92ab37 100644
--- a/src/components/Header.tsx
+++ b/src/components/Header.tsx
@@ -39,6 +39,11 @@ import {
     saveUpdateCheckOnStartup,
     subscribeToUpdateCheckOnStartup,
 } from '@/lib/updatePreferences';
+import {
+    getMultiPlateEnabled,
+    saveMultiPlateEnabled,
+    subscribeToMultiPlateEnabled,
+} from '@/lib/experimentalFeatures';
 import logo from '../assets/logo.png';
 import redditIcon from '../assets/reddit.svg';
 import { landingPath } from '@/lib/routes';
@@ -57,11 +62,13 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onOpenDocs }) =
     const [themeMode, setThemeMode] = React.useState<ThemeMode>(() => getStoredThemeMode());
     const [settingsOpen, setSettingsOpen] = React.useState(false);
     const [checkOnStartup, setCheckOnStartup] = React.useState(() => getUpdateCheckOnStartup());
+    const [multiPlateEnabled, setMultiPlateEnabled] = React.useState(() => getMultiPlateEnabled());
     const [updateStatus, setUpdateStatus] = React.useState<UpdateCheckStatus>('idle');
     const [availableUpdate, setAvailableUpdate] = React.useState<VersionInfo | null>(null);
     const [updateError, setUpdateError] = React.useState('');
     const settingsTitleId = React.useId();
     const updateStartupSwitchId = React.useId();
+    const multiPlateSwitchId = React.useId();
     const isDesktopApp = isDesktopUpdateSupported();
     const settingsButtonRef = React.useRef<HTMLButtonElement>(null);
     const settingsDialogRef = React.useRef<HTMLDivElement>(null);
@@ -139,6 +146,10 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onOpenDocs }) =
         return subscribeToUpdateCheckOnStartup(setCheckOnStartup);
     }, []);
 
+    React.useEffect(() => {
+        return subscribeToMultiPlateEnabled(setMultiPlateEnabled);
+    }, []);
+
     React.useEffect(() => {
         if (settingsOpen) return;
 
@@ -157,6 +168,14 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onOpenDocs }) =
         setCheckOnStartup(enabled);
     };
 
+    const setMultiPlate = (enabled: boolean) => {
+        saveMultiPlateEnabled(enabled);
+        setMultiPlateEnabled(enabled);
+        // Enabling plays a full-screen unlock flourish; close settings first so it
+        // plays over the app rather than on top of the open dialog.
+        if (enabled) setSettingsOpen(false);
+    };
+
     const handleCheckForUpdates = async () => {
         setUpdateStatus('checking');
         setAvailableUpdate(null);
@@ -486,6 +505,32 @@ export const Header: React.FC<Props> = ({ docsOpen, onBackToApp, onOpenDocs }) =
                             </section>
                         )}
 
+                        <section className="mt-5 space-y-3 border-t border-border pt-5">
+                            <div className="text-sm font-medium text-foreground">Experimental</div>
+                            <div className="rounded-md border border-border bg-background p-3">
+                                <div className="flex items-center justify-between gap-4">
+                                    <label
+                                        htmlFor={multiPlateSwitchId}
+                                        className="min-w-0 cursor-pointer"
+                                    >
+                                        <div className="text-sm font-medium text-foreground">
+                                            Multi-plate mode
+                                        </div>
+                                        <div className="mt-1 text-xs text-muted-foreground">
+                                            Unfinished multi-plate workflow. No effect yet; may
+                                            change or break.
+                                        </div>
+                                    </label>
+                                    <Switch
+                                        id={multiPlateSwitchId}
+                                        checked={multiPlateEnabled}
+                                        onCheckedChange={setMultiPlate}
+                                        aria-label="Enable experimental multi-plate mode"
+                                    />
+                                </div>
+                            </div>
+                        </section>
+
                         <div className="mt-5 flex items-center justify-between border-t border-border pt-4 text-xs text-muted-foreground">
                             <span>Kromacut</span>
                             <span className="font-mono">v{appVersion}</span>
diff --git a/src/components/PrintUnlockEffect.tsx b/src/components/PrintUnlockEffect.tsx
index 301fe64..7ba1089 100644
--- a/src/components/PrintUnlockEffect.tsx
+++ b/src/components/PrintUnlockEffect.tsx
@@ -11,8 +11,8 @@ function prefersReducedMotion(): boolean {
 }
 
 /**
- * A quick, self-timing FDM "print build" flourish that plays when the hidden
- * feat35 code (see src/hooks/useSecretCode.ts) unlocks multi-image mode. It
+ * A quick, self-timing FDM "print build" flourish that plays when the
+ * experimental "Multi-plate mode" settings toggle is switched on. It
  * renders a full-screen, click-through overlay of a filament object printing
  * layer-by-layer with a sweeping nozzle, then calls `onDone` so the parent can
  * unmount it. Bows out immediately for anyone who prefers reduced motion.
diff --git a/src/hooks/useSecretCode.ts b/src/hooks/useSecretCode.ts
deleted file mode 100644
index 14e75a8..0000000
--- a/src/hooks/useSecretCode.ts
+++ /dev/null
@@ -1,32 +0,0 @@
-import { useEffect, useRef } from 'react';
-
-function isEditableTarget(target: EventTarget | null): boolean {
-    if (!(target instanceof HTMLElement)) return false;
-    const tag = target.tagName;
-    return tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || target.isContentEditable;
-}
-
-/**
- * Fires `onMatch` the moment `code` is typed anywhere on the page, Chrome
- * "thisisunsafe"-style — no input box, no visible prompt, keys typed into
- * form fields don't count.
- */
-export function useSecretCode(code: string, onMatch: () => void): void {
-    const bufferRef = useRef('');
-    const onMatchRef = useRef(onMatch);
-    onMatchRef.current = onMatch;
-    const target = code.toLowerCase();
-
-    useEffect(() => {
-        const onKeyDown = (e: KeyboardEvent) => {
-            if (isEditableTarget(e.target) || e.key.length !== 1) return;
-            bufferRef.current = (bufferRef.current + e.key.toLowerCase()).slice(-target.length);
-            if (bufferRef.current === target) {
-                bufferRef.current = '';
-                onMatchRef.current();
-            }
-        };
-        window.addEventListener('keydown', onKeyDown);
-        return () => window.removeEventListener('keydown', onKeyDown);
-    }, [target]);
-}
diff --git a/src/index.css b/src/index.css
index 6b1c068..b75b515 100644
--- a/src/index.css
+++ b/src/index.css
@@ -453,10 +453,11 @@ input[type='number'] {
 }
 
 /* ---------------------------------------------------------------------------
- * feat35 print-unlock effect: a quick FDM "print build" flourish that plays
- * when the hidden code (see src/hooks/useSecretCode.ts) reveals multi-image
- * mode. A filament object prints layer-by-layer while a nozzle sweeps, then
- * the whole thing fades out. See src/components/PrintUnlockEffect.tsx.
+ * Multi-plate unlock effect: a quick FDM "print build" flourish that plays
+ * when the experimental "Multi-plate mode" settings toggle is switched on.
+ * A filament object prints layer-by-layer while a nozzle sweeps, then the
+ * whole thing fades out. See src/components/PrintUnlockEffect.tsx.
+ * (The `feat35-*` class names are kept as stable style identifiers.)
  * ------------------------------------------------------------------------- */
 .feat35-overlay {
     position: fixed;
diff --git a/src/lib/experimentalFeatures.ts b/src/lib/experimentalFeatures.ts
new file mode 100644
index 0000000..507662b
--- /dev/null
+++ b/src/lib/experimentalFeatures.ts
@@ -0,0 +1,57 @@
+export const MULTIPLATE_ENABLED_STORAGE_KEY = 'kromacut:experimental-multiplate';
+export const MULTIPLATE_ENABLED_CHANGED_EVENT = 'kromacut:experimental-multiplate-changed';
+
+const DEFAULT_MULTIPLATE_ENABLED = false;
+
+export function getMultiPlateEnabled(): boolean {
+    if (typeof window === 'undefined') {
+        return DEFAULT_MULTIPLATE_ENABLED;
+    }
+
+    try {
+        return window.localStorage.getItem(MULTIPLATE_ENABLED_STORAGE_KEY) === 'true';
+    } catch {
+        return DEFAULT_MULTIPLATE_ENABLED;
+    }
+}
+
+export function saveMultiPlateEnabled(enabled: boolean) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+
+    try {
+        window.localStorage.setItem(MULTIPLATE_ENABLED_STORAGE_KEY, String(enabled));
+    } catch {
+        // The in-session preference should still update if storage is blocked.
+    }
+
+    window.dispatchEvent(
+        new CustomEvent<boolean>(MULTIPLATE_ENABLED_CHANGED_EVENT, { detail: enabled })
+    );
+}
+
+export function subscribeToMultiPlateEnabled(onChange: (enabled: boolean) => void) {
+    if (typeof window === 'undefined') {
+        return () => {};
+    }
+
+    const handlePreferenceChange = (event: Event) => {
+        const detail = (event as CustomEvent<boolean>).detail;
+        onChange(typeof detail === 'boolean' ? detail : getMultiPlateEnabled());
+    };
+
+    const handleStorageChange = (event: StorageEvent) => {
+        if (event.key === MULTIPLATE_ENABLED_STORAGE_KEY) {
+            onChange(getMultiPlateEnabled());
+        }
+    };
+
+    window.addEventListener(MULTIPLATE_ENABLED_CHANGED_EVENT, handlePreferenceChange);
+    window.addEventListener('storage', handleStorageChange);
+
+    return () => {
+        window.removeEventListener(MULTIPLATE_ENABLED_CHANGED_EVENT, handlePreferenceChange);
+        window.removeEventListener('storage', handleStorageChange);
+    };
+}

From 3fc9f7cab877c5c789fec639cc9e410df5a41db8 Mon Sep 17 00:00:00 2001
From: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
Date: Wed, 22 Jul 2026 22:37:30 -0500
Subject: [PATCH 79/81] add CHANGELOG.md entry.

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>
---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 28c9cc4..6f3371a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -20,6 +20,7 @@ All notable changes to Kromacut are documented in this file.
 - **2D touch-up tools** - The 2D preview toolbar now includes five hard-edged pixel tools (Brush, Eraser, Fill, Text, and color picker) for direct image editing with palette-safe colors, an on-canvas text box you type into directly with live move, resize, and word wrap, one undo/redo step per edit, and live non-blocking drawing with adjustments staying non-destructive.
 - **Calibration theory docs** - New in-app documentation page explaining the science behind filament calibration: the frontlit Beer-Lambert optical model and hiding distance, why the wedge's reference-rail comparison is reliable without a camera, how a single patch read becomes a hiding distance through a just-noticeable-difference solve, per-channel measurement with multiple bases, the session JND fit, and what the confidence score reflects — illustrated with three new diagrams. The Calibrate Filaments dialog links straight to it.
 - **Reddit community links** - Added r/kromacut links to the app settings and README.
+- **Experimental multi-plate mode** - Added an experimental mode for multi-plate projects, where one image may be separated into multiple prints.
 
 ### Changed
 

From efc9f25a09f251b11b1ca4468bf0da6c5fdeaa27 Mon Sep 17 00:00:00 2001
From: Vadym <djdim2008@gmail.com>
Date: Thu, 23 Jul 2026 22:17:28 +0200
Subject: [PATCH 80/81] fix(profiles): strip UTF-8 BOM before parsing HueForge
 CSV/TSV imports

Fixes #42.

parseHueForgeCSV() matches column names literally against the header row
(e.g. "Color", "TD", "Brand"). Spreadsheet tools such as Excel commonly
prepend a UTF-8 byte-order mark (U+FEFF) when saving a file as CSV/TSV. When
that happens, the first header cell decodes as "\uFEFFColor" instead of
"Color", so the column lookup for the first header never matches. If the
export happens to lead with the Color column (a common HueForge spool
layout: "Color,TD,..."), every row then looks like it's missing a color and
gets silently skipped, and the import produces nothing.

Fix

Strip a single leading U+FEFF code unit from the CSV/TSV string before any
parsing happens, so the header row is decoded the same way whether or not
the source file carried a BOM. This only touches the very first character
of the input and has no effect on files without a BOM.

Testing

    npm ci
    npm run test     # 341/341 pass, 0 fail (full existing suite + 2 new tests)
    npx eslint . --ext .ts,.tsx --max-warnings=0 src/lib/profileManager.ts tests/profileManager.test.ts
    npx tsc -b --noEmit

Added two regression tests in tests/profileManager.test.ts, both against
the develop branch's parseHueForgeCSV (introduced in #37):
- "strips a leading UTF-8 BOM before parsing the header" - CSV whose header
  begins with "\uFEFFColor,TD,Name" now imports the row correctly, matching
  the exact failure mode described in #42.
- "strips a leading UTF-8 BOM from TSV input as well" - same fix verified
  for the tab-delimited path, since detectDelimiter/parseCSV are shared
  between CSV and TSV.
---
 src/lib/profileManager.ts    |  7 +++++++
 tests/profileManager.test.ts | 24 ++++++++++++++++++++++++
 2 files changed, 31 insertions(+)

diff --git a/src/lib/profileManager.ts b/src/lib/profileManager.ts
index 3256a67..b41e285 100644
--- a/src/lib/profileManager.ts
+++ b/src/lib/profileManager.ts
@@ -401,6 +401,11 @@ function parseCSV(content: string, delimiter: ',' | '\t'): string[][] {
  * Quoted fields with embedded commas, newlines, and "" escaped quotes are
  * supported per RFC 4180. Rows missing Color or TD are skipped.
  *
+ * A leading UTF-8 byte-order mark (U+FEFF), often added by spreadsheet
+ * tools such as Excel when saving CSV/TSV, is stripped before parsing so it
+ * doesn't get glued onto the first header name (e.g. "\uFEFFColor"), which
+ * would otherwise make every row's Color column look missing.
+ *
  * Returns null if the input has no header, no valid data rows, or cannot be
  * parsed.
  */
@@ -408,6 +413,8 @@ export function parseHueForgeCSV(
     csv: string,
     profileName = 'HueForge Import'
 ): AutoPaintProfile[] | null {
+    if (csv.charCodeAt(0) === 0xfeff) csv = csv.slice(1);
+
     const firstNewline = csv.indexOf('\n');
     const headerLine = firstNewline >= 0 ? csv.slice(0, firstNewline) : csv;
     const delimiter = detectDelimiter(headerLine);
diff --git a/tests/profileManager.test.ts b/tests/profileManager.test.ts
index 1625fac..743a72d 100644
--- a/tests/profileManager.test.ts
+++ b/tests/profileManager.test.ts
@@ -199,6 +199,30 @@ Overture Basic,#033877,Blue,3.5`;
     assert.equal(profile.filaments[0].td, 0.35);
 });
 
+test('parseHueForgeCSV strips a leading UTF-8 BOM before parsing the header', () => {
+    // A UTF-8 BOM (U+FEFF) is often prepended by spreadsheet tools (e.g.
+    // Excel) when saving CSV/TSV. Without stripping it, the first header
+    // cell reads as "\uFEFFColor" instead of "Color", so the Color column
+    // lookup fails for every row and no filaments are imported.
+    const csv = `\uFEFFColor,TD,Name
+#bf9c81,1.7,Light Brown`;
+    const profiles = parseHueForgeCSV(csv, 'My Spools');
+    assert.ok(profiles);
+    assert.equal(profiles.length, 1);
+    assert.equal(profiles[0].filaments.length, 1);
+    assert.equal(profiles[0].filaments[0].color, '#BF9C81');
+    assert.equal(profiles[0].filaments[0].td, 0.17);
+});
+
+test('parseHueForgeCSV strips a leading UTF-8 BOM from TSV input as well', () => {
+    const tsv = `\uFEFFBrand\tColor\tName\tTD
+Inland Basic\t#bf9c81\tLight Brown\t1.7`;
+    const [profile] = parseHueForgeCSV(tsv)!;
+    assert.equal(profile.filaments.length, 1);
+    assert.equal(profile.filaments[0].color, '#BF9C81');
+    assert.equal(profile.filaments[0].brand, 'Inland Basic');
+});
+
 test('auto-paint profiles can be renamed without changing filament data', async () => {
     const { renameProfile } = await loadProfileManager();
     const profiles: AutoPaintProfile[] = [

From b88920ea139b016d3402b5dd295b036aabf11fa5 Mon Sep 17 00:00:00 2001
From: Victor Sandu <vyctor661@gmail.com>
Date: Sat, 25 Jul 2026 09:45:22 +0300
Subject: [PATCH 81/81] docs: note BOM-prefixed HueForge imports

---
 CHANGELOG.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b56bf26..f0836ad 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -34,6 +34,7 @@ All notable changes to Kromacut are documented in this file.
 
 ### Fixed
 
+- **HueForge spool CSV/TSV imports** - BOM-prefixed HueForge spool files now import correctly when a UTF-8 byte-order mark precedes the first header.
 - **Settings documentation link** - Opening Docs from Settings now remains in the documentation when Docs is already active instead of unexpectedly returning to the app.
 - **Auto-paint Max Height** - Auto-paint now plans, scores, previews, and exports the same layer-aligned stack. Height caps round down to a valid printable layer boundary, so a generated model no longer exceeds the requested maximum by adding a final whole layer.
 - **Auto-paint region priority** - Center and Edge priority now use the actual locations of each image color. Center prioritizes colors near the image middle; Edge prioritizes colors near the outer border. The optimizer no longer allocates a full-image weight map or guesses location from color brightness.