@cognite/aura 0.3.5 → 1.46105.0

package/CHANGELOG.md

@@ -0,0 +1,264 @@
+## [1.0]
+
+Aura is now built and published from the `cognitedata/infrastructure` monorepo, and this is its first stable major release.
+Published versions follow `1.<commit count>.0`.
+PR references prefixed with `cognitedata/fusion` were merged in Fusion before the move; bare references are infrastructure PRs.
+
+### Added
+
+- Added `Item` compositional list-row primitive with group, media, actions, tree chevron, checkbox, indent, and section-header parts for flexible lists and tree views, exposed as `@cognite/aura/components/item`. [KCIH-1095] cognitedata/fusion#27311
+- Added `Tree` hierarchical list primitive with chevron expand/collapse and optional cascading checkboxes built on Headless Tree and `Item` rows, exposed as `@cognite/aura/components/tree`. [KCIH-1096] cognitedata/fusion#27705
+- Added `Conversation` primitives, exposed as `@cognite/aura/components/conversation`. [AX-442] cognitedata/fusion#26450
+- Promoted a reworked `Toolbar` from Aura Labs into Aura core, exposed as `@cognite/aura/components/toolbar`. cognitedata/fusion#25809, cognitedata/fusion#26566
+- Added the `OverflowList` component. cognitedata/fusion#25117
+- Added the `TimeRangePicker` component to `@cognite/aura/components/date-time-pickers`. cognitedata/fusion#25240
+- Date and time pickers now accept a dynamic date type instead of requiring `dayjs`. cognitedata/fusion#25929
+- `DateTimeRangePicker` now derives its display format from `timeFormat`. #40757
+- Added `DataGrid` header and footer slots, pagination, row selection, search composables, a filter clause model with evaluator and filter trigger, and a filter panel. cognitedata/fusion#26312, cognitedata/fusion#26315, cognitedata/fusion#26319, cognitedata/fusion#26320, cognitedata/fusion#26321, cognitedata/fusion#26916
+- Exported the `DataGrid` table types. cognitedata/fusion#28354
+- `Popover` can now anchor to a supplied box instead of its trigger. cognitedata/fusion#28300
+- Added a native `Combobox` trigger and form control API. cognitedata/fusion#27903
+- `MessageResponse` now renders LaTeX math via KaTeX. [AX-691] #40775
+- Added `CountUnit`, `CountValue`, and a `success` variant to `Count`, `TabsListSeparator` and `showSeparator` to `Tabs`, and `chartSeriesColor` and `CHART_SERIES_COLOR_TOKENS` to `@cognite/aura/chart`. #40894
+- Exposed component docs and gallery examples via the `@cognite/aura/docs/*` and `@cognite/aura/examples/*` subpaths. #40772
+
+### Changed
+
+- Regenerated `colors.css` from the Figma Reflect tokens and synced form, overlay, navigation, button, AI, and chart components to them. cognitedata/fusion#26261, cognitedata/fusion#26265
+- Deprecated the legacy color tokens, which are now aliases of the `colors.css` tokens and live in `@cognite/aura/colors-deprecated.css`. cognitedata/fusion#26260, cognitedata/fusion#26644
+- Unified the decorative variant slots for `Badge` and `Avatar` while preserving the legacy ramp steps. cognitedata/fusion#26643, cognitedata/fusion#27170
+- Removed `ItemIndent` and `ItemChevron` from `Item`; use `Tree` for hierarchical rows.
+- Improved the visibility and interaction styles of the destructive `DropdownMenu` variant. cognitedata/fusion#26743
+
+### Fixed
+
+- The month and year dropdowns in `Calendar` now scroll to the current selection on open. cognitedata/fusion#26487
+- The toast action now stays visible beside a long title. cognitedata/fusion#26556
+- Restored the `--gradient-active` shimmer token. cognitedata/fusion#26661
+- `Tool` only highlights output as JSON when it actually is JSON. [APF-931] cognitedata/fusion#26805
+- `OverflowList` now renders `<li>` items inside `<ol>`, `<ul>`, and `<menu>` containers. cognitedata/fusion#27226
+- Fixed leftover `Calendar`, `Banner`, and `Button` color tokens. cognitedata/fusion#27119
+- `MessageResponse` now applies host attributes and `data-slot`. [AUR-660] cognitedata/fusion#28085
+
+### Internal
+
+- Moved Aura from Fusion into the infrastructure monorepo at `lib/ts/aura`. cognitedata/fusion#28227
+- Storybook now applies the shared `#theme=` hash, and the Theme Tokens story was rebuilt from the regenerated ramps. cognitedata/fusion#26262, cognitedata/fusion#26678
+- Updated `DESIGN.md` for the Reflect color token structure. cognitedata/fusion#27175
+- Added `OverflowList` stories and fixed the `Toolbar` stories build. cognitedata/fusion#25118, cognitedata/fusion#26834
+- `Button` docs are now rendered from portable markdown. #40772
+
+## [0.3.5] - 2026-07-31
+
+### Added
+
+- Exposed `@cognite/aura/data-grid` with the composed `DataGrid` component — a virtualised table with client/server sorting, column pinning, and expandable rows. Requires `@tanstack/react-table` and `@tanstack/react-virtual` as peer dependencies. Pagination, selection, search, filters, and loading states are landing in follow-up releases. #25853, #25854, #26332
+
+### Changed
+
+- Refactored `SegmentedControl` to use a composite-agnostic sliding indicator, decoupling the animation from specific child component types. #25379
+
+## [0.3.4] - 2026-07-30
+
+### Added
+
+- Promoted `Slider` from Aura Labs into Aura core. #25877
+- Exposed `Calendar` as a standalone component via `@cognite/aura/components/calendar`. #25382
+- Added internal `useDateTimePicker` and `useTimeRangePicker` hooks backing upcoming `DateTimePicker`/`TimeRangePicker` components; not yet part of the public API. #25242, #25239
+- Added DataGrid cell and row primitives as foundation for data table rendering; not yet part of the public API. #25855
+- Added `OverflowList` order and measurement utilities for managing dynamic lists, will be used as part of an upcoming OverflowList component. #25900
+
+### Changed
+
+- Widened ESLint peer dependency range to `^9.6.0 || ^10.0.0`, supporting both ESLint 9 and 10. Aura's ESLint plugin (`@cognite/aura/eslint`) remains compatible with both versions, enabling consumers to upgrade for npm audit security fixes in the `minimatch` and `brace-expansion` dependency chain (resolving [GHSA-mh99-v99m-4gvg](https://github.com/advisories/GHSA-mh99-v99m-4gvg)). #26271
+
+### Fixed
+
+- Removed the one remaining npm-imported cogs package reference in Aura, part of a repo-wide cleanup. #25916
+
+## [0.3.3] - 2026-07-23
+
+### Added
+
+- Added a `collapsible` mode to `Sources` (`collapsible`, `defaultOpen`, `open`, `onOpenChange`), rendering the title as a trigger that toggles a `Collapsible` panel around the source items. #25832
+- Exposed the approved Tabler icon set from `@cognite/aura/icons`, with base-layer size/stroke defaults consumers can override with Tailwind utilities. #25927
+- Added a dedicated `@cognite/aura/highlight-code` entry point for the Shiki-backed `highlightCode` helper, split out of `@cognite/aura/utils`. #25426
+- Added an `active` gradient variant to `Shimmer`. #25905
+
+### Changed
+
+- Removed the `iconUrl` prop and CSS-mask icon rendering from `Shimmer` (added in 0.3.2); icon shimmering is no longer supported through this prop. #25905
+- Bumped the `@base-ui/react` peer dependency to `^1.6.0`, fixing an OXC cross-module compress miscompile that broke `Popover`/`Select`/`DropdownMenu` dismiss behaviour under Vite 8 builds. Note this version also changes accessible-name computation: radio/checkbox controls wrapped in a visible label no longer need an explicit `aria-label`, as `1.6.0` auto-associates the label via `aria-labelledby`. #26012
+
+### Fixed
+
+- `Switch` and `Combobox` are now exported from the aggregate barrel and registered as per-component subpath exports; both were built but previously unreachable from `@cognite/aura/components`. #25849
+- `DropdownMenuTrigger` now forwards refs, so Base UI composite components (e.g. Toolbar) that pass a ref via render prop no longer skip it during keyboard navigation. #25380
+- `Command`'s border radius now matches `Popover`'s (`rounded-xl` instead of `rounded-lg`). #25377
+- `CodeBlock` no longer renders the collapsed fade-out gradient on single-line content, which isn't collapsible. #25512
+- Decoupled the shared `cn` helper from Shiki so per-subpath imports (e.g. `@cognite/aura/components/card`) no longer transitively load the Shiki graph; only `CodeBlock` pulls it in, and lazily. #25426
+
+### Internal
+
+- Added foundation Storybook stories for colours, layout, typography, and effects tokens. #23528, #23529, #23562
+- Documented motion guidelines (roles, timing, easing, animatable properties, Tailwind transition utilities) in `DESIGN.md`. #25913
+- Documented icon usage, sizing, and skills tables in `DESIGN.md`. #25446
+- Removed the `memo` wrapper from `MessageResponse` as part of adding Streamdown streaming-animation support. #25539
+
+## [0.3.2] - 2026-07-03
+
+### Added
+
+- Added a standalone `TimePicker` to Aura core with 12h/24h modes and am/pm handling (typed so 12h mode requires an `ampm` value), exposed from the package root and `@cognite/aura/components`. #25146
+
+### Changed
+
+- Renamed the package's `style` export condition to `development` so Vite/Tailwind resolve Aura sources under the intended dev condition. #25153
+
+### Fixed
+
+- `DropdownMenuItem` now uses a minimum height instead of a fixed height so items grow for multiline content without overflowing into adjacent rows. #25085
+
+### Internal
+
+- Expanded `DESIGN.md` with standard layout foundations (content max-widths, section spacing, grid gaps, page padding) and layout patterns (sidebar content, full-width dashboard, form, detail, settings, split screen, three panel, list, and wizard), and folded state-handling and accessibility rules (validation behaviour, field validation states, page accessibility structure, and verification checklists) into the Heuristics and Content sections. #25471
+- Documented every primitive component in `DESIGN.md` under a "Primitive components" section with Storybook/docs slug links, definitions, and usage rules, and normalised component headings to a consistent level. #25472
+- Documented the Aura versioning and release process in `README.md`. #25255
+- Extracted a shared `TimePickerPanel` and migrated the date/time picker consumers to it. #25215
+- Stabilised flaky date/time picker popover tests by simplifying the shared `use-popover-state` hook and removing dead return properties. #25384
+- Excluded `*.stories.tsx` and `.storybook/**` files from the ESLint dependency-checks rule. #25424
+- Replaced the namespace React import with named imports in `useControllableState`. #25425
+
+## [0.3.1] - 2026-06-23
+
+### Added
+
+- Promoted `Toggle` from Aura Labs into Aura core with design conformance, composed icon/label/count behaviour, and aligned heights (default 36px / small 28px). #24238
+- Added a single-date `DatePicker` to Aura core alongside `DateRangePicker` and `DateTimeRangePicker`, exposed from the package root and `@cognite/aura/components`. #24850
+- Added an optional `iconUrl` prop to `Shimmer` that renders an SVG icon via CSS mask inside the shimmer surface. #25041
+- Added a `suffix` slot to `Select` so triggers can render an end adornment alongside `icon`, and reworked the trigger and menu items to allow text truncation. #24273
+- Added per-component subpath exports under `@cognite/aura/components/<name>` (e.g. `@cognite/aura/components/button`, `…/select`) so consumers can import individual components for better tree-shaking. #24944
+- Added `streamdown/dist` and `@streamdown/mermaid/dist` `@source` directives to `styles.source.css` so libraries composing Aura no longer need extra Tailwind config to pick up Streamdown classes. #24712
+
+### Changed
+
+- `Input`, `Select`, and `Textarea` now use a fixed `h-9` (36px) height instead of `min-h-9`, locking form-element height until explicit size variants are added. #24273
+- `Select` open state now applies focus-shadow, background, and text styling, and the dropdown popup uses `min-width: var(--anchor-width)` so the menu matches the trigger width. #24273
+- `SelectTrigger` defaults to `w-full` (was `w-fit`); story examples were updated accordingly. Apps that relied on the implicit fit-to-content trigger should wrap with a sized container. #24273
+
+### Fixed
+
+- Compiled ESM now uses explicit `.js` extensions on dayjs plugin imports (e.g. `dayjs/plugin/isBetween.js`), so apps under strict Node ESM (Node 18+, Vitest) can resolve them. #25086
+- `getPortalContainer` drops a cached portal container when it has been detached from the DOM, preventing portals from rendering into stale nodes. #24594
+
+### Internal
+
+- Added Pagination Storybook stories with size demonstrations and Linux-tolerant width-tolerance assertions. #23636
+- Stabilised date-picker shortcut tests to await portaled popover content via `findByRole`. #24712, #25191
+- Reorganised `DESIGN.md` (token/color reference up top, agent-oriented guidance) and added Fusion package-usage guidance to `README.md`. #24549, #24912
+
+## [0.3.0] - 2026-06-10
+
+### Added
+
+- Added `Tabs` to Aura core with composable subcomponents (`TabsList`, `TabsTrigger`, `TabsLabel`), an animated `TabsIndicator`, and size inheritance via `TabsSizeContext`. #23093
+- Added `SegmentedControl` to Aura core with size variants, an animated active-tab indicator, and size inheritance via `SegmentedControlSizeContext`. #22013
+- Added a composable `Topbar` to Aura core with `TopbarLeft`, `TopbarCenter`, `TopbarRight`, `TopbarIcon`, `TopbarMetadata`, `TopbarBreadcrumbs`, `TopbarAction`, and `TopbarThemeSwitcher`. The legacy Labs Topbar API is retained as a compatibility layer until apps migrate. #22989
+- Added `EmptyState` to Aura core with composable slots (`EmptyStateIcon`, `EmptyStateTitle`, `EmptyStateDescription`, `EmptyStateActions`), compact and full variants, and type-driven gradient backgrounds. #23833, #23841
+- Added `Search` primitive with focus-aware clear button, controlled and uncontrolled value handling, and keyboard-accessible clear behaviour. #23191
+- Added `Chart` primitive (shadcn + Recharts based) exposed via the new `@cognite/aura/chart` entry point, with `ChartContainer` plus `ChartTooltipContent` and `ChartLegendContent` themed primitives. Recharts is exposed as an optional peer dependency. #23470, #23634, #23476
+- Added `ActionToolbar` to Aura core with `ActionToolbarAction`, `ActionToolbarActionClear`, `ActionToolbarPrimaryAction`, and `ActionToolbarSelectionSummary`, including built-in tooltips for icon-only actions and a discriminated-union prop type that requires `aria-label` when `iconOnly`. #23200
+- Promoted `Pagination` from Aura Labs into Aura core with design conformance updates, a `size` prop on the `Pagination` root that propagates via `PaginationSizeContext`, dynamic teleport input width based on `totalPages`, customisable `aria-label`s on icon controls, and a compact layout. #22922
+- Promoted `Switch` from Aura Labs into Aura core with design conformance updates, peer-driven styling via Base UI data attributes, and an updated state-label API that hides labels from the accessible name. #22850
+- Promoted the date pickers (`DateRangePicker`, `DateTimeRangePicker`, and shared calendar/time primitives) from Aura Labs into Aura core. #24613
+- Added `defaultOnDark`, `secondaryOnDark`, and `ghostOnDark` Button variants for use on fixed-dark surfaces, including disabled-state handling via `mountain-alpha-300`. #24307
+- Added on-dark background tokens (`--primary-background-fixed-dark`, `--secondary-background-fixed-dark`, `--disabled-background-fixed-dark`, `--disabled-foreground-fixed-dark`, plus `*-hover` variants) and exposed the full `--mountain-alpha-*` ramp as Tailwind `@theme` utilities. #24306
+
+### Changed
+
+- Updated `Alert` for design conformance: refined the icon API (filled tabler variants by default, larger default icon size, `IconAlertCircleFilled` for `error`), renamed `variant="secondary"` to `variant="info"` (with `secondary` retained as a deprecated alias), rendered an X icon for `AlertClose` in card mode, and tightened spacing in strip mode. #21901
+
+### Fixed
+
+- Fixed Aura style imports so consumers resolve `styles.source.css` correctly. #24220
+- Stabilised Chart unit tests and Chromatic Storybook interactions for `Chart`, `Topbar`, and `CodeBlock` stories. #24402
+- Added missing `@source` directive to `styles.source.css` so consuming apps pick up Aura component classes during Tailwind discovery. #24632
+
+### Internal
+
+- Marked the package as side-effect free apart from `*.css`/`*.scss` so consumers can tree-shake unused components and their heavy dependencies. #24736
+- Enabled `isolatedDeclarations` for the Aura library and added the explicit type annotations required across the codebase. #24524
+- Enabled Chromatic Storybook publishing for Aura in CI via `CHROMATIC_TOKEN_AURA`. #24388
+- Removed per-component `*.metadata.ts` files and their re-exports; the registry build no longer treats metadata as a dependency source. #23517
+- Re-enabled the `package-json/specify-peers-locally` lint rule and pinned the corresponding peer dependencies. #24038
+- Added previously-unlisted dependencies to `package.json`. #24383
+
+## [0.2.0] - 2026-05-12
+
+### Added
+
+- Promoted `Checkbox` from Aura Labs into Aura core with design conformance, exposed it from the package root, and refined the disabled unchecked border color. #22857
+- Promoted `RadioGroup` from Aura Labs into Aura core with design conformance and a composable item API (control, label, description). #22697
+- Promoted `SonnerToast` from Aura Labs into Aura core with design conformance updates. #22803
+- Promoted `Kbd` from Aura Labs into Aura core, added design conformance updates, and exported `Kbd`, `KbdGroup`, and `KbdMetadata` from the barrels. #22370
+- Added Aura `DESIGN.md` and a `design.md` lint check (run via `npx`) so the design doc stays in sync. #23073, #23433
+- Added animations and a refined variant API to `Loader` as part of design conformance. #22990
+
+### Changed
+
+- Imported updated Aura color tokens from Figma. Renamed decorative hover tokens to `decorative-background-{ramp}-hover` (suffix ordering), renamed `chart-error-*` to `chart-destructive-*`, added per-palette `--*-alpha-*` ramps, and replaced hard-coded chart RGBAs with the new alpha tokens. #23406
+- Renamed focus-ring tokens (`ring-critical` → `ring-destructive`, `ring-critical-shadow` → `ring-destructive-muted`, `ring-shadow` → `ring-muted`) and reduced focus-ring outer radii from 2px/4px to 1px/3px. Components using the old names were migrated. #23406
+- Remapped shadow tokens (`--shadow-sm`/`md`/`lg`/`xl` now use the intended `--effect-shadow-*` levels) and bumped dark-theme `--effect-shadow-md` intensity for better elevation contrast. #23406
+- Updated `Card` for design conformance with additional stories. Renamed slots: `CardIcon` → `CardHeaderStart`, `CardHeaderRight` → `CardHeaderEnd`, and introduced `CardHeaderCenter` to wrap `CardTitle`/`CardDescription`. The Card root now owns outer padding (`p-4`) and inter-slot gap (`gap-4`). #22286
+- Updated `Count`, `Loader`, `Breadcrumb`, `KBD`, `RadioGroup`, `SonnerToast`, and `Card` for design conformance. #23338, #22990, #22730, #22370, #22697, #22803, #22286
+
+### Fixed
+
+- Adjusted aurora alpha values, disabled foreground, and overlay backgrounds for consistent theming across light and dark. #23406
+
+### Internal
+
+- Externalized `vscode-*` and `@chevrotain/*` from the Storybook bundle to reduce bundle size. #23619
+- Migrated Aura to the shared Storybook + Vitest setup and removed the legacy `test-storybook` target. #23133
+- Dropped the `@google/design.md` devDependency in favor of running the linter via `npx`. #23433
+
+## [0.1.7] - 2026-04-30
+
+### Added
+
+- Ship Aura `DESIGN.md` with the published npm package: include it in `files`, add a `./DESIGN.md` package export so it resolves as `@cognite/aura/DESIGN.md`, and document this in the README.
+
+## [0.1.6] - 2026-04-22
+
+### Added
+
+- Added Figma color sync scripts to generate `colors.css` from Figma. AUR-455
+- Added download actions for Aura `CodeBlock` and tool outputs. AUR-379
+- Added `Progress` to Aura core. AUR-482, AUR-433
+
+### Changed
+
+- Updated Aura color tokens to match Figma and migrated Aura and Aura Labs components to the new token naming scheme. AUR-459
+- Promoted `Accordion` and `Banner` from Aura Labs into Aura core with design conformance updates. AUR-405, AUR-407
+- Updated `Avatar`, `Badge`, `Button`, `Collapsible`, `HelperText`, `Input`, `InputGroup`, `Label`, `Textarea`, and `Tooltip` for design conformance. AUR-375, AUR-376, AUR-377, AUR-380, AUR-384, AUR-389, AUR-400, AUR-402
+- Expanded `Popover` with composable header, title, description, slot, and close subcomponents.
+- Restored Mermaid copy, download, and pan/zoom controls while keeping fullscreen disabled. AX-117, AX-118
+
+### Fixed
+
+- Added `forwardRef` support to `SelectTrigger` and `Toggle`.
+- Added the missing accent background color.
+- Prevented `InputGroupAddon` refocus from stealing focus from portaled inputs. AX-196
+- Fixed Sources list wrapping so long titles do not overlap the `+N` badge. AX-254
+
+## [0.1.5] - 2026-03-30
+
+### Added
+
+- Added an Aura ESLint entry point and `no-overriding-styles` rule to guard against visual style overrides. AUR-461
+
+## [0.1.4] - 2026-03-23
+
+### Fixed
+
+- Fixed card hover behavior.