Wit

Roadmap

Where Wit is today and what comes next. Pre-1.0, breaking changes are allowed under 0.x with notes.

Status now

The language is feature-complete for its initial scope: nodes, definitions, additive partials, records, collections, data access, conditionals, iteration, and scripting all ship, along with two renderers (HTML and Markdown), a CLI, and a VS Code extension.

The milestone ladder

  • M0–M4 — foundations, language lock, the lexer and parser, and the resolver and expander. Shipped.
  • M5 — the VS Code extension core: highlighting, diagnostics, hover, go-to-definition, references, outline, and completion. Shipped.
  • M6 — the reference renderer: HTML from any expanded AST. Shipped.
  • M7 (1.0) — the bar for 1.0 is a docs site, published packages, and a versioned spec. This site is itself an M7 deliverable and a dogfood test.

In progress — the literal-node layer

A literal-content layer that builds toward a component system.

  • Shipped. Literal nodes (@@name … name@@) and frozen bodies (@@@ … @@@); {{path}} interpolation inside double-fence bodies, with single braces left literal so CSS works; and style and script raw-text rendering in the default render path.
  • Designed, not yet built. The component definition (##name … name##), a body parameter, interpolation in strings and normal content, capture scope with parameter defaults, and component-CSS deduplication.

VS Code extension roadmap

The extension core has shipped; the rest is committed future work, most of it exposing engine capability that already exists to the editor.

  • Quick wins. A live HTML preview panel, snippets for the preferred forms, code folding, a file icon, and palette commands.
  • Medium. Ctrl-clickable document links, rename-symbol, workspace symbol search, signature help, and quick-fix code actions.
  • Bigger bets. A formatter with format-on-save, embedded script highlighting inside the script bridge, a custom split editor, and marketplace publishing.

The value-per-effort priority is live preview, then snippets, then folding and the file icon, then document links and rename.

Deferred to v2

Non-ASCII handles, incremental reparse hooks, and a separate theme package are explicitly deferred. Two writer-delight candidates surfaced by onboarding are worth naming honestly as not yet shipped: a build watch mode and comma escaping inside record values.

What is not shipped

See also

Changelog

records what has actually shipped; Install covers the VS Code extension's current dev-install path.