diff --git a/.changeset/calm-upgrades-plan.md b/.changeset/calm-upgrades-plan.md deleted file mode 100644 index 4d6212a3..00000000 --- a/.changeset/calm-upgrades-plan.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -"@cloudflare/nimbus-docs": minor -"@cloudflare/create-nimbus-docs": patch ---- - -Add a versioned breaking-change manifest, explicit reviewed upgrade baselines, agent-readable migration plans, shared `check` and `outdated` diagnostics, safe starter drift updates, starter agent upgrade guidance, and automatic migration guidance during Astro configuration. diff --git a/.changeset/clean-routes-report.md b/.changeset/clean-routes-report.md deleted file mode 100644 index b4256974..00000000 --- a/.changeset/clean-routes-report.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -"@cloudflare/nimbus-docs": patch -"@cloudflare/create-nimbus-docs": patch ---- - -Allow user-owned Astro pages and scaffolded Markdown and `llms.txt` endpoints to use native rendering semantics while retaining entrypoint-aware checks for active Nimbus contracts and composing with unrelated integration routes. These dynamic endpoints now resolve their payloads when rendered on request. Endpoint helpers now live at `@cloudflare/nimbus-docs/agent-endpoints`; the existing `@cloudflare/nimbus-docs/publication` entrypoint remains supported. Sub-path sitemaps now list the deployment root once. diff --git a/.changeset/compact-api-field-icons.md b/.changeset/compact-api-field-icons.md deleted file mode 100644 index 6c2f8033..00000000 --- a/.changeset/compact-api-field-icons.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@cloudflare/create-nimbus-docs": patch ---- - -Reduce repeated API field-icon markup by sharing SVG paint settings in the existing field-list stylesheet. Preserve icon shapes, field content, links, and disclosure behavior. Existing sites can apply the owned component and stylesheet changes together; framework upgrades do not overwrite owned files. diff --git a/.changeset/preserve-authored-links.md b/.changeset/preserve-authored-links.md deleted file mode 100644 index c5899275..00000000 --- a/.changeset/preserve-authored-links.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -"@cloudflare/nimbus-docs": patch ---- - -Preserve authored root-relative links and unrelated source across Markdown and -MDX, including HTML containers, fenced examples, Unicode, and CRLF. Keep plain -Markdown unchanged when generating Markdown and agent endpoint output. diff --git a/.changeset/safe-admonition-titles.md b/.changeset/safe-admonition-titles.md deleted file mode 100644 index 8004aff9..00000000 --- a/.changeset/safe-admonition-titles.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -"@cloudflare/nimbus-docs": minor -"@cloudflare/create-nimbus-docs": patch ---- - -Render MDX admonitions with Sätteri's native directive parser, preserving nested -content, code examples, plain titles, aliases, and scoped opt-outs. Use -`markdown.mdastPlugins` and `markdown.hastPlugins` for native extensions. -Explicit incompatible processors must disable Nimbus admonitions, while Astro -MDX options continue to pass through unchanged. Native admonitions now apply to -`.mdx` only; review existing admonition directives in `.md` files. Astro 7.2.6 -or newer is required. diff --git a/.changeset/secure-astro-images.md b/.changeset/secure-astro-images.md deleted file mode 100644 index 90fec385..00000000 --- a/.changeset/secure-astro-images.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -"@cloudflare/create-nimbus-docs": patch -"@cloudflare/nimbus-docs": patch ---- - -Update generated projects to Astro 7.2.8 and align the Node adapter with Astro's updated runtime API. diff --git a/.changeset/stable-api-code-rail.md b/.changeset/stable-api-code-rail.md deleted file mode 100644 index 91e3ec37..00000000 --- a/.changeset/stable-api-code-rail.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"@cloudflare/create-nimbus-docs": patch ---- - -Reserve the desktop API code-rail column before streamed rail HTML arrives, preventing the main content from shifting sideways. Preserve mobile stacking, no-rail layouts, and custom rail width. Existing sites can copy the updated owned ApiLayout component if desired; updating the framework does not overwrite it. This prevents layout shift without making the rail arrive sooner. diff --git a/apps/www/nimbus.json b/apps/www/nimbus.json index 230eb550..7118197c 100644 --- a/apps/www/nimbus.json +++ b/apps/www/nimbus.json @@ -1,4 +1,4 @@ { "$schema": "https://nimbus-docs.com/schema/nimbus.json", - "lastReviewedNimbusVersion": "0.13.1" + "lastReviewedNimbusVersion": "0.14.0" } diff --git a/packages/create-nimbus-docs/CHANGELOG.md b/packages/create-nimbus-docs/CHANGELOG.md index 24e7f56a..a23455ac 100644 --- a/packages/create-nimbus-docs/CHANGELOG.md +++ b/packages/create-nimbus-docs/CHANGELOG.md @@ -1,5 +1,30 @@ # @cloudflare/create-nimbus-docs +## 0.7.4 + +### Patch Changes + +- [#129](https://github.com/cloudflare/nimbus/pull/129) [`3fd7d15`](https://github.com/cloudflare/nimbus/commit/3fd7d15581feedf1799735b3c71d54ee394b88d1) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Add a versioned breaking-change manifest, explicit reviewed upgrade baselines, agent-readable migration plans, shared `check` and `outdated` diagnostics, safe starter drift updates, starter agent upgrade guidance, and automatic migration guidance during Astro configuration. + +- [#122](https://github.com/cloudflare/nimbus/pull/122) [`4b51ebb`](https://github.com/cloudflare/nimbus/commit/4b51ebbab227449e271bbe5a627ecd796c1c9e02) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Allow user-owned Astro pages and scaffolded Markdown and `llms.txt` endpoints to use native rendering semantics while retaining entrypoint-aware checks for active Nimbus contracts and composing with unrelated integration routes. These dynamic endpoints now resolve their payloads when rendered on request. Endpoint helpers now live at `@cloudflare/nimbus-docs/agent-endpoints`; the existing `@cloudflare/nimbus-docs/publication` entrypoint remains supported. Sub-path sitemaps now list the deployment root once. + +- [#141](https://github.com/cloudflare/nimbus/pull/141) [`7790b7c`](https://github.com/cloudflare/nimbus/commit/7790b7c56d7cde72cdf8f05286f2313dd3ab95d8) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Reduce repeated API field-icon markup by sharing SVG paint settings in the existing field-list stylesheet. Preserve icon shapes, field content, links, and disclosure behavior. Existing sites can apply the owned component and stylesheet changes together; framework upgrades do not overwrite owned files. + +- [#139](https://github.com/cloudflare/nimbus/pull/139) [`ea8cd46`](https://github.com/cloudflare/nimbus/commit/ea8cd46ae8f3a607881f7b744f1a604305e59980) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Render MDX admonitions with Sätteri's native directive parser, preserving nested + content, code examples, plain titles, aliases, and scoped opt-outs. Use + `markdown.mdastPlugins` and `markdown.hastPlugins` for native extensions. + Explicit incompatible processors must disable Nimbus admonitions, while Astro + MDX options continue to pass through unchanged. Native admonitions now apply to + `.mdx` only; review existing admonition directives in `.md` files. Astro 7.2.6 + or newer is required. + +- [#137](https://github.com/cloudflare/nimbus/pull/137) [`728e753`](https://github.com/cloudflare/nimbus/commit/728e7536600e3e46f5ac9541291c70204f6d2d84) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Update generated projects to Astro 7.2.8 and align the Node adapter with Astro's updated runtime API. + +- [#140](https://github.com/cloudflare/nimbus/pull/140) [`a6ccf99`](https://github.com/cloudflare/nimbus/commit/a6ccf9902c7068166483edfa845da0f6189909d3) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Reserve the desktop API code-rail column before streamed rail HTML arrives, preventing the main content from shifting sideways. Preserve mobile stacking, no-rail layouts, and custom rail width. Existing sites can copy the updated owned ApiLayout component if desired; updating the framework does not overwrite it. This prevents layout shift without making the rail arrive sooner. + +- Updated dependencies [[`3fd7d15`](https://github.com/cloudflare/nimbus/commit/3fd7d15581feedf1799735b3c71d54ee394b88d1), [`4b51ebb`](https://github.com/cloudflare/nimbus/commit/4b51ebbab227449e271bbe5a627ecd796c1c9e02), [`3f7c16a`](https://github.com/cloudflare/nimbus/commit/3f7c16a45b3178c1fbd66e09a0c4375e690feec9), [`ea8cd46`](https://github.com/cloudflare/nimbus/commit/ea8cd46ae8f3a607881f7b744f1a604305e59980), [`728e753`](https://github.com/cloudflare/nimbus/commit/728e7536600e3e46f5ac9541291c70204f6d2d84)]: + - @cloudflare/nimbus-docs@0.14.0 + ## 0.7.3 ### Patch Changes diff --git a/packages/create-nimbus-docs/package.json b/packages/create-nimbus-docs/package.json index abf3e8a4..bbcd30f1 100644 --- a/packages/create-nimbus-docs/package.json +++ b/packages/create-nimbus-docs/package.json @@ -1,6 +1,6 @@ { "name": "@cloudflare/create-nimbus-docs", - "version": "0.7.3", + "version": "0.7.4", "private": false, "publishConfig": { "access": "public" diff --git a/packages/nimbus-docs/CHANGELOG.md b/packages/nimbus-docs/CHANGELOG.md index 2ef29242..309214bd 100644 --- a/packages/nimbus-docs/CHANGELOG.md +++ b/packages/nimbus-docs/CHANGELOG.md @@ -1,5 +1,29 @@ # @cloudflare/nimbus-docs +## 0.14.0 + +### Minor Changes + +- [#129](https://github.com/cloudflare/nimbus/pull/129) [`3fd7d15`](https://github.com/cloudflare/nimbus/commit/3fd7d15581feedf1799735b3c71d54ee394b88d1) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Add a versioned breaking-change manifest, explicit reviewed upgrade baselines, agent-readable migration plans, shared `check` and `outdated` diagnostics, safe starter drift updates, starter agent upgrade guidance, and automatic migration guidance during Astro configuration. + +- [#139](https://github.com/cloudflare/nimbus/pull/139) [`ea8cd46`](https://github.com/cloudflare/nimbus/commit/ea8cd46ae8f3a607881f7b744f1a604305e59980) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Render MDX admonitions with Sätteri's native directive parser, preserving nested + content, code examples, plain titles, aliases, and scoped opt-outs. Use + `markdown.mdastPlugins` and `markdown.hastPlugins` for native extensions. + Explicit incompatible processors must disable Nimbus admonitions, while Astro + MDX options continue to pass through unchanged. Native admonitions now apply to + `.mdx` only; review existing admonition directives in `.md` files. Astro 7.2.6 + or newer is required. + +### Patch Changes + +- [#122](https://github.com/cloudflare/nimbus/pull/122) [`4b51ebb`](https://github.com/cloudflare/nimbus/commit/4b51ebbab227449e271bbe5a627ecd796c1c9e02) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Allow user-owned Astro pages and scaffolded Markdown and `llms.txt` endpoints to use native rendering semantics while retaining entrypoint-aware checks for active Nimbus contracts and composing with unrelated integration routes. These dynamic endpoints now resolve their payloads when rendered on request. Endpoint helpers now live at `@cloudflare/nimbus-docs/agent-endpoints`; the existing `@cloudflare/nimbus-docs/publication` entrypoint remains supported. Sub-path sitemaps now list the deployment root once. + +- [#138](https://github.com/cloudflare/nimbus/pull/138) [`3f7c16a`](https://github.com/cloudflare/nimbus/commit/3f7c16a45b3178c1fbd66e09a0c4375e690feec9) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Preserve authored root-relative links and unrelated source across Markdown and + MDX, including HTML containers, fenced examples, Unicode, and CRLF. Keep plain + Markdown unchanged when generating Markdown and agent endpoint output. + +- [#137](https://github.com/cloudflare/nimbus/pull/137) [`728e753`](https://github.com/cloudflare/nimbus/commit/728e7536600e3e46f5ac9541291c70204f6d2d84) Thanks [@MohamedH1998](https://github.com/MohamedH1998)! - Update generated projects to Astro 7.2.8 and align the Node adapter with Astro's updated runtime API. + ## 0.13.1 ### Patch Changes diff --git a/packages/nimbus-docs/package.json b/packages/nimbus-docs/package.json index 84de7372..93cdce64 100644 --- a/packages/nimbus-docs/package.json +++ b/packages/nimbus-docs/package.json @@ -1,6 +1,6 @@ { "name": "@cloudflare/nimbus-docs", - "version": "0.13.1", + "version": "0.14.0", "private": false, "publishConfig": { "access": "public" diff --git a/packages/nimbus-docs/src/cli/_registry.generated.ts b/packages/nimbus-docs/src/cli/_registry.generated.ts index 90b9178e..71f914ce 100644 --- a/packages/nimbus-docs/src/cli/_registry.generated.ts +++ b/packages/nimbus-docs/src/cli/_registry.generated.ts @@ -27,7 +27,7 @@ export const REGISTRY_BASE_URL = "https://nimbus-docs.com/registry"; export const BUNDLED_INDEX: BundledIndex = { "version": 1, - "registryVersion": "0.13.1", + "registryVersion": "0.14.0", "items": { "cn": { "name": "cn", diff --git a/packages/nimbus-starter-source/nimbus.json b/packages/nimbus-starter-source/nimbus.json index 230eb550..7118197c 100644 --- a/packages/nimbus-starter-source/nimbus.json +++ b/packages/nimbus-starter-source/nimbus.json @@ -1,4 +1,4 @@ { "$schema": "https://nimbus-docs.com/schema/nimbus.json", - "lastReviewedNimbusVersion": "0.13.1" + "lastReviewedNimbusVersion": "0.14.0" }