@liminis/editor 0.3.0 → 0.4.1

package/docs/architecture.md

@@ -0,0 +1,80 @@
+# Architecture
+
+Which entry point to import, what each one costs you, and where the boundary
+between this package and its host actually falls.
+
+## The package and the world around it
+
+`@liminis/editor` is a component, not an application. It has no storage, no file
+dialogs, no network, and no opinion about where a document came from. Everything
+it needs from its environment arrives through the host seam as an injected
+function with a working default, so `<Editor>` renders in a host that supplies
+nothing at all — and a host that supplies everything gets an editor wired into
+its own file system, its own clipboard, and its own annotation store.
+
+```c4 static height=24rem
+Person(author, "Author", "Writes and edits markdown documents")
+
+System_Boundary(host, "Host application") {
+  Container(shell, "Host shell", "Electron or browser", "Owns documents, storage and windows. Supplies the seam.")
+  Container(editor, "@liminis/editor", "React + Lexical", "The editing surface, the markdown pipeline and annotations")
+}
+
+System_Ext(store, "Document store", "Files, a database, a sync service — the host's concern, never this package's")
+
+Rel(author, shell, "Opens and edits documents")
+Rel(shell, editor, "Mounts <Editor>, injects host services")
+Rel(editor, shell, "Reports changes, requests services through the seam")
+Rel(shell, store, "Reads and writes")
+```
+<picture><source media="(prefers-color-scheme: dark)" srcset="./diagrams/architecture-1-dark.svg" /><img src="./diagrams/architecture-1.svg" alt="Diagram 1 from architecture.md" /></picture>
+
+The arrow that matters is the one from the editor back to the shell. It is not a
+callback bolted on for one feature; it is how every capability the editor cannot
+implement for itself is obtained. A host that ignores it still gets an editor,
+because every one of those services has a default.
+
+## Entry points
+
+The package is split so that a consumer pays only for what it imports. The
+divide that does the most work is `./headless`: it is DOM-free, which is what
+lets the Electron **main** process import it at all.
+
+```c4 static height=26rem
+Container_Boundary(pkg, "@liminis/editor") {
+  Component(main, ".", "React", "<Editor>, the host seam, the annotation UI")
+  Component(md, "./markdown", "mdast", "parseMarkdown / stringifyMarkdown, no editor mounted")
+  Component(ann, "./annotations", "TypeScript", "Range anchoring that survives edits")
+  Component(headless, "./headless", "DOM-free", "Safe in an Electron main process")
+  Component(nodes, "./nodes", "Lexical", "The custom node set, for a host building its own editor")
+}
+
+System_Ext(lexical, "Lexical", "Peer dependency — the editing engine")
+System_Ext(mdast, "mdast / micromark", "GFM, math, footnotes, definition lists, wiki-links")
+System_Ext(diagrams, "@liminis/diagrams", "Renders the C4 diagrams on this page")
+
+Rel(main, nodes, "Registers")
+Rel(main, md, "Parses and serialises through")
+Rel(main, ann, "Anchors annotations with")
+Rel(nodes, lexical, "Extends")
+Rel(md, mdast, "Built on")
+Rel(headless, diagrams, "Re-exports renderC4DiagramToSVG")
+Rel(headless, mdast, "Parses with")
+```
+<picture><source media="(prefers-color-scheme: dark)" srcset="./diagrams/architecture-2-dark.svg" /><img src="./diagrams/architecture-2.svg" alt="Diagram 2 from architecture.md" /></picture>
+
+`./headless` re-exporting `renderC4DiagramToSVG` is the reason the two packages
+appear together here: a C4 diagram in a document has to render in the main
+process too, where there is no DOM, and `@liminis/diagrams/server` is DOM-free
+for exactly that reason.
+
+## What this means when you install it
+
+- Importing `.` brings React and Lexical. That is the editor.
+- Importing `./markdown` or `./annotations` brings neither. They are ordinary
+  TypeScript over mdast, usable in a script or a server.
+- Importing `./headless` is a promise enforced by its own doc comment: nothing
+  reachable from it may touch `document`, `window`, or Lexical.
+- Lexical is a **peer** dependency. The host owns the version, because a host
+  that mounts its own Lexical plugins beside this editor must not end up with
+  two copies of it.

package/docs/decisions/adr-93-liminis-editor-defined-aliases.md

@@ -1,9 +1,10 @@
 # ADR-93: `--liminis-editor-*` Names Are Defined as Aliases of Their Legacy Names
 
 **Date:** 2026-08-20
-**Status:** Accepted
+**Status:** Accepted (amended by ADR-98 — see the note marked *Amended by ADR-98* below; the alias direction this ADR chose is reversed)
 **Supersedes:** none
 **Amends:** none
+**Amended by:** ADR-98 (#98 inverts this ADR's alias direction — the legacy names stop carrying the real defaults, and become shims to `--liminis-editor-*` instead)
 **Issue:** #93 (verveguy/liminis-editor)
 
 ## Context
@@ -61,6 +62,25 @@ anticipated by the plan:
 
 ## Decision
 
+> **Amended 2026-08-22 by ADR-98 (#98) — this clause no longer holds.** The
+> direction chosen here is reversed: `--liminis-editor-*` names now carry the
+> real defaults, and the legacy names below become one-line shims
+> (`<legacy>: var(--liminis-editor-x);`). This ADR's own reasoning for why
+> the *opposite* direction was unsafe — "adding `--liminis-editor-foreground:
+> <default>` unconditionally would resolve every consumption chain at the
+> new name before ever reaching the old one" — no longer applies once every
+> internal consumption site reads `--liminis-editor-*` only (ADR-98's FR-003),
+> which removes the nested legacy fallback this ADR's Decision explicitly
+> chose to leave in place. This also reverses this ADR's own non-breaking
+> guarantee below for one direction: a host that only *reads* a legacy name
+> still gets a real value (the shim resolves fine), but a host that only
+> *sets* a legacy name no longer themes the editor, since nothing internal
+> reads that name to pick the override up — verified empirically, not
+> assumed, and accepted as an intentional breaking change. See ADR-98's
+> "Verified, not assumed" section for the full rationale. The rest of this
+> section is kept as the historical record of what was decided and why in
+> 2026-08-20, not edited to match the new direction.
+
 **Legacy names keep carrying the real defaults. Each `--liminis-editor-*`
 name becomes a new declaration that reads its legacy name via `var()`** —
 `--liminis-editor-foreground: var(--vscode-foreground);` — added in a new
@@ -125,6 +145,13 @@ comment noting they are superseded by the new canonical default. The
 spec's Out of Scope section explicitly permits this as a side effect of
 choosing FR-001's value, not as a design goal in its own right.
 
+> **Amended 2026-08-22 by ADR-98 (#98) — this clause no longer holds.** Every
+> consumption site's nested legacy fallback, called "provably dead code"
+> below, is removed by ADR-98 — precisely because leaving it in place would
+> mean this package still textually reads the legacy vocabulary ADR-98's
+> FR-003 forbids. The "materially larger, coordinated change deferred out of
+> this issue's scope" this paragraph anticipated is ADR-98 itself.
+
 **Consumption sites are left untouched.** All 224 `styles.css` sites and 26
 `.tsx` sites keep their existing `var(--liminis-editor-x, var(--old-name-x, ...))`
 chains. Simplifying them to a single `var(--liminis-editor-x)` call was

package/docs/decisions/adr-98-invert-token-direction.md

@@ -0,0 +1,309 @@
+# ADR-98: Invert the Token Direction — `--liminis-editor-*` Carries the Values, Legacy Names Become Shims
+
+**Date:** 2026-08-22
+**Status:** Accepted
+**Supersedes:** none
+**Amends:** none
+**Issue:** #98 (verveguy/liminis-editor)
+
+## Context
+
+ADR-93 (#93) gave every `--liminis-editor-*` name a real `:root`/`.dark`
+declaration, but as a forward to its legacy name —
+`--liminis-editor-foreground: var(--vscode-foreground);`. The real values
+kept living on the legacy side. That was a deliberate, narrow fix for a
+narrow problem (a host reading `--liminis-editor-*` got nothing at all,
+zusammen#129); it was never the end state, and ADR-092's own "Not decided
+here" section named the inversion as an open item.
+
+The narrowness became a concrete defect. verveguy/zusammen#134 migrated its
+shadcn palette onto `--liminis-editor-*` and had to leave three tokens
+behind, because their aliases lead to a literal, not a value:
+`--liminis-editor-primary: var(--color-primary, #3b82f6)`,
+`--liminis-editor-errorForeground: var(--vscode-errorForeground, #f14c4c)`,
+`--liminis-editor-focus-border: var(--vscode-focus-border, #007acc)`. Wiring
+Zusammen's `--primary` to the first would have replaced its purple brand
+colour with an unrelated blue — a visible, app-wide regression, and not a
+Zusammen problem to work around: `--color-primary` has zero definitions in
+this package, so the alias never led anywhere real to begin with.
+
+**Verified against the current codebase, not the issue's approximate
+counts** (the spec's own Assumptions permit this — Implement diffs against
+real source, not the issue's illustrative numbers):
+
+- 59 `--liminis-editor-*` names are declared (the issue said 65).
+- 26 legacy names need a shim: 24 distinct `--vscode-*` names,
+  `--checkbox-border`, and `--editor-brand`.
+- The 61 `--slashmd-*` names need no shim — verified zero hits across both
+  `verveguy/zusammen` and `verveguy/liminis` (the one `slashmd` string that
+  does appear, `.slashmd-editor`, is an unrelated CSS class name). They are
+  upstream vocabulary no known consumer reads, so #98 deletes them outright.
+- `--slashmd-heading-color` is declared three times (twice in the `:root`/
+  `.dark` blocks ADR-93 left in place, once in `@media print`) but consumed
+  nowhere and has no `--liminis-editor-*` counterpart — dropped entirely,
+  including from the print block, rather than inventing one.
+- Exactly 10 `var(--color-*)` references exist in `src/`: 4 in the
+  `styles.css` alias block this ADR deletes, and 6 in `C4Component.tsx`
+  (the C4 diagram layout-toggle buttons) — the only place
+  `--color-primary`/`--color-muted-foreground`/their `-100` variants are
+  read anywhere in this package.
+
+## Decision
+
+**Invert the direction.** Each `--liminis-editor-*` name now carries its own
+literal (or, for two names, a value built only from another
+`--liminis-editor-*` name) at `:root`/`.dark`. Each of the 26 legacy names
+above becomes a one-line shim, `<legacy>: var(--liminis-editor-x);`, in a
+new `:root`-only block — no `.dark` duplicate is needed, since
+`var(--liminis-editor-x)` re-resolves against whichever cascade value is
+active at the point of use, the same reasoning ADR-93 already relied on in
+the opposite direction. **The physical structure of `styles.css`'s two
+blocks swaps roles, not position**, so the diff reads as "these two blocks
+traded places" rather than a scrambled rewrite.
+
+### Verified, not assumed: the shim preserves reads, not writes
+
+The issue asked for this to be verified, not assumed, and it was — with a
+real, corrected finding, not a confirmation of the original premise. The
+issue's own proposed mechanism claimed a host *setting* only a legacy name
+would still theme the editor, "because the package consumes
+`--liminis-editor-foreground` and the host's declaration wins by cascade."
+That is false, and checking it (a static HTML fixture opened in a real
+Chromium via Playwright's cached binary, then the same check repeated
+against `examples/electron/e2e/theming-aliases.spec.ts`'s running shell)
+shows why: a `var()` reference resolves the cascade of the *exact* property
+name written inside it. `--liminis-editor-foreground`'s own declaration is
+a literal, containing no reference to `--vscode-foreground` at all — so a
+host's override of `--vscode-foreground` changes what `--vscode-foreground`
+itself computes to, and nothing else. Nothing inside this package reads
+`--vscode-foreground`, so the override never reaches the editor. Two custom
+properties do not auto-synchronize; only a `var()` reference that names one
+inside the other's declaration creates any relationship between them, and
+here the reference runs one way only (legacy → new, in the shim), not both
+— a bidirectional shim (each side referencing the other via `var()`) is a
+CSS cycle, which the spec defines as producing a guaranteed-invalid value on
+*both* properties, so that was never an option either.
+
+**The corrected, accepted guarantee: a shim preserves reads, not writes.** A
+host that *reads* a legacy name (e.g. Zusammen's
+`--vscode-errorForeground`/`--vscode-focus-border`) still gets the real,
+current value, since the shim's `var(--liminis-editor-x)` reference resolves
+normally. A host that *sets* only a legacy name no longer themes the editor
+— this is accepted as an intentional breaking change (see CHANGELOG's
+`## Unreleased` / Breaking changes), not a regression to silently work
+around, because the only alternative (`--liminis-editor-x: var(--legacy-x,
+<literal>)`, checking the legacy name first at the *definition* site) would
+keep the legacy name in the resolution path for every one of the 26 shimmed
+tokens — reintroducing, in a new shape, the exact dependence on the legacy
+vocabulary this issue exists to remove. Measured directly: neither
+`liminis-app` nor Zusammen sets a legacy name today (`liminis-app` sets
+`--liminis-editor-primary`/`--liminis-editor-muted-foreground`; Zusammen
+only reads), so this break has no currently-known victim, and it is also
+`0.2.0`'s already-announced deprecation ("removed in a future major
+release") completing on schedule rather than early.
+`examples/electron/e2e/theming-aliases.spec.ts` pins both halves directly
+with `getComputedStyle` in a running Electron shell: a legacy-name read
+still resolves, and a legacy-name-only *write* no longer reaches the
+editor's computed style — a deliberate assertion of the new, documented
+behavior, not a gap left uncovered.
+
+**FR-003 ("no internal code may read a `--vscode-*`/`--slashmd-*`/
+`--checkbox-*` property") is taken literally.** All CSS and TSX consumption
+sites under `src/` lose their now-redundant nested `var(--legacy-x, …)`
+fallback, becoming a bare `var(--liminis-editor-x)`. Every name now has an
+unconditional default, so the fallback was provably dead weight, not a
+safety net — the same "provably dead code" ADR-93 left in place in the
+other direction, except this time removed, because leaving it would mean
+this package still textually reads the legacy vocabulary FR-003 forbids.
+The `@media print` block — an *internal* consumer, not a host — is migrated
+the same way, overriding `--liminis-editor-*` names directly.
+
+**`--liminis-editor-primary`/`-100` are brand-derived, not host-borrowed.**
+`--editor-brand` — this package's own, already-themed purple,
+`oklch(0.55 0.20 303)` light / `oklch(0.70 0.20 303)` dark — becomes
+`--liminis-editor-primary`'s value directly; no new public token name is
+invented. `--editor-brand` itself becomes a one-line shim,
+`--editor-brand: var(--liminis-editor-primary);`.
+`--liminis-editor-primary-100` becomes the same brand colour at 10% alpha,
+mirroring how the existing callout tokens already derive a tint from
+`--editor-brand`. This replaces the previous forward to liminis-app's
+`--color-primary`/`-100` (§the issue's point 3: "this looks like a defect
+introduced by #93 rather than a deliberate default") — this package never
+defined `--color-primary`, so that forward never had a real value behind
+it; a package-owned brand colour is a deliberate default the package
+actually owns.
+
+**`--color-primary`/`--color-muted-foreground`/their `-100` variants are not
+part of this package's legacy vocabulary and stay outside FR-003's
+forbidden list** (only `--vscode-*`/`--slashmd-*`/`--checkbox-*` are
+forbidden). liminis-app sets `--color-primary`/`--color-muted-foreground`
+today, and that override must keep working unmodified. Once
+`--liminis-editor-primary`'s *definition* no longer forwards to
+`--color-primary`, the only place left to preserve that override is
+`C4Component.tsx`'s own 6 consumption sites — so, uniquely, those sites are
+**not** simplified to a bare `var(--liminis-editor-x)` like every other
+site in this package. They are reordered to
+`var(--color-x, var(--liminis-editor-x))`, checking liminis-app's token
+first and falling back to this package's own default, dropping only the
+now-redundant third-level literal. **This is the one deliberate exception
+to "strip every legacy fallback," and it is the single highest-risk spot in
+this change** — a future pass that "simplifies" it to match every other
+call site would silently stop liminis-app's existing override from working.
+An inline comment at the site says so explicitly, not only this ADR.
+
+> **Amended 2026-08-22 (#101) — this exception is removed.** Measured
+> against both known consumers' current `main`, the two arms resolved
+> identically in liminis-app (`--color-primary` and `--liminis-editor-primary`
+> both trace to `var(--primary)`) and the `--color-*` arm was dead in
+> Zusammen (neither `--color-primary-100` nor `--color-muted-100` was ever
+> defined there). The fallback changed no observable outcome anywhere it was
+> deployed, while permanently coupling this package to a host's Tailwind
+> `@theme` namespace it does not define or control. `C4Component.tsx`'s six
+> sites now read `var(--liminis-editor-x)` only, the same as every other
+> consumption site; a host that wants to override the C4 diagram colours
+> sets `--liminis-editor-primary` and its siblings, exactly as it would for
+> any other token. This confirms the risk this ADR itself flagged above —
+> the "single highest-risk spot" and "permanent asymmetry" — rather than
+> contradicting it.
+
+**`PREVIOUS_NAME` in `scripts/lib/theming-tokens.mjs` drops its `-primary-100`/
+`-muted-foreground`/`-muted-100` entries** (they pointed at `--color-*`,
+which this package never defined — keeping them implied a migration
+relationship that never existed) **and repoints `-primary` at
+`--editor-brand`**, the name it now genuinely shims. The map's remaining
+entries (`--slashmd-*`, most `--vscode-*`) are kept as a historical
+migration record for the README's "Previous name" column, even though
+`--slashmd-*` itself is deleted — the record of what a token used to be
+called remains useful to a host migrating an old override, and nothing
+about deleting the definition requires deleting the history of the rename.
+
+**`resolvesToPreviousName()` is deleted, not just updated, and replaced with
+`LEGACY_SHIM_TARGET` + `resolvesToShimTarget()`.** The old guard's premise —
+a consumption-site fallback protects a host still supplying only the legacy
+name — is exactly what this ADR inverts: that protection now lives in the
+`:root` shim declaration, not at the consumption site. The new guard checks
+the new invariant directly: every one of the 26 legacy names in
+`LEGACY_SHIM_TARGET` is declared in `styles.css` as a one-line `var()`
+forward to its `--liminis-editor-*` target (FR-002), and — a second,
+independent check — nothing under `src/` contains `var(--vscode-`,
+`var(--slashmd-`, or `var(--checkbox-` at all (FR-003). A plain-text scan
+is sufficient for the second check and more robust than the old paren-depth
+-aware fallback check, because after this change there is no longer any
+legitimate reason for those substrings to appear inside a `var()` call
+anywhere in this package.
+
+**One side effect of the `C4Component.tsx` exception, not separately
+designed:** `scripts/lib/theming-tokens.mjs`'s `consumedTokens()` treats the
+outermost (depth-0) name in a `var()` fallback chain as the "primary"
+consumed name — the same logic ADR-93 relied on to keep alias declarations
+out of the consumed set. Since `var(--color-x, var(--liminis-editor-x))`'s
+outer argument is `--color-x`, that is now the name the README's generated
+table documents at those 4 token pairs, not `--liminis-editor-primary`/
+`-100`/`-muted-foreground`/`-muted-100` — those four remain fully real,
+declared defaults (verified by the baseline and by `defaultedTokens()`),
+just no longer the *documented-as-consumed* name at this one file's sites.
+`TOKEN_DESCRIPTIONS` gains four new entries for the `--color-*` names
+instead, describing the override relationship in both directions.
+
+## Consequences
+
+**Good:**
+
+- A host reading `--liminis-editor-*` now gets a real value in every case,
+  including the 23 aliases that previously baked a literal — the entire
+  point of this issue and the prerequisite for zusammen#134's read
+  migration (FR-001, SC-001).
+- A host supplying only a legacy name keeps *reading* a real value, verified
+  by `getComputedStyle` in a running Electron shell, not assumed from
+  cascade theory alone (FR-002, FR-003) — see "Verified, not assumed" above
+  for the corrected scope of this guarantee (reads, not writes).
+- `--liminis-editor-primary` now resolves to a value this package actually
+  owns, closing the defect the issue's point 3 named (FR-008).
+- The ADR-092 baseline guard now protects the 26 shim declarations the same
+  way it already protected every other definition — an accidental deletion
+  of a shim fails `pnpm test`, naming the token.
+- `--slashmd-*`'s 61 names are gone entirely — the largest single reduction
+  in this package's declared token surface since #51, with a verified
+  absence of consumers backing the removal, not a guess.
+
+**Bad / accepted:**
+
+- **A host that sets only a legacy name no longer themes the editor** — this
+  package's initial framing of this issue called the whole change
+  "non-breaking," and that framing was wrong for this one direction (see
+  "Verified, not assumed" above). Accepted because the only fix would keep
+  the legacy name in every shimmed token's resolution path, defeating the
+  purpose of the inversion, and because neither known consumer (`liminis-app`,
+  Zusammen) currently sets a legacy name — this is documented in the
+  CHANGELOG's `## Unreleased` / Breaking changes as of this decision.
+- **`--liminis-editor-primary`/`-100`'s new computed value is a real,
+  visible change** for anything relying on the old `#3b82f6`-derived default
+  rather than overriding it. This is out of this repository's control —
+  `zusammen`/`liminis-app` are separate repositories — but is a deliberate,
+  known consequence of FR-008, not an oversight, and is called out
+  prominently in the PR description.
+- **The `C4Component.tsx` `--color-*` exception is a permanent asymmetry** in
+  an otherwise uniform "every consumption site reads `--liminis-editor-*`
+  only" rule. It is the one place a future contributor could plausibly
+  "clean up" into a silent regression against liminis-app. The inline
+  comment at the site and this ADR are the two places that asymmetry is
+  recorded; there is no CI guard that would catch a well-intentioned but
+  wrong simplification here, because the wrong version is textually
+  indistinguishable from a normal consumption site.
+  > **Amended 2026-08-22 (#101) — removed.** The exception is gone; see the
+  > amendment in the Decision section above. `--color-*` is now forbidden
+  > under `src/` on the same footing as `--vscode-*`/`--slashmd-*`/
+  > `--checkbox-*`, with no per-file carve-out.
+- **The README's generated token table no longer lists
+  `--liminis-editor-primary`/`-100`/`-muted-foreground`/`-muted-100` as
+  their own rows** — `--color-primary`/`-100`/`-muted-foreground`/`-muted-100`
+  appear instead, as a direct consequence of which name is "outermost" in
+  `C4Component.tsx`'s reordered fallback chain (see Decision). The four
+  `--liminis-editor-*` names remain fully real, declared, overridable
+  defaults; they are simply not the *documented-as-consumed* name at this
+  one file's sites. A future contributor auditing "does every
+  `--liminis-editor-*` name have a row in the README" needs to know this
+  before treating the absence as a bug.
+- **`--editor-brand` was never itself part of `PREVIOUS_NAME`'s renamed-token
+  history before this change** (it had no consumption site to preserve a
+  fallback for), so its entry is new, not migrated — a minor asymmetry with
+  every other `PREVIOUS_NAME` entry, which all trace back to #51.
+
+**Neutral:**
+
+- `scripts/lib/theming-tokens.mjs`'s `consumptionSitesIn()`/
+  `isCustomPropertyDeclarationValue()` machinery (ADR-93) needed no change:
+  it is direction-agnostic, and correctly treats this ADR's new shim
+  declarations as declaration-side values, not consumption sites, the same
+  way it treated ADR-93's aliases.
+- `resolvesWithoutHost()` needed no change either: once every
+  `--liminis-editor-*` name has a real `:root`/`.dark` declaration, a bare
+  `var(--liminis-editor-x)` with no fallback resolves without a host by
+  construction — the guard's existing logic already covers this.
+
+## References
+
+- Issue #98 (this decision); ADR-092's "Not decided here," Item 3 — this
+  decision's direct origin
+- `docs/decisions/adr-93-liminis-editor-defined-aliases.md` — the decision
+  this one inverts; amended to note its alias direction is superseded here
+- `docs/decisions/adr-092.md` — the checked-in baseline guard this
+  decision's shim declarations and dropped `--slashmd-*` names are
+  reconciled against (`pnpm docs:theming-baseline`)
+- `docs/decisions/adr-087.md` — the consumption-side rename and
+  `PREVIOUS_NAME`/fallback design this decision's `resolvesToPreviousName()`
+  retirement supersedes for the definition side
+- `src/styles.css` — the swapped shim/definition blocks; the migrated
+  `@media print` block; the inline comment at `C4Component.tsx`'s
+  `--color-*` sites
+- `scripts/lib/theming-tokens.mjs` — `LEGACY_SHIM_TARGET`,
+  `resolvesToShimTarget()`, the adjusted `PREVIOUS_NAME`
+- `scripts/lib/theming-defined-tokens-baseline.json` — regenerated via
+  `pnpm docs:theming-baseline` (61 `--slashmd-*` removed, 13
+  previously-undeclared `--vscode-*` shims added)
+- `README.md`, "Theming: CSS custom properties" — regenerated table and
+  hand-rewritten prose describing the inverted mechanism
+- [verveguy/zusammen#134](https://github.com/verveguy/zusammen/issues/134) —
+  the downstream migration this decision unblocks
+- [verveguy/zusammen#129](https://github.com/verveguy/zusammen/issues/129) —
+  the earlier, narrower migration ADR-93 unblocked

package/docs/diagrams/architecture-1-dark.svg

@@ -0,0 +1 @@
+<svg width="1286" height="535" viewBox="-50 0 1286 535" xmlns="http://www.w3.org/2000/svg" data-diagram="c4" style="font-family:system-ui, -apple-system, sans-serif"><g class="boundaries-layer"><g><rect x="190" y="40" width="440" height="455" rx="8" ry="8" fill="#131619" stroke="#47657d" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="410" y="64" text-anchor="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Host application</text></g></g><g class="nodes-layer"><g><circle cx="50" cy="156" r="14" fill="#006b2d" stroke="#009848" stroke-width="1.5"></circle><rect x="30" y="174" width="40" height="30" rx="20" ry="8" fill="#006b2d" stroke="#009848" stroke-width="1.5"></rect><text x="50" y="232" text-anchor="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Author</text><text x="50" y="246" text-anchor="middle" fill="#d6d6d6" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7">Writes and edits ...</text></g><g><rect x="230" y="135" width="360" height="110" rx="8" ry="8" fill="#16191c" stroke="#0098e0" stroke-width="2.5" stroke-dasharray="none"></rect><text x="410" y="178" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Host shell</text><text x="410" y="194" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[Electron or browser]</text><text x="410" y="216" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="410" dy="0">Owns documents, storage and windows. Supplies the seam.</tspan></text></g><g><rect x="230" y="345" width="360" height="110" rx="8" ry="8" fill="#16191c" stroke="#0098e0" stroke-width="2.5" stroke-dasharray="none"></rect><text x="410" y="388" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/editor</text><text x="410" y="404" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[React + Lexical]</text><text x="410" y="426" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="410" dy="0">The editing surface, the markdown pipeline and</tspan><tspan x="410" dy="14">annotations</tspan></text></g><g><rect x="820" y="143" width="360" height="94" rx="8" ry="8" fill="#2d2d2d" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1000" y="184" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Document store</text><text x="1000" y="204" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1000" dy="0">Files, a database, a sync service — the host&#x27;s concern,</tspan><tspan x="1000" dy="14">never this package&#x27;s</tspan></text></g></g><g class="edges-layer"><g><path d="M 110 190 L 222 190" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="230,190 222,194 222,186" fill="#a7a7a7"></polygon><text x="170" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 170, 190)"><tspan x="170" y="194">Opens and edits documents</tspan></text></g><g><path d="M 397.5 245 L 397.5 337" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="397.5,345 393.5,337 401.5,337" fill="#a7a7a7"></polygon><rect x="387.5" y="285" width="20" height="20" rx="3" fill="#16191c" stroke="#a7a7a7" stroke-width="1.5"></rect><text x="397.5" y="299" text-anchor="middle" fill="#a7a7a7" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">B</text></g><g><path d="M 422.5 345 L 422.5 253" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="422.5,245 426.5,253 418.5,253" fill="#a7a7a7"></polygon><rect x="412.5" y="285" width="20" height="20" rx="3" fill="#16191c" stroke="#a7a7a7" stroke-width="1.5"></rect><text x="422.5" y="299" text-anchor="middle" fill="#a7a7a7" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">A</text></g><g><path d="M 590 190 L 653.6 190" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 756.4 190 L 812 190" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="820,190 812,194 812,186" fill="#a7a7a7"></polygon><text x="705" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 705, 190)"><tspan x="705" y="194">Reads and writes</tspan></text></g></g><g class="legend-layer"><g><rect x="920" y="20" width="18" height="18" rx="3" fill="#16191c" stroke="#a7a7a7" stroke-width="1.5"></rect><text x="929" y="33" text-anchor="middle" fill="#a7a7a7" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">A</text><text x="946" y="33" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif">Reports changes, requests services through the seam</text></g><g><rect x="920" y="44" width="18" height="18" rx="3" fill="#16191c" stroke="#a7a7a7" stroke-width="1.5"></rect><text x="929" y="57" text-anchor="middle" fill="#a7a7a7" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">B</text><text x="946" y="57" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif">Mounts &lt;Editor&gt;, injects host services</text></g></g></svg>

package/docs/diagrams/architecture-1.svg

@@ -0,0 +1 @@
+<svg width="1286" height="535" viewBox="-50 0 1286 535" xmlns="http://www.w3.org/2000/svg" data-diagram="c4" style="font-family:system-ui, -apple-system, sans-serif"><g class="boundaries-layer"><g><rect x="190" y="40" width="440" height="455" rx="8" ry="8" fill="#f4f7fb" stroke="#63869b" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="410" y="64" text-anchor="middle" fill="#3d3d3d" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Host application</text></g></g><g class="nodes-layer"><g><circle cx="50" cy="156" r="14" fill="#006b2d" stroke="#004b1e" stroke-width="1.5"></circle><rect x="30" y="174" width="40" height="30" rx="20" ry="8" fill="#006b2d" stroke="#004b1e" stroke-width="1.5"></rect><text x="50" y="232" text-anchor="middle" fill="#3d3d3d" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Author</text><text x="50" y="246" text-anchor="middle" fill="#3d3d3d" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7">Writes and edits ...</text></g><g><rect x="230" y="135" width="360" height="110" rx="8" ry="8" fill="#ffffff" stroke="#005998" stroke-width="2.5" stroke-dasharray="none"></rect><text x="410" y="178" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Host shell</text><text x="410" y="194" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[Electron or browser]</text><text x="410" y="216" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="410" dy="0">Owns documents, storage and windows. Supplies the seam.</tspan></text></g><g><rect x="230" y="345" width="360" height="110" rx="8" ry="8" fill="#ffffff" stroke="#005998" stroke-width="2.5" stroke-dasharray="none"></rect><text x="410" y="388" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/editor</text><text x="410" y="404" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[React + Lexical]</text><text x="410" y="426" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="410" dy="0">The editing surface, the markdown pipeline and</tspan><tspan x="410" dy="14">annotations</tspan></text></g><g><rect x="820" y="143" width="360" height="94" rx="8" ry="8" fill="#f0f4f8" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1000" y="184" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Document store</text><text x="1000" y="204" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1000" dy="0">Files, a database, a sync service — the host&#x27;s concern,</tspan><tspan x="1000" dy="14">never this package&#x27;s</tspan></text></g></g><g class="edges-layer"><g><path d="M 110 190 L 222 190" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="230,190 222,194 222,186" fill="#565656"></polygon><text x="170" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 170, 190)"><tspan x="170" y="194">Opens and edits documents</tspan></text></g><g><path d="M 397.5 245 L 397.5 337" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="397.5,345 393.5,337 401.5,337" fill="#565656"></polygon><rect x="387.5" y="285" width="20" height="20" rx="3" fill="#ffffff" stroke="#565656" stroke-width="1.5"></rect><text x="397.5" y="299" text-anchor="middle" fill="#565656" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">B</text></g><g><path d="M 422.5 345 L 422.5 253" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="422.5,245 426.5,253 418.5,253" fill="#565656"></polygon><rect x="412.5" y="285" width="20" height="20" rx="3" fill="#ffffff" stroke="#565656" stroke-width="1.5"></rect><text x="422.5" y="299" text-anchor="middle" fill="#565656" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">A</text></g><g><path d="M 590 190 L 653.6 190" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 756.4 190 L 812 190" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="820,190 812,194 812,186" fill="#565656"></polygon><text x="705" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 705, 190)"><tspan x="705" y="194">Reads and writes</tspan></text></g></g><g class="legend-layer"><g><rect x="920" y="20" width="18" height="18" rx="3" fill="#ffffff" stroke="#565656" stroke-width="1.5"></rect><text x="929" y="33" text-anchor="middle" fill="#565656" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">A</text><text x="946" y="33" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif">Reports changes, requests services through the seam</text></g><g><rect x="920" y="44" width="18" height="18" rx="3" fill="#ffffff" stroke="#565656" stroke-width="1.5"></rect><text x="929" y="57" text-anchor="middle" fill="#565656" font-size="10" font-weight="600" font-family="system-ui, -apple-system, sans-serif">B</text><text x="946" y="57" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif">Mounts &lt;Editor&gt;, injects host services</text></g></g></svg>

package/docs/diagrams/architecture-2-dark.svg

@@ -0,0 +1 @@
+<svg width="1761" height="545" viewBox="0 0 1761 545" xmlns="http://www.w3.org/2000/svg" data-diagram="c4" style="font-family:system-ui, -apple-system, sans-serif"><g class="boundaries-layer"></g><g class="nodes-layer"><g><rect x="40" y="40" width="1105" height="455" rx="8" ry="8" fill="#131619" stroke="#47657d" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="592.5" y="64" text-anchor="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/editor</text></g><g><rect x="388" y="135" width="294" height="110" rx="4" ry="4" fill="#16191c" stroke="#2b89bf" stroke-width="2.5"></rect><text x="535" y="186" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">.</text><text x="535" y="202" text-anchor="middle" fill="#b2b2b2" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[React]</text></g><g><rect x="355" y="345" width="360" height="110" rx="4" ry="4" fill="#16191c" stroke="#2b89bf" stroke-width="2.5"></rect><text x="535" y="396" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./markdown</text><text x="535" y="412" text-anchor="middle" fill="#b2b2b2" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[mdast]</text></g><g><rect x="80" y="345" width="245" height="110" rx="4" ry="4" fill="#16191c" stroke="#2b89bf" stroke-width="2.5"></rect><text x="202.5" y="396" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./annotations</text><text x="202.5" y="412" text-anchor="middle" fill="#b2b2b2" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[TypeScript]</text></g><g><rect x="712" y="135" width="240" height="110" rx="4" ry="4" fill="#16191c" stroke="#2b89bf" stroke-width="2.5"></rect><text x="832" y="186" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./headless</text><text x="832" y="202" text-anchor="middle" fill="#b2b2b2" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[DOM-free]</text></g><g><rect x="745" y="345" width="360" height="110" rx="4" ry="4" fill="#16191c" stroke="#2b89bf" stroke-width="2.5"></rect><text x="925" y="396" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./nodes</text><text x="925" y="412" text-anchor="middle" fill="#b2b2b2" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[Lexical]</text></g><g><rect x="1371" y="411" width="252" height="94" rx="8" ry="8" fill="#2d2d2d" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1497" y="452" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Lexical</text><text x="1497" y="472" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1497" dy="0">Peer dependency — the editing engine</tspan></text></g><g><rect x="1371" y="277" width="350" height="94" rx="8" ry="8" fill="#2d2d2d" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1546" y="318" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">mdast / micromark</text><text x="1546" y="338" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1546" dy="0">GFM, math, footnotes, definition lists, wiki-links</tspan></text></g><g><rect x="1371" y="143" width="252" height="94" rx="8" ry="8" fill="#2d2d2d" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1497" y="184" text-anchor="middle" dominant-baseline="middle" fill="#d6d6d6" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/diagrams</text><text x="1497" y="204" text-anchor="middle" fill="#b2b2b2" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1497" dy="0">Renders the C4 diagrams on this page</tspan></text></g></g><g class="edges-layer"><g><path d="M 637.143 245 L 703.68 280.828" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 756.904 309.487 L 815.813 341.207" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="822.857,345 813.917,344.729 817.71,337.685" fill="#a7a7a7"></polygon><text x="730" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(28.301, 730, 295)"><tspan x="730" y="299">Registers</tspan></text></g><g><path d="M 535 245 L 535 287.2" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 535 304.2 L 535 337" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="535,345 531,337 539,337" fill="#a7a7a7"></polygon><text x="535" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 535, 295)"><tspan x="535" y="299">Parses and serialises through</tspan></text></g><g><path d="M 447.917 245 L 432.353 254.83" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 304.515 335.569 L 296.347 340.728" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="289.583,345 294.211,337.346 298.483,344.11" fill="#a7a7a7"></polygon><text x="368.75" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(-32.276, 368.75, 295)"><tspan x="368.75" y="299">Anchors annotations with</tspan></text></g><g><path d="M 1105 418.252 L 1214.019 429.306" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 1262.122 434.184 L 1363.041 444.417" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="1371,445.224 1362.637,448.397 1363.444,440.437" fill="#a7a7a7"></polygon><text x="1238" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(5.79, 1238, 431.738)"><tspan x="1238" y="435.738">Extends</tspan></text></g><g><path d="M 715 386.469 L 1015.824 363.855" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 1070.071 359.777 L 1363.023 337.755" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="1371,337.155 1363.322,341.743 1362.723,333.766" fill="#a7a7a7"></polygon><text x="1043" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(-4.299, 1043, 361.812)"><tspan x="1043" y="365.812">Built on</tspan></text></g><g><path d="M 952 190 L 1098 190" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 1225 190 L 1363 190" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="1371,190 1363,194 1363,186" fill="#a7a7a7"></polygon><text x="1161.5" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 1161.5, 190)"><tspan x="1161.5" y="183">Re-exports</tspan><tspan x="1161.5" y="197">renderC4DiagramToSVG</tspan></text></g><g><path d="M 952 212.521 L 1125.974 245.172" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><path d="M 1197.279 258.554 L 1363.137 289.681" fill="none" stroke="#a7a7a7" stroke-width="1.5"></path><polygon points="1371,291.157 1362.399,293.613 1363.875,285.75" fill="#a7a7a7"></polygon><text x="1161.5" text-anchor="middle" fill="#bebebe" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(10.629, 1161.5, 251.839)"><tspan x="1161.5" y="255.839">Parses with</tspan></text></g></g></svg>

package/docs/diagrams/architecture-2.svg

@@ -0,0 +1 @@
+<svg width="1761" height="545" viewBox="0 0 1761 545" xmlns="http://www.w3.org/2000/svg" data-diagram="c4" style="font-family:system-ui, -apple-system, sans-serif"><g class="boundaries-layer"></g><g class="nodes-layer"><g><rect x="40" y="40" width="1105" height="455" rx="8" ry="8" fill="#f4f7fb" stroke="#63869b" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="592.5" y="64" text-anchor="middle" fill="#3d3d3d" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/editor</text></g><g><rect x="388" y="135" width="294" height="110" rx="4" ry="4" fill="#f8f8f8" stroke="#0068a0" stroke-width="2.5"></rect><text x="535" y="186" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">.</text><text x="535" y="202" text-anchor="middle" fill="#626262" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[React]</text></g><g><rect x="355" y="345" width="360" height="110" rx="4" ry="4" fill="#f8f8f8" stroke="#0068a0" stroke-width="2.5"></rect><text x="535" y="396" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./markdown</text><text x="535" y="412" text-anchor="middle" fill="#626262" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[mdast]</text></g><g><rect x="80" y="345" width="245" height="110" rx="4" ry="4" fill="#f8f8f8" stroke="#0068a0" stroke-width="2.5"></rect><text x="202.5" y="396" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./annotations</text><text x="202.5" y="412" text-anchor="middle" fill="#626262" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[TypeScript]</text></g><g><rect x="712" y="135" width="240" height="110" rx="4" ry="4" fill="#f8f8f8" stroke="#0068a0" stroke-width="2.5"></rect><text x="832" y="186" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./headless</text><text x="832" y="202" text-anchor="middle" fill="#626262" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[DOM-free]</text></g><g><rect x="745" y="345" width="360" height="110" rx="4" ry="4" fill="#f8f8f8" stroke="#0068a0" stroke-width="2.5"></rect><text x="925" y="396" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="13" font-weight="500" font-family="system-ui, -apple-system, sans-serif">./nodes</text><text x="925" y="412" text-anchor="middle" fill="#626262" font-size="10" font-family="system-ui, -apple-system, sans-serif" opacity="0.8">[Lexical]</text></g><g><rect x="1371" y="411" width="252" height="94" rx="8" ry="8" fill="#f0f4f8" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1497" y="452" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">Lexical</text><text x="1497" y="472" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1497" dy="0">Peer dependency — the editing engine</tspan></text></g><g><rect x="1371" y="277" width="350" height="94" rx="8" ry="8" fill="#f0f4f8" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1546" y="318" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">mdast / micromark</text><text x="1546" y="338" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1546" dy="0">GFM, math, footnotes, definition lists, wiki-links</tspan></text></g><g><rect x="1371" y="143" width="252" height="94" rx="8" ry="8" fill="#f0f4f8" stroke="#667280" stroke-width="2.5" stroke-dasharray="8 4"></rect><text x="1497" y="184" text-anchor="middle" dominant-baseline="middle" fill="#303030" font-size="14" font-weight="600" font-family="system-ui, -apple-system, sans-serif">@liminis/diagrams</text><text x="1497" y="204" text-anchor="middle" fill="#626262" font-size="11" font-family="system-ui, -apple-system, sans-serif" opacity="0.7"><tspan x="1497" dy="0">Renders the C4 diagrams on this page</tspan></text></g></g><g class="edges-layer"><g><path d="M 637.143 245 L 703.68 280.828" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 756.904 309.487 L 815.813 341.207" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="822.857,345 813.917,344.729 817.71,337.685" fill="#565656"></polygon><text x="730" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(28.301, 730, 295)"><tspan x="730" y="299">Registers</tspan></text></g><g><path d="M 535 245 L 535 287.2" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 535 304.2 L 535 337" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="535,345 531,337 539,337" fill="#565656"></polygon><text x="535" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 535, 295)"><tspan x="535" y="299">Parses and serialises through</tspan></text></g><g><path d="M 447.917 245 L 432.353 254.83" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 304.515 335.569 L 296.347 340.728" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="289.583,345 294.211,337.346 298.483,344.11" fill="#565656"></polygon><text x="368.75" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(-32.276, 368.75, 295)"><tspan x="368.75" y="299">Anchors annotations with</tspan></text></g><g><path d="M 1105 418.252 L 1214.019 429.306" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 1262.122 434.184 L 1363.041 444.417" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="1371,445.224 1362.637,448.397 1363.444,440.437" fill="#565656"></polygon><text x="1238" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(5.79, 1238, 431.738)"><tspan x="1238" y="435.738">Extends</tspan></text></g><g><path d="M 715 386.469 L 1015.824 363.855" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 1070.071 359.777 L 1363.023 337.755" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="1371,337.155 1363.322,341.743 1362.723,333.766" fill="#565656"></polygon><text x="1043" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(-4.299, 1043, 361.812)"><tspan x="1043" y="365.812">Built on</tspan></text></g><g><path d="M 952 190 L 1098 190" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 1225 190 L 1363 190" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="1371,190 1363,194 1363,186" fill="#565656"></polygon><text x="1161.5" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(0, 1161.5, 190)"><tspan x="1161.5" y="183">Re-exports</tspan><tspan x="1161.5" y="197">renderC4DiagramToSVG</tspan></text></g><g><path d="M 952 212.521 L 1125.974 245.172" fill="none" stroke="#565656" stroke-width="1.5"></path><path d="M 1197.279 258.554 L 1363.137 289.681" fill="none" stroke="#565656" stroke-width="1.5"></path><polygon points="1371,291.157 1362.399,293.613 1363.875,285.75" fill="#565656"></polygon><text x="1161.5" text-anchor="middle" fill="#4a4a4a" font-size="11" font-family="system-ui, -apple-system, sans-serif" transform="rotate(10.629, 1161.5, 251.839)"><tspan x="1161.5" y="255.839">Parses with</tspan></text></g></g></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liminis/editor",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "//publishing": "Publishing is deliberate, never incidental. `private: true` was this package's guard until verveguy/liminis-editor#39 took the publish decision; it is gone because that decision was taken, not because it was tidied away. The guard is now `prepublishOnly` -> scripts/guard-publish.mjs, which refuses unless LIMINIS_ALLOW_PUBLISH=1 is set explicitly. That variable is set at step scope in .github/workflows/publish.yml and nowhere else, so a release is the only path that publishes. Note that `npm publish --dry-run` does NOT report a private package as blocked (npm 10.8.2), which is why the guard is a script rather than a flag.",
   "license": "MIT",
   "description": "Lexical-based markdown WYSIWYG editor with mdast round-trip and a host-injection seam",
@@ -99,7 +99,7 @@
     "react-dom": "^19.2.0"
   },
   "dependencies": {
-    "@dagrejs/dagre": "^3.0.0",
+    "@liminis/diagrams": "^0.1.5",
     "@mathjax/src": "^4.1.1",
     "lucide-react": "^1.11.0",
     "mdast-util-definition-list": "^2.0.0",

package/dist/app/editor/c4/C4InteractiveRenderer.d.ts

@@ -1,35 +0,0 @@
-/**
- * C4InteractiveRenderer - Interactive SVG renderer with drag support
- *
- * Wraps the C4Renderer with drag-and-drop functionality for manual layout mode.
- * Maintains local position state during drag and recalculates edges in real-time.
- */
-import type { C4Diagram } from './types.js';
-/** Synthetic ID used to store legend position in manual positions map */
-export declare const LEGEND_POSITION_ID = "__legend__";
-export interface C4InteractiveRendererProps {
-    /** Parsed C4 diagram */
-    diagram: C4Diagram;
-    /** Whether dark mode is enabled */
-    isDarkMode: boolean;
-    /** Whether edit mode (drag) is enabled */
-    isEditMode: boolean;
-    /** Current manual positions */
-    manualPositions: Record<string, {
-        x: number;
-        y: number;
-    }>;
-    /** Callback when positions change (during drag or on drag end) */
-    onPositionChange: (positions: Record<string, {
-        x: number;
-        y: number;
-    }>) => void;
-}
-/**
- * Interactive C4 diagram renderer with drag support.
- *
- * When isEditMode is true, nodes can be dragged to new positions.
- * Edges and boundaries are recalculated in real-time during drag.
- */
-export declare function C4InteractiveRenderer({ diagram, isDarkMode, isEditMode, manualPositions, onPositionChange, }: C4InteractiveRendererProps): JSX.Element;
-export default C4InteractiveRenderer;