@cognite/aura 1.47321.0 → 1.47367.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognite/aura",
-  "version": "1.47321.0",
+  "version": "1.47367.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": [

package/src/components/ui/core/breadcrumb/breadcrumb.md

@@ -0,0 +1,45 @@
+Use a Breadcrumb to show users where the current page sits in the product hierarchy and let them return to its ancestors.
+Breadcrumbs are location-based, not path-based: they reflect the structure of the product, not the user's browsing history.
+
+## When to use
+
+- Users need to return to a parent page.
+- Users need clarity on their current position in the product hierarchy.
+- Quick access to ancestor pages is useful.
+
+## When to use something else
+
+- Leave out the Breadcrumb when the page structure is flat and there is no hierarchy to show.
+- Use [Tabs](?path=/docs/primitives-tabs--docs) or a [Segmented Control](?path=/docs/primitives-segmented-control--docs) when users switch between pages at the same level.
+
+## Content
+
+- Wrap a `BreadcrumbList` in `Breadcrumb`, and put each step in a `BreadcrumbItem` with a `BreadcrumbSeparator` between items.
+- Use `BreadcrumbLink` for ancestor pages and `BreadcrumbPage` for the current page.
+- Use `BreadcrumbPageButton` instead of `BreadcrumbPage` when the current page opens a [Dropdown Menu](?path=/docs/primitives-dropdown-menu--docs) of page actions, such as rename or delete.
+- Keep labels short and match them to the titles of the pages they link to.
+
+## Overflow
+
+- When space is limited, condense the middle items into a `BreadcrumbEllipsis`, keeping the first item and the last two visible.
+- Wrap the ellipsis in a [Dropdown Menu](?path=/docs/primitives-dropdown-menu--docs) trigger so users can still reach the hidden pages.
+- The current page always stays visible.
+
+## Dos and don'ts
+
+- **Do** truncate long labels and show the full text in a [Tooltip](?path=/docs/primitives-tooltip--docs).
+- **Don't** make the current page a link.
+- **Don't** pair a Breadcrumb with a back button.
+- **Don't** wrap labels onto multiple lines.
+- **Don't** show more than one Breadcrumb trail on a page.
+
+## Behavior
+
+- The Breadcrumb renders as a `nav` landmark labelled "breadcrumb".
+- Every link except the current page is reachable with Tab and Shift+Tab and activates with Enter.
+- The current page has `aria-current="page"` and is not focusable.
+- Separators are hidden from assistive technology.
+
+## Often used with
+
+[Topbar](?path=/docs/primitives-topbar--docs), [Tooltip](?path=/docs/primitives-tooltip--docs) for truncated labels, and [Dropdown Menu](?path=/docs/primitives-dropdown-menu--docs) for overflow items and page actions.

package/src/components/ui/core/button-group/button-group.md

@@ -0,0 +1,38 @@
+Use a Button Group to join related buttons into one connected row, showing that the actions belong to the same context.
+
+## When to use
+
+- Two or more actions are closely related and act on the same target, such as text alignment or a split button.
+- Saving horizontal space compared with spacing individual [Buttons](?path=/docs/primitives-button--docs) apart.
+
+## When to use something else
+
+- Use separate [Buttons](?path=/docs/primitives-button--docs) when the actions are unrelated.
+- Use a [Toolbar](?path=/docs/primitives-toolbar--docs) or a [Dropdown Menu](?path=/docs/primitives-dropdown-menu--docs) when there are more than a handful of actions.
+- Use a [Segmented Control](?path=/docs/primitives-segmented-control--docs) when the buttons switch between views rather than run commands.
+
+## Content
+
+- Put `Button`s directly inside the group so their borders and corners join.
+- Add `ButtonGroupText` for a short, non-interactive label at the start of the group.
+- Add `ButtonGroupSeparator` to split sub-groups of actions within one group.
+
+## Orientation
+
+- Groups are horizontal by default.
+- Set `orientation="vertical"` to stack buttons, for example in a narrow side panel.
+
+## Dos and don'ts
+
+- **Do** use the same `variant` and `size` for every button in a group.
+- **Do** give icon-only buttons an `aria-label` and pair them with a [Tooltip](?path=/docs/primitives-tooltip--docs).
+- **Don't** group more than a small set of actions.
+
+## Behavior
+
+- The group has the `group` role, so assistive technology announces its buttons together.
+- Each button stays a separate Tab stop.
+
+## Often used with
+
+[Button](?path=/docs/primitives-button--docs), [Tooltip](?path=/docs/primitives-tooltip--docs) for icon-only buttons, and [Dropdown Menu](?path=/docs/primitives-dropdown-menu--docs) for split buttons.

package/src/components/ui/core/collapsible/collapsible.md

@@ -0,0 +1,42 @@
+Use a Collapsible to show or hide one optional block of content inline.
+It is designed for a single independent section, not for several stacked sections.
+
+## When to use
+
+- Showing one optional or secondary block of content, such as AI reasoning, advanced settings, or a preview.
+- The content is useful but not essential to the primary task.
+
+## When to use something else
+
+- Use an [Accordion](?path=/docs/primitives-accordion--docs) when there are several expandable sections.
+- Show the content by default when it is essential.
+- Use [Tabs](?path=/docs/primitives-tabs--docs) or filter controls when users are navigating or filtering.
+
+## Content
+
+- Put the always-visible trigger in `CollapsibleTrigger` and the hidden content in `CollapsibleContent`.
+- Render the trigger as a ghost [Button](?path=/docs/primitives-button--docs) through the `render` prop, with an `IconSelector` at the end that rotates when open.
+- Write a descriptive trigger label that says what is inside, such as "Advanced settings" rather than "More".
+
+## State
+
+- Collapsibles start collapsed; set `defaultOpen` to start open.
+- Use `open` with `onOpenChange` when the state lives elsewhere.
+- Set `disabled` to stop the section from opening or closing.
+
+## Dos and don'ts
+
+- **Do** default to collapsed unless the content is the main purpose of the view.
+- **Don't** nest Collapsibles; use an [Accordion](?path=/docs/primitives-accordion--docs) for layered disclosure.
+- **Don't** hide errors or required information inside a Collapsible.
+
+## Behavior
+
+- One trigger controls one content region.
+- Clicking the trigger, or pressing Space or Enter while it has focus, toggles the content.
+- The trigger exposes the open state to assistive technology through `aria-expanded`.
+- The content stays mounted while closed, so form fields inside keep their values.
+
+## Often used with
+
+[Button](?path=/docs/primitives-button--docs) as the trigger, [Badge](?path=/docs/primitives-badge--docs) for counts in the trigger, and [Separator](?path=/docs/primitives-separator--docs) between stacked Collapsibles.