Skip to content

Candor 4.5.0

Choose a tag to compare

@arunk3 arunk3 released this 13 Nov 05:03
· 10 commits to main since this release

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 onToggle says "On" or "Off" in words (span[data-slot=monitor-on], the new strings
    monitorCard.isOn and isOff) in place of a switch that did nothing when pressed. An unavailable monitor keeps its
    switch, locked with the reason. Pass onToggle where the person can turn the monitor on or off; a test that found
    the switch on a card without onToggle should find the words.
  • DriftChange (Pro) keeps its actions locked once Adopt or Revert has finished, saying "Waiting for the change to
    update." (the new string driftChange.waitUpdate), until its status leaves "open" or a new change arrives; then
    it announces the outcome. Set status to "adopted" or "reverted" when onAdopt or onRevert has 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 string personMenu.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.announceRule and announceRuleAlone, the announcement once the person stops changing the rule.
    An app that translated 4.4's announceNext and not these still hears its own words, joined as 4.4 joined them.
    announceNext is 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.isOn and isOff; driftChange.waitUpdate and revertUndo;
    modelKey.cancelLocked; permissionMode.changingLocked; linkPreview.userinfo; dateField.readingWithProblem.
  • sessionList.contextWords and contextKindShown; cardDeck.dismissedNext, keysMoveDismiss, keysMove and
    keysDismiss; dataTable.sortBy, notSorted, order, ascending, descending and sortFirst.
  • IntegrationConnect's hold: integrationConnect.waitingTitle, waitingNote, blockedTitle, blockedNote,
    approveWho, approveWhere, blockedWhat, unblocker, askedAt, holdCheckedAt, checkAgain, checking,
    waitCheck, checkFailed and back.
  • The workflow graph's move: graphView.places, and workflowEditor.move, moveNode, moveHint, cancelMove,
    cancelMoveNode, triggerFixed, placeAt, placeHere, pickedUp and putBack.

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-disabled in
    Locked with the reason "Changing the mode" (permissionMode.changingLocked), not disabled, and focus stays where
    it was. A test that expected them disabled should check aria-disabled="true".
  • CardDeck (Pro) lists its keys in aria-keyshortcuts and 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 no brand, no top and 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 own TooltipTrigger round it finds the app's Tooltip. Locked's
    tooltip now sits beside the control rather than round it. locked imports @base-ui/react/tooltip. Each Locked
    also has its own tooltip provider, on your TooltipProvider's timing, so moving from one locked control to the next
    waits the provider's delay again rather than opening at once within its timeout. 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
    through LayerPortal, 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 in document.
  • Tabs (Pro) leave data-tab-value off a tab whose value is an object or a function, where 4.4 wrote "[object
    Object]"; strings, numbers, booleans, null and 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 own style, 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 in locale ("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-menu still exports initialsOf for 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) and moving (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, a settle moment in the
    move family. Without places a 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"), onCheckAgain and
    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. Without hold nothing changes; once connected, hold is 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): stackBelow is 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 entry and onEntryChange, to control the second entry; entry="" resets it and its
    judgement. Both entries are compared after normalize("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 attend no longer replays it, and a step
    pressed while attend rings 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) or null. After text it couldn't read, the app's value is
    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's header takes 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 keeps from="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 flipped while 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 value on 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 endsAt is 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.
  • initialsOf takes 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 from person-menu without one and wants the language's
    letters passes useLocale().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 own onKeyDown and onClick still run.
  • Progress (free) is seen in forced colours: a measured bar is filled in Highlight on a Canvas track edged in
    CanvasText, and an indeterminate bar shows a Highlight band, 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: expand shows an icon button's name beside it without widening it or moving its
    neighbours, and leaves its position and z-index to 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 in Highlight.
  • Drawings travel the right way when an element's direction comes from dir="auto" or the browser
    (--cd-inline-sign from :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-sign is the kit's own, set by TabsContent, not a token: theme check says so if a brand file sets it.
    Remove the line.

CLI 2.3.1

  • update --differing keep, where add can'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
    as lib/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's theme_check) warns motion-value on a --cd-show-* or --cd-draw-* value
    the item doesn't draw, naming the values it takes; none and var() aren't judged. The exit code doesn't change.
  • theme check and the theme builder no longer say that mark: fade and pop: rise need the Pro item: their
    keyframes are in the free candor.css.

Docs and the docs MCP

  • suggest_components answers "a table with sortable columns" and "a sortable table" with data-table first.
    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 answers table. With sdk: "claude", a related Premium block is judged
    as the version the ranking found, so its -claude version is no longer dropped for its own words; no answer on
    today's index changes.

Site and repository

  • /screens: the home-dashboard brief scores as a weighted mean of its subscores and uses DashboardGrid as
    /apps/workspace does; /screens/app-shell#topbar lands 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:motion checks each @ease line's overshoots against its values; that every show or control rule leaves
    out data-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 in scripts/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.ts fails when a bold label in this file says "(free)" of a Pro item.