Merge pull request #5917 from BookStackApp/copy_references

Internal reference handling on content copying

Copying: Fixed issue with non-page links to page permalinks

Found during manual testing.
Added test case to cover.

Styles: Made non-active dark/light css variables exist by default

This means that it would be possible to jump between light/dark mode
with just the class, and no reload needed.
Not something we'll directly use right now, but may be useful in
customizations.

Copying: Added logic to find & update references

Copying: Added reference change context tracking

Added core wiring in the cloning logic, just need to implement core
logic in the updater now.

Copying: Added tests to cover copy self-references

Logic to make tests pass to follow

Testing: Extracted copy tests to their own class

Merge pull request #5913 from BookStackApp/slug_history

Slug History Tracking & Usage

Slugs: Added test to cover history lookup permission usage

Slugs: Rolled out history lookup to other types

Added testing to cover.
Also added batch recording of child slug pairs on book slug changes.

Slugs: Added lookup system using history

Switched page lookup to use this.

Slugs: Fixed storage bugs, added testing coverage

Slugs: Added slug recording at points of generation

Also moved some model-level helpers, which used app container
resolution, to be injected services instead.

Slugs: Created history table to track changes

DB testing: Prevented caching during build

To prevent re-using code when re-run for same branch.

DB Testing: Updated supported DB list, added readme

Also fixed potentally flaky GIf test to be more accurate with single
frame GIF images.

Env: Added storage type to default example env

Provides greater consideration to the storage type used and the fact
that it'll place images in public space by default.

Deps: Updated PHP packages via composer

Images: Updated access to consider public secure_restricted

Had prevented public access for images when secure_restricted images was
enabled (and for just secure images) when app settings allowed public
access.

This considers the app public setting, and adds tests to cover extra
scenarios to prevent regression.

Maintenance: Fixed type issue, updated translator list

New translations common.php (Albanian) (#5887)

Dev: Set timezone for test DB creation, added PHP 8.5 to tests

Also fixed some test namespaces
Related to #5881

Deps: Updated PHP package versions

Also updated dev version

Merge pull request #5899 from BookStackApp/zip_image_handling

Exports: Updated perm checking for images in ZIP exports

Exports: Updated perm checking for images in ZIP exports

For #5885
Adds to, uses and cleans-up central permission checking in ImageService
to mirror that which would be experienced by users in the UI to result
in the same image access conditions.

Adds testing to cover.

DB: Added extra query tests, updated db-testing scripts

Also added skipping to avif tests for environments where GD does not
have built-in AVIF support

DB: Added initial DB testing docker-based script

DB: Updated entity scope to use models dynamic table

This was hardcoded since the table was always the same, but in some
cases Laravel will auto-alias the table name (for example, when in
sub-queries) which will break MySQL 5.7 when the scope attempts to use
the table name instead of the alias.

Needs testing coverage.
For #5877

Notifications: Fixed attempted null usage issue where int expected

Updated translator & dependency attribution before release v25.11

Updated translations with latest Crowdin changes (#5843)

API: Re-ordered routes, Improved navigation

Updated route order to follow some kind of logic.
Updated scrolling sidebar to not be so cut-off in various scenarios.
Added new nav helper to quick jump to specific API models.

Closes #5865

Deps: Updated PHP composer packages

Search: Fixed formatting timeout with many term occurrences

For #5863

Merge pull request #5860 from BookStackApp/api_image_data_endpoint

API: Added endpoints for reading image data

API: Added endpoints for reading image data

Merge pull request #5854 from BookStackApp/efficient_search

Pagable and efficient search

Search: Tested changes to single-table search

Updated filters to use single table where needed.

Search: Added pagination, updated other search uses

Also updated hydrator to be created via injection.

Search: Improved result hydration performance

Search: Started work to make search result size consistent

Merge pull request #5850 from BookStackApp/comments_api

API: Started building comments API endpoints

API: Added examples for comments

Tweaked comment repo to avoid returning a lot of extra data on API
update responses.

Comments API: Addressed failing tests and static testing

API: Added comment tree to pages-read endpoint

Includes tests to cover

API: Built out tests for comment API endpoints

API: Added comment CUD endpoints, drafted tests

Move some checks and made some tweaks to the repo to support consistency
between API and UI.

API: Added comment-read endpoint, added api docs section descriptions

API: Started building comments API endpoints

API Docs: Updated link to archived GitHub repo

Closes #5813

Code: Added groovy syntax highlighting

For #5822

Deps: Updated PHP deps via composer

Merge pull request #5846 from BookStackApp/page_image_nullification

Images: Added nulling of image page relation on page delete

Images: Added nulling of image page relation on page delete

Merge pull request #5844 from BookStackApp/user_ids

Updated handling of deleted user ID handling in DB

DB: Addressed test issues for user ID changes

Reverted change for activities table so that a record is retained of
past activity, and added a check where the ID may be displayed to ensure
it does not mislead and accidentially reference other, newer users.

DB: Updated handling of deleted user ID handling in DB

Updated uses of user ID to nullify on delete.
Added testing to cover deletion of user relations.
Added model factories to support changes and potential other tests.
Cleans existing ID references in the DB via migration.

DB: Aligned entity structure to a common table

As per PR #5800

* DB: Planned out new entity table format via migrations

* DB: Created entity migration logic

Made some other tweaks/fixes while testing.

* DB: Added change of entity relation columns to suit new entities table

* DB: Got most view queries working for new structure

* Entities: Started logic change to new structure

Updated base entity class, and worked through BaseRepo.
Need to go through other repos next.

Removed a couple of redundant interfaces as part of this since we can
move the logic onto the shared ContainerData model as needed.

* Entities: Been through repos to update for new format

* Entities: Updated repos to act on refreshed clones

Changes to core entity models are now done on clones to ensure clean
state before save, and those clones are returned back if changes are
needed after that action.

* Entities: Updated model classes & relations for changes

* Entities: Changed from *Data to a common "contents" system

Added smart loading from builder instances which should hydrate with
"contents()" loaded via join, while keeping the core model original.

* Entities: Moved entity description/covers to own non-model classes

Added back some interfaces.

* Entities: Removed use of contents system for data access

* Entities: Got most queries back to working order

* Entities: Reverted back to data from contents, fixed various issues

* Entities: Started addressing issues from tests

* Entities: Addressed further tests/issues

* Entities: Been through tests to get all passing in dev

Fixed issues and needed test changes along the way.

* Entities: Addressed phpstan errors

* Entities: Reviewed TODO notes

* Entities: Ensured book/shelf relation data removed on destroy

* Entities: Been through API responses & adjusted field visibility

* Entities: Added type index to massively improve query speed

Merge branch 'v25-07' into development

Updated translator & dependency attribution before release v25.07.3

Updated translations with latest Crowdin changes (#5786)

Add crossorigin attribute to manifest link

Deps: Updated PHP package versions

Updated translations with latest Crowdin changes (#5786)

Merge pull request #5820 from tfnh621/patch-1

Fix PWA manifest access behind authenticated proxies

Add crossorigin attribute to manifest link

Sponsors: Updated diagrams.net sponsor level

Merge pull request #5793 from BookStackApp/role_permission_refactor

Permissions: Use of enum references and RolePermission cleanup

Permissions: Cleanup after review of enum implementation PR

Permissions: Fixed check method to allow enum usage

Permissions: Updated use of helpers to use enums

Also added middlware method to Permission enum to allow easier usage
with controller middleware.

Permissions: Updated usage of controller methods to use enum

Permissions: Added enum usage to controller helpers

Also fixed various missing types or spelling/formatting points.
Added down action for role_permission table changes in migration.

Permissions: Removed unused role-perm columns, added permission enum

Updated main permission check methods to support our new enum.

Merge pull request #5790 from BookStackApp/timezones

Timezones: Seperate display timezone and consistency update

Timezones: Updated date displays to use consistent formats

Timezones: Seperated out store & display timezones to two options

Merge pull request #5785 from BookStackApp/phpstan_level2

PHPstan level 3

Maintenance: Updated larastan target level, fixed issues from tests

Maintenance: Finished changes to meet phpstan level 3

Maintenance: Addressed a range of phpstan level 3 issues

Maintenance: Reached PHPstan level 2

Reworked some stuff around slugs to use interface in a better way.
Also standardised phpdoc to use @return instead of @returns

Maintenance: Continued work towards PHPstan level 2

Updated html description code to be behind a proper interface.
Set new convention for mode traits/interfaces.

Maintenance: Removed unused comments text column

Has been redundant and unused for a about a year now.
Closes #4821

Packages: Updated npm packages

Spent way too many hours debugging through issues from jsdom changes.

Packages: Updated predis

Framework: Updated to Laravel 12

Merge pull request #5749 from BookStackApp/admin_command_updates

Create Admin Command: New Flags

Updated translator & dependency attribution before release v25.07.2

Packages: Upgraded php deps to latest versions

Merge pull request #5775 from BookStackApp/lexical_aug25

Lexical: August 2025 fixes

Updated translations with latest Crowdin changes (#5759)

Lexical: Fixed details tests

Updated to use new test pattern while there.

Lexical: Added backspace handling for details

Allows more reliable removal of details block on backspace at first
child position with the details block.

Lexical: Added better selection display for collapisble blocks

Lexical: Improved nested details interaction

- Set to open by default on insert.
- Updated selection handling not to always fully cascade to lowest
  editable child on selection, so parents can be reliably selected.
- Updated mouse handling to treat details panes like the root element,
  inserting within-details where relevant.

Testing: Addressed deprecation in test helper

Also updated version in phpunit config

Shelves: Addressed book edits removing non-visible books

Tracks the non-visible existing books on change, to retain as part of
the assigned books sync.
Added test to cover.

For #5728

Imports: Fixed drawing IDs not being updated in content

Would leave imported content with inaccessible images in many cases (or
wrong references) although the drawing was still being uploaded &
related to the page.
Added test to cover.

For #5761

Testing: Added more deprecation output