GUILD OF GLEKS UIv21.19.0

@guildofgleks/ui

Releases

The changelog shipped inside the package this site was built against — v21.19.0. It is read from node_modules at build time rather than copied here, so it cannot describe a version different from the one documented on every other page.

All notable changes to @guildofgleks/ui are documented here. Format follows Keep a Changelog. From 21.16.0 the package follows semantic versioning: a patch fixes, a minor adds, and only a major breaks — see the README's Versioning section. Before 21.16.0 a minor could carry a breaking change, and its entry said so.

05.10.2026

Changed

  • gog-chip's avatar is a gog-avatar, at the chip's own em-based size: a broken avatarUrl falls back to the initials of avatarAlt, or the person icon, instead of the browser's broken-image glyph. No avatarAlt keeps it decorative, as alt="" did; with one it is named by it, as before. Measured on the showcase's Chip page: the same 17 to 27px across the five sizes as the <img> it replaces.
  • A labelled gog-skeleton is an indeterminate role="progressbar", not role="status" — the role gog-spinner has taken since 21.15.0, so a loading area reads "progress bar, Loading profile" whichever of the two draws it. status was a live region that never spoke (a skeleton has no text to announce), so nothing a screen reader used to say is lost. An unlabelled skeleton is unchanged: hidden.

Added

  • 95 more built-in icons, 136 in all, from the same Lucide set: navigation and layout (home, log-in, grid, dashboard, drag, zoom-in…), actions (save, share, link, send, undo, redo…), files and media (file, folder, image, play, volume…), communication (bell, message, phone, globe…), people and status (users, heart, help, shield, key…), commerce and data (shopping-cart, credit-card, tag, chart-bar, trending-up…) and appearance (sun, moon, monitor…). Every name works in <gog-icon name="…"> with no setup; AGENTS.md lists them all. The whole set adds 4.5 KB gzipped to an app (1.8 KB to 6.3 KB), since the registry ships whole. Each glyph passes check:geometry's centring law — play was moved one unit left and tag's hole is stroked rather than filled to get there.
  • gog-table takes a gogTableEmpty template, shown in place of emptyMessage when there are no rows. With a gog-empty-state in it, a table emptied by a filter is announced — the text cell never was. New export from @guildofgleks/ui/table: GogTableEmptyDirective.
  • gog-radio-group takes optionLabel, optionValue and optionDisabled, like every other collection control: your own objects, read by property path or function, instead of mapping each domain list into { id, label, disabled? } first. The defaults read exactly that shape, so every existing binding is unchanged. The value is still a string or a number.
  • gog-slider takes valueFormat, one function that writes the readout, the min and max labels and each thumb's aria-valuetext: a price range reads "€40 – €120" on screen and "€40" to a screen reader, where it used to say "40" with the unit only in the label. The readout's reserved width is measured on the formatted endpoints, so it still does not shift while dragging.
  • gog-table takes ariaLabel, which names the table and, whenever its columns overflow, the scrolling region that makes it reachable by Tab. A table had no way to be named at all, and an overflowing one was an unnamed region in the tab order.
  • A dev-mode warning for a component that needs a name and has none: gog-progressbar, gog-tabs, gog-scroll while it is a scrolling region, and gog-table through it. Each needs a name only the app can give — a default like "Loading" on a bar measuring an upload says something false — so an unnamed one used to ship silently, read as "progress bar, 62 percent" of nothing. One console.warn per component per page, never in production.

Documentation

  • gog-tabs' activeIndex documents what happens when it names a disabled tab: the first enabled tab is shown and the model keeps the value it was given, on purpose — a tab disabled while its data loads is selected again once it is enabled, which writing the shown index back would lose.
  • AGENTS.md says that gog-calendar is not an event calendar — a date grid that picks a day, a range or a time, with no week or day view and nothing that places events. "Calendar" also names full-page schedulers, and an agent asked for a booking view could otherwise reach for it.