archyne 0.3.0-alpha.1 → 0.3.2-alpha.1

package/README.md

@@ -9,8 +9,9 @@ A draw.io-style diagram editor with **two-way sync to Mermaid code**. Edit visua
 other. Because the document _is_ standard Mermaid, LLMs can generate, read, and
 modify your diagrams as plain text, and anything they produce opens on the canvas.
 
-Runs entirely in the browser — no server, no accounts, nothing leaves your machine.
-Self-host by serving the `dist/` folder from any static file server.
+Runs entirely on your own machine — in a browser, as a desktop app, or inside
+VS Code. No server, no accounts, nothing leaves it. Self-host by serving the
+`dist/` folder from any static file server.
 
 <p align="center">
   <a href="https://github.com/dariodd/archyne/actions/workflows/ci.yml"><img src="https://github.com/dariodd/archyne/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
@@ -30,6 +31,21 @@ npx archyne                 # opens http://localhost:4173
 npx archyne diagram.mmd     # …with a diagram already loaded
 ```
 
+Or inside the editor you already have open:
+
+```sh
+code --install-extension naxeris.archyne
+```
+
+Archyne registers as an optional editor for `.mmd`, so the file stays VS Code's
+— its dirty dot, its undo, its save, its diff against `HEAD`. A
+` ```mermaid ` block inside Markdown gets an **Open on canvas** action above the
+fence, which is where most Mermaid actually lives: the diagram is edited in
+place, and the rest of the document is left alone. It is on the
+[Marketplace](https://marketplace.visualstudio.com/items?itemName=naxeris.archyne)
+and on [Open VSX](https://open-vsx.org/extension/naxeris/archyne), for
+VSCodium, Cursor, Windsurf, Gitpod and Theia.
+
 Desktop builds for Windows, macOS and Linux are attached to every
 [release](https://github.com/dariodd/archyne/releases/latest). They are **not
 yet code-signed** — Windows warns, macOS needs one `xattr` command — and each
@@ -44,7 +60,7 @@ entirely.
 <tr>
 <td width="50%">
 <img src="docs/images/editor-architecture-dark.png" alt="An architecture diagram with vendor icons for Cloudflare, AWS, Node.js, Redis and Postgres, grouped inside a VPC" width="100%">
-<p align="center"><em>Architecture diagrams with 13 000+ searchable vendor icons</em></p>
+<p align="center"><em>Architecture diagrams with 16 000+ searchable vendor icons</em></p>
 </td>
 <td width="50%">
 <img src="docs/images/editor-sequence-dark.png" alt="A sequence diagram with participants, activations, a note and numbered messages" width="100%">
@@ -301,7 +317,9 @@ the other version.
 
 ## Current scope
 
-Five Mermaid diagram families, all with visual editing and two-way sync:
+Seven Mermaid diagram families, all with visual editing and two-way sync.
+Anything else Mermaid can draw — gantt, pie, mindmap, timeline — opens
+read-only, rendered rather than refused.
 
 - **Flowcharts** — all 14 vertex shapes, all edge stroke/arrow types,
   subgraphs as groups (create/dissolve from the toolbar), and full
@@ -317,7 +335,8 @@ Five Mermaid diagram families, all with visual editing and two-way sync:
   dotted relations.
 - **Sequence diagrams** — participants/actors as draggable columns with
   lifelines (drag horizontally to reorder), messages as ordered horizontal
-  arrows with all eight operators; reorder from the inspector. Notes and
+  arrows with all eight operators; drag a message by its grab strip to
+  reorder it, into or out of a block, or step it from the inspector. Notes and
   loop/alt/opt blocks are created from the palette (drop them at a row),
   renamed and deleted in place; par/critical/break blocks, activations, and
   autonumber are rendered and fully preserved through any canvas edit.
@@ -326,8 +345,8 @@ Five Mermaid diagram families, all with visual editing and two-way sync:
   architecture icons** are bundled (`azure:virtual-networks`, and the
   catalogue codes other tools write resolve too), alongside the Iconify
   `logos`, `devicon`, `carbon`, `tabler` and `simple-icons` collections:
-  16 600 icons, all searchable from the palette, nested groups for VPCs/subnets, junctions, and side-anchored
-  connections with per-end arrows. A vendor's own set — Azure's, AWS's —
+  more than 16 000 icons, all searchable from the palette, nested groups for
+  VPCs/subnets, junctions, and side-anchored connections with per-end arrows. A vendor's own set — Azure's, AWS's —
   can be **imported as SVGs**, from files or from a pasted link; the desktop
   build takes a whole `.zip`. Any of Iconify's ~200 000 icons can be pulled in
   the same way (`api.iconify.design/mdi/database.svg`). Imported icons are
@@ -386,7 +405,7 @@ names the five hosts that makes possible and nothing else — never
 Untrusted diagram text is held by two independent layers — Mermaid's
 sanitizer and the CSP — each verified separately in a real browser on every
 pull request. Accessibility is checked the same way: `axe` reports no WCAG
-2.2 AA violations across ten interface surfaces in both themes.
+2.2 AA violations across sixteen interface surfaces, in both themes.
 
 Two things stated up front rather than discovered later: the desktop
 installers are **not yet code-signed**, and the accessibility work is a
@@ -400,8 +419,8 @@ on request.
 listed in [THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md); all are compatible
 with MIT distribution (elkjs is EPL-2.0, consumed unmodified as a library;
 the Iconify collections are CC0/MIT/Apache-2.0, with depicted logos remaining
-their owners' trademarks). The full breakdown is also available in-app: click
-the Archyne logo.
+their owners' trademarks). The full breakdown is also available in-app, under
+**About Archyne** in the ⋯ menu.
 
 **One bundled thing is not MIT.** The 636 Azure architecture icons in
 `src/icons-azure.generated.json` are Microsoft's, shipped under