From 8cf3d41f90b8c55d33e8a401ca17a9fcd0192462 Mon Sep 17 00:00:00 2001 From: Dandaedre Date: Mon, 16 Nov 2026 12:28:17 +0100 Subject: [PATCH] Use Illustrator instead of AI in format names and documentation --- crates/canvas-pilot/src/interchange.rs | 4 +- docs/canvas-pilot/changelog.md | 17 ++++---- docs/canvas-pilot/guide/advanced-exchange.md | 2 +- docs/canvas-pilot/guide/files.md | 22 +++++----- docs/canvas-pilot/guide/format-matrix.md | 18 ++++----- docs/canvas-pilot/guide/install.md | 2 +- docs/canvas-pilot/introduction.md | 6 +-- docs/canvas-pilot/plan.md | 2 +- docs/canvas-pilot/portable-quickstart.txt | 2 +- .../formats/{ai.svg => illustrator.svg} | 0 docs/interfaces/canvas-pilot-exchange.md | 40 +++++++++---------- docs/interfaces/midra-extra-parameters.md | 2 +- docs/templates/canvas-pilot/catalog.md | 12 +++--- 13 files changed, 66 insertions(+), 63 deletions(-) rename docs/images/formats/{ai.svg => illustrator.svg} (100%) diff --git a/crates/canvas-pilot/src/interchange.rs b/crates/canvas-pilot/src/interchange.rs index f1c8f9c..836abf4 100644 --- a/crates/canvas-pilot/src/interchange.rs +++ b/crates/canvas-pilot/src/interchange.rs @@ -57,7 +57,7 @@ impl Codec { Self::Pptx => "PowerPoint · PPTX", Self::Figma => "Figma · FIG", Self::Figcraft => "FigCraft · FIGCRAFT", - Self::Illustrator => "Illustrator · AI (VectorCraft)", + Self::Illustrator => "Illustrator (VectorCraft)", } } pub fn extension(self) -> &'static str { @@ -200,7 +200,7 @@ pub fn import(bytes: &[u8], filename: &str) -> Result, String> { }]); } let text = std::str::from_utf8(bytes).map_err( - |_| "Unrecognized binary format. Choose PPTX, FIG, FIGCRAFT, AI or a supported geometry file.", + |_| "Unrecognized binary format. Choose PPTX, FIG, FIGCRAFT, Illustrator or a supported geometry file.", )?; Ok(vec![Page { name: filename.into(), diff --git a/docs/canvas-pilot/changelog.md b/docs/canvas-pilot/changelog.md index 92c3bf5..54b1efe 100644 --- a/docs/canvas-pilot/changelog.md +++ b/docs/canvas-pilot/changelog.md @@ -4,12 +4,15 @@ ## Unreleased +- Name the format Illustrator throughout the interface and documentation, avoiding + the ambiguous former abbreviation while retaining `.ai` files and codec compatibility. + - Added opt-in saved input correction proposals (project v16), restored inactive until mapping/input review and explicit staging; older projects migrate safely. - Added FigCraft embedded snapshots and full-state round-trip coverage across all snapshot codecs, including fit modes, blanking, shared inputs and mappings. - Ranked file formats and starter downloads by preservation tier, with compact - format pills and a separate advanced feature matrix. FIG, DWG and AI still + format pills and a separate advanced feature matrix. FIG, DWG and Illustrator still require a companion project for editable settings. @@ -31,7 +34,7 @@ callout and bold introduction, shared by the Markdown page and book. - Ordered the file feature matrix by preservation support, starting with Canvas - Pilot projects, and explained capability ties and the AI converter requirement. + Pilot projects, and explained capability ties and the Illustrator converter requirement. - Placed native-codec note 3 beside format names and extra-settings note 4 in each supporting row’s Extra settings cell in the feature matrix. @@ -230,7 +233,7 @@ release. Current project schema: **v13**; application settings: **v8**. and staged acceptance checks. No device support is enabled by this task. - Recommend SVG for Illustrator exchange in the README, manual and template - catalog. Keep AI as an optional compatibility target requiring external + catalog. Keep Illustrator as an optional compatibility target requiring external VectorCraft CLI, with executable discovery and setup documented. - Group viewport context-menu property windows under Properties and capture under @@ -274,7 +277,7 @@ release. Current project schema: **v13**; application settings: **v8**. HTML and PPTX, using metadata/custom fields or comments. Geometry remains editable; explicit Restore parameters from export recovers the original snapshot into an unsaved project. JSON/CSV v2 carries metadata; plain v1 exports are - unchanged. Document all formats, including unsupported DWG/FIG/FIGCRAFT/AI metadata embedding. + unchanged. Document all formats, including unsupported DWG/FIG/FIGCRAFT/Illustrator metadata embedding. Round-trip tests cover settings and geometry; installed draw.io exported the metadata-bearing diagram to SVG, and librsvg rendered both SVG variants. @@ -317,7 +320,7 @@ release. Current project schema: **v13**; application settings: **v8**. - Mark PPTX, draw.io and SVG format acceptance as solved following manual review confirming all three work (2026-11-14). -- Replace the incomplete DXF skeleton with the official shared Craft DXF document writer/reader; add optional Craft DWG exchange with the same pixel geometry and canvas limits. Refresh CAD starter files and cover document structure, binary DXF and DWG round trips. Add a byte-preserving ZIP of the AI templates to bypass Gitea/browser PDF preview downloads. +- Replace the incomplete DXF skeleton with the official shared Craft DXF document writer/reader; add optional Craft DWG exchange with the same pixel geometry and canvas limits. Refresh CAD starter files and cover document structure, binary DXF and DWG round trips. Add a byte-preserving ZIP of the Illustrator templates to bypass Gitea/browser PDF preview downloads. - Place insufficient import-destination warnings directly below the destination scope selector instead of repeating them near the Import button. @@ -372,7 +375,7 @@ release. Current project schema: **v13**; application settings: **v8**. - Add manual Midra input-still capture through the verified WebRCS PNG endpoint, with preview/Add as reference, one request at a time and a five-second minimum interval. Device-setting writes are not involved; active-input 512 × 288 and inactive blank-image responses checked on the Eikos. - Load project/recovery files and decode embedded references in a background worker, install atomically, preserve work on errors/cancel and pause recovery autosave while loading. Reconcile the historical plan into completed implementation, remaining features and separate hardware/platform acceptance checks. -- Add README-linked two-layer PPTX, Figma FIG and Illustrator AI templates in Full HD and UHD 4K. Extend the template generator with format selection and import verification; test native fixture geometry, with AI checked through VectorCraft 0.24.1. +- Add README-linked two-layer PPTX, Figma FIG and Illustrator templates in Full HD and UHD 4K. Extend the template generator with format selection and import verification; test native fixture geometry, with Illustrator checked through VectorCraft 0.24.1. - Remove the redundant Copy coordinates button from the title header and right-align the device label. Existing copy commands remain available. @@ -404,7 +407,7 @@ release. Current project schema: **v13**; application settings: **v8**. - Use a crisp, theme-aware magnet icon for the snapping dropdown; preserve snapping controls and active grid indicators. -- Unify file exchange around shared geometry preparation, byte-oriented codecs and one Export layers window. Add optional native PPTX/FIG import/export with slide/frame selection and embedded artwork, plus local VectorCraft AI conversion. File conversions run off the UI thread. Document and test `--no-default-features --features no_proprietary`; CI covers both configurations and production coverage includes the codecs. +- Unify file exchange around shared geometry preparation, byte-oriented codecs and one Export layers window. Add optional native PPTX/FIG import/export with slide/frame selection and embedded artwork, plus local VectorCraft Illustrator conversion. File conversions run off the UI thread. Document and test `--no-default-features --features no_proprietary`; CI covers both configurations and production coverage includes the codecs. - Add versioned geometry JSON, RFC-style CSV, DXF and HTML/CSS import/export alongside SVG and draw.io. All six formats have two-layer Full HD/UHD templates and round-trip tests; artwork support is explicit per format. diff --git a/docs/canvas-pilot/guide/advanced-exchange.md b/docs/canvas-pilot/guide/advanced-exchange.md index 57c103d..7b7c335 100644 --- a/docs/canvas-pilot/guide/advanced-exchange.md +++ b/docs/canvas-pilot/guide/advanced-exchange.md @@ -72,7 +72,7 @@ They do not turn crop, mask or source settings into native editing controls in t other application. Background/placeholder pictures can show the result, but cannot restore editable state by themselves. -FIG, DWG and AI have no verified metadata carrier through the current codecs. +FIG, DWG and Illustrator have no verified metadata carrier through the current codecs. Keep a `.pilot.json` companion when using these Bronze formats. Clipboard geometry also does not restore embedded snapshots. Use **Restore parameters from export** for Silver; use ordinary geometry import for the artwork's latest positions. diff --git a/docs/canvas-pilot/guide/files.md b/docs/canvas-pilot/guide/files.md index 71e2d43..e6a757c 100644 --- a/docs/canvas-pilot/guide/files.md +++ b/docs/canvas-pilot/guide/files.md @@ -10,7 +10,7 @@ for naming, crop, pictures and editable-settings support. Check the [clipboard feature matrix](format-matrix.md#clipboard-matrix) for your application: its file and copy/paste workflows can support different features. -Drop SVG, draw.io/XML, geometry JSON/CSV, DXF/DWG, HTML, PPTX, FIG, FIGCRAFT or AI files into +Drop SVG, draw.io/XML, geometry JSON/CSV, DXF/DWG, HTML, PPTX, FIG, FIGCRAFT or Illustrator files into the window to open the same geometry review as **Import → Geometry file…**. Native codecs still require their normal build options/dependencies. Filename extensions are case-insensitive; PNG/JPEG/BMP drops remain reference images. @@ -156,17 +156,17 @@ The [starter-file catalog](../../templates/canvas-pilot/catalog.md) contains all exchange formats, with two layers for 1920 × 1080 and 3840 × 2160 canvases. **Project → Export → Export layers…** opens one shared window. Choose SVG, -draw.io, JSON, CSV, DXF/DWG, HTML, PPTX, Figma FIG, FigCraft or Illustrator AI, then +draw.io, JSON, CSV, DXF/DWG, HTML, PPTX, Figma FIG, FigCraft or Illustrator, then **Current layer…**, **Selected layers…**, **Specific layer…**, **All layers…** and **Visible layers only…**. A current-layer export keeps its original screen position and full-screen canvas. The window offers **Include background layer**. SVG, draw.io, geometry -JSON, HTML, PPTX, FIG, FIGCRAFT and AI also offer **Include placeholder pictures** with embedded source-grid +JSON, HTML, PPTX, FIG, FIGCRAFT and Illustrator also offer **Include placeholder pictures** with embedded source-grid imagery; CSV and DXF explicitly disable pictures and carry rectangle geometry. Import a supported format with **Import → Geometry file…** or paste its text, then choose a slide/page/frame where applicable, then map detected layers to destinations. -PPTX uses 96 pixels per inch; FIG/FIGCRAFT use native pixels. AI requires a separately +PPTX uses 96 pixels per inch; FIG/FIGCRAFT use native pixels. Illustrator file exchange requires a separately installed `vectorcraft-cli`; its artboards appear in the same canvas selector. Import/export runs in the background and reports conversion failures without modifying the project. Backgrounds are automatically ignored; @@ -344,7 +344,7 @@ In **Export layers**, enable **Include extra Canvas Pilot parameters (experiment store the exported layers' source/crop settings, fit modes, masks, saved input proposals, names, folders, links and workspace setup alongside the geometry. It is available for SVG, draw.io, JSON, CSV, DXF, HTML, PPTX and FigCraft. Images/capture assignments are excluded from this snapshot; the -background and placeholder options remain separate. DWG, FIG and AI show why the +background and placeholder options remain separate. DWG, FIG and Illustrator show why the option is unavailable with the current codecs. Use **Project → Restore parameters from export…** to restore that original @@ -362,18 +362,18 @@ See the [format-by-format audit and metadata contract](../../interfaces/midra-ex See the [advanced feature matrix](advanced-exchange.md) for complete project, snapshot and geometry-only preservation, including input corrections. -## Illustrator AI: optional converter required +## Illustrator: optional converter required **SVG is the preferred format for exchanging layer layouts with Illustrator.** Midra imports and exports SVG directly, without Illustrator or VectorCraft installed. -AI remains an optional compatibility format; both AI import and AI export require +Native Illustrator files remain an optional compatibility format; import and export require **VectorCraft CLI**, which is not bundled with Canvas Pilot. Installing the VectorCraft graphical application alone does not guarantee that its CLI is available to Midra. The normal build includes all other supported exchange formats without external applications: SVG, draw.io, geometry JSON/CSV, HTML, DXF/DWG, PPTX, FIG and FIGCRAFT. -A build made with `no_proprietary` disables DWG, PPTX, FIG, FIGCRAFT and AI support. +A build made with `no_proprietary` disables DWG, PPTX, FIG, FIGCRAFT and Illustrator support. Installing a converter does not re-enable formats excluded from that build. Obtain VectorCraft CLI from the [VectorCraft project](https://github.com/storytold/vectorcraft). @@ -396,11 +396,11 @@ $env:MIDRA_VECTORCRAFT_CLI = 'C:\Tools\VectorCraft\vectorcraft-cli.exe' .\canvas-pilot.exe ``` -Select **Illustrator · AI (VectorCraft)** in Export layers, or import an `.ai` file +Select **Illustrator (VectorCraft)** in Export layers, or import an `.ai` file through Geometry file. Conversion is local and temporary; it does not use a cloud service. A missing converter produces an error without changing the project. Use SVG if you do not want to install or configure the converter. -AI exchanges layer geometry and optional artwork, not the complete editor project. +Illustrator exchanges layer geometry and optional artwork, not the complete editor project. Use a `.pilot.json` project to preserve all settings. See the -[AI format contract and round-trip checks](../../interfaces/canvas-pilot-exchange.md#illustrator-ai). +[Illustrator format contract and round-trip checks](../../interfaces/canvas-pilot-exchange.md#illustrator). diff --git a/docs/canvas-pilot/guide/format-matrix.md b/docs/canvas-pilot/guide/format-matrix.md index c1dc588..45c440b 100644 --- a/docs/canvas-pilot/guide/format-matrix.md +++ b/docs/canvas-pilot/guide/format-matrix.md @@ -4,8 +4,8 @@ Use **Save project** to continue editing later. Use **SVG** for straightforward vector-editor exchange, **draw.io** for diagrams.net, **PPTX** for slides, and -**FIG / FIGCRAFT** for Figma / FigCraft files. Prefer **SVG over AI** for Illustrator -unless you specifically need a native AI file. **DXF / DWG** suit CAD geometry; +**FIG / FIGCRAFT** for Figma / FigCraft files. Prefer **SVG** for Illustrator exchange +unless you specifically need a native `.ai` file. **DXF / DWG** suit CAD geometry; **JSON / CSV** suit scripts and tables. HTML provides a browser-viewable layout. These tables describe what **Canvas Pilot implements**, not everything each file @@ -17,7 +17,7 @@ a reference, not interactive controls. **Gold — complete project:** `.pilot.json` retains editable state and images. **Silver — optional snapshot:** eight exchange formats preserve advanced settings -when extra parameters are enabled. **Bronze — geometry/artwork:** FIG, DWG and AI +when extra parameters are enabled. **Bronze — geometry/artwork:** FIG, DWG and Illustrator need a companion project to retain those settings. Tiers describe preservation; formats within a tier are tied, with picture-capable formats listed first. See the [advanced feature matrix](advanced-exchange.md) for every saved feature. @@ -40,23 +40,23 @@ and layer labels can help identify the boxes; they do not rename destinations. | 🥈 Silver
![DXF](../../images/formats/dxf.svg) DXF (`.dxf`) | ✅ | ✅ | ✅ [2](#file-notes) | ❌ | ❌ | ✅ [4](#file-notes) | | 🥉 Bronze
![Figma](../../images/formats/fig.svg) Figma file (`.fig`) [3](#file-notes) | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ | | 🥉 Bronze
![DWG](../../images/formats/dwg.svg) DWG (`.dwg`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ❌ | ❌ | ❌ | -| 🥉 Bronze
![Illustrator](../../images/formats/ai.svg) Illustrator file (`.ai`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ✅ | ✅ | ❌ | +| 🥉 Bronze
![Illustrator](../../images/formats/illustrator.svg) Illustrator file (`.ai`) [3](#file-notes) | ✅ | ✅ | ✅ [2](#file-notes) | ✅ | ✅ | ❌ | ### File notes 1. **Pictures:** enable **Include background layer** and/or **Include placeholder pictures** when exporting. 2. **Names:** exported as format-specific labels/metadata. CAD uses stable layer - IDs with human names in descriptions; AI goes through an SVG conversion. + IDs with human names in descriptions; Illustrator files go through an SVG conversion. Another application's layer panel may display these differently. -3. **Native codecs:** DWG, PPTX, FIG, FIGCRAFT and AI require a build with vendor - formats enabled (the default). AI additionally requires the separately installed - [VectorCraft converter](files.md#illustrator-ai-optional-converter-required). +3. **Native codecs:** DWG, PPTX, FIG, FIGCRAFT and Illustrator require a build with vendor + formats enabled (the default). Illustrator file exchange additionally requires the separately installed + [VectorCraft converter](files.md#illustrator-optional-converter-required). 4. **Extra settings:** experimental and opt-in. Restore the original snapshot with **Project → Restore parameters from export…**; ordinary geometry import never applies it. External applications may strip it or leave it stale after edits. Exports use one screen-sized canvas, slide, frame or artboard. PPTX import offers -a slide picker; FIG / FIGCRAFT offer page/frame choices; AI offers artboards. +a slide picker; FIG / FIGCRAFT offer page/frame choices; Illustrator offers artboards. Draw.io supports single-page files, including compressed files. These are supported layout profiles, not general-purpose artwork importers: arbitrary HTML, SVG effects, CAD entities or complex native document features may be rejected or omitted. diff --git a/docs/canvas-pilot/guide/install.md b/docs/canvas-pilot/guide/install.md index 585245e..63258e5 100644 --- a/docs/canvas-pilot/guide/install.md +++ b/docs/canvas-pilot/guide/install.md @@ -160,7 +160,7 @@ explains source selection, install locations and replacement behavior. installation, remove its extracted folder and shortcut. Neither instruction asks you to delete saved projects or manually remove application preferences. - **Do I need a switcher?** No. Local editing and file exchange work offline. -- **Do I need extra converters?** FFprobe is not needed. Illustrator AI exchange +- **Do I need extra converters?** FFprobe is not needed. Illustrator exchange requires VectorCraft; SVG exchange works without that optional converter. ## Run the development version diff --git a/docs/canvas-pilot/introduction.md b/docs/canvas-pilot/introduction.md index 9fbf7e4..fd803cc 100644 --- a/docs/canvas-pilot/introduction.md +++ b/docs/canvas-pilot/introduction.md @@ -76,9 +76,9 @@ a format for your editor and see which settings it preserves. - **Work with another application:** drop a supported geometry file into the window, use **Import → Geometry file…**, or **Project → Export → Export layers…**. The [starter-file catalog](../templates/canvas-pilot/catalog.md) has matching Full HD and 4K files in SVG, draw.io, geometry JSON, CSV, DXF/DWG, - HTML, PPTX, Figma FIG, FigCraft and Illustrator AI. Prefer SVG for Illustrator - exchange: AI requires a separately installed VectorCraft CLI for both import - and export. See [AI setup](guide/files.md#illustrator-ai-optional-converter-required). + HTML, PPTX, Figma FIG, FigCraft and Illustrator. Prefer SVG for Illustrator + exchange: Illustrator requires a separately installed VectorCraft CLI for both import + and export. See [Illustrator setup](guide/files.md#illustrator-optional-converter-required). - **Use a supported device:** connect, review layer mappings, then explicitly load or send the chosen layers. Ordinary editing does not send commands to the device. Follow the [connection and transfer guide](guide/device.md) and its linked diff --git a/docs/canvas-pilot/plan.md b/docs/canvas-pilot/plan.md index f05ebbd..a01934b 100644 --- a/docs/canvas-pilot/plan.md +++ b/docs/canvas-pilot/plan.md @@ -41,7 +41,7 @@ device readback and physical-screen acceptance. size/position/available-zoom toggles, draw.io stroke handling and own-copy round trips. Real draw.io clipboard sample and draw.io-exported SVG supported. - [x] Eleven-format file exchange: SVG, draw.io, geometry JSON, CSV, DXF/DWG, HTML, - PPTX, FIG, FIGCRAFT and AI through VectorCraft. Shared geometry, scope and review, + PPTX, FIG, FIGCRAFT and Illustrator through VectorCraft. Shared geometry, scope and review, optional artwork where supported, page/frame selection and licensing build flag. Two-layer Full HD and UHD templates exist for all eleven formats. - [x] Project JSON v15, tested legacy/recovery migration, saved layer links, diff --git a/docs/canvas-pilot/portable-quickstart.txt b/docs/canvas-pilot/portable-quickstart.txt index e862938..7e4a08d 100644 --- a/docs/canvas-pilot/portable-quickstart.txt +++ b/docs/canvas-pilot/portable-quickstart.txt @@ -21,7 +21,7 @@ Run these commands from the extracted directory. Linux launchers reference this location; keep it in a permanent folder. macOS launchers copy the executable. The helper does not sign/notarize the application or bypass OS security checks. -FFprobe is not required. Illustrator AI exchange needs a separately installed +FFprobe is not required. Illustrator exchange needs a separately installed VectorCraft CLI; SVG exchange can be used without it. License: LICENSES/MIT.txt. Independent software, not affiliated with Analog Way. diff --git a/docs/images/formats/ai.svg b/docs/images/formats/illustrator.svg similarity index 100% rename from docs/images/formats/ai.svg rename to docs/images/formats/illustrator.svg diff --git a/docs/interfaces/canvas-pilot-exchange.md b/docs/interfaces/canvas-pilot-exchange.md index f498559..ce377e7 100644 --- a/docs/interfaces/canvas-pilot-exchange.md +++ b/docs/interfaces/canvas-pilot-exchange.md @@ -4,7 +4,7 @@ Canvas Pilot was formerly named Midra Layout. The rename preserves existing wire The Export menu writes **SVG v2**, **draw.io v1**, **geometry JSON v1**, **geometry CSV v1**, **DXF/DWG**, **HTML/CSS v1**, **PPTX**, **Figma FIG / FigCraft** and -**Illustrator AI** (the latter via a local VectorCraft CLI). Project +**Illustrator** (the latter via a local VectorCraft CLI). Project JSON is version 16 and is the full-fidelity save format. These exchanges preserve layer **visible-box geometry**, not sources, crop settings, zoom, pivots, Midra links, locks, visibility, camera or selection. Pictures illustrate current @@ -12,24 +12,24 @@ cropping; importing a picture does not reconstruct its crop or source settings. The [starter-file catalog](../templates/canvas-pilot/catalog.md) centralizes ready-to-open two-layer templates under `docs/templates/canvas-pilot/` for Full HD (1920 × 1080) and UHD 4K -(3840 × 2160), in all eleven exchange formats (including PPTX, FIG and AI). The 4K geometry is an exact +(3840 × 2160), in all eleven exchange formats (including PPTX, FIG and Illustrator). The 4K geometry is an exact 2× scale of the Full HD layout. Regenerate them with: ```sh cargo run --locked -p canvas-pilot --example check_geometry_exchange -- templates docs/templates/canvas-pilot -# Optional native codecs (default build); AI requires VectorCraft CLI: +# Optional native codecs (default build); Illustrator requires VectorCraft CLI: MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo run --locked -p canvas-pilot --example check_geometry_exchange -- templates docs/templates/canvas-pilot pptx fig ai ``` The generator verifies imported geometry before writing each template and replaces existing templates in the explicitly supplied directory. Samples contain only two editable layer boxes, with no background or placeholder images. PPTX uses one slide, -FIG one frame, and AI one artboard. Their canvas sizes are pixels (PPTX uses the +FIG one frame, and Illustrator one artboard. Their canvas sizes are pixels (PPTX uses the documented 96 pixels/inch conversion). These files are geometry examples, not -full-fidelity project saves. AI samples were generated and round-trip checked with +full-fidelity project saves. Illustrator samples were generated and round-trip checked with VectorCraft CLI 0.24.1; Adobe Illustrator itself was not used for validation. Native fixtures are checked semantically rather than byte-for-byte because encoder -metadata can vary. The AI regression check is opt-in and requires the real CLI: +metadata can vary. The Illustrator regression check is opt-in and requires the real CLI: ```sh MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo test --locked -p canvas-pilot --test exchange illustrator_readme_templates -- --ignored @@ -48,7 +48,7 @@ MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo test --locked -p canvas-pil | PowerPoint, LibreOffice Impress, DeckCraft | PPTX | Yes; slide picker on import | Embedded PNG | Embedded PNG | | Figma, FigCraft | Native FIG | Yes; page/frame picker on import | Embedded PNG | Embedded PNG | | FigCraft | Native FIGCRAFT | Yes; page/frame picker on import | Embedded PNG | Embedded PNG | -| Illustrator, VectorCraft | Native AI via VectorCraft CLI | Yes; artboard picker on import | Embedded PNG | Embedded PNG | +| Illustrator, VectorCraft | Native Illustrator via VectorCraft CLI | Yes; artboard picker on import | Embedded PNG | Embedded PNG | PSD, VSDX and ODG remain future adapters rather than implied support. PDF is a useful final visual but does not retain a @@ -80,7 +80,7 @@ they do not modify the project/settings schema: - **Include background layer** adds a first, full-screen shape with ID `midra-background`, explicitly marked as background. SVG, draw.io, JSON, HTML, - PPTX, FIG and AI + PPTX, FIG and Illustrator embed all visible references composited in project order over a dark backdrop using each image's fit/stretch/native-size, offset and opacity; otherwise they embed a plain dark backdrop. This is a baked visual reference, not an editable copy of reference @@ -107,15 +107,15 @@ The default `vendor_formats` Cargo feature uses the published, pinned [`figcraft-format 0.5.1`](https://crates.io/crates/figcraft-format/0.5.1) crates with their document/geometry types. Their licenses are `MIT OR Apache-2.0`; vendor file formats do not imply a proprietary implementation license. No upstream app UI, -font bundle, media engine or online service is embedded. VectorCraft's AI readers -are unpublished and pull in rendering, font and PDF stacks, so AI uses a separate +font bundle, media engine or online service is embedded. VectorCraft's Illustrator readers +are unpublished and pull in rendering, font and PDF stacks, so Illustrator uses a separate optional executable rather than embedding that stack. Upstream licenses still apply to separately distributed tools; Midra does not bundle VectorCraft. ```sh -# Normal build: native PPTX/FIG/DWG codecs and the optional AI converter interface. +# Normal build: native PPTX/FIG/DWG codecs and the optional Illustrator converter interface. cargo build --locked --release -p canvas-pilot -# Excludes vendor codecs, their optional dependency trees and the AI interface. +# Excludes vendor codecs, their optional dependency trees and the Illustrator interface. cargo build --locked --release -p canvas-pilot --no-default-features --features no_proprietary ``` @@ -184,18 +184,18 @@ Midra or recreated on export. Reader repair warnings appear in the import review This option shares the FIG vendor feature and is excluded by `no_proprietary`. Tests cover native resaving, bare JSON, geometry, artwork and both starter sizes. -### Illustrator AI +### Illustrator -Optional compatibility target: **prefer SVG for Illustrator exchange**. AI import +Optional compatibility target: **prefer SVG for Illustrator exchange**. Illustrator import and export require a separately installed VectorCraft CLI; it remains external -and is not embedded or bundled. See the [manual setup instructions](../canvas-pilot/guide/files.md#illustrator-ai-optional-converter-required). +and is not embedded or bundled. See the [manual setup instructions](../canvas-pilot/guide/files.md#illustrator-optional-converter-required). Uses [VectorCraft CLI](https://github.com/storytold/vectorcraft), discovered through `MIDRA_VECTORCRAFT_CLI`, beside the Midra executable, in its `bin/` subdirectory, then on PATH. Conversion runs locally in safe mode in a temporary directory, with a 60-second timeout and 16 MiB result limit. Nothing is installed automatically. -The CLI reads AI and converts to SVG for the shared geometry importer, or writes -PDF-compatible AI from Midra SVG. Import enumerates up to 64 artboards and presents +The CLI reads Illustrator and converts to SVG for the shared geometry importer, or writes +PDF-compatible Illustrator from Midra SVG. Import enumerates up to 64 artboards and presents each separately in the same canvas selector. Converter import warnings are shown in the mapping review; export warnings reject the result instead of silently losing content. SVG's rectangle/path/image restrictions @@ -210,7 +210,7 @@ MIDRA_VECTORCRAFT_CLI=/path/to/vectorcraft-cli cargo run --locked -p canvas-pilo These generate plain and illustrated documents, with backgrounds, and verify the imported layer boxes. Existing diagnostic files are not overwritten. VectorCraft -0.24.1 native AI round trips were checked for both variants. DeckCraft 0.8.0 +0.24.1 native Illustrator round trips were checked for both variants. DeckCraft 0.8.0 rendered the exported PPTX independently of the pinned 0.6.1 codec; the resulting Full HD image was visually inspected. @@ -383,7 +383,7 @@ the only positions present in that SVG. Include Canvas Pilot's background layer before exporting through draw.io when the full output-screen origin must survive the round trip. -Tests cover each format/artwork combination, the twelve text templates and eight native PPTX/FIG/FIGCRAFT/DWG templates (plus two AI templates in the opt-in CLI check), +Tests cover each format/artwork combination, the twelve text templates and eight native PPTX/FIG/FIGCRAFT/DWG templates (plus two Illustrator templates in the opt-in CLI check), full-screen layers vs backgrounds, negative/fractional coordinates, repeat round trips, compressed clipboard/files, embedded references, invalid IDs/versions and no-overwrite file handling. @@ -443,7 +443,7 @@ capture bindings. See the [complete carrier contract and format audit](midra-ext Restore the original snapshot with **Project → Restore parameters from export…**. Normal geometry import continues to use the artwork's current boxes, including any -external edits. Third-party editors may strip metadata. DWG, FIG and AI are not +external edits. Third-party editors may strip metadata. DWG, FIG and Illustrator are not enabled until their current codec paths can preserve it reliably. Embedded project snapshots now contain project version 16 and family-aware `device_link` objects. Geometry representation versions are unchanged. Existing embedded versions 1–15 migrate using the [project contract](canvas-pilot.md); plain geometry continues to omit device destinations. diff --git a/docs/interfaces/midra-extra-parameters.md b/docs/interfaces/midra-extra-parameters.md index d7288f2..4061059 100644 --- a/docs/interfaces/midra-extra-parameters.md +++ b/docs/interfaces/midra-extra-parameters.md @@ -26,7 +26,7 @@ external editor moves/resizes a shape without updating the embedded snapshot. | DWG | Not enabled | DXF comments do not provide a reliable binary-DWG carrier. XRECORD/XData are potential future paths, but the current Craft conversion bridge has no verified application-payload round trip. No bytes are appended to the binary file. | | FigCraft FIGCRAFT | First page node `plugin_data.beffroi_midra_parameters` in native v1 `document.json` | ZIP and bare JSON restore supported. Native FigCraft 0.5.1 load/save preserves the field. Duplicate payloads are rejected; document JSON reads are bounded to 16 MiB. Other ZIP members are preserved. | | Figma FIG | Not enabled | Figma has plugin data, but the installed FigCraft 0.5.1 native exporter explicitly warns `plugin data was left out`. Its model field is not evidence of native preservation. | -| Illustrator AI | Not enabled | PDF-compatible AI can have document metadata, but the current VectorCraft SVG↔AI conversion path has no verified application-payload preservation. No unverified PDF/AI trailer changes are made. | +| Illustrator | Not enabled | PDF-compatible Illustrator can have document metadata, but the current VectorCraft SVG↔Illustrator conversion path has no verified application-payload preservation. No unverified PDF/Illustrator trailer changes are made. | | Midra project JSON | Already complete | Project v16 remains the authoritative full-fidelity save. | Unsupported codecs disable the option with an explanation. Programmatic attempts diff --git a/docs/templates/canvas-pilot/catalog.md b/docs/templates/canvas-pilot/catalog.md index ad66597..948af65 100644 --- a/docs/templates/canvas-pilot/catalog.md +++ b/docs/templates/canvas-pilot/catalog.md @@ -44,15 +44,15 @@ These starter downloads are plain geometry templates, without embedded snapshots | 🥈 Silver | ![DXF](../../images/formats/dxf.svg) DXF | [Download .dxf](canvas-pilot-1080p-2-layers.dxf) | [Download .dxf](canvas-pilot-4k-2-layers.dxf) | CAD tools | | 🥉 Bronze | ![Figma](../../images/formats/fig.svg) Figma FIG | [Download .fig](canvas-pilot-1080p-2-layers.fig) | [Download .fig](canvas-pilot-4k-2-layers.fig) | Figma or FigCraft | | 🥉 Bronze | ![DWG](../../images/formats/dwg.svg) DWG | [Download .dwg](canvas-pilot-1080p-2-layers.dwg) | [Download .dwg](canvas-pilot-4k-2-layers.dwg) | CAD tools; Craft bridge | -| 🥉 Bronze | ![Illustrator](../../images/formats/ai.svg) Illustrator AI (optional) | [Download .ai](canvas-pilot-1080p-2-layers.ai) | [Download .ai](canvas-pilot-4k-2-layers.ai) | Requires VectorCraft CLI for Canvas Pilot import/export; prefer SVG | +| 🥉 Bronze | ![Illustrator](../../images/formats/illustrator.svg) Illustrator (optional) | [Download .ai](canvas-pilot-1080p-2-layers.ai) | [Download .ai](canvas-pilot-4k-2-layers.ai) | Requires VectorCraft CLI for Canvas Pilot import/export; prefer SVG | FIG, FIGCRAFT, DXF and DWG import/export were manually reviewed on 2026-11-15. PPTX, draw.io and SVG were previously confirmed; see the [format acceptance list](../../canvas-pilot/plan.md#completed-acceptance). -**Prefer SVG when exchanging layouts with Illustrator.** The AI templates remain +**Prefer SVG when exchanging layouts with Illustrator.** The Illustrator templates remain available for compatibility, but Canvas Pilot needs the separately installed VectorCraft -CLI to import or export them. See [AI setup](../../canvas-pilot/guide/files.md#illustrator-ai-optional-converter-required). +CLI to import or export them. See [Illustrator setup](../../canvas-pilot/guide/files.md#illustrator-optional-converter-required). ## Geometry files and saved projects @@ -64,7 +64,7 @@ Save project…** for a full `.pilot.json` project; see the examples stay beside their [interface contracts](../../interfaces/README.md). PPTX and FIG support uses the optional native codecs included in the default -build. Illustrator AI import/export requires a separately installed VectorCraft +build. Illustrator import/export requires a separately installed VectorCraft CLI. See [dependencies and licensing builds](../../interfaces/canvas-pilot-exchange.md#optional-native-document-codecs-and-licensing-builds). ## Maintaining the base files @@ -81,8 +81,8 @@ the file names and bytes and the manual includes the same archive. Keep all formats here and link to this catalog instead of copying files or maintaining separate download lists. The [generation and verification commands](../../interfaces/canvas-pilot-exchange.md) rebuild both canvas sizes with the application exporter and verify their geometry. -Text and native PPTX/FIG/DWG fixtures are covered by regression tests; the AI check -requires VectorCraft and is opt-in. The AI samples were checked with VectorCraft +Text and native PPTX/FIG/DWG fixtures are covered by regression tests; the Illustrator check +requires VectorCraft and is opt-in. The Illustrator samples were checked with VectorCraft 0.24.1, not Adobe Illustrator. The DXF and DWG samples were opened and rendered with **QCAD Professional 3.28.2**.