Twoslash

Fast triage

What does the user need?
├─ Show an inferred type or resolved symbol
│  └─ references/notations.md -> query markers
├─ Show autocomplete or highlight a span
│  └─ references/notations.md -> query markers
├─ Hide setup, fixtures, or boilerplate
│  └─ references/patterns.md -> hidden-setup patterns
├─ Model multiple files or fake imports
│  └─ references/patterns.md -> multi-file patterns
├─ Show or validate diagnostics
│  └─ references/notations.md -> error flags
├─ Show emitted JS / .d.ts / source maps
│  └─ references/notations.md -> emit flags
└─ Explain provenance or edge options
   └─ references/source-index.md

Response workflow

1. Identify whether this is new authoring or review of an existing snippet.
2. Identify the teaching goal: type, completion, highlight, hidden setup, diagnostics, or emit.
3. Keep the rendered sample minimal; move scaffolding into cut regions or virtual files.
4. Add the smallest directive set that proves the point.
5. If errors are intentional, prefer exact validation with @errors over blanket suppression.
6. If the snippet is multi-file or emit-focused, verify the visible file is the one the reader actually needs.
7. Name the exact directives in the answer so the user can copy them directly.

Authoring defaults

• ^? for inferred or resolved types.
• ^| for completion lists; pair with @noErrors when the expression is intentionally unfinished.
• ^^^ for visual emphasis, not semantic explanation.
• ---cut--- or ---cut-before--- to hide setup above the visible snippet.
• ---cut-after--- or ---cut-start--- / ---cut-end--- to hide trailing or middle noise.
• @filename: to create virtual files, including fake node_modules/@types shims.

Reading Order

Scripts

In This Reference