Skip to content

Stylus 0.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 12 Oct 11:20
  • Public betas for macOS, Windows and Linux (2026-10-12), the way
    Coupler ships: GitHub Actions builds the Windows installers (NSIS and
    MSI) and the Linux .deb and .rpm on every version tag and publishes
    them to the version's GitHub release (dev between versions), and the
    Mac release script now builds a universal app (Apple Silicon and
    Intel), signed with the Developer ID, notarized and zipped for the
    same release. ansiapps.com links the newest files. The app's binary is
    now stylus (it was app), and the selection buttons' tooltips show
    Ctrl shortcuts off the Mac.

  • Frames and layers in the document model (2026-09-30): every
    document is now frames × layers in stylus-core (src/frames.rs),
    ready for Phase 3's timeline and Layers tab with no model or recovery
    format change. Frames can be added (a copy or blank), deleted, moved
    and given a hold time; layers added, deleted, shown and hidden, the
    same in every frame; each change is one undo step, and undoing a
    stroke on another frame shows that frame. Resize and the iCE switch
    cover every frame. Saving writes the frame shown, merged, and the
    save warning says so when there's more than one frame or layer. The
    crash-recovery snapshot is now version 2 and keeps every frame and
    layer (version 1 still opens). Fixed on the way: icy_engine skips
    writes to hidden or locked layers, so the model writes past that for
    undo, resize and the iCE switch, and drawing on a hidden or locked
    layer is refused instead of leaving an empty undo step.

  • View basics (2026-09-30): View → Fit Window shows the whole piece
    at once, Grid (⌘') draws the cell lines, Preview (⇧⌘P) hides the
    cursor, selection, grid and contrast marks to check a finished piece,
    and Describe Cell (⇧⌘D) reads the cell at the cursor to screen
    readers. The status bar names the font.

  • Measuring the editor's hot path (2026-09-30): stylus-core's
    stroke_bench example times a fast pencil drag in the core alone
    (about 3 µs a move on the M1). Dev builds time each pencil move from
    pointer to canvas and each IPC call, log them per stroke, and add
    Help → Measure Drawing Speed (dev), a scripted drag at 400%. None of
    it is in a release build. Measured on the M1: a fast drag at 400% is
    drawn within 7 ms a move (every move inside a 120 Hz frame), so the
    desktop editor stays on IPC.

  • Editing begins (Phase 1) (2026-09-30): the Viewer tab is now the Art
    workspace, where opened art can be edited and new art made.

    • New… (80×25, 80×50, 132×25, 160×25 or any size, iCE on or off).
    • Type at a cursor (arrows, Home/End, Page Up/Down, Backspace, Delete;
      Enter or Down on the last row adds a row), the Pencil (right-drag
      erases), Pick (or Option-click), and painting characters and colors,
      colors only or characters only.
    • Ten F-key character sets on F1–F10 and a clickable strip, a
      256-character picker, 16 color swatches, a status bar.
    • Undo and redo by stroke (⌘Z, ⇧⌘Z).
    • Save and Save As in ANSI, plain text, XBin, BIN, Artworx, iCE Draw
      and TundraDraw, through icy_engine. The dialog lists what the format
      would lose before saving, and won't save what it can't hold. SAUCE
      title, author, group and comments are written in one fresh record,
      keeping the file's date. Save asks the first time it would replace a
      file; a replaced file is written beside it and moved over it.
    • Opening, New or closing the window with unsaved changes asks first.
  • The drawing tools and selection (2026-09-30): Eraser, Line,
    Rectangle (outline or filled), Box (single or double lines), the
    Half-block brush (half-cell pixels, right-drag in the background color),
    and flood Fill join the Pencil. Shapes preview as the real art while
    dragged and undo in one step. Select drags a rectangle (or Shift+arrows,
    ⌘A), and the selection can be cut, copied, pasted (opaque or
    transparent, into any open document), moved by dragging, flipped (with
    ▌▐, ▀▄ and the box corners mirrored), filled and cleared. Single-letter
    tool keys work while not typing; Esc leaves Type.

  • Menu bar (2026-09-30): File, Edit, Draw, Select, Colors, View and
    Help, drawn from one command registry that also runs every shortcut
    and fills Help → Keyboard Shortcuts. Option plus a menu's letter opens
    it, and arrows move through it. The Art and Make workspaces and the
    gear sit at the bar's right; the editor's toolbar went into the menus
    (zoom and the render settings in View, iCE in Colors, the Amiga fonts
    in View for text files). The art's name, with • when unsaved, is in
    the window title and the status bar. X swaps the colors.

  • The macOS menu bar (2026-09-30) carries the same menus as the
    in-window bar, from the same command registry: the same items greyed
    out and ticked, ⌘ shortcuts shown, plus the app menu (About, Services,
    Hide, Quit) and the Window menu. In a text field or dialog, ⌘C, ⌘V, ⌘Z
    and ⌘A edit the text. Quit (⌘Q) now asks about unsaved changes, as
    closing the window does.

  • Recent files and crash recovery (2026-09-30): File → Open Recent
    (a submenu in both menu bars, with Clear Menu) and a Recent list on the
    empty screen hold the last ten files opened or saved; a file that's
    gone comes off the list when it fails to open. Unsaved changes are
    autosaved every 10 seconds to the app-data folder, never over the file,
    in a lossless snapshot (icy_engine's IcyDraw format plus the file's own
    SAUCE record, format and render settings). Saving, discarding or
    closing removes it; after a crash Stylus offers the art back at launch
    (and under File → Recover Unsaved Art…) with its changes unsaved and
    the original file untouched.

  • Export PNG (2026-09-30): File → Export PNG… (⇧⌘E) writes the art at
    its own pixel size, in 8- or 9-px cells, optionally stretched to the
    original screen's aspect, with a progress bar over the rows. It starts
    from how the art is shown and leaves the view as it was.

  • Contrast lint (2026-09-30): View → Check Contrast, on per
    document, lists in a new Problems tab every text cell under 4.5:1 and
    every graphic (symbols, shades, half blocks, line drawing) under 3:1
    against its background, grouped by color pair with the ratio and cell
    count, by the ANSIapps contrast rules. Failing cells are outlined on
    the art; choosing a row outlines its cells and moves the cursor there.
    Ratios use the colors the art shows (its palette, bold as bright,
    24-bit as is) and are checked again after every edit.

  • Amiga ASCII (2026-09-30): text files without SAUCE get a Font menu
    with the Amiga fonts, remembered per file type.

  • UTF-8 text files (2026-09-30) show their block characters (▀ ▄ █),
    which came out blank before.

  • Saving tested on real art (2026-09-30): scripts/roundtrip-corpus.sh
    saves every corpus file again and compares pixels. On 181 files: 353
    saves identical, 9 differing only where the save warned. It found
    icy_engine's color optimizer dropping look-alike rows from ANSI, so
    saves are now cell-exact, and a TundraDraw writer bug, written up in
    docs/upstream/icy_engine-tundra-initial-color.md and sent upstream as
    icy_tools#188.

  • The "77 rows" 162-column file is explained: its SAUCE asks for the EGA
    8×14 font, which Stylus uses and ansilove doesn't.

  • Roadmap (2026-09-30): docs/roadmap.md consolidates the two
    ANSI-editor feature surveys with the design notes into a four-phase
    rollout (open and draw, theme workshop, make and animate for 1.0,
    everywhere and beyond), and lists the survey features Stylus won't
    build and why.

  • UI design (2026-09-30): docs/ui-design.md adapts the ANSI editor
    UI survey to Stylus's phases and the ANSIapps theme: the Art, Make,
    Theme and Lab workspaces, the F-key strip, one Problems list, and a
    native macOS menu bar beside the in-window one. The roadmap moves the
    command palette and custom shortcuts to Phase 3 and adds a
    reference-image layer.

  • In-development warning (2026-09-30): on first run, before any
    window, a native dialog says Stylus is still in development. OK opens
    the app and is remembered (a marker file in the app-data folder);
    I'll Be Back. quits and asks again next launch. The main window is now
    created only after that (src-tauri/src/first_run.rs, after
    Diskette's).

  • Image to ANSI (2026-09-30): a new tab. Drop an image on the window
    (or choose one) and 36 open-source image-to-ANSI converters each turn
    it into an 80-column .ANS, shown side by side, each labelled with its
    project, repository, license and the settings used. Save one, or all
    into a folder (existing files are never replaced).

    • The converters are Rust ports in stylus-core/src/convert/, all
      under licenses that allow closed-source commercial use: KOAN.ansi,
      img2ansi (Wes Brown), libcaca, two png2ansis, ansify, ansir, CLImage,
      TerminalImageViewer, viuer, catimg, terminal-image, two imgcats,
      termpix, image-to-ansi, aimg, img2ansi (John McCabe, Jakob Westhoff),
      ansipx, asciimatics, term-image, Rich Pixels, img2txt, img2ansi
      (Bryan Matsuo), hiptext, ansize, ascii-image-converter, ASCII Magic,
      img2ansi (Lukas Beranek), tapciify, image-to-ascii, img_to_txt,
      chromatic, ANSI-art and ransid. Two carry a whole resizer:
      ImageMagick's (magick.rs) and stb_image_resize2's (stbir.rs).
    • Every one matches its original cell for cell on the test images
      except ansify (99.8%+, its k-d tree breaking ties its own way). The
      survey, exclusions and results are in
      docs/image-to-ansi-converters.md.
    • About lists every converter's and ported library's license in full.
  • icy_tools upgraded to da0d287 (2026-09-30), the TundraDraw fix
    from icy_tools#188: black text before a TundraDraw file's first color
    change no longer comes back light gray, so .TND saves are exact and
    back in the round-trip tests. The only other change since 2e4e2b1 is
    in Icy Term. License scan and the WebAssembly build rechecked.

  • icy_tools upgraded to 2e4e2b1 (2026-09-30), which has #187 as
    merged: DEL shows as ⌂ and 24-bit backgrounds stay put under iCE.
    BEL stays a control code, as icy_engine's maintainer chose, so files
    with BEL differ from ansilove's •. Rechecked on 128 files: all match
    except that BEL file and one 162-column wrapped file (older, still
    unexplained).

  • stylus-core now builds for WebAssembly with icy_engine's default
    features: the maintainer removed icy_net, zstd's C code and unrar
    from icy_engine's tree upstream (in place of our feature-flag
    proposal, icy_tools#186).

Unsigned: Windows' SmartScreen warns until the installers are code-signed.