style: format documentation files with oxfmt

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Goosterhof

docs/.vitepress/config.mts

@@ -1,74 +1,74 @@
-import { defineConfig } from 'vitepress'
+import { defineConfig } from "vitepress";
 
 export default defineConfig({
-  title: 'FS Packages',
-  description: 'Shared frontend service packages by Script Development',
+  title: "FS Packages",
+  description: "Shared frontend service packages by Script Development",
 
   themeConfig: {
     nav: [
-      { text: 'Home', link: '/' },
-      { text: 'Getting Started', link: '/getting-started' },
-      { text: 'Architecture', link: '/architecture' },
-      { text: 'Packages', link: '/packages/http' },
-      { text: 'Contributing', link: '/contributing' },
+      { text: "Home", link: "/" },
+      { text: "Getting Started", link: "/getting-started" },
+      { text: "Architecture", link: "/architecture" },
+      { text: "Packages", link: "/packages/http" },
+      { text: "Contributing", link: "/contributing" },
     ],
 
     sidebar: {
-      '/': [
+      "/": [
         {
-          text: 'Guide',
+          text: "Guide",
           items: [
-            { text: 'Getting Started', link: '/getting-started' },
-            { text: 'Architecture', link: '/architecture' },
-            { text: 'Contributing', link: '/contributing' },
+            { text: "Getting Started", link: "/getting-started" },
+            { text: "Architecture", link: "/architecture" },
+            { text: "Contributing", link: "/contributing" },
           ],
         },
         {
-          text: 'Foundation',
+          text: "Foundation",
           collapsed: false,
           items: [
-            { text: 'fs-http', link: '/packages/http' },
-            { text: 'fs-storage', link: '/packages/storage' },
-            { text: 'fs-helpers', link: '/packages/helpers' },
+            { text: "fs-http", link: "/packages/http" },
+            { text: "fs-storage", link: "/packages/storage" },
+            { text: "fs-helpers", link: "/packages/helpers" },
           ],
         },
         {
-          text: 'Services',
+          text: "Services",
           collapsed: false,
           items: [
-            { text: 'fs-theme', link: '/packages/theme' },
-            { text: 'fs-loading', link: '/packages/loading' },
-            { text: 'fs-toast', link: '/packages/toast' },
-            { text: 'fs-dialog', link: '/packages/dialog' },
-            { text: 'fs-translation', link: '/packages/translation' },
+            { text: "fs-theme", link: "/packages/theme" },
+            { text: "fs-loading", link: "/packages/loading" },
+            { text: "fs-toast", link: "/packages/toast" },
+            { text: "fs-dialog", link: "/packages/dialog" },
+            { text: "fs-translation", link: "/packages/translation" },
           ],
         },
         {
-          text: 'Domain',
+          text: "Domain",
           collapsed: false,
           items: [
-            { text: 'fs-adapter-store', link: '/packages/adapter-store' },
-            { text: 'fs-router', link: '/packages/router' },
+            { text: "fs-adapter-store", link: "/packages/adapter-store" },
+            { text: "fs-router", link: "/packages/router" },
           ],
         },
       ],
     },
 
     socialLinks: [
-      { icon: 'github', link: 'https://github.com/script-development/fs-packages' },
-      { icon: 'npm', link: 'https://www.npmjs.com/org/script-development' },
+      { icon: "github", link: "https://github.com/script-development/fs-packages" },
+      { icon: "npm", link: "https://www.npmjs.com/org/script-development" },
     ],
 
     search: {
-      provider: 'local',
+      provider: "local",
     },
 
     outline: {
       level: [2, 3],
     },
 
     footer: {
-      message: 'Built by Script Development & Back to Code',
+      message: "Built by Script Development & Back to Code",
     },
   },
-})
+});

docs/architecture.md

@@ -199,8 +199,8 @@ Vue-dependent packages use Vue's reactivity primitives (`Ref`, `ComputedRef`, `r
 ```typescript
 const loading = createLoadingService();
 
-loading.isLoading;    // ComputedRef<boolean> — use in templates, watch, computed
-loading.activeCount;  // DeepReadonly<Ref<number>> — readable but not writable
+loading.isLoading; // ComputedRef<boolean> — use in templates, watch, computed
+loading.activeCount; // DeepReadonly<Ref<number>> — readable but not writable
 ```
 
 This means services integrate naturally with Vue's ecosystem:
@@ -245,7 +245,7 @@ const routes = [
 
 const router = createRouterService(routes);
 
-router.goToEditPage("users", 42);    // compiles — "users" exists and has an edit page
+router.goToEditPage("users", 42); // compiles — "users" exists and has an edit page
 router.goToEditPage("projects", 42); // compile error — "projects" is not a valid route
 ```
 
@@ -254,15 +254,18 @@ router.goToEditPage("projects", 42); // compile error — "projects" is not a va
 `fs-translation` validates keys against your translation schema:
 
 ```typescript
-const translation = createTranslationService({
-  en: {
-    common: { save: "Save", cancel: "Cancel" },
-    users: { title: "Users", empty: "No users found" },
+const translation = createTranslationService(
+  {
+    en: {
+      common: { save: "Save", cancel: "Cancel" },
+      users: { title: "Users", empty: "No users found" },
+    },
   },
-}, "en");
+  "en",
+);
 
-translation.t("common.save");    // compiles — "common.save" exists
-translation.t("common.delete");  // compile error — "common.delete" doesn't exist
+translation.t("common.save"); // compiles — "common.save" exists
+translation.t("common.delete"); // compile error — "common.delete" doesn't exist
 ```
 
 ## The Dependency Graph

docs/contributing.md

@@ -73,16 +73,16 @@ npm run lint:pkg
 
 Every pull request must pass all 8 gates in order:
 
-| Gate | Command | What it checks |
-|------|---------|----------------|
-| 1. Audit | `npm audit` | No known vulnerabilities in dependencies |
-| 2. Format | `npm run format:check` | Code follows oxfmt formatting rules |
-| 3. Lint | `npm run lint` | No oxlint violations |
-| 4. Build | `npm run build` | All packages compile successfully |
-| 5. Typecheck | `npm run typecheck` | No TypeScript errors in strict mode |
-| 6. Package lint | `npm run lint:pkg` | Package exports are correct (publint + attw) |
-| 7. Coverage | `npm run test:coverage` | 100% code coverage per package |
-| 8. Mutation | `npm run test:mutation` | 90% mutation score per package |
+| Gate            | Command                 | What it checks                               |
+| --------------- | ----------------------- | -------------------------------------------- |
+| 1. Audit        | `npm audit`             | No known vulnerabilities in dependencies     |
+| 2. Format       | `npm run format:check`  | Code follows oxfmt formatting rules          |
+| 3. Lint         | `npm run lint`          | No oxlint violations                         |
+| 4. Build        | `npm run build`         | All packages compile successfully            |
+| 5. Typecheck    | `npm run typecheck`     | No TypeScript errors in strict mode          |
+| 6. Package lint | `npm run lint:pkg`      | Package exports are correct (publint + attw) |
+| 7. Coverage     | `npm run test:coverage` | 100% code coverage per package               |
+| 8. Mutation     | `npm run test:mutation` | 90% mutation score per package               |
 
 ::: tip Why mutation testing?
 100% code coverage means every line of code was executed during tests. It does not mean every line was actually **verified**. Mutation testing changes your code (introduces "mutants") and checks whether your tests catch the change. A 90% mutation score means your tests detect 90% of possible bugs — not just that they run the code.
@@ -180,7 +180,9 @@ export function createExampleService(config: ExampleConfig): ExampleService {
   // return public API as plain object
   return {
     value: computed(() => state.value),
-    doSomething() { /* ... */ },
+    doSomething() {
+      /* ... */
+    },
   };
 }
 ```

docs/getting-started.md

@@ -128,7 +128,7 @@ export const dialog = createDialogService();
 // Translation
 export const translation = createTranslationService(
   { en: { common: { save: "Save", cancel: "Cancel" } } },
-  "en"
+  "en",
 );
 ```
 

docs/index.md

@@ -38,32 +38,32 @@ All packages are published under the `@script-development` scope on npm.
 
 These packages have zero Vue dependency — they work in any TypeScript project.
 
-| Package | Description |
-|---------|-------------|
-| [fs-http](/packages/http) | HTTP service factory with middleware architecture |
-| [fs-storage](/packages/storage) | localStorage service factory with prefix namespacing |
+| Package                         | Description                                                       |
+| ------------------------------- | ----------------------------------------------------------------- |
+| [fs-http](/packages/http)       | HTTP service factory with middleware architecture                 |
+| [fs-storage](/packages/storage) | localStorage service factory with prefix namespacing              |
 | [fs-helpers](/packages/helpers) | Tree-shakeable utilities: deep copy, type guards, case conversion |
 
 ### Services
 
 Vue-powered reactive services for common application concerns.
 
-| Package | Description |
-|---------|-------------|
-| [fs-theme](/packages/theme) | Reactive dark/light mode with system preference detection |
-| [fs-loading](/packages/loading) | Loading state service with HTTP middleware integration |
-| [fs-toast](/packages/toast) | Component-agnostic toast notification queue |
-| [fs-dialog](/packages/dialog) | Component-agnostic dialog stack with error middleware |
-| [fs-translation](/packages/translation) | Type-safe reactive i18n with multi-locale support |
+| Package                                 | Description                                               |
+| --------------------------------------- | --------------------------------------------------------- |
+| [fs-theme](/packages/theme)             | Reactive dark/light mode with system preference detection |
+| [fs-loading](/packages/loading)         | Loading state service with HTTP middleware integration    |
+| [fs-toast](/packages/toast)             | Component-agnostic toast notification queue               |
+| [fs-dialog](/packages/dialog)           | Component-agnostic dialog stack with error middleware     |
+| [fs-translation](/packages/translation) | Type-safe reactive i18n with multi-locale support         |
 
 ### Domain
 
 Higher-level packages for domain-driven application architecture.
 
-| Package | Description |
-|---------|-------------|
-| [fs-adapter-store](/packages/adapter-store) | Reactive state management with CRUD resource adapters |
-| [fs-router](/packages/router) | Type-safe router with CRUD navigation and middleware pipeline |
+| Package                                     | Description                                                   |
+| ------------------------------------------- | ------------------------------------------------------------- |
+| [fs-adapter-store](/packages/adapter-store) | Reactive state management with CRUD resource adapters         |
+| [fs-router](/packages/router)               | Type-safe router with CRUD navigation and middleware pipeline |
 
 ## Quality Guarantees
 

docs/packages/adapter-store.md

@@ -15,6 +15,7 @@ npm install @script-development/fs-adapter-store
 ## The Big Picture
 
 A typical application has domain resources — users, projects, invoices — that need to be:
+
 1. **Fetched** from an API
 2. **Stored** in reactive state
 3. **Displayed** in components
@@ -43,11 +44,11 @@ import { createAdapterStoreModule, resourceAdapter } from "@script-development/f
 import { http, storage, loading } from "@/services";
 
 const usersStore = createAdapterStoreModule<User>({
-  domainName: "users",           // API endpoint: /users
-  adapter: resourceAdapter,       // CRUD adapter factory
-  httpService: http,              // for API calls
-  storageService: storage,        // for offline persistence
-  loadingService: loading,        // for waiting on data
+  domainName: "users", // API endpoint: /users
+  adapter: resourceAdapter, // CRUD adapter factory
+  httpService: http, // for API calls
+  storageService: storage, // for offline persistence
+  loadingService: loading, // for waiting on data
 });
 ```
 
@@ -117,15 +118,15 @@ When a resource comes from the API (has an `id`), it's wrapped in an `Adapted` o
 const user = usersStore.getById(1).value;
 
 // Read original values (readonly, frozen)
-user.id;    // 1
-user.name;  // "Alice"
+user.id; // 1
+user.name; // "Alice"
 user.email; // "alice@example.com"
 
 // Edit via mutable ref
 user.mutable.value.name = "Bob";
 
 // Save changes
-await user.update();  // PUT /users/1 — sends full object
+await user.update(); // PUT /users/1 — sends full object
 await user.patch({ name: "Bob" }); // PATCH /users/1 — sends partial update
 
 // Discard edits
@@ -143,7 +144,7 @@ When you create a new resource via `generateNew()`, it's wrapped in a `NewAdapte
 const newUser = usersStore.generateNew();
 
 // Default values (readonly, frozen)
-newUser.name;  // "" (empty defaults)
+newUser.name; // "" (empty defaults)
 newUser.email; // ""
 
 // Edit via mutable ref
@@ -218,40 +219,40 @@ import { EntryNotFoundError, MissingResponseDataError } from "@script-developmen
 
 ### `createAdapterStoreModule(config)`
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `config.domainName` | `string` | Resource endpoint name (e.g., `"users"`) |
-| `config.adapter` | `Adapter` | CRUD adapter factory (use `resourceAdapter`) |
-| `config.httpService` | `Pick<HttpService, "getRequest">` | HTTP service for fetching |
-| `config.storageService` | `Pick<StorageService, "get" \| "put">` | Storage for persistence |
-| `config.loadingService` | `Pick<LoadingService, "ensureLoadingFinished">` | Loading service for sync |
+| Parameter               | Type                                            | Description                                  |
+| ----------------------- | ----------------------------------------------- | -------------------------------------------- |
+| `config.domainName`     | `string`                                        | Resource endpoint name (e.g., `"users"`)     |
+| `config.adapter`        | `Adapter`                                       | CRUD adapter factory (use `resourceAdapter`) |
+| `config.httpService`    | `Pick<HttpService, "getRequest">`               | HTTP service for fetching                    |
+| `config.storageService` | `Pick<StorageService, "get" \| "put">`          | Storage for persistence                      |
+| `config.loadingService` | `Pick<LoadingService, "ensureLoadingFinished">` | Loading service for sync                     |
 
 ### Store Module Methods
 
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `getAll` | `ComputedRef<Adapted[]>` | Reactive list of all adapted resources |
-| `getById(id)` | `ComputedRef<Adapted \| undefined>` | Reactive lookup by ID |
-| `getOrFailById(id)` | `Promise<Adapted>` | Wait for loading, throw if not found |
-| `generateNew()` | `NewAdapted` | Create a new unsaved resource |
-| `retrieveAll()` | `Promise<void>` | Fetch all from API and update state |
+| Method              | Returns                             | Description                            |
+| ------------------- | ----------------------------------- | -------------------------------------- |
+| `getAll`            | `ComputedRef<Adapted[]>`            | Reactive list of all adapted resources |
+| `getById(id)`       | `ComputedRef<Adapted \| undefined>` | Reactive lookup by ID                  |
+| `getOrFailById(id)` | `Promise<Adapted>`                  | Wait for loading, throw if not found   |
+| `generateNew()`     | `NewAdapted`                        | Create a new unsaved resource          |
+| `retrieveAll()`     | `Promise<void>`                     | Fetch all from API and update state    |
 
 ### Adapted Properties
 
-| Property | Type | Description |
-|----------|------|-------------|
-| *(all resource fields)* | `readonly` | Original values from API |
-| `mutable` | `Ref<Writable<T>>` | Editable copy |
-| `reset()` | `() => void` | Revert mutable to original |
-| `update()` | `() => Promise<T>` | PUT full resource |
-| `patch(partial)` | `(partial) => Promise<T>` | PATCH partial update |
-| `delete()` | `() => Promise<void>` | DELETE resource |
+| Property                | Type                      | Description                |
+| ----------------------- | ------------------------- | -------------------------- |
+| _(all resource fields)_ | `readonly`                | Original values from API   |
+| `mutable`               | `Ref<Writable<T>>`        | Editable copy              |
+| `reset()`               | `() => void`              | Revert mutable to original |
+| `update()`              | `() => Promise<T>`        | PUT full resource          |
+| `patch(partial)`        | `(partial) => Promise<T>` | PATCH partial update       |
+| `delete()`              | `() => Promise<void>`     | DELETE resource            |
 
 ### NewAdapted Properties
 
-| Property | Type | Description |
-|----------|------|-------------|
-| *(all new fields)* | `readonly` | Default values |
-| `mutable` | `Ref<Writable<N>>` | Editable copy |
-| `reset()` | `() => void` | Revert mutable to defaults |
-| `create()` | `() => Promise<T>` | POST to create resource |
+| Property           | Type               | Description                |
+| ------------------ | ------------------ | -------------------------- |
+| _(all new fields)_ | `readonly`         | Default values             |
+| `mutable`          | `Ref<Writable<N>>` | Editable copy              |
+| `reset()`          | `() => void`       | Revert mutable to defaults |
+| `create()`         | `() => Promise<T>` | POST to create resource    |