docs(HF-282): auto-derive function & language counts in docs

[marcin-kordas-hoc]

What & why

The docs stated a hardcoded count of built-in functions ("~400"/"400+") and languages ("17"/"18") that drifts from reality. The function count already auto-derived via {{ $page.functionsCount }}; this adds the parallel {{ $page.languagesCount }} and swaps the remaining hardcoded counts to the interpolated variables.

How

• docs/.vuepress/config.js: derive languagesCount once at config load from the i18n export barrel src/i18n/languages/index.ts (whitespace-tolerant regex + fail-loud guard so a barrel reformat can never silently publish "0 languages"); inject $page.languagesCount.
• Docs: ~400/400+ → {{ $page.functionsCount }} (index, ai-sdk, mcp-server, langchain); 17/18 → {{ $page.languagesCount }} (index, built-in-functions, i18n-features, localizing-functions).
• README.md (not a VuePress page, so no interpolation possible): manual over 400 + 18, with the language count now asserted against the same i18n barrel at config load (3b4fda30f) so it fails the docs build instead of rotting silently.
• docs/.vuepress/plugins/md-companions/index.js: register languagesCount with the companion {{ $page.* }} resolver (3ef3fdddc). The resolver arrived with Agent-friendly documentation: .md companions, llms.txt, coding-agent guide (HF-154) #1703 and substitutes an allowlist of injected keys, so without this the built .md companions and llms-full.txt shipped the raw mustache while the HTML rendered the number.

Verification

docs:build renders the real counts (functions / languages), including inside markdown link text, with no un-rendered {{ }} in the built output. Docs-only + docs-build-config → no CHANGELOG per DEV_DOCS DoD.

Known nuance

README.md counts stay hand-edited — it is rendered by GitHub and npm, neither of which runs VuePress, so {{ $page.* }} would publish literally. The language count is therefore guarded rather than interpolated: the docs build fails if README disagrees with the barrel, or if the <n> built-in languages phrase disappears. Verified both failure modes. The function count needs no guard — "over 400" is chosen so the line does not restale as functions grow. The localizing-functions.md language table rows remain hand-maintained.

The guard couples the docs build to README.md, which is a deliberate trade: the alternative was generating README as a build product, and it is a file people edit directly.

ClickUp task: https://app.clickup.com/t/9015210959/HF-282

Update (28.08 rebase): develop replaced docs/guide/built-in-functions.md with a generated page (template docs/guide/built-in-functions.tmpl.md + generator, HF-249/#1692). This PR's one-line change to that page now lives in the template — the generator copies prose verbatim, and npm run docs:build renders {{ $page.languagesCount }} correctly in the generated output (verified: zero unrendered mustaches in dist/). Commit SHAs in this description refer to the rebased branch.

---

Note

Low Risk
Docs and VuePress build configuration only; no runtime library or API behavior changes.

Overview
Stops hardcoded function and language totals in docs and the root README from drifting when the catalogue or i18n packs change.

VuePress now derives languagesCount at config load from src/i18n/languages (with a barrel re-export check) and injects {{ $page.languagesCount }} alongside the existing function count. The function total is computed once via getAvailableFunctions() on a default-config engine—the same approach as script/generate-builtin-functions-doc.ts—instead of getRegisteredFunctionNames, so the headline number matches the generated built-in-functions table. Guide pages, index, and integration previews swap ~400 / 400+ and 17 / 18 for {{ $page.functionsCount }} and {{ $page.languagesCount }}; the md-companions allowlist resolves languagesCount in shipped .md / llms-full.txt.

README.md (GitHub/npm, no VuePress) is updated manually to over 400 functions and 18 languages; the docs build fails if the i18n features bullet’s language number disagrees with the derived count.

^{Reviewed by Cursor Bugbot for commit ea8e6a4. Bugbot is set up for automated code reviews on this repo. Configure here.}

[netlify]

✅ Deploy Preview for hyperformula-dev-docs ready!

Name	Link
🔨 Latest commit	474c21a
🔍 Latest deploy log	https://app.netlify.com/projects/hyperformula-dev-docs/deploys/6a68b8f63a267600080a8ba7
😎 Deploy Preview	https://deploy-preview-1715--hyperformula-dev-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[qunabu]

Task linked: HF-282 No. of supported functions and languages in the docs is not updated automatically

[github-actions]

Performance comparison of head (ea8e6a4) vs base (f9c50c1)

                                     testName |    base |    head | change
--------------------------------------------------------------------------
                                      Sheet A |  496.65 |  502.29 | +1.14%
                                      Sheet B |  164.56 |  163.52 | -0.63%
                                      Sheet T |  145.97 |  138.44 | -5.16%
                                Column ranges |  483.83 |  474.46 | -1.94%
                                Sorted lookup | 14346.3 | 14059.4 | -2.00%
Sheet A:  change value, add/remove row/column |   16.31 |   15.93 | -2.33%
 Sheet B: change value, add/remove row/column |  144.51 |  142.86 | -1.14%
                   Column ranges - add column |  158.53 |  159.06 | +0.33%
                Column ranges - without batch |   497.2 |  490.11 | -1.43%
                        Column ranges - batch |  120.95 |  123.03 | +1.72%

[marcin-kordas-hoc]

bugbot run

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 9974cda. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 717e7f4. Configure here.}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	hyperformula-docs	ea8e6a4	Commit Preview URL Branch Preview URL	Sep 02 2026, 02:16 PM

[qunabu]

Task linked: HF-249 HF function documentation available via API

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 97.32%. Comparing base (f9c50c1) to head (ea8e6a4).

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #1715   +/-   ##
========================================
  Coverage    97.32%   97.32%           
========================================
  Files          195      195           
  Lines        15739    15739           
  Branches      3390     3390           
========================================
  Hits         15318    15318           
  Misses         421      421           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.