Repository navigation
Candor 4.5.0
Released 2026-11-12.
A minor, with CLI 2.3.1 and @candor-ui/react 4.5.0; nothing breaks. Steps and conditions dragged into place in
WorkflowEditor's graph, by pointer, keyboard or touch; heading levels on seven items, so they fit under a page's own
headings; the fixes 4.4's reviews found, in the kit, the motion system and the docs MCP; and the fixes the Fable review
of 4.3.0 and 4.4.0 found. The kit has 399 items: 74 free and 368 in Pro.
What to do: npx candor-ui@2 update takes a 4.4 project to 4.5.0, with no codemod. If you use @candor-ui/react,
install 4.5.0, which carries the free fixes to Button, Locked and Progress. Three changes a 4.4 app sees, each
with what to do:
- MonitorCard (Pro) without
onTogglesays "On" or "Off" in words (span[data-slot=monitor-on], the new strings
monitorCard.isOnandisOff) in place of a switch that did nothing when pressed. An unavailable monitor keeps its
switch, locked with the reason. PassonTogglewhere the person can turn the monitor on or off; a test that found
the switch on a card withoutonToggleshould find the words. - DriftChange (Pro) keeps its actions locked once Adopt or Revert has finished, saying "Waiting for the change to
update." (the new stringdriftChange.waitUpdate), until itsstatusleaves"open"or a new change arrives; then
it announces the outcome. Setstatusto"adopted"or"reverted"whenonAdoptoronReverthas done its work;
an app that never sets it leaves the actions locked. - PersonMenu's avatar (Pro) is named after the initials it shows, then its 4.4 name: "PS, Priya Shah, account
menu", through the new stringpersonMenu.withInitials("{initials}, {label}"), so its name starts with what can
be seen. A test that found the avatar by its name should look for the new one; the row form is unchanged.
Translators: these keys are new. Until you translate them, each says its English words, except where noted.
scheduleEditor.announceRuleandannounceRuleAlone, the announcement once the person stops changing the rule.
An app that translated 4.4'sannounceNextand not these still hears its own words, joined as 4.4 joined them.
announceNextis no longer read otherwise; 5.0 removes it.settingsLayout.contentLabel("{item} settings"), the open section's region name. An app that translated
SettingsLayout's other strings and not this one gets 4.4's name, the item's own label.personMenu.withInitials;monitorCard.isOnandisOff;driftChange.waitUpdateandrevertUndo;
modelKey.cancelLocked;permissionMode.changingLocked;linkPreview.userinfo;dateField.readingWithProblem.sessionList.contextWordsandcontextKindShown;cardDeck.dismissedNext,keysMoveDismiss,keysMoveand
keysDismiss;dataTable.sortBy,notSorted,order,ascending,descendingandsortFirst.- IntegrationConnect's hold:
integrationConnect.waitingTitle,waitingNote,blockedTitle,blockedNote,
approveWho,approveWhere,blockedWhat,unblocker,askedAt,holdCheckedAt,checkAgain,checking,
waitCheck,checkFailedandback. - The workflow graph's move:
graphView.places, andworkflowEditor.move,moveNode,moveHint,cancelMove,
cancelMoveNode,triggerFixed,placeAt,placeHere,pickedUpandputBack.
Some DOM your own CSS or tests may match has changed:
- SettingsLayout's open section (Pro) is a region named "{item} settings" ("Members settings"), no longer the item's
label alone, so it no longer shares "Members" with MembersTable's section. A test that found the region by the item's
label should use the new name. - PermissionMode (Pro), while a change of mode is on its way, keeps the other modes focusable,
aria-disabledin
Lockedwith the reason "Changing the mode" (permissionMode.changingLocked), notdisabled, and focus stays where
it was. A test that expected them disabled should checkaria-disabled="true". - CardDeck (Pro) lists its keys in
aria-keyshortcutsand describes them in[data-slot=card-deck-hint], shown
while the stack has keyboard focus. Once the app has taken a dismissed card out, it announces "{card} dismissed.
{next}, 2 of 5" once, in place of "{card} dismissed". A test expecting the shorter announcement should expect the
sentence. Backspace still dismisses. - AppLayout's app frame (Pro) draws no
<header>when there is nobrand, notopand no menu button; the
banner's row collapses. A test that expected an empty banner landmark there should expect none. Locked(free), without a reason, hands back the control as it is: it no longer gives it an id or a tooltip
trigger's attributes and handlers, so an app's ownTooltipTriggerround it finds the app'sTooltip. Locked's
tooltip now sits beside the control rather than round it.lockedimports@base-ui/react/tooltip. EachLocked
also has its own tooltip provider, on yourTooltipProvider's timing, so moving from one locked control to the next
waits the provider'sdelayagain rather than opening at once within itstimeout. Nothing to change in the app; a
test that expected the next locked control's tooltip at once should wait for it.- LinkPreview (Pro) shows the scheme and host the browser goes to: lower-cased, an international name as its
punycode, without a user name or password. An address that carries one has a note under it,
[data-slot=link-preview-userinfo](linkPreview.userinfo). A test that matched the address as written should
match the host as the browser reads it. - DataTable's stacked form (Pro) has
[data-slot=data-table-sort]above its cards whenever it has rows. - ReorderableList's drag ghost (Pro),
[data-slot=reorderable-list-ghost], and GraphView's new one are drawn
throughLayerPortal, at the end of<body>(or in the layer host inside another library's dialog), so inside a
Dialog or Sheet the ghost sits beside the pointer and isn't cut off by the window. A test that looked for the ghost
inside the list should look indocument. - Tabs (Pro) leave
data-tab-valueoff a tab whose value is an object or a function, where 4.4 wrote "[object
Object]"; strings, numbers, booleans,nulland bigints keep it. - Added attributes, with nothing to do: LineChart's plot carries
data-plot-dir="ltr"; GraphView's node buttons, and
the backdrops of Dialog, AlertDialog, Sheet and Drawer, carry their moment's motion chain in their ownstyle, with
the caller's style merged over it; DriftChange's Revert confirmation has[data-slot=drift-change-revert-undo].
New items (Pro)
@candor/initials, a lib item:initialsOf(name, locale?), the first letter of each of a name's first two
words, upper-cased inlocale("ilker" is "İ" in Turkish, "I" in English). Left out, the letters are upper-cased the
same in every language, so the server and the browser agree. PersonMenu and Board import it, so installing Board no
longer brings in PersonMenu;person-menustill exportsinitialsOffor apps that import it from there.
Components
- WorkflowEditor (Pro): steps and conditions move in the graph view. Drag one with a mouse or pen to a place
between two nodes or into a branch, or press the Move button on its card under the graph: the arrow keys choose a
place, Enter drops it there and Escape puts it back, each step said; on a touch screen, tap a place, or Cancel. The
layout stays automatic. A move is marked "Moved by you" and Undo takes it back. The trigger always comes first, and
its Move button says so. Escape during a move or a drag doesn't close a Dialog or Sheet the editor is in. - GraphView (Pro) takes
places, a function giving the places a node can go (GraphViewPlace, in the layout's
layer and slot),onPlace(a drop) andmoving(a keyboard move the app draws). While a move is on, each place is a
button named by its place, out of the tab order. After a drop the nodes that moved slide, asettlemoment in the
move family. Withoutplacesa graph draws as before, so Plan, RunTree and Diagram are unchanged. headingLevel(Pro) on ReorderableList (its group heads, default 4), Board (its column heads, default 4),
BoardCard (one below its board's heads; used alone, 5), DataTable (its title, default 3; the stacked form's group
heads and cards below it), ApprovalDecision (1 to 6, default 3), MonitorCard (default 3) and EnvironmentList
(default 3), so each fits under a page's own headings. ApprovalRequest and PortfolioCard already had it. The defaults
are 4.4's levels, so nothing a 4.4 page draws changes.- IntegrationConnect (Pro) takes
hold(IntegrationHold,"waiting"or"blocked"),onCheckAgainand
onBack, as EnvironmentConnect does: who has to approve the app, where and when it was asked and checked, or whose
policy blocks it and who can unblock it. Withoutholdnothing changes; once connected,holdis ignored. The names
in a hold are another tenant's text, neutralised and drawn in a<bdi>. - SessionList (Pro):
contextKind="visible"prints the context's kind before its chip ("Approval · Quote over
$50k"); the default,"name", reads it in the chip's name only, as in 4.4. - ScheduleEditor and SessionList (Pro) build their sentences from strings with placeholders (
announceRule,
announceRuleAlone,contextWords), not by joining words in code, so a translation can order them. - DataTable (Pro):
stackBelowis measured before the first paint, so a phone never draws the wide table first;
server-rendered HTML shows the wide table until it hydrates. The stacked form has a Sort by control (a column, or Not
sorted) and Ascending and Descending above the cards: the same sort as the column heads, asked of the server in
server mode and kept when the table widens. Nothing is chosen until the person chooses. - ConfirmField (Pro) takes
entryandonEntryChange, to control the second entry;entry=""resets it and its
judgement. Both entries are compared afternormalize("NFC"), so a name typed with a combining accent matches; case
and spacing still count. "Matches" is withdrawn as soon as either entry changes. - PlanPicker (Pro): the totals' value moment waits a second with no More or Fewer press, then plays once for the
settled total; a typed seat number doesn't play it. A test of the moment should advance timers by 1000 ms. - NumberInput (Pro) replays its value moment only on a step: clearing
attendno longer replays it, and a step
pressed whileattendrings doesn't replay the ring. - MaskedInput (Pro): a literal in the mask that would fit a slot ("+1 ###") is no longer read as typed input.
MaskedInput and NumberInput read digits in every script. - DateField and DateRangeField (Pro) take
onProblemChange: what is wrong with what the field last read
(unreadable,pastMonthEnd,beforeMin,afterMax) ornull. After text it couldn't read, the app'svalueis
still the last date it read, so check this before saving a controlled field. In a locale whose calendar isn't the
Gregorian one (Thai's Buddhist, Persian's Solar Hijri), the date in words carries its era. Enter announces the
reading. - AppLayout (Pro):
useHideOnScroll'sheadertakes the element as well as a ref, so a header that mounts later
still hides and comes back. When a hidden banner unmounts, the frame moves back. - DialogContent (Pro) gives the window to an app's
ref, an object or a callback, and keepsfrom="trigger"
working; before, an app's ref turned it off without a word. Dialog's nudge ring is drawn inside the window's edge, so
a scrolling window doesn't clip it. - ModelKey (Pro): while a replacement key is being checked, Cancel is locked and says why
(modelKey.cancelLocked); Replace opens with nothing from an earlier attempt. - DriftChange (Pro) takes
revertUndo, whether a reverted change can be had again, in the app's words; left out,
Revert's confirmation says it isn't kept (driftChange.revertUndo). See the list above for its locked actions. - Focus kept on the page (Pro): FlipCard moves focus to its button when the app sets
flippedwhile focus is in
the face turning away. NeedsYouLine passes Retry's focus to the line when Retry goes, even after a blur to nowhere.
FilterChips' Clear all passes over what Tab can't reach (hidden, inert, disabled,aria-hidden,tabIndex-1),
and removing the only chip keeps focus on the page. EnvironmentList takes focus back only from the page itself, not
from where the person is. - ReorderableList and Board (Pro): removing the held item ends the move.
- Tabs and DropdownMenu (Pro): an app's callback ref runs once, and its cleanup runs. Tabs find the chosen tab by
its order, so the panel's arrive moment travels the right way for any value. - Command (Pro): a controlled
valueon a disabled item, or one two items share, no longer loops. - GlideHighlight (Pro) puts back its host's position and isolation when it unmounts.
- RunEstimate (Pro) counts down from when
endsAtis given, not from when the card mounted, and stops after it. - SliderMarks (Pro): a locked slider ignores the range input's change event.
- ScopeSwitcher (Pro): a locked level's reason describes its items.
- SectionNav (Pro) links sections that arrive after it mounts.
initialsOftakes an optional locale (see@candor/initials); PersonMenu and BoardCard pass LocaleProvider's
language. Without a locale it now upper-cases the same in every language, where 4.4's followed the runtime's (a
Turkish runtime gave "İ", now "I"). An app that calls it fromperson-menuwithout one and wants the language's
letters passesuseLocale().locale.- Button (free): Enter, Space or a click with no pointer clears the press point (
--cd-press-x,--cd-press-y),
so the Pro ripple grows from the middle; the app's ownonKeyDownandonClickstill run. - Progress (free) is seen in forced colours: a measured bar is filled in
Highlighton aCanvastrack edged in
CanvasText, and an indeterminate bar shows aHighlightband, never a full bar.
Motion (Pro motion-drawings)
- Backdrops follow their window. Dialog's, AlertDialog's, Sheet's and Drawer's backdrops carry their item's open
chain, so they fade in their own open time and a brand's--cd-motion-<item>-open-*reaches them; in 4.4 a sheet's
dim faded in 150 ms while its panel took longer. --cd-draw-button-icon: expandshows an icon button's name beside it without widening it or moving its
neighbours, and leaves its position andz-indexto the app. Where the browser has anchor positioning the name is
anchored to the button, so it adds no sideways scroll at the end of a row, and goes to the button's start when its
end has no room for it.- At the Off level an indeterminate Progress with a Pro drawing (travel, refill, stripes) shows the free still band,
in forced colours too; in 4.4 travel showed a still bar 40% full and refill a full one. In forced colours the Pro
bands are drawn inHighlight. - Drawings travel the right way when an element's direction comes from
dir="auto"or the browser
(--cd-inline-signfrom:dir()). - In a right-to-left page a line chart's line draws in from its first point, the end its points pop in from.
- The button press spring falls back to the press family's 0.96 and 150 ms.
- 4.1's chart rule on
svg[role="img"], which matched nothing since 4.2, is gone; charts still draw in. --cd-tab-signis the kit's own, set by TabsContent, not a token:theme checksays so if a brand file sets it.
Remove the line.
CLI 2.3.1
update --differing keep, whereaddcan't plan the project itself (tsx: false, or no tsconfig paths), keeps
every file on disk that shadcn's own dry run lists for the install, including ones the lockfile doesn't record, such
aslib/utils.ts. 2.2.1 to 2.3.0 kept only the files the lockfile recorded as changed, and shadcn replaced the rest.
Both modes name the files the install changed, and a dry run that can't be read stops before anything is written.theme check(also the docs MCP'stheme_check) warnsmotion-valueon a--cd-show-*or--cd-draw-*value
the item doesn't draw, naming the values it takes;noneandvar()aren't judged. The exit code doesn't change.theme checkand the theme builder no longer say thatmark: fadeandpop: riseneed the Pro item: their
keyframes are in the freecandor.css.
Docs and the docs MCP
suggest_componentsanswers "a table with sortable columns" and "a sortable table" withdata-tablefirst.
DataTable's description now says what people ask for (search, sort, filter, page and select rows), and Table's says it
is the plain elements; "a plain table" still answerstable. Withsdk: "claude", a related Premium block is judged
as the version the ranking found, so its-claudeversion is no longer dropped for its own words; no answer on
today's index changes.
Site and repository
/screens: thehome-dashboardbrief scores as a weighted mean of its subscores and usesDashboardGridas
/apps/workspacedoes;/screens/app-shell#topbarlands on "Workspace frame".- App examples: the board's TW-110 moves from Building, not "Waiting for you"; the workspace's "Value a year" and
its client estimates say saved or reclaimable, as an estimate with its basis. - The 4.3.0 section of this file labelled Dialog, the menus, Command and nested dialogs "(free)"; they are Pro, and the
labels say so.
For maintainers
check:motionchecks each@easeline'sovershootsagainst its values; that every show or control rule leaves
outdata-motion="calm"and"none", scales by a level and loops only while running; and that an element whose
class names a family utility carries its moment's chain in its own style (a component's{...props}doesn't count).
Known problems in files no stream owned are inscripts/motion-baseline.json, each with its row; an entry that stops
matching fails, so the list can only shrink.npm run test:browser -- --only <group>reaches the runner that has the group (tests/browser/run.mjs).- The layer checks open PersonMenu's and ScopeSwitcher's menus in a Radix dialog.
tests/repo/changelog-tiers.test.tsfails when a bold label in this file says "(free)" of a Pro item.