lithop 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 724832daeb852eb0910033dd04b596f4d5f0f74535804e0577c20312b499ebe9
-  data.tar.gz: 0a75bcd7986e64d707736b67f49f6e5301819043cddccdd63fb09569541d6aa9
+  metadata.gz: 6d976da7f11815d7bb666e57fc4fa9f3154b535f1482814974804c642c988d11
+  data.tar.gz: cbb54acb9074271d1813398f98b6e2353eb8fa545ccb8f4ac256c73fdebde0b5
 SHA512:
-  metadata.gz: 719b4231386b719eacade124d17fb26c020d546ee526244bd285df6f78bf6c1905c4c1f62dd4b3d5853e57fb93f930b6c83e9c0bce47fee76d1fd49f4d320abc
-  data.tar.gz: 16d8f9c4ce8cd42fa152e0e4a1dc6d98b40cd8d615fdb871b0e54f9ac2a96c96184f57ae906d227dd994bc2f5b215259c70f89f113a112744214f5b7f27d427b
+  metadata.gz: 24c42f6590c20ff0dd02c301569b4935559f160be4f79361f252e10fb027beedd7692a4ed2f1689753bbe23321c1b646a59e4e2d6f4e6c29f9e5b8da1e8ca3f3
+  data.tar.gz: 2c0e65025d88cb73e3266ed1b2d7325aa0c0ebdc845ac819e31ae40d38b24bab79a5e7557a3c1ab78470690638f04bcbb058cf7a9fc1fbc09b221fc2773799c6

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # 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.

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.2.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.2.0
+brew install vips rust
+gem install lithop -v 0.3.0
 lithop --version
+lithop doctor
 ```
 
-The version command must print `0.2.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
@@ -100,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.2.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.2.0 --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.2.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) — 画像選択、設定、プレビュー、進捗・中止、成果物表示
 
 ## 印刷・校正する
 
@@ -37,6 +38,7 @@ CLIの現在の構文は、次のコマンドでも確認できます。
 ```sh
 lithop --help
 lithop calibrate --help
+lithop ui --help
 lithop clean --help
 ```
 

data/docs/artifacts.md

@@ -10,7 +10,11 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
 
 状態は`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`として記録し、未完成ジョブを公開しません。失敗はエラーのクラスとメッセージを`failed`状態へ記録します。どちらも実行自身が作成した一時領域を回収し、入力画像、別の実行の所有情報がない一時領域、使用中の一時領域、完了済みジョブを削除しません。プロセスが強制終了して回収できなかった所有情報付き一時領域は、所有PIDの終了を確認したうえで次の変換開始時に削除し、残っていた実行状態を`failed`の`recovered`工程へ変更します。
+`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起動時に回収します。
 
 ## 通常ジョブのファイル
 
@@ -18,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` | セル単位の厚さマップ |
@@ -34,6 +39,8 @@ Lithopは生成中のファイルを一時ディレクトリへ書き、すべ
 
 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材料で同じ明度尺度を使います。
@@ -100,7 +107,7 @@ XYタイルとZ分割のファイル構成、座標、`tile-layout.svg`、マニ
   "pixel_size_x": 0.21978021978021978,
   "pixel_size_y": 0.21987315010570824,
   "schema_version": 1,
-  "generator_version": "0.2.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上面を使います。以下の確認をすべて終えるまで印刷を開始しないでください。
 
@@ -28,6 +28,10 @@ bundle exec lithop examples/cmy-fine-line.svg --width 20 --height 15 --pixel-siz
 
 ## 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/command.md

@@ -1,6 +1,6 @@
 # コマンドリファレンス
 
-このページはCLI構文とオプションの正本です。実行中の版では`lithop --help`、`lithop calibrate --help`、`lithop clean --help`でも確認できます。ソースチェックアウトでは、例の`lithop`を`bundle exec lithop`に読み替えてください。
+このページはCLI構文とオプションの正本です。実行中の版では`lithop --help`、`lithop calibrate --help`、`lithop ui --help`、`lithop clean --help`でも確認できます。`lithop doctor`はRust拡張の状態をJSONで表示します。ソースチェックアウトでは、例の`lithop`を`bundle exec lithop`に読み替えてください。
 
 ## 画像からリトファンを生成する
 
@@ -158,6 +158,27 @@ lithop calibrate
 
 固定レイアウトで入力画像を使わないため、画像用の`width`、`height`、`margin_*`、画像配置、明るさ・コントラスト・彩度、`pixel_size`、`color_pixel_size`、`maximum_input_pixels`は使いません。生成物は[校正ジョブのファイル](artifacts.md#校正ジョブのファイル)、測定方法は[色校正](calibration.md)を参照してください。
 
+## ローカルUIを起動する
+
+画像選択、主要設定、プレビュー、進捗・中止、成果物表示を行うブラウザUIを`127.0.0.1`で起動します。
+
+```text
+Usage: lithop ui [--project-dir DIR] [--port PORT]
+```
+
+| オプション | 型 | 既定値 | 説明 |
+| --- | --- | ---: | --- |
+| `--project-dir DIR` | Path | 現在のディレクトリ | 設定を読み、`build/`を作るプロジェクトを選ぶ |
+| `--port PORT` | Integer | `4567` | ローカルUIのポートを1〜65535で指定する |
+| `-v`, `--version` | — | — | バージョンを表示して終了する |
+| `-h`, `--help` | — | — | ヘルプを表示して終了する |
+
+```sh
+lithop ui
+```
+
+表示された`http://127.0.0.1:4567`をブラウザで開きます。詳細は[ローカルブラウザUI](local-ui.md)を参照してください。
+
 ## 生成物を削除する
 
 ### 構文
@@ -181,13 +202,15 @@ lithop clean --project-dir /path/to/project
 
 `build/`がなければ正常終了します。ファイルシステムのルート、`build`自体がシンボリックリンク、または`build`がディレクトリではない場合は削除を拒否します。
 
-## バージョンとヘルプを表示する
+## バージョン、診断、ヘルプを表示する
 
 | コマンド | 内容 |
 | --- | --- |
 | `lithop --version` | バージョンを表示する。短縮形は`lithop -v` |
+| `lithop doctor` | Rustバックエンドのロード・有効状態、拡張とLithopのバージョン、Ruby、実行プラットフォームをJSONで表示する |
 | `lithop --help` | 通常生成の構文とオプションを表示する |
 | `lithop calibrate --help` | 校正片生成の構文とオプションを表示する |
+| `lithop ui --help` | ローカルUIの起動オプションを表示する |
 | `lithop clean --help` | 削除コマンドの構文とオプションを表示する |
 
 ## 終了ステータスとエラー

data/docs/config.md

@@ -225,4 +225,4 @@ effective: 1.0–2.14689422 mm
 
 ## 情報表示オプション
 
-`--help`と`--version`の対応は[バージョンとヘルプを表示する](command.md#バージョンとヘルプを表示する)を参照してください。
+`--help`、`--version`、`doctor`の対応は[バージョン、診断、ヘルプを表示する](command.md#バージョン診断ヘルプを表示する)を参照してください。

data/docs/getting-started.md

@@ -4,8 +4,9 @@ Lithopは、画像からカラーLithophane（リトファン）の3MFとWhite
 
 ## 準備
 
-- macOS
+- macOS（CIはmacOS／Ruby 4.0、現在の実測環境はApple silicon）
 - Ruby 4.0以上
+- CMYWレシピ選択用ネイティブ拡張をビルドするRust
 - JPEG、PNG、SVG（librsvg）、ICCプロファイルを扱えるlibvips
 - 印刷する場合はBambu Studio、AMS対応プリンタ、必要なCMYWフィラメント
 
@@ -13,15 +14,17 @@ Lithopは、画像からカラーLithophane（リトファン）の3MFとWhite
 
 ## インストール
 
-公開版0.2.0を使う場合は、libvipsとバージョンを指定したLithopをインストールします。
+0.3.0を使う場合は、libvips、Rust、バージョンを指定したLithopをインストールします。
 
 ```sh
-brew install vips
-gem install lithop -v 0.2.0
+brew install vips rust
+gem install lithop -v 0.3.0
 lithop --version
+lithop doctor
 ```
 
-`lithop --version`が`0.2.0`を表示することを確認します。
+`lithop --version`が`0.3.0`を表示することを確認します。
+`lithop doctor`では`backend`が`rust`、`extension_version`がLithopと同じバージョンであることを確認します。
 
 ソースチェックアウトから実行する場合は、代わりに次を実行します。