Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
114 commits
Select commit Hold shift + click to select a range
e362f20
refactor!: rename the package to prismatic
rehmatsg Nov 16, 2026
4b54c2f
refactor: split lib/src into core and border_beam
rehmatsg Nov 16, 2026
2109b81
refactor(shaders): share outline() through an include
rehmatsg Nov 16, 2026
cd22468
feat(wave): timeline, style and palettes
rehmatsg Nov 16, 2026
e4fd4b8
feat(wave): composite and glow shaders
rehmatsg Nov 16, 2026
b74a82b
feat(wave): DistortionWave, controller, anchor and theme
rehmatsg Nov 16, 2026
ea85bae
feat(wave): DistortionWaveRoute
rehmatsg Nov 16, 2026
41ad1f0
test(wave): goldens
rehmatsg Nov 16, 2026
a132f6f
test(wave): pin the sides' pictures the right way up
rehmatsg Nov 16, 2026
b239d21
feat(wave): warm the GPU up in precache; refinements from the example
rehmatsg Nov 16, 2026
e472299
feat(example): distortion wave showcase and demo reel
rehmatsg Nov 16, 2026
572d7f2
docs: README, architecture, CLAUDE.md, CHANGELOG for 0.3.0
rehmatsg Nov 16, 2026
7e352ac
feat(wave): follow the display's corners when the wave fills it
rehmatsg Nov 16, 2026
0d87eac
perf(wave): cut the shaders' per-pixel work
rehmatsg Nov 16, 2026
103a039
feat(example): full-screen wave demos on the display's own corners
rehmatsg Nov 16, 2026
cddf17d
fix(wave): give each corner of the view its own radius
rehmatsg Nov 16, 2026
b2a8e16
fix(wave): anti-alias the colour at the view's outline
rehmatsg Nov 16, 2026
f4909f6
fix(example): measure each display corner with UIKit's public API
rehmatsg Nov 16, 2026
24afe80
fix(wave): no seam across a sharp corner's diagonal
rehmatsg Nov 16, 2026
133cb0b
fix(wave): turn the edges' colour smoothly round sharp corners
rehmatsg Nov 16, 2026
ddf4feb
fix(wave): one smooth curve round every corner of a display
rehmatsg Nov 16, 2026
00dda68
fix(wave): a sharp corner carries the same slim curve as a round one
rehmatsg Nov 17, 2026
3a1b439
fix(example): no mock status bar on a full-screen demo
rehmatsg Nov 17, 2026
a777025
fix(wave): the light follows each corner's own radius
rehmatsg Nov 17, 2026
fc5ff9b
fix(wave): end the colour's edge inside the outline, not across it
rehmatsg Nov 17, 2026
4313481
feat(example): re-measure the display's corners when the window changes
rehmatsg Nov 17, 2026
415e06b
fix(wave): light a sharp corner as two edges of a frame
rehmatsg Nov 17, 2026
a7b4d77
fix(wave): light a sharp corner evenly
rehmatsg Nov 17, 2026
fd87b68
fix(wave): each wave owns its dot disc and disposes it
rehmatsg Nov 17, 2026
380cf1e
fix(wave): the route makes its curve once and disposes it
rehmatsg Nov 17, 2026
bab0c18
fix(wave): the side off screen takes no focus
rehmatsg Nov 17, 2026
39c12c1
fix(wave): an anchor reached by keyboard or screen reader is the source
rehmatsg Nov 17, 2026
7bfdaab
fix(wave): settle every style value to a finite one in release builds
rehmatsg Nov 17, 2026
bda5423
docs(wave): say what the route's paint guard does in release builds
rehmatsg Nov 17, 2026
7856807
fix(wave): measure the source afresh for every run
rehmatsg Nov 17, 2026
1494053
feat(example): keep the wave reel's scenes clear of the sensor pill
rehmatsg Nov 17, 2026
dec6916
docs: a short README for people, with demo clips
rehmatsg Nov 17, 2026
5d242f1
docs: doc/ is the reference for agents; AGENTS.md for Codex
rehmatsg Nov 17, 2026
66e0878
docs(changelog): one entry for the first release
rehmatsg Nov 17, 2026
32cbdbe
fix(license): keep LICENSE plain MIT and move the credits to NOTICE
rehmatsg Nov 17, 2026
98bc2a4
fix(wave): a wave heads for its new controller's target
rehmatsg Nov 17, 2026
883b159
fix(wave): hand the controller over when a wave leaves the tree
rehmatsg Nov 17, 2026
d26300d
fix(wave): a reveal lasts as long as its easing needs to cross the view
rehmatsg Nov 17, 2026
188792c
fix(wave): a new owner runs a wave on that a seek stopped short
rehmatsg Nov 17, 2026
c89dc36
fix(wave): a hold stops the clock under it and reports the held point
rehmatsg Nov 17, 2026
2e89482
fix(wave): a wave held at either end rests there
rehmatsg Nov 17, 2026
77b8502
fix(wave): a wave back in the tree heads for its controller's target
rehmatsg Nov 17, 2026
985bb48
fix(wave): a crossfading stage takes no touch until it arrives
rehmatsg Nov 17, 2026
6d7073e
fix(wave): a route makes its anchor registry once
rehmatsg Nov 17, 2026
593c630
fix(wave): a disposed route takes no picture of the page underneath
rehmatsg Nov 17, 2026
9fb261b
fix(wave): a route fades over a page it cannot picture
rehmatsg Nov 17, 2026
963e973
fix(wave): a source on a widget that is not a box measures as none
rehmatsg Nov 17, 2026
b160b8f
fix(wave): anchors follow their scope's registry and side
rehmatsg Nov 17, 2026
ba86e3a
fix(wave): warm up the shaders with the stage's paint flags
rehmatsg Nov 17, 2026
ffdcd2a
fix(wave): clamp the dot count with maxWaveDots
rehmatsg Nov 17, 2026
444a040
fix(wave): a theme merge keeps an unset style unset
rehmatsg Nov 17, 2026
2a1e2a4
test(wave): cover nested themes, outer-theme rebuilds and snapshots
rehmatsg Nov 17, 2026
ddeb9fb
fix(wave): settle gatherGlow within its documented 0–2
rehmatsg Nov 17, 2026
f327b55
fix(wave): returnSpeed's assert accepts the 100 the spec settles to
rehmatsg Nov 17, 2026
d14318f
fix(wave): always dispose the detached layer a side is pictured in
rehmatsg Nov 17, 2026
8480ec7
fix(wave): keep the dots of a few specs, not only the last one
rehmatsg Nov 17, 2026
8c8bf38
docs(wave): name the floors WaveSpec raises glow lengths to
rehmatsg Nov 17, 2026
1fb3777
docs(wave): a palette's colours must not change after it is made
rehmatsg Nov 17, 2026
b2d2476
test(wave): check which side shows round the center wave's ring
rehmatsg Nov 17, 2026
80fd605
test(wave): assert the collapse is quicker than the reveal
rehmatsg Nov 17, 2026
6325368
test(wave): fail when a type has no frame where the edges linger
rehmatsg Nov 17, 2026
6408921
test(wave): check the ring and hold lanes of uFront3
rehmatsg Nov 17, 2026
22f59e5
test(wave): check a wave with no source opens from its type's spot
rehmatsg Nov 17, 2026
311d176
test: shaderUniforms throws on a declaration it cannot parse
rehmatsg Nov 17, 2026
07f1e91
test(wave): size the test view from waveTestSize alone
rehmatsg Nov 17, 2026
dc4ec50
test(wave): horizontal dots fly off past the source's right edge
rehmatsg Nov 17, 2026
9fb32be
test(wave): check the dots burn out before the edges are wiped
rehmatsg Nov 17, 2026
2c1b543
test(wave): say what the brightness test checks
rehmatsg Nov 17, 2026
2517a1e
test(wave): give the detached controller's collapse time to show
rehmatsg Nov 17, 2026
a73a9cf
test: say why the Oklab equality test parses its 0.5
rehmatsg Nov 17, 2026
edd0983
test(wave): reword the rim pulse test's comment
rehmatsg Nov 17, 2026
e32de2d
test(wave): cover overshooting easings in the any-easing test
rehmatsg Nov 17, 2026
eec078d
docs: cover the wave and all three shaders in SECURITY.md's scope
rehmatsg Nov 17, 2026
5a9f246
docs: only a pulse rises on BeamSpringCurve.pop
rehmatsg Nov 17, 2026
e722804
docs: describe the agent guide's state, not its history
rehmatsg Nov 17, 2026
3930e05
docs: point at lib/src/border_beam/look/ for the beam's tuning
rehmatsg Nov 17, 2026
fadb99e
docs: beamProgram's doc makes no timing promise
rehmatsg Nov 17, 2026
87a6a9b
docs(wave): move wave_colour.glsl's comments to their functions
rehmatsg Nov 17, 2026
c76ba17
docs: one shader draw plus at most one atlas draw per frame
rehmatsg Nov 17, 2026
c359ed4
docs(wave): WaveStyle.copyWith replaces a group whole
rehmatsg Nov 17, 2026
f73f10d
docs(wave): the center defaults were calibrated, not scaled by 0.6
rehmatsg Nov 17, 2026
b2dd0a3
docs: name WavePalette.fromBeamColors in the README
rehmatsg Nov 17, 2026
7adf4f5
docs: name the image draws the wave's stage never makes
rehmatsg Nov 17, 2026
213be3a
docs: the stage's uniforms are written every frame
rehmatsg Nov 17, 2026
e33f436
docs: ShaderProgram is what core shares; Oklab is the wave's
rehmatsg Nov 17, 2026
6349e03
docs: name compactMaxExtent instead of quoting 56px
rehmatsg Nov 17, 2026
eb6503f
docs: give the full path to rotate_look.dart in effects.md
rehmatsg Nov 17, 2026
d4810d7
docs(wave): WaveRim.thickness mirrors waveRimThickness
rehmatsg Nov 17, 2026
68b8346
docs(wave): a reveal takes its source only from rest
rehmatsg Nov 17, 2026
1ad67d3
docs(wave): the route example measures its button through an anchor
rehmatsg Nov 17, 2026
d869bb4
docs: the package description says where it runs, not one draw
rehmatsg Nov 17, 2026
1c6693b
docs(wave): the wave library is drawn by shaders plus a dot atlas
rehmatsg Nov 17, 2026
3cabf6e
docs(wave): say what the center wave holds still and what it zeroes
rehmatsg Nov 17, 2026
c3620e2
docs(wave): WaveFrameData's stage is written every frame
rehmatsg Nov 17, 2026
d106345
docs(wave): say plainly how squash narrows the front
rehmatsg Nov 17, 2026
e25e32e
chore: suggest 0.3.0 in the bug report's version field
rehmatsg Nov 17, 2026
47539d3
chore(example): name the web app prismatic when installed
rehmatsg Nov 17, 2026
bfa166a
chore(example): record the wave reel with --no-crop
rehmatsg Nov 17, 2026
fc6ba62
docs(example): only the send and step demos fill a phone's screen
rehmatsg Nov 17, 2026
ca8069f
fix(example): keep the display corners each measurement finds
rehmatsg Nov 17, 2026
5ef560d
fix(example): the corner scope keeps one shape when radii arrive
rehmatsg Nov 17, 2026
5523702
fix(example): the legacy corner fallback measures the chosen window's…
rehmatsg Nov 17, 2026
2048530
fix(example): the scrub bar reads and steps the wave for screen readers
rehmatsg Nov 17, 2026
02317d6
fix(example): a screen reader's scrub steps hold the wave
rehmatsg Nov 17, 2026
4d5f885
fix(wave): tell the controller when letting go of a hold starts a run
rehmatsg Nov 17, 2026
6ed8177
docs(wave): say which style ranges are asserted and which are clamped
rehmatsg Nov 17, 2026
a13d3b3
test(wave): pin the particle cache to least-recently-used eviction
rehmatsg Nov 17, 2026
59e8683
docs(security): name material_ui among the runtime dependencies
rehmatsg Nov 17, 2026
2ad8abc
fix(wave): tell the controller of a let-go run after the frame
rehmatsg Nov 17, 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
  •  
  •  
  •  
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ body:
round trip.

Security issues do **not** belong here — see
[SECURITY.md](https://github.com/SimplifyJobs/flutter_border_beam/blob/main/SECURITY.md).
[SECURITY.md](https://github.com/SimplifyJobs/prismatic/blob/main/SECURITY.md).

- type: textarea
id: description
Expand Down Expand Up @@ -72,8 +72,8 @@ body:
- type: input
id: package-version
attributes:
label: flutter_border_beam version
placeholder: "0.2.0"
label: prismatic version
Comment thread
rehmatsg marked this conversation as resolved.
Resolved
placeholder: "0.3.0"
validations:
required: true

Expand Down
6 changes: 3 additions & 3 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
blank_issues_enabled: false
contact_links:
- name: Question or idea
url: https://github.com/SimplifyJobs/flutter_border_beam/discussions
url: https://github.com/SimplifyJobs/prismatic/discussions
Comment thread
rehmatsg marked this conversation as resolved.
Resolved
about: Ask how to do something, or float an idea before it becomes a proposal.
- name: Live demo
url: https://simplifyjobs.github.io/flutter_border_beam/
url: https://simplifyjobs.github.io/prismatic/
about: See every effect and palette in the browser.
- name: Security vulnerability
url: https://github.com/SimplifyJobs/flutter_border_beam/security/advisories/new
url: https://github.com/SimplifyJobs/prismatic/security/advisories/new
about: Report privately. Never in a public issue.
20 changes: 12 additions & 8 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:

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

Expand Down Expand Up @@ -40,17 +40,21 @@ touched, with `--plain-name`.
**Frame budget** — still one draw, no `saveLayer` / clip / image or mask filter:

<!--
`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.
`test/border_beam/render/frame_budget_test.dart` and
`test/distortion_wave/render/wave_frame_budget_test.dart` must pass
unchanged. If you touched a shader's uniforms, say so: `shaders/beam.frag`
moves with `lib/src/border_beam/render/beam_frame.dart` (`beamUniformFloats`),
and `shaders/common/wave_uniforms.glsl` with
`lib/src/distortion_wave/render/wave_frame_data.dart` (`waveUniformFloats`).
The uniform-layout tests check types, counts and order.
-->

## Checklist

- [ ] `BeamOutline` and `color_math.dart` still mirror the shader (if either
side changed)
- [ ] `BeamOutline` still mirrors `shaders/common/outline.glsl`, and
`BeamFrameData.tableAt` the shader's `TABLE_LOOKUP` (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
- [ ] README updated if this changes what a user reaches for first
- [ ] `doc/` updated for any user-facing change (README only if it changes what a user reaches for first)
4 changes: 2 additions & 2 deletions .github/workflows/ci.yaml
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# CI for flutter_border_beam.
# CI for prismatic.
#
# Three things about this workflow are deliberate and easy to get wrong:
#
# 1. The Flutter version is PINNED to 3.50.0 rather than tracking `stable`.
# The golden files in `test/golden/` were generated on Flutter 3.50.0
# The golden files under `test/**/golden/` were generated on Flutter 3.50.0
# (Dart 3.14) on macOS, and shader compilation and rasterization shift
# between Flutter releases. An unpinned `stable` would turn every Flutter
# release into a spurious golden diff. Regenerate the goldens (macOS,
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/pages.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@
# The site is `example/` — the one-screen effect showcase — built for web and
# served at
#
# https://simplifyjobs.github.io/flutter_border_beam/
# https://simplifyjobs.github.io/prismatic/
#
# The root README links to that URL. Pages serves a project site under the
# repo name, so the `--base-href` below must stay `/flutter_border_beam/`.
# repo name, so the `--base-href` below must stay `/prismatic/`.
#
# ── ONE-TIME SETUP THE MAINTAINER MUST DO ────────────────────────────────────
#
Expand Down Expand Up @@ -81,7 +81,7 @@ jobs:
# `https://<owner>.github.io/<repo>/`, not from the domain root.
- name: Build web
working-directory: example
run: flutter build web --release --base-href /flutter_border_beam/
run: flutter build web --release --base-href /prismatic/
Comment thread
rehmatsg marked this conversation as resolved.
Resolved

- name: Add the SPA fallback
working-directory: example
Expand Down
6 changes: 3 additions & 3 deletions .github/workflows/release.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Publish flutter_border_beam to pub.dev and cut a GitHub Release.
# Publish prismatic to pub.dev and cut a GitHub Release.
#
# Trigger: pushing a `vX.Y.Z` tag (a `-suffix` prerelease tag is allowed).
#
Expand All @@ -13,10 +13,10 @@
# the first version is on pub.dev there is nothing to attach automated
# publishing to.
# 2. On pub.dev, open
# https://pub.dev/packages/flutter_border_beam/admin
# https://pub.dev/packages/prismatic/admin
# → "Automated publishing" → "Enable publishing from GitHub Actions", and
# set:
# Repository: SimplifyJobs/flutter_border_beam
# Repository: SimplifyJobs/prismatic
# Tag pattern: v{{version}}
# (You must be an uploader on the package to see the Admin tab.)
# 3. Nothing else. There is no PUB_CREDENTIALS / CREDENTIAL_JSON secret to
Expand Down
8 changes: 5 additions & 3 deletions .pubignore
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,9 @@
#
# `screenshots/` stays in the archive — pub.dev renders the images the
# pubspec's `screenshots:` section points at, so they must ship with the package.
# `shaders/` must stay in the archive too: `beam.frag` is declared under
# `flutter: shaders:` and compiled into every consuming app. Never ignore it.
# `shaders/` must stay in the archive too: the `.frag` files are declared under
# `flutter: shaders:` and compiled into every consuming app, with the
# `shaders/common/*.glsl` they include. Never ignore it.

# ── Mirrors of the root .gitignore ──────────────────────────────────────────
*.class
Expand All @@ -29,9 +30,10 @@ coverage/
# ── Repo-only sources and tooling ───────────────────────────────────────────
assets/
tool/
AGENTS.md
CLAUDE.md
# codecov.yml, plus the uploader binary and its checksums that
# codecov/codecov-action downloads into the working tree in CI.
/codecov*
# Golden reference images only matter to the repo's own CI, not to consumers.
test/golden/
test/**/golden/
Loading
Loading