@qoretechnologies/reqraft 0.10.62 → 0.10.63-pr.142.g0b675cd

package/src/components/smartEditor/__fixtures__/mockLspServer.ts

@@ -1,205 +0,0 @@
-// Shared mock-socket LSP harness for stories — owns the JSON-RPC plumbing
-// (heartbeat, initialize, document tracking, request dispatch); story files
-// register only their language-specific handlers.
-import { Client, Server } from 'mock-socket';
-import { storySocketUrl } from '../../../stories/storyNetwork';
-
-/** Where `ReqraftLspClient` dials by default, on the instance stories use. */
-export const MOCK_LSP_URL = storySocketUrl('lsp');
-
-// LSP-standard 16-type / 6-modifier legend, as the real Qorus server
-// advertises in `initialize` (qorus/Classes/QorusLspWebSocketHandler.qc:847).
-export const SEMANTIC_TOKENS_LEGEND = {
-  tokenTypes: [
-    'namespace',
-    'type',
-    'class',
-    'parameter',
-    'variable',
-    'property',
-    'function',
-    'method',
-    'keyword',
-    'modifier',
-    'comment',
-    'string',
-    'number',
-    'regexp',
-    'operator',
-    'decorator',
-  ],
-  tokenModifiers: [
-    'declaration',
-    'definition',
-    'readonly',
-    'static',
-    'defaultLibrary',
-    'documentation',
-  ],
-};
-
-export const DEFAULT_LSP_CAPABILITIES = {
-  semanticTokensProvider: {
-    legend: SEMANTIC_TOKENS_LEGEND,
-    full: true,
-    range: true,
-  },
-};
-
-export interface IMockLspParams {
-  textDocument?: { uri?: string; text?: string; metadata?: Record<string, string> };
-  contentChanges?: Array<{ text?: string }>;
-  position?: { line: number; character: number };
-  text?: string;
-  [key: string]: unknown;
-}
-
-export interface IMockLspMessage {
-  jsonrpc?: string;
-  id?: number;
-  method?: string;
-  params?: IMockLspParams;
-}
-
-// Returns the JSON-RPC `result` for requests; the return value is ignored
-// for notifications (no `id`).
-export type TMockLspHandler = (msg: IMockLspMessage, lsp: IMockLspServer) => unknown;
-
-export interface IMockLspServerOptions {
-  capabilities?: Record<string, unknown>;
-  handlers?: Record<string, TMockLspHandler>;
-  // Result for requests with no registered handler.
-  defaultResult?: unknown;
-  // Per-method response delay in ms; also mutable per story via `lsp.delays`.
-  delays?: Record<string, number>;
-}
-
-export interface IMockLspServer {
-  received: IMockLspMessage[];
-  connectionCount: number;
-  getOpenConnectionCount: () => number;
-  // Most-recent document text from didOpen / didChange, whichever document.
-  documentText: string;
-  /**
-   * The text of every open document, by URI. Clients share ONE socket per
-   * endpoint and open a document each — an editor and several read-only
-   * renderings at once — so a per-document answer (semantic tokens) must read
-   * its own document, not whichever one changed last.
-   */
-  textOf: (uri?: string) => string;
-  delays: Record<string, number>;
-  notify: (method: string, params: unknown) => void;
-  close: () => void;
-}
-
-/* One mock per URL at a time. `.storybook/preview.tsx` starts a default DPQL
-   language server for every story, and a story that needs its own handlers
-   creates a server on the same URL; mock-socket refuses a second server there,
-   so creating one replaces whichever is listening. */
-const activeServers = new Map<string, IMockLspServer>();
-
-export const createMockLspServer = (
-  url: string,
-  options: IMockLspServerOptions = {}
-): IMockLspServer => {
-  // No connection reset here: `.storybook/preview.tsx` resets the shared LSP
-  // connections (and the expression render client) before every story, which
-  // covers stories that never create a mock server as well as those that do.
-  activeServers.get(url)?.close();
-  const server = new Server(url);
-  const sockets: Client[] = [];
-  const documents = new Map<string, string>();
-  let closed = false;
-  const lsp: IMockLspServer = {
-    received: [],
-    connectionCount: 0,
-    getOpenConnectionCount: () => sockets.filter((socket) => socket.readyState === 1).length,
-    documentText: '',
-    textOf: (uri) => (uri !== undefined && documents.has(uri) ? documents.get(uri)! : lsp.documentText),
-    delays: { ...options.delays },
-    notify: (method, params) =>
-      sockets.forEach((socket) =>
-        socket.send(JSON.stringify({ jsonrpc: '2.0', method, params }))
-      ),
-    close: () => {
-      /* Once only. mock-socket finds clients by URL, not by server, so closing a
-         server that was already replaced would close its REPLACEMENT's clients
-         — and the default server is closed twice when a story replaces it: once
-         on replacement, once in the preview's teardown. */
-      if (closed) {
-        return;
-      }
-      closed = true;
-      if (activeServers.get(url) === lsp) {
-        activeServers.delete(url);
-      }
-      server.close();
-      // `close()` drops the clients but leaves mock-socket's WebSocket installed
-      // on the page; only `stop()` puts the real one back. Without it a story
-      // that reaches a real server (`parameters.live`) dials the mock instead.
-      server.stop();
-    },
-  };
-  activeServers.set(url, lsp);
-
-  server.on('connection', (socket) => {
-    lsp.connectionCount++;
-    sockets.push(socket);
-    socket.on('message', (raw) => {
-      // ReqraftWebSocket heartbeats are plain strings, not JSON-RPC.
-      if (raw === 'ping') {
-        socket.send('pong');
-        return;
-      }
-      let msg: IMockLspMessage;
-      try {
-        msg = JSON.parse(raw as string);
-      } catch {
-        return;
-      }
-      lsp.received.push(msg);
-
-      const uri = msg.params?.textDocument?.uri;
-      if (msg.method === 'textDocument/didOpen') {
-        lsp.documentText = msg.params?.textDocument?.text ?? '';
-        if (uri !== undefined) {
-          documents.set(uri, lsp.documentText);
-        }
-      } else if (msg.method === 'textDocument/didChange') {
-        // The client sends a single full-document content change.
-        const change = msg.params?.contentChanges?.[0];
-        if (change && typeof change.text === 'string') {
-          lsp.documentText = change.text;
-          if (uri !== undefined) {
-            documents.set(uri, change.text);
-          }
-        }
-      } else if (msg.method === 'textDocument/didClose' && uri !== undefined) {
-        documents.delete(uri);
-      }
-
-      const handler = options.handlers?.[msg.method];
-
-      // Notifications (no `id`) get no response.
-      if (msg.id === undefined) {
-        handler?.(msg, lsp);
-        return;
-      }
-
-      const result = handler
-        ? handler(msg, lsp)
-        : msg.method === 'initialize'
-          ? { capabilities: options.capabilities ?? DEFAULT_LSP_CAPABILITIES }
-          : (options.defaultResult ?? null);
-      const response = JSON.stringify({ jsonrpc: '2.0', id: msg.id, result });
-      const delay = lsp.delays[msg.method] ?? 0;
-      if (delay > 0) {
-        setTimeout(() => socket.send(response), delay);
-      } else {
-        socket.send(response);
-      }
-    });
-  });
-
-  return lsp;
-};

package/src/components/smartEditor/helpers.ts

@@ -1,217 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Generic helpers for the SmartEditor primitive — language-agnostic
-// plain-text ↔ Slate conversion defaults, cursor-position math, and
-// completion-icon mapping. Language-specific behaviour (DPQL's
-// `@field` / `$template` tags, Qonsole's command tokens, …) lives in
-// the wrapper layer's own helpers and overrides these defaults via the
-// `converter` prop on `SmartEditor`.
-
-import { IReqoreIconName } from '@qoretechnologies/reqore/dist/types/icons';
-import { ISlateConverter, ISlateElement, ISlateText, TSlateNode } from './types';
-
-/**
- * Default plain-text → Slate conversion. Splits on `\n`; each line becomes
- * a paragraph with a single text child. No tag-element recognition — that's
- * the wrapper's job (e.g. `dpqlEditor/dpqlHelpers.ts`).
- */
-export function defaultToSlateNodes(text: string): ISlateElement[] {
-  if (!text) {
-    return [{ type: 'paragraph', children: [{ text: '' }] }];
-  }
-  return text.split('\n').map((line) => ({
-    type: 'paragraph' as const,
-    children: [{ text: line }],
-  }));
-}
-
-/**
- * Default Slate → plain-text conversion. Mirrors `defaultToSlateNodes`.
- * Walks paragraph children and concatenates text. Tag-element values are
- * emitted as their raw `value` string (a wrapper that uses tags will
- * usually override this to control quoting/etc.).
- */
-export function defaultFromSlateNodes(nodes: ISlateElement[]): string {
-  return nodes.map(processElement).join('\n');
-}
-
-function processElement(element: TSlateNode): string {
-  if ('text' in element) {
-    return element.text;
-  }
-  if (element.type === 'tag') {
-    return element.value?.toString() ?? '';
-  }
-  if (element.children) {
-    return element.children.map(processElement).join('');
-  }
-  return '';
-}
-
-/**
- * Default Slate-selection → plain-text-offset conversion. Walks the
- * Slate document in order, counting characters from text nodes and tag
- * values until reaching the target node. Generic enough for any wrapper
- * that uses `{type: 'paragraph', children: [text|tag, …]}` structure;
- * DPQL overrides this to handle its `metadata.quoted` tag option.
- */
-export function defaultSelectionToOffset(
-  nodes: ISlateElement[],
-  anchorPath: number[],
-  anchorOffset: number
-): number {
-  let totalOffset = 0;
-  const targetParagraphIdx = anchorPath[0];
-  const targetChildIdx = anchorPath[1];
-
-  for (let pIdx = 0; pIdx < nodes.length; pIdx++) {
-    if (pIdx > 0) {
-      totalOffset += 1; // newline between paragraphs
-    }
-    if (pIdx > targetParagraphIdx) break;
-
-    const paragraph = nodes[pIdx];
-    const children = paragraph.children || [];
-
-    for (let cIdx = 0; cIdx < children.length; cIdx++) {
-      const child = children[cIdx];
-      const isTag = 'type' in child && child.type === 'tag';
-      const isText = 'text' in child && !isTag;
-
-      if (pIdx === targetParagraphIdx && cIdx === targetChildIdx) {
-        if (isText) {
-          totalOffset += anchorOffset;
-        } else if (isTag) {
-          totalOffset += anchorOffset;
-        }
-        return totalOffset;
-      }
-
-      if (isText) {
-        totalOffset += (child as ISlateText).text.length;
-      } else if (isTag) {
-        const tagValue = (child as ISlateElement).value?.toString() ?? '';
-        totalOffset += tagValue.length;
-      }
-    }
-  }
-
-  return totalOffset;
-}
-
-/** The default `ISlateConverter` exposed for consumers that pass no override. */
-export const defaultSlateConverter: ISlateConverter = {
-  toSlateNodes: defaultToSlateNodes,
-  fromSlateNodes: defaultFromSlateNodes,
-  selectionToOffset: defaultSelectionToOffset,
-};
-
-/**
- * Convert a plain-text offset (0-based character count) to an LSP
- * Position (0-based line + UTF-16 character). Used by `useLspSession`
- * to translate Slate cursor positions to LSP coordinates for
- * `textDocument/completion` etc.
- */
-export function offsetToLspPosition(
-  plainText: string,
-  offset: number
-): { line: number; character: number } {
-  let line = 0;
-  let character = 0;
-  for (let i = 0; i < offset && i < plainText.length; i++) {
-    if (plainText[i] === '\n') {
-      line++;
-      character = 0;
-    } else {
-      character++;
-    }
-  }
-  return { line, character };
-}
-
-/**
- * Inverse of `offsetToLspPosition` — convert an LSP `{line, character}`
- * back into a plain-text character offset. Used when applying a
- * `textEdit.range` from a completion item: the server speaks LSP
- * positions, the editor inserter speaks plain-text offsets.
- */
-export function lspPositionToOffset(
-  plainText: string,
-  position: { line: number; character: number }
-): number {
-  let line = 0;
-  for (let i = 0; i < plainText.length; i++) {
-    if (line === position.line) {
-      return i + position.character;
-    }
-    if (plainText[i] === '\n') {
-      line++;
-    }
-  }
-  // Position is past end of document — clamp to end + character (best-effort).
-  return plainText.length;
-}
-
-/** Map an LSP CompletionItemKind enum value to a Reqore icon name. */
-export function mapCompletionKindToIcon(kind?: number): IReqoreIconName {
-  switch (kind) {
-    case 2:
-      return 'CodeLine'; // Method
-    case 3:
-      return 'FunctionLine'; // Function
-    case 5:
-      return 'Database2Line'; // Field
-    case 6:
-      return 'ExchangeDollarLine'; // Variable
-    case 14:
-      return 'Key2Line'; // Keyword
-    case 15:
-      return 'CodeBoxLine'; // Snippet
-    default:
-      return 'CodeLine';
-  }
-}
-
-/**
- * Expand an LSP **snippet** (`insertTextFormat === 2`, TextMate syntax)
- * to plain insertable text. We don't implement interactive tab-stops —
- * we strip the placeholder markup down to the placeholder's *text* (the
- * standard fallback for editors without snippet-navigation support), so
- * `slice(${1:List Value}, ${2:Index or Range})$0` becomes
- * `slice(List Value, Index or Range)` instead of leaking the raw
- * `${n:…}$0` syntax into the document.
- *
- * Handled forms:
- *  - `${1:default}` → `default` (placeholder with text)
- *  - `${1}` / `${0}` → `` (placeholder without text)
- *  - `$1` / `$0` → `` (bare tab-stop)
- *  - `\$`, `\}`, `\\` → `$`, `}`, `\` (TextMate escapes)
- */
-export function expandSnippet(text: string): string {
-  let out = '';
-  for (let i = 0; i < text.length; i++) {
-    const c = text[i];
-    // TextMate escape: `\$`, `\}`, `\\` → the literal char.
-    if (c === '\\' && i + 1 < text.length && /[$}\\]/.test(text[i + 1])) {
-      out += text[i + 1];
-      i += 1;
-      continue;
-    }
-    if (c === '$') {
-      // `${n:default}` or `${n}` → the default text (or empty).
-      const braced = text.slice(i).match(/^\$\{(\d+)(?::([^}]*))?\}/);
-      if (braced) {
-        out += braced[2] ?? '';
-        i += braced[0].length - 1;
-        continue;
-      }
-      // `$n` (bare tab-stop, incl. `$0`) → empty.
-      const bare = text.slice(i).match(/^\$(\d+)/);
-      if (bare) {
-        i += bare[0].length - 1;
-        continue;
-      }
-    }
-    out += c;
-  }
-  return out;
-}

package/src/components/smartEditor/index.ts

@@ -1,35 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Public surface of the SmartEditor primitive.
-
-export { SmartEditor } from './SmartEditor';
-export type {
-  ICompletionDropdownItem,
-  ICompletionGroup,
-  IUseLspAutocompleteOptions,
-  IUseLspAutocompleteResult,
-} from './useLspAutocomplete';
-export { useLspAutocomplete } from './useLspAutocomplete';
-export type {
-  IUseLspSessionOptions,
-  IUseLspSessionResult,
-} from './useLspSession';
-export { useLspSession } from './useLspSession';
-export {
-  defaultFromSlateNodes,
-  defaultSelectionToOffset,
-  defaultSlateConverter,
-  defaultToSlateNodes,
-  lspPositionToOffset,
-  mapCompletionKindToIcon,
-  offsetToLspPosition,
-} from './helpers';
-export type {
-  ICompletionInserterContext,
-  ILspCompletionItem,
-  ISlateConverter,
-  ISlateElement,
-  ISlateText,
-  ISmartEditorProps,
-  TCompletionInserter,
-  TSlateNode,
-} from './types';

package/src/components/smartEditor/styling.ts

@@ -1,45 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Visual constants for the SmartEditor stack. Mirrors the styling
-// vocabulary used throughout qorus-ide (`src/components/Field/multiPair.tsx`
-// for effect constants, `src/constants/util.ts` for DRAWER_STYLE) so
-// the editor blends in with the rest of the IDE without depending on
-// qorus-ide-specific exports.
-//
-// Reqraft is meant to be standalone-usable — cloning these constants
-// rather than re-exporting from qorus-ide keeps the dependency graph
-// clean. Source attribution is in comments next to each constant.
-
-import type { IReqoreEffect } from '@qoretechnologies/reqore/dist/components/Effect';
-import type { TReqoreIntent } from '@qoretechnologies/reqore/dist/constants/theme';
-
-/**
- * Frosted-glass backdrop for the completion / hover / signature
- * popovers. Matches qorus-ide's `DRAWER_CONTENT_EFFECT` so editor
- * popovers feel like the same surface family as Reqore drawers.
- * Cloned from `qorus-ide/src/constants/util.ts:DRAWER_CONTENT_EFFECT`.
- */
-export const SMART_EDITOR_OVERLAY_EFFECT = {
-  backgroundBlur: 20,
-} as const satisfies IReqoreEffect;
-
-/**
- * LSP `CompletionItemKind` → Reqore intent for the per-row kind chip.
- * Lets the chip carry visual weight beyond just `minimal: true` while
- * still being subdued enough not to compete with the row label.
- *
- * Indices align with the LSP `CompletionItemKind` enum (1 = Text,
- * 2 = Method, …). Unknown kinds get no intent (default chip).
- */
-export const COMPLETION_KIND_INTENTS: Record<number, TReqoreIntent> = {
-  2: 'success', // Method
-  3: 'success', // Function
-  5: 'info', // Field
-  6: 'info', // Variable
-  7: 'success', // Class
-  8: 'success', // Interface
-  10: 'info', // Property
-  12: 'warning', // Value
-  14: 'info', // Keyword
-  15: 'pending', // Snippet — Qonsole uses this kind for wizard items
-  21: 'warning', // Constant
-};