fix: copy formatting

Author: grega

README.md

@@ -44,7 +44,7 @@ if (result) {
   // result.html is a ready-made snippet
   // or use result.title, result.summary, result.steps, result.patch, result.trace
 } else {
-  // no friendly explanation — show the original traceback as-is
+  // no friendly explanation - show the original traceback as-is
 }
 
 // if the trace reports an unhelpful source location (eg. Pyodide runs code as "<exec>"), pass file explicitly to override what's parsed from the trace:
@@ -70,7 +70,7 @@ See the [demo](docs/README.md) for a full set of examples.
 
 `result.html` is built to be accessible by default (with WCAG 2.1 AA in mind):
 
-- The whole explanation is one labelled group — `<div class="pfem" role="group" lang="…" aria-labelledby="…">`, named by its title, with `lang` taken from the copydeck so screen readers pronounce localised copy correctly (`3.1.2 Language of Parts`). `role="group"` (not a landmark) keeps things uncluttered when several explanations render on one page
+- The whole explanation is one labelled group: `<div class="pfem" role="group" lang="…" aria-labelledby="…">`, named by its title, with `lang` taken from the copydeck so screen readers pronounce localised copy correctly (`3.1.2 Language of Parts`). `role="group"` (not a landmark) keeps things uncluttered when several explanations render on one page
 - The title is deliberately not a heading. Heading level depends on the surrounding page outline, which a library can't know, so the title supplies the group's accessible name instead. If you want it in your heading outline, render your own heading from `result.title` and use `result.html` (or the structured fields) for the body
 - Code is marked up as code; inline tokens use `<code>` and blocks use `<pre><code>`
 - The suggested fix has a visible "Suggested fix" label; the original traceback stays in a native `<details>`/`<summary>`
@@ -162,14 +162,10 @@ The script:
 6. pushes the commits and tag, and
 7. creates a GitHub Release with notes generated from the commits/PRs since the previous tag.
 
-If `npm publish` fails, nothing is pushed — the script prints how to undo the local
+If `npm publish` fails, nothing is pushed - the script prints how to undo the local
 bump and retry.
 
 ### Prerequisites (one-time)
 
-- `npm login` — publishing uses your local npm credentials (the package publishes
-  publicly via `publishConfig.access: "public"`).
-- `gh auth login` — the GitHub Release is created with the `gh` CLI.
-
-Tests still run automatically on every push to `main` and on pull requests via
-[`.github/workflows/ci.yml`](.github/workflows/ci.yml).
+- `npm login`: publishing uses your local npm credentials (the package publishes publicly via `publishConfig.access: "public"`)
+- `gh auth login`: the GitHub Release is created with the `gh` CLI

docs/index.html

@@ -123,7 +123,7 @@ <h1>Python Friendly Error Messages - Demo</h1>
             }
             const result = friendlyExplain({ error: parsedTrace, code: example.code });
             if (!result) {
-              throw new Error('No friendly mapping for this error — nothing to show.');
+              throw new Error('No friendly mapping for this error - nothing to show.');
             }
             processedExamples.push({ example, trace, result, error: null });
           } catch (err) {

docs/styles.css

@@ -128,7 +128,6 @@ h1 {
   line-height: 1.6;
 }
 
-/* inline code tokens share a monospace pill; the tint varies by token type */
 .pfem__var,
 .pfem__code,
 .pfem__file {
@@ -138,20 +137,17 @@ h1 {
   border-radius: 0.25rem;
 }
 
-/* variable names & the offending code line — purple */
 .pfem__var,
 .pfem__code {
   background: #efe8ff;
   color: #5b3f99;
 }
 
-/* file name — teal */
 .pfem__file {
   background: #e0f2f1;
   color: #00695c;
 }
 
-/* line-number token — not code, so a proportional pill in a warm amber */
 .pfem__line {
   font-weight: 600;
   font-size: 0.9em;
@@ -353,7 +349,7 @@ h1 {
 }
 
 /* ═══════════════════════════════════════════════════════════
-   Anatomy page — docs/anatomy.html
+   Anatomy page - docs/anatomy.html
    ═══════════════════════════════════════════════════════════ */
 
 :root {
@@ -369,14 +365,12 @@ h1 {
   --err: #db0b0b;
 }
 
-/* ── Page ── */
 .anatomy {
   max-width: 64rem;
   margin: 0 auto;
   padding: 1.25rem 1.5rem 1.5rem;
 }
 
-/* ── Back link ── */
 .anatomy__back {
   display: inline-flex;
   align-items: center;
@@ -392,7 +386,6 @@ h1 {
   color: #111827;
 }
 
-/* ── Header ── */
 .anatomy__header {
   text-align: center;
   margin-bottom: 1.25rem;
@@ -416,7 +409,6 @@ h1 {
   margin: 0 auto;
 }
 
-/* ── Two-column layout ── */
 .anatomy__main {
   display: grid;
   grid-template-columns: 1fr 21rem;
@@ -429,7 +421,6 @@ h1 {
   top: 1.25rem;
 }
 
-/* ── Traceback context strip ── */
 .anatomy__context {
   background: #fff;
   border-radius: 0.75rem 0.75rem 0 0;
@@ -456,7 +447,6 @@ h1 {
   line-height: 1.6;
 }
 
-/* ── Error card ── */
 .anatomy__card {
   background: #fff;
   border-radius: 0 0 0.75rem 0.75rem;
@@ -465,7 +455,6 @@ h1 {
   margin-bottom: 0;
 }
 
-/* ── Stage ── */
 .anatomy__zone {
   padding: 0.875rem 1.125rem;
   border-left: 4px solid #e5e7eb;
@@ -536,7 +525,6 @@ h1 {
 .anatomy__zone[data-zone="3"].is-revealed .anatomy__zone-tag { color: var(--z2-light); }
 .anatomy__zone[data-zone="4"].is-revealed .anatomy__zone-tag { color: var(--z4-light); }
 
-/* Stage body reveal animation */
 .anatomy__zone-body {
   transition: opacity 0.45s ease, filter 0.45s ease, transform 0.45s ease;
 }
@@ -559,15 +547,13 @@ h1 {
   animation: zoneIn 0.45s ease forwards;
 }
 
-/* pfem overrides inside stages */
 .anatomy__zone .pfem__title   { font-size: 1rem; margin-bottom: 0.35rem; }
 .anatomy__zone .pfem__summary { margin-bottom: 0; font-size: 0.9rem; }
 .anatomy__zone .pfem__why     { margin: 0; border-radius: 0.375rem; padding: 0.625rem 0.875rem; }
 .anatomy__zone .pfem__patch   { margin: 0; padding: 0.625rem 0.875rem; }
 .anatomy__zone .pfem__steps   { margin: 0; }
 .anatomy__zone .pfem__steps li { font-size: 0.9rem; margin-bottom: 0.25rem; }
 
-/* ── Description panel ── */
 .anatomy__desc {
   background: #fff;
   border-radius: 0.75rem;
@@ -592,7 +578,6 @@ h1 {
   line-height: 1.65;
 }
 
-/* ── Controls ── */
 .anatomy__controls {
   display: flex;
   align-items: center;
@@ -628,7 +613,6 @@ h1 {
 .anatomy__btn--ghost { background: transparent; color: #9ca3af; font-weight: 500; }
 .anatomy__btn--ghost:hover { color: #6b7280; }
 
-/* ── Print: reveal everything ── */
 @media print {
   .anatomy__controls { display: none; }
   .anatomy__zone-body { opacity: 1 !important; filter: none !important; transform: none !important; }

scripts/import_copydeck_csv.py

@@ -4,7 +4,7 @@
 Reads a reviewed CSV (originally produced by export_copydeck_csv.py, then edited
 in a spreadsheet) and updates title/summary/why/steps for each variant, writing
 the result to a JSON file. The original if_condition and any other metadata are
-preserved from the source copydeck — reviewers cannot change match logic.
+preserved from the source copydeck - reviewers cannot change match logic.
 
 The reader tolerates the mutations a spreadsheet round-trip introduces:
   * blank rows above the header (e.g. a frozen spacer row)

src/engine.ts

@@ -152,7 +152,7 @@ export const friendlyExplain = (opts: ExplainOptions): ExplainResult | null => {
   const code = opts.code;
 
   const trace = coerceTrace(opts.error, code, opts.runtime);
-  // The error could not be parsed — no friendly explanation; caller uses the raw error
+  // The error could not be parsed - no friendly explanation; caller uses the raw error
   if (!trace) return null;
 
   // Caller-provided file/line take precedence over whatever was parsed from the trace