vycdev · vycdev · Jun 12, 2026 · Jun 14, 2026 · Jun 14, 2026 · Jun 18, 2026
diff --git a/.gitignore b/.gitignore
@@ -32,3 +32,6 @@ test-results/
 src-tauri/target/
 src-tauri/gen/
 src-tauri/WixTools/
+
+# Agent workspace files
+.agents/
diff --git 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
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -0,0 +1 @@
+@AGENTS.md
diff --git a/README.md b/README.md
diff --git 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/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,13 +1,15 @@
 {
     "name": "kromacut",
     "private": true,
-    "version": "3.1.0",
+    "version": "3.2.0",
     "license": "AGPL-3.0-only",
     "type": "module",
     "scripts": {
         "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",
+        "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",
@@ -27,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/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/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/scripts/generate-auto-paint-goldens.ts b/scripts/generate-auto-paint-goldens.ts
@@ -0,0 +1,65 @@
+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: 'balanced', seed: scenario.seed }
+        );
+
+        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/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,29 +145,36 @@ 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) => {
         const resolved = resolveDocHref(href, 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) {
@@ -325,6 +341,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 +372,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 +401,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
@@ -380,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.');
 }
@@ -391,5 +492,7 @@ 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();
+verifyGeneratedOutput(docs);