Skip to content

fix(docs): list each package's category in its sidebar, ship the fonts, and style headings - #370

Merged
vite-hub[bot] merged 2 commits into
mainfrom
fix/docs-sidebar
Nov 6, 2026
Merged

vite-hub[bot] merged 2 commits into
mainfrom
fix/docs-sidebar

Conversation

@onmax

@onmax onmax commented Nov 6, 2026 •

Copy link
Copy Markdown
Owner

On comark-ui.onmax.me, every package page's sidebar shows a single link to the page you're on, so /diff reads as broken. Since #369 the fonts also ship as 0-byte files, and page headings render as 16px body text.

Sidebar: each package is a section with one page, and @vite-hub/docs lists only the current section's pages. A pnpm patch backports vite-hub/vitehub#3559, which lists the sections of the category instead, so /diff shows the 20 Review blocks with Diff active. Packages with several pages, like the linter, keep their own list. patches/README.md says when to drop the patch. While there, Annotate's rail item drew no icon, because Lucide has no scribble-loop. docs/content.ts now maps it to pen-tool, as the landing's package grid already does.

Fonts: Nuxt UI 4.12 depends on @nuxt/fonts 0.14, which writes an empty placeholder for each font and fills it in Nitro's rollup:before hook. Nitro 3 never runs that hook. This overrides Nuxt UI's dependency to @nuxt/fonts ^1.2.0, which downloads the fonts when Vite closes the bundle.

Headings: comark-links renders the docs' h2 to h4, so @comark/vue picks its H2 over Nuxt UI's ProseH2. DocsMarkdown.vue now gives them ProseH2's sizes and margins.

I checked a local pnpm docs:build. All 36 font files have bytes and every url() resolves. On /diff, Geist loads, "Features" is 24px/700, and the sidebar lists Review blocks, both on a direct load and after clicking from /code. vp check on the changed files, test/site.test.ts, and pnpm install --frozen-lockfile pass. I didn't run the full pnpm ready, and I haven't seen a deploy.

Nitro 3 never calls rollup:before, where @nuxt/fonts 0.14 fills its font files, so every /_fonts file deployed empty since #369. Nuxt UI's dependency on it now resolves to 1.2, which downloads the fonts when Vite closes the bundle.

comark-links draws the docs' headings, so Nuxt UI's ProseH2 never styles them and they rendered as 16px body text. The docs app now gives them ProseH2's sizes and spacing.
@chatgpt-codex-connector

Copy link
Copy Markdown
Codex Review Summary: ❌ Failed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ❌ Failed 2026-11-06T15:44:23.291385Z
We couldn’t complete this review. Comment @codex review to try again.
7c5d882 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes Reviewed the docs font-build dependency override and the top-level Markdown heading styling introduced in 7c5d882.

  • Font emission — Overrides Nuxt UI's legacy @nuxt/fonts dependency with the Nitro 3-compatible 1.2 release and updates the resolved font toolchain.
  • Page heading styles — Restores Nuxt UI-equivalent H2-H4 typography and spacing for both plain headings and comark-links anchor rows while excluding nested example content.
  • Compatibility and verification — Confirmed the new dependency's Node and Nuxt integration constraints fit this repository, traced the rendered heading structure and selector scope, and reran test/site.test.ts successfully.

Pullfrog  | View workflow run | Using gpt-5.6-sol | 𝕏

@pkg-pr-new

pkg-pr-new Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

Open in StackBlitz

comark-annotate

pnpm add https://pkg.pr.new/comark-annotate@370

comark-badge

pnpm add https://pkg.pr.new/comark-badge@370

comark-cards

pnpm add https://pkg.pr.new/comark-cards@370

comark-carousel

pnpm add https://pkg.pr.new/comark-carousel@370

comark-cast

pnpm add https://pkg.pr.new/comark-cast@370

comark-charts

pnpm add https://pkg.pr.new/comark-charts@370

comark-chat

pnpm add https://pkg.pr.new/comark-chat@370

comark-chips

pnpm add https://pkg.pr.new/comark-chips@370

comark-cjk

pnpm add https://pkg.pr.new/comark-cjk@370

comark-code

pnpm add https://pkg.pr.new/comark-code@370

comark-code-notes

pnpm add https://pkg.pr.new/comark-code-notes@370

comark-colors

pnpm add https://pkg.pr.new/comark-colors@370

comark-comments

pnpm add https://pkg.pr.new/comark-comments@370

comark-critic

pnpm add https://pkg.pr.new/comark-critic@370

comark-deflist

pnpm add https://pkg.pr.new/comark-deflist@370

comark-details

pnpm add https://pkg.pr.new/comark-details@370

comark-diagrams

pnpm add https://pkg.pr.new/comark-diagrams@370

comark-diff

pnpm add https://pkg.pr.new/comark-diff@370

comark-embed

pnpm add https://pkg.pr.new/comark-embed@370

comark-fields

pnpm add https://pkg.pr.new/comark-fields@370

comark-figure

pnpm add https://pkg.pr.new/comark-figure@370

comark-file-tree

pnpm add https://pkg.pr.new/comark-file-tree@370

comark-footnotes

pnpm add https://pkg.pr.new/comark-footnotes@370

comark-github

pnpm add https://pkg.pr.new/comark-github@370

comark-icon

pnpm add https://pkg.pr.new/comark-icon@370

comark-include

pnpm add https://pkg.pr.new/comark-include@370

comark-keys

pnpm add https://pkg.pr.new/comark-keys@370

comark-links

pnpm add https://pkg.pr.new/comark-links@370

comark-linter

pnpm add https://pkg.pr.new/comark-linter@370

comark-magic-move

pnpm add https://pkg.pr.new/comark-magic-move@370

comark-mark

pnpm add https://pkg.pr.new/comark-mark@370

markdown-it-to-comark

pnpm add https://pkg.pr.new/markdown-it-to-comark@370

marked-to-comark

pnpm add https://pkg.pr.new/marked-to-comark@370

comark-mathml

pnpm add https://pkg.pr.new/comark-mathml@370

comark-media

pnpm add https://pkg.pr.new/comark-media@370

comark-metrics

pnpm add https://pkg.pr.new/comark-metrics@370

migrate-to-comark

pnpm add https://pkg.pr.new/migrate-to-comark@370

comark-outline

pnpm add https://pkg.pr.new/comark-outline@370

comark-properties

pnpm add https://pkg.pr.new/comark-properties@370

comark-qr

pnpm add https://pkg.pr.new/comark-qr@370

comark-quiz

pnpm add https://pkg.pr.new/comark-quiz@370

comark-reading-time

pnpm add https://pkg.pr.new/comark-reading-time@370

remark-to-comark

pnpm add https://pkg.pr.new/remark-to-comark@370

comark-sources

pnpm add https://pkg.pr.new/comark-sources@370

comark-steps

pnpm add https://pkg.pr.new/comark-steps@370

comark-table

pnpm add https://pkg.pr.new/comark-table@370

comark-tabs

pnpm add https://pkg.pr.new/comark-tabs@370

comark-tests

pnpm add https://pkg.pr.new/comark-tests@370

comark-time

pnpm add https://pkg.pr.new/comark-time@370

comark-ui

pnpm add https://pkg.pr.new/comark-ui@370

comark-xref

pnpm add https://pkg.pr.new/comark-xref@370

comark-zoom

pnpm add https://pkg.pr.new/comark-zoom@370

commit: f4a1de3

@vite-hub

vite-hub Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor
Session Status Started Duration
Pending Completed Not started —
View session Completed 2026-11-06T16:05:24.501Z 6m 29s

Latest result

Pull request merged.

Final answers

Session

Pull request merged.

View session

Ready: inspected the full diff and supplied feedback; no actionable findings remain and all current-head checks passed. Pullfrog found no issues; Codex review hit its usage limit. `node_modules/.bin/vp lint docs/app/components/DocsMarkdown.vue` passed. `node_modules/.bin/vp test test/site.test.ts` could not run because generated Nuxt tsconfigs are absent locally; hosted CI passed. No repair commit was needed; the working tree is clean.

…tate's rail icon

Every package page is a one-page section, so @vite-hub/docs showed a sidebar with a single link to the current page. A pnpm patch backports vite-hub/vitehub#3559, which lists the section's category instead.

Lucide has no scribble-loop, so Annotate's rail item drew no icon. content.ts maps it to pen-tool, as the landing's package grid does.
@onmax onmax changed the title fix(docs): ship the fonts again and style the page headings fix(docs): list each package's category in its sidebar, ship the fonts, and style headings Nov 6, 2026

@pullfrog pullfrog Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ No new issues found.

Reviewed changes Reviewed the sidebar grouping patch and Annotate navigation icon fix introduced in f4a1de3 since the prior Pullfrog review.

  • Category sidebars — Added the upstream docsSidebarGroup() behavior so one-page package sections list their category peers while multi-page sections continue to list their own pages.
  • Navigation icon — Mapped Annotate's landing-only scribble-loop name to Lucide's pen-tool in generated docs navigation.
  • Patch lifecycle — Registered the ViteHub backport through pnpm and documented its upstream source and removal condition.
  • Verification — Traced the grouping guard against the repository's generated section metadata and multi-page packages, and regenerated docs content to confirm the expected Diff category and Annotate icon output.

Pullfrog  | View workflow run | Using gpt-5.6-sol | 𝕏

@vite-hub
vite-hub Bot merged commit a6b7e24 into main Nov 6, 2026
6 checks passed
@vite-hub
vite-hub Bot deleted the fix/docs-sidebar branch November 6, 2026 16:59
@github-actions github-actions Bot mentioned this pull request Nov 6, 2026
vite-hub Bot added a commit that referenced this pull request Nov 6, 2026
…nd code frames (#372)

* fix(docs): one rail item per kind of page, as on the old site

The rail had an item per package, and since #370 each package's sidebar lists its category's packages too, so every
package showed twice. The rail now has Docs, Skills, Components, Typography, Linter, and Migrate, each a group whose
sidebar lists its sections under their categories. Sections sort by category, so each heading shows once, and Mermaid
joins Charts and diagrams instead of sitting alone in the rail.

* fix(docs): bring back the old site's example tabs and code block frame

Examples get the old underlined tabs, with the Preview/Code switch and the Playground link on the same row, and a
block that draws its own frame, such as a diff, isn't framed again. Code blocks get their frame back: comark-code
replaces pre, so Nuxt UI's prose styles never reached them and they had no padding or background.

* fix(docs): avoid duplicate frames around annotate examples

---------

Co-authored-by: vite-hub[bot] <320448255+vite-hub[bot]@users.noreply.github.com>
@github-actions github-actions Bot mentioned this pull request Nov 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant