From f2b4cd6d66eeedb730f6a3a486ad89f615468ad8 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Fri, 11 Sep 2026 12:22:46 +0000 Subject: [PATCH] docs: complete 1.1.0 changelog links and sync gleam skill Add Keep-a-Changelog compare links and cite #8. Document Line detection, accessibility busy state, and Reduce Motion in /gleam. Co-authored-by: David Boutin --- CHANGELOG.md | 14 +++++++++++++- skills/gleam/SKILL.md | 6 +++++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 02e714a..61c8f50 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,8 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + ## [1.1.0] - 2026-08-27 ### Added @@ -24,7 +26,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - CI: always run `pod install` after cache restore (codegen needs fresh `build/generated`) - CI: stop caching `vendor/bundle` (stale gems broke Ruby 3.4 pod install) - Example: add `nkf` and `base64` gems for Ruby 3.4 / CocoaPods compatibility -- `GleamView.Line` detection no longer walks custom component `children` (avoids disabling the parent shimmer when a nested `GleamView` owns those Lines) +- `GleamView.Line` detection no longer walks custom component `children` (avoids disabling the parent shimmer when a nested `GleamView` owns those Lines) (#8) ## [1.0.6] - 2026-05-15 @@ -97,3 +99,13 @@ First stable release. - Requires React 19+ and React Native 0.78+ - The shimmer overlay supports uniform `borderRadius` only — per-corner radii are not applied to the shimmer - When `GleamView.Line` children are present, the parent renders as a plain `View`. Use `onTransitionEnd` on individual lines, not the parent. + +[Unreleased]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.1.0...HEAD +[1.1.0]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.6...v1.1.0 +[1.0.6]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.5...v1.0.6 +[1.0.5]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.4...v1.0.5 +[1.0.4]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.3...v1.0.4 +[1.0.3]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.2...v1.0.3 +[1.0.2]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.1...v1.0.2 +[1.0.1]: https://github.com/RamboWasReal/react-native-gleam/compare/v1.0.0...v1.0.1 +[1.0.0]: https://github.com/RamboWasReal/react-native-gleam/releases/tag/v1.0.0 diff --git a/skills/gleam/SKILL.md b/skills/gleam/SKILL.md index e97c06e..8a0843f 100644 --- a/skills/gleam/SKILL.md +++ b/skills/gleam/SKILL.md @@ -82,8 +82,10 @@ import { GleamView } from 'react-native-gleam'; Key rules: - `GleamView` wraps content — no conditional rendering needed. Children are hidden when `loading={true}` and shown when `loading={false}` - Lines inherit shimmer props from parent. `delay` and `onTransitionEnd` are per-line -- Place Lines as direct children or inside fragments +- Place Lines as direct children of `GleamView`, or inside `` / fragments — those are detected on the first render. Custom wrappers still work; they register after mount - Use `onTransitionEnd` on individual Lines, not the parent +- While `loading={true}`, `GleamView` and `GleamView.Line` set `accessibilityState.busy` (merged with any `accessibilityState` you pass) +- When the system Reduce Motion setting is on, shimmer is a static `baseColor` placeholder — no animation - In `FlatList`/`VirtualizedList` cells, keep the wrapper pattern and make `loading` reflect the absence of stable content, not background refetching. For example, with server-state data use `loading={isPending && !data}` instead of `loading={isFetching}` so recycled cells do not re-enable shimmer over already loaded content. - When adding or debugging list usage, validate with the example app's `FlatList recycling` section by scrolling enough to recycle cells, toggling loading, and confirming loaded content remains visible after cells reattach. @@ -112,6 +114,8 @@ Key rules: | `delay` | `number` | `0` | Phase offset for this line | | `onTransitionEnd` | `function` | — | Per-line transition callback | +Accessibility props (`accessibilityLabel`, `accessibilityRole`, etc.) are accepted on Lines. Shimmer props (`loading`, `speed`, `direction`, …) are inherited from the parent `GleamView`. + ### Enums ```tsx