Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
81 commits
Select commit Hold shift + click to select a range
c942cfa
wip: single-pass shader renderer, effect model, and new value types
rehmatsg Nov 15, 2026
ec52a9e
test: rebuild the suite around the single-pass shader renderer
rehmatsg Nov 15, 2026
04bb332
style(effects): tune every effect's look for the shader renderer
rehmatsg Nov 15, 2026
cbf6e25
docs(shader): point the uniform-layout note at the real packer
rehmatsg Nov 15, 2026
54eff65
Merge branch 'worktree-agent-ab1e4e3064b3617f1' into feat/native-shad…
rehmatsg Nov 15, 2026
de7ea30
test: align with the tuned effects and regenerate goldens
rehmatsg Nov 15, 2026
faff01f
fix: phaseOffset, glow 0, and follow on linear sweeps
rehmatsg Nov 15, 2026
02bde74
docs: rewrite docs and CI for the 0.2.0 shader renderer
rehmatsg Nov 15, 2026
b83f900
Merge branch 'worktree-agent-a80cd49f575ce11f3' into feat/native-shad…
rehmatsg Nov 15, 2026
e7bfc3f
docs: phaseOffset reaches ambient effects; drop upstream wording in lib
rehmatsg Nov 15, 2026
415c1d8
feat(example): migrate the gallery and playground to the 0.2 effect API
rehmatsg Nov 15, 2026
8c107f4
Merge branch 'worktree-agent-a2280e3d2b88a5b23' into feat/native-shad…
rehmatsg Nov 15, 2026
1226f43
feat(render): rebuild rotate on the original layer model in one pass
rehmatsg Nov 15, 2026
a4a4049
feat(render): restore the line's streak, spikes, and travelling bloom
rehmatsg Nov 15, 2026
02a4f83
feat(render): restore the pulse and the halo's tuned glow
rehmatsg Nov 15, 2026
7f7a788
feat(effects): restyle flow, spin, shimmer, and charge in the origina…
rehmatsg Nov 15, 2026
bb567ff
test: rebuild the render suite around the layer model; regenerate gol…
rehmatsg Nov 15, 2026
2e3f668
feat!: drop the flow, spin, shimmer, and charge effects
rehmatsg Nov 16, 2026
0c7ab61
feat(example): rewrite the example as a one-screen showcase
rehmatsg Nov 16, 2026
31fc8ee
fix(line): keep the bloom blurred when the hue is fixed
rehmatsg Nov 16, 2026
0501926
feat(motion): fade on critically damped springs
rehmatsg Nov 16, 2026
a969499
feat(pulse): breathe in quicker than out
rehmatsg Nov 16, 2026
ef906a1
feat!: remove the halo effect
rehmatsg Nov 16, 2026
249297a
fix(render): follow Flutter's RSuperellipse construction
rehmatsg Nov 16, 2026
726b674
fix: harden playback and inputs, prune dead code, tighten the tests
rehmatsg Nov 16, 2026
fd0c020
ci: pin actions, tighten permissions, and fix the package archive
rehmatsg Nov 16, 2026
24914a0
docs: three effects, accurate throughout, and fresh media
rehmatsg Nov 16, 2026
b7dc941
fix: retime a running beam on the cycle it actually runs
rehmatsg Nov 16, 2026
43716ba
fix: mirror a reversed beam's static frame the way it travels
rehmatsg Nov 16, 2026
57c624c
fix: keep the phase offset in a beam's static frame
rehmatsg Nov 16, 2026
d6c02a3
fix(render): hold the line's own hue tracks still in a static frame
rehmatsg Nov 16, 2026
f9e7ca2
fix: leave a controller's clock alone when debugFrozenAt changes
rehmatsg Nov 16, 2026
dec748a
fix: count a BeamDecoration's repeat budget before its first paint
rehmatsg Nov 16, 2026
9af77b0
fix: name every field in BeamPalette.toString
rehmatsg Nov 16, 2026
a57d6a8
docs: name the effects each hue mode is the default of
rehmatsg Nov 16, 2026
aaec243
fix(render): share an in-flight shader load
rehmatsg Nov 16, 2026
c9f5a56
fix(render): leave the join of a closed segment unfeathered
rehmatsg Nov 16, 2026
55b3ca2
fix(look): spread custom palettes across the light-surface streak
rehmatsg Nov 16, 2026
e8f5891
docs: name ringOffset in BeamDecoration's clipping note
rehmatsg Nov 16, 2026
37a1853
docs: list the ring offset in BeamHover's shape summary
rehmatsg Nov 16, 2026
1f24938
docs: separate repeated flashes from short cycles in the flicker note
rehmatsg Nov 16, 2026
8e65a23
docs: say the beam's inward light does change contrast over the child
rehmatsg Nov 16, 2026
32c449e
docs: say a new progress value arrives with a rebuild
rehmatsg Nov 16, 2026
28be07f
docs: describe the shader's four fixed conic-table lookups
rehmatsg Nov 16, 2026
811d63b
docs: say what driven progress keeps lit
rehmatsg Nov 16, 2026
19b4c8a
docs: scope the pure-function-of-time claim to the timeline
rehmatsg Nov 16, 2026
5a6115a
docs: note the line and lerp-endpoint exceptions to derived tables
rehmatsg Nov 16, 2026
2861769
docs: limit "never per frame" blending to a stable palette
rehmatsg Nov 16, 2026
f875e45
docs: limit the inset shadow to rotate and line in surface adaptation
rehmatsg Nov 16, 2026
4f5e741
docs(changelog): keep the 0.1.0 import as unchanged
rehmatsg Nov 16, 2026
2cc95e3
docs(changelog): stop claiming the renderer keeps the same look
rehmatsg Nov 16, 2026
febb878
docs(changelog): say the extras cycle colours over colorful's tables
rehmatsg Nov 16, 2026
5149eeb
docs(readme): qualify the palette memo as a bounded LRU
rehmatsg Nov 16, 2026
9391833
docs(claude): point the preset map at where the table data lives
rehmatsg Nov 16, 2026
50d0865
chore: show a single effect in the bug report placeholder
rehmatsg Nov 16, 2026
d5b1d5f
fix(example): wrap the swatch gradient across 12 o'clock
rehmatsg Nov 16, 2026
0b14ee5
fix(example): fall back to colorful on an unknown PALETTE define
rehmatsg Nov 16, 2026
e7b5e9a
test: catch an uncancelled startAfter timer before it fires
rehmatsg Nov 16, 2026
4f17d96
test: check the gap leaves every effect's ambient clock alone
rehmatsg Nov 16, 2026
f4ae74b
test: fail a rendered frame that outgrows its margin
rehmatsg Nov 16, 2026
5fee39c
test: check each uniform writer lands where the shader reads it
rehmatsg Nov 16, 2026
960971c
test: hold the uniforms to the GLES limit the test documents
rehmatsg Nov 16, 2026
e5ad926
test: check the shader's loops run to their slot counts
rehmatsg Nov 16, 2026
2a37808
test: let the hover and press fade-outs run down after capture
rehmatsg Nov 16, 2026
249e072
test: stop requiring unequal effects to hash apart
rehmatsg Nov 16, 2026
18928eb
test: stop requiring a changed config to hash apart
rehmatsg Nov 16, 2026
ddfbb9a
test: check a reverse sweep's shape mirrors forward, not just its centre
rehmatsg Nov 16, 2026
6e9a580
test: hold the stops of a table in use to the conic range
rehmatsg Nov 16, 2026
650fd3e
test: pin the pop's single rise and its settle
rehmatsg Nov 16, 2026
fa1a7f2
test: require a beam with non-finite inputs to still paint
rehmatsg Nov 16, 2026
f068527
test: count seek among the commands that notify listeners
rehmatsg Nov 16, 2026
259d9b5
refactor!: hide the controller and sync plumbing from the public API
rehmatsg Nov 16, 2026
6b0395f
fix!: let style and theme colours reach BeamFocusRing
rehmatsg Nov 16, 2026
d391933
fix: hold a controller-driven beam still under reduced motion
rehmatsg Nov 16, 2026
fd4a325
feat!: let controller.start() resume a paused beam
rehmatsg Nov 16, 2026
88a7df1
fix: reject a non-finite controller speed in release builds too
rehmatsg Nov 16, 2026
7fb5fea
fix: reject a non-finite BeamSync speed
rehmatsg Nov 16, 2026
60fd3e0
docs: say the uniform layout test now checks order and the GLES limit
rehmatsg Nov 16, 2026
95e5950
feat!: move to material_ui and raise the floor to Flutter 3.47
rehmatsg Nov 16, 2026
7e90002
ci: pin Flutter 3.50.0
rehmatsg Nov 16, 2026
62c4dab
Merge origin/main: take Dependabot's action majors as SHA pins
rehmatsg Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
22 changes: 10 additions & 12 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,8 @@ body:
- type: markdown
attributes:
value: |
Thanks for the report. If you can reproduce it in the
[live playground](https://simplifyjobs.github.io/flutter_border_beam/),
paste the share link — it carries the exact configuration and saves
everyone a round trip.
Thanks for the report. A minimal reproduction below saves everyone a
round trip.

Security issues do **not** belong here — see
[SECURITY.md](https://github.com/SimplifyJobs/flutter_border_beam/blob/main/SECURITY.md).
Expand All @@ -28,11 +26,11 @@ body:
label: Minimal reproduction
description: >-
The smallest widget tree that shows the problem — ideally one that
drops straight into a fresh `flutter create` app. A playground share
link works too.
drops straight into a fresh `flutter create` app.
render: dart
placeholder: |
BorderBeam.rotate(
BorderBeam(
effect: const BeamEffect.rotate(),
colors: BeamColors.ocean,
child: const SizedBox(width: 240, height: 120),
)
Expand All @@ -54,11 +52,11 @@ body:
required: true

- type: input
id: variant
id: effect
attributes:
label: Variant(s) and palette
description: Which `BeamVariant` and which `BeamColors` (or custom colors).
placeholder: "rotate + line; BeamColors.colorful"
label: Effect(s) and palette
description: Which `BeamEffect` and which `BeamColors` (or custom colors).
placeholder: "rotate; BeamColors.colorful"
validations:
required: true

Expand All @@ -75,7 +73,7 @@ body:
id: package-version
attributes:
label: flutter_border_beam version
placeholder: "0.1.0"
placeholder: "0.2.0"
validations:
required: true

Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ contact_links:
- name: Question or idea
url: https://github.com/SimplifyJobs/flutter_border_beam/discussions
about: Ask how to do something, or float an idea before it becomes a proposal.
- name: Live playground
- name: Live demo
url: https://simplifyjobs.github.io/flutter_border_beam/
about: Try variants and palettes in the browser, then share the exact configuration.
about: See every effect and palette in the browser.
- name: Security vulnerability
url: https://github.com/SimplifyJobs/flutter_border_beam/security/advisories/new
about: Report privately. Never in a public issue.
19 changes: 9 additions & 10 deletions .github/ISSUE_TEMPLATE/feature_request.yml
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
name: Feature request
description: Propose a new variant, option, palette, or API.
description: Propose a new effect, option, palette, or API.
title: "[feat]: "
labels: [enhancement]
body:
- type: markdown
attributes:
value: |
This package is a port of the
[border-beam](https://github.com/Jakubantalik/border-beam) React
library. Features that exist upstream are the easiest sell — say so if
yours does, and link the source. Flutter-only additions are welcome
too; they just need to stay out of the parity tables.
Every effect is drawn by one fragment shader in a single draw call,
with no offscreen layers or blurs. Proposals that fit that model — new
light along the border, new motion, new palettes, new options — are
the easiest sell. Describe the look you want; how to render it is a
conversation for the issue.

- type: textarea
id: problem
Expand All @@ -31,8 +31,8 @@ body:
fine — the shape is what matters.
render: dart
placeholder: |
BorderBeam.rotate(
style: const BeamStyle(tailLength: 0.4),
BorderBeam(
effect: const BeamEffect.rotate(length: 0.4),
child: ...,
)
validations:
Expand Down Expand Up @@ -68,7 +68,6 @@ body:
attributes:
label: Anything else
description: >-
References, a link to the React implementation, screenshots or a
mockup of the effect.
References, screenshots, a video, or a mockup of the effect.
validations:
required: false
22 changes: 11 additions & 11 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ the first thing a reviewer needs to know.
<!--
Bullets, each opening with a bold lead-in naming the area:

- **Painting** (`lib/src/painting/`) — …
- **Render** (`lib/src/render/`, `shaders/beam.frag`) — …
- **Docs** — …
-->

Expand All @@ -32,24 +32,24 @@ What you actually ran, and what it said. Do not claim a check you skipped —

<!--
If you regenerated any: list which scenes, and why the pixels legitimately
moved (a new blur radius, a corrected gradient stop, a Flutter pin bump).
Goldens are macOS-only and pinned to Flutter 3.44.2; regenerate only your own
new scenes, with `--plain-name`.
moved (a retuned effect, a shader fix, a Flutter pin bump). Goldens are
macOS-only and pinned to Flutter 3.50.0; regenerate only the scenes you
touched, with `--plain-name`.
-->

**saveLayer budget** — unchanged / changed:
**Frame budget** — still one draw, no `saveLayer` / clip / image or mask filter:

<!--
If `test/painting/save_layer_budget_test.dart`'s table changed: which variants,
the new counts, and what the added layer composites that no existing layer
could. Both the test and CLAUDE.md's table have to move together.
`test/render/frame_budget_test.dart` must pass unchanged. If you touched the
shader's uniforms, say so: `shaders/beam.frag` and the offsets and slot
counts in `lib/src/render/beam_frame.dart` (`beamUniformFloats`) must move
together, and the uniform order is checked by hand.
-->

## Checklist

- [ ] No values in `lib/src/constants/` were tweaked (they are verbatim
transcriptions of the React source); Flutter-only additions live in a
clearly headed file
- [ ] `BeamOutline` and `color_math.dart` still mirror the shader (if either
side changed)
- [ ] New public API has doc comments (`public_member_api_docs` is enforced)
- [ ] Docs and comments describe current behavior — no change-history prose
- [ ] `CHANGELOG.md` updated
Expand Down
6 changes: 4 additions & 2 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@
version: 2

updates:
# GitHub Actions used by ci.yaml and release.yaml.
# GitHub Actions used by ci.yaml, release.yaml, and pages.yaml. They are
# pinned to commit SHAs with the release in a trailing comment; Dependabot
# bumps both together.
- package-ecosystem: github-actions
directory: /
schedule:
Expand All @@ -17,7 +19,7 @@ updates:
patterns:
- "*"

# Dart/Flutter dependencies for the package and the example gallery.
# Dart/Flutter dependencies for the package and the example app.
- package-ecosystem: pub
directories:
- /
Expand Down
6 changes: 3 additions & 3 deletions .github/labels.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,19 +14,19 @@

- name: enhancement
color: a2eeef
description: A new variant, option, palette, or API.
description: A new effect, option, palette, or API.

- name: documentation
color: 0075ca
description: README, doc comments, or the guides in this repo.

- name: rendering
color: 8a63d2
description: Painting, geometry, gradients, goldens — anything about the pixels.
description: The shader, geometry, colour, goldens — anything about the pixels.

- name: performance
color: fbca04
description: Frame cost, saveLayer budget, repaint churn, memory.
description: Frame cost, the one-draw budget, repaint churn, memory.

- name: good first issue
color: 7057ff
Expand Down
Loading
Loading