Changelog
Notable Nerio releases and project announcements. The repository changelog remains the canonical record for complete technical details.
· Announcement
Nerio is now on X
Follow @nerio_ui for release notes, component updates, documentation improvements, and important project news.
· Release
Nerio Core 1.0.0-beta.1
Strengthened release verification, Registry integrity, atomic CLI updates, package compatibility, and the public documentation experience while preserving the frozen Core 1.0 contract.
Added
- Added the canonical post-1.0 capability parity decision, machine-readable projection, and drift validator. The decision classifies the complete current catalog, reviewed Base UI 1.6.0 primitives, platform coverage, and issues #342–#357 without changing the frozen Core 1.0 public contract.
- Added scope-aware PR contracts, exact-SHA release candidate validation, immutable GitHub Action pins, DCO enforcement, and a deterministic candidate-bound CycloneDX SBOM for all six public packages. Current workflows prepare and retain evidence without publishing or requesting npm credentials.
- Added strict stable-only validators for the real accessibility/device audit and the external beta feedback cycle. Stable readiness requires affirmative audit and beta decisions and rejects future-dated completion evidence. Beta records remain explicitly pending; automation cannot convert prepared templates into completion evidence.
- Added one machine-readable coordinated release metadata source, a dry-run-first version preparation command, and validators for all six public packages, the Registry revision, CLI, documentation, and installation examples.
- Added packed minimum/current dependency consumers, independent optional-adapter peer evidence, Node 22 and Node 24 release coverage, and a scheduled non-blocking current-stable Playwright canary.
- Added SHA-256 integrity metadata for every Registry source file plus CLI, Registry, MCP, packed consumer, and public-contract validation. The Registry tarball grows from 25,279 to 29,812 bytes and unpacked content from 148,383 to 176,740 bytes; its reviewed tarball budget moves from 28,000 to 31,000 bytes while the existing 250,000-byte unpacked ceiling remains.
Changed
- Recalibrated the Operations Workspace full-screen runtime-transfer ceiling after the reviewed template expansion added five local avatar assets, charts, and richer operational content. The deterministic Chromium measurement moves from 581,370 to 778,265 bytes (+196,895), and the ceiling moves from 646,144 to 844,800 bytes, retaining the required 64 KiB runtime-variance allowance after rounding the measurement to the next KiB.
- Published Blocks, Templates, their same-origin Views, and Playground across all documentation deployments; removed the former deployment flag and production-only discovery gate. The current Template catalog is intentionally limited to Operations Workspace and Finance & Assets, and the redundant Empty project Block has been removed.
- Added the Sidebar item-icon token used by the stable expanded and collapsed navigation geometry. The raw token CSS budget moves from 72,000 to 72,500 bytes; the measured stylesheet is 72,001 bytes and remains within the existing gzip budget.
- Added an explicit Sidebar collapse mode so existing arbitrary content remains inert by default while migrated SidebarMenuButton navigation can opt into the icon rail. The measured
@nerio-ui/uitarball is 65,059 bytes, so its reviewed ceiling moves from 65,000 to 65,500 bytes. - Changed CardTitle to render a neutral 16px
divby default while preserving explicit heading opt-in throughas, and made CardHeader consistently own title-description spacing beside CardAction. CardDescription now uses the standard 14px body size. - Changed Dialog and Sheet titles to render neutral 16px
divelements by default with explicit heading opt-in, and aligned both descriptions to the standard 14px body size. - Added MCP output schemas and structured content for all four discovery tools while preserving the existing JSON text payload, plus stable machine-readable missing-component errors.
- Split standard documentation into server-rendered reference content and typed, statically registered client preview islands. Added a packed Vite + React + TypeScript + Tailwind CSS v4 consumer and replaced the former 8 MiB transfer tripwire with measured per-route JavaScript, CSS, deterministic transfer, runtime, CLS, LCP, network, hydration, and overflow checks. This records fixture evidence and does not add a blanket framework support claim.
- Raised the public Node.js minimum from 20.9 to 22 and aligned repository runtime declarations, package engines, documentation, fixtures, snapshots, and CI evidence.
- Raised the Tailwind CSS minimum from 4.0.0 to 4.1.0 after a clean Next.js 16.2 consumer proved that Tailwind 4.0.0 fails the Turbopack/PostCSS scanner contract.
- Updated the pinned browser gate to Playwright 1.62.1 with Chromium 151, Firefox 153, and WebKit 26.5.
- Refreshed the single affected Linux Finance & Assets mobile screenshot after Chromium 151 produced a deterministic selected-control rasterization delta; component geometry, content, and tokens are unchanged.
- Replaced Base UI-derived public props and event aliases for the interactive Core components with bounded Nerio-owned contracts, restricted Tabs values to stable strings, and exact-pinned
@base-ui/reactto 1.6.0. - Made HTTPS the default remote Registry policy with explicit trusted-local HTTP opt-in and bounded request timeout, response size, redirects, content types, paths, schema, and secret-safe errors.
Fixed
- Routed CommandItem selection through Base UI's documented click contract so highlighted items selected with Enter invoke consumer callbacks consistently in WebKit, while unsupported runtime click handlers remain blocked.
- Made Calendar and empty DatePicker initial markup independent of the server or browser clock and timezone; consumer-owned
todaynow exclusively controls current-day styling and month fallback. - Kept unavailable Calendar days out of the roving tab stop and moved the no-available-date focus fallback to the grid.
- Avoided repeating DatePicker's visible value for self-named triggers while retaining the selected value once for controls named by Field or explicit ARIA, plus consumer descriptions and the localized open/change instruction.
- Made
nerio addandnerio updateoperation-atomic: the CLI fetches and validates the complete closure, stages and backs up affected files, writes lock metadata last, and restores source and lock state after injected source or lock failures. Durable journals recover abrupt process exits on the next state-sensitive command (add,diff,update, ordoctor) without rolling back a source-and-lock transaction that had fully committed. A project-local process lock serializes installs, updates, validation, and recovery, preventing simultaneous commands from losing source ownership or lock metadata and reclaiming dead owners before journal recovery;listandinforemain read-only inspection commands. A heartbeat lease makes stale locks reclaimable after restart or PID reuse. The CLI tarball grows from 10,559 to 18,994 bytes and unpacked content from 40,917 to 79,835 bytes; reviewed budgets move from 18,000 to 19,000 compressed bytes and from 75,000 to 80,000 unpacked bytes for this bounded lease and transaction contract.
Migration
- Follow
docs/migrations/beta-0-to-beta-1.mdfor the runtime lower bounds, deterministic date initialization, Tabs string values, Nerio-owned interactive types, Registry integrity, HTTPS policy, and atomic CLI lifecycle. Exact technical closure and publication evidence is recorded indocs/core-1-0-beta-gap-closure.md.
· Release
Nerio Core 1.0.0-beta.0
Froze the reviewed Core 1.0 public API, published the compatibility and migration contracts, prepared the external feedback program, and moved the supported baseline to React 19.
Added
- Added the reviewed Core 1.0 public API snapshot and CI gate covering package manifests and TypeScript signatures, tokens, Registry, CLI/MCP contracts, support ranges, and public docs routes.
- Added the public compatibility policy and alpha-to-frozen migration guide.
- Added the preparation plan for a structured 14-day external feedback program covering package mode, source installation, Calendar/DatePicker, Registry update, accessibility, and API-freeze evaluation.
Changed
- Narrowed the supported React peer range to React 19 for the Core 1.0 baseline.
Removed
- Removed the pre-1.0
IconButtonexport and temporary Button, Badge, Select, RadioGroup, Pagination, Icon, List, and adapters compatibility aliases. Canonical replacements are listed in the migration guide.
Fixed
- Restored same-origin Block and Template previews in the hardened documentation Content Security Policy while continuing to reject unapproved frame sources.
- Fixed
nerio initto choosesrc/components/neriofor conventional Next.js src-dir projects, keeping source-installed imports aligned with the standard@/*alias while preserving the existing root default and explicit override. - Fixed source-installed Command collections to satisfy the supported Next.js ESLint baseline without consumer edits.
Migration
- Migrate all six coordinated packages together and follow
docs/migrations/alpha-to-beta.md.
· Release
Nerio Core 0.1.0-alpha.2
Expanded the public Core with Toggle, Blocks, Templates, Calendar, DatePicker, Slider, FileInput, Registry lifecycle tooling, and the manual accessibility and device audit plan.
Added
- Added a machine-validated preparation plan and evidence record for the manual Core 1.0 accessibility and real-device audit. The plan fixes the required VoiceOver, NVDA, TalkBack, physical-device, zoom/reflow, reduced-motion, contrast, native-control, component-family, and runtime-axis scenarios without representing automated coverage as human evidence.
- Added the client-only Base UI Toggle for one independent retained button state, with controlled and uncontrolled
pressedstate, stable accessible naming, icon-only and visible-label content, ghost and outline variants, three control sizes, render composition, tokens, Registry, CLI/MCP, docs, source-install, accessibility, and cross-browser coverage. ToggleGroup, Toolbar, grouped selection, form-field semantics, persistence, and product policy remain outside this primitive. Existing retained-state Buttons now reuse Toggle for balance visibility and deterministic loading modes in the Finance & Assets, Content Library, and AI Research Workspace templates; grouped and disclosure controls remain on their existing semantics. The raw token CSS budget moves from 70,000 to 72,000 bytes for the component token contract; the measured stylesheet grows by 2,149 bytes to 71,355 bytes while remaining below the existing 11,000-byte gzip budget. - Added a metadata-driven catalog of ten bounded product Blocks at
/blocks, with same-origin full-screen previews at/views/blocks/[slug], canonical detail metadata, responsive and accessible task-focused examples, and explicit product boundaries. The previous broad settings composition was split into profile, security, and notification Blocks; profile, empty-state, and feedback galleries were simplified around recognizable tasks; valuable overlay, navigation, feedback-family, and dense-form stress coverage moved to unindexed internal fixtures. - Added an immutable, release-versioned Registry contract and a portable
nerio.lock.jsonsource record with exact revision, style contract, dependency closure, installed paths, and original hashes. Addednerio diff, deterministicnerio update --dry-run, safe source updates, conflict-preserving normal updates, explicit force replacement, expanded doctor diagnostics, MCP Registry metadata, migration fixtures, and packed-consumer verification. The CLI tarball budget moves from 8,000 to 12,000 bytes for this lifecycle contract; the measured tarball is 10,224 bytes and the unpacked budget remains unchanged. - Added the client-only single-date DatePicker composed from Calendar and an anchored Base UI Popover, with timezone-safe ISO values, controlled and uncontrolled value/open state, localized display, min/max and disabled-date constraints, form submission/reset/required behavior, optional clear, focus transfer/restoration, Registry, CLI/MCP, docs, source-install, accessibility, and cross-browser coverage. Ranges, parsing, presets, time zones, scheduling, availability, recurrence, and product shortcuts remain outside Core.
- Added the client-only single-date Calendar with timezone-safe ISO values, controlled and uncontrolled selection and visible-month state, roving grid focus, locale-aware labels, localized selected-date context, configurable week starts, min/max and disabled-date constraints, Registry, CLI/MCP, docs, package/source-install, accessibility, and cross-browser coverage. DatePicker, date ranges, scheduling, availability, events, recurrence, time, and timezone workflows remain outside this primitive.
- Added the server-safe native FileInput with typed file-only props, forwarded ref and FileList events, single or multiple selection, native form/reset behavior, tokenized file-button states, Registry, CLI/MCP, docs, package/source-install, accessibility, and cross-browser coverage. Upload, drop-zone, preview, validation-workflow, progress, retry, queue, and storage behavior remain outside Core.
- Added the client-only single-value Slider with Base UI keyboard, pointer, touch, form, orientation, read-only, localized value-text, token, Registry, CLI/MCP, docs, source-install, and browser contracts. Existing native range usage can migrate to
Sliderwhen a tokenized cross-browser presentation adds value; multi-thumb ranges and product-specific scale behavior remain outside Core. - Added native
date,month,week,time, anddatetime-localcoverage to the server-safe Input contract while preserving browser-owned pickers, localized chrome, validity, value, and form-submission behavior. - Added the canonical Core 1.0 platform-primitive coverage matrix, approved bounded follow-up identities for Slider, FileInput, Calendar, and DatePicker, and catalog drift validation for the native/component/deferred boundary.
- Added deterministic Core visual-regression fixtures, cross-axis screenshot baselines, CI diff artifacts, and an explicit maintainer approval workflow.
- Added Chromium, Firefox, and WebKit interaction gates for docs and demo, an explicit platform support policy, deterministic route/search performance checks, retry/failure artifacts, and enforced package, CSS, named-import, icon, and optional-adapter budgets.
Changed
- Split pull-request automation into a fast, scope-aware development gate for working branches and a parallel full release-candidate gate for
dev -> main. Development runtime changes receive a focused Chromium smoke while Firefox, WebKit, complete visual, tool, package, packed-consumer, and manual-audit contracts remain mandatory at the release boundary. - Refined the Core component presentation contracts from Playground review: ButtonGroup is now horizontal-only with short decorative dividers; FileInput uses a compact upload icon; Checkbox, Slider, Calendar, DatePicker, Badge, FormGroup, Pagination, Sidebar, and Command states have corrected visual treatment; Dropdown Menu items support leading and trailing icons plus hotkeys; List supports dot, number, dash, and icon markers; Separator supports both orientations; and docs avatar previews use a shared representative image set.
- Gated Blocks, Templates, their full-screen Views, and the visual Playground behind
NERIO_SHOW_PREVIEW_SURFACES. They remain available by default in local and preview deployments while public production hides their navigation, search entries, sitemap andllms.txtdiscovery, redirects, and direct routes until launch. - Added Support Desk as a docs-local Template with saved inbox views, dense ticket selection, desktop split view, mobile drill-in, localized conversations, assignment and status controls, customer context, reply validation and feedback, complete queue states, runtime-axis inspection, and focused browser and visual evidence. It does not add a CRM backend, email delivery, persistence, permissions, or Core API.
- Added Developer Portal as a docs-local Template with a developer landing, deep navigation, keyboard-accessible documentation search, quickstart examples, API request and response states, versioned changelog, responsive navigation, runtime-axis inspection, and focused browser and visual evidence. It remains distinct from the Nerio docs application and does not add a docs backend, live API, SDK, persistence, or Core API.
- Added AI Research Workspace as a docs-local Template with an evidence-grounded conversation, inspectable citations, local attachments, deterministic running, completed, interrupted, failed, and retry tool states, searchable saved threads, responsive navigation, runtime-axis inspection, and focused browser and visual evidence. It does not add a model API, streaming backend, remote files, persistence, or Core API.
- Added Content Library as a docs-local Template with a media-first library overview, desktop grid and mobile list, search and filters, bounded multi-selection, local preview and metadata editing, complete import queue states, responsive navigation, runtime-axis inspection, and focused browser and visual evidence. It uses deterministic CSS artwork and metadata without adding remote media, uploads, persistence, a DAM backend, or Core API.
- Added Finance & Assets as a second docs-local Template with a consolidated portfolio overview, searchable holdings and asset detail, semantic transaction states, a validated local transfer flow, responsive navigation, sensitive-value controls, runtime-axis inspection, and focused browser and visual evidence. It uses deterministic data and the existing charts adapter without adding a backend, remote market data, or Core API.
- Moved the Operations Workspace showcase into a metadata-driven docs-local Template architecture.
/templates,/templates/operations-workspace, and/views/operations-workspacenow share one catalog and one docs deployment; the standalone demo application, external demo URL, port 3002, duplicate appearance runtime, and separate browser build were retired. Existing runtime-axis, responsive, accessibility, performance, and product-state coverage now runs against the same-origin full-screen View. - Stabilized the optional
@nerio-ui/adapters/motionCore 1.0 contract. Runtime exports, transition and variant values, package/source parity, reduced-motion updates, SSR/hydration, and bundle isolation are snapshot- or fixture-protected.NerioMotionConfignow accepts onlychildren, CSPnonce, and deterministic-testskipAnimations; alpha passthrough options such as globaltransition,isValidProp,isStatic, andtransformPagePointmove to consumer-owned Motion composition. - Standardized public package, Registry CLI, and MCP onboarding around version-aligned local installs,
pnpm execbins, and package-qualifiedpnpm dlxone-off execution. Active docs, component install blocks, README,llms.txt, CLI help, and release guidance now share one validated command contract. Clean-consumer release smoke executes the documented CLI lifecycle and packaged MCP bin, while MCP server version metadata derives from the coordinated package. - Redesigned the public documentation, component Playground, and universal workspace demo around the approved Visual Language 1.0; added explicit Core/Pro and alpha boundaries, standardized component installation and decision guidance, compact mobile navigation, realistic Core states, and synchronized search, sitemap, README, and AI-readable discovery.
- Added the optional
@nerio-ui/adapters/motionclient entrypoint with typed token-aligned transitions and variants, user-preference reduced motion, strict LazyMotion guidance, source-install metadata, and measured zero-runtime isolation for non-adopters. - Implemented the approved Nerio 1.0 visual foundation with cool alpha-neutral layers, pure white/black foundations, role-based soft geometry, calm shared motion, inverted overlay-glass aliases, calculated contrast validation, and a public visual-language reference.
- Applied the approved visual language to Navigation, Layout, and Overlays: neutral navigation states, soft selected Tabs elevation, tokenized hover motion, compact popup geometry, inverted dark-glass layers, blurred modal backdrops, directional Sheet motion, secondary close controls, and inline-end modal action footers.
- Applied the approved visual language to Data Display and Feedback: compact medium-weight hierarchy, borderless Card and muted table grouping, fixed Avatar overlap colors, neutral inline Alerts, inverted glass Toasts, deliberate status color, and tokenized interaction motion.
- Made Table body cells wrap text by default while retaining explicit consumer control for bounded identifiers and intentionally non-wrapping values.
- Refined Table's neutral product-table recipe with a borderless 4px container gutter, compensated 20px/16px outer and row-group radii, clipped tbody content, short tokenized header dividers, neutral selected-row boundaries, and a focused set of interactive documentation previews composed from Nerio Checkbox, Button, Icon, and Pagination components; the complete preview now keeps its footer inside the muted shell, uses a full-row drag image, and removes the selected row's lower divider without changing its geometry. Added Secondary-only per-row rounded interaction surfaces that round only on hover in Secondary, vertically centered cells, stable inline Checkbox alignment, a composed EmptyState example with icon, comfortable spacing, and a secondary create action on a transparent non-row surface without hover treatment, a four-row loading preview, and intentional sans/code typography. Unified all data headers as neutral sortable controls with trailing direction arrows, removed the select-all leading divider, and refined reordering with a dedicated floating row clone, insertion cue, selection suppression, and concise
Reordertooltip. Documented faithful Primary (unified muted body) and Secondary (open page-level rows) presentation recipes without moving DataGrid behavior into the Core primitive. - Aligned Pagination with Button's secondary presentation recipe: secondary controls by default and a secondary-active surface for the current page, while retaining stable geometry and
aria-currentstate. - Added a localizable
Dialog.closeLabelwhile preserving the existing "Close dialog" default.
Fixed
- Protected Navigation, Sidebar, Command, Dialog, and Sheet anatomy/state ownership from escaped consumer DOM props and synchronized their docs and Registry projections with the shipped APIs.
Migration
ButtonGroupno longer acceptsorientation="vertical"and no longer exportsButtonGroupOrientation. Replace a vertical ButtonGroup with application-owned stack layout and independent Buttons; the attached ButtonGroup contract is horizontal-only.
· Release
Nerio Core 0.1.0-alpha.1
Aligned documentation and governance with the first coordinated package release, completed Tailwind CSS v4 source-install guidance, and tightened release validation and migration evidence.
Documentation and governance
- Added a canonical Core UI implementation standard, reusable review checklist, cross-category audit, and aligned agent, contributor, proposal, pull-request, architecture, and AI guidance.
- Completed Tailwind CSS v4-first component authoring, documented and tested the narrow residual CSS compatibility policy, and established the
feature -> dev -> mainpull request flow.
Changed
- Migrated all Core component styling to static Tailwind CSS v4 recipes while preserving Nerio semantic and component variables as the public theme, mode, density, and customization contract.
- Added explicit package
@sourceregistration and source-install bridge guidance; Nerio does not inject Tailwind Preflight.
Fixed
- Extended
nerio doctor, Registry/CLI/MCP fixtures, runtime-axis validation, and clean-consumer coverage for Tailwind package and source-install setup. - Preserved consumer class precedence, Sheet viewport and RTL placement, and Toast RTL centering in the Tailwind-first implementation.
Migration
- Package consumers must import
@nerio-ui/tokens/tailwind.cssand register the installed@nerio-ui/uisource path. Source-install consumers must import the copied Nerio bridge and token styles. Seedocs/tailwind-migration-report.mdfor complete migration guidance from0.1.0-alpha.0.
· Release
Nerio Core 0.1.0-alpha.0
Introduced the first public Nerio Core alpha with semantic tokens, accessible components, the Registry and CLI workflow, MCP discovery, documentation, and initial migration guidance.
Core 0.1 alpha summary
Foundations
- Established semantic tokens, six preset themes, custom-theme overrides, system/light/dark modes, comfortable/compact density, typography recipes, radius, motion, and contrast contracts.
Components
- Completed the approved Core 0.1 component scope across actions, forms, overlays, navigation, feedback, data display, and layout primitives. All non-deprecated Core components are
stable-core; IconButton remains a deprecated compatibility wrapper.
Source registry and CLI
- Added aligned registry metadata and editable source installation through
nerio init,list,info,add, anddoctor, including clean dependency-chain builds outside the monorepo.
MCP and AI
- Added read-only MCP discovery over the same registry contract and an AI-readable
llms.txtindex. The packed MCP runtime now resolves its installed registry package instead of a workspace path.
Documentation and demo
- Added public installation, package/source usage, entrypoint, customization, component, CLI, MCP, accessibility, SEO, and contribution guidance. The universal demo app exercises Core primitives; app-local composition previews are not presented as released Blocks or Templates.
Accessibility
- Verified accessible names, semantic structure, keyboard interaction, focus management and restoration, loading and invalid states, reduced motion, forced colors, RTL, and responsive behavior across the release surface where applicable.
Known limitations
- This is the first public alpha and is not production-stable or 1.0-compatible.
- Package distribution is source-first TypeScript. Next.js package consumers must configure the documented
transpilePackageslist. - IconButton and the documented Button compatibility aliases remain available only for migration.
Added
- Added a semantic token system with preset themes, light and dark modes, comfortable and compact density, and CSS-variable customization.
- Added the initial Nerio Core component foundation, including actions, form controls, overlays, feedback, navigation, data display, and layout primitives.
- Added source registry, CLI installation, and MCP component-discovery contracts for Core components.
- Added
Kbdfor displaying keyboard shortcuts in component interfaces. - Added component contract and accessibility test coverage for the Core release surface.
- Added System, Geist, Inter, IBM Plex, Manrope, Source Sans 3, and Space Grotesk typography preset recipes through CSS tokens.
- Added a reproducible Chromium release smoke for the theme, mode, density, responsive, interaction, direction, motion, forced-color, and application-state matrix.
Changed
- Adopted
@nerio-uias the public npm namespace for all six Nerio Core packages. - Refined Core component APIs, token mappings, and documentation examples as the pre-release contract evolves.
- Consolidated icon-only actions into Button icon mode and keyboard shortcut composition.
- Expanded Card into a composable anatomy with header, content, footer, action, and visual slots.
- Improved theme, dark-mode, and density behavior across the Core component surface.
- Added router-render support to List items and preserved router-rendered Pagination slots and current-page state.
- Changed Nerio Core's default sans-serif typography from Geist to the platform system font stack.
- Isolated Lucide's fixed-stroke option behind
lucideAbsoluteStrokeWidth; the previousabsoluteStrokeWidthIcon prop remains a deprecated alpha compatibility alias. - Split
@nerio-ui/adaptersinto expliciticons,table,charts,forms, andschemasubpaths; non-icon integrations are now optional peers and the monolithic root entrypoint is no longer supported.
Fixed
- Kept primitive token scales immutable across runtime selectors, moved compact density to semantic and component remaps, and restored an explicit persisted System/Light/Dark appearance selector.
- Corrected accessibility associations, loading-state announcements, overlay close behavior, and localized Toast dismiss controls.
- Improved Avatar fallback updates, Table scroll-region behavior, and link navigation contracts.
- Closed responsive, high-contrast, image-transition, semantic-root ref, and router-adapter gaps across the remaining polished Core components.
- Protected Icon accessibility semantics from consumer SVG props, kept custom SVG forwarding free of Lucide-only DOM warnings, composed Item and ItemGroup render refs, and restored static Pagination current-state styling.
- Made SheetClose neutral for body and footer composition, isolated the default icon close style, aligned safe-area offsets and viewport metadata, wired the Sheet backdrop token, and corrected side-specific enter, exit, and reduced-motion contracts.
- Prevented malformed TableContainer names and consumer prop spreads from creating unnamed focus stops, and limited Table row-state styling to truthful current or selected tbody rows.
- Eliminated Toast enter and swipe-dismiss transform jumps across collapsed and expanded stacks, preserved both axes for four-way dismissal, and resolved inherited RTL before the first interactive render while keeping root direction changes synchronized.
- Bounded SidebarRail to its centered hit area, corrected SidebarContent's div ref contract, stabilized SidebarInset refs, and clarified the server/client entrypoint split in examples.
- Corrected Command selection so visible queries and form values use labels only while stable values and keywords remain available for selection events and filtering; also fixed grouped data typing, leading-slot semantics, no-leading row layout, and shared focus-ring styling.
- Re-ran the post-remediation release gate with strict packed-manifest contracts, isolated adapter dependency checks, expanded source-install coverage, and a production consumer build.
- Added safe-area-aware docs and demo shells, corrected copy-paste Sidebar labels and imports, hardened runtime-axis validation, and extended release smoke to the public documentation app.
Deprecated
- Deprecated
IconButtonin favor of Button icon mode.IconButtonremains available as a compatibility wrapper until the next major release. - Deprecated Button
subtleanddestructivecompatibility aliases in favor ofsecondaryanddanger.
Accessibility
- Added accessible-name requirements for icon-only Button usage and strengthened keyboard, focus, label, and state contracts across Core components.
Migration
- Replace new
IconButtonusage with Button icon mode and provide an accessible name. - Replace Button
subtleanddestructivevariants withsecondaryanddanger. - Products that relied on Geist implicitly should load it explicitly and apply the Geist typography preset or override
--n-font-sans. - Replace explicit Icon
absoluteStrokeWidthusage withlucideAbsoluteStrokeWidth; custom SVG components should implement only the genericIconSvgPropscontract. - Replace icon imports from
@nerio-ui/adapterswith@nerio-ui/adapters/icons. Import optional integrations from their dedicated subpath and install only its matching peer dependency.
Technical changelog
Read the complete changelog on GitHub for detailed additions, changes, fixes, and migration notes for every public release.