Merge develop into docs/astro-migration

Brings in two content-only commits that landed on develop after the
last sync:

- 0e047ee docs: fix SSR section framing in React integration guide (#1688)
- 79f2f15 docs: rewrite Vue integration guide around markRaw pattern (#1689)

Both touch files we migrated from `docs/guide/` to
`docs/src/content/docs/guide/`. Git's rename detection auto-applied
the develop-side edits to the new locations — no conflicts.

GitHub had flagged the PR as CONFLICTING because its mergeability check
hadn't recomputed since develop's last push; pushing this merge clears
that flag.

Author: GreenFlux

docs/src/content/docs/guide/integration-with-react.md

@@ -7,6 +7,10 @@ The HyperFormula API is identical in a React app and in plain JavaScript. This g
 
 Install with `npm install hyperformula`. For other options, see the [client-side installation](/docs/guide/client-side-installation) section.
 
+::: tip TypeScript
+All examples use TypeScript. Remove the type annotations to use plain JavaScript.
+:::
+
 ## Basic usage
 
 Hold the HyperFormula instance in a `useRef` so it survives re-renders. Initialize it inside `useEffect` and release it in the cleanup function. Use `useState` to toggle between raw formulas and computed values.
@@ -70,15 +74,13 @@ export default function SpreadsheetComponent() {
 }
 ```
 
-If you use JavaScript instead of TypeScript, drop the type annotations — the rest of the pattern is unchanged.
-
 ## `React.StrictMode` double invocation
 
 In development, React runs effects twice (mount → unmount → mount) to surface cleanup bugs. The pattern above is correct for StrictMode because `destroy()` runs before the re-mount creates a new instance, so no work leaks between the two lifecycles. Do not switch to a module-scoped singleton as a workaround — it will break StrictMode semantics.
 
 ## Server-side rendering (Next.js App Router)
 
-The component above is already SSR-safe — the engine is constructed in `useEffect`, which never runs on the server. If you still want to skip the initial bundle on the server (it is a few hundred kB), wrap it in a client-only dynamic import.
+The component above is already SSR-safe — the engine is constructed in `useEffect`, which never runs on the server. If you still want to keep HyperFormula out of the initial JS bundle sent to the browser (it is a few hundred kB), wrap it in a client-only dynamic import.
 
 In the App Router, `dynamic(..., { ssr: false })` is only allowed inside a client component. Put the dynamic call in a `'use client'` wrapper and import the wrapper from your server page:
 

docs/src/content/docs/guide/integration-with-vue.md

@@ -7,67 +7,47 @@ The HyperFormula API is identical in a Vue 3 app and in plain JavaScript. This g
 
 Install with `npm install hyperformula`. For other options, see the [client-side installation](/docs/guide/client-side-installation) section.
 
-## Basic usage
-
-Wrap the HyperFormula instance inside a plain class so it stays outside Vue's reactivity system (see [Troubleshooting](#vue-reactivity-issues) below for why this matters). Hold derived data in `ref` so the template updates when you reassign the ref's `.value`.
+::: tip TypeScript
+All examples use TypeScript. Remove the type annotations to use plain JavaScript.
+:::
 
-```typescript
-// spreadsheet-provider.ts
-import { HyperFormula, type CellValue } from 'hyperformula';
-
-export class SpreadsheetProvider {
-  private hf: HyperFormula;
-
-  constructor(data: (string | number | null)[][]) {
-    this.hf = HyperFormula.buildFromArray(data, {
-      licenseKey: 'gpl-v3',
-      // more configuration options go here
-    });
-  }
-
-  getCalculatedValues(): CellValue[][] {
-    return this.hf.getSheetValues(0);
-  }
-
-  getRawFormulas(): (string | number | null)[][] {
-    return this.hf.getSheetSerialized(0) as (string | number | null)[][];
-  }
-
-  destroy() {
-    this.hf.destroy();
-  }
-}
-```
+## Basic usage
 
-Use the class from a component with `<script setup>`:
+Pass the HyperFormula instance through Vue's [`markRaw`](https://vuejs.org/api/reactivity-advanced.html#markraw) to opt it out of the reactivity system (see [Troubleshooting](#vue-reactivity-issues) below for why this matters). Hold derived data in `ref` so the template updates when you reassign the ref's `.value`.
 
 ```vue
 <script setup lang="ts">
-import { onUnmounted, ref } from 'vue';
-import type { CellValue } from 'hyperformula';
-import { SpreadsheetProvider } from './spreadsheet-provider';
-
-const provider = new SpreadsheetProvider([
-  [1, 2, '=A1+B1'],
-  // your data rows go here
-]);
+import { markRaw, onUnmounted, ref } from "vue";
+import { HyperFormula, type CellValue } from "hyperformula";
+
+const hf = markRaw(
+  HyperFormula.buildFromArray(
+    [
+      [1, 2, "=A1+B1"],
+      // your data rows go here
+    ],
+    { licenseKey: "gpl-v3" },
+  ),
+);
 
 const values = ref<CellValue[][]>([]);
 
 function runCalculations() {
-  values.value = provider.getCalculatedValues();
+  values.value = hf.getSheetValues(0);
 }
 
 function reset() {
   values.value = [];
 }
 
-onUnmounted(() => provider.destroy());
+onUnmounted(() => hf.destroy());
 </script>
 
 <template>
-  <button @click="runCalculations">Run calculations</button>
-  <button @click="reset">Reset</button>
+  <button @click="runCalculations" :disabled="!!values.length">
+    Run calculations
+  </button>
+  <button @click="reset" :disabled="!values.length">Reset</button>
   <table v-if="values.length">
     <tr v-for="(row, r) in values" :key="r">
       <td v-for="(cell, c) in row" :key="c">{{ cell }}</td>
@@ -76,11 +56,11 @@ onUnmounted(() => provider.destroy());
 </template>
 ```
 
-The class keeps the HyperFormula instance as a private field, so Vue's reactivity Proxy never reaches it. This is the same pattern used in the [Vue 3 demo](#demo).
+`hf` is marked raw so Vue never proxies it — `values` is the only reactive piece. To mutate data, call any HyperFormula method (e.g. `setCellContents`) then reassign `values.value` to trigger a re-render. See [Basic operations](basic-operations.md) for the full mutation API.
 
 ## Server-side rendering (Nuxt)
 
-The class above is already SSR-safe — HyperFormula has no browser-only API dependency. To skip the (otherwise wasted) server-side instantiation in Nuxt, wrap the component with `<ClientOnly>`.
+HyperFormula has no browser-only API dependency. To skip server-side computation, wrap the component with `<ClientOnly>`.
 
 ## Troubleshooting
 
@@ -92,16 +72,16 @@ If you encounter an error like
 Uncaught TypeError: Cannot read properties of undefined (reading 'licenseKeyValidityState')
 ```
 
-it means that Vue's reactivity system tried to deeply observe the HyperFormula instance. Vue wraps reactive objects in a `Proxy` that intercepts every property access; when that proxy reaches a non-trivial instance with its own internal state, identity checks and lazy-initialized maps break. The fix is to opt the instance out of reactivity with Vue's [`markRaw`](https://vuejs.org/api/reactivity-advanced.html#markraw):
+it means that Vue's reactivity system tried to deeply observe the HyperFormula instance. Vue wraps reactive objects in a `Proxy` that intercepts every property access; when that proxy reaches a non-trivial instance with its own internal state, identity checks and lazy-initialized maps break. The fix is to opt the instance out of reactivity with [`markRaw`](https://vuejs.org/api/reactivity-advanced.html#markraw):
 
 ```typescript
-import { markRaw } from 'vue';
-import { HyperFormula } from 'hyperformula';
+import { markRaw } from "vue";
+import { HyperFormula } from "hyperformula";
 
-const hfInstance = markRaw(
+const hf = markRaw(
   HyperFormula.buildEmpty({
-    licenseKey: 'gpl-v3',
-  })
+    licenseKey: "gpl-v3",
+  }),
 );
 ```