docs(release): Prepare release v0.9.5

Version bump from 0.9.4 to 0.9.5 across the five canonical version
sites:

- src/version.h (FORMULON_VERSION_PATCH 4 -> 5)
- CMakeLists.txt (project VERSION)
- packages/npm/package.json
- packages/npm-native/package.json
- packages/python/pyproject.toml

CHANGELOG.md:
- Add [0.9.5] - 2026-07-04 section with Added / Fixed / Build-CI groups
  covering ad-hoc array evaluation (evaluateFormulaArray /
  evaluate_formula_array across C API, Node addon, WASM, and Python,
  with the two-step fm_workbook_evaluate_formula_array /
  fm_workbook_evaluate_formula_array_cell C ABI surface); the
  function-metadata provider seam (lazy-dispatch and parser
  special-form recognition in fm_function_metadata, unbounded-arity
  as null/None, and mergeFunctionMetadata / merge_function_metadata
  precedence helpers); spill-phantom cell enumeration and pagination
  fidelity; range-shaped defined names evaluating as Value::Array
  instead of collapsing via implicit intersection; and the
  python-smoke CI job added to prebuild.yml to catch C ABI drift
  before release
- Update [Unreleased] and footer compare links for v0.9.5

docs/releases/README.md:
- Prepend v0.9.5 as latest release entry
- Demote v0.9.4 to a dated entry

Author: libraz

CHANGELOG.md

@@ -7,6 +7,45 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.5] - 2026-07-04
+
+### Added
+
+- Ad-hoc array evaluation: `evaluateFormulaArray` (C API, Node addon,
+  WASM) and `evaluate_formula_array` (Python) evaluate a dynamic-array or
+  spilled formula against a workbook without mutating it, returning the
+  whole `Array` result instead of reducing to its top-left element. The C
+  ABI exposes a two-step surface — `fm_workbook_evaluate_formula_array`
+  stashes the result on the handle, `fm_workbook_evaluate_formula_array_cell`
+  reads it back by row-major index.
+- Function-metadata provider seam: hosts can inject localized function
+  documentation over the engine's structural catalog. `fm_function_metadata`
+  now also recognizes lazy-dispatch forms (`XLOOKUP`, `SUMIFS`, …) and
+  parser special forms (`LET`, `LAMBDA`), and surfaces the unbounded-arity
+  sentinel as `null` / `None`. Pure merge helpers `mergeFunctionMetadata`
+  (Node) and `merge_function_metadata` (Python) resolve
+  signature/description/localized name by locale-override → entry-default →
+  engine-value precedence. Contract documented in
+  `docs/function-metadata-schema.md`.
+
+### Fixed
+
+- Spill-phantom fidelity: `Sheet::spill_phantom_addresses` enumerates
+  phantom cells across all spill regions; cell enumeration and `cell_count`
+  now fold them in, `fm_workbook_cell_at` no longer treats a phantom
+  coordinate as an internal error, and pagination computes the used range
+  against a spilled region's full extent rather than just its anchor.
+- Range-shaped defined names (e.g. `Sheet1!$A$1:$A$5`) now evaluate as a
+  `Value::Array` instead of collapsing to a scalar through implicit
+  intersection.
+
+### Build / CI
+
+- Add a `python-smoke` job to `prebuild.yml` to catch C ABI drift before
+  release.
+
+**Detailed Release Notes**: [GitHub Release](https://github.com/libraz/formulon/releases/tag/v0.9.5)
+
 ## [0.9.4] - 2026-07-03
 
 ### Added
@@ -180,7 +219,8 @@ See the
 [GitHub release page](https://github.com/libraz/formulon/releases/tag/v0.9.0)
 for the full auto-generated change list.
 
-[Unreleased]: https://github.com/libraz/formulon/compare/v0.9.4...HEAD
+[Unreleased]: https://github.com/libraz/formulon/compare/v0.9.5...HEAD
+[0.9.5]: https://github.com/libraz/formulon/compare/v0.9.4...v0.9.5
 [0.9.4]: https://github.com/libraz/formulon/compare/v0.9.3...v0.9.4
 [0.9.3]: https://github.com/libraz/formulon/compare/v0.9.2...v0.9.3
 [0.9.2]: https://github.com/libraz/formulon/compare/v0.9.1...v0.9.2

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.20)
-project(formulon VERSION 0.9.4 LANGUAGES CXX)
+project(formulon VERSION 0.9.5 LANGUAGES CXX)
 
 # ---------------------------------------------------------------------------
 # Language standard and global settings

docs/releases/README.md

@@ -6,7 +6,8 @@ The high-level summary lives in [`CHANGELOG.md`](../../CHANGELOG.md).
 
 ## Available Versions
 
-- [v0.9.4](https://github.com/libraz/formulon/releases/tag/v0.9.4) — Latest release (2026-07-03) — read-only ad-hoc formula/CF evaluation, comment enumeration, and data-validation dropdown fixes.
+- [v0.9.5](https://github.com/libraz/formulon/releases/tag/v0.9.5) — Latest release (2026-07-04) — ad-hoc array evaluation, function-metadata provider seam, and spill-phantom / range-shaped defined-name fixes.
+- [v0.9.4](https://github.com/libraz/formulon/releases/tag/v0.9.4) — 2026-07-03 — read-only ad-hoc formula/CF evaluation, comment enumeration, and data-validation dropdown fixes.
 - [v0.9.3](https://github.com/libraz/formulon/releases/tag/v0.9.3) — 2026-07-03 — full binding-surface parity, XLSB/OOXML round-trip fidelity, and pivot/CF/print correctness fixes.
 - [v0.9.2](https://github.com/libraz/formulon/releases/tag/v0.9.2) — 2026-05-18 — workbook oracle track (pivot + print) and dynamic-array / parser / print-pagination fixes.
 - [v0.9.1](https://github.com/libraz/formulon/releases/tag/v0.9.1) — 2026-05-11 — OOXML print settings round-trip + unknown rels / shared-formula fixes.

packages/npm-native/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libraz/formulon-native",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Excel 365 calculation engine -- native N-API binding",
   "license": "Apache-2.0",
   "author": "libraz",

packages/npm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@libraz/formulon",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Excel 365 calculation engine -- WASM binding",
   "license": "Apache-2.0",
   "author": "libraz",

packages/python/pyproject.toml

@@ -20,7 +20,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "formulon"
-version = "0.9.4"
+version = "0.9.5"
 description = "Excel 365 calculation engine -- Python binding"
 readme = "README.md"
 license = "Apache-2.0"

src/version.h

@@ -9,7 +9,7 @@
 
 #define FORMULON_VERSION_MAJOR 0
 #define FORMULON_VERSION_MINOR 9
-#define FORMULON_VERSION_PATCH 4
+#define FORMULON_VERSION_PATCH 5
 
 #define FORMULON_VERSION_STRINGIFY_(x) #x
 #define FORMULON_VERSION_STRINGIFY(x) FORMULON_VERSION_STRINGIFY_(x)