opus-react 0.6.16 → 0.6.18

package/API_STABILITY.md

@@ -0,0 +1,23 @@
+# Opus React API stability policy
+
+Every public export is deliberately labelled so application teams can judge upgrade risk.
+
+| Label | Meaning | Change policy |
+| --- | --- | --- |
+| Stable | Production API with semantic-versioned compatibility. | Breaking changes require the next major version. |
+| Beta | Production-capable API still being standardised. | Changes can occur in a minor version and are called out in the changelog. |
+| Experimental | Incubating API, Lab, game, or provider-specific integration. | Changes may occur in any release. Do not make it a critical product dependency without pinning. |
+
+## Default classification
+
+- Foundational primitives, fields, layouts, navigation, overlays, feedback, data views, and charts are **Beta** until their component quality record is complete.
+- Components in the Labs and Games catalogue, and APIs tied to a third-party media or map provider, are **Experimental**.
+- A component becomes **Stable** only after it has typed API documentation, controlled/uncontrolled guidance where relevant, keyboard and focus coverage, light/dark responsive coverage, an accessibility review, interaction tests, and a published migration path for any predecessor.
+
+## Deprecations
+
+Deprecated exports remain available for at least one minor release. Deprecations include a replacement, migration note, and removal target in `CHANGELOG.md`. Removal is restricted to the next major release unless a security or data-loss issue requires faster action.
+
+## Support matrix
+
+Opus supports the latest two major versions of Chrome, Edge, Firefox, and Safari, plus the current mobile Safari and Chrome releases. The automated suite runs Chromium; manual release checks cover the other supported browsers, keyboard-only interaction, screen readers, reduced motion, forced colours, 320px reflow, RTL, and long localised content.

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+All notable public-package changes are recorded here. Opus follows [Semantic Versioning](https://semver.org/).
+
+## Unreleased
+
+## 0.6.18
+
+### Fixed
+
+- Restore CSS-module class-map generation in the published ESM and CommonJS bundles. This corrects the 0.6.17 regression where component controls could render with native browser styling despite importing `opus-react/index.css`.
+- Fail the package build if CSS-module mappings are absent, preventing this class of broken publish.
+
+## 0.6.17
+
+### Changed
+
+- Public bundles are minified and tree-shaken.
+- Scroll regions can be given a meaningful accessible name through `ScrollArea.label`.
+
+### Fixed
+
+- Consumer-provided scroll viewports are keyboard reachable by default.
+- CRM table headers expose valid column-header semantics.
+
+## 0.6.16
+
+- Current published package baseline.

package/README.md

@@ -34,6 +34,10 @@ Opus is a production-ready, themeable React design system for dashboards, CRM pr
 - React DOM `^18.2.0` or `^19.0.0`
 - `three` `^0.185.0` — optional, only needed for 3D model components
 
+## API stability and upgrades
+
+Published APIs are labelled **Stable**, **Beta**, or **Experimental**. Most current primitives are Beta while their final cross-browser and accessibility reviews complete; Labs, games, and provider-specific integrations are Experimental. See [the API stability policy](./API_STABILITY.md) for compatibility guarantees, deprecation handling, and the supported-browser matrix. All user-facing changes and migrations are recorded in [the changelog](./CHANGELOG.md).
+
 ## Install
 
 ```bash