Skip to content

v0.6.0

Choose a tag to compare

@lam0819 lam0819 released this 17 Nov 05:58
· 3 commits to main since this release
8e186c7

Documentation and repository

  • A real plugin-library layout: a new README (banner, badges, feature table, screenshots, requirements, installation, quick start), a docs/ folder with an index, an FAQ, upgrade notes per release, an API reference generated from the code, and the long README sections moved into focused guides (usage, modern navigation, large menus, render hooks, panels/workers/tenants/languages, the demo, testing).
  • A support matrix (docs/support.md): Filament v5 only, with the supported Filament, PHP, Laravel, Livewire and Octane versions. A test keeps it, composer.json, the README and the CI job in step; another keeps the generated API reference current and checks every relative link and image.
  • LICENSE (MIT), CODE_OF_CONDUCT.md, .gitattributes (the Composer dist leaves out the demo, tests, screenshots and CI files), complete composer.json metadata (keywords, homepage, support links).
  • The docs no longer use the old "agent" example; code samples use projects, tasks and documents.
  • The repository is public from this release.

Changed

  • Every read accessor on NavItem and DrilldownNavPlugin is tagged @internal (43 methods): they serve the sidebar view and its Livewire endpoints and may change. docs/api-stability.md has the freeze review and the decisions left before 1.0.0-rc1.
  • The Pinned list moved to the top of the top level (it was below the menu). Recent stays below.
  • The open/closed state of inline sections is stored in a fi-drilldown-open cookie (excluded from cookie encryption, validated when read) instead of localStorage, and rendered on the server: a closed section no longer shows open until JavaScript starts. Previously stored states are not carried over.

Fixed

  • Content from the sidebar's render hooks was not hidden in the collapsed (icon-only) sidebar, so free text widened the icon rail (to about 250 px in the demo). Hook output is now wrapped in .fi-drilldown-hook and shown only while a collapsible sidebar is open.

Added

  • Record menus with less code: NavItem::resource(X)->recordPages() builds a record's menu from the resource's own record pages (labels, icons, badges and access from each page, as Filament builds a record's sub-navigation); or implement Contracts\HasDrilldownRecordMenu on the resource. Demo: the new auto panel.
  • Live updates: DrilldownNavPlugin::pollBadges('30s') re-renders the sidebar on an interval; refresh-sidebar keeps working.
  • Search across all levels: searchable(allLevels: true) also lists matching pages from levels that are not open ("In other menus", with their trail), from an index loaded over Livewire on first use. / focuses the search box (shortcut: to change or turn off).
  • DrilldownNavPlugin::flatten() and DrilldownNavPlugin::current(): the whole menu the user may see as a flat list (label, URL, trail, depth), for command palettes or a mobile bottom bar.
  • Pinned pages in the database: pinnable(database: true) (optional model:) stores pins per user, panel and tenant in a drilldown_nav_pins table (publishable migration), renders them on the server and syncs them across devices. URLs are checked to be paths under the panel; at most 20 pins; labels follow renamed pages.
  • DrilldownNavPlugin::accordion(): one inline section open at a time.
  • Release hygiene: SECURITY.md, CONTRIBUTING.md, issue and pull request templates, and a release workflow that creates the GitHub release from the tag's changelog section (and fails when there is none; bin/changelog-section.sh).
  • docs/compatibility.md: checked next to Hover Sidebar, Sidebar Resize, Refresh Sidebar, Mobile Bottom Nav and Collapsible Sub-Nav (all work; Hover Sidebar and Sidebar Resize conflict with each other).