chore(release): release v0.3.0

acgetchell · acgetchell · commit a09bd6f9f5f5 · 2026-03-12T15:19:02.000-07:00
- Bump version to v0.3.0
- Update changelog with latest changes
- Update benchmark comparison table
- Update documentation for release
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,11 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.3.0] - 2026-03-12
 
 ### Added
 
 - Expose exact determinant value (det_exact, det_exact_f64) [`b1a676c`](https://github.com/acgetchell/la-stack/commit/b1a676c8bd8fde98eb9915a9d2e528f1225f46bf)
+- [**breaking**] Expose exact determinant value (det_exact, det_exact_f64) [`92ce476`](https://github.com/acgetchell/la-stack/commit/92ce476201d5759766d73221612cd27492bccbe5)
+- Exact linear system solve (solve_exact, solve_exact_f64) [`d04fcd3`](https://github.com/acgetchell/la-stack/commit/d04fcd3b24843b7377a34849dbb2e6469bf9fc56)
+
+### Changed
+
+- Add LaError::Overflow, dimension-coverage tests, and doc fixes [`fed0082`](https://github.com/acgetchell/la-stack/commit/fed00823e552c60ec5a98bc74aeb61254f4e2999)
+- Add #[non_exhaustive] to LaError [`d068c0e`](https://github.com/acgetchell/la-stack/commit/d068c0e62073a9746a36dab06761605635281481)
+- Use det_direct() in exact_det_3x3 example [`5b69fa8`](https://github.com/acgetchell/la-stack/commit/5b69fa8011cd5471af10be5db8fcde64ec9a9dfa)
+- Restructure gauss_solve to avoid break/continue [`125b259`](https://github.com/acgetchell/la-stack/commit/125b259608a2c1965aba486d2594ff9fa328609c)
+
+### Documentation
+
+- Clarify pivoting strategy and use idiomatic rev() in exact.rs [`d884581`](https://github.com/acgetchell/la-stack/commit/d8845816b4cc4cb282913f67d7b94b58fbf91bd2)
+- Add LDLT example, solve_exact README snippet, and sync examples [`2bddccf`](https://github.com/acgetchell/la-stack/commit/2bddccf3f20156fadb4fee6a4093e76b1b631de1)
 
 ## [0.2.2] - 2026-03-11
 
@@ -173,7 +187,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Add tarpaulin coverage upload [`7486dfd`](https://github.com/acgetchell/la-stack/commit/7486dfd54e16a6dbde41575c3f35a1acb65f57d2)
 
-[unreleased]: https://github.com/acgetchell/la-stack/compare/v0.2.2..HEAD
+[0.3.0]: https://github.com/acgetchell/la-stack/compare/v0.2.2..v0.3.0
 [0.2.2]: https://github.com/acgetchell/la-stack/compare/v0.2.1..v0.2.2
 [0.2.1]: https://github.com/acgetchell/la-stack/compare/v0.2.0..v0.2.1
 [0.2.0]: https://github.com/acgetchell/la-stack/compare/v0.1.3..v0.2.0
diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "la-stack"
-version = "0.2.2"
+version = "0.3.0"
 edition = "2024"
 rust-version = "1.94"
 license = "BSD-3-Clause"
diff --git a/README.md b/README.md
@@ -57,7 +57,7 @@ Add this to your `Cargo.toml`:
 
 ```toml
 [dependencies]
-la-stack = "0.2.2"
+la-stack = "0.3.0"
 ```
 
 Solve a 5×5 system via LU:
@@ -143,7 +143,7 @@ rationals (this pulls in `num-bigint`, `num-rational`, and `num-traits` for
 
 ```toml
 [dependencies]
-la-stack = { version = "0.2.2", features = ["exact"] }
+la-stack = { version = "0.3.0", features = ["exact"] }
 ```
 
 **Determinants:**
@@ -289,14 +289,14 @@ Summary (median time; lower is better). The “la-stack vs nalgebra/faer” colu
 <!-- BENCH_TABLE:lu_solve:median:new:BEGIN -->
 | D | la-stack median (ns) | nalgebra median (ns) | faer median (ns) | la-stack vs nalgebra | la-stack vs faer |
 |---:|--------------------:|--------------------:|----------------:|---------------------:|----------------:|
-| 2 | 2.013 | 4.405 | 139.352 | +54.3% | +98.6% |
-| 3 | 14.795 | 23.172 | 179.562 | +36.2% | +91.8% |
-| 4 | 27.752 | 53.273 | 209.677 | +47.9% | +86.8% |
-| 5 | 47.390 | 72.950 | 269.797 | +35.0% | +82.4% |
-| 8 | 134.480 | 164.243 | 362.668 | +18.1% | +62.9% |
-| 16 | 608.460 | 582.134 | 865.103 | -4.5% | +29.7% |
-| 32 | 2,649.763 | 2,762.180 | 2,874.740 | +4.1% | +7.8% |
-| 64 | 17,511.169 | 14,424.833 | 12,461.534 | -21.4% | -40.5% |
+| 2 | 2.026 | 4.476 | 142.364 | +54.7% | +98.6% |
+| 3 | 15.718 | 23.857 | 191.028 | +34.1% | +91.8% |
+| 4 | 28.171 | 53.516 | 213.492 | +47.4% | +86.8% |
+| 5 | 47.595 | 72.861 | 287.763 | +34.7% | +83.5% |
+| 8 | 137.876 | 163.720 | 365.792 | +15.8% | +62.3% |
+| 16 | 609.456 | 594.194 | 910.985 | -2.6% | +33.1% |
+| 32 | 2,719.556 | 2,812.766 | 2,921.820 | +3.3% | +6.9% |
+| 64 | 17,776.557 | 14,083.938 | 12,541.345 | -26.2% | -41.7% |
 <!-- BENCH_TABLE:lu_solve:median:new:END -->
 
 ## 📄 License
diff --git a/docs/assets/bench/vs_linalg_lu_solve_median.csv b/docs/assets/bench/vs_linalg_lu_solve_median.csv
@@ -1,9 +1,9 @@
 D,la_stack,la_lo,la_hi,nalgebra,na_lo,na_hi,faer,fa_lo,fa_hi
-2,2.0129952217223885,2.0061407197443417,2.0168122172304086,4.404951992571533,4.400418609647442,4.408452656262073,139.3517253218574,138.50482989350675,139.86343502882943
-3,14.795179075506232,14.789286135110832,14.803244538731988,23.172070504384962,23.0520401720687,23.278155934276526,179.56220546930416,178.55531914893618,180.22876722354502
-4,27.752029315580472,27.741824246874756,27.774331807541486,53.272537394230646,53.208071025020175,53.319913510497315,209.67690958415466,209.0381468958392,210.0178826478561
-5,47.39011385617569,47.36572705870567,47.434535810291855,72.94987826328057,72.91627145664927,73.02378983549339,269.79719305517176,269.4128804326373,270.45311738551584
-8,134.48018448401416,134.3040585873219,134.6177509579855,164.2427127034942,159.74575068811896,165.2338455884042,362.6677206250939,361.5072061149183,364.00475693887375
-16,608.4597753007785,607.342235543899,611.125613448888,582.1338665451551,581.731399541134,582.8570980467689,865.1028781294933,859.9175712497981,870.7697108742846
-32,2649.762983737125,2647.4328951193515,2653.1137228006733,2762.180088243148,2758.509459060006,2764.2234699973396,2874.7399273255814,2870.4124273255816,2878.4722333600644
-64,17511.168839634942,17441.1430343117,17579.095531587056,14424.83263094631,14028.021071428571,14452.97602905569,12461.533509700177,12410.040987654322,12510.995978301533
+2,2.0258758718048133,2.014534795046898,2.0337088481055914,4.476274388530518,4.468773998658985,4.486731305906561,142.36367198250207,141.82715200931858,143.21787638322655
+3,15.717669371675765,15.648950929023092,15.867428712733322,23.857261749124255,23.694320255654922,24.088176511317513,191.02830230753565,189.6244976294505,192.02929880197323
+4,28.171349365792665,28.1324478448672,28.229709543836528,53.515728177148674,53.34916975176522,53.77942386273234,213.4924047917039,212.38023954262556,214.5020685579196
+5,47.59503548589087,47.38801322788408,47.79285706741585,72.86136096441832,72.71078395288922,73.06408244387191,287.76335568245673,286.6382644567461,290.2384197600831
+8,137.87610457779525,137.2567887868679,138.23988300398284,163.72019468107788,162.28590020683725,165.54345017655672,365.79150403431754,364.6016750345311,366.73479988263375
+16,609.4564776739355,607.5162485653386,612.3944602465123,594.1937570340338,593.0004570514468,596.1405861684806,910.9849864426476,908.2138488534533,915.6392660912747
+32,2719.555966413325,2713.00270671728,2725.4250499879836,2812.7660040983606,2808.242909028018,2819.1458333333335,2921.819801830421,2919.528526414588,2928.77003109304
+64,17776.557416267944,17736.584051724138,17819.410263618192,14083.937823189666,14046.268052019077,14108.37641453246,12541.345378151262,12524.776339285716,12565.923475609756
diff --git a/docs/assets/bench/vs_linalg_lu_solve_median.svg b/docs/assets/bench/vs_linalg_lu_solve_median.svg
