Shared tests check document and editor rules without a window. Host tests check native controls and input. GPU tests check pixels and rendering cost on a hardware GPU. Device tests check real pen, touch and display behaviour. None substitutes for another: injected input does not exercise the OS pen driver, a software adapter or small desktop fixture does not qualify hardware rendering or a tier's performance, and window-free tests do not establish host coverage.
Ordinary CI runs only when dispatched (gh workflow run ci.yml --ref <branch>).
It runs the window-free shared suites, the Wasm check, the Apple project check
and the license check. The release workflow adds platform builds,
packaging, script suites and software-adapter tests
(release validation). Neither replaces the
hardware checks and journeys for your change.
Run every row that matches your change and the area checks under
Shared Rust and UI and input, then walk the
affected user journeys on each affected host in light and dark themes. Scope
Cargo commands with -p; cargo test --workspace pulls in GPU and platform
crates that a given machine may not be able to run.
| Change | Checks |
|---|---|
Shared Rust (layer-core, -engine, -ui, -workspace, -color, -render) |
cargo test --locked -p <crate> for each changed crate, then cargo check --locked -p layer-linux --tests and cargo check --locked -p layer-web --target wasm32-unknown-unknown for the consumers. |
| Renderer, shaders or runtime filters | cargo test --locked -p layer-render-wgpu <filter> and -p layer-host on a hardware GPU. Frame-path changes need measurements. |
| Pen prediction or stroke placement | cargo test --locked -p layer-engine --features prediction-bench, then cargo build --locked -p layer-engine --release --features prediction-bench --examples and python3 tools/prediction/replay-bank.py --output artifacts/strokes/bank --analyze --check. |
| GTK | cargo test --locked -p layer-linux (includes the confined photo_reader integration test) for the model tests, then each affected journey on the private display: bash tools/performance/workspace-motion.sh gtk --native-test=<name>, adding --tablet for pen journeys (Linux). |
| Web | bash apps/layer-web/build.sh, the pure tests, then the affected journeys with bash tools/performance/workspace-motion.sh web --<journey> (headed, hardware WebGPU) or node apps/layer-web/test.mjs --headless --<journey> against run.sh. Packaging changes: node apps/layer-web/package.mjs && node apps/layer-web/test.mjs --package (Web). |
| Android | Without a device: ./gradlew :app:assembleDebug :app:assembleDebugAndroidTest :app:lintDebug -PcapyAbi=arm64-v8a in apps/layer-android. On a reserved tablet, through tools/devices/devices.py run: install both APKs with adb install -r, then am instrument -w -e class art.capycanvas.<Class>[#method] $CAPY_APPLICATION_ID.test/androidx.test.runner.AndroidJUnitRunner. Read OK or FAILURES!!!, not the exit status (Android). Kotlin or R8 changes also need the minified class check. |
| Android distribution | python3 -m unittest discover -s tools/build -p 'test_android_*.py', then the APK release checks on devices with and without Google services. A local build does not verify the APK that Play processes. |
| Apple | Anywhere: cargo test --locked -p layer-apple --lib -- --test-threads=1 and python3 apps/layer-apple/tests/test_icon_assets.py. On a Mac: the Swift fixtures, the command audit, and the XCTest journeys in the Apple guide. The iOS simulator renders the canvas through the Float32 texel fallback; hardware filtering, Pencil and timing need a physical iPad. |
| Windows | From any OS: cargo test --locked -p layer-host -p layer-ui -p layer-workspace -p layer-windows --lib and cargo clippy --locked -p layer-windows --all-targets -- -D warnings. On Windows: apps/layer-windows/scripts/test-without-gpu.ps1, then the exercise-*.ps1 fixtures for the changed area; from Linux, tools/windows-vm/windows-vm.py check and fixtures <name>, which runs in shared GPU sessions; fixtures --warp <names> or --runners N runs on the CPU pool. A configured VM GPU pool also supports gpu-check and fixtures --hardware-gpu <name>. HDR output, physical input and performance targets require the corresponding reference hardware (Windows). |
| GTK runtime recipe or SDK setup | The source regressions in the runtime guide and the release workflow's Arch job; GPU journeys still run on the private display on hardware. |
| Image codecs or color references | The affected Rust suites, the reference generators in tools/validation/ as the Arch job in .github/workflows/release-checks.yml builds and runs them, and the fuzz targets. The remaining ignored color tests need the pinned libavif 1.3.0 qualification SDK or external HEIF references. |
Dependencies or Cargo.lock |
cargo deny --locked check advisories licenses sources (publication). |
Scripts under tools/ |
python3 -m unittest discover -s tools/<dir> -p 'test_*.py', or node --test on the script's .test.mjs. |
| Docs only | Check every link, path, command and test name you wrote or whose target you changed. |
Select fixtures by the behavior and consumers a change affects, including callers
outside the edited feature. Run every affected variant, with both themes and
each affected input device. A single passing variant does not cover its family.
Brush, blender and frame-path shader changes must complete a fine default Pencil stroke on a WARP CPU runner before pushing; use fixtures --warp layers:default and its painted-thumbnail check.
UI fixtures run in shared GPU sessions by default. On --warp, the fixture registry
marks rows whose WARP first-dispatch or first-stroke submission
stall exceeds the fixture bound; production refuses software adapters. The runner
routes those rows to one pool GPU VM at the CPU runners' 150% scale. New rows
run on CPU runners there. A hardware annotation requires recorded WARP-only stall
evidence and hardware clearance of that stage, and hardware must reach at least
as far as the row's furthest recorded WARP stage. Keep later failures as failures;
never move a row to hardware to avoid a check that passes on WARP.
| Change | Windows fixtures before pushing |
|---|---|
| Shared UI state, layout, Windows host Rust or shared native controls, input and presentation | smoke plus every affected selector family and dependent journey. |
| Startup, window registry, automation discovery, shared fixture helpers or runner | Full default matrix. |
| Local controls and individual fixture scripts | Complete affected selector families and dependent journeys. |
smoke is the single named selector list in run-fixtures.ps1; use the alias
without hand-picking a subset. With --warp or --runners, smoke includes the
marked drawers and drawers:light rows: reserve one free exclusive pool card
and two CPU slots; no free card stops all fixture input. Follow the
VM matrix commands, plus
the windowless checks above. Fixture routing changes also run
tools/windows-vm/test-fixture-routing.ps1 on PowerShell 7 and Windows PowerShell
5.1 and the Python suite in tools/windows-vm.
Changes to scripts that fixtures or tests dot-source, AST-import or mock (for example,
CapyUia.ps1, CapyEnvironment.ps1 or run-fixtures.ps1) run the full normal
suite with tools/windows-vm/windows-vm.py check, not only the edited scripts.
Record first-attempt failures with the selector, exact error and evidence path;
a retry is diagnostic evidence, not a passing result. Fix or report failures
already on main before pushing. Do not remove a known failure until its
original assertion passes with the fix. Follow the
fixture authoring rules for geometry, DPI and identity.
The table names the tests for areas whose coverage is not obvious from the module layout. Run them with the row for the crate above; GPU tests need a hardware GPU, and Web, Android, GTK and Windows names are journeys run as their host guide describes.
| Area | Checks |
|---|---|
| Session persistence | Core package::session, package::session_transfer, package::session_store and persistence_tests; UI session_recovery and recovery; affected native restore/close fixtures; node apps/layer-web/restart-store.test.mjs. Keep the regression checks. |
| Memory diagnostics | UI stats::tests and localization_catalog_tests; renderer memory_sample::tests and display_memory::tests; GTK native_diagnostics_and_gpu_failure_recovery. |
| Workspace version copies | Native sqlite::snapshots::tests, shared snapshots::tests, and Web --workspace-store cover version changes, failed copies, legacy preservation, retention and transaction aborts. |
| Workspace startup | workspace_controls_become_ready_with_the_restored_layout_on_every_platform, UI renderer_lifecycle::tests::launch_, GTK native_launch_splash_timing_and_bypass and native_startup_latency (cold painted-editor reveal); Android AndroidFirstUiTest (splashMarkFitsSystemSafeCircle, launchRevealWaitsForReadyDrawAndCommit); Web --workspace-startup. |
| Artwork, filters and file format | Core package::effect_records, package::codec and package::session with the fixed builtin-contracts.json and authored-filters.capy; on hardware, saved_artwork_render_contracts and saved_angular_filter_render_contracts with -- --nocapture. |
| Vector layers | vector::tests; on hardware, saved_vector_render_contract. |
| Vector face Fill | Core authored::vector, UI vector_line_tests; GTK native_vector_fill_between_open_strokes and native_vector_gap_fill_and_everywhere; Web --vector-fill, both themes. Release vector_face_busy_page measures the 2,002-path Off, Auto and search-miss gates, and vector_fill_busy_page_timings measures press/lift dispatch and each fixed-reach slot; renderer vector_reference_line_middle_tracks_pressure_stroke_centrelines checks raster fill against pressure-stroke centre lines. |
| Vector mask tracing and enclosure | Core authored::vector::trace and selection_coverage_samples; engine vector_stroke; UI vector_line_tests and enclose_fill_checks; GTK native_vector_trace_raster_and_enclose; Web --vector-fill, both themes. Release trace_and_fit_large_region_budgeted measures the TCL 8 ms per-call trace/fitting budget. |
| Pointwise color adjustments | Core color_adjustment_schema_tests; UI Colorize and Threshold Properties tests; renderer native_effects::color, scale::tests::color_effects and filter_weights_preserve_exact_original_and_signed_output_endpoints. |
| Spatial filters | scene::scale::tests::effects::gaussian. |
| Shadows/Highlights, Clarity, Dehaze | UI effect_analysis_tests; renderer snapshot::tests::local_adjustments, effect_analysis_lease_tests and local_tone; GTK native_diagnostics_and_gpu_failure_recovery and native_document_tab_input; Android registeredDehazeMatchesIndependentTwoPixelAirlightTie and localAdjustmentsUpdateStackedSourcesAndPersistExactOutput. |
| Color Lookup | lut3d_tests in layer-core, layer-ui and layer-render-wgpu; GTK native_color_lookup_import_replace_and_persistence; Web --lookup-transport; Android colorLookupImportPresetsAndResourceLifetime. |
| Levels, Curves and scopes | artwork_statistics_tests, levels_statistics_tests and curves_calibration_tests; the tonal journeys; Web --tonal-controls. |
| Fill line geometry | Renderer enclose_fill_geometry*, including CPU enclose_fill_geometry_known_misses_only_shrink; remove fixed cases from KNOWN_MISSES. GTK native_fill_scribble_geometry --tablet; Web --enclose-fill, using tools/fixtures/fill-scribble.json. |
| Fill anti-aliased edges | Renderer enclose_fill::edges; GTK native_fill_antialiased_edge_plates and Web --enclose-fill use tools/fixtures/fill-edges.json. |
| Fill cache | Renderer region_cache_, background_cache_prepares_query_recipes_before_becoming_idle, end_storage_scales_with_canvas_area_and_fits_61mp, native_stroke_publication_keeps_prepared_reference_pages_and_matches_fresh_masks and command_mask_reuse_preserves_fractional_coverage_and_placement; GTK native_enclose_fill_pointer_workflow; Web --enclose-fill. |
| Fill areas and Paint unfilled | Renderer enclose_fill::fill_areas, shared UI enclose_fill_checks; GTK native_fill_areas_and_paint_unfilled; Web --fill-areas. |
| Flat All Areas | Renderer flat_areas_tests (24/61 MP rows use --ignored); UI flat_all_areas; GTK native_flat_all_areas_scribbles; Web --flat-all-areas. |
| Fill texture | native_fill_texture_matches_contact_and_flat_pixels_through_history; GTK native_fill_texture_controls_and_papers. |
| Gradients | Core gradient; UI shared_gradient; GTK native_gradient_editor_modes_contacts_and_archive and native_gradient_tool_editor_shapes_and_reverse. |
| Layer color modes and Add Filter | Core saved_reduced_color_layers_keep_modes_channel_counts_and_samples; color fixed_reduced_color_layers_preserve_modes_and_alpha_through_document_depth_changes; renderer layer_color_modes and reduced_color; UI filter_drawer_tests; GTK native_layer_color_modes_and_add_filter; Web --filter-drawer; Android AndroidInteractionTest#layerColorModesAndLocalFilterMenu; Windows exercise-layers.ps1; painting rates with android-brush-benchmark.py --color-mode grayscale and --color-mode two_tone. |
| Dither Spread, Scatter, Crystallize | UI artistic_cell_contract; GTK native_artistic_cell_filters; Web --artistic-filters; Android artisticCellFiltersKeepNativePixelsControlsAndHistory. |
| Export Again | UI export_again_tests; GTK native_export_again_retains_recipe_and_current_pixels_per_document; Web --export-metadata; Android AndroidRasterTest#exportAgainRetainsDestinationRecipeAndDrawingOwnership. |
| Paper | UI a_late_library_read_cannot_replace_a_newer_paper_choice and scaling_paper_preserves_the_pending_library_choice; host changing_paper_texture_holds_early_strokes_until_the_new_binding_is_ready; Android AndroidRasterTest#paperTextureChangesRetainImmediatePencilContacts; Web --paper-texture-readiness on desktop and Android Chrome; Apple headless app and project fixtures. |
| Liquify | Renderer Liquify tests; GTK native_liquify_pinch_stroke_on_a_pattern with --tablet; Web --liquify-journey. |
| Transforms and capture | Renderer pixel_transform::program_tests, scene::capture_readiness_tests, staged_off_canvas_captures_prepare_constant_paper_and_keep_its_frame_extent, scene::scale::tests::source_progress and correction_gather_; transforms_the_shared_page_check_admits_always_plan; GTK native_photo_transform_reference_pivot_snap_and_nudge and native_distort_near_collinear_corner_recovery; Web --capture-readiness, --image-commands and --transform-footprint. |
| Merge across raster pages | merging_trimmed_crossings_preserves_ink_across_raster_pages on hardware and the Windows software adapter. |
| Pipeline and shader preparation | Renderer startup::platform::tests (compiler scheduling), dry_material::tests, shader_limits::tests and reduction_samplers_live_with_records_not_page_views; host dry_brushes_never_compile_while_painting_any_pose in a debug build; GTK native_dry_brush_preparation (with __GL_SHADER_DISK_CACHE=0 for a cold NVIDIA driver) and native_late_shader_failure_after_startup; Web --pipeline-readiness and --drawing-tabs-recovery. |
| GPU limits and native writeback | upload_capacity_tests and levels_statistics_tests; Web --native-writeback and --heal-portability, because browser defaults can exceed the limits native tests request. |
| Watercolor and direct paint | first_watercolor_frame_batches_page_initialization, first_watercolor_contact_on_empty_layer_batches_source_reduction, page_zero_copies_reclear_both_formats_and_reduced_extents and watercolor_transport_batches_restored_empty_backing; direct_contact_paint_and_erase_match_destination_deposition with --ignored on hardware float32 blending. |
| Presentation and submission | The vendored wgpu-core surface tests with RUSTFLAGS='--cfg wgpu_validate_locks', with and without the trace feature (vendored crates); renderer submission::tests; Android frontBufferSurfaceLifecycle. Measure navigation and brush rows separately. |
| Pen tilt | Engine projected_tilt and dry_pose_keys_use_physical_inclination_independent_of_azimuth; Android AndroidStylusTest and AndroidHostTest#physicalTiltControlsDryBrushCursorAndPigment; GTK native_contact_brushes; Web --contact-brushes. |
| Panels, bridges and squircles | Shared panel_bridges::tests and divider_geometry_; renderer panel_surface::tests and panel_geometry::tests; GTK panel_tabs::tests, workspace::allocation_tests, squircle::tests, render_thread::tests::chrome_, ignored render_thread::tests::workspace_presenter_prepares_chrome_before_first_panel_parameters, native_squircle_corners, native_panel_tab_alpha_pixels, native_compact_shadow_pixels and native_window_scene_pixels; Android columnBridgeGapFrameTiming and AndroidWorkspacePresentationTest. |
GTK native_document_tabs_cold_store_motion checks cold pan and ordered paint/undo after real pressure parking.
Tab sizing: cargo test --locked -p layer-ui tab_measurement_tests; Android AndroidHostTest#crowdedTabReordersKeepPanelWidthsAndBodies covers English/Russian reorder after resize in both themes.
Pending transform cancellation: GTK native_transform_escape at 412×891 and 1600×1000 in light and dark checks one physical Escape, drawer closure and unchanged artwork history.
New drawing spacing: GTK native_new_drawing_preview_spacing checks stacked preview height and the wide two-pane layout in light and dark.
Filter categories: GTK native_filter_category_footer checks initial clipping and scrolls the last row above Cancel at 412×891 and 280×560.
Tool lists: GTK native_tool_list_alignment compares Select and Healing rows at 412×891 and 1600×1000 in light and dark.
Export layout: GTK native_export_narrow_bounds checks the previews, fields and header actions at 280, 320 and 412 px in light and dark.
Preferences layout: GTK native_preferences_inline_controls_fit checks 280/320 px pages; native_zen_icons checks image choice selection and Reset in both themes.
The GTK journeys are native_composite_histogram_updates_without_changing_the_drawing,
native_curves_histogram_preserves_numeric_focus,
native_levels_auto_and_calibration_atomic_history,
native_curves_calibration_atomic_history,
native_targeted_curves_rgb_contacts_and_cancel,
native_targeted_curves_red_contacts_and_cancel,
native_compact_graphs_photo_review and
native_waveform_photo_sources_channels_and_layout. Run the calibration and
targeted journeys with --tablet, at narrow and wide widths in both themes.
Calibration defaults to the mouse matrix; set LAYER_TONAL_CONTACT=pen or
touch, LAYER_TONAL_ROLE=Black, Gray or White, and LAYER_TONAL_THEME=Light
or Dark for one contact per process. native_targeted_curves_motion_and_latency
with LAYER_NATIVE_INPUT_TRACE=1 records input, curve adoption and presentation
times on the private 120 Hz display.
Extensive compatibility run. Use python3 tools/compat/run.py rust, upgrade,
downgrade, web, app-data or windows (all runs them all) without a GPU.
--releases takes comma-separated
tags and defaults to every stable tag from v1.0.15 onward. --work holds private
storage and builds; reports and check logs remain there, while --keep also
retains generated inputs and build scratch. Upgrade and downgrade run only the
four CPU Cargo generators and print SKIP for the GTK preview generator;
committed app-rendered preview fixtures are covered by rust. Releases without
generators or external-input tests print their skip reasons. The normal
external_compat_inputs_load tests accept CAPY_COMPAT_IN without comparing
expectations. web serves a minimal Wasm/IndexedDB page in headless Chrome with
--disable-gpu; it never loads the editor. app-data checks released data folders
through native startup; repeat --app-data DIR to report on copies of other
folders. User-folder outcomes are reported without failing the run. Run the
shared checker directly on a copy with
cargo run --locked -p layer-workspace --features native --example check-saved-data -- DIR.
windows runs the registered saved-data fixtures on one CPU-pool runner;
without a configured Linux/KVM pool it prints SKIP. The manual Compatibility
workflow accepts comma-separated releases and modes (both default to all),
keeps each mode's report and logs, and calls Windows readiness on hosted WARP.
Android remains a local AndroidSavedStateTest journey on a
reserved tablet; there is no Android compatibility job in GitHub Actions.
release_fixtures_load_without_loss in layer-workspace (with --features native),
layer-core, layer-ui and layer-host opens released inputs through the real
store, import and recovery readers and compares reviewed authored values and
resource/preview digests, including save/reopen and session history.
CI enables the native workspace cases and runs the paper compatibility tests
separately without a GPU. The pre-push hook runs the released-input guard over
every pushed range, and CI runs it over the commits since origin/main, both
with full history so intermediate input edits cannot hide behind a later restore.
generated_compat_fixtures_load_without_expectations runs the workspace fixture
generator in private temporary storage and reads every generated input through
the release loaders without expectation files; output excludes markers and locks.
generated_saved_documents_set_every_field (UI) checks non-default saved fields,
including serde omissions; generated_fixtures_cover_every_saved_value (core)
checks portable saved values and private-only session fields.
saved_documents_tolerate_missing_and_unknown_fields in the affected suites
removes defaultable app-state options and adds unknown struct fields; required
identities and structure still fail validation. Closed artwork records keep
their strict package acceptance tests.
Inputs live in each crate's tests/compat/<release>/, written by that release's
code and never edited or resaved. Expectations live separately under
tests/compat/expected/<release>/; CAPY_BLESS=1 rewrites only expectations.
Review the first expectation against the source input field by field, including
references and resource bytes, before accepting it. Later expectation diffs get
the same review as code. Commit reviewed expectations with the
compatibility explanation.
The push guard
enforces immutable inputs; the release procedure
adds new ones. Never freeze old Rust types or change an input to hide a regression.
- Test threads. Renderer tests create and destroy their own GPU device, so
.cargo/config.tomlruns four test threads unlessRUST_TEST_THREADSor--test-threadssays otherwise. Some Linux drivers limit live Vulkan devices per process or deadlock when many threads create and destroy devices; use--test-threads=1for device-heavy filters. Headless renderers keep one wgpu instance for the process lifetime, because reloading the driver eventually exhausts static TLS. - Software adapter.
layer-render-wgpuunit tests andsoftware-adapter-testsbuilds accept a CPU adapter whenLAYER_TEST_SOFTWARE_GPU=1is set. Those runs check numbers only; production hosts always require a hardware GPU. Runraster_capture_waits_share_the_selected_gpu_budgetwith and without--features software-adapter-testsafter changing feature forwarding. The Windows runner is described in the Windows guide. - Fixed fixtures. File-format changes read the checked-in
crates/layer-core/src/package/codec/fixturesfiles, then edit, save and reopen them. Never regenerate fixture inputs from the current writer. When a representation that never shipped is replaced, move its value and resource assertions to a current-design fixed fixture without a conversion reader (package contract). - Render baselines. The saved artwork, angular filter and vector contracts
compare against fixed linear RGBA F32 images in
crates/layer-render-wgpu/src/fixtures, captured with Vulkan on an NVIDIA RTX PRO 6000 Blackwell; each index row holds its case's tolerances. Other hardware backends qualify against the same inputs and tolerances, and a CPU adapter is rejected. There is no baseline-update mode: a change beyond tolerance needs a regression fix or a new authored data version with a converter and an unchanged-file regression. A reviewed appearance change to an evolving procedural filter under the package policy replaces only that filter's rows. - Shared helpers. Use
session::test_supportforlayer-uiRecorder fixtures, action dispatch, pointer records, selections and document-space pen input; platform overrides belong there, not in production sessions. Photo writer tests usephoto::test_support::assert_provider_failure; presentation tests create surfaces with the renderer'screate_target. - Settle before reading. Completed-stroke fixtures wait for
has_pending_document_editsto clear before reading pixels or starting another edit: draining input does not publish delayed pen-up work, and a smoothed pen-up settles for 32 ms. Observe a frame before asserting that no ink was deposited. Undo availability reports history entries, not raster backing readiness. Native GPU fixtures fit the current viewport and project authored points through that camera. - Previews. Check a moving preview in the display cache: document export readback rebuilds a full-resolution result instead.
- Cold devices. Readiness and cold-capture tests use a fresh device; a warm native device can hide missing preparation.
- Storage. Storage-folder tests pass the override and platform folders
explicitly and must hold under a private
CAPY_STORAGE_DIR. SQLite fixtures canonicalize paths beforerusqlite::Connection::open, as the store does; on Windows run them in a private directory whose database paths exceed 260 characters. - Shaders. Pass only the pipeline constants an entry point uses, because
Safari rejects unused overrides, and declare no struct member after a
bool, because Mali's compiler crashes on it.dry_material::testschecks both without a GPU. Native Metal, Chrome and Safari use different shader compilers, so check browser compiler failures in that browser. Generator fixtures load exact pixel bits at run time; compilers may flush subnormal shader literals. - Expected panics. Timed worker-recovery fixtures inject expected unwinds
with
resume_unwindso panic-hook backtraces do not consume their deadline.
Run cargo test --locked -p layer-ui localization_catalog_tests for catalog
changes, then the shared Rust and consumer checks above when Rust changes. These
window-free tests format every message directly, so errors surface before the
runtime English fallback can hide them.
Live language changes run cargo test --locked -p layer-ui language_ and the
full changed-crate suites, then the host journeys in both themes:
workspace-motion.sh gtk --native-test=native_live_language_switching,
workspace-motion.sh web --language-switching, Android AndroidLanguageTest and
Windows scripts/exercise-localization.ps1. Run the affected dialog and
composition suites too. Synthetic composition and InputConnection coverage do
not establish genuine CJK IME behavior.
For an advertised language, walk every affected host in both themes, including search, rename with IME, Unicode save/reopen, export, unsaved close, validation errors, workspace history and accessibility. Check narrow windows and increased system text size. Follow the localization guide for catalog and release rules.
fuzz/ holds cargo fuzz targets for the shared readers of outside files:
import (photos and .capy through the shared import policy), workspace
(workspace and toolbar packages), icc, lut and palette. It is its own
Cargo workspace with the same vendored patches. Run a target with a nightly
toolchain and AddressSanitizer, keeping corpora and artifacts outside the repository:
cd fuzz && cargo +nightly fuzz run -O import /mnt/localssd/fuzz/import -- \
-fork=8 -ignore_crashes=1 -ignore_ooms=1 -ignore_timeouts=1 -max_total_time=1800Treat an AddressSanitizer report as a memory-safety defect. A panic, timeout or memory exhaustion is a refused input, not a vulnerability. Run the targets after changing a decoder, a vendored codec patch or a reader of outside files.
- Both themes. Check changed UI in light and dark themes, panels and dialogs at narrow and wide widths, and brush changes in both live drawing and replay.
- Each input device. Test mouse, touch and pen separately. Input changes also need a real stylus on the affected host: pressure, tilt, hover, cancellation and fast curves, plus touch navigation and resuming from the background.
- Drags. Reorder gestures follow the drag convention and its validation matrix. Assert that movement before a hold does not reorder where a hold is required.
- Popups on GTK. Run popup and menu checks without
--tablet: the tablet proxy's synthetic serials cannot take compositor popup grabs. - Composed pixels. GTK's bridge journeys capture the GPU background with the native controls; rendering a GTK widget alone omits the GPU underlay. For scaled-display edge checks, render in physical pixels and round the cropped viewport outward to that grid, since a fractional crop origin adds edge coverage absent from the displayed frame. Compare suspected flashes or seams with a real compositor recording.
- Parity. Web is compared with GTK, and each native port with Web, at the
same document, workspace, theme, viewport and scale. For GTK and Web, run
cargo test --locked --release -p layer-linux native_web_parity_reference -- --ignored --test-threads=1, thennode apps/layer-web/test.mjs --parityin a headed browser. The visual tools capture the other hosts; never rescale or crop a capture to hide a difference.
| Area | Checks |
|---|---|
| GTK chrome ordering | native_chrome_during_filter_preparation, native_diagnostics_and_gpu_failure_recovery, native_document_tab_input and native_canvas_background_during_startup_and_tab_switch; cold startup: native_startup_latency with __GL_SHADER_DISK_CACHE=0. |
| Waiting canvas and tab transitions | Renderer waiting_drawing_shows_surround_until_full_composition_and_keeps_transparency_after_edits, persistent_presenter_holds_the_previous_artwork_then_fades_below_chrome and navigator_transition_holds_fades_and_clips_in_surface_and_standalone; GTK native_document_tabs_canvas_transition and Web --drawing-tabs check independent artwork and Navigator holds and fades in both themes. |
| GTK drawer snapshot | drawer_glass_uses_the_allocated_frame_until_the_next_allocation, native_column_drawer_snapshot_purity and matched native_column_drawer_snapshot_motion; native checks cover light/dark and Off/Medium. |
| Drags and reorder | GTK workspace-motion.sh gtk --drag-pickup and --column-drops; Web --drag-pickup, --layer-hold, --long-press-drag and --drag-cursors; Android AndroidInteractionTest; Windows exercise-layer-pickup.ps1 and exercise-workspace-pickup.ps1. |
| Cursor ownership | GTK native_palette_reorder_input and native_palette_reorder_pen; Web --edge-reach; Android AndroidInteractionTest#nativeCursorDoesNotRetainDividerAfterQuickTabReorder, #nativeMouseCursorDoesNotRetainDividerOnNeutralChrome and #tileDropLosingWindowFocusRetiresDragState. |
| Workspace background and header menus | Android AndroidInteractionTest#emptyWorkspaceBackgroundsOpenMenusWithoutDragging, #workspaceBackgroundMenusPreserveControlsAndColumnDoubleTap, #contextMenusFollowNativeContactsAcrossTheWindow, #contextRequestsKeepTheirSourceAndRetireLateReplies, #headerMenusUseContactPointsAndRetireTheirOwner and #secondContactCancelsWorkspaceAndHeaderMenus; Apple workspace-native-input.swift; Windows toolbars:dark, toolbars:light, header:options and header:options-light. Check popup bounds against off-center contacts in both orientations. |
| Blender controls | Shared blender_profiles_ and blender_hidden_pickup_; GTK native_blender_control_profiles; Web --blender-controls. |
| Tool bubbles | Shared serialized_bubble_hit_geometry_preserves_native_contact_regions and restoring_workspace_cancels_bubble_contacts_before_reusing_their_ids; host outside_bubble_contact_publishes_retained_model_without_painting; GTK native_tool_bubbles; Web --tool-bubbles; Android AndroidToolBubblesTest#nativeBubblesAcrossThemesAndDevices; Windows tool-bubbles and tool-bubbles:RapidOnly. Include painting through gaps and waiting for the fade return before editing an arc. |
| Layer thumbnails | GTK native_layer_thumbnail_squircles at scales 1 and 2; Web --layer-hold; Android AndroidTitleBarTest#layerRelationships; Windows layers:Relationships. |
| Icons | node apps/layer-web/test.mjs --icons; workspace-motion.sh gtk --icons at scale 1 and with LAYER_MOTION_SCALE=2; Android AndroidIconTest; python3 apps/layer-apple/tests/test_icon_assets.py. |
| Live paint pairs | GTK native_color_pair_updates; Web --color-panel; Android AndroidColorPanelTest#retainedPaintIconsAndCompactControlFollowCommittedContext and #retainedPaintIconsUseMappedRenditionAndIgnorePickerHover; Windows compact-color:pair-dark and compact-color:pair-light, which cover opaque paints only. Static icon captures do not exercise these updates. |
| Brush slider previews | Shared slider_stamp; renderer brush_stamp; GTK native_toolbar_strength_preview_input; Web --toolbar-components; Android materialHardnessAndCanonicalStampsFollowNativeControls; Windows toolbar_stamp_returns_alpha_bytes_and_rejects_stale_context. |
| Pen response calibration | Pressure and tilt calibration, held-contact admission, engine and localization catalog tests; GTK native_pressure_calibration and native_tilt_calibration with --tablet; the tonal journeys when changing CurveEditor. The tilt guide covers device profiles and rotation. |
Performance targets defines the tiers and targets,
and measuring the rules and commands. Keep CPU
submission, GPU completion and presentation latency separate: a short submission
time does not establish a frame rate. Offscreen GPU numbers from
cargo run --locked --release -p layer-bench -- --scenario <name>
(benchmark workloads) compare revisions on one
machine but never replace a measurement on the tier's device.
Regenerate bundled brush previews with
cargo run --locked --release -p layer-bench -- --brush-previews [dir] and
bundled filter previews with
cargo test --locked -p layer-render-wgpu --features bake write_bundled_filter_previews -- --ignored.
Both write lossy WebP through layer_render_wgpu::bundled_preview_webp; GTK
embeds them and the other hosts package or serve the same files.
every_built_in_filter_has_a_bundled_preview checks catalog coverage. Regenerate
the affected swatches when a preset's rendered behavior changes.
cargo run --locked --release -p layer-bench -- --blend-study <dir> paints every
blender over fixed colour scenes for visual review.
These fail on main independently of your change. Don't chase them unless they
are your task, keep their assertions, deadlines and bounds, and remove an entry
when you fix it. A commit names an unmodified build that reproduces the failure.
- Metal, M2 Pro Mac mini (
17a4da321):dehaze_constant_area_means_keep_exact_airlight_coordinate_tiesreads0.24999997against0.25. - Metal, M2 Pro Mac mini (
17a4da321):painterly_blends_high_contrast_hdr_without_a_variance_ceilingreports an HDR scale mismatch at pixel8272. - Intel Iris Xe D3D12 (
8f7a9c77):saved_artwork_render_contractsdrifts beyond 0.0002 ondomain_warp/F32. - Intel Iris Xe D3D12 (
8f7a9c77):native_publication_pipelines_follow_canvas_and_gate_brushandidle_filter_preview_requests_refresh_completed_startup_workexceed their 30-second catalogue deadlines. - Intel Iris Xe D3D12 (
8f7a9c77):layer-hosta_contact_begun_as_a_transform_opens_is_replayed_whole_once_it_is_prepared,a_stroke_once_painting_is_reported_ready_paints_before_catalog_admission,canvas_bar_queries_answer_for_the_current_bar,thumbnail_work_left_for_canvas_frames_wakes_the_hostandwarp_opens_over_a_large_filled_selectionexceed the 60-second startup wait. - GTK
native_panel_value_scrub_input(fa32b31db): the touch pass stops receiving value-drag updates after 8 px. - GTK
native_selection_pen_input,native_toolbar_components_narrow_input,native_workspace_motion_inputandnative_workspace_switcher_input: intermittent. - GTK
native_workspace_resize_input: presents below its rate threshold under the runner'scolor-mgmt. - Android
AndroidTitleBarTest: 7 of 15 cases. - Android
detachedPanelsKeepBodiesAndWiderResizeTargets. - Android
AndroidInteractionTest#menuBodyAndExtendedTabDropsAcrossDevicesand#drawerTabsKeepActiveColorsAndPadding. - Android
AndroidHostTest#cameraNavigationPublishesOnlyReadoutUpdates: the last assertion. - Android
AndroidHostTestshortcutPageRecordsMultipleBindingsAndPersists,shortcutSearchFindsModifiedKeysAndMarksChangedBindings,settingsPanesShareTopEdgeAndUseAppScale,workspaceMenusManageVisibilityNamesAndHistory,toolbarManagerSelectsConfirmsDeletesAndRestores,filterLayerIconsUsePackagedNamesandtoolbarConfigurationAndGroupCollapseUseTheSharedDefault. - Android
AndroidInteractionTest#healingAcrossDevicesand Web--heal(MovinkPad 11, MovinkPad Pro 14): look for a Heal tile, but the Photo toolbar holds Heal and Spot Healing in one Healing slot. - Android
AndroidInteractionTest#clipboardCopyPasteAcrossDevices: reads the pasted image's own affine, but the paste position is in its layer offset. - Android
AndroidInteractionTest#layerHandleLongPressDragCancelAndUndo: expects a finger or pen hold on a row body to reorder; touch and pen leave it to scrolling and the menu. - Android
AndroidInteractionTest#dodgeBurnAndFrequencySeparationAcrossDevices: expects a radius above 6 at 45 % of the slider, where the square mapping gives 4.2. - Android
AndroidInteractionTest#canvasEdgeDoubleTapUsesRecursiveDefaultWidths: expects fixed column widths where a double tap restores the automatic width. - Android
AndroidInteractionTest#navigationPreferencesControlWheel: taps the wheel choice while Preferences slides in. - Android
AndroidHostTest#touchNavigationHistoryCancellationAndSurfaceRecovery(TCL TAB 11 Gen 2): cannot find the portrait Settings labelPen & Input. - Android
AndroidRasterTest#hdrBlackIntensityMarkerVisible: intermittently keeps the last EV value when the drag is cancelled. - Android
AndroidWorkspaceManagerTest#restoreStartingLayoutPlacesPalettesAfterColorAndProofAfterNavigator(MovinkPad 11): cannot find its Window menu. - Android
AndroidRasterTest#profileLibraryKeepsExactCopiesAndPresetOwnership: intermittently times out waiting for profile-library buttons. - Android
AndroidPaletteTest#palettesPersistAcrossRelaunchandAndroidWorkspaceSwitcherTest#nativeOptionsVisibilityInputsAndRestart(MovinkPad Pro 14). - Android
AndroidWorkspaceOwnershipTest: expectsfocus_windowto be a workspace ID, but the view also names the owning window. - Android
AndroidHostTest#curvesPagesNativeContactsAndExactCoordinates(8a819ffa1; MovinkPad 11, Huion Kamvas Pad 12): a save after the light-theme calibrations finds nodocumentrequest. - Windows
exercise-layers.ps1(Iris Xe,c5624d37): "Outer editing edge did not use the accent color"; the PrintWindow probe reads#A94EC1for#A94DC1, and-Relationshipsreads#AA50C2in light theme. - Windows matched Web editor captures (
c5624d37): accent, caption controls, number rows and workspace controls differ; the Web collector looks for the blend button as aselectand measures Tool Set children beyond their panel clip. - Windows
exercise-multiwindow.ps1: "Pin preferences did not refresh in the inactive window". - Windows
exercise-pen-buttons.ps1: Transform is enabled on the empty starting layer. - Windows
exercise-proof.ps1: UI Automation times out choosing sRGB in Proof Setup after save and reopen. - iPad XCTest
testCompactMenuShortcutAcrossPagesandtestSettingsTextSelectionShortcut: XCTest keys don't reach UIKit key commands. - Tablet Chrome
--workspace-manager(MovinkPad 11): cannot find its new-workspace name input.