[Epic] Editor feature set: object model, pens, image import, projects

[BernardJen]

Epic: Editor feature set

Tracking issue for the planned editor features. These are not independent — most depend on a shared object/scene model. This epic captures the recommended build order and dependencies.

Recommended build order

Phase 0 — Foundation

• Editing toolbar: select, copy/paste, and object manipulation #6 Editing toolbar: select, copy/paste, object manipulation
  • The keystone. Introduces a proper object/scene model (discrete objects with identity, transform, z-order). Almost everything below depends on it.

Phase 1 — Pens & medium

• Pen selection with characteristics (thickness, color) #2 Pen selection with characteristics (thickness, color)
• Multi-color plotting with pen-change / load-pen pauses #3 Multi-color plotting with pen-change pauses — depends on Pen selection with characteristics (thickness, color) #2
• Selectable background paper type #7 Selectable background paper type — depends on Editing toolbar: select, copy/paste, and object manipulation #6

Phase 2 — Content creation

• Draw basic shapes and text on the canvas #5 Draw basic shapes and text — depends on Editing toolbar: select, copy/paste, and object manipulation #6
  • Note: text needs single-line / Hershey-style fonts, not outline fonts.
• Replace PNG/SVG upload with an Image import wizard (5+ image-to-lines algorithms) #4 Image import wizard (split below) — depends on Editing toolbar: select, copy/paste, and object manipulation #6 (outputs objects into the scene)
  • Image import wizard — shell + adjust step + 2 algorithms #11 Image import wizard — shell + adjust + 2 algorithms
  • Image import wizard — additional conversion algorithms (reach 5+) #12 Image import wizard — additional algorithms (reach 5+)

Phase 3 — Persistence

• Save and load projects (local machine and Raspberry Pi) #8 Save and load projects (local + Pi) — do last; the project file format must serialize the object/pen/paper models, so build it after those stabilize

Independent / anytime

• Magnet placement recommendation and visualization #9 Magnet placement recommendation and visualization — advisory overlay, low risk

Key cross-cutting decision

The object/scene model introduced in #6 is the keystone: it defines the project file format (#8), what a pen attaches to (#2/#3), and what magnets check against (#9). Pin it down early.

[BernardJen]

Operations (independent)

• In-app updater (local machine and Raspberry Pi) #13 In-app updater (local + Pi) — independent of the editor work; mirrors the existing rsync/rebuild/restart flow. Can be built anytime.

[BernardJen]

Settings & packaging

• Persist app settings on the gateway (shared across clients) #14 Persist app settings on the gateway (shared across clients) — distinct from artwork session and from project save/load (Save and load projects (local machine and Raspberry Pi) #8). Relates to pens (Pen selection with characteristics (thickness, color) #2) and paper (Selectable background paper type #7).
• Package the app/daemon as a .deb #15 Package the app/daemon as a .deb — folds in gateway/install.sh; pairs with the updater (In-app updater (local machine and Raspberry Pi) #13).