lithop 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13a626692e6ae5bd67e88bb4f81e0cf8ae8ad6fb220e5cdb4822a582eaec6dd7
-  data.tar.gz: 1497a224597acc9416aa67961969aeeb868981581af93cff6fb7e0bada32d781
+  metadata.gz: 6d976da7f11815d7bb666e57fc4fa9f3154b535f1482814974804c642c988d11
+  data.tar.gz: cbb54acb9074271d1813398f98b6e2353eb8fa545ccb8f4ac256c73fdebde0b5
 SHA512:
-  metadata.gz: 879e0cc070dfd33464e12504d5409b2b98df8ff1f576e716c818968875cab637a9f315ddf41bd021c391e3c88e222ebc3eddb29dcbbecf002531b9b80068a743
-  data.tar.gz: 3ce5b71121d43b5c58ffb9bee086cf59e36ab1550554a007742ffc76852a2350b2e3dc49ec14596f4bc4caa4022efb1a53b752103eddfb18084d60a1ca454b31
+  metadata.gz: 24c42f6590c20ff0dd02c301569b4935559f160be4f79361f252e10fb027beedd7692a4ed2f1689753bbe23321c1b646a59e4e2d6f4e6c29f9e5b8da1e8ca3f3
+  data.tar.gz: 2c0e65025d88cb73e3266ed1b2d7325aa0c0ebdc845ac819e31ae40d38b24bab79a5e7557a3c1ab78470690638f04bcbb058cf7a9fc1fbc09b221fc2773799c6

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.3.0 - 2026-10-20
+
+- Adds a loopback-only Sinatra/ERB/Puma UI with responsive Create, Jobs, and Presets panes, faster immediate JPEG/PNG/SVG input previews, reusable settings, drafts, and engine-rendered result views.
+- Adds persistent job progress and cancellation, indexed searchable history, result comparison, ZIP downloads, safe bulk deletion, direct opening of completed 3MF artifacts in Bambu Studio on macOS, and bounded preview caching with browser timing diagnostics.
+- Adds a Rust extension for CMY recipe selection, CMY mesh generation, 3MF vertex indexing, and XML output; the standard chart benchmark median improves from 36.800 seconds to 13.946 seconds while retaining the Ruby comparison path.
+- Packages the UI and Rust sources in the source gem, adds `lithop doctor`, and verifies macOS/Ruby 4.0 builds, installed-gem native loading, Chromium/WebKit workflows, and Bambu Studio loading of unsplit and split 3MF outputs.
+
+## 0.2.0 - 2026-10-16
+
+- Adds exact-count CMYW 3MF tiling, plus optional four-plate output for three Base White-backed CMYW color regions and Top White.
+- Aligns the CLI help and source-checkout settings with the 140 × 104 mm standard profile.
+- Adds reproducible sRGB brightness, contrast, and saturation adjustments to JSON settings and the CLI.
+- Records conversion progress and final status, supports cancellation and stale temporary-data recovery, and limits each project to one active conversion.
+
 ## 0.1.0 - 2026-10-12
 
 - Converts JPEG, PNG, and validated self-contained SVG files up to 15 MB into a White reference STL and a single-plate multipart CMYW 3MF.

data/Cargo.lock

@@ -0,0 +1,284 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "aho-corasick"
+version = "1.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c982642fa9e8606056828ee9a8505737230110bb1099153c79efe865c59d12ba"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "bindgen"
+version = "0.72.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "993776b509cfb49c750f11b8f07a46fa23e0a1386ffc01fb1e7d343efc387895"
+dependencies = [
+ "bitflags",
+ "cexpr",
+ "clang-sys",
+ "itertools",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "rustc-hash",
+ "shlex",
+ "syn",
+]
+
+[[package]]
+name = "bitflags"
+version = "2.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ded4057c258ba199e2d26386d3af3780957ecaee6c4ef4041c6b4b8b97c0b06"
+
+[[package]]
+name = "cexpr"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fac387a98bb7c37292057cffc56d62ecb629900026402633ae9160df93a8766"
+dependencies = [
+ "nom",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e7648175b45a9a48536d676f68d918270699102aa8dab5496df06904c914600"
+
+[[package]]
+name = "clang-sys"
+version = "1.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "157a8ba7b480713b56f4c09fd13fc3e0a22a5dfab8097ba61cbc5feef950788a"
+dependencies = [
+ "glob",
+ "libc",
+ "libloading",
+]
+
+[[package]]
+name = "either"
+version = "1.19.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0e9c71c2167ca323c882b99918929403426e2373ea17242ff5653e0d5e1058be"
+
+[[package]]
+name = "glob"
+version = "0.3.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e4eba85ea1d0a966a983acd07deee566e67395d2d96b6fb39e62b5a833f1eb0b"
+
+[[package]]
+name = "itertools"
+version = "0.13.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "lazy_static"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "20870f649af7073d53e38067b2a84312175d56ea15217e1b15bc83506ec50afb"
+
+[[package]]
+name = "libc"
+version = "0.2.191"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "65cd87c9a6d60536580b316ad985726104730a5151c99845f2490428ef91240a"
+
+[[package]]
+name = "libloading"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d7c4b02199fee7c5d21a5ae7d8cfa79a6ef5bb2fc834d6e9058e89c825efdc55"
+dependencies = [
+ "cfg-if",
+ "windows-link",
+]
+
+[[package]]
+name = "lithop_native"
+version = "0.3.0"
+dependencies = [
+ "libc",
+ "magnus",
+ "rb-sys",
+ "rb-sys-env",
+]
+
+[[package]]
+name = "magnus"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e76237a607e1dea288dd0ef0c6c8f49037df2152d14bb52b3542c46522d9e6fc"
+dependencies = [
+ "magnus-macros",
+ "rb-sys",
+ "rb-sys-env",
+ "seq-macro",
+]
+
+[[package]]
+name = "magnus-macros"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47607461fd8e1513cb4f2076c197d8092d921a1ea75bd08af97398f593751892"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
+
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.107"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.47"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rb-sys"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02faf625bb10ba893e3ae620f19c9fb1b5f8fcae0fe4eb86bb3f2230fad75edb"
+dependencies = [
+ "rb-sys-build",
+]
+
+[[package]]
+name = "rb-sys-build"
+version = "0.9.130"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "05be6f9c86fe5482808162826f6c047d093b3670582296c770de1d94f8066694"
+dependencies = [
+ "bindgen",
+ "lazy_static",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "shell-words",
+ "syn",
+]
+
+[[package]]
+name = "rb-sys-env"
+version = "0.2.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cca7ad6a7e21e72151d56fe2495a259b5670e204c3adac41ee7ef676ea08117a"
+
+[[package]]
+name = "regex"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f020237b6c8eed93db2e2cb53c00c60a8e1bc73da7d073199a1180401450218d"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-automata",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-automata"
+version = "0.4.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ad8553b9b26413251cbf30e620595c7a41b3887f03da04579c0e6b0d6a06b4b2"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax",
+]
+
+[[package]]
+name = "regex-syntax"
+version = "0.8.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d6f6ff9a378485b298a5286656da665ba74413d36db0979633275d2e708145d4"
+
+[[package]]
+name = "rustc-hash"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6b1e7f9a428571be2dc5bc0505c13fb6bf936822b894ec87abf8a08a4e51742d"
+
+[[package]]
+name = "seq-macro"
+version = "0.3.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bc711410fbe7399f390ca1c3b60ad0f53f80e95c5eb935e52268a0e2cd49acc"
+
+[[package]]
+name = "shell-words"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dc6fe69c597f9c37bfeeeeeb33da3530379845f10be461a66d16d03eca2ded77"
+
+[[package]]
+name = "shlex"
+version = "1.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fda2ff0d084019ba4d7c6f371c95d8fd75ce3524c3cb8fb653a3023f6323e64"
+
+[[package]]
+name = "syn"
+version = "2.0.119"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.27"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2c754d6c33795a1c324727428e5a7dedb5b06195f9890bdbcba760d3e246563"
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"

data/Cargo.toml

@@ -0,0 +1,6 @@
+[workspace]
+members = ["ext/lithop_native"]
+resolver = "2"
+
+[profile.release]
+debug = true

data/README.md

@@ -2,7 +2,11 @@
 
 Create backlit color lithophanes locally.
 
-Lithop is a command-line CMYW color lithophane generator. It turns a JPEG, PNG, or validated self-contained SVG image into a single-plate multipart CMYW 3MF and a White reference STL without uploading, modifying, or copying the source image into the output job.
+Lithop is a local CMYW color lithophane generator with a CLI and browser UI. It turns a JPEG, PNG, or validated self-contained SVG image into a single-plate multipart CMYW 3MF and a White reference STL without uploading the source image or copying it into the output job.
+
+![CMYW lithophane color-chart preview generated by Lithop](docs/images/cmyw-lithophane-preview.png)
+
+*CMYW lithophane preview generated from the bundled color chart. This is the pre-print preview, not a photograph of a physical print.*
 
 ## Status and safety
 
@@ -24,21 +28,24 @@ Before printing, inspect every layer and confirm the Cyan, Magenta, Yellow, and
 
 ## Requirements
 
-- macOS and Ruby 4.0 or later
+- macOS, Ruby 4.0 or later, and Rust. CI verifies macOS with Ruby 4.0; the current measured build is Apple silicon.
 - libvips with JPEG, PNG, SVG (librsvg), and ICC profile support
 - For physical printing: Bambu Studio, an AMS-capable printer, and the required PLA Basic Cyan, Magenta, Yellow, and White filaments
 
 ## Install
 
-To install the 0.1.0 release from RubyGems, install libvips and the matching Lithop version:
+To install Lithop 0.3.0 from RubyGems, install libvips, Rust for the native palette extension, and the matching Lithop version:
 
 ```sh
-brew install vips
-gem install lithop -v 0.1.0
+brew install vips rust
+gem install lithop -v 0.3.0
 lithop --version
+lithop doctor
 ```
 
-The version command must print `0.1.0`.
+The version command must print `0.3.0`.
+The doctor command reports `"backend": "rust"` and the loaded native-extension version. Set
+`LITHOP_DISABLE_NATIVE=1` only when comparing the Ruby fallback.
 
 To work from a source checkout instead:
 
@@ -61,6 +68,14 @@ From a source checkout, use the bundled sample and a coarse cell size for a fast
 bundle exec lithop examples/cmy-fine-line.svg --width 20 --height 15 --pixel-size 0.5
 ```
 
+To use the local browser UI, start its loopback-only server and open the displayed URL:
+
+```sh
+lithop ui
+```
+
+The UI separates creation, jobs, and reusable presets into responsive panes, with drag-and-drop image selection, grouped settings, an engine-rendered input preview, persistent job progress and cancellation, side-by-side result views, and per-job artifact management. Sinatra, ERB, Puma, CSS, and JavaScript are included in the gem, so the workflow remains local and works offline after installation. Playwright is used only for source-checkout browser tests. See [local browser UI](docs/local-ui.md).
+
 The standard command generates the 140 × 104 × 2.14689422 mm, 0.2 mm-nozzle layout:
 
 ```sh
@@ -69,6 +84,12 @@ bundle exec lithop path/to/image.jpeg
 
 It writes `lithop.3mf` with a single `lithophane` plate and White/Cyan/Magenta/Yellow extruders. Its layer preview and physical print still require manual verification.
 
+Use `--brightness`, `--contrast`, and `--saturation` with percentages from `-100` to `100` to adjust the shared sRGB input before White thickness and CMYW recipes are sampled. The resolved values are recorded in each job's `settings.json`.
+
+Use `--tile-count N` with `--tile-layout auto`, `columns`, `rows`, or `grid` to emit exactly N local-origin 3MF tiles. Tiled jobs include assembled offsets and bounds in `manifest.json` plus a physical-size `tile-layout.svg` placement guide.
+
+Add `--separate-z-parts` to place three closed CMYW color-region bands and Top White on four Bambu Studio plates inside every generated 3MF. Each color-region plate includes its own Base White carrier, and every plate is translated to start at Z=0 for independent printing; `manifest.json` retains the original assembly order and Z bounds.
+
 The command reports estimated and final triangle counts and creates a new `build/<job_id>/` directory. Completed jobs are never overwritten. Inspect `preview.png`, `transmission.png`, `thickness.png`, and the four material masks, then import `lithop.3mf` into Bambu Studio as a model. The 3MF contains geometry, fixed extruder numbers, and layer-height metadata. It does not select a printer, physical build plate, AMS slot, or complete slicing preset.
 
 The bundled color chart at standard settings produces 2,660,706 CMYW 3MF triangles, below the default 5,000,000-triangle limit. Runtime and memory depend on the image and machine; use a smaller model and a coarser cell size for initial checks.
@@ -94,13 +115,16 @@ The command-line options can override individual profile values. Use `--color-pi
 ## Other commands
 
 - `lithop calibrate` creates a 140 × 104 mm calibration SVG and matching printable 3MF with all 120 seven-layer recipes, eight White thickness stages, and a measurement-profile template. A completed measured profile can select both color recipes and the physical White height used by the 3MF, STL, previews, thickness map, and material masks. See [color calibration](docs/calibration.md).
+- `lithop ui` starts the local browser UI on `127.0.0.1:4567`; on macOS, completed 3MF artifacts can be handed directly to Bambu Studio from the Jobs view. See [local browser UI](docs/local-ui.md).
+- `lithop doctor` reports whether the Rust acceleration extension is loaded, enabled, and version-matched.
 - `lithop clean` permanently removes the selected project's complete `build/` directory, not one job. See the [command reference](docs/command.md#生成物を削除する) before using it.
-- `lithop --help`, `lithop calibrate --help`, and `lithop clean --help` show the current command syntax.
+- `lithop --help`, `lithop calibrate --help`, `lithop ui --help`, and `lithop clean --help` show the current command syntax.
 
 ## Documentation
 
 - [Documentation index and verification status](docs/README.md)
 - [Installation and basic use](docs/getting-started.md)
+- [Local browser UI](docs/local-ui.md)
 - [Bambu Studio verification and printing](docs/bambu-studio.md)
 - [Options and settings](docs/config.md)
 - [Artifacts and generation records](docs/artifacts.md)

data/RELEASING.md

@@ -2,20 +2,38 @@
 
 This checklist prepares and publishes one immutable gem version. Run every command from the repository root.
 
+Confirm that Ruby 4.0, Rust, Cargo, and libvips are available before installing dependencies:
+
+```sh
+ruby --version
+rustc --version
+cargo --version
+bundle exec ruby -rvips -e 'puts Vips.version_string'
+```
+
 ## 1. Prepare the version
 
 1. Update `Lithop::VERSION` in `lib/lithop/version.rb`.
 2. Add or update the matching version and release date in `CHANGELOG.md`. Keep the changelog concise; add an `Unreleased` section only when subsequent changes need one.
 3. Confirm the README installation and usage examples match the release.
 4. Manually open the external links in `README.md` and `docs/`; automated tests intentionally validate only local links and anchors.
-5. Commit all intended files and verify that `git status --short` is empty.
-6. Run the non-publishing release check:
+5. Confirm that `LICENSE` and `lithop.gemspec` identify Lithop as MIT. Review newly bundled code, images, fonts, and binaries for third-party terms. The current source gem does not bundle its Ruby dependencies, Playwright, libvips, or Rust crate sources, so it does not need a separate `THIRD_PARTY_NOTICES` file. Re-run this review before vendoring dependencies or publishing a precompiled native gem, and include the required license and notice texts when applicable.
+6. Commit all intended files and verify that `git status --short` is empty.
+7. When the local UI changed, run the Chromium and WebKit browser suite with the development-only Node.js 22 toolchain:
+
+```sh
+npm install
+npx playwright install chromium webkit
+npm run test:browser
+```
+
+8. Run the non-publishing release check:
 
 ```sh
 bundle exec rake release:check
 ```
 
-The check runs the specs, RuboCop, and RBS validation; builds the gem; checks its version, metadata, runtime dependency, and packaged documentation; installs it into a temporary isolated gem directory; and executes the installed `lithop --version` command.
+The check compiles the Rust extension, runs the Rust and Ruby specs, RuboCop, and RBS validation; builds the gem; checks its version, metadata, runtime dependency, and packaged documentation; installs it into a temporary isolated gem directory; and executes the installed `lithop --version` command.
 
 ## 2. Prepare publishing services
 
@@ -49,15 +67,15 @@ Alternatively, configure a RubyGems.org trusted publisher for this repository an
 bundle exec rake release
 ```
 
-After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. Replace `0.1.0` for later versions:
+After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. Replace `0.3.0` for later versions:
 
 ```sh
-gh release create v0.1.0 lithop-0.1.0.gem --verify-tag --generate-notes
+gh release create v0.3.0 --verify-tag --generate-notes
 ```
 
 Finally, install the published version in a clean environment and verify the CLI:
 
 ```sh
-gem install lithop -v 0.1.0
+gem install lithop -v 0.3.0
 lithop --version
 ```

data/docs/README.md

@@ -1,6 +1,6 @@
 # Lithopドキュメント
 
-Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトファン）3MFと、White参照STLを生成するローカルCLIです。画像を外部へ送信せず、入力画像自体を生成ジョブへコピーしません。
+Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトファン）3MFと、White参照STLを生成するローカルCLI／ブラウザUIです。画像を外部へ送信せず、入力画像自体を生成ジョブへコピーしません。
 
 ## 安全と現在の検証範囲
 
@@ -14,6 +14,7 @@ Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトフ
 ## 初めて使う
 
 - [導入と基本操作](getting-started.md) — インストール、小型モデルの生成、最初に見る成果物
+- [ローカルブラウザUI](local-ui.md) — 画像選択、設定、プレビュー、進捗・中止、成果物表示
 
 ## 印刷・校正する
 
@@ -23,6 +24,7 @@ Lithopは、JPEG、PNG、SVGからCMYW材料のカラーLithophane（リトフ
 ## 仕様を調べる
 
 - [生成物と記録](artifacts.md) — ジョブ、全成果物、プレビュー、`settings.json`、`manifest.json`
+- [3MFタイル分割とZ分割](tiling.md) — 指定枚数のXY分割、組み立て座標、4プレートのZ分割
 - [生成オプションと設定ファイル](config.md) — 設定の優先順位、入力JSON、既定値、検証規則
 - [コマンドリファレンス](command.md) — 構文、全オプション、終了ステータス
 - [CMYWの色モデルと積層構造](color-model.md) — 材料、減法混色、White厚み、3MF構造
@@ -36,6 +38,7 @@ CLIの現在の構文は、次のコマンドでも確認できます。
 ```sh
 lithop --help
 lithop calibrate --help
+lithop ui --help
 lithop clean --help
 ```
 

data/docs/artifacts.md

@@ -6,7 +6,15 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
 
 通常生成は`build/<job_id>/`、校正片生成は`build/<job_id>-calibration/`へ保存します。ジョブIDはUTC時刻とランダム値から作られます。
 
-生成中は`build/.tmp-<job_id>/`を排他的に取得します。失敗または中断した実行は自分が作成した一時領域だけを回収し、入力画像、別の実行の一時領域、完了済みジョブを削除しません。完了済みジョブと同じIDは上書きしません。
+生成中は`build/.tmp-<job_id>/`へ書き込みます。通常生成と校正生成はプロジェクトごとの`build/.lithop.lock`を共有し、同時変換数を1に制限します。変換中に別の変換を開始した場合は待機せず、`another conversion is already running`で失敗します。完了済みジョブと同じIDは上書きしません。
+
+状態は`build/.jobs/<job_id>.json`へ原子的に保存します。`state`は`queued`、`running`、中止要求を受けた`cancelling`、終了状態の`completed`／`failed`／`cancelled`です。`phase`、0〜100の`percent`、メッセージ、開始・更新・終了日時を持ち、完了時だけ`output_path`と`files`を記録します。CLIにも主要工程の進捗を表示します。
+
+`Ctrl-C`などの割り込みと`JobExecution.request_cancel`による中止要求は`cancelled`として記録し、未完成ジョブを公開しません。成果物の原子的な公開が確定した後に中止要求が届いた場合は、出力との整合を保つため`completed`として記録します。失敗はエラーのクラスとメッセージを`failed`状態へ記録します。どちらも実行自身が作成した一時領域を回収し、入力画像、別の実行の所有情報がない一時領域、使用中の一時領域、完了済みジョブを削除しません。プロセスが強制終了して回収できなかった所有情報付き一時領域は、所有PIDの終了を確認したうえで次の変換開始時に削除し、残っていた実行状態を`failed`の`recovered`工程へ変更します。
+
+ローカルUIでは終了状態のジョブを個別または複数選択で削除できます。対象は`build/<job_id>/`、`build/.jobs/<job_id>.json`、同名のログと中止要求、終了済みの`build/.web/<job_id>/`だけです。実行中のジョブ、シンボリックリンク、状態に記録された出力先がジョブIDと一致しないものは削除を拒否します。
+
+ローカルUIの「全3MFをZIP」と「全成果物をZIP」は、状態JSONの`files`に成果物として記録されたファイルだけを元の相対パスで格納します。対象一覧と容量の確認まではZIPを生成しません。生成した`build/.downloads/*.zip`は応答終了時に削除し、異常終了で残った場合は次のUI起動時に回収します。
 
 ## 通常ジョブのファイル
 
@@ -14,6 +22,7 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
 | --- | --- |
 | `lithop.3mf` | 使用するCyan、Magenta、Yellow、Whiteの材料別メッシュを持つカラー用モデル |
 | `cmyk_white.stl` | 厚さマップから作るWhite単色の参照リトファン |
+| `corrected-input.png` | 配置、クロップ、色調整、White余白を適用し、変換時の格子でサンプリングしたRGB入力 |
 | `preview.png` | 公称レシピ色に相対的な厚さの明暗を重ねた確認用画像 |
 | `transmission.png` | White厚さによる相対透過明度 |
 | `thickness.png` | セル単位の厚さマップ |
@@ -28,6 +37,10 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
 
 標準ジョブは単一プレートと非一様レイヤー情報を持つ`lithop.3mf`を出力します。未使用のCyan、Magenta、Yellowは3MFのメッシュから省略されるため、材料部品は1〜4個です。Whiteは必ず含まれます。`cmyk_white.stl`は比較用で、CMYWの材料分離情報を持ちません。
 
+XYタイルとZ分割のファイル構成、座標、`tile-layout.svg`、マニフェスト記録、4プレート構成は[3MFタイル分割とZ分割](tiling.md)を参照してください。
+
+XY分割時は各`tiles/tile_rNN_cNN.3mf`に対応する`tiles/tile_rNN_cNN-preview.png`を追加します。画像の1画素はそのタイルの1セルで、分割3MFと同じ範囲を表します。`manifest.json`の各`tiles`要素は`file`と`preview_file`で対応を記録します。
+
 ## プレビューの座標と値
 
 全プレビューの1画素は3MFの1セルに対応し、左上がモデルの`+Y`側です。材料マスクは黒が0層で、明るいほど層数が多く、4材料で同じ明度尺度を使います。
@@ -55,12 +68,21 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
   "crop_position_x": 0.5,
   "crop_position_y": 0.5,
   "crop_scale": 1.0,
+  "brightness": 0.0,
+  "contrast": 0.0,
+  "saturation": 0.0,
   "minimum_thickness": 1.0,
   "maximum_thickness": 2.14689422,
   "pixel_size": 0.22,
   "color_pixel_size": null,
   "grid_columns": null,
   "grid_rows": null,
+  "tile_count": 1,
+  "tile_layout": "auto",
+  "tile_rows": null,
+  "tile_columns": null,
+  "separate_z_parts": false,
+  "color_region_parts": 3,
   "first_layer_height": 0.1,
   "layer_height": 0.1,
   "base_white_layers": 2,
@@ -78,12 +100,14 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
   "effective_color_pixel_size": 0.22,
   "effective_minimum_thickness": 1.0,
   "effective_maximum_thickness": 2.14689422,
+  "resolved_tile_rows": 1,
+  "resolved_tile_columns": 1,
   "columns": 637,
   "rows": 473,
   "pixel_size_x": 0.21978021978021978,
   "pixel_size_y": 0.21987315010570824,
   "schema_version": 1,
-  "generator_version": "0.1.0",
+  "generator_version": "0.3.0",
   "input_path": "/absolute/path/to/image.png",
   "input_settings_path": "/absolute/path/to/config/settings.json",
   "calibration_profile_id": null,

data/docs/bambu-studio.md

@@ -1,6 +1,6 @@
 # Bambu Studioでの確認と印刷
 
-標準の`lithop.3mf`は、単一`lithophane`プレート、CMYW割り当て、上部Whiteのレイヤー範囲を持ちます。単一プレートとWhite/Cyan/Magenta/Yellow割り当ての復元はBambu Studioで確認済みです。G-code、温度、速度、AMS実スロット、機種固有の開始・終了コードを含まないため、その他の印刷条件はBambu Studio側で確認します。
+標準の`lithop.3mf`は、単一`lithophane`プレート、CMYW割り当て、上部Whiteのレイヤー範囲を持ちます。単一プレートとWhite/Cyan/Magenta/Yellow割り当ての復元に加え、分割なし・分割ありの3MFが正常に開くことをBambu Studioで確認済みです。G-code、温度、速度、AMS実スロット、機種固有の開始・終了コードを含まないため、その他の印刷条件はBambu Studio側で確認します。
 
 標準構造は0.2 mmノズル、White下地2層、7層の`Cyan -> Magenta -> Yellow -> White`、連続高のWhite上面を使います。以下の確認をすべて終えるまで印刷を開始しないでください。
 
@@ -24,8 +24,14 @@ bundle exec lithop examples/cmy-fine-line.svg --width 20 --height 15 --pixel-siz
 
 表示された`build/<job_id>/`で、`preview.png`、`PRINT_README.md`、`settings.json`、`manifest.json`を確認してから`lithop.3mf`を開きます。自分のジョブIDと印刷条件は`manifest.json`に記録されています。
 
+タイルまたはZ分割ジョブを開く場合は、[3MFタイル分割とZ分割](tiling.md)に従い、対象3MF、組み立て座標、4プレート、材料割り当てを確認します。
+
 ## 3MFを読み込む
 
+macOSで`lithop ui`を使用している場合は、完了ジョブの「成果物 → モデル」にある「Bambu Studioで開く」から対象3MFを渡せます。XY分割ジョブは、分割モデルカードまたは成果物一覧でタイルを1つずつ選びます。画面に成功と表示されても、OSへ起動要求を渡した段階です。Bambu Studioでファイル名、プレート数、材料、寸法を確認してから次へ進んでください。Bambu Studioで既存プロジェクトを開いていると別の3MFが表示されない場合があるため、その場合は現在の作業を確認してから3MFを保存して開きます。
+
+ボタンが表示されない環境や起動できない場合は、同じ行の「3MFを保存」を使い、Bambu Studioからファイルを開きます。未保存プロジェクトの確認ダイアログが表示された場合は、現在の編集内容を確認してから操作してください。
+
 1. `cmyk_white.stl`ではなく`lithop.3mf`をモデルとして読み込む。
 2. 一つの親オブジェクトの下に、使用材料の部品が同じ位置で組み立てられていることを確認する。
 3. 部品を個別に移動、整列、拡大縮小、結合しない。

data/docs/color-model.md

@@ -77,6 +77,8 @@ Z=0 / バックライト側
 | CMYW色領域 |          7 | 0.20–0.90 mm |
 | 上部White  |       可変 | 0.90–2.14689422 mm |
 
+`--separate-z-parts`で出力する4プレート、Base Whiteキャリア、元のZ境界、積層順は[3MFタイル分割とZ分割](tiling.md)を参照してください。
+
 標準の最小厚さは1.0 mm、最大厚さは2.14689422 mmです。
 
 ## 材料別メッシュの関係