Opus
opus-react v0.6.8

opus-react

v0.6.8

Current release, a detailed twelve-month delivery roadmap, and the complete history of shipped library changes.

August 2026 — July 2027

Twelve-month roadmap

Monthly outcomes are divided into small, independently testable component and platform changes. Timing may move as research and user feedback shape priorities.

  1. August 2026

    Component quality baseline

    In progress

    Every published primitive has a dependable API, interaction contract, and test baseline.

    • Complete the callback and Waiting for action audit
    • Add render tests for every catalogue entry
    • Add interaction tests for buttons, rows, menus, and fields
    • Standardise disabled, loading, error, and empty states
    • Complete keyboard and focus-order checks
    • Publish component API stability labels

  2. September 2026

    Forms and validation

    Planned

    A complete form toolkit for authentication, onboarding, settings, and data-entry workflows.

    • Unify FieldShell labels, help, errors, and required state
    • Finish range, OTP, token, chip, and masked inputs
    • Add address, phone, currency, and percentage fields
    • Add field groups and responsive form sections
    • Document controlled and uncontrolled usage
    • Add validation and form-submission examples

  3. October 2026

    Tables and data workflows

    Planned

    Production-ready components for browsing, editing, filtering, and exporting structured data.

    • Ship sortable and resizable table columns
    • Add row selection and bulk actions
    • Add filters, saved views, and column visibility
    • Add inline cell editing and validation
    • Add pagination and virtualised long lists
    • Create list, grid, and column-view compositions

  4. November 2026

    Navigation and application shells

    Planned

    Composable navigation that scales from a focused tool to a complete enterprise application.

    • Harden sidebar collapsed and nested-menu behaviour
    • Add responsive top-navigation patterns
    • Complete breadcrumbs, pagination, and step navigation
    • Add route-aware active states
    • Standardise header, footer, and profile actions
    • Document shell layouts for web and desktop

  5. December 2026

    Overlays and feedback

    Planned

    Consistent contextual actions and feedback across pointer, keyboard, and touch input.

    • Unify modal, dialog, drawer, and popover focus management
    • Add anchored positioning and collision handling
    • Complete toast queues and notification actions
    • Add command-palette grouping and recent commands
    • Standardise confirmation and destructive-action flows
    • Test nested overlays and portal cleanup

  6. January 2027

    Charts and visualisation

    Planned

    Accessible, responsive visualisations with consistent data, interaction, and theming APIs.

    • Normalise chart data and series contracts
    • Add keyboard-accessible legends and tooltips
    • Improve responsive labels and small-container behaviour
    • Add data-table alternatives for every graph
    • Complete empty, loading, and invalid-data states
    • Publish dashboard chart composition examples

  7. February 2027

    Media, maps, and assets

    Planned

    Reliable rich-media components with graceful fallbacks and provider boundaries.

    • Complete video and audio player controls
    • Add captions, transcripts, and media keyboard shortcuts
    • Harden image upload, crop, gallery, and lightbox flows
    • Add map provider adapters and offline fallbacks
    • Document attribution and third-party licences
    • Optimise large image, model, and media loading

  8. March 2027

    Dashboard compositions

    Planned

    Flexible dashboard building blocks that remain useful from compact panels to wide workspaces.

    • Refine tiles, stat tiles, and overflow controls
    • Add draggable dashboard grid placement
    • Add widget loading, refresh, and failure states
    • Create pipeline, task, activity, and performance widgets
    • Add dashboard layout persistence and reset
    • Publish CRM, operations, and analytics examples

  9. April 2027

    Desktop and installable application

    Planned

    The same Opus application runs cleanly on the web, as a PWA, and in the desktop wrapper.

    • Extract the desktop shell into public composition APIs
    • Harden window drag, resize, focus, and edge constraints
    • Complete dock launch, minimise, restore, and auto-hide
    • Add installable PWA metadata and offline shell
    • Align Electron and browser capability adapters
    • Add desktop end-to-end interaction recordings

  10. May 2027

    Themes, tokens, and branding

    Planned

    Teams can create branded Opus experiences without forking component CSS.

    • Publish semantic colour and surface tokens
    • Add density, radius, motion, and typography scales
    • Complete light, dark, and high-contrast themes
    • Add brand preset import and export
    • Audit accent contrast across every interactive state
    • Document safe component-level token overrides

  11. June 2027

    Accessibility, performance, and localisation

    Planned

    Opus meets release-level quality gates across assistive technology, devices, and locales.

    • Complete WCAG 2.2 AA audit and remediation
    • Run screen-reader journeys for core workflows
    • Add reduced-motion and forced-colour coverage
    • Set bundle, render, and interaction performance budgets
    • Add right-to-left layout support
    • Test long translations, dates, numbers, and currencies

  12. July 2027

    Opus 1.0 release

    Planned

    A stable, documented, and supported public release with a predictable upgrade path.

    • Freeze and review the public component API
    • Resolve final visual and interaction regressions
    • Publish migration guides and codemods
    • Complete browser and device compatibility matrix
    • Publish support, deprecation, and release policies
    • Release opus-react 1.0 and aligned applications

Published packages

Release history

Run npm run sync-versions after shipping changes to refresh this log.

  1. v0.6.8

    Softer resize handles and playground ChatGPT bring-your-own key.

    • Lengthen ResizeHandle accent lines with faded ends and a gentler hover treatment.
    • Require each visitor's OpenAI API key for playground ChatGPT instead of a shared server key.
    • Add a resizable split between playground Source and ChatGPT panes.
    • Publish opus-react 0.6.8 and update Application to consume the release from npm.
  2. v0.6.7

    Accent colour picker menu stays on screen with viewport-aware placement.

    • Portal the AccentColorPicker compact menu and flip or clamp it to the viewport so it no longer spills off the left of the preview.
    • Document accent colour picker relationships to colour picker, colour clouds, and portal.
    • Publish opus-react 0.6.7 and update Application to consume the release from npm.
  3. v0.6.6

    Booking-style date range picker, masked input delete fix, and masonry demo polish.

    • Replace the dual From/To date fields with a single calendar range control: first click sets the start, second click sets the end, with accent range highlighting and hover preview.
    • Fix MaskedField so backspace and clear work through mask separators instead of re-inserting them.
    • Improve the MasonryGrid demo with varied card heights and clearer card chrome.
    • Publish opus-react 0.6.6 and update Application to consume the release from npm.
  4. v0.6.5

    Kanban board polish and collapsible component Settings pane.

    • Expand Kanban demo data with a Backlog column and denser board contents.
    • Add sticky column headers, accent-tinted full-width headers, equal-height ellipsised cards, and a reliable auto-hiding card scrollbar.
    • Add a collapsible Settings sidebar control in the component docs shell.
    • Publish opus-react 0.6.5 and update Application to consume the release from npm.
  5. v0.6.4

    Kanban drag polish, Opus colour/date pickers, and configurable card clicks.

    • Rebuild KanbanBoard around pointer drag with gap shifting, dashed drop ghosts, origin ghosts, and commit-on-drop so neighbours stay put.
    • Add configurable card click actions (modal, callback, or none) with live JSON board state in the usage preview.
    • Replace native colour and month/year selects with Opus ColorPickerPanel and DatePickerSelect listboxes, and align select chevrons.
    • Publish opus-react 0.6.4 and update Application to consume the release from npm.
  6. v0.6.3

    Form submission keeps controlled field values in sync after submit.

    • Fix the Form Submission demo reverting select and text fields to defaults after submit, caused by React resetting the DOM form once a function action resolved.
    • Handle submit and reset in React so controlled useFormState values always match the rendered fields.
    • Publish opus-react 0.6.3 and update Application to consume the release from npm.
  7. v0.6.2

    Complete version history coverage and stable release-list keys.

    • Key version history entries by version so duplicate commits cannot hide releases.
    • Harden version-log sync so overlay releases resolve to matching commits instead of shared HEAD fallbacks.
    • Backfill curated notes for every published npm version missing from the history page, including 0.2.5–0.2.10, 0.3.2–0.3.7, and 0.4.2–0.4.6.
    • Publish opus-react 0.6.2 and update Application to consume the release from npm.
  8. v0.6.1

    Form submission demos stay submit-ready and keep action buttons at a fixed size.

    • Allow Form Submission demo submit without requiring a dirty form first.
    • Keep Form and FormActions from stretching buttons when sibling panels grow taller.
    • Publish opus-react 0.6.1 and update Application to consume the release from npm.
  9. v0.6.0

    Form state, FormHeader, Badge counts, and accessibility fixes across CRM and media previews.

    • Add useFormState for values, dirty and touched tracking, validation, reset, and register helpers.
    • Add FormHeader for consistent form titles, descriptions, and trailing actions.
    • Add Badge count pill support and use it for touched field status in the Form Submission demo.
    • Forward shared native input attributes across text, textarea, select, date, phone, password-strength, and checkbox fields.
    • Fix serious and critical axe issues in CrmWorkspaceLab tables, TreeMenu leaf toggles, scrollable Tabs and StatTiles, and ModelLightbox triggers.
    • Publish opus-react 0.6.0 and update Application to consume the release from npm.
  10. v0.5.0

    Flip clock, pointed menus, and three-role colour themes.

    • Add FlipClock with hinged digit animation, optional seconds and 24 fps frame columns.
    • Add pointed menu positioning for dropdown and context menus.
    • Expand accent and tile colour theming with three-role colour support.
    • Publish opus-react 0.5.0 and update Application to consume the release from npm.
  11. v0.4.7

    MIT licence, contact metadata, and package consumer polish.

    • Declare MIT licensing and maintainer contact details on the published package.
    • Align package metadata and README guidance for npm consumers.
    • Add Library quality workflow, Playwright coverage, and usage-code audit tooling.
    • Publish opus-react 0.4.7 for Application consumption.
  12. v0.4.6

    npm marketing gallery and desktop showcase assets.

    • Add the npm marketing screenshot gallery and desktop component showcase assets.
    • Publish opus-react 0.4.6 ahead of the 0.4.7 licence and metadata polish.
  13. v0.4.5

    Restore icons and relationships routing after deploy fixes.

    • Restore icons and the relationships route after the Netlify cutover.
    • Publish opus-react 0.4.5 for Application and docs consumers.
  14. v0.4.4

    Next.js upgrade for Netlify security policy.

    • Upgrade Next.js to satisfy the Netlify security policy.
    • Publish opus-react 0.4.4 with the upgraded consumer baseline.
  15. v0.4.3

    Netlify adapter and symlink resolution fixes.

    • Enable the Netlify Next.js adapter and resolve Application symlinks in hosted builds.
    • Publish opus-react 0.4.3 after the deployment path corrections.
  16. v0.4.2

    Netlify deployment packaging for marketing and docs.

    • Deploy the marketing site and documentation on Netlify.
    • Publish opus-react 0.4.2 while wiring the hosted consumer builds.
  17. v0.4.1

    Panel CSS compatibility and clean Webpack consumer builds.

    • Replace the mixed-support Panel flex alignment value with its compatible flex-start equivalent.
    • Remove the resulting Autoprefixer and Webpack cache-serialization warnings in Library and Application builds.
    • Publish the corrected package and update Application to consume opus-react 0.4.1 from npm.
  18. v0.4.0

    Expanded component platform, desktop environment, and npm-consumer alignment.

    • Add reusable desktop, window, dock, desktop-icon, tree-menu, compact-documents, OTP, and advanced-field primitives.
    • Expand CRM workspace, contact, company, document, media, dashboard, and authentication compositions.
    • Align Component Lab previews, generated usage examples, Playground, and external previews around the same reusable package APIs.
    • Audit the public component surface and publish the complete opus-react package for Application consumption.
    • Update Application to consume the published package CSS and runtime exports instead of local package build paths.
  19. v0.3.7

    Video and audio players with media demos.

    • Add VideoPlayer and AudioPlayer with playlist controls and media demo assets.
    • Correct the ContactDetails resolveContactDetailsContact signature for the DTS build.
    • Publish opus-react 0.3.7 and update Application to consume the release.
  20. v0.3.6

    Contact Details lab with notes, security, and Badge contrast polish.

    • Add the Contact Details lab with composable card, notes, and staff security surfaces.
    • Refine Contact Details tabs, spacing, avatar upload, and Badge contrast.
    • Publish opus-react 0.3.6 (0.3.5 was never published).
  21. v0.3.4

    Scrollable home dashboard workspace.

    • Add scrollable behaviour to the home dashboard workspace for denser tile layouts.
    • Publish opus-react 0.3.4 for Application consumption.
  22. v0.3.3

    Tile scrollbar styling encapsulation.

    • Encapsulate tile scrollbar styling so dashboard tiles keep consistent overflow chrome.
    • Publish opus-react 0.3.3 with the scrollbar polish.
  23. v0.3.2

    Responsive home dashboard workspace.

    • Build a responsive home dashboard workspace composition for Application and Component Lab.
    • Publish opus-react 0.3.2 and update consumers to the new dashboard baseline.
  24. v0.3.1

    Application chrome, composed workspace shell, and interaction polish.

    • Add the composed ApplicationHeader Lab with Opus branding, global search shortcut, JSON-driven create actions, notification badges, and profile controls.
    • Add the standalone ApplicationFooter Lab with matching application-surface styling, product identity, version information, copyright, and utility actions.
    • Integrate the header and footer around Test Layout so Component Lab and generated Playground source share the complete CRM workspace shell.
    • Adopt the transparent Opus brand asset and refine responsive header surfaces, connected pane spacing, resize grips, and light-theme presentation.
    • Make ThemeSwitcher a single accessible light-dark toggle and remove theme selection from ApplicationHeader so it can move into dedicated settings.
  25. v0.3.0

    Application-consumed component platform milestone.

    • Promote the tested Opus component system to the 0.3 release line now that Application consumes the published package directly.
    • Ship the three-pane workspace, persistent resizable sidebars, custom scrolling, Sidebar footer insets, compact raw-preview routing, and refined resize handles as one supported baseline.
    • Align Component Lab, Playground, external previews, and Application around the same package and preview behaviour.
    • Update Application to opus-react 0.3.0 and publish the matching npm release and Git tag.
  26. v0.2.45

    Correct raw-preview orientation, labelling, and height containment.

    • Make portrait previews consistently taller than wide and landscape previews consistently wider than tall.
    • Remove the redundant edge-to-edge status label from full-width previews while retaining fixed-size dimensions and fit percentages.
    • Size full-width preview canvases from their actual flex container so component bottom edges and borders remain visible.
    • Synchronise the preview corrections into Application and publish opus-react 0.2.45.
  27. v0.2.44

    Theme-aware resize-grip dot contrast.

    • Render resize-handle grip dots in white for light themes and near-black for dark themes.
    • Use CSS light-dark colour selection so embedded, external, and component previews follow their own active theme.
    • Publish the corrected ResizeHandle styling and update Application to opus-react 0.2.44.
  28. v0.2.43

    Stable resize-grip spacing and compact raw-preview URLs.

    • Replace gradient-rendered grip dots with four fixed-size elements for identical spacing in embedded and external previews.
    • Replace serialized raw-preview configuration URLs with short same-origin preview IDs.
    • Retain backward compatibility with existing config query links.
    • Synchronise raw-preview routing into Application deployments.
  29. v0.2.42

    Resize-handle grip affordance and dual-orientation preview.

    • Add a centred four-dot grip to vertical and horizontal ResizeHandle tracks.
    • Use a dark muted resting grip that follows the track accent on hover and keyboard focus.
    • Add interactive vertical and horizontal examples together on the Resize Handle component page.
    • Publish the updated ResizeHandle styling and Application preview as opus-react 0.2.42.
  30. v0.2.41

    Custom source-editor scrolling and reusable Sidebar footer insets.

    • Connect CustomScrollbar tracks to CodeMirror's native scroll viewport while preserving editing and virtualisation.
    • Add reusable top, right, bottom, and left footer padding controls to Sidebar.
    • Make Sidebar footer dividers inherit the same horizontal insets as their footer content.
    • Align Test Layout component and Playground menu content through shared demo data.
    • Backfill curated release narratives from opus-react 0.2.26 through 0.2.40.
  31. v0.2.40

    Published font API and Application dependency alignment.

    • Publish the corrected public font-preference API to npm.
    • Update Application package metadata and lockfile to consume opus-react 0.2.40.
  32. v0.2.39

    Font preference API export fix.

    • Export FontPicker and useFontPreference from the public opus-react package surface.
    • Republish package declarations and runtime exports for Application consumers.
  33. v0.2.38

    Test Layout polish and documentation composition refinements.

    • Refine Test Layout pane sizing, scrolling, padding, collapse controls, and responsive behaviour.
    • Improve NotesActivity demos, relationship views, settings panels, and dashboard overviews.
    • Synchronise the latest Lab and component-detail experience into Application.
  34. v0.2.37

    Accessibility pass, custom scrollbars, and global font preferences.

    • Add CustomScrollbar and ScrollArea with styled tracks, thumbs, dual-axis corners, and auto-hide behaviour.
    • Apply accessibility improvements across navigation, overlays, builders, content, and dashboard components.
    • Add a global Google Font picker and persist the selected documentation font.
    • Integrate custom scrolling across the component library and Lab layouts.
  35. v0.2.36

    Playground workspace controls and component-library guidance.

    • Refine Playground source, split, preview, reset, and full-width workspace controls.
    • Update component-library documentation for the expanded preview workflow.
  36. v0.2.35

    Three-pane CRM lab, composition relationships, and external previews.

    • Add the resizable Test Layout CRM workspace with collapsible Sidebar and NotesActivity panes.
    • Add composition relationship views and expand dashboard documentation groups.
    • Add external Playground previews, NoteTag support, ResizeHandle controls, and richer NotesActivity interactions.
    • Improve resize persistence, panel sizing, collapse behaviour, and component settings.
  37. v0.2.34

    Emoji persistence and source-editor refinements.

    • Add recent-emoji persistence and shared emoji catalogue utilities.
    • Improve generated source and CodeMirror editor behaviour.
    • Refresh preview and documentation registration for the updated controls.
  38. v0.2.33

    Forms catalogue and generated example coverage expansion.

    • Expand forms overview content, defaults, icons, and component registration.
    • Add reusable usage-data formatters for richer generated examples.
    • Improve component previews and settings for newly documented form controls.
  39. v0.2.32

    Calendar improvements, documentation navigation, and preview parity auditing.

    • Improve Calendar behaviour and a broad set of interactive component previews.
    • Restructure documentation routes and navigation for catalogue groups and Playground.
    • Add preview-versus-usage auditing and improve the Application synchronisation workflow.
  40. v0.2.31

    Usage-code editor and component documentation workflow improvements.

    • Improve editable generated source, selection behaviour, and preview theme controls.
    • Refine component Markdown rendering and usage-code presentation.
    • Strengthen Library-to-Application source synchronisation for documentation tooling.
  41. v0.2.30

    User Profile widget, editable Code Playground, and unified component detail pages.

    • Add the UserProfileWidget and image-crop profile-photo workflow.
    • Add the Code Playground with live JSX compilation and component-seeded examples.
    • Unify preview, documentation, composition, settings, and usage-code panels on component pages.
  42. v0.2.29

    Dashboard widgets, navigation primitives, and interactive content refinements.

    • Broaden layout and navigation primitives including ThreePaneLayout, Sidebar, tiles, rails, and pagination.
    • Refine PipelineOverview, DealsOverTime, NotesActivity, NoteComposer, and dashboard tile presentation.
    • Expand component exports, examples, settings, and package documentation.
  43. v0.2.28

    Expanded component catalogue and synchronised Application documentation.

    • Expand builder, layout, navigation, tile, and dashboard component definitions.
    • Add richer preview settings and generated usage examples across the catalogue.
    • Synchronise the growing Library catalogue, emoji data, and documentation into Application.
  44. v0.2.27

    Application and package version alignment after the theme release.

    • Align Application dependency and lockfiles with the latest published opus-react package.
    • Refresh package metadata for consistent Library and Application installs.
  45. v0.2.26

    Theme architecture split, preview isolation, and release history improvements.

    • Split global shell theme from independent preview theme with separate storage keys.
    • Isolate preview theming via PreviewThemeBoundary and preview-scoped CSS overrides.
    • Prevent theme flash on load using cookie-backed SSR and a beforeInteractive bootstrap script.
    • Keep the documentation top bar permanently dark while the shell respects the global theme toggle.
    • Rebuild the version page with curated release notes instead of raw chore commit messages.
    • Fix OpusThemeProvider document theme resolution and remove hardcoded app-shell dark theme.
  46. v0.2.25

    Deals Over Time chart and dashboard catalogue growth.

    • Add DealsOverTime line-chart widget with period selector and purple/blue palettes.
    • Register DealsOverTime in dashboard catalogue, docs, icons, and usage-code generation.
    • Expand dashboard preview grid and settings panels for new chart widgets.
    • Tune metric tiles, gauges, progress visuals, and tabs styling for dashboard density.
  47. v0.2.24

    CRM dashboard list widgets, Labs/System catalogues, and error pages.

    • Add UpcomingTasks, RecentActivity, and TopPerformingUsers dashboard widgets.
    • Add Labs catalogue with Dashboard List Columns composition preview.
    • Add System catalogue with shared 403 and 404 documentation error pages.
    • Add documentation breadcrumbs across guide, components, and version pages.
    • Improve checkbox field sizing and interactive task-row behaviour.
  48. v0.2.23

    Dashboard section shell and pipeline funnel widget.

    • Add DashboardContentContainer for shared neon-glass dashboard section chrome.
    • Add PipelineOverview funnel widget with stage legend, totals, and period selector.
    • Refactor pipeline preview layout and dashboard widget width rules.
    • Publish dashboard shell primitives to npm.
  49. v0.2.22

    Major library expansion — data grid, utilities, content primitives, and charts.

    • Add Data Grid pivot mode, layout helpers, and expanded demo datasets.
    • Add Avatar, AvatarGroup, Badge, Clipboard, ContentTimeline, CopyButton, DescriptionList, Divider, FocusTrap, HotkeyManager, Icon, JsonViewer, List, and related utility components.
    • Expand chart catalogue and SpecializedCharts with additional dashboard chart types.
    • Add form overview layouts and richer generated usage code for complex controls.
    • Add documentation top-bar version badge and improved component settings panels.
    • Publish the large post-monorepo feature batch to npm as opus-react@0.2.22.
  50. v0.2.20

    Stabilise the first wave of npm publishes for the monorepo split.

    • Finalise package version alignment between Library and Application.
    • Republish opus-react after initial monorepo packaging iterations.
  51. v0.2.19

    Republish after component docs and settings panel corrections.

    • Fix component documentation metadata and settings defaults in the docs site.
    • Republish library build consumed by Application.
  52. v0.2.18

    Republish after catalogue and preview wiring fixes.

    • Sync generated usage code and preview imports with the published package surface.
    • Republish to npm after Application integration fixes.
  53. v0.2.17

    Follow-up publish with README and install guidance updates.

    • Expand opus-react README with install, theming, and Next.js setup notes.
    • Republish after documentation and export path corrections.
  54. v0.2.16

    Package export and style entry fixes for Next.js consumers.

    • Fix opus-react style and flag asset paths in published package exports.
    • Align Application lockfile with the first published build.
  55. v0.2.15

    First public npm publish after the Library/Application split.

    • Publish opus-react to npm with transpiled dist, CSS, and TypeScript declarations.
    • Wire Application to consume the published package instead of local source.
    • Add publish workflow and package metadata for the component library.
  56. v0.2.10

    Final pre-baseline packaging publish before 0.2.15.

    • Close out the early monorepo packaging ladder.
    • Publish opus-react 0.2.10 to npm.
  57. v0.2.9

    Packaging republish ahead of the stable 0.2.15 baseline.

    • Keep Application and Library package versions aligned during cutover.
    • Publish opus-react 0.2.9 to npm.
  58. v0.2.8

    Packaging republish with consumer wiring fixes.

    • Adjust published package metadata and install paths for Application.
    • Publish opus-react 0.2.8 to npm.
  59. v0.2.7

    Follow-up packaging publish during the monorepo cutover.

    • Continue hardening package exports and Application consumption paths.
    • Publish opus-react 0.2.7 after another packaging pass.
  60. v0.2.5

    Early packaging iteration before the public 0.2.15 line.

    • Iterate on the first npm package shape while the Library/Application split settles.
    • Publish opus-react 0.2.5 as an intermediate consumer build.
  61. v0.2.4

    Restructure into Library and Application monorepo.

  62. v0.2.3

    Fix usage examples and raw preview theming

  63. v0.2.2

    Scope preview theme to canvas, add version log, and clean shell chrome.

  64. v0.2.1

    Fix dashboard sparkline layout and add global component settings sidebar.

  65. v0.2.0

    Add dashboard widgets, charts, icon picker, and improved component docs.

  66. v0.1.0

    Initial commit: Opus design system with data-driven navigation.