Repository Public License
1# ORIX Convert — application architecture23The macOS application shell: `project.yml` (XcodeGen), `App/`, `Scripts/build.sh`, `Scripts/shot.sh`,4`Scripts/screenshots.sh`, `Scripts/localize.py`. Conversion code lives in `Packages/` (see `core-api.md` and5`ENGINE-CONTRACT.md`); the app only talks to engines through the generic contract.67## Project89- `Scripts/build.sh generate|debug|release|run|selftest|core-test|strings`. The `.xcodeproj` is generated and10 gitignored. `release` signs with `Developer ID Application` (`--timestamp`, `CODE_SIGN_INJECT_BASE_ENTITLEMENTS=NO`);11 `ORIX_RELEASE_ADHOC=1 Scripts/build.sh release` builds the Release configuration signed ad hoc.12- macOS 15.0, arm64, Swift 6, strict concurrency, `SWIFT_DEFAULT_ACTOR_ISOLATION: MainActor` for the app target13 (types that must be callable off the main actor are marked `nonisolated`). Not sandboxed, Hardened Runtime, no14 entitlement.15- Document types: any file or folder, role Viewer, rank Alternate — the app accepts drops on the Dock icon and16 "Open With" without ever becoming a default handler.17- Post-build phase "Embed tools, helpers and licences" (`project.yml`):18 1. **Licences** → `Contents/Resources/Licenses`: every `EmbeddedEngines/*/NOTICE.md` as `<component>.md`, plus the19 full licence texts `ffmpeg/*` (from `EmbeddedEngines/ffmpeg/licenses`), `pandoc/COPYING-GPL-2.0.txt` and20 `hdf5/LICENSE.txt`. LibreOffice keeps its own `LICENSE` / `NOTICE` inside its bundle. Settings › About lists the21 notices; its "Licence…" sheet has a document picker for the texts (LibreOffice's are read from its bundle).22 2. **Tools** → `Contents/Helpers`: Release rsyncs `EmbeddedEngines/tools/` (symlinks preserved), or the folder given23 by `ORIX_TOOLS_SOURCE` (`build/signed-tools` after `Scripts/sign-tools.sh`). Debug skips the 700 MB copy24 (`ORIX_EMBED_TOOLS_IN_DEBUG=YES` forces it) and the app points the core at `EmbeddedEngines/tools` through25 `ORIX_CONVERT_TOOLS` (`EngineCatalog.prepareToolLookup`, `#if DEBUG` only).26 3. **Own helpers**, built by `swift build -c release --build-system native` with a clean environment, each in27 `build/helpers/<name>` (log `build/helpers/<name>.log`), copied to `Contents/Helpers` and signed with the28 build's identity, Hardened Runtime, and a secure timestamp when the app has one: `orix-model3d-helper`29 (EngineModel3D), `orix-hdf5-probe` (EngineScientific), `orix-midi-render` (EngineMedia) — required, in Debug too —30 and, in Release (or `ORIX_EMBED_CLI=YES`), `orix-convert` through `Scripts/cli-build.sh` (optional: a failed31 build is a warning; `@loader_path/../Frameworks` is added to its run paths for `libduckdb.dylib`).32- `libduckdb.dylib` (binary target of EngineData) is embedded and signed in `Contents/Frameworks` by Xcode.33- `Scripts/build.sh release` passes `ARCHS=arm64` on the command line: with `ONLY_ACTIVE_ARCH=NO` Xcode would also34 compile the packages for x86_64, where `Float16` (scientific engine) does not exist.35- `ORIX_APP=<app> Scripts/build.sh selftest` runs the self-test of any built app with `env -i HOME TMPDIR PATH=/usr/bin:/bin`.3637## Structure3839```40App/Sources/App entry point, AppDelegate, AppModel, AppSection, EngineCatalog, launch options,41 self-test, self-screenshot, string lookup (L / LE), engine string harvest42App/Sources/DesignSystem Tokens (colour roles, gradient, spacing, radii, category colours), Components,43 FormatBadge, ProgressViews44App/Sources/Features/SmartDrop WorkspaceModel + Prepare pane (groups, destination picker, generated options,45 presets, warnings, output bar)46App/Sources/Features/Queue QueueModel + Queue pane (rows, decisions, summary, inspector, log sheet)47App/Sources/Features/History HistoryModel + list and detail48App/Sources/Features/Metadata MetadataModel + Metadata Studio, shared InspectionContent49App/Sources/Features/Formats registry browser and matrix export50App/Sources/Features/Settings Settings scene (General, Performance, Privacy, Advanced, About)51App/Sources/Features/Shared Finder actions, Quick Look, Dock progress, notification, sample files, KeyLabels52App/Sources/Features/Studio what the studios share: CompareCanvas (zoomable canvas), TargetCatalog / TargetPicker,53 StudioRunner (private queue), PictureSource, PixelMath54App/Sources/Features/QualityLab QualityLabModel + view, WaveformView55App/Sources/Features/VectorStudio VectorStudioModel + view56App/Sources/Features/Flow FlowDocument (editable workflow, conditions, built-ins, messages), FlowModel, FlowView57 (library + canvas), FlowPanel (step editor, run, history)58App/Sources/Features/WatchFolders WatchModel, WatchView (rules, activity, rule sheet), MenuBarController59```6061`AppModel` (`@Observable`, main actor) owns the core services (`ConversionJobManager`, `PresetStore`, settings) and62one model per feature. Views are thin and read the models through the environment.6364- **Every file entry point ends in `AppModel.ingest(urls:)`**: window drop, Add Files / Add Folder, paste, Dock65 icon, `open`, `-ORIXOpen`. The Services / Finder Quick Action must call the same function (markers66 `EXTENSION POINT` in `App/Sources/App/AppDelegate.swift` and `project.yml`).67- `WorkspaceModel` runs `SmartDropAnalyzer`, groups files by detected format, and for each group keeps the chosen68 destination (`TargetChoice`: a real `ConversionPlan`), the option values, and the warnings gathered by69 `SmartDropAnalyzer.preflight` for every file (recomputed when the destination or an option changes). Only70 destinations returned by the capability resolver or reachable by a real two-step plan are ever listed.71- `QueueModel` mirrors `ConversionQueue.events()` into one `@Observable` `JobItem` per job (a progress tick redraws72 one row). Progress is determinate only when the engine measured a fraction; the batch progress is "settled jobs +73 measured fractions over the number of jobs"; ETA and throughput appear only when they can be derived from measured74 values. A running job has no Pause control (the core cannot suspend an engine), only Cancel.75- Secrets: option keys containing `password` are rendered as `SecureField`s, live only in the staged group and in76 the in-memory job request, are stripped from presets, from the history (core: `ConversionOptions.redactingSecrets`)77 and from every "copy details" / inspector view.78- Estimated output size: not shown. No engine exposes a real basis for one, so the app does not invent it.79- Combining across format groups: when several staged groups have chosen the same multi-source path (same engine,80 destination and operation — `WorkspaceModel.combineKey`), each offers "One file with the … too"; the groups then81 become one job whose sources are their files in group order, with the options of the first group. Nothing is82 offered between groups whose formats do not share that path.83- Prepare rows are keyboard-selectable (`WorkspaceModel.selectedFileID`): arrows, space = Quick Look, delete removes.84- `KeyLabels` gives the generic validation check names and the common fact keys a label from the string catalog85 (`output.not-empty` → "Output is not empty", `dpi` → "Resolution (dpi)"), falling back to the raw key.86- The welcome chips come from a curated list of everyday pairs, each shown only when the registry has a verified87 path for it (`ExampleChips.curated`), with the former automatic pick as a fallback.88- `OptionControl`: an integer option whose unit is `%` is a slider; a choice whose menu does not fit next to its89 label goes under it.90- Settings are a JSON file in the support folder (`settings.json`), next to `history.sqlite` and `presets.json`, so91 `-ORIXDataDir` isolates all three.9293## Adding a section94951. Add a case to `AppSection` (`App/Sources/App/AppSection.swift`) with its `group`, `title`, `symbol`.962. Return its view from `SectionHost` in `App/Sources/App/RootView.swift`.973. The sidebar, the Go menu (⌘1…⌘9) and `-ORIXSection <rawValue>` pick it up automatically.9899A section gets `AppModel` from the environment; add its own `@Observable` model to `AppModel` as a lazy property like100the existing ones. Use `HeaderBar`, `Card`, `Banner`, `EmptyState`, `FormatBadge`, `ORIXProgressBar` /101`ORIXProgressRing` and the `ORIX.Palette` roles. Files dropped on the window go to `AppModel.receive(urls:)`, which102hands them to the visible studio (Quality Lab, Vector Studio, Flow) and stages them everywhere else.103104## The studios105106All four are built. They share `App/Sources/Features/Studio`:107108- **`StudioRunner`** owns a second `ConversionQueue` (same registry, no history, at most two jobs). Quality Lab trial109 conversions and Vector Studio exports are ordinary jobs on it — planner, engine, validation, safe writer — that110 never appear in the Convert queue or the history. Its scratch folder is111 `$TMPDIR/ai.spboucher.orix.convert.studio-<pid>`, removed at quit.112- **`CompareCanvas`** (`NSViewRepresentable` over `CanvasNSView`, drawn with Core Graphics): one pane, two synchronized113 panes or a draggable split; each side is a `CanvasLayer` — a bitmap (preview + optional "detail" bitmap), filled114 CGPath layers or stroked outlines with nodes. Zoom is expressed in device pixels per image pixel (`Viewport`,115 shared with the toolbar and the View menu: ⌘+ ⌘− ⌘0 ⇧⌘1); bitmaps switch to nearest-neighbour as soon as one116 bitmap pixel covers more than one device pixel; scroll pans, ⌘-scroll / pinch / mouse wheel zoom around the117 pointer, double-click toggles fit and 100 %, arrow keys pan, `[` `]` move the split.118- **`TargetCatalog` / `TargetPicker` / `TargetButton`**: destinations that are real for a format (or every119 destination of the registry, for workflow steps and watch rules), not tied to the Convert workspace.120121**Quality Lab** (`QualityLabModel`). `open(url, target:)` inspects the file, lists its real single-file destinations122and starts the trial; `setOption` re-runs it 450 ms after the last change, cancelling the stale job. The previous123comparison stays on screen while a new run converts. After a run: both files are inspected, pictures are decoded124through `PictureSource` (`ImagePreview`, `PDFPreview.thumbnail`, `SVGWebRenderer.bitmap`,125`MediaQualityLab.videoFrame`), PSNR / largest difference / differing pixels come from `ImageComparison.compare` on126the two previews (only when they have the same pixel size; the panel says at which size), the difference view is127`PixelMath.difference` (absolute difference × 1 / 4 / 16 / 64). Bounded decodes: previews are at most 2048 px on the128long side; a "detail" bitmap of at most **8192 px** (`PictureSource.detailLimit`) is decoded only for images whose129file holds more than the preview, and is what the canvas draws past the preview's resolution and what the pixel130inspector reads (it says so when the file is larger than the cap). Audio → audio shows `WaveformCompare`131(`MediaQualityLab.waveform`, 4000 buckets). A result made of several files (pages) is compared page by page; a132result folder is expanded to its files. When one side cannot be drawn the stage says so and the Facts tab remains.133"Use These Settings" stages the file in Convert with the same destination and options; the bookmark button saves a134preset (secrets removed).135136**Vector Studio** (`VectorStudioModel`). The image is decoded with the engine's `RasterDecoder`; the controls are the137engine's own descriptors for its `image.vectorize` path (the mode is drawn as chips and138`VectorEngine.presetOptions(for:)` fills the form). Every change cancels the running trace (`CancelFlag`, polled by139`Vectorizer`), runs `.preview(maxDimension: 512)` after 45 ms, then the full pass after 380 ms of rest. The canvas140draws `VectorDocument.cgLayers`. Export SVG / vector PDF runs the engine's path on the `StudioRunner` queue into the141file chosen in a save panel; "Copy SVG" puts the full-pass SVG on the pasteboard; the drag handle provides an `.svg`142file representation written when it is dropped; "Apply to Files…" enqueues `image.vectorize` jobs with the current143options in the Convert queue. The palette strip is display-only: the engine has no per-colour exclusion.144145**Flow** (`FlowModel`, `FlowDocument`). The document is the core `Workflow` with stable node identifiers. Every edit146goes through `FlowModel.edit(_:_:)`, which registers the previous document in the model's own `UndoManager`147(Edit › Undo / Redo call it while Flow is visible), re-validates with `WorkflowValidator` and saves to the148`WorkflowLibrary` 250 ms later. Issues are attached to cards by the validator's `nodePath`; `FlowMessages` rewrites149the validator's sentences in the user's language. Built-in examples (`BuiltInWorkflows`) are plain `Workflow` values150validated at launch against the formats they are meant for (strict `inputFormats`); the ones that fail are not151offered; they are read-only and can be duplicated. `runNow()` hands the in-memory workflow to152`manager.workflowRunner`: its conversions are jobs of the main queue (they appear in Convert › Queue); per-item153progress is read from the jobs carrying the run's `counter`. A workflow handles files one by one and a branch runs154one of its two lanes: neither "several inputs → one output" nor "two outputs from one input in parallel" exist in155the core model. Secrets typed in a convert step stay in the in-memory document (they are used by runs started from156it) and are removed by `WorkflowLibrary` whenever it stores or exports.157158**Watch Folders** (`WatchModel`). A thin layer over the core's `FolderWatcher`, started at launch. Folders enter a159rule only through `NSOpenPanel` (`FolderPanel.choose`), where the bookmark is taken. The sheet runs160`FolderWatcher.loopRisk` on the draft before saving, and `addRule` checks again. Rule status is derived (watching /161paused / all paused / folder missing or destination read-only). Rules never store secrets. The optional menu bar162item (`MenuBarController`, setting `keepInMenuBar`, off by default) keeps the app alive when its window is closed163(`applicationShouldTerminateAfterLastWindowClosed`); nothing is registered at login.164165## Adding an engine1661671. Check that the package builds: `swift build` in `Packages/Engine<Name>` and that it exposes `makeEngines()`.1682. `project.yml`: add the package under `packages:` and `- package: Engine<Name>` under the target's dependencies.1693. `App/Sources/App/EngineCatalog.swift`: one `import Engine<Name>`, one line `Engine<Name>.makeEngines,` in170 `factories`, and the name in `wiredPackages`. If the engine runs a large helper process, add its engine identifier171 to `heavyEngineIDs`.1724. `Scripts/build.sh debug && Scripts/build.sh selftest`, then `Scripts/build.sh strings` to harvest its strings.173174All thirteen engine packages are wired (15 engines). Static xcframeworks must carry their module map in175`Headers/<Module>/module.modulemap` (`EmbeddedEngines/normalize-xcframework.sh`): Xcode copies the headers of every176xcframework into one include directory. `Model3DEngine` is created with `isolation: .required` (Release always; Debug177when the helper is there). The archive engine is registered with `makeEngines()` = archive-specific paths only.178179## Generic operations (any files → archive)180181"Create ZIP / 7z / TAR… archive" and "Compress to gzip / bzip2 / xz / zstd" are declared once by the archive engine182from the `.folder` pseudo-source. `SmartDropAnalysis.selectionOperations` / `.fileOperations` carry them and183`WorkspaceModel` appends them to the operations of every group, including unrecognised files (`StagedGroup.genericIDs`);184they are never a default choice. A choice made from them has `TargetChoice.isGeneric`: the plan starts at `.folder`185and the request carries `sourceFormat: .folder`. Groups (and the folder group) that pick the same generic multi-source186operation share one `combineKey` and are combined into ONE job by default ("One file with the … too" separates them).187Caveat: a dropped folder is both a folder entry and its expanded files; choosing the archive for both puts the files188in twice.189190## Previews191192`Features/Preview`: `FilePreviewModel` (lazy, cancellable, loads off the main actor, bounds in193`FilePreviewModel.Bounds`) and `FilePreviewView`. Shown in Metadata Studio (card "Preview") and in the Convert side194panel ("Preview" disclosure, closed by default; `-ORIXPanel preview` opens it). Sources: `ImagePreview.decode`,195`PDFPreview.thumbnail` (first 3 pages), `Model3DPreviewLoader` (helper process; `SCNView` with camera control and a196wireframe toggle; models above 512 MB are not loaded), `DataPreview.preview` (first 100 rows, detected types, sheet197picker), `ArchiveBrowser.list` (200 entries per page, filter, encrypted / unsafe-name marks, nothing extracted),198`LoadedFont.preview` + `glyphs(in:)` (four sizes, pages of 96 glyphs, the font's embedding statement),199`SubtitleParser.parse` (first 400 cues), `GeoPreview.preview` (Core Graphics plot of the first 400 features in the200file's coordinates + attribute table; no tiles, no network), `MediaQualityLab.waveform` / `.videoFrame`, and201`QLThumbnailGenerator` for documents, ebooks, presentations and SVG. Formats without any of these (scientific202containers, unrecognised files) say that no preview exists. Self-screenshots replace the live `SCNView` by one203`SCNView.snapshot()` of the same scene (`cacheDisplay` does not capture a Metal layer).204205## System integrations206207- **Services**: Info.plist `NSServices` — "Convert with ORIX Convert", `NSSendFileTypes: [public.item]`, message208 `convertFiles`. `ServicesProvider` (registered as `NSApp.servicesProvider`) reads the pasteboard's file URLs and209 calls `AppModel.ingest(urls:)`. macOS lists a new service after the app has been in /Applications and `pbs` has210 rescanned; it may have to be ticked in System Settings › Keyboard › Keyboard Shortcuts › Services.211- **Finder Quick Action / Share extension**: not built. An Action extension is a separate sandboxed target with its212 own signing and an App Group or XPC hand-off to the (unsandboxed) app, and its appearance in Finder cannot be213 verified without driving the screen. The Services entry covers the same gesture (Finder › right click › Services).214- **App Intents** (`Features/Integration/AppIntents.swift`): `ConvertFilesIntent` (files, format entity listing the215 registry's plain destinations, optional preset), `DetectFormatIntent`, `RunWorkflowIntent` (entity query over saved216 and built-in workflows), `ORIXConvertShortcuts`. `openAppWhenRun = false`; they run on the app's own queue and write217 results under `$TMPDIR/ai.spboucher.orix.convert.intents` (swept after a day). Intent titles are English only.218- **Command line**: Settings › Advanced › "Install command-line tool…" shows the `sudo ln -sf` command for219 `Contents/Helpers/orix-convert`; the app writes nothing outside itself.220- **Presets**: `BuiltInPresets.all` (27), validated at launch by `BuiltInPresets.validated(in:)` — path, option keys,221 ranges and choices — and registered through `PresetStore.registerBuiltIns`; rejected ones are logged222 (`Logger` category `presets`) and not offered.223224## Launch arguments (Debug and Release)225226Only honoured when given. `-AppleLanguages` / `-AppleLocale` pass through (this Mac is French: use227`-AppleLanguages "(en)" -AppleLocale en_US` for English).228229| Argument | Effect |230|---|---|231| `-ORIXSection <id>` | Section at launch: `convert`, `qualityLab`, `vectorStudio`, `flow`, `watchFolders`, `history`, `metadata`, `formats`; `settings` or `settings:<general\|performance\|privacy\|advanced\|about>` opens the Settings window |232| `-ORIXOpen <path>` | Repeatable. Files or folders ingested at launch (inspected when the section is `metadata`; opened by the studio when the section is `qualityLab`, `vectorStudio` or `flow`) |233| `-ORIXTarget <format>` or `<format>#<operation>` | Destination chosen for every group that can reach it (e.g. `png`, `pdf#pdf.merge`); in Quality Lab, the destination of the trial |234| `-ORIXOption key=value` | Repeatable. Quality Lab: option values of the trial (`quality=12`) |235| `-ORIXView <mode>` | Quality Lab: `sidebyside`, `split`, `original`, `result`, `difference`. Vector Studio: `original`, `vector`, `split`, `outline`, `nodes` |236| `-ORIXZoom <percent>`, `-ORIXCenter x,y` | Zoom of the studio canvas (100 = one image pixel per screen pixel) and the image point (0…1) at its centre |237| `-ORIXVectorMode <mode>` | Vector Studio: `logo`, `line-art`, `monochrome`, `illustration`, `icon`, `technical`, `high-detail` |238| `-ORIXWorkflow <id \| key \| name>` | Flow: workflow opened (built-in keys: `images-webp`, `pdf-ocr`, `media-branch`, `scans-pdf`, `large-photos`) |239| `-ORIXFlowRun YES` | Flow: run the opened workflow over the `-ORIXOpen` files; paths without an export step write to `-ORIXOutputDir` |240| `-ORIXSeedDemo YES` | With `-ORIXDataDir`: Flow gets two demonstration workflows (one valid, one with an impossible step); Watch Folders gets three rules on folders created under the data directory, real files are dropped and really converted |241| `-ORIXAutoStart YES` | Start converting once the launch files are analysed |242| `-ORIXOutputDir <dir>` | Results of the launch batch go to this folder |243| `-ORIXConflict ask\|keep\|skip` | Conflict policy of the launch batch |244| `-ORIXAppearance light\|dark` | Forces the appearance |245| `-ORIXWindowSize WxH` | Content size of the main window |246| `-ORIXDataDir <dir>` | Isolated settings, presets and history (sets `ORIX_CONVERT_SUPPORT_DIR` for the process) |247| `-ORIXPane prepare\|queue` | Pane of the Convert section |248| `-ORIXSelect first\|<format>` | Selects the first job / history entry, a staged group, or a format in Formats; in Flow, the step with that path (`2`, `2.then.1`) |249| `-ORIXPanel log\|options\|inspector` | Opens the log sheet of the first job / the side panel in narrow windows; `facts` (Quality Lab), `run` / `history` (Flow), `rule` (Watch Folders: the rule sheet) |250| `-ORIXShot <png>` + `-ORIXShotDelay <s>` | Draws the window (attached sheet or Settings window when relevant) into a PNG with `cacheDisplay`, then `exit(0)` |251| `-ORIXSelfTest YES` | Runs the end-to-end scenario, prints `SELFTEST` lines, exits 0 or 1 |252| `-ORIXMakeSamples <dir>` + `-ORIXSampleCount <n>` | Writes generated sample files (plus `n` bulk files), then exits |253| `-ORIXMakePreviewSamples <dir>` | Writes one generated file per kind of preview (torus OBJ, CSV, GeoJSON, SRT, a system font copy, a ZIP of them made by the archive engine), then exits |254| `-ORIXMakeStudioSamples <dir>` | Writes the studios' samples: a logo, a photo, a 50-megapixel photo (Core Graphics), a 6 s video and a 12 s audio file (bundled ffmpeg, through `BundledTools`), then exits |255| `-ORIXDumpEngineStrings <json>` | Writes the strings declared by the wired engines, then exits |256257Unattended modes (`-ORIXShot`, `-ORIXSelfTest`, `-ORIXMakeSamples`, `-ORIXMakeStudioSamples`, `-ORIXDumpEngineStrings`) switch the app to the258accessory activation policy and make its windows fully transparent and click-through: nothing appears on screen, no259focus is taken, no alert or notification is shown. `-ORIXSelfTest` without `-ORIXDataDir` uses a temporary data260folder: the user's data is never touched.261262## Screenshots263264`Scripts/shot.sh <out.png> <section> [light|dark] [extra arguments…]` wraps the arguments above (`ORIX_LANG=fr`,265`ORIX_SIZE`, `ORIX_DELAY`, `ORIX_DATA`, `ORIX_SAMPLES`). `Scripts/screenshots.sh [folder]` captures every built266section in both appearances on generated samples, running real conversions for the queue and history shots, and267every studio state (`20-…` Quality Lab, `30-…` Vector Studio, `40-…` Flow, `50-…` Watch Folders) on real trial268conversions, traces, workflow runs and watched folders. `ORIX_ONLY=studios` captures only those; `ORIX_LOOKS=dark`269one appearance. `ORIX_ONLY=previews` captures `60-…` to `73-…`: the preview surfaces, the archive workspace and the settings rows.270Because the window is never key, native controls (switches, list selection, window buttons) are drawn in their271inactive state; everything drawn by the design system is unaffected.272273## Self-test274275`Scripts/build.sh selftest` (or `-ORIXSelfTest YES`) runs `App/Sources/App/SelfTest.swift` inside the app, through the276same model code the UI calls, on files generated in a temporary folder: content analysis and grouping, wrong277extension, unrecognisable file, PDF → PNG with a password option (history rows written, the secret absent from every278stored file), merge with reordering, "keep both", images → one PDF, "ask" then skip, cancel (waiting and running),279source deleted before start, read-only destination, quit with jobs running, history search, Metadata Studio280inspection and discovered actions, a 500-file mixed drop, and the studios: JPEG + PNG combined into one PDF across281format groups; a Quality Lab trial PNG → JPEG (both bitmaps decoded, size ratio and PSNR measured, nothing written282next to the source, one trial folder kept after a re-run); a logo traced in Vector Studio and exported as SVG (path283elements, no `<image>`) and vector PDF; a built-in workflow run over three files with its outputs and history row;284a workflow with an impossible step refused; undo / redo; a password typed in a workflow absent from every stored285file; and a watch rule that picks up a dropped PNG, converts it, does not re-process its own output and stops286picking up when paused (this part waits on the watcher's two-second settle time: about 15 s). `SelfTestIntegration.swift` then runs one real conversion per wired engine (CSV ↔ Parquet, CSV ↔ XLSX, OBJ → GLB through the helper, WAV → MP3, video → MP4, Markdown → PDF, DOCX → PDF, SRT → VTT, TTF → WOFF2, GeoJSON → KML, PNG → WebP / HEIC / SVG), the generic archive capability through the workspace, archive passwords, the cross-component fixes, the presets, every kind of preview, the Services provider, `application(_:open:)`, the three App Intents, and prints where each helper tool and `libduckdb` were really loaded from (in Release every path must be inside the app bundle). Output: one `SELFTEST PASS|FAIL <name>` line per check287and `SELFTEST RESULT: PASS|FAIL (n passed, m failed)`; the exit status is 1 when a check fails.288289## Localization (en + fr-CA)290291- App strings: `L("English text")` / `L("… %@ … %lld", args)`. `Scripts/localize.py` (run by `build.sh generate`)292 extracts every key from `App/Sources` and writes `App/Resources/Localizable.xcstrings` with the French from293 `Scripts/translations-fr.json`. `Scripts/localize.py --check` fails when a key has no French.294- Engine strings (option labels, help, groups, choices, placeholders, units, operation titles, limitations, format295 names, warnings, errors, validation details, inspection fields) stay English in the engines and go through296 `LE("English text")`: exact lookup in `Engines.xcstrings`, then the patterns of `EnginePatterns.json` for297 interpolated messages (`%@` per interpolation; captures are looked up too; `%1$@` reorders), then the English text.298- `Scripts/build.sh strings` (= `localize.py --harvest`) refreshes `Scripts/engine-strings.json`: the built app dumps299 what its engines declare, and the sources of the wired packages are scanned for warning / error / validation /300 inspection / progress messages. French goes in `Scripts/translations-engines-fr.json`;301 `Scripts/localize.py --missing` lists what is not translated yet.302- Sizes, dates, numbers and durations use the `formatted()` APIs (`Fmt` in `L10n.swift`).303304## Accessibility305306Custom views carry labels, values and hints (format badges, progress, drop zone, job rows, decisions, summary; the307comparison canvas — adjustable: it moves the split —, the waveforms, the pixel inspector, the workflow cards with308their issues and named actions, rule cards and activity rows). The Prepare list, the Flow canvas and both canvases309take the keyboard (arrows, space, delete, ⌘D in Flow).310Colour is never the only signal: states, severities and fidelity pair a symbol and a word with their colour.311`ORIX.Palette` colours follow light / dark and switch to stronger values when Increase Contrast is on. Animations312(progress fill, drop highlight, indeterminate indicators) stop or become static with Reduce Motion.313