release: 1.2.0 by anilcancakir · Pull Request #150 · fluttersdk/wind

anilcancakir · 2026-07-07T21:31:23Z

Summary

Prepares the 1.2.0 minor release and syncs every documentation surface to the post-1.1.2 change set.

Per SemVer 2.0.0 this is a MINOR bump (not 1.1.3): the release adds new public API (five widgets, WindRecipe/WindSlotRecipe, two utility families), which patch versions do not carry.

What ships in 1.2.0

New public surface added since 1.1.2 (already merged, now versioned):

Widgets: WBadge, WCard, WSwitch, WRadio, WTabs.
Composition: WindRecipe / WindSlotRecipe (+ compound variants).
Utilities: cursor-* (new CursorParser), size-* shorthand.
Layout: grid ... items-stretch equal-height rows, intrinsic-safe flex stretch, min-width-stretch horizontal scroll, w-full on a Row child treated as flex-1.
Theme: seeded default primary color token; interactive widgets route selection colors through it.
Parser: flex-wrap aliased to wrap, unknown-className debug hint.
Fixes: WPopover horizontal clamp + width/maxWidth, WSelect self-close, prefixed alias expansion, and more.

Full detail in the promoted ## [1.2.0] CHANGELOG section.

Documentation sync (commit 1)

Brings the five sync surfaces plus llms.txt in line with the shipped surface:

llms.txt: 22 to 27 widgets, adds the new widgets, cursor-* / size-*, and WindRecipe; corrects the unknown-token behavior (debug hint, not silent).
skills/wind-ui: adds a Composed-widgets section to references/widgets.md, fixes the parser count (20) and the cursor-* / flex-wrap support state in tokens.md and community.md.
doc/core-concepts/debugging.md: documents the unknown-className debug hint.
Removes every em-dash and en-dash from doc/, skills/, lib/ comments, and example/ (empty-value UI glyphs preserved); the WindDynamic unknown-action debug message now uses the comma form.

Release bump (commit 2)

pubspec.yaml, example/pubspec.yaml, dartdoc_options.yaml, llms.txt version string, and the CHANGELOG promotion, matching the prior release-PR shape.

Verification

flutter test: 1664 passed, 1 pre-existing skip, 0 failures.
./tool/coverage.sh 90: 94.6% (gate 90%).
dart format clean; dart analyze clean on lib/, test/, and example/.

After merge

Tag 1.2.0 and push it to trigger publish.yml to pub.dev.

Summary by CodeRabbit

New Features
- Added new release notes for version 1.2.0 and refreshed the app/package version to match.
- Expanded documentation coverage for widgets, themes, layouts, debugging, and dynamic rendering.
- Added clearer guidance for unknown class-name handling, alias behavior, and composed widget usage.
Bug Fixes
- Improved viewport clamping for popovers.
- Refined equal-height grid behavior to reduce overflow and improve layout stability.
Documentation
- Standardized wording and formatting across docs and examples for clearer, more consistent guidance.

Bring every documentation surface in line with the post-1.1.2 changes and the project style rule: - llms.txt: 22 -> 27 widgets, add WBadge/WCard/WSwitch/WRadio/WTabs, the cursor-* / size-* families, and WindRecipe/WindSlotRecipe; correct the unknown-token behavior (debug hint, not silent). - skills/wind-ui: add a Composed-widgets section to references/widgets.md, fix the parser count (19 -> 20) and the cursor-* / flex-wrap support state in tokens.md and community.md. - doc/core-concepts/debugging.md: document the unknown-className debug hint. - CHANGELOG: attribute the #120 design-system widgets and record the sync under Quality. - Remove every em-dash and en-dash from doc/, skills/, lib/ comments, and example/ (empty-value UI glyphs preserved); the WindDynamic unknown-action debug message now uses the comma form.

Minor release: five new widgets (WBadge, WCard, WSwitch, WRadio, WTabs), WindRecipe/WindSlotRecipe variant composition, cursor-* and size-* utilities, grid items-stretch equal-height rows, intrinsic-safe flex stretch, min-width-stretch scroll, seeded primary color token, and the flex-wrap alias. Bump pubspec.yaml 1.1.2 -> 1.2.0 and promote ## [Unreleased] to ## [1.2.0] - 2026-07-08 in CHANGELOG.md, with the [1.2.0] link reference and the [Unreleased] compare link redirected to 1.2.0...HEAD. Sync example/pubspec.yaml, dartdoc_options.yaml source-link tag, and the llms.txt version string to 1.2.0.

coderabbitai · 2026-07-07T21:31:53Z

Warning

Review limit reached

@anilcancakir, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 47 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: a452d3d1-22f4-4077-ba53-0f21a29ecfb4

📥 Commits

Reviewing files that changed from the base of the PR and between 99e1931 and d0ad3be.

📒 Files selected for processing (10)

lib/src/widgets/w_tabs.dart
skills/wind-ui/SKILL.md
skills/wind-ui/references/debug.md
skills/wind-ui/references/dynamic.md
skills/wind-ui/references/forms.md
skills/wind-ui/references/layouts.md
skills/wind-ui/references/tailwind-divergence.md
skills/wind-ui/references/theme.md
skills/wind-ui/references/tokens.md
skills/wind-ui/references/widgets.md

📝 Walkthrough

Walkthrough

This PR bumps the package version from 1.1.2 to 1.2.0 across pubspec.yaml, example/pubspec.yaml, dartdoc_options.yaml, and CHANGELOG.md, and applies a repo-wide style cleanup replacing em-dash/en-dash punctuation with colons, commas, or parentheses across documentation, example app UI strings, and code comments. It also updates skill reference docs (tokens, widgets, tailwind-divergence, etc.) and llms.txt to document unknown-className debug hints, flex-wrap aliasing, and new composed widgets (WCard, WBadge, WTabs, WSwitch, WRadio).

Changes

Release Version Bump and Changelog

Layer / File(s)	Summary
Version bump across pubspec, dartdoc config, and changelog `pubspec.yaml`, `example/pubspec.yaml`, `dartdoc_options.yaml`, `CHANGELOG.md`	Version strings updated from 1.1.2 to 1.2.0; CHANGELOG adds a 1.2.0 release section covering WPopover viewport-clamping and grid items-stretch MIN-height fixes, documentation sync, and em-dash removal quality notes.

Documentation and Example Punctuation Cleanup

Layer / File(s)	Summary
Core-concepts and widget documentation punctuation updates `doc/core-concepts/`, `doc/layout/`, `doc/widgets/*`	Em-dash/en-dash separators replaced with colons/commas across debugging, theming, layout, positioning, and widget docs; adds new "Unknown className Warnings" debugging section.
Example app UI string punctuation updates `example/lib/pages/*/.dart`	Displayed strings across buttons, effects, forms, interactivity, layout, popover, typography, utilities, and widget example pages reformatted from em-dash to colon/comma/parenthetical style.
Library source code comment punctuation updates `lib/src/dynamic/`, `lib/src/parser/`, `lib/src/theme/`, `lib/src/widgets/`	Inline doc comments and debug log messages reworded/re-punctuated without changing logic in action handler, parsers, theme, and widget files.
llms.txt feature catalog updates `llms.txt`	Version bumped to 1.2.0; documents unknown-token debug hints, new widgets (WCard, WBadge, WTabs, WSwitch, WRadio), and reorganized Debugging/Recipes sections.
Skill reference documentation updates `skills/wind-ui/SKILL.md`, `skills/wind-ui/references/*`	Reference docs bumped to Wind 1.1 heading, flex-wrap documented as aliased (not silent no-op), and a new "Composed: WBadge, WCard, WSwitch, WRadio, WTabs" section added to widgets.md.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

fluttersdk/wind#96: Both PRs touch WPopover behavior — this PR's changelog documents viewport-clamping changes referenced by that PR's interaction tests.
fluttersdk/wind#142: This PR's changelog describes the grid ... items-stretch MIN-height stretch fix matching that PR's WindEqualHeightRow.performLayout change.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly matches the main change: preparing and versioning the 1.2.0 release.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch release/1.2.0

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

Copilot

Pull request overview

Prepares the 1.2.0 release by bumping package versions and promoting the changelog, while syncing documentation/skill surfaces and standardizing punctuation (replacing em/en dashes with commas/colons) across docs, skills, library comments, and example pages.

Changes:

Bump versions to 1.2.0 and promote CHANGELOG.md with a new 1.2.0 section.
Sync llms.txt, skills/wind-ui/**, and doc/** to reflect the post-1.1.2 shipped surface (new widgets/utilities + unknown-token debug hint).
Mechanical punctuation/style pass across lib/, doc/, and example/ text/comments.

Reviewed changes

Copilot reviewed 68 out of 68 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
skills/wind-ui/SKILL.md	Minor wording/table clarity tweaks in skill guidance.
skills/wind-ui/references/widgets.md	Updates widget reference contents (incl. composed widgets section) and punctuation.
skills/wind-ui/references/tokens.md	Updates token catalog wording (parser count + unknown-token hint) and punctuation.
skills/wind-ui/references/theme.md	Updates theme reference punctuation/wording.
skills/wind-ui/references/tailwind-divergence.md	Updates divergence catalog punctuation/wording.
skills/wind-ui/references/layouts.md	Updates layout reference punctuation/wording.
skills/wind-ui/references/forms.md	Updates forms reference punctuation/wording.
skills/wind-ui/references/dynamic.md	Updates WDynamic reference punctuation/wording (unknown-action message text).
skills/wind-ui/references/debug.md	Updates debug reference punctuation/wording.
skills/wind-ui/references/community.md	Corrects community guidance re: which tokens are truly silent no-ops.
pubspec.yaml	Bumps package version to `1.2.0`.
llms.txt	Updates surface summary (widget count, recipes, utilities) and version string to 1.2.0.
lib/src/widgets/w_text.dart	Comment punctuation change.
lib/src/widgets/w_tabs.dart	Doc comment punctuation change.
lib/src/widgets/w_svg.dart	Comment punctuation change.
lib/src/widgets/w_keyboard_actions.dart	Comment punctuation change.
lib/src/widgets/w_div.dart	Comment punctuation change.
lib/src/widgets/w_card.dart	Doc comment punctuation change.
lib/src/widgets/w_button.dart	Comment punctuation change.
lib/src/widgets/w_breakpoint.dart	Doc comment punctuation change.
lib/src/widgets/w_anchor.dart	Comment punctuation change.
lib/src/theme/wind_theme.dart	Comment punctuation change.
lib/src/parser/wind_style.dart	Comment punctuation change.
lib/src/parser/parsers/svg_parser.dart	Doc/comment punctuation change.
lib/src/parser/parsers/position_parser.dart	Doc/comment punctuation change.
lib/src/parser/parsers/order_parser.dart	Doc/comment punctuation change.
lib/src/dynamic/w_action_handler.dart	Updates unknown-action debug message text (dash → comma form) + doc comment.
example/pubspec.yaml	Bumps example app version to `1.2.0+1`.
example/lib/pages/widgets/w_text.dart	Punctuation/style text update in example description.
example/lib/pages/widgets/w_spacer_responsive.dart	Punctuation/style text updates in example copy.
example/lib/pages/widgets/w_spacer_basic.dart	Punctuation/style text update in example copy.
example/lib/pages/widgets/w_form_input_layout.dart	Punctuation/style text update in example copy.
example/lib/pages/widgets/w_div_basic.dart	Punctuation/style text update in example copy.
example/lib/pages/widgets/w_anchor_flex.dart	Punctuation/style text update in example copy.
example/lib/pages/utilities/typography_helpers_basic.dart	Punctuation/style text update in example section titles.
example/lib/pages/utilities/style_parser_basic.dart	Punctuation/style text update in example description.
example/lib/pages/utilities/spacing_helpers_basic.dart	Punctuation/style text update in example description.
example/lib/pages/utilities/context_extensions_basic.dart	Punctuation/style text update in example section titles.
example/lib/pages/utilities/color_helpers_basic.dart	Punctuation/style text update in example section titles.
example/lib/pages/typography/text_overflow_truncate.dart	Replaces em dash in demo string.
example/lib/pages/typography/line_height.dart	Punctuation/style text update in demo string.
example/lib/pages/typography/font_size.dart	Punctuation/style text updates in demo strings and description.
example/lib/pages/popover/popover_basic.dart	Punctuation/style text update in example description.
example/lib/pages/layout/sizing_height.dart	Punctuation/style text update in demo string.
example/lib/pages/layout/grid_cols.dart	Copy tweak (“1–12” → “1 to 12”).
example/lib/pages/layout/flex_grow.dart	Punctuation/style text update in reference row.
example/lib/pages/layout/display.dart	Punctuation/style text updates in reference rows.
example/lib/pages/interactivity/transition_basic.dart	Punctuation/style text update in demo string.
example/lib/pages/interactivity/cursor_basic.dart	Replaces em dash in demo string.
example/lib/pages/interactivity/animation_basic.dart	Punctuation/style text update in description.
example/lib/pages/forms/select_basic.dart	Punctuation/style text update in example description.
example/lib/pages/forms/input_basic.dart	Punctuation/style text update in placeholders.
example/lib/pages/effects/opacity.dart	Punctuation/style text update in demo string.
example/lib/pages/buttons/button_basic.dart	Punctuation/style text update in example description.
doc/widgets/w-switch.md	Punctuation/style tweak in props description.
doc/widgets/w-svg.md	Punctuation/style tweaks in preserve-colors section and comments.
doc/widgets/w-form-date-picker.md	Punctuation/style tweaks in note and event handling section.
doc/widgets/w-date-picker.md	Punctuation/style tweaks in range selection explanation.
doc/widgets/w-breakpoint.md	Punctuation/style tweaks in intro and usage guidance.
doc/layout/positioning.md	Punctuation/style tweaks in prose and code comments.
doc/layout/flexbox.md	Punctuation/style tweaks in table/prose.
doc/interactivity/cursor.md	Punctuation/style tweaks in related links list.
doc/core-concepts/utility-first.md	Punctuation/style tweak in numbered list.
doc/core-concepts/theming.md	Punctuation/style tweaks in prose.
doc/core-concepts/dynamic-rendering.md	Link text tweak (“WDynamic — …” → “WDynamic: …”).
doc/core-concepts/debugging.md	Adds documentation for unknown className warnings.
dartdoc_options.yaml	Updates `linkTo.url` to point at the `1.2.0` tag.
CHANGELOG.md	Promotes a new `1.2.0` section and updates link refs.

codecov · 2026-07-07T21:35:14Z

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

- Bump the wind-ui reference headings (and the SKILL.md package-version label) from 1.1 to 1.2 so they track the current minor release. - Fix a comma splice the em-dash sweep left in the WTabs docstring (`selected:` prefix tokens; they activate ...).

anilcancakir · 2026-07-07T21:43:55Z

Addressed the review in d0ad3be:

Copilot (8 comments): bumped the skills/wind-ui/references/*.md headings from Wind 1.1 to Wind 1.2, and for consistency the two package-version labels in SKILL.md (description + version comment) as well.
Copilot (lib/src/widgets/w_tabs.dart:74): fixed the comma splice the em-dash sweep left behind; the docstring now reads Supports \selected:` prefix tokens; they activate only on the selected tab.`

CodeRabbit reported no actionable comments and Codecov is green. dart analyze / dart format clean on the touched files.

anilcancakir added 2 commits July 8, 2026 00:27

Copilot AI review requested due to automatic review settings July 7, 2026 21:31

Copilot started reviewing on behalf of anilcancakir July 7, 2026 21:31 View session

Copilot AI reviewed Jul 7, 2026

View reviewed changes

docs: address PR review for 1.2.0

d0ad3be

- Bump the wind-ui reference headings (and the SKILL.md package-version label) from 1.1 to 1.2 so they track the current minor release. - Fix a comma splice the em-dash sweep left in the WTabs docstring (`selected:` prefix tokens; they activate ...).

anilcancakir merged commit 4f63db6 into master Jul 7, 2026
9 checks passed

anilcancakir deleted the release/1.2.0 branch July 7, 2026 21:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

release: 1.2.0#150

release: 1.2.0#150
anilcancakir merged 3 commits into
masterfrom
release/1.2.0

anilcancakir commented Jul 7, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

coderabbitai Bot commented Jul 7, 2026 •

edited

Loading

Review limit reached

Walkthrough

Changes

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codecov Bot commented Jul 7, 2026

Uh oh!

anilcancakir commented Jul 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

anilcancakir commented Jul 7, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

What ships in 1.2.0

Documentation sync (commit 1)

Release bump (commit 2)

Verification

After merge

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jul 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review limit reached

Walkthrough

Changes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codecov Bot commented Jul 7, 2026

Codecov Report

Uh oh!

anilcancakir commented Jul 7, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

anilcancakir commented Jul 7, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jul 7, 2026 •

edited

Loading