bs4Dashkit 0.3.0

Navbar ergonomics

• Added complete navbar item helpers for safer bs4DashNavbar(rightUi = ...) usage:

  • dash_nav_help_item()

  • dash_nav_refresh_item()

  • dash_nav_status_item()

• Added dash_nav_status_badge() for compact navbar status indicators.

• Added validate_bs4dash_navbar() to catch common custom navbar structure mistakes, including <li> children missing the required "dropdown" class.

• Kept dash_nav_help_button() and dash_nav_refresh_button() as lower-level button builders for custom wrappers.

Branding and layout

• Added dash_brand_options() and dash_titles_from() so shared brand configuration can be reused across app families without growing each dash_titles() call.

• Added prototype top-navigation support with use_dash_topnav() and use_bs4Dashkit_core(layout = "topnav"). The sidebar menu remains the source of truth and is mirrored into the navbar so bs4TabItems(), input$sidebar, updateTabItems(), and bookmarking can keep using native {bs4Dash} wiring.

• Top-navigation tabs can now be aligned left, center, or right with align / topnav_align, and spaced with gap / topnav_gap.

• Added dash_topnav_options() so production apps can pass one compact topnav = ... object to use_bs4Dashkit_core(layout = "topnav") instead of a long run of topnav_* arguments.

• Top-navigation mode now includes an animated active underline, mobile hamburger behavior, optional pill and compact tab styles, optional More overflow, centered title auto-compact/hide behavior, keyboard navigation, optional active page-title sync, a Shiny click event at input$bs4dashkit_topnav, and a debug outline mode.

• use_bs4Dashkit_core() and use_dash_sidebar_behavior() now accept explicit CSS lengths for topbar_h, collapsed_w, and expanded_w, such as "56px", "4.25rem", and "270px". Existing numeric values remain supported with their historical default units.

• Removed the digest import; scoped brand CSS now uses a tiny internal ID counter.

Documentation and examples

• Updated README, vignettes, packaged examples, and pkgdown reference navigation to show the complete navbar item helpers and top-navigation prototype as the preferred API.

• Updated examples to avoid wrapping helpers that already return navbar <li> elements.

Testing

• Added regression coverage for complete navbar item helpers, navbar validation messages, CSS-unit sidebar dimensions, reusable brand options, status badges, core helper layout selection, and top-navigation dependency injection.

bs4Dashkit 0.2.1

• Hardened generated JavaScript by encoding dynamic sidebar brand strings as JSON literals.

• Added validation for CSS values used in theme, brand, and sidebar helpers before they are emitted into HTML/style blocks.

• Reused sidebar dimension validation for direct use_dash_sidebar_behavior() calls.

• Removed unused package metadata and cleaned unnecessary source comments.

• Added regression tests for JavaScript escaping, CSS validation, and direct sidebar dimension validation.

• Added a packaged hardening regression example app that exercises JavaScript label escaping, CSS validation, sidebar dimensions, runtime DOM tracing, and visual theme fixtures.

bs4Dashkit 0.2.0

Ergonomics and discoverability

• dash_titles() now accepts simple shiny::icon() inputs in addition to character icon names, and emits a more targeted error when icon= receives an unsupported object.

• Added sidebar brand text controls for collapsed and expanded states: collapsed_text_size, expanded_text_size, collapsed_text_weight, and expanded_text_weight.

• Added bs4dashkit_theme_presets() to list shipped theme presets and improved unknown-preset errors to enumerate valid choices.

• Polished the built-in theme presets so they style navbar, sidebar, footer, link, and status colors more coherently, and extended bs4dashkit_theme_presets(values = TRUE) to expose the shipped preset tokens for inspection and customization.

• Added bs4dashkit_example_app() as a minimal runnable example of the recommended dash_titles() + use_bs4Dashkit_core() workflow.

• Added bs4dashkit_demo_app() plus a packaged inst/examples/real-shiny-app/app.R example for interactively testing sidebar brand states, hover-expand behavior, presets, navbar controls, and footer styling together. The packaged example now contains the full standalone app code directly.

• Added inst/examples/sidebar-smoke-test/app.R as a minimal sidebar verification app and inst/examples/test-all/app.R as a heavier end-to-end stress test for branding, sidebar, navbar, theme, and footer features.

• Refined sidebar brand state handling so hover-expanded sidebars use the expanded text rules consistently, brand_text is treated as the default expanded label, and icon-requested states fall back more gracefully when no icon is supplied.

• Fixed reactive sidebar mode updates by clearing stale collapsed/expanded body classes before applying the current mode and cleaning up old observers and hover listeners before installing new ones.

• Fixed collapsed and expanded sidebar text sizing and weight controls so live updates consistently win over AdminLTE defaults, and centered the collapsed "text-only" label layout.

• Allowed brand_text = NULL for fully icon-only brands when both sidebar states are "icon-only" and an icon or image brand is supplied, with a browser-title fallback warning when app_name is omitted.

• Improved dash_nav_title() centering so the title stays visually centered as the viewport and surrounding navbar content change, and added left/center/right alignment controls to the interactive demo.

Documentation and package polish

• Updated README and vignettes to match the shipped API:

  • removed references to the non-existent dash_nav_logout_button()

  • aligned documentation with the current preset names "professional", "modern", and "dark-lite"

  • clarified preset discoverability and the recommended body-level placement of use_bs4Dashkit_core()

  • clarified how brand_text, collapsed_text, and expanded_text interact across collapsed, hover-expanded, and expanded sidebar states

  • documented the textless icon-only brand path, the automatic sidebar mirroring of bs4DashNavbar(title = ttl$brand), and the shipped example apps for smoke testing and full feature testing

Testing

• Expanded test coverage for:

  • icon normalization in dash_titles()

  • targeted validation errors for invalid icon objects

  • collapsed and expanded sidebar brand text styling controls

  • sidebar mode class resets and cleanup of reactive hover/state listeners

  • theme preset discovery and preset validation errors

  • the exported minimal example app helper

bs4Dashkit 0.1.0

Initial release

• Added dash_titles() as a unified constructor for brand and sidebar configuration. Returns $app_name, $brand, and $deps for placement in bs4DashPage(), bs4DashNavbar(), and bs4DashBody().

• Added use_bs4Dashkit_core() as the recommended entry point for injecting dependencies, applying a theme preset, and configuring sidebar behavior.

• Added theme support via CSS custom properties:

  • Presets: "professional", "modern", and "dark-lite"

  • use_dash_theme() for direct CSS variable overrides

  • use_dash_theme_preset() for applying named presets

  • bs4dashkit_theme_presets() for inspecting available presets

• Added configurable sidebar brand modes:

  • “icon-only”, "icon-text", and "text-only"

  • Independent configuration for collapsed and expanded states

• Added use_dash_sidebar_behavior() for configurable collapsed width, expanded width, and topbar height.

• Added use_dash_sidebar_brand_divider() for optional brand/menu separation.

• Added brand visual effects ("glow", "shimmer", "emboss") and two-color gradients via dash_titles().

• Added support for image-based brand icons via icon_img and icon_shape.

• Added navbar utilities:

  • dash_nav_title()

  • dash_nav_item()

  • dash_nav_refresh_button()

  • dash_nav_help_button()

  • dash_user_menu()

• Added dash_footer()with independently positional logo and text elements.

• Added global options:

  • bs4Dashkit.sidebar.collapsed

  • bs4Dashkit.sidebar.expanded

  • bs4Dashkit.brand_divider

  • bs4Dashkit.theme_preset

  • bs4Dashkit.accent