@particle-academy/fancy-code 0.15.1 → 0.17.0

package/CHANGELOG.md

@@ -14,6 +14,59 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-11-13
+
+### Changed
+
+- **Releases need a lab-run certificate.** `publish.yml` gains a read-only
+  `lab-certificate` job that every publishing job needs: a tag is published only
+  when the fancy-labs lab has certified that exact version and commit. Consumers
+  do nothing; this changes how releases are cut, not what the package does.
+
+### Fixed
+
+- **The editing textarea of `CodeEditor`, `FileViewer` and `MarkdownEditor`
+  shows a focus ring.** It was `outline-none` with nothing in its place, so a
+  keyboard user could not see where focus was. It now carries the kit ring
+  (`focus-visible:ring-2 ring-inset`, `--fancy-focus` / `--fancy-focus-dark`) on
+  the textarea itself. Consumers do nothing.
+- **`FileViewer` (and any `readOnly` editor) no longer traps keyboard focus.**
+  Its key handler called `preventDefault` on every key except copy and
+  select-all, Tab included, so focus could never leave and the caret could not
+  move. Read-only now intercepts nothing; the textarea's `readOnly` attribute
+  already refuses edits.
+- **Editable `CodeEditor` and `MarkdownEditor` no longer trap keyboard focus
+  (WCAG 2.1.2).** Tab always inserted indentation, so tabbing in meant never
+  tabbing out. Tab / Shift+Tab now indent and dedent only once you have edited
+  in the current focus session (typed, pasted, pressed Enter); until then Tab
+  moves focus on. Escape disarms, so the next Tab leaves; blur disarms too.
+  **Behaviour change:** a Tab pressed straight after focusing the editor, with
+  no edit yet, now moves focus instead of indenting. Nothing to do unless you
+  relied on that; type first, and Tab indents as before.
+- **`CodeEditor`, `FileViewer` and `MarkdownEditor` can be named, and are named
+  by default** (axe `label`, critical, lab run 601, K28). The `<textarea>` a
+  person types into had no accessible name and none of the three accepted one.
+  Each now takes `aria-label`, `aria-labelledby` and `aria-describedby`, and
+  puts them on that textarea, not on a wrapper. Defaults: "Code editor",
+  the `filename` (else "File contents") for `FileViewer`, and "Markdown
+  editor". A `aria-labelledby` wins and suppresses the default label. Nothing
+  to do on upgrade; pass a name that says what the field is for, where you can.
+
+## [0.16.0] - 2026-11-02
+
+### Added
+
+- **Shell and dotenv highlighting.** `language="shell"` (aliases `sh`, `bash`, `zsh`) and `language="dotenv"` (alias `env`) are registered built-ins, and `FileViewer` now highlights `.sh` / `.bash` / `.zsh` files, shell rc files and `.env` / `.env.*` files, which it showed as plain text before.
+
+### Changed
+
+- **The tokenizers now come from `@particle-academy/fancy-file-commons`.** fancy-code's own copies of the JavaScript/TypeScript, PHP, Python, Go and Markdown grammars moved there unchanged (react-fancy's `CodeBlock` and `CodeView` now use the same ones), and fancy-code registers the shared functions. Highlighting is identical. `tokenizeMarkdown` is still exported from this package.
+- **The `@particle-academy/fancy-file-commons` range floor rose from `>=0.2` to `>=0.4`** (still `<2.0`): 0.4 is the first release that ships these grammars. npm installs it for you. **Consumer action:** none.
+
+### Fixed
+
+- **PHP with an unterminated `<!--` before a `<?php` tag no longer shows text twice.** The fix is in fancy-file-commons' `highlightCode`, which now trims a token that overlaps the one before it.
+
 ## [0.15.1] - 2026-11-01
 
 ### Changed
@@ -182,7 +235,6 @@ renders exactly as before.
 
 These are the kit 0.5 platform floors, applied across every package at once so a consumer never has to resolve a mix. **No API changed, nothing was removed, nothing was renamed** — only what the package requires.
 
-
 ## [0.9.1] — 2026-07-28
 
 ### Fixed

package/README.md

@@ -140,7 +140,7 @@ pnpm --filter @particle-academy/fancy-code clean    # Remove dist/
 ## At a Glance
 
 - **5 public exports** — `CodeEditor` (+ `Toolbar`, `Toolbar.Separator`, `Panel`, `StatusBar`) and the `useCodeEditor` hook
-- **6 built-in languages** — JavaScript, TypeScript, HTML, PHP, Python, Go
+- **9 built-in languages** — JavaScript, TypeScript, HTML, PHP, Python, Go, Markdown, Shell, Dotenv (grammars shared from `@particle-academy/fancy-file-commons`)
 - **3 built-in themes** — `light`, `dark`, `auto` (follows `prefers-color-scheme`)
 - **Zero third-party dependencies** — custom engine, no Monaco / CodeMirror / Shiki
 - **IDE-ready** — pairs with `TreeNav` from `@particle-academy/react-fancy` for full IDE layouts; see [docs/CodeEditor.md](./docs/CodeEditor.md) for an example.