# Releases

## v2.21.2 (2026-11-10)

### Bug Fixes

- **hooks**: Sitemap noindex, sidebar depth and icons, boolean options
  ([#237](https://github.com/r4sky0/sphinx-lumina-theme/pull/237),
  [`13384c5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/13384c512748b3ad8e54f1a2e6f2f6f9653b7c70))
- **js**: Survive blocked storage and fix TOC, copy, permalink and search edge cases
  ([#238](https://github.com/r4sky0/sphinx-lumina-theme/pull/238),
  [`77981a8`](https://github.com/r4sky0/sphinx-lumina-theme/commit/77981a8bae970e260c18714e792b9a36381e64da))
- **search**: Mark same-page results and keep landing highlights in the body
  ([#240](https://github.com/r4sky0/sphinx-lumina-theme/pull/240),
  [`6e6efc0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6e6efc0659f73ad3763f336014be912ca6e7c9e5))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- **release**: Publish and deploy the tagged commit; build sdist without pnpm
  ([#239](https://github.com/r4sky0/sphinx-lumina-theme/pull/239),
  [`5ac3f62`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5ac3f626ed6cac3ff8f1063797a0f3f290256b80))

</details>

## v2.21.1 (2026-11-10)

### Bug Fixes

- **templates**: Escape SEO tags, resolve nav links, translate leftover text
  ([#236](https://github.com/r4sky0/sphinx-lumina-theme/pull/236),
  [`8428a4b`](https://github.com/r4sky0/sphinx-lumina-theme/commit/8428a4b91a236bcbf915b4bf83217a64531d61c0))

## v2.21.0 (2026-11-07)

### Features

- **search**: Highlight search terms on the opened page
  ([#235](https://github.com/r4sky0/sphinx-lumina-theme/pull/235),
  [`785e824`](https://github.com/r4sky0/sphinx-lumina-theme/commit/785e824732315c7780c4f4175acc3440c8250cd0))

## v2.20.0 (2026-11-07)

### Features

- Lumina code style preset and reading polish
  ([#234](https://github.com/r4sky0/sphinx-lumina-theme/pull/234),
  [`8d1db77`](https://github.com/r4sky0/sphinx-lumina-theme/commit/8d1db77724417afdec7c6cc16bf58856808be906))

## v2.19.6 (2026-11-07)

### Bug Fixes

- Style index pages and native search and select controls
  ([#233](https://github.com/r4sky0/sphinx-lumina-theme/pull/233),
  [`6926e27`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6926e279d529bf3f7caf2c43dbab631e80d08311))

## v2.19.5 (2026-11-07)

### Bug Fixes

- **version-switcher**: Drop non-http(s) version URLs
  ([#230](https://github.com/r4sky0/sphinx-lumina-theme/pull/230),
  [`2847629`](https://github.com/r4sky0/sphinx-lumina-theme/commit/28476298ee08bdf39d822914decf3c3c443665e8))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump the uv-minor group with 10 updates
  ([#227](https://github.com/r4sky0/sphinx-lumina-theme/pull/227),
  [`de5f924`](https://github.com/r4sky0/sphinx-lumina-theme/commit/de5f92497256eb32740f0af66cd98ed65aa330f2))
- **deps-dev**: Bump sphinx-llm from 0.4.1 to 1.1.0 in the uv-major group
  ([#228](https://github.com/r4sky0/sphinx-lumina-theme/pull/228),
  [`ad6bf1e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ad6bf1e1f067a9f1f850e4e67c553ce607956358))

#### Continuous Integration

- Run extension tests on Python 3.14 and 3.15
  ([#232](https://github.com/r4sky0/sphinx-lumina-theme/pull/232),
  [`3c4ebc9`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3c4ebc95dea8f7ea85c2582014864fdd26215300))

</details>

## v2.19.4 (2026-11-07)

### Bug Fixes

- **search**: Expose keyboard selection to screen readers
  ([#231](https://github.com/r4sky0/sphinx-lumina-theme/pull/231),
  [`06a5661`](https://github.com/r4sky0/sphinx-lumina-theme/commit/06a566145e090491314f90e4827c4bd71fde2196))

## v2.19.3 (2026-11-07)

### Bug Fixes

- Apply dark Pygments palette for dark_mode_default
  ([#229](https://github.com/r4sky0/sphinx-lumina-theme/pull/229),
  [`5a79730`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5a79730eacd5e24a0d4e6fffa642c6496291c0f1))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump pnpm/action-setup from 6.1.0 to 6.1.1 in the github-actions-minor group across 1
  directory ([#218](https://github.com/r4sky0/sphinx-lumina-theme/pull/218),
  [`6b94dc6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6b94dc653a788cfeaa9fbca6dac0463393cacabf))
- **deps-dev**: Bump the npm-minor group across 1 directory with 4 updates
  ([#219](https://github.com/r4sky0/sphinx-lumina-theme/pull/219),
  [`9913256`](https://github.com/r4sky0/sphinx-lumina-theme/commit/99132561e75319aea7ba4e080bc0ee72ec657b58))

</details>

## v2.19.2 (2026-11-07)

### Bug Fixes

- **search**: Resolve fallback search link under dirhtml builds
  ([#220](https://github.com/r4sky0/sphinx-lumina-theme/pull/220),
  [`46d9dfc`](https://github.com/r4sky0/sphinx-lumina-theme/commit/46d9dfce32552646a7e8f938140614e4a4fd132f))

<details>
<summary>Maintenance</summary>

#### Build System

- Support Python 3.15 ([#224](https://github.com/r4sky0/sphinx-lumina-theme/pull/224),
  [`7ab986e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7ab986e595db7cf8c8b4f1e7a475d3aec1d365a5))

#### Chores

- **deps**: Bump sphinx to 9.2.0 ([#221](https://github.com/r4sky0/sphinx-lumina-theme/pull/221),
  [`8bc5ef0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/8bc5ef04e7a16533eb36913cae17dcf2debb44ba))

#### Continuous Integration

- Fix browser tests on Ubuntu 26.04 and run engines in parallel
  ([#222](https://github.com/r4sky0/sphinx-lumina-theme/pull/222),
  [`70e32a6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/70e32a68a3b3163488c2572710dccd72d63db5be))
- Skip browser tests on pushes to main
  ([#226](https://github.com/r4sky0/sphinx-lumina-theme/pull/226),
  [`fd86bdf`](https://github.com/r4sky0/sphinx-lumina-theme/commit/fd86bdf6d6bca066fe265db4c4c910863f3b5973))
- Use dependabot uv ecosystem for python deps
  ([#225](https://github.com/r4sky0/sphinx-lumina-theme/pull/225),
  [`646a653`](https://github.com/r4sky0/sphinx-lumina-theme/commit/646a653c45e351a39882a03d1fc3759b8f70a3e4))

#### Testing

- Filter upstream deprecation warnings
  ([#223](https://github.com/r4sky0/sphinx-lumina-theme/pull/223),
  [`ccc2d81`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ccc2d81f52704b63c9de4c58277669514ea06edf))

</details>

## v2.19.1 (2026-11-04)

### Bug Fixes

- **version-switcher**: Restyle the picker and list PR builds
  ([#217](https://github.com/r4sky0/sphinx-lumina-theme/pull/217),
  [`547ffdc`](https://github.com/r4sky0/sphinx-lumina-theme/commit/547ffdc9281adf750ae1f7cd9e43bd69a91a9114))

## v2.19.0 (2026-11-04)

### Features

- Add numbered steps for heading sequences
  ([#216](https://github.com/r4sky0/sphinx-lumina-theme/pull/216),
  [`af63625`](https://github.com/r4sky0/sphinx-lumina-theme/commit/af636254fea79cf6fff79e876bc6cca3efd4ca71))

## v2.18.0 (2026-11-04)

### Features

- Integrate with Read the Docs addons
  ([#215](https://github.com/r4sky0/sphinx-lumina-theme/pull/215),
  [`7db0867`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7db08672ffc5f3ee1570c50d151cea1d5560c38e))

## v2.17.2 (2026-11-04)

### Bug Fixes

- Keep content aligned and hide title-only TOC
  ([#214](https://github.com/r4sky0/sphinx-lumina-theme/pull/214),
  [`4236c24`](https://github.com/r4sky0/sphinx-lumina-theme/commit/4236c24497bc6a66b7561de17c5152d246605f2b))

## v2.17.1 (2026-10-30)

### Bug Fixes

- **landing**: Smooth the fluid hero and cut its GPU use
  ([#213](https://github.com/r4sky0/sphinx-lumina-theme/pull/213),
  [`7f332e0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7f332e022439ee33eef95e174fdb5beff17b1ef7))

## v2.17.0 (2026-10-30)

### Features

- Add right-to-left layout support and Arabic translation
  ([#211](https://github.com/r4sky0/sphinx-lumina-theme/pull/211),
  [`9bfb660`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9bfb6604689731503a8fdfdd59ffcfd87dda6b9c))

## v2.16.0 (2026-10-30)

### Features

- **landing**: Refresh landing heroes and fix reading details
  ([#212](https://github.com/r4sky0/sphinx-lumina-theme/pull/212),
  [`c721e4d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/c721e4d4f15a1a2e77751e0c74821c8e6617a990))

## v2.15.0 (2026-10-30)

### Features

- Add font tokens for custom fonts ([#210](https://github.com/r4sky0/sphinx-lumina-theme/pull/210),
  [`9506146`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9506146db6aeea6901485f09b6868e9f269bdc32))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps-dev**: Bump lucide-static from 1.61.0 to 1.62.0 in the npm-minor group
  ([#209](https://github.com/r4sky0/sphinx-lumina-theme/pull/209),
  [`97c2466`](https://github.com/r4sky0/sphinx-lumina-theme/commit/97c2466fd54e833e13b3780ea247ea7b51b60d21))

</details>

## v2.14.2 (2026-10-29)

### Bug Fixes

- **search**: Add role=main to landing pages for Sphinx search summaries
  ([#208](https://github.com/r4sky0/sphinx-lumina-theme/pull/208),
  [`9406319`](https://github.com/r4sky0/sphinx-lumina-theme/commit/940631905dc52d86ea49fc9fc52abceba0130c30))

## v2.14.1 (2026-10-29)

### Bug Fixes

- **tables**: Keep captions and stub columns intact in stacked mobile tables
  ([#207](https://github.com/r4sky0/sphinx-lumina-theme/pull/207),
  [`67d882c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/67d882c070e2793e648965e64f142a0203bb2901))

## v2.14.0 (2026-10-28)

### Features

- Hide breadcrumbs on the root page and per page via front matter
  ([#206](https://github.com/r4sky0/sphinx-lumina-theme/pull/206),
  [`daf744d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/daf744de5355072dc8dd9013aca9bb25ad83a9d5))

## v2.13.1 (2026-10-28)

### Bug Fixes

- **ci**: Remove PR previews when pull requests close
  ([#205](https://github.com/r4sky0/sphinx-lumina-theme/pull/205),
  [`3264243`](https://github.com/r4sky0/sphinx-lumina-theme/commit/326424359b7166d619a300e1e6650be00dac0397))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps-dev**: Bump the npm-minor group with 4 updates
  ([#202](https://github.com/r4sky0/sphinx-lumina-theme/pull/202),
  [`d2555e3`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d2555e3cb4361cac0660dbebc17f33e289597e2d))

</details>

## v2.13.0 (2026-10-28)

### Features

- **search**: Make Pagefind opt-in through a Python extra
  ([#201](https://github.com/r4sky0/sphinx-lumina-theme/pull/201),
  [`65c7803`](https://github.com/r4sky0/sphinx-lumina-theme/commit/65c7803f3092f9c57d56a2c1093e2fb491dddc51))

### Additional Release Information

- **search**: Search_backend now defaults to “auto”: Pagefind is used only when the
  sphinx-lumina-theme[pagefind] extra is installed, otherwise Sphinx’s built-in search. Install the
  extra to keep Pagefind.

## v2.12.3 (2026-10-28)

### Bug Fixes

- **landing**: Clear the fixed header when a landing page has no hero
  ([#199](https://github.com/r4sky0/sphinx-lumina-theme/pull/199),
  [`d44e4f4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d44e4f4ca4d15e5252c2c7fc19cf27bb6959a4e1))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- **release**: Comment on released pull requests and issues
  ([#204](https://github.com/r4sky0/sphinx-lumina-theme/pull/204),
  [`2c50674`](https://github.com/r4sky0/sphinx-lumina-theme/commit/2c506743409aefd2bd099466f31f4f41f348a379))

</details>

## v2.12.2 (2026-10-28)

### Bug Fixes

- **github**: Render bug report steps as Markdown
  ([#203](https://github.com/r4sky0/sphinx-lumina-theme/pull/203),
  [`872866d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/872866dcf7108f5b43306ce497e830052881db09))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps-dev**: Pin test mermaid to sphinxcontrib-mermaid’s default version
  ([#200](https://github.com/r4sky0/sphinx-lumina-theme/pull/200),
  [`0e6a74d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/0e6a74dc1aa33e40be230d10523591a2140114b9))

</details>

## v2.12.1 (2026-10-28)

### Bug Fixes

- **headings**: Space the permalink icon from heading text
  ([#198](https://github.com/r4sky0/sphinx-lumina-theme/pull/198),
  [`32164dc`](https://github.com/r4sky0/sphinx-lumina-theme/commit/32164dc67d5dd4be5d866370feb2f68bd75a6ce3))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump fast-uri from 3.1.8 to 3.1.9
  ([#197](https://github.com/r4sky0/sphinx-lumina-theme/pull/197),
  [`5e9849c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5e9849cd435964e1d970272cb926b14c798ff01d))
- **deps**: Bump markdown-it from 14.3.2 to 14.3.3
  ([#190](https://github.com/r4sky0/sphinx-lumina-theme/pull/190),
  [`ad49405`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ad494051fc67e4aebb746bccd17da580b3ddbf53))
- **deps**: Bump pypa/gh-action-pypi-publish from 1.14.2 to 1.14.3 in the github-actions-minor group
  ([#196](https://github.com/r4sky0/sphinx-lumina-theme/pull/196),
  [`6a96be5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6a96be5460cbbfb9a7b7587e8dba2f5bc7260bae))
- **deps**: Bump the github-actions-minor group with 3 updates
  ([#186](https://github.com/r4sky0/sphinx-lumina-theme/pull/186),
  [`d481f03`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d481f03af92ef6adc58853439316de7c0860faa2))
- **deps**: Bump the npm-minor group with 2 updates
  ([#187](https://github.com/r4sky0/sphinx-lumina-theme/pull/187),
  [`aa95a3f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/aa95a3fc3c18365ec9a01c74f313df6b14767583))
- **deps**: Bump the uv group across 1 directory with 2 updates
  ([#191](https://github.com/r4sky0/sphinx-lumina-theme/pull/191),
  [`e4290d7`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e4290d7afbb1e15e19f5dd2fe46d5376342d6b29))

</details>

## v2.12.0 (2026-10-16)

### Features

- **i18n**: Translate theme UI strings with Sphinx’s language setting
  ([#185](https://github.com/r4sky0/sphinx-lumina-theme/pull/185),
  [`073920d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/073920d23eb6f3e38c735a83ce5ba413001dff33))

## v2.11.0 (2026-10-13)

### Features

- **search**: Find API symbols and keep API reference navigation readable
  ([#184](https://github.com/r4sky0/sphinx-lumina-theme/pull/184),
  [`bc197ed`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bc197ed240f91e96a9164b77bd4a6609b4abfe88))

## v2.10.1 (2026-10-12)

### Bug Fixes

- **search**: Style Sphinx’s search page
  ([#183](https://github.com/r4sky0/sphinx-lumina-theme/pull/183),
  [`3943977`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3943977c56bfda1a8be0c6639e06170025e37951))

## v2.10.0 (2026-10-12)

### Features

- **nav**: Expand only the current path in the sidebar by default
  ([#182](https://github.com/r4sky0/sphinx-lumina-theme/pull/182),
  [`b1a1019`](https://github.com/r4sky0/sphinx-lumina-theme/commit/b1a1019875900838dfe2514b17e623a12130da5a))

## v2.9.11 (2026-10-12)

### Bug Fixes

- **search**: Make Sphinx’s search page list results
  ([#180](https://github.com/r4sky0/sphinx-lumina-theme/pull/180),
  [`96d32b3`](https://github.com/r4sky0/sphinx-lumina-theme/commit/96d32b31e120d58094480b17c739a7f0fa297d0b))

## v2.9.10 (2026-10-12)

### Bug Fixes

- **nav**: Wrap long names in the sidebar and page TOC
  ([#181](https://github.com/r4sky0/sphinx-lumina-theme/pull/181),
  [`71c1860`](https://github.com/r4sky0/sphinx-lumina-theme/commit/71c1860cc108afd1dfc75132449230cf08ac6659))

## v2.9.9 (2026-10-11)

### Bug Fixes

- **search**: Keep the keyboard selection when a search repeats
  ([#179](https://github.com/r4sky0/sphinx-lumina-theme/pull/179),
  [`e0c5678`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e0c5678bcb47383cd035d508b6e188d387d1f059))

## v2.9.8 (2026-10-11)

### Bug Fixes

- **tables**: Keep code blocks inside table cells from widening the table
  ([#178](https://github.com/r4sky0/sphinx-lumina-theme/pull/178),
  [`675cefd`](https://github.com/r4sky0/sphinx-lumina-theme/commit/675cefd84140762c7432d2969b26d93d28eaa0f4))

## v2.9.7 (2026-10-11)

### Bug Fixes

- **css**: Style docutils elements that basic.css used to cover
  ([#176](https://github.com/r4sky0/sphinx-lumina-theme/pull/176),
  [`a84c862`](https://github.com/r4sky0/sphinx-lumina-theme/commit/a84c8627892d0153489856266ea65dd4586db50c))

## v2.9.6 (2026-10-11)

### Bug Fixes

- **code**: Make the wrap toggle opt-in and fill the corner without copybutton
  ([#177](https://github.com/r4sky0/sphinx-lumina-theme/pull/177),
  [`5a71499`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5a7149989fb286234f33f067539b7bf4304ce497))

## v2.9.5 (2026-10-11)

### Bug Fixes

- **api**: Style C, C++, rST, and other Sphinx domains like Python
  ([#175](https://github.com/r4sky0/sphinx-lumina-theme/pull/175),
  [`aa8c4f5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/aa8c4f535837a91c5ea84ea89bc09fb3f91f2a98))

## v2.9.4 (2026-10-10)

### Bug Fixes

- **toc**: Prevent active snake highlight flicker during fast scrolling
  ([#173](https://github.com/r4sky0/sphinx-lumina-theme/pull/173),
  [`2ad1743`](https://github.com/r4sky0/sphinx-lumina-theme/commit/2ad1743c6cfb103376d6fa5534f019c42c49b1cb))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump fast-uri from 3.1.5 to 3.1.8
  ([#170](https://github.com/r4sky0/sphinx-lumina-theme/pull/170),
  [`1e74619`](https://github.com/r4sky0/sphinx-lumina-theme/commit/1e74619842ddbc88c003094362d2c89e530b6007))
- **deps**: Bump js-yaml from 4.3.1 to 4.3.2
  ([#168](https://github.com/r4sky0/sphinx-lumina-theme/pull/168),
  [`4127190`](https://github.com/r4sky0/sphinx-lumina-theme/commit/4127190cabdd16f59316395d2380350704419eb8))
- **deps**: Bump linkify-it from 5.0.0 to 5.0.2
  ([#171](https://github.com/r4sky0/sphinx-lumina-theme/pull/171),
  [`9efb7fa`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9efb7fae17a5f39f3180e4728065867f869176b8))
- **deps**: Bump markdown-it from 14.1.1 to 14.3.2
  ([#169](https://github.com/r4sky0/sphinx-lumina-theme/pull/169),
  [`ec55bf5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ec55bf58981e9159d610461549456b4d43af4208))
- **deps**: Bump source-map-js from 1.2.1 to 1.2.2
  ([#167](https://github.com/r4sky0/sphinx-lumina-theme/pull/167),
  [`f7083ea`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f7083eaa5b654b59a60791ba8e74d3fc79cb8e2f))
- **deps**: Bump uv from 0.12.17 to 0.12.18 in the uv group across 1 directory
  ([#174](https://github.com/r4sky0/sphinx-lumina-theme/pull/174),
  [`8d53ad9`](https://github.com/r4sky0/sphinx-lumina-theme/commit/8d53ad9dd5972e5e53ef7f148391fe72abac2520))
- **deps-dev**: Bump mermaid from 11.12.1 to 11.16.1
  ([#172](https://github.com/r4sky0/sphinx-lumina-theme/pull/172),
  [`78256b6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/78256b64cc33a3db517196600b2069d4561f3e12))

</details>

## v2.9.3 (2026-10-10)

### Bug Fixes

- Prevent mobile announcement jump and align sidebar rows
  ([#164](https://github.com/r4sky0/sphinx-lumina-theme/pull/164),
  [`1f72bde`](https://github.com/r4sky0/sphinx-lumina-theme/commit/1f72bde908af0482135e1ab2ab0d22bf49ec3e90))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump the uv group across 1 directory with 2 updates
  ([#166](https://github.com/r4sky0/sphinx-lumina-theme/pull/166),
  [`72e61a4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/72e61a44db1e08004ae07b5df54f6aa7cac3be4b))

</details>

## v2.9.2 (2026-10-10)

### Performance Improvements

- Reduce font downloads and remove hero entrance delays
  ([#161](https://github.com/r4sky0/sphinx-lumina-theme/pull/161),
  [`42e9028`](https://github.com/r4sky0/sphinx-lumina-theme/commit/42e90284d00d8c172f01cf5d746ba2ffde7722d9))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump the npm-minor group with 3 updates
  ([#165](https://github.com/r4sky0/sphinx-lumina-theme/pull/165),
  [`7fd066b`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7fd066bd14cb93f248b27d037c4eb757e15b9aed))

</details>

## v2.9.1 (2026-09-28)

### Bug Fixes

- Prevent announcement overflow and mobile breadcrumb overlap
  ([#163](https://github.com/r4sky0/sphinx-lumina-theme/pull/163),
  [`f5c4e8d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f5c4e8d8a9c8b92863b2a2cdccdc9ed7a781b8a5))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump the github-actions-major group across 1 directory with 2 updates
  ([#153](https://github.com/r4sky0/sphinx-lumina-theme/pull/153),
  [`65f1cca`](https://github.com/r4sky0/sphinx-lumina-theme/commit/65f1cca5d2c4de6abd65844a6961fb8d80d2ec2d))
- **deps**: Bump the github-actions-minor group across 1 directory with 2 updates
  ([#152](https://github.com/r4sky0/sphinx-lumina-theme/pull/152),
  [`11a154f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/11a154fc11c32d7d948808b65188d2056ef75b4e))
- **deps**: Bump the npm-minor group across 1 directory with 6 updates
  ([#154](https://github.com/r4sky0/sphinx-lumina-theme/pull/154),
  [`b502b56`](https://github.com/r4sky0/sphinx-lumina-theme/commit/b502b56d6c1d29eefdd3b68cbc75e56dbe2b71da))

#### Documentation

- Add accent color preview ([#158](https://github.com/r4sky0/sphinx-lumina-theme/pull/158),
  [`2aa3df5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/2aa3df52fefcef1306acbf98f9162f4ac44c5e71))
- Announce Lumina 2.0 features ([#160](https://github.com/r4sky0/sphinx-lumina-theme/pull/160),
  [`19528c8`](https://github.com/r4sky0/sphinx-lumina-theme/commit/19528c80a64811cfe7d6306631049566a596b9f1))
- Improve discovery metadata and declare Python 3.14
  ([#159](https://github.com/r4sky0/sphinx-lumina-theme/pull/159),
  [`3b9098c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3b9098c5f2f2f1cf199eb72a9778726a43e8239e))

#### Testing

- Stabilize browser checks ([#162](https://github.com/r4sky0/sphinx-lumina-theme/pull/162),
  [`88db9ad`](https://github.com/r4sky0/sphinx-lumina-theme/commit/88db9ad3289a37e62074e8272bbf848bb9641df6))

</details>

## v2.9.0 (2026-09-25)

### Features

- **search**: Add section scopes and heading results
  ([#157](https://github.com/r4sky0/sphinx-lumina-theme/pull/157),
  [`80c35f7`](https://github.com/r4sky0/sphinx-lumina-theme/commit/80c35f75866ac8e4ee6246eddb3e6cdbac481c78))

## v2.8.1 (2026-09-25)

### Bug Fixes

- **tests**: Stabilize TOC and copy feedback browser checks
  ([#156](https://github.com/r4sky0/sphinx-lumina-theme/pull/156),
  [`19fd41e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/19fd41e780b5fafbb19a67022ae61a43b98d0137))

## v2.8.0 (2026-09-25)

### Features

- **tables**: Refine lists and add opt-in table controls
  ([#155](https://github.com/r4sky0/sphinx-lumina-theme/pull/155),
  [`0f9e029`](https://github.com/r4sky0/sphinx-lumina-theme/commit/0f9e02999de0dc590d1a909218b51cc061b5f075))

## v2.7.0 (2026-09-24)

### Features

- **toc**: Add curved heading hierarchy guide
  ([#151](https://github.com/r4sky0/sphinx-lumina-theme/pull/151),
  [`35db757`](https://github.com/r4sky0/sphinx-lumina-theme/commit/35db757e1e0b1dd202a6e9593d50e711f3cd7ffa))

## v2.6.0 (2026-09-24)

### Features

- **mermaid**: Refine diagram design and natural sizing
  ([#150](https://github.com/r4sky0/sphinx-lumina-theme/pull/150),
  [`3b47b46`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3b47b467edd787e16183c1102dc28c7406697441))

## v2.5.0 (2026-09-24)

### Features

- **api**: Streamline and collapse API reference layouts
  ([#149](https://github.com/r4sky0/sphinx-lumina-theme/pull/149),
  [`17dc98f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/17dc98ff2870c0c2efeed2c8e85cf248c2232758))

## v2.4.0 (2026-09-23)

### Features

- **http-api**: Improve interactive REST API testing
  ([#148](https://github.com/r4sky0/sphinx-lumina-theme/pull/148),
  [`ef55c80`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ef55c80d57c4d9783a0c973d23e98baa07f08730))

## v2.3.0 (2026-09-23)

### Features

- **docs**: Enable prose hyphenation
  ([#147](https://github.com/r4sky0/sphinx-lumina-theme/pull/147),
  [`9282e15`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9282e1589c42c087dba23850a4826e1264678e87))

## v2.2.0 (2026-09-21)

### Features

- **layout**: Expand wide-screen content
  ([#145](https://github.com/r4sky0/sphinx-lumina-theme/pull/145),
  [`6f4ea25`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6f4ea2546b79b2a2e97cc708fcd5c72665352049))

<details>
<summary>Maintenance</summary>

#### Documentation

- Consolidate repository instructions
  ([#146](https://github.com/r4sky0/sphinx-lumina-theme/pull/146),
  [`770e3e5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/770e3e5b95e95791547e5de5156e2a1af968313c))

</details>

## v2.1.2 (2026-09-21)

### Bug Fixes

- Declare sphinx-design runtime dependency
  ([#143](https://github.com/r4sky0/sphinx-lumina-theme/pull/143),
  [`332a5fe`](https://github.com/r4sky0/sphinx-lumina-theme/commit/332a5fe558efa77affed3c05186d92ad0e0dcc17))

## v2.1.1 (2026-09-21)

### Bug Fixes

- **lightbox**: Make close button native
  ([#144](https://github.com/r4sky0/sphinx-lumina-theme/pull/144),
  [`facca12`](https://github.com/r4sky0/sphinx-lumina-theme/commit/facca12ba0b020cf983980b096bdba6853aa3afa))

## v2.1.0 (2026-09-20)

### Features

- **docs**: Redesign the single-screen landing page
  ([#142](https://github.com/r4sky0/sphinx-lumina-theme/pull/142),
  [`ede8473`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ede84730b32bdb25b7974b10e06d876522241ad8))

### Refactoring

- Remove audited over-engineering ([#137](https://github.com/r4sky0/sphinx-lumina-theme/pull/137),
  [`4f2f913`](https://github.com/r4sky0/sphinx-lumina-theme/commit/4f2f913775625b765e4b195dfb50357bc825b28b))

## v2.0.1 (2026-09-20)

### Bug Fixes

- **responsive**: Improve mobile table reading
  ([#141](https://github.com/r4sky0/sphinx-lumina-theme/pull/141),
  [`fbee9eb`](https://github.com/r4sky0/sphinx-lumina-theme/commit/fbee9ebe489c9323459553ddb2beadc93bbf66be))

## v2.0.0 (2026-09-20)

### Features

- **theme**: Ship the Lumina 2 editorial redesign
  ([#140](https://github.com/r4sky0/sphinx-lumina-theme/pull/140),
  [`1d6cd54`](https://github.com/r4sky0/sphinx-lumina-theme/commit/1d6cd54f98b3adf0e8aa605ccec9e6fd4cc17894))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- Update checkout pin comments ([#138](https://github.com/r4sky0/sphinx-lumina-theme/pull/138),
  [`39bc1b6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/39bc1b6c18d40756571498d9429de59aec421b2a))

#### Documentation

- Document uv workflow ([#139](https://github.com/r4sky0/sphinx-lumina-theme/pull/139),
  [`6ffff55`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6ffff555e8cdb8619517563a6e36896b6228b162))

</details>

## v1.44.1 (2026-09-20)

### Bug Fixes

- **ci**: Update release action pins
  ([`f011b91`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f011b91fb7a8d48acc3b4a4b46afa6965249fce5))
- **release**: Avoid building in semantic release container
  ([`f02b46e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f02b46e0d9e46b7709d87883b2af29378398ed59))
- **release**: Set up build tools before semantic release
  ([`4642d5b`](https://github.com/r4sky0/sphinx-lumina-theme/commit/4642d5b7c0cad03e0628d1aa5f8f4bf09b9c00c7))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- Harden GitHub Actions workflows ([#135](https://github.com/r4sky0/sphinx-lumina-theme/pull/135),
  [`9f0f916`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9f0f9167981af7dfb4c81c06a0d991854933c6ca))

#### Documentation

- Polish user-facing documentation ([#134](https://github.com/r4sky0/sphinx-lumina-theme/pull/134),
  [`f6593f0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f6593f0b2edf5e40c34a0fe99bddb5b4007a5522))

</details>

## v1.44.0 (2026-09-19)

### Features

- **docs**: Add Google site verification file
  ([#133](https://github.com/r4sky0/sphinx-lumina-theme/pull/133),
  [`40ab849`](https://github.com/r4sky0/sphinx-lumina-theme/commit/40ab8491151e9ea5bf6c506ac2f0a42771d4aa5f))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump starlette from 1.0.1 to 1.3.1 in the uv group across 1 directory
  ([#118](https://github.com/r4sky0/sphinx-lumina-theme/pull/118),
  [`fe23a49`](https://github.com/r4sky0/sphinx-lumina-theme/commit/fe23a4994224987725b57f9da84a91450409f1fd))
- **deps**: Bump the github-actions-major group across 1 directory with 2 updates
  ([#127](https://github.com/r4sky0/sphinx-lumina-theme/pull/127),
  [`9ead58c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9ead58c0fa2c1b3a9226dd8594aef0155027b9ae))
- **deps**: Bump the github-actions-minor group across 1 directory with 3 updates
  ([#129](https://github.com/r4sky0/sphinx-lumina-theme/pull/129),
  [`865f6c4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/865f6c467bc4e4d81cfdbd30dc236d9b78c2a4ab))
- **deps**: Bump the npm-minor group across 1 directory with 5 updates
  ([#116](https://github.com/r4sky0/sphinx-lumina-theme/pull/116),
  [`db3155d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/db3155d1ad258677d74f7b5973ce9623c5dcc3cc))
- **deps**: Bump the npm-minor group across 1 directory with 6 updates
  ([#131](https://github.com/r4sky0/sphinx-lumina-theme/pull/131),
  [`2b70ac4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/2b70ac4727e8ccce3764a79599dab7fd228cb76e))
- **deps**: Bump the uv group across 1 directory with 2 updates
  ([#132](https://github.com/r4sky0/sphinx-lumina-theme/pull/132),
  [`e1eff07`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e1eff07e28b965d757c2002608014eff30a8a4e4))
- **deps**: Bump the uv group across 1 directory with 3 updates
  ([#113](https://github.com/r4sky0/sphinx-lumina-theme/pull/113),
  [`9a82b30`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9a82b30e003233568634703883b40ef540b9525b))
- **deps-dev**: Bump esbuild from 0.28.0 to 0.28.1
  ([#117](https://github.com/r4sky0/sphinx-lumina-theme/pull/117),
  [`d58a19b`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d58a19b2546b510e5f7dd874250f7a79b4344e4f))
- **deps-dev**: Bump the npm-major group across 1 directory with 3 updates
  ([#125](https://github.com/r4sky0/sphinx-lumina-theme/pull/125),
  [`7c9dd39`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7c9dd39c20e4603218918f44440858d6124a576b))

</details>

## v1.43.0 (2026-06-11)

### Features

- Fix nested admonitions and improve visual polish
  ([#115](https://github.com/r4sky0/sphinx-lumina-theme/pull/115),
  [`3ba60d5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3ba60d5c73c3b67fe80a5e622021f47929ce8e1e))

## v1.42.0 (2026-06-11)

### Features

- Fix header offset variable usage and improve accessibility
  ([#114](https://github.com/r4sky0/sphinx-lumina-theme/pull/114),
  [`debd271`](https://github.com/r4sky0/sphinx-lumina-theme/commit/debd27199c8c5c0ab65f992acf0425d5c080c3ed))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump mistune from 3.2.0 to 3.2.1 in the uv group across 1 directory
  ([#104](https://github.com/r4sky0/sphinx-lumina-theme/pull/104),
  [`643a791`](https://github.com/r4sky0/sphinx-lumina-theme/commit/643a79119dc69a1fc4c27d4102f6efb8f46da21b))
- **deps**: Bump pnpm/action-setup from 6.0.4 to 6.0.5 in the github-actions-minor group
  ([#105](https://github.com/r4sky0/sphinx-lumina-theme/pull/105),
  [`87d027d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/87d027d5d57f3b784795fa56ba7e7ba78d901375))
- **deps**: Bump the github-actions-minor group across 1 directory with 2 updates
  ([#112](https://github.com/r4sky0/sphinx-lumina-theme/pull/112),
  [`d4cb2d4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d4cb2d4b86268d711fe1ad931f34261e64cbe12b))

</details>

## v1.41.0 (2026-05-03)

### Features

- **seo**: Add SEO discoverability primitives to the theme
  ([#103](https://github.com/r4sky0/sphinx-lumina-theme/pull/103),
  [`1ab5808`](https://github.com/r4sky0/sphinx-lumina-theme/commit/1ab5808b7502e49f1310e0c81df0a728d417d7b9))

### Refactoring

- Simplify mobile drawer dismissal (drop close X, add Escape)
  ([#101](https://github.com/r4sky0/sphinx-lumina-theme/pull/101),
  [`875310a`](https://github.com/r4sky0/sphinx-lumina-theme/commit/875310a14018b59207e2d2481c566c297fa1ea98))
- Unify shadows behind elevation tokens and share overlay backdrop
  ([#102](https://github.com/r4sky0/sphinx-lumina-theme/pull/102),
  [`fa20f03`](https://github.com/r4sky0/sphinx-lumina-theme/commit/fa20f034695bcbd31527c3a8bbff87977e85992c))

## v1.40.0 (2026-05-02)

### Features

- Click-to-zoom lightbox for images ([#98](https://github.com/r4sky0/sphinx-lumina-theme/pull/98),
  [`7fe05d6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7fe05d64844ca2f3021af9cbcd5f59e8b592d3c7))

## v1.39.0 (2026-05-01)

### Features

- Add per-block code line-wrap toggle ([#97](https://github.com/r4sky0/sphinx-lumina-theme/pull/97),
  [`273e884`](https://github.com/r4sky0/sphinx-lumina-theme/commit/273e884ca0fb37963e73c8c3b1c6d783d8148d0c))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump pnpm/action-setup from 6.0.3 to 6.0.4 in the github-actions-minor group
  ([#99](https://github.com/r4sky0/sphinx-lumina-theme/pull/99),
  [`bd14ee2`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bd14ee26d1c4ab345b6b45780f90c77111ddeab2))
- **deps**: Bump the npm-minor group with 5 updates
  ([#100](https://github.com/r4sky0/sphinx-lumina-theme/pull/100),
  [`85186b8`](https://github.com/r4sky0/sphinx-lumina-theme/commit/85186b83feb60c92dfee0476a17d8be34daa1302))

</details>

## v1.38.0 (2026-05-01)

### Features

- Add opt-in reading-time estimate badge
  ([#96](https://github.com/r4sky0/sphinx-lumina-theme/pull/96),
  [`39acaa1`](https://github.com/r4sky0/sphinx-lumina-theme/commit/39acaa13a32590f00c585b04d35214ab255a99ef))

### Refactoring

- Define Lumina palette via Tailwind v4 @theme directive
  ([#95](https://github.com/r4sky0/sphinx-lumina-theme/pull/95),
  [`9ceb12e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9ceb12ea83de6741ef5ab06112deb02205107746))

<details>
<summary>Maintenance</summary>

#### Documentation

- Add CSS variables reference page ([#94](https://github.com/r4sky0/sphinx-lumina-theme/pull/94),
  [`f6ec452`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f6ec452f1c8a9b9bee45fe24e6c0dd71530e79f2))

</details>

## v1.37.0 (2026-05-01)

### Features

- Fluid responsive scaling for article headings
  ([#93](https://github.com/r4sky0/sphinx-lumina-theme/pull/93),
  [`3ac79bf`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3ac79bf67fa195f603ef19f6c0ae0a6511388639))
- **search**: Add load timeout and query memoization
  ([#92](https://github.com/r4sky0/sphinx-lumina-theme/pull/92),
  [`c16e251`](https://github.com/r4sky0/sphinx-lumina-theme/commit/c16e251b62854d1a53220c5093e2af7bb346e395))

### Performance Improvements

- **scrollspy**: Coalesce position recompute via requestAnimationFrame
  ([#91](https://github.com/r4sky0/sphinx-lumina-theme/pull/91),
  [`905477d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/905477dc3e53a92f41012e589a586e767aff9c5a))

## v1.36.0 (2026-05-01)

### Bug Fixes

- **sidebar**: Trap focus and shrink drawer on small viewports
  ([#88](https://github.com/r4sky0/sphinx-lumina-theme/pull/88),
  [`3206518`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3206518e75cd457765f5778c278f3f8254954d4e))

### Features

- Add print stylesheet for legible printed output
  ([#89](https://github.com/r4sky0/sphinx-lumina-theme/pull/89),
  [`6a932aa`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6a932aa79a02a42cbc3916f87c2e16675fd0a3fd))

### Refactoring

- Extract shared clipboard helper, drop execCommand fallback
  ([#90](https://github.com/r4sky0/sphinx-lumina-theme/pull/90),
  [`1e07ee1`](https://github.com/r4sky0/sphinx-lumina-theme/commit/1e07ee1c6e5696d4d9a34b14b496b4030d3856c5))

## v1.35.1 (2026-05-01)

### Bug Fixes

- Skip link uses configured accent color
  ([#87](https://github.com/r4sky0/sphinx-lumina-theme/pull/87),
  [`da1e37a`](https://github.com/r4sky0/sphinx-lumina-theme/commit/da1e37ab8957799461f77284694dbab87ef06a9a))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump actions/setup-node from 6.3.0 to 6.4.0 in the github-actions-minor group
  ([#83](https://github.com/r4sky0/sphinx-lumina-theme/pull/83),
  [`308bcf0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/308bcf094100088daedc323320fed55547457f08))
- **deps**: Bump pnpm/action-setup from 5.0.0 to 6.0.3
  ([#84](https://github.com/r4sky0/sphinx-lumina-theme/pull/84),
  [`52df117`](https://github.com/r4sky0/sphinx-lumina-theme/commit/52df117010d560d26669dab6c80986b0208cfb95))
- **deps**: Bump the npm-minor group with 4 updates
  ([#85](https://github.com/r4sky0/sphinx-lumina-theme/pull/85),
  [`d67c314`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d67c3145c42fe97f84800a87a0e5c57f851d3e21))

#### Chores

- Add issue and pull request templates
  ([#86](https://github.com/r4sky0/sphinx-lumina-theme/pull/86),
  [`3e487e0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3e487e0d526171fdb336006adc5837be1fe56342))

</details>

## v1.35.0 (2026-04-16)

### Features

- Optimize scrollspy and improve accessibility
  ([#79](https://github.com/r4sky0/sphinx-lumina-theme/pull/79),
  [`31c7cb4`](https://github.com/r4sky0/sphinx-lumina-theme/commit/31c7cb456e786e2ef23278ecda062c4a35712187))

## v1.34.0 (2026-04-16)

### Features

- Polish API field list labels, parameter items, and status codes
  ([#78](https://github.com/r4sky0/sphinx-lumina-theme/pull/78),
  [`7871617`](https://github.com/r4sky0/sphinx-lumina-theme/commit/78716171b467c18a0ce74cb77d1985d0746184fe))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump dompurify from 3.3.3 to 3.4.0
  ([#73](https://github.com/r4sky0/sphinx-lumina-theme/pull/73),
  [`86c94c6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/86c94c6558c5270d19476600581e6d110607c239))

</details>

## v1.33.3 (2026-04-16)

### Bug Fixes

- Highlight top-level nav items when they are the current page
  ([#77](https://github.com/r4sky0/sphinx-lumina-theme/pull/77),
  [`9e6390d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9e6390d53df74980eae7650da244b5d85ec743c5))

## v1.33.2 (2026-04-16)

### Bug Fixes

- Prevent typography CSS from overriding API documentation styles
  ([#76](https://github.com/r4sky0/sphinx-lumina-theme/pull/76),
  [`9829667`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9829667519baa2903b2f8245d42a241d5ea4d933))

## v1.33.1 (2026-04-15)

### Bug Fixes

- Add tooltips to icon-only header buttons
  ([#72](https://github.com/r4sky0/sphinx-lumina-theme/pull/72),
  [`c8ea143`](https://github.com/r4sky0/sphinx-lumina-theme/commit/c8ea143e1c8d4dfc884653d6e986f739803ce1eb))

## v1.33.0 (2026-04-15)

### Features

- Polish lists, tables & typography elements
  ([#71](https://github.com/r4sky0/sphinx-lumina-theme/pull/71),
  [`9535d4f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9535d4f6e63ea53d1b3cd1056a1099ee04a2b558))

## v1.32.0 (2026-04-15)

### Features

- Add code_style theme option with 5 curated Pygments presets
  ([#70](https://github.com/r4sky0/sphinx-lumina-theme/pull/70),
  [`b458959`](https://github.com/r4sky0/sphinx-lumina-theme/commit/b4589599b19de61b9e5165a3c2b29855d866d8dc))

## v1.31.3 (2026-04-15)

### Bug Fixes

- Polish doc sections switcher ([#68](https://github.com/r4sky0/sphinx-lumina-theme/pull/68),
  [`e11ad3d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e11ad3d31e28c40f22556a6937b6a99069773e35))

## v1.31.2 (2026-04-15)

### Bug Fixes

- Redesign sidebar active state and move chevrons to right
  ([#69](https://github.com/r4sky0/sphinx-lumina-theme/pull/69),
  [`7eea5d3`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7eea5d327e3bfe3c902c9af69f1b2b1e7b79c423))

## v1.31.1 (2026-04-15)

### Bug Fixes

- Render Lucide logo icon crisply and derive favicon from it
  ([#67](https://github.com/r4sky0/sphinx-lumina-theme/pull/67),
  [`f5de441`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f5de4412157fc90974917a96a29e437d96eb0353))

## v1.31.0 (2026-04-15)

### Features

- Collapsible sidebar navigation with extra depth level
  ([#66](https://github.com/r4sky0/sphinx-lumina-theme/pull/66),
  [`a66577e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/a66577e2aa03474fcba113002319a0bf5f326cdc))

## v1.30.0 (2026-04-15)

### Features

- Add doc sections switcher ([#63](https://github.com/r4sky0/sphinx-lumina-theme/pull/63),
  [`90e5186`](https://github.com/r4sky0/sphinx-lumina-theme/commit/90e5186f9308239b1465e4b3c1f52aba37f461e5))

## v1.29.0 (2026-04-15)

### Features

- Add always-on wide layout mode ([#65](https://github.com/r4sky0/sphinx-lumina-theme/pull/65),
  [`cd6987e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/cd6987ec73fdfa55ae333acb76d7bc3992d8b9a7))

## v1.28.1 (2026-04-15)

### Bug Fixes

- Tighten tab component spacing ([#64](https://github.com/r4sky0/sphinx-lumina-theme/pull/64),
  [`58c5429`](https://github.com/r4sky0/sphinx-lumina-theme/commit/58c542983aa9aff1bcabadb1d712f9b3e97eed07))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps-dev**: Bump pytest from 9.0.2 to 9.0.3 in the uv group across 1 directory
  ([#56](https://github.com/r4sky0/sphinx-lumina-theme/pull/56),
  [`d5b1bb7`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d5b1bb754e49c83e0394e07d55c60f5f3b3476aa))

</details>

## v1.28.0 (2026-04-14)

### Features

- Add Lucide icon system for cards, sidebar, and logo
  ([#61](https://github.com/r4sky0/sphinx-lumina-theme/pull/61),
  [`d52cbb6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d52cbb6cefcd714e5e187d2380758864c8a7e267))

## v1.27.0 (2026-04-14)

### Features

- Redesign TOC with sliding indicator and typographic hierarchy
  ([#62](https://github.com/r4sky0/sphinx-lumina-theme/pull/62),
  [`5b4fa4f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5b4fa4f89dd6da38eccd2f5d2750e4521c1c7d1a))

## v1.26.1 (2026-04-14)

### Bug Fixes

- Improve sidebar navigation visual hierarchy and typography
  ([#60](https://github.com/r4sky0/sphinx-lumina-theme/pull/60),
  [`bfc78dc`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bfc78dce562a8ca63ec686601e5e30fcc270d2fe))

## v1.26.0 (2026-04-14)

### Features

- Add wide layout mode with reader toggle
  ([#58](https://github.com/r4sky0/sphinx-lumina-theme/pull/58),
  [`90d784f`](https://github.com/r4sky0/sphinx-lumina-theme/commit/90d784f758542e0d19bf4bb1177bc33369a22b31))

## v1.25.2 (2026-04-14)

### Bug Fixes

- Remove page-load transition animation
  ([#57](https://github.com/r4sky0/sphinx-lumina-theme/pull/57),
  [`853be35`](https://github.com/r4sky0/sphinx-lumina-theme/commit/853be35a0068b0d9bb63b76517f641c0791dba32))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps**: Bump actions/github-script from 8.0.0 to 9.0.0
  ([#55](https://github.com/r4sky0/sphinx-lumina-theme/pull/55),
  [`6f6b1aa`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6f6b1aae4983289a941273ad8fba6d1e73e6d8ea))
- **deps**: Bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 in the github-actions-minor group
  ([#54](https://github.com/r4sky0/sphinx-lumina-theme/pull/54),
  [`c4f53c5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/c4f53c5e7dc703eb48873e50057c6b980dc121a2))

</details>

## v1.25.1 (2026-04-07)

### Bug Fixes

- Smooth fluid simulation mouse interaction
  ([#53](https://github.com/r4sky0/sphinx-lumina-theme/pull/53),
  [`8364262`](https://github.com/r4sky0/sphinx-lumina-theme/commit/8364262b1ec7642123babe30bcf47049510d90dc))

<details>
<summary>Maintenance</summary>

#### Chores

- Replace deprecated master_doc with root_doc in theme templates
  ([#52](https://github.com/r4sky0/sphinx-lumina-theme/pull/52),
  [`deb6985`](https://github.com/r4sky0/sphinx-lumina-theme/commit/deb6985c5e3351a5a76f02a639cb605ad6cbd4c5))

</details>

## v1.25.0 (2026-04-06)

### Features

- Add auto-generated JavaScript API documentation
  ([#51](https://github.com/r4sky0/sphinx-lumina-theme/pull/51),
  [`3214fee`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3214fee0e37ea76249fe8573e9ce05c092b2b8b9))

<details>
<summary>Maintenance</summary>

#### Chores

- Add aria-hidden attribute to decorative SVG icons
  ([#49](https://github.com/r4sky0/sphinx-lumina-theme/pull/49),
  [`6e3af4e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6e3af4e82f3adbb2fb71af296a00ef676ee01ea3))

#### Continuous Integration

- Refactor GitHub Actions workflows to use reusable actions
  ([#50](https://github.com/r4sky0/sphinx-lumina-theme/pull/50),
  [`3efa0a9`](https://github.com/r4sky0/sphinx-lumina-theme/commit/3efa0a981c8a7354e1fdff5c96e6205fbad75208))

#### Documentation

- Getting Started documentation link in README
  ([#48](https://github.com/r4sky0/sphinx-lumina-theme/pull/48),
  [`795763c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/795763ce15d700e3cfbfed42af665bc20f3a0ef8))

</details>

## v1.24.0 (2026-04-04)

### Features

- Improve performance - defer scripts, optimize fluid sim, preload font
  ([#47](https://github.com/r4sky0/sphinx-lumina-theme/pull/47),
  [`619dd30`](https://github.com/r4sky0/sphinx-lumina-theme/commit/619dd30a789297c5ab698e297d0f75d81eb74e8a))

## v1.23.0 (2026-04-04)

### Features

- Add version switcher dropdown ([#41](https://github.com/r4sky0/sphinx-lumina-theme/pull/41),
  [`d4f09c1`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d4f09c17e59e33c9e73088326077d2e390f06a10))

<details>
<summary>Maintenance</summary>

#### Chores

- Add PyPI classifiers, project URLs, author, and keywords
  ([#44](https://github.com/r4sky0/sphinx-lumina-theme/pull/44),
  [`9b4805c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9b4805c84f2346721625b94179bf801ed11c6774))

#### Documentation

- Add pip install command to README ([#45](https://github.com/r4sky0/sphinx-lumina-theme/pull/45),
  [`5eadb1c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/5eadb1c6688f17c10dafac7ab94ec673a6627448))
- Update README demo GIF ([#46](https://github.com/r4sky0/sphinx-lumina-theme/pull/46),
  [`6c3ae46`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6c3ae46d7bc9dffd4ba9ede7038ab4e33ecefca9))

</details>

## v1.22.1 (2026-04-04)

### Bug Fixes

- Try It Out panel — Safari crash, collapsed content leak, polish
  ([#43](https://github.com/r4sky0/sphinx-lumina-theme/pull/43),
  [`810df2d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/810df2d66f0d2c805e0aae69d5bdf00876b921c5))

## v1.22.0 (2026-04-04)

### Features

- Add dismissible announcement banner ([#38](https://github.com/r4sky0/sphinx-lumina-theme/pull/38),
  [`62fbccd`](https://github.com/r4sky0/sphinx-lumina-theme/commit/62fbccd6b1fb4e603ec95d30c955287d33058881))

## v1.21.1 (2026-04-04)

### Bug Fixes

- Fix README for PyPI ([#42](https://github.com/r4sky0/sphinx-lumina-theme/pull/42),
  [`95e6383`](https://github.com/r4sky0/sphinx-lumina-theme/commit/95e63838506da78dda11ab221a962bde0d627a9c))

## v1.21.0 (2026-04-04)

### Features

- Add separate light/dark mode logos ([#40](https://github.com/r4sky0/sphinx-lumina-theme/pull/40),
  [`bd5a86a`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bd5a86a9fac808bff4e0a9a32be7151e013e249a))

## v1.20.0 (2026-04-04)

### Features

- Add back-to-top button ([#39](https://github.com/r4sky0/sphinx-lumina-theme/pull/39),
  [`312335e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/312335e4830b2251e6ee579dd8b1a3d9a6277519))

## v1.19.0 (2026-04-04)

### Features

- Add icons to hero feature tags ([#37](https://github.com/r4sky0/sphinx-lumina-theme/pull/37),
  [`6eab593`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6eab5933af2ff4a5e6bcf5db77ef6a6b903c6a51))

## v1.18.1 (2026-04-04)

### Bug Fixes

- Accent color no longer bleeds emerald into derived CSS vars
  ([#35](https://github.com/r4sky0/sphinx-lumina-theme/pull/35),
  [`73eeacd`](https://github.com/r4sky0/sphinx-lumina-theme/commit/73eeacd411db8c2bc7303e2a6d52d89805d3f957))
- Use standard Apache 2.0 license and clean up sdist
  ([#36](https://github.com/r4sky0/sphinx-lumina-theme/pull/36),
  [`f538619`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f5386195a1456b255272495043ea4396a9e5c602))

## v1.18.0 (2026-04-04)

### Features

- Bump dev Python to 3.14 and minimum to 3.12
  ([#34](https://github.com/r4sky0/sphinx-lumina-theme/pull/34),
  [`17414b6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/17414b6071fc82c6387e662ec74cbd7752241b9d))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- Publish releases to PyPI via trusted publishers
  ([#33](https://github.com/r4sky0/sphinx-lumina-theme/pull/33),
  [`ae97887`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ae97887b3f8cbe0cca901fd4c60f4ba6f22d8818))

</details>

## v1.17.0 (2026-04-04)

### Features

- Improve Pagefind search quality and result UX
  ([#31](https://github.com/r4sky0/sphinx-lumina-theme/pull/31),
  [`47826f6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/47826f68d7a89b1a2bb5096d9269ec27dc9957fe))

<details>
<summary>Maintenance</summary>

#### Continuous Integration

- Auto-deploy docs on push to main when docs/ changes
  ([#32](https://github.com/r4sky0/sphinx-lumina-theme/pull/32),
  [`ecb6054`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ecb60547164086785b642dc183130fecf876a1af))

#### Documentation

- Document the landing page template ([#30](https://github.com/r4sky0/sphinx-lumina-theme/pull/30),
  [`b9a0c4a`](https://github.com/r4sky0/sphinx-lumina-theme/commit/b9a0c4a0a4e0b5472610e25915b5876002b80ec0))

</details>

## v1.16.1 (2026-04-04)

### Bug Fixes

- Sanitize search excerpts to prevent XSS via x-html
  ([#29](https://github.com/r4sky0/sphinx-lumina-theme/pull/29),
  [`aea9974`](https://github.com/r4sky0/sphinx-lumina-theme/commit/aea9974d87e94daf59c897c791302668b76a49ea))

## v1.16.0 (2026-04-04)

### Features

- Interactive HTTP API docs with Try it out and curl copy
  ([#28](https://github.com/r4sky0/sphinx-lumina-theme/pull/28),
  [`9bb8f22`](https://github.com/r4sky0/sphinx-lumina-theme/commit/9bb8f22961bc907012eccfd39bfc4dffaf609988))

## v1.15.0 (2026-04-04)

### Features

- Switch to Apache 2.0 license and add configurable attribution
  ([#27](https://github.com/r4sky0/sphinx-lumina-theme/pull/27),
  [`bc3a0ab`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bc3a0ab24ac739b073eabc57ba09a1af44be37d8))

## v1.14.0 (2026-04-04)

### Features

- Style code block captions as file header bars
  ([#26](https://github.com/r4sky0/sphinx-lumina-theme/pull/26),
  [`f95c495`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f95c49578c34deb20da19e538913c7deb92fca81))

<details>
<summary>Maintenance</summary>

#### Documentation

- Remove Getting Started and Customization links from README nav
  ([#25](https://github.com/r4sky0/sphinx-lumina-theme/pull/25),
  [`f76b586`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f76b586d0a467442157ae981e1c7d2240ecfd13c))

</details>

## v1.13.0 (2026-04-04)

### Features

- Add sphinx-last-updated-by-git support
  ([#23](https://github.com/r4sky0/sphinx-lumina-theme/pull/23),
  [`f8c25a3`](https://github.com/r4sky0/sphinx-lumina-theme/commit/f8c25a34d955b059cef1b7bfecb28ab509507ca5))

## v1.12.0 (2026-04-04)

### Features

- Add animated demo GIF recording for README
  ([#24](https://github.com/r4sky0/sphinx-lumina-theme/pull/24),
  [`21222ef`](https://github.com/r4sky0/sphinx-lumina-theme/commit/21222ef236c7a5b424e6c80e99382ffc15641e89))

## v1.11.0 (2026-04-04)

### Features

- Reorganize documentation into hub-and-spoke architecture
  ([#22](https://github.com/r4sky0/sphinx-lumina-theme/pull/22),
  [`81ce49e`](https://github.com/r4sky0/sphinx-lumina-theme/commit/81ce49e49b95143d0ce75fc1abc896cc6c69ff30))

## v1.10.0 (2026-04-04)

### Features

- Add llms.txt integration with sphinx-llm
  ([#21](https://github.com/r4sky0/sphinx-lumina-theme/pull/21),
  [`e55d1d5`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e55d1d5bc494cbd3d13a5e6c00cc175586d646e3))

## v1.9.0 (2026-04-04)

### Features

- Add sphinxcontrib-openapi showcase with curl copy
  ([#20](https://github.com/r4sky0/sphinx-lumina-theme/pull/20),
  [`aac58f1`](https://github.com/r4sky0/sphinx-lumina-theme/commit/aac58f13e9829753fc74e56202460db169672d62))

## v1.8.13 (2026-04-04)

### Bug Fixes

- Polish tabs to align with design system
  ([#19](https://github.com/r4sky0/sphinx-lumina-theme/pull/19),
  [`475b3da`](https://github.com/r4sky0/sphinx-lumina-theme/commit/475b3da3a82961ef70c40bc38fd3880aa1c33a9a))

## v1.8.12 (2026-04-04)

### Bug Fixes

- Align sphinx-design badges and buttons with design system
  ([#18](https://github.com/r4sky0/sphinx-lumina-theme/pull/18),
  [`c722f8b`](https://github.com/r4sky0/sphinx-lumina-theme/commit/c722f8b94ce21db624eacbff705b3cedd8a23ac8))

## v1.8.11 (2026-04-04)

### Bug Fixes

- Polish dark mode icons, clipboard fallback, and minor UI details
  ([#17](https://github.com/r4sky0/sphinx-lumina-theme/pull/17),
  [`e766441`](https://github.com/r4sky0/sphinx-lumina-theme/commit/e766441ce858c07a539a95a1614ac50b1eb8da7f))

## v1.8.10 (2026-04-03)

### Bug Fixes

- Improve README and version replacement script
  ([#16](https://github.com/r4sky0/sphinx-lumina-theme/pull/16),
  [`5113486`](https://github.com/r4sky0/sphinx-lumina-theme/commit/51134861e5790087dcec49facab45c64ba661da5))

<details>
<summary>Maintenance</summary>

#### Documentation

- Add banner screenshot to README ([#15](https://github.com/r4sky0/sphinx-lumina-theme/pull/15),
  [`855f271`](https://github.com/r4sky0/sphinx-lumina-theme/commit/855f27168b70a6d9847c0909950e714530161dbb))

</details>

## v1.8.9 (2026-04-03)

### Bug Fixes

- Align tabs and mermaid with design system
  ([#14](https://github.com/r4sky0/sphinx-lumina-theme/pull/14),
  [`adbabb0`](https://github.com/r4sky0/sphinx-lumina-theme/commit/adbabb03a76ca543e327816bb328bce3d9c6aa98))

## v1.8.8 (2026-04-03)

### Bug Fixes

- Remove non-functional mobile menu from landing pages
  ([#13](https://github.com/r4sky0/sphinx-lumina-theme/pull/13),
  [`bd6674d`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bd6674d87fa0a4aca3dc3e92b715224bfe21afd4))

## v1.8.7 (2026-04-03)

### Bug Fixes

- Outdated content and inaccuracies across documentation
  ([#12](https://github.com/r4sky0/sphinx-lumina-theme/pull/12),
  [`d996ca9`](https://github.com/r4sky0/sphinx-lumina-theme/commit/d996ca920dfa62dccdb57078c2e3b1adc57b4577))

<details>
<summary>Maintenance</summary>

#### Build System

- **deps-dev**: Bump esbuild from 0.27.5 to 0.28.0
  ([#3](https://github.com/r4sky0/sphinx-lumina-theme/pull/3),
  [`bf7e444`](https://github.com/r4sky0/sphinx-lumina-theme/commit/bf7e444b5cfd1f861ee9340ae3977f89ca18fd0d))

#### Chores

- **deps**: Bump actions/github-script from 7 to 8
  ([#2](https://github.com/r4sky0/sphinx-lumina-theme/pull/2),
  [`eaa7d55`](https://github.com/r4sky0/sphinx-lumina-theme/commit/eaa7d5513beb7744b27e367f2a27898f89a54073))

</details>

## v1.8.6 (2026-04-03)

### Bug Fixes

- Resolve pagefind import URL against document instead of script
  ([#10](https://github.com/r4sky0/sphinx-lumina-theme/pull/10),
  [`36aeff7`](https://github.com/r4sky0/sphinx-lumina-theme/commit/36aeff7d022c09042c72a542c030c0e38680da1d))

## v1.8.5 (2026-04-03)

### Bug Fixes

- Run semantic-release natively to use deploy key
  ([#8](https://github.com/r4sky0/sphinx-lumina-theme/pull/8),
  [`4ca0fe6`](https://github.com/r4sky0/sphinx-lumina-theme/commit/4ca0fe6a95afa0caf106e6e6c763ef8abf9f1e68))
- Switch GitHub Pages to branch-based deployment
  ([#6](https://github.com/r4sky0/sphinx-lumina-theme/pull/6),
  [`7955fdc`](https://github.com/r4sky0/sphinx-lumina-theme/commit/7955fdc5ad577ccdca4991f0cf3412c7c0205a56))

<details>
<summary>Maintenance</summary>

#### Chores

- Deployment preview in PRs ([#7](https://github.com/r4sky0/sphinx-lumina-theme/pull/7),
  [`6efd807`](https://github.com/r4sky0/sphinx-lumina-theme/commit/6efd807485f2a8eda7bf537a7cd753ebe3247489))
- Group dependabot updates by ecosystem ([#4](https://github.com/r4sky0/sphinx-lumina-theme/pull/4),
  [`a33986c`](https://github.com/r4sky0/sphinx-lumina-theme/commit/a33986c01711d548f6a1950a3e09927b547124fb))
- Update site url ([#5](https://github.com/r4sky0/sphinx-lumina-theme/pull/5),
  [`ecc3434`](https://github.com/r4sky0/sphinx-lumina-theme/commit/ecc343494ca8029b32a71e4d552252983240c966))

</details>

## v1.8.4 (2026-04-03)

- Initial Release
