Release v3.2.0 by vycdev · Pull Request #64 · vycdev/Kromacut

vycdev · 2026-07-23T18:37:34Z

Summary

This PR promotes the full Kromacut v3.2.0 release train from develop to main. It is a major release spanning physical filament calibration, appearance-aware Auto-paint, image preparation, 3D inspection, export reliability, the web experience, and desktop security updates.

Highlights

Three complementary physical calibration workflows

Hiding Distance: camera-free printed wedges with Quick and Accurate multi-base measurements, per-channel HD values, confidence scoring, partial result entry, and calibrated profile persistence.
Palette Proof: image-driven target selection from original or fitted/achievable colors, printable candidate matrices, iterative continuations, match-quality judgments, and regularized appearance fitting.
Stack Matrix: HD-guided selection from large fixed-depth recipe spaces, worker-backed 3MF creation, photographed-board orientation and alignment, perspective correction, LUT extraction, reference-marker lighting correction, and profile-integrated appearance evidence.

Better Auto-paint and physical output

Hiding Distance replaces ambiguous stored TD values, with one-time migration and per-channel optical behavior.
Enhanced matching scores the same layer-snapped physical stack used by preview and export with deterministic CIEDE2000-based optimization.
Added optimizer effort tiers, progress reporting, repeated-swap controls, transition detail, stable seeds, region weighting, and Preserve color separation.
Palette Proof and Stack Matrix evidence improve achievable-color fitting without introducing a second stack simulator.
Added carrier-free Flat Paint, producing an unmirrored, face-up print without a transparent carrier.
Added Simulated/Physical preview colors and Shaded, Transparent, and Wireframe inspection modes.

Image preparation and workflow

New responsive landing page at /, with the tool moved to /app.
Hard-edged Brush, Eraser, Fill, Text, and color-picker touch-up tools.
Supplier palettes and filament-profile templates, beginning with Bambu Lab PLA Basic.
Palette cloning, editable color names, and per-color enable/disable controls.
Collapsible 2D and 3D control groups with remembered state.
Improved crop workflow, settings navigation, and in-app calibration theory documentation.

Reliability and compatibility

Hardened smooth meshing and serialized 3MF topology against slicer-visible open or non-manifold geometry.
Streamed large desktop exports and moved heavy calibration/export work off the main UI thread.
Added safer profile validation and schema-v3 appearance-evidence import/export.
Added HueForge spool CSV/TSV profile imports.
Updated Tauri and supporting dependencies to resolve applicable security alerts.
Expanded deterministic optimizer, calibration, meshing, export, routing, and browser-flow regression coverage.

Release gallery

Landing page	2D touch-up tools
Enhanced Auto-paint result	3D inspection modes
Palette Proof target selection	Stack Matrix photo workflow

Open the complete v3.2.0 screenshot gallery

Image preparation and palettes

Image workspace	Supplier palettes
Named and selectively disabled colors	Crop workflow

Auto-paint and 3D output

Calibrated HD profile	Carrier-free Flat Paint controls
Physical filament preview colors	Application settings

Calibration workflows

Calibration hub	Accurate multi-base HD calibration
Frontlit calibration wedge	Selected Palette Proof colors
Palette Proof map	Stack Matrix setup
Calibration theory documentation

Showcase artwork uses public-domain images from Wikimedia Commons: Van Gogh self-portrait and Rainbow landscape. Calibration screens use Kromacut's repository test profile and genuine application states; no physical print results were simulated.

Compatibility notes

Older uncalibrated opacity values migrate once to the frontlit HD scale.
Calibrations produced by the removed photo-based workflow should be recreated with the new frontlit wedge.
Profile schema v3 adds bounded Palette Proof and Stack Matrix evidence while preserving v2 HD semantics.
Multi-plate work in this release is preliminary scaffolding and does not yet change generated output.

Validation

npm test — 453 tests passed
npm run lint
npm run build — production build completed; Rollup reported only the existing large-chunk warning
npm run test:e2e — 10 passed, 1 failed: settings resource focus did not land on the Patreon link after Shift+Tab (tests/e2e/landing.spec.ts:142); the focused rerun failed the same way
GitHub branch-direction check

Release checklist

Replace unreleased with the v3.2.0 release date in CHANGELOG.md
Smoke-test landing, /app, and documentation routes
Smoke-test frontlit wedge, Palette Proof, and Stack Matrix workflows
Smoke-test STL/3MF export in browser and packaged desktop builds
Confirm final release installers and update metadata

…xports Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

…d delimiters Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Add CSV import capability

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. @

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.

…omacut into autopaint-improvements

- Storage loads now migrate palettes/profiles whose ids collide with ANY reserved built-in id (generic palette ids like p4/g8/auto included, not just sup_/tpl_ prefixes) and persist the re-assigned ids so they stay stable across reloads; covered by localStorage-level tests - Number of Colors input is disabled while a named palette is selected, resolving the min-2 clamp fighting one-color palettes - Docs link Bambu Lab's official hex chart in both supplier sections; settings-and-controls documents .kpal v2 fields and legacy behavior - Supplier test pins all 30 official name/hex pairs exactly - Eye toggle gains aria-pressed and per-row aria-labels - New focused Playwright spec for the supplier/clone/toggle flow (not executed here: Playwright browsers are unavailable in the sandbox image; runs via npm run test:e2e where browsers exist) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Issue #26 discussion (comment by vycdev) asked for specific wording: an unofficial reference palette, not affiliated with, endorsed by, or sponsored by the manufacturer, names used only to identify referenced products, plus a link to the referenced chart. Dropdown captions and both docs sections now follow that phrasing; the chart link was already added to the docs. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Fixes #65

The two Fixed bullets refined behavior introduced in this same unreleased version, so per the changelog guidance they don't belong as Fixed entries. The palette-management e2e spec ran green in a real Chromium (Playwright v1.60.0 container): supplier group + disclaimer, clone with name inheritance, eye toggle to 29/30, reload persistence. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Fixes Star History

Feat/issue 26 suppliers palette and better management

…f-feedback # Conflicts: # src/hooks/useProfileManager.ts # src/lib/profileManager.ts

Add iterative palette proof calibration

vycdev2

Comprehensive review — changes requested

I reviewed all 165 changed files / 149 commits (+34,753 −4,660) across the optimizer and optical model, profile/evidence persistence, Palette Proof and Stack Matrix calibration, 2D editing, 3D meshing/export, Tauri integration, routing/docs, accessibility, dependencies, packaging, and tests.

Blocking/high-impact findings

The checked-in deterministic auto-paint golden is stale, so the clean unit suite is red.
The settings smoke test is stale after adding the multi-plate switch, so the clean E2E suite is red.
A late Stack Matrix photo decode can repopulate state for a different matrix/profile and allow calibration data to be saved to the wrong owner.

Other actionable findings

Golden fixtures use the global profile version instead of the TD/HD migration boundary.
Imported closest-cell judgments accept unbounded duplicate IDs and materialize duplicate exact anchors.
Image export races the new touch-up commit round trip.
Schema-valid touching-cell reinforcement geometry feeds overlapping holes to triangulation and generates excess/overlapping faces.
One internal documentation link has no target.
The changelog overstates both the multi-plate implementation and the completeness of the dependency-security cleanup.

Verification

npm run lint: passed.
npm run build: passed.
Clean-head focused export smoke: 1/1 passed (STL + 3MF).
Clean-head auto-paint golden test: failed deterministically on the repeated B&W/logo case.
After regenerating only the stale golden fixture: 453/453 Node tests passed.
After changing only the stale modal-focus expectation as well: 11/11 smoke E2E tests passed. These modified-worktree results are not presented as clean-head passes.
npm audit --omit=dev: 0 findings; full audit: 4 high, fixable development/build findings.
cargo metadata --locked: passed. cargo check --locked reached native dependency compilation but could not complete because this host lacks glib-2.0 >= 2.70; that is an environment limitation, not a PR finding.
git diff --check: passed; the review checkout remained clean at the exact PR head.

See the inline comments for reproductions and requested fixes.

This was generated by an AI agent (vycdev2). Please verify any changes before merging or applying.

vycdev2 · 2026-08-09T20:39:53Z

Review complete: changes requested

I reviewed all 165 changed files and posted 10 inline findings. The main blockers are:

the clean auto-paint golden suite is red because one deterministic fixture is stale;
the clean smoke E2E suite is red because the settings focus expectation predates the new switch;
a late Stack Matrix photo decode can write calibration state into a different active matrix/profile.

The remaining inline findings cover profile/evidence sanitation, touch-up export timing, Palette Proof geometry, fixture migration, docs, and release/dependency claims.

Full review: #64 (review)

This was generated by an AI agent (vycdev2). Please verify any changes before merging or applying.

vycdev2

Follow-up adversarial pass on the unchanged PR head found six additional, independently validated issues: two P1 correctness/resource blockers (touch-up history coalescing and unbounded calibrated TDs), plus four P2 import/default/accessibility defects. I used focused browser and module-level probes for the executable cases and withheld speculative, unreachable, or duplicate candidates.

This was generated by an AI agent (vycdev2). Please verify any changes before merging or applying.

Bjohnson131 and others added 30 commits June 12, 2026 16:47

Add support for importing filament profiles from HueForge spool CSV e…

91d2355

…xports Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Enhance CSV/TSV parsing in profile manager to handle quoted fields an…

1538067

…d delimiters Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Enhance CSV parsing to normalize hex colors and skip invalid rows

2f4a4e6

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Prepare 3.2.0 development cycle

35f2e85

Add auto-paint regression baseline

2191c2e

Add auto-paint benchmark harness

43eb66e

Fix auto-paint region priority

1544270

Make auto-paint optimization deterministic

966c13a

Unify auto-paint optimizer scoring

bc1d155

Add variable-length auto-paint search

6d41030

Improve auto-paint progress and 3MF exports

d685832

update to note tsv in docs, add escaped newline parsing.

8b838c5

Signed-off-by: Brice Johnson <1939015+Bjohnson131@users.noreply.github.com>

Merge branch 'develop' into csv-import

e4ae4b3

Harden auto-paint physics and 3MF export

46a6662

Keep auto-paint plan local

109a417

Merge pull request #37 from Bjohnson131/csv-import

8ee7e75

Add CSV import capability

Allow explicit exhaustive auto-paint search

9d766cd

Add Reddit community links

30ecd49

Improve calibration image sampler

6823226

Revert gitignore

15c64b0

Fix auto-paint printable height planning

8df9f88

Use calibrated TDs for auto-paint transitions

0ec0b49

Chain auto-paint transition colors

2efd547

Use linear-light auto-paint blending

f1273b5

Fit filament calibration in linear-light model

7d6174e

Score auto-paint with CIEDE2000 and p95 tail term

89716a1

Replace auto-paint optimizer menu with effort tiers

dc99787

Merge branch 'autopaint-improvements' of https://github.com/vycdev/Kr…

fc6ce13

…omacut into autopaint-improvements

RMantis and others added 16 commits August 6, 2026 00:57

Fixes Star History

042e3fc

Fixes #65

Merge pull request #70 from Mubelotix/patch-1

ae0bee4

Fixes Star History

Constrain supplier dropdown widths

0690b6d

Fix palette test storage isolation

e449d41

Preserve filament brands in profile identity

6cf5e0f

Merge pull request #71 from RMantis/feat/issue-26-palette-management

caf2e8b

Feat/issue 26 suppliers palette and better management

Merge remote-tracking branch 'origin/develop' into codex/palette-proo…

d223702

…f-feedback # Conflicts: # src/hooks/useProfileManager.ts # src/lib/profileManager.ts

feat: add stack matrix calibration

0ba53a3

feat: refine stack matrix photo alignment

932ae59

feat: polish stack matrix photo workflow

5f15ad3

Merge pull request #67 from vycdev/codex/palette-proof-feedback

234f5b3

Add iterative palette proof calibration

fix: address post-merge calibration review

bf39fde

fix: constrain palette proof history menu

d0e22e2

vycdev2 suggested changes Aug 9, 2026

View reviewed changes

vycdev2 reviewed Aug 9, 2026

View reviewed changes

vycdev added 11 commits August 10, 2026 19:34

fix: address calibration review findings

7550e99

fix: harden calibration defaults

17123ed

fix: reject incompatible proof reinforcement

0bb5531

feat: improve auto-paint color separation

7fa554d

Merge branch 'codex/improve-color-separation' into develop

7e59d13

feat: use stack matrix as empirical color LUT

9bf5cad

feat: combine compatible stack matrix evidence

1f2d935

fix: enforce total repeat limit

fd80672

feat: apply palette proof evidence locally

9db204b

feat: refit filament optics from stack matrices

0dccf53

feat: score auto-paint prediction uncertainty

4cbdf4e

Navigation Menu

Uh oh!

Release v3.2.0 - #64

Release v3.2.0#64
vycdev wants to merge 160 commits into
mainfrom
develop

vycdev commented Jul 23, 2026 •

edited

Loading

Uh oh!

vycdev2 left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vycdev2 commented Aug 9, 2026

Uh oh!

vycdev2 left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Uh oh!

Conversation

vycdev commented Jul 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Highlights

Three complementary physical calibration workflows

Better Auto-paint and physical output

Image preparation and workflow

Reliability and compatibility

Release gallery

Image preparation and palettes

Auto-paint and 3D output

Calibration workflows

Compatibility notes

Validation

Release checklist

Uh oh!

vycdev2 left a comment

Choose a reason for hiding this comment

Comprehensive review — changes requested

Blocking/high-impact findings

Other actionable findings

Verification

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

vycdev2 commented Aug 9, 2026

Review complete: changes requested

Uh oh!

vycdev2 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

vycdev commented Jul 23, 2026 •

edited

Loading