Files
Artstr-Studio/src/help/tool-text.md
T
thePR0M3TH3ANandClaude Opus 4.7 ef03f731d1 docs: audit pass — fix wrong shortcut + behaviour claims
Swept the help pages against the actual code paths and removed /
corrected claims that didn't ship.

vector-tools.md
- Removed: spacebar temp-pan, Alt duplicate-as-you-drag, generic
  Shift-constrain.
- Added: verified shortcuts (Cmd+Z/Y/D/C/X/V/G, Cmd+]/[ with
  Shift modifier, Cmd+J / Cmd+Alt+J in Pen edit mode,
  Delete/Backspace for layers + anchors).

tool-select.md
- Removed Cmd+A (not wired), Alt-drag-duplicate (not wired),
  Shift-constrain-axis drag (not wired), Cmd-click stack-walk
  (not wired). Kept the verified marquee + multi-select.

tool-direct-select.md
- Re-wrote anchor / handle interactions to match the actual hit-
  test branches (Alt-click anchor toggles kind in one click; Alt-
  drag a handle breaks symmetry; Alt-click segment inserts an
  anchor; plain drag of a segment bows it). Removed the "click an
  endpoint to continue drawing" claim — that's a Pen-only flow.

tool-hand.md
- Removed every fictional zoom shortcut (Cmd+wheel, Cmd+0,
  Cmd+= / Cmd+-). Documented the real zoom controls (−/+/Fit
  buttons + dropdown in the canvas toolbar). Spacebar reposition
  scoped correctly to the Pen tool only.

tool-pen.md
- Clarified that the Pen options pane has its own Fill / Stroke
  inputs (separate from any "Stroke panel" that doesn't actually
  exist).

tool-pencil.md
- Removed every claim that wasn't true: smoothing slider, Alt-drag
  append, auto-close. Pencil writes a plain polyline (M…L L L…),
  one layer per stroke. Tool options pane has only colour + width.

tool-shape.md
- Filled in the missing primitives (rounded-rect / circle /
  triangle — total 8, not 5). Removed Shift / Alt drag modifiers
  that aren't checked in startShapeDrag / commitShapeFromDrag.
  Added the small-drag → default-size fallback that the code does
  do.

tool-text.md
- Replaced the "drag a rectangle to size" claim with the actual
  click-to-place behaviour (placeTextWithTool drops a fixed-size
  box at the cursor + auto-flips to Select with the box focused).
  Softened the Cmd+B/I/U claims to "browser native rich-text
  shortcuts" since they're not wired in the app code.

tool-eyedropper.md
- Replaced the fictional "inline ⊙ buttons next to colour fields"
  with the real OS-colour-picker eyedropper that Chrome's native
  <input type="color"> shows.

panel-layers.md
- Removed Cmd+A select-all (not wired). Added Shift modifier to
  Cmd+]/[ for bring-to-front / send-to-back. Clarified that
  position units are inches in print modes, pixels in Custom Art
  / Slide / Deck (matches the unit toggle behaviour).

Co-Authored-By: Claude Opus 4.7 <[email protected]>
2026-06-04 09:32:11 -04:00

2.2 KiB

Text tool (T)

Drops a text layer. Drag to size the bounding box; the layer is created with contentEditable set so you can type immediately.

Creating

  • Click the canvas. A default-sized text box drops at the click point, the tool auto-flips back to Select, and the box's contentEditable area gains focus so you can start typing immediately. The placeholder text is pre-selected so your first keystroke replaces it.

Editing

A text layer's content is HTML (rich text). Inline marks are applied via the text-layer-options inline buttons (or the browser's native rich-text shortcuts when the contenteditable area has focus — browser behaviour differs):

  • Bold, italic, underline, strikethrough — via the inline toolbar buttons that appear with a text layer selected.
  • Inline link — use the link button in the layer-options pane to add a URL to selected text.

Block formatting:

  • Alignment (left / center / right) via the Alignment dropdown.
  • Font, size, colour via the Type options pane.

Right-side Type panel

When a text layer is selected:

  • Font family picker (system fonts + a vendored Google Fonts subset).
  • Font size + weight + style.
  • Colour (with the Eyedropper inline).
  • Letter spacing, line height.
  • Horizontal + vertical alignment within the box.
  • Padding (inset from the box edge).

Behaviour notes

  • Text rasterizes via the browser's font engine — what you see is what the PNG export captures. PDF export emits real PDF text for fonts on the embeddable allowlist (Times / Helvetica / Courier families); other fonts fall back to vector paths in the PDF.
  • Linked-design and pixel-art layers can sit on top of text without the text losing its editability.
  • For multi-page books, place body-text headings via the chapter editor's markdown (the reflow engine handles pagination there) — the Text tool is for designed-page captions / titles, not body.

Tips

  • A locked layer (lock icon in the Layers panel) refuses clicks — unlock first if a text box won't activate.
  • Token text ({page-number} etc) in a book master text layer resolves per-page. Token text in a designed-page text layer stays literal.