From 9eee720a8d820ac1a9ef3763a331a3669c4e9bc0 Mon Sep 17 00:00:00 2001 From: Kieron Lanning Date: Fri, 6 Nov 2026 13:20:31 +0000 Subject: [PATCH 1/2] docs: fix the retired roadmap link and a stale anchor --- docs/wiki/README.md | 1 - docs/wiki/guide/Plain-Astro.md | 2 +- 2 files changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/wiki/README.md b/docs/wiki/README.md index ea97004..faa014b 100644 --- a/docs/wiki/README.md +++ b/docs/wiki/README.md @@ -54,7 +54,6 @@ lists its own pages. | [guide](guide/README.md) | Using the plugin: getting started, fences, components, highlighting, icons, i18n, options. | | [contributing](contributing/README.md) | Changing it: the module map, the local workflow, CI and releases. | | [Troubleshooting](Troubleshooting.md) | The failures people actually hit. | -| [Roadmap](Roadmap.md) | What Phase 1 covers and what Phase 2 adds. | Start with [Getting Started](guide/Getting-Started.md) — a site with a diagram, in four files. diff --git a/docs/wiki/guide/Plain-Astro.md b/docs/wiki/guide/Plain-Astro.md index d1be21c..560ba44 100644 --- a/docs/wiki/guide/Plain-Astro.md +++ b/docs/wiki/guide/Plain-Astro.md @@ -82,7 +82,7 @@ export default defineEcConfig({ `likec4Language` is the grammar snapshot bundled with the package, so this needs no network. `await loadLikeC4Language({ ref: 'v1.60.0' })` fetches a different one when the config is asynchronous, and -[Syntax Highlighting](Syntax-Highlighting.md#pinning-the-grammar) covers the +[Syntax Highlighting](Syntax-Highlighting.md#choosing-a-version) covers the trade-off. ## What you give up From 462eeff97fb84088e381c1fc378d223106ddd77f Mon Sep 17 00:00:00 2001 From: Kieron Lanning Date: Fri, 6 Nov 2026 13:29:25 +0000 Subject: [PATCH 2/2] docs: keep machine paths out of the troubleshooting snippets --- docs/wiki/Troubleshooting.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/docs/wiki/Troubleshooting.md b/docs/wiki/Troubleshooting.md index 2dd7d1a..5a2f499 100644 --- a/docs/wiki/Troubleshooting.md +++ b/docs/wiki/Troubleshooting.md @@ -8,8 +8,8 @@ The frame renders, the page answers 200, `astro build` exits 0 — and every diagram still shows "Loading architecture diagram…". In the browser console: ``` -[astro-island] Error hydrating /node_modules/@purview-dev/astroc4/src/components/LikeC4ProjectView.tsx -SyntaxError: The requested module '/node_modules/react/compiler-runtime.js?v=…' +[astro-island] Error hydrating @purview-dev/astroc4/src/components/LikeC4ProjectView.tsx +SyntaxError: The requested module 'react/compiler-runtime.js?v=…' does not provide an export named 'c' ``` @@ -18,12 +18,12 @@ so it imports `c` from `react/compiler-runtime`. React 19 ships that entry point as CommonJS: ```js -// node_modules/react/compiler-runtime.js +// react/compiler-runtime.js module.exports = require('./cjs/react-compiler-runtime.development.js'); // exports.c = … ``` The island is `client:only="react"` and its source is in this package, so in -`astro dev` Vite can hand the browser `/node_modules/react/compiler-runtime.js` +`astro dev` Vite can hand the browser the `compiler-runtime.js` entry point as-is instead of pre-bundling it into an ES module with a named `c` export. The island then throws during hydration and stays on its `slot="fallback"` placeholder. **`astro build` bundles the dependency @@ -53,8 +53,9 @@ export default defineConfig({ }); ``` -Then delete `node_modules/.vite` (and any `.vite` cache under the site root) and -restart `astro dev`; the cache is why the failure can appear to come and go. +Then delete the `.vite` cache inside `node_modules` (and any `.vite` cache under +the site root) and restart `astro dev`; the cache is why the failure can appear +to come and go. Do not treat the other workarounds people reach for as fixes: `client:only` is already correct, pinning an older React or LikeC4 only hides the bug, and