test(docs): run md-companions strip test in CI (HF-154)

The md-companions markdown stripper is the acceptance gate for the
agent-friendly docs (per-page .md companions + llms.txt), but its test
lived at docs/.vuepress/plugins/md-companions/strip.test.js — a path and
suffix Jest's testMatch (`test/**/*spec.(ts|js)`) never discovers, so it
never ran in CI.

- Move the assertions into test/docs/md-companions-strip.spec.js as a
  Jest spec, where the default glob picks them up. The file is `.js`, so
  Karma's `.spec.ts`-only require.context skips it (the stripper is plain
  Node code, not part of the browser bundle).
- Add an ESLint override for `**/test/**/*.spec.js` mirroring the existing
  `scripts/*.js` relaxations (node env, allow require of untyped modules).
- Remove the orphan strip.test.js.
- CHANGELOG: note the agent-friendly docs under [Unreleased] > Added.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: marcin-kordas-hoc

.eslintrc.js

@@ -165,5 +165,23 @@ module.exports = {
         'no-undef': 'off',
       },
     },
+    {
+      // Plain-Node Jest specs (e.g. docs tooling tests that `require` JS modules
+      // rather than importing typed sources). Same relaxations as `scripts/*.js`.
+      files: ['**/test/**/*.spec.js'],
+      env: {
+        node: true,
+      },
+      rules: {
+        '@typescript-eslint/no-var-requires': 'off',
+        '@typescript-eslint/no-unsafe-argument': 'off',
+        '@typescript-eslint/no-unsafe-assignment': 'off',
+        '@typescript-eslint/no-unsafe-call': 'off',
+        '@typescript-eslint/no-unsafe-member-access': 'off',
+        '@typescript-eslint/no-unsafe-return': 'off',
+        '@typescript-eslint/restrict-template-expressions': 'off',
+        'no-undef': 'off',
+      },
+    },
   ],
 }

CHANGELOG.md

@@ -9,6 +9,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ### Added
 
+- Added agent-friendly documentation: per-page `.md` companions, a Copy-Markdown button, an `llms.txt` index, and a coding-agent setup guide. [#1696](https://github.com/handsontable/hyperformula/pull/1696)
 - Added an Indonesian (Bahasa Indonesia) language pack. [#1674](https://github.com/handsontable/hyperformula/pull/1674)
 
 ## [3.3.0] - 2026-05-20

docs/.vuepress/plugins/md-companions/strip.test.js

@@ -0,0 +1,58 @@
+/**
+ * CI-discoverable tests for the md-companions VuePress plugin's markdown
+ * stripper (HF-154, agent-friendly docs). The stripper turns VuePress-flavoured
+ * markdown into clean markdown for the per-page `.md` companions and `llms.txt`,
+ * so its fidelity is the acceptance gate for the feature.
+ *
+ * This is a `.js` spec under `test/` so Jest's testMatch (`test/**\/*spec.(ts|js)`)
+ * discovers it, while Karma (which only globs `.spec.ts`) skips it — the stripper
+ * is plain Node code that does not run in the browser bundle.
+ */
+const { stripVuePressSyntax } = require('../../docs/.vuepress/plugins/md-companions/strip')
+
+describe('md-companions stripVuePressSyntax', () => {
+  it('converts a tip container with a title to a blockquote', () => {
+    expect(stripVuePressSyntax(':::tip Heads up\nBe careful here.\n:::'))
+      .toBe('> **Heads up**\n>\n> Be careful here.')
+  })
+
+  it('converts a titleless warning container to a blockquote', () => {
+    expect(stripVuePressSyntax(':::warning\nDanger zone.\n:::'))
+      .toBe('> Danger zone.')
+  })
+
+  it('leaves ::: tokens inside a code fence untouched', () => {
+    expect(stripVuePressSyntax('```js\nconst x = ":::tip";\n```'))
+      .toBe('```js\nconst x = ":::tip";\n```')
+  })
+
+  it('removes <script> blocks', () => {
+    expect(stripVuePressSyntax('Text before\n<script>\nconsole.log(1)\n</script>\nText after'))
+      .toBe('Text before\nText after')
+  })
+
+  it('removes self-closing Vue components', () => {
+    expect(stripVuePressSyntax('Intro\n<CodingAgentWizard />\nOutro'))
+      .toBe('Intro\nOutro')
+  })
+
+  it('removes the [[toc]] marker', () => {
+    expect(stripVuePressSyntax('# Title\n[[toc]]\nBody'))
+      .toBe('# Title\nBody')
+  })
+
+  it('preserves plain markdown content', () => {
+    expect(stripVuePressSyntax('# H\n\n`code`\n\n[link](/guide/x)\n\n| a | b |\n|---|---|'))
+      .toBe('# H\n\n`code`\n\n[link](/guide/x)\n\n| a | b |\n|---|---|')
+  })
+
+  it('strips :::example (live demo) containers entirely', () => {
+    expect(stripVuePressSyntax('## Demo\n\n::: example #ex1 --html 1\n@[code](example.html)\n:::\n\nOutro'))
+      .toBe('## Demo\n\nOutro')
+  })
+
+  it('does not let an inner 3-backtick fence close a 4-backtick outer fence', () => {
+    expect(stripVuePressSyntax('````markdown\n```js\ncode\n```\n````'))
+      .toBe('````markdown\n```js\ncode\n```\n````')
+  })
+})