feat(http): add HTTP client space (#766)

* feat(http): scaffold space registration, route and locales

* feat(http): add storage types, paths and contracts

* feat(http): add state, frontmatter parser and disk sync

* feat(http): add folders and requests storages

Implements HttpFoldersStorage (CRUD over folders persisted in
state.yaml plus filesystem dirs) and HttpRequestsStorage (CRUD over
.md request files with frontmatter). Extends shared validation kinds
to cover 'request' for sibling-name conflict messages.

* feat(http): wire environments, history, provider and watcher

Adds HTTP environments and history storages on top of state.yaml,
exposes createHttpStorageProvider via useHttpStorage(), registers
HTTP space in PERSISTED_SPACE_IDS and integrates http runtime cache
into the markdown watcher so external file changes resync and
broadcast storage-synced.

* feat(http): add API DTOs and routes for folders, requests, environments and history

* feat(http): add execute IPC handler with undici, env interpolation and history

* refactor(http): extract shared types to src/main/types/http.ts

Single source of truth for HTTP primitives shared between main, IPC and
renderer (renderer tsconfig already includes src/main/types/**). Removes
duplicate definitions from runtime/types.ts and inline declarations in
the IPC handler.

* feat(http): add renderer composables for folders, requests, environments, history and execute

Module-level reactive state for the HTTP space. Mirrors the notes-space
pattern: useHttpFolders/useHttpRequests/useHttpEnvironments/useHttpHistory
talk to the REST API, useHttpExecute wraps the spaces:http:execute IPC,
useHttpApp owns the cross-composable folderId/requestId selection.

useHttpRequests tracks a draft snapshot against the loaded request so the
UI can detect dirty state and offer save/discard. Adds the
spaces.http.untitledRequest i18n key for default request names.

* feat(http): scaffold 3-column space layout with sidebar/editor/response

HttpSpace view wires LayoutThreeColumn with HttpSidebar, RequestEditor and
ResponsePanel placeholders. useHttpSpaceInit kicks off folders/requests/
environments/history fetches once on mount. Real component bodies follow
in Phase 6.2-6.5.

* feat(http): render sidebar tree with folders, requests and context menus

* feat(http): split layout into folders sidebar, requests list and editor pane

* fix(http): use registered Http* component names and add search input

* fix(http): match notes list header layout (single search row with + button)

* feat(http): add description and enabled flags on header/query KV entries

* feat(http): redesign KeyValueTable with checkbox, description column and row actions

* refactor(http-editor): polish header, drop save button and rename description tab to pre-request

* style(http): show full uppercase method label in HttpMethodBadge

* refactor(http): migrate folders sidebar to UiTree with multi-select and drag-drop

* feat(http): multi-select, multi-delete and drag-drop in request list

* feat(store): add http selection state to app store

* feat(http): persist selected request and folder across reloads

* refactor(http): remove unused send button label and folder info display

* feat(http): bidirectional sync between request URL and query params

* feat(http): implement body, auth and description tabs

* feat(http): polish ResponsePanel with status, headers and copy

* fix(http): use Http* prefix for tab components

* feat(http): replace body textarea with CM6 editor and JSON validation

* feat(http): validate JSON body on blur instead of every change

* fix(http): hide internal JSON parse error details from user

* fix(http): nest response i18n keys inside editor namespace

* fix(http): apply custom scrollbar class to overflow containers

* feat(http): hide pre-request tab until implementation

* fix(http): avoid duplicate query params

* fix(http): refresh state after storage changes

* fix(http): persist active space

* fix(http): localize empty request url

* feat(http): support sidebar/list visibility toggle via View menu

* style(http): align RequestEditor header with code/notes editor pattern

* style(http): drop font-mono from URL input

* feat(http): api-based search with state restore

Mirror notes/snippets search pattern: server-side filter by name and url
via ?search= query, separate requestsBySearch list, snapshot of selection
before search and restore on clear. Eliminate redundant GET /:id calls by
selecting from already-loaded list data.

* feat(http): environments switcher and manager dialog

EnvironmentSwitcher — icon button in RequestEditor header with active
env tooltip and popover (none / list / manage). EnvironmentManagerDialog
— two-pane modal with env list and key/value variables editor, autosave
debounced 500ms, draft re-syncs only on selection change to avoid races.

* feat(http): variable interpolation highlight and autocomplete

* style(http): render {{var}} as chips

* style(http): theme-aware {{var}} chip colors via tokens

* feat(http): add request name input above url row

* style(http): use default variant for method select and url input

* style(http): tweak environment and send icons in editor header

* feat(http): validate request name on rename

* feat(http): auto-rename request on folder change conflict

* chore: prevent auto-focus on close for environment popover

* fix(http): make response panel resizable

* feat(http): add request preview panel

* refactor(http): use compact preview copy action

* refactor(http): add response header copy action

* refactor(http): move response summary to bottom panel

* refactor(http): reuse code viewer for response body

* refactor(cm): share editor extensions

* feat(http): highlight request preview

* refactor(cm): remove notes extension aliases

* feat(http): move environments to sidebar

* feat(http): track donation activity

* fix(http): align environment rows

* refactor(http): align body editor with cm6 viewer

* fix(http): use ui font in url input

* feat(http): reorder math space definition in getSpaceDefinitions

* feat(http): add send request shortcut

* feat(notes): link http requests

* fix(http): refresh vault changes

* fix(http): interpolate preview variables

* feat(http): expand request context menu

* feat(http): add http preferences

* fix(http): tune environment panel

* fix(http): confirm environment deletes

* refactor(http): reuse key value table

* fix(http): improve selected request item

* feat(http): add folder custom icons

* fix(http): select first request on folder change

* docs: add http space documentation

* chore(docs): remove AppVersion tag from environments and requests documentation

* fix(http): prevent environment dialog autofocus tooltips

Author: antonreshetov

.github/workflows/build-sponsored.yml

@@ -76,5 +76,3 @@ jobs:
             dist/*.snap
           if-no-files-found: warn
           retention-days: 30
-
-

.github/workflows/release.yml

@@ -118,5 +118,3 @@ jobs:
           append_body: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-

CONTRIBUTING.md

@@ -31,4 +31,4 @@ fix #123
 
 It's ok to have multiple commits in a single PR, you don't need to rebase or force push for your changes as we will use Squash and Merge to squash the commits into one commit when merging.
 
-And of course please test your code before PR. 
+And of course please test your code before PR.

README.md

@@ -8,7 +8,7 @@ A free, open-source developer workspace.
 </p>
 
 <p align="center">
-  <strong>Snippets, notes, calculations, and dev tools in one local-first app.</strong>
+  <strong>Snippets, notes, HTTP requests, calculations, and dev tools in one local-first app.</strong>
   <br>
   Your data stays on your machine as plain Markdown files.
 </p>
@@ -75,7 +75,7 @@ massCode is free and open source. But building and maintaining a quality tool ta
 
 ## About
 
-Originally a snippet manager, massCode now brings together snippets, notes, calculations, and developer tools in one desktop app, so everyday work stays in one place.
+Originally a snippet manager, massCode now brings together snippets, notes, HTTP requests, calculations, and developer tools in one desktop app, so everyday work stays in one place.
 
 ## Features
 
@@ -101,6 +101,17 @@ Write longer markdown documents right next to your snippets: project docs, draft
 - Fullscreen presentation mode for demos and meetings
 - Callout blocks and image embedding
 
+### HTTP Client
+
+Keep API requests close to your code snippets and project notes with a lightweight HTTP client built into massCode.
+
+- Organize requests with folders and custom folder icons
+- Use environments and `{{variables}}` for local, staging, and production APIs
+- Edit params, headers, body, auth, and markdown descriptions
+- Preview requests as raw HTTP or cURL before sending
+- Inspect response status, time, size, body, and headers
+- Send the current request with <kbd>Cmd+Enter</kbd> on macOS or <kbd>Ctrl+Enter</kbd> on Windows and Linux
+
 ### Math Notebook
 
 A calculator-style notebook for natural-language calculations, conversions, and date math without leaving your workflow.
@@ -122,7 +133,7 @@ Built-in utilities for the small tasks that usually send you to a browser tab:
 
 ## Markdown Vault
 
-Your snippets and notes live as plain `.md` files on disk with frontmatter metadata, so the data stays readable and portable.
+Your snippets, notes, and HTTP requests live as plain `.md` files on disk with frontmatter metadata, so the data stays readable and portable.
 
 - **Git-friendly** - track changes and sync via any Git remote
 - **Cloud sync** - works with iCloud, Dropbox, Google Drive, Syncthing

docs/website/.vitepress/_data/assets.json

@@ -5,4 +5,4 @@
   "win": "https://github.com/massCodeIO/massCode/releases/download/v4.7.1/massCode-4.7.1-x64.exe",
   "winPortable": "https://github.com/massCodeIO/massCode/releases/download/v4.7.1/massCode-4.7.1-x64-portable.exe",
   "linux": "https://github.com/massCodeIO/massCode/releases/download/v4.7.1/massCode-4.7.1.AppImage"
-}
+}

docs/website/.vitepress/config.mts

@@ -132,6 +132,14 @@ export default defineConfig({
             { text: 'Search', link: '/documentation/notes/search' },
           ],
         },
+        {
+          text: 'HTTP',
+          items: [
+            { text: 'HTTP Client', link: '/documentation/http/' },
+            { text: 'Requests', link: '/documentation/http/requests' },
+            { text: 'Environments', link: '/documentation/http/environments' },
+          ],
+        },
         {
           text: 'Math',
           items: [

docs/website/documentation/http/environments.md

@@ -0,0 +1,49 @@
+---
+title: HTTP Environments
+description: "Use HTTP environments in massCode to manage reusable variables for local, staging, and production API requests."
+---
+
+# Environments
+
+Environments store reusable variables for requests. Use them for values that change between local, staging, and production APIs, such as base URLs, user IDs, organization IDs, and tokens.
+
+<img :src="withBase('/http-envs.png')">
+
+## Variables
+
+Use variables with double braces:
+
+```text
+{{apiUrl}}/v1/users/{{userId}}/sessions
+```
+
+The URL field keeps variables visible while you edit. Preview and request execution resolve variables from the active environment.
+
+Variables can be used in:
+
+- URL
+- params
+- headers
+- body
+- auth fields
+
+## Active Environment
+
+Use the **Environments** panel below folders to choose the active environment.
+
+Select **No environment** when you want requests to keep variables unresolved. This is useful when you are editing templates or copying a request without applying local values.
+
+## Managing Environments
+
+Open **Manage** from the Environments panel to create environments and edit variables.
+
+Each environment has:
+
+- a name
+- a key-value table of variables
+
+The active environment is stored as part of the HTTP space state.
+
+<script setup>
+import { withBase } from 'vitepress'
+</script>

docs/website/documentation/http/index.md

@@ -0,0 +1,46 @@
+---
+title: HTTP Client
+description: "Use the HTTP space in massCode as a lightweight local-first API client for saved requests, environments, previews, and responses."
+---
+
+# HTTP Client
+
+<AppVersion text=">=5.3" />
+
+HTTP is the API client space inside massCode. Use it to keep reusable requests next to your snippets and notes, test endpoints during development, and store small API collections in your local vault.
+
+Access HTTP from the **HTTP** icon in the Space rail. The layout follows the same workspace pattern as Code and Notes: folders on the left, requests in the middle, and the request editor with preview and response panels on the right.
+
+<img :src="withBase('/http.png')">
+
+## When to use HTTP
+
+Use HTTP when you want a lightweight request client without leaving massCode.
+
+- test local or remote API endpoints
+- save repeatable requests by project or service
+- keep request descriptions close to implementation notes
+- switch variables between local, staging, and production environments
+- copy a request as raw HTTP or cURL for debugging and sharing
+
+## Main Concepts
+
+### [Requests](/documentation/http/requests)
+
+Requests store the method, URL, params, headers, body, auth settings, and markdown description for an API call. The editor autosaves changes, shows an outgoing request preview, and sends the selected request with <kbd>Cmd+Enter</kbd> on macOS or <kbd>Ctrl+Enter</kbd> on Windows or Linux.
+
+### [Environments](/documentation/http/environments)
+
+Environments store reusable variables for local, staging, and production APIs. The URL field keeps variables visible while you edit, while preview and request execution resolve values from the active environment.
+
+## Folders
+
+HTTP requests are organized in folders. Selecting a folder shows its requests and selects the first request in that folder. Folders support nesting, drag and drop ordering, inline rename, and custom folder icons.
+
+## Storage
+
+HTTP data is stored in your vault under the `http` folder. Requests are markdown files with YAML frontmatter, so they can be backed up and synced together with the rest of your massCode data.
+
+<script setup>
+import { withBase } from 'vitepress'
+</script>

docs/website/documentation/http/requests.md

@@ -0,0 +1,68 @@
+---
+title: HTTP Requests
+description: "Create, edit, preview, send, duplicate, and inspect HTTP requests in the massCode HTTP space."
+---
+
+# Requests
+
+Requests are the main items in the HTTP space. Each request stores the method, URL, params, headers, body, auth settings, and a markdown description.
+
+## Creating Requests
+
+Create a request from the request list header or from a folder context menu. New requests are created in the selected folder.
+
+Request context menus include actions for:
+
+- duplicate
+- delete
+- copy request preview
+- copy internal link
+- reveal in file manager
+
+## Request Editor
+
+The request editor is split into focused tabs:
+
+- **Params** - query parameters sent with the URL
+- **Headers** - request headers
+- **Body** - JSON, text, form URL encoded, or multipart form data
+- **Auth** - none, bearer token, or basic auth
+- **Description** - markdown notes for the request
+
+Changes are saved automatically while you edit.
+
+## Body
+
+Use the body tab to choose the payload format for methods that send data.
+
+- **JSON** and **Text** use a CodeMirror editor.
+- **Form URL Encoded** uses key-value rows.
+- **Multipart Form Data** supports text and file rows.
+
+## Sending Requests
+
+Send the selected request with one of these methods:
+
+- Click the send button next to the URL field.
+- Select **"Editor"** > **"Send Request"** from the menu bar.
+- Press <kbd>Cmd+Enter</kbd> on macOS or <kbd>Ctrl+Enter</kbd> on Windows or Linux.
+
+## Preview
+
+The lower panel can show the outgoing request before it is sent.
+
+- **HTTP** preview shows the request line, host, headers, and body.
+- **cURL** preview builds a command you can paste into a terminal.
+
+Use the copy button in the preview panel to copy the active preview.
+
+## Response Viewer
+
+After a request is sent, the response panel shows:
+
+- status, duration, and response size
+- body and headers tabs
+- JSON formatting for JSON responses
+- copy action for response body and headers
+
+HTTP has its own editor preferences, including line wrapping for request previews, request bodies, and response viewers.

docs/website/documentation/index.md

@@ -1,11 +1,11 @@
 ---
 title: Documentation Overview
-description: "Explore the massCode documentation for code snippets, markdown notes, math notebook, storage, sync, themes, JSON Diff, and built-in developer tools."
+description: "Explore the massCode documentation for code snippets, markdown notes, HTTP requests, math notebook, storage, sync, themes, JSON Diff, and built-in developer tools."
 ---
 
 # Overview
 
-massCode is a free and open source developer workspace for code snippets, markdown notes, calculations, and quick developer utilities. Instead of scattering everyday work across an editor, a notes app, a calculator, and a handful of websites, you keep it in four focused Spaces inside one local-first desktop app.
+massCode is a free and open source developer workspace for code snippets, markdown notes, HTTP requests, calculations, and quick developer utilities. Instead of scattering everyday work across an editor, a notes app, an HTTP client, a calculator, and a handful of websites, you keep it in focused Spaces inside one local-first desktop app.
 
 Switch between Spaces using the rail on the left side of the app.
 
@@ -19,6 +19,10 @@ Use Code to build a reusable snippet library across projects and languages. The
 
 Use Notes for longer markdown documents that do not fit well into snippets: project notes, drafts, technical docs, meeting notes, and personal knowledge bases. It uses the same three-column layout as Code and adds a Notes Dashboard, live preview, a notes graph, mindmaps, and fullscreen presentation mode.
 
+## HTTP
+
+Use HTTP as a lightweight API client inside massCode. Store requests in folders, switch environments, preview the outgoing request as raw HTTP or cURL, send it from the editor, and inspect the response body and headers without leaving your workspace.
+
 ## Math
 
 Math is a calculator-style notebook for quick development math without leaving massCode. Use it for currency conversion, unit conversion, date math, finance, and natural-language calculations with instant results on every line.