Skip to content

Enable oxfmt sorting + JSDoc formatting#109

Merged
lifeiscontent merged 9 commits into
mainfrom
chore/oxfmt-sort-tailwind
Jun 17, 2026
Merged

Enable oxfmt sorting + JSDoc formatting#109
lifeiscontent merged 9 commits into
mainfrom
chore/oxfmt-sort-tailwind

Conversation

@lifeiscontent

@lifeiscontent lifeiscontent commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Turns on oxfmt's sorting/normalization options in the root vite.config.ts fmt block (Vite+'s recommended location over .oxfmtrc.json), so vp check keeps all of this consistent automatically.

  • sortTailwindcss — sort Tailwind classes. functions: ["cva", "cx"] (propel writes classes inside those calls, including cva's class: compound-variant key) and stylesheet: "packages/propel/tailwind.css" (propel's Tailwind v4 entry, @import "tailwindcss" + the @theme/@utility tokens) so custom utilities like bg-surface-1/border-subtle sort into the right position.
  • sortImports — group and sort import statements. sortSideEffects is left at its default (false), so CSS side-effect imports (import "./preview.css") are not reordered.
  • sortPackageJson — canonical top-level key order for every package.json (script order left as authored).
  • jsdoc — normalize JSDoc/TSDoc blocks (canonicalize tag aliases, capitalize descriptions, reflow long lines). Content is preserved, just reformatted.

The rest of the diff (58 files) is the one-time reformat across the codebase.

Behavior-preserving — verified that the side-effect CSS imports stayed put, vp check is clean, and vp run -r test passes 700/700 across all four themes.

Copilot AI review requested due to automatic review settings June 16, 2026 14:12
@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown

📚 Storybook preview: https://pr-109-propel-storybook.vamsi-906.workers.dev

Copilot AI 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.

Pull request overview

Enables Tailwind utility class sorting via oxfmt in the root Vite+ formatting config so vp check can automatically keep Tailwind class ordering consistent across the repo.

Changes:

  • Configure sortTailwindcss (including functions: ["cva","cx"] and a Tailwind v4 stylesheet entry) under the root fmt block.
  • Apply one-time canonical Tailwind class re-ordering across components, internals, and Storybook/pattern stories.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
vite.config.ts Enable oxfmt Tailwind class sorting with cva/cx + stylesheet reference
packages/propel/src/patterns/comment.stories.tsx Re-sorted Tailwind classes in recipe story markup
packages/propel/src/internal/scrollbar.ts Re-sorted scrollbar Tailwind class string
packages/propel/src/internal/node-slot.ts Re-sorted node-slot Tailwind selectors ordering
packages/propel/src/components/toast/index.tsx Re-sorted Tailwind classes on close button
packages/propel/src/components/tabs/index.tsx Re-sorted Tailwind classes in tab variants
packages/propel/src/components/switch/index.tsx Re-sorted Tailwind classes in switch variants
packages/propel/src/components/scroll-area/scroll-area.stories.tsx Re-sorted Tailwind classes in story markup
packages/propel/src/components/radio/index.tsx Re-sorted Tailwind classes in radio variants
packages/propel/src/components/pagination/index.tsx Re-sorted Tailwind classes in labels/range markup
packages/propel/src/components/nav-item/nav-item.stories.tsx Re-sorted Tailwind classes in story labels
packages/propel/src/components/nav-item/index.tsx Re-sorted Tailwind classes in nav item variants/markup
packages/propel/src/components/dropdown/index.tsx Re-sorted Tailwind classes in dropdown item row classes
packages/propel/src/components/dropdown/dropdown.stories.tsx Re-sorted Tailwind classes in story icon nodes
packages/propel/src/components/checkbox/index.tsx Re-sorted Tailwind classes in checkbox variants
packages/propel/src/components/button/index.tsx Re-sorted Tailwind classes in button variants
packages/propel/src/components/breadcrumb/index.tsx Re-sorted Tailwind classes in crumb variants
packages/propel/src/components/banner/index.tsx Re-sorted Tailwind classes in compound variants
packages/propel/src/components/badge/index.tsx Re-sorted Tailwind classes in badge variants
packages/propel/src/components/accordion/index.tsx Re-sorted Tailwind classes in transition state utilities

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/propel/src/patterns/comment.stories.tsx
@lifeiscontent lifeiscontent force-pushed the chore/oxfmt-sort-tailwind branch from e09a419 to f7888ae Compare June 16, 2026 14:16
@lifeiscontent lifeiscontent changed the title Enable Tailwind class sorting in oxfmt Enable oxfmt sorting + JSDoc formatting Jun 16, 2026
Copilot AI review requested due to automatic review settings June 16, 2026 14:19
@lifeiscontent lifeiscontent force-pushed the chore/oxfmt-sort-tailwind branch from f7888ae to e1e459b Compare June 16, 2026 14:19

Copilot AI 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.

Pull request overview

Copilot reviewed 60 out of 60 changed files in this pull request and generated 1 comment.

Comment thread packages/propel/src/storybook/icon-control.tsx
Turn on oxfmt's sorting/normalization in the root `vite.config.ts` `fmt` block so
`vp check` keeps these consistent automatically:

- sortTailwindcss: sort Tailwind classes. `functions: ["cva", "cx"]` (propel writes
  classes inside those, incl. cva's `class:` key). `stylesheet` points at a new
  tooling-only Tailwind entry (see below) so base + custom utilities sort canonically.
- sortImports: group + sort imports. `sortSideEffects` stays false (default), so CSS
  side-effect imports like `import "./preview.css"` keep their position.
- sortPackageJson: canonical key order for package.json (script order left as-is).
- jsdoc: normalize JSDoc/TSDoc blocks (tag aliases, capitalization, wrapping).

Add `packages/propel/tailwind.css` as the single tooling Tailwind entry
(`@import "tailwindcss"` + propel's tokens). `src/styles/propel.css` deliberately
does not import Tailwind (the consumer owns that), so it can't drive a sorter on its
own; the tooling entry can. It lives at the package root so the build never publishes
it, and `.storybook/preview.css` now imports it too (one source of truth).

The rest of the diff is the one-time reformat. Behavior-preserving: `vp check` clean
and `vp run -r test` 700/700 across the four themes.
@lifeiscontent lifeiscontent force-pushed the chore/oxfmt-sort-tailwind branch from e1e459b to 6c30e5f Compare June 16, 2026 14:39
Copilot AI review requested due to automatic review settings June 16, 2026 17:47

Copilot AI 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.

Pull request overview

Copilot reviewed 62 out of 62 changed files in this pull request and generated 2 comments.

Comment thread packages/propel/tailwind.css
Comment thread vite.config.ts
Copilot AI review requested due to automatic review settings June 17, 2026 06:38

Copilot AI 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.

Pull request overview

Copilot reviewed 66 out of 66 changed files in this pull request and generated 5 comments.

Comment thread packages/propel/src/components/popover/index.tsx
Comment thread packages/propel/src/components/dropdown/index.tsx
Comment thread packages/propel/src/components/toolbar/index.tsx
Comment thread packages/propel/src/components/tabs/index.tsx
Comment thread packages/propel/src/components/breadcrumb/index.tsx
Copilot AI review requested due to automatic review settings June 17, 2026 06:44
@lifeiscontent lifeiscontent self-assigned this Jun 17, 2026

Copilot AI 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.

Pull request overview

Copilot reviewed 67 out of 67 changed files in this pull request and generated no new comments.

@lifeiscontent lifeiscontent enabled auto-merge (squash) June 17, 2026 06:48
@lifeiscontent lifeiscontent disabled auto-merge June 17, 2026 06:48
@lifeiscontent lifeiscontent merged commit 379782f into main Jun 17, 2026
3 checks passed
@lifeiscontent lifeiscontent deleted the chore/oxfmt-sort-tailwind branch June 17, 2026 06:48
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.

2 participants