You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This commit was created on GitHub.com and signed with GitHub’s verified signature.
Changed
Renamed from fluttersdk_wind to wind_kit. The package, its barrel (package:wind_kit/wind_kit.dart) and every test carry the new name, and the diagnostics dependency is wind_kit_diagnostics_contracts ^1.3.0 (was fluttersdk_wind_diagnostics_contracts ^1.2.0; WindDebugRegistry, WindDebugResolver and WindPerfResolver are unchanged). Migration: replace the dependency in pubspec.yaml and the import package:fluttersdk_wind/fluttersdk_wind.dart with package:wind_kit/wind_kit.dart. Every W* and Wind* class, every className token and the parser cache are unchanged by the rename; the Material types in the public signatures move to material_ui in the next entry, so an app that passes Colors or a ThemeData follows that migration too. Releasing both names in parallel was rejected because two packages with one codebase would split the ecosystem's dependants between them. The old fluttersdk_wind package receives no further feature releases. Do not depend on both fluttersdk_wind and wind_kit in one app: each has its own WindTheme and its own WindDebugRegistry, so a WDiv from one finds no theme from the other. The packages that depend on it (magic, magic_starter, magic_notifications, magic_devtools) move to their wind_kit releases together, and tapir moves to wind_kit_diagnostics_contracts in step, or its snapshots lose the Wind data. pubspec.yaml, lib/wind_kit.dart, test/, example/pubspec.yaml (#272)
BREAKING.wind_kit builds on material_ui, so an app uses package:material_ui/material_ui.dart for its MaterialApp, ThemeData, Colors and MaterialColor. Flutter 3.50 deprecates package:flutter/material.dart and package:flutter/cupertino.dart, and pana's static analysis score drops 10 points for a package that still imports them, so every file in lib/ now imports material_ui ^1.11.0 instead. The new package defines its own MaterialApp, ThemeData, MaterialColor and localisations, so an app that still imports package:flutter/material.dart gets "No MaterialLocalizations found" from the default close button of WKeyboardActions and from the selection toolbar of WText(selectable: true), a ThemeData type mismatch from WindThemeData.toThemeData() and WindThemeController.toThemeData(), and a MaterialColor type mismatch wherever it passes colours: the colors maps of WindThemeData (constructor and copyWith), WindThemeController (colors, updateTheme) and windColors, and invertMaterialColor, take the material_ui type, so WindThemeData(colors: {'brand': Colors.indigo}) with Flutter's Colors no longer compiles. Run flutter pub add material_ui so the app declares the package it now imports, migrate its imports in the same upgrade and replace the flutter_localizations delegates (GlobalMaterialLocalizations, GlobalCupertinoLocalizations) with GlobalMaterialLocalizations.delegates from material_ui. Keeping the deprecated package:flutter/material.dart barrels was rejected: Flutter 3.50 flags every import of them, pana takes 10 static analysis points off, and the barrels are slated for removal. pubspec.yaml, lib/, test/, example/pubspec.yaml, example/lib/, CLAUDE.md (#279)
BREAKING.wind_kit needs Dart 3.13 and Flutter 3.47.material_ui 1.11 and cupertino_ui 1.1 require that floor, so the old one (Dart 3.4, Flutter 3.27) no longer resolves with them; an app on an older SDK stays on fluttersdk_wind 1.11.x, the last release under the previous name. Staying on the old floor was not an option, since material_ui and cupertino_ui require the new one. The floor also moves the package to the tall Dart formatter, so lib/ and test/ are reformatted with it, and the lints the new floor enables are satisfied without a change to any public signature. pubspec.yaml, CLAUDE.md, lib/, test/ (#285)
The user docs, the wind-ui skill (2.32.0) and ARCHITECTURE.md no longer promise behaviour the code does not have. An audit of 42 changed hunks against lib/ found the old text false in 26 of them: a WindController class that does not exist, states: {'pressed'} where only 'active' reaches active:, an 'input-border' theme key that WInput never reads, camelCase customIcons keys that never match, font stacks that were wrong, and a cache note that said the parser cache never needs clearing in production although its key leaves out the theme maps. Deleting the unverified claims instead of correcting them was rejected because pub.dev and the skill registry publish these pages as the reference. ARCHITECTURE.md gains alias expansion, the cache bypass, invariants and a change guide, and the .claude/ hook formats then analyses a Dart file in one script. doc/, skills/wind-ui/, llms.txt, ARCHITECTURE.md, .claude/settings.json, .claude/hooks/dart-format-analyze.sh (#273, #274, #275, #276, #277, #288, #292)
The gallery is wind_kit_example, builds from the working tree and needs Dart 3.13 and Flutter 3.47. The example package is renamed from the previous name and depends on wind_kit with path: ../, so the gallery always shows the code it ships with instead of the last published release; its native ids are com.anilcancakir.wind_kit (Android and the other platforms) and com.anilcancakir.windKit (Apple, which takes no underscore); its SDK floor matches the package's; and the unused cupertino_ui dependency is dropped. Pinning the gallery to a hosted wind_kit release was rejected because the docs site embeds it as the live demo of the current code, and a hosted pin would lag every change until a publish. example/pubspec.yaml, example/lib/, example/android/, example/ios/, example/macos/, example/linux/, example/windows/, example/web/, .github/dependabot.yml (#278, #282, #286)
The pub.dev description is marketing-first and the lockfile is no longer tracked. The pubspec.yaml description is the 174-character one the GitHub repository carries, so pub.dev and GitHub show the same pitch, the dartdoc_options.yaml source links point at anilcancakir/wind_kit, and the root pubspec.lock is untracked and ignored, because a library does not commit its lockfile and an app resolves its own graph. Tracking the lockfile was rejected because it pins the CI to versions no consumer resolves and hides a breaking upper bound until a user hits it. pubspec.yaml, dartdoc_options.yaml, .gitignore, pubspec.lock (#283)
The package and the gallery lint with flutter_lints ^6.0.0, and the 13 findings it adds are fixed. The Dart 3.13 floor lets the newer rule set resolve; it flags if (x != null) x! list and map entries (use_null_aware_elements) and a double underscore parameter (unnecessary_underscores). dart fix rewrote them to ?x entries and _, with identical behaviour: the 2037 tests and the 96.1% coverage are unchanged. Staying on flutter_lints ^5.0.0 was rejected because it keeps the repo linting against a rule set that cannot see the null-aware syntax the new floor already allows, and turning the two rules off in analysis_options.yaml was rejected because it would hide the same findings in new code. pubspec.yaml, example/pubspec.yaml, lib/src/utils/wind_perf_counters.dart, lib/src/widgets/ (w_breakpoint.dart, w_card.dart, w_div.dart, w_form_date_picker.dart, w_form_input.dart, w_form_select.dart) (#289)
WInput draws its own selection handles and selection toolbar, so the package no longer imports cupertino_ui and a bare WidgetsApp root still gets handles and a copy, cut, paste and select-all menu. The Cupertino handles (cupertinoTextSelectionHandleControls), the Cupertino toolbar and one grey constant were the only use of cupertino_ui, so they are replaced by WindTextSelectionHandleControls (a lollipop handle in the ambient cursor colour, blue-500 without one, still mixing in TextSelectionHandleControls so MaterialLocalizations is never read) and WindTextSelectionToolbar (a rounded row with a shadow, positioned by TextSelectionToolbarLayoutDelegate, white or slate-800 by the field's own brightness and refreshed while open when that brightness changes), both built on package:flutter/widgets.dart only and not exported. The toolbar scrolls sideways instead of paging when its buttons are wider than the screen (seven iOS actions or German labels on a 320px phone), so every action stays reachable, and it draws no arrow. Look Up, Search Web and Share now carry their WidgetsLocalizations labels instead of rendering blank, and an action with no label at all (Live Text, which WidgetsLocalizations does not name) is left out. material_ui still pulls cupertino_ui in transitively, so an app's resolved graph does not shrink. pubspec.yaml, lib/src/widgets/w_input.dart, lib/src/widgets/w_text_selection.dart, test/widgets/w_text_selection_test.dart, test/widgets/w_input/selection_test.dart, CLAUDE.md (#287)
The dartdoc on WindTheme, WImage, WSvg, WPopover, WKeyboardActions and the colour and context helpers now describes what the code does. Each claim was checked against the source: onThemeChanged also fires for setTheme, updateTheme(brightness:), resetToSystem and a new data: from a parent rebuild when the brightness differs (never for an OS brightness change), WImage and WSvg ignore shadow-*, w-full, max-w-* and animate-*, a WPopovermaxHeight caps the overlay without scrolling its content, the keyboard bar's default button reads MaterialLocalizations.okButtonLabel, and wColorExt takes shade:. The examples in the comments carry their dark: pairs and debugPrint replaces print. The gallery page z_index_hover.dart now shows paint order and hover shadows instead of a z-* class that no widget reads. Comments only, no behaviour change. Deleting the wrong claims instead of correcting them was rejected because pub.dev renders these comments as the API reference. lib/src/theme/wind_theme.dart, lib/src/utils/color_utils.dart, lib/src/utils/wind_extensions.dart, lib/src/widgets/ (w_anchor.dart, w_checkbox.dart, w_div.dart, w_icon.dart, w_image.dart, w_keyboard_actions.dart, w_popover.dart, w_svg.dart), lib/wind_kit.dart, example/lib/pages/layout/z_index_hover.dart (#284)
CI is ci.yml, and the demo deploy is gone: the docs site builds the gallery and serves it itself (wind-demo.anilcancakir.com), so the deploy job, its Cloudflare purge and tool/stamp-demo-cache-bust.sh are removed and the web build only proves the gallery compiles for the web, on pushes and on pull requests that touch it. Lint & Test analyses with flutter analyze --no-fatal-infos (the package and the example), changelog.yml is new, the docs job is named Internal Links, and publish.yml checks that the tag sits on master, that the tag, pubspec.yaml and the blob/<tag> link in dartdoc_options.yaml agree, pana 0.23.19 (the version pub.dev runs; 0.23.13 reports flutter_svg as web-incompatible) and the changelog section before the OIDC publish. Every workflow declares permissions: contents: read at the top level, every checkout sets persist-credentials: false, and every action is pinned by SHA at its latest release (the actionlint image by digest). Keeping a second deploy job in this repo was rejected because the docs site builds and serves the gallery itself, so the job would publish a stale copy. .github/workflows/ci.yml, .github/workflows/changelog.yml, .github/workflows/publish.yml, .github/workflows/docs-link-check.yml, .github/workflows/dispatch-to-registry.yml, .github/workflows/dependabot-auto-merge.yml, .github/workflows/dependency-review.yml, .github/workflows/scorecard.yml, .github/workflows/zizmor.yml, tool/stamp-demo-cache-bust.sh (#268)
The repo follows the standard files: a pull request template, issue forms and a contact config that point at the security advisory form and the API reference, SECURITY.md (which now names what the WDynamic allowlist does not restrict: image loading), the LICENSE holder, .lycheeignore and .pubignore entries, Dependabot groups for the wind_kit family, and no Copilot instruction files. A layout of this repo's own was rejected in favour of one standard across the ecosystem. .github/PULL_REQUEST_TEMPLATE.md, .github/ISSUE_TEMPLATE/, .github/dependabot.yml, SECURITY.md, LICENSE, .lycheeignore, .pubignore, CLAUDE.md (#268)