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

package/src/components/qonsoleSmartInput/QonsoleSmartInput.tsx

@@ -1,105 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// QonsoleSmartInput — Qorus Qonsole-flavored wrapper around the generic
-// SmartEditor primitive. Provides predictive text + diagnostics for
-// Qonsole command and natural-language input by pointing `ReqraftLspClient` at
-// the server's `/lsp` endpoint with `languageId: 'qonsole'` and the
-// server-advertised trigger characters from the live spike.
-
-import { forwardRef, useCallback, useImperativeHandle, useMemo } from 'react';
-import { RenderLeafProps } from 'slate-react/dist/components/editable';
-import { SmartEditor } from '../smartEditor/SmartEditor';
-import { makeQonsoleCompletionInserter } from './qonsoleInserter';
-import {
-  IQonsoleSmartInputProps,
-  IQonsoleSmartInputRef,
-  TQonsoleAssistFeature,
-} from './types';
-import { useQonsoleSession } from './useQonsoleSession';
-
-export type { IQonsoleSmartInputProps, IQonsoleSmartInputRef };
-
-/**
- * Trigger characters that open the autocomplete dropdown. Sourced from
- * the server's `initialize` response under
- * `capabilities.experimental.qonsole.completionTriggerCharacters` — see
- * `QONSOLE_LSP_REFERENCE.md` and the spike transcript section 1 in
- * `QONSOLE_LSP_RESPONSES.txt`.
- */
-const QONSOLE_TRIGGERS = new Set(['/', ' ', '-', '=', '.']);
-
-/**
- * Minimal leaf renderer — returns a plain `<span>` with Slate's
- * attributes. Sidesteps the React-warning chain in Reqore's default
- * `Leaf` → `ReqoreSpan` → `ReqoreTooltipComponent` (which currently
- * types `Component: React.FC<any>` and triggers the
- * "function components cannot be given refs" warning even though
- * styled-components do auto-forward at runtime). Tracked as a Reqore
- * follow-up; suppressing here keeps the QonsoleSmartInput console clean.
- */
-const qonsoleRenderLeaf = (props: RenderLeafProps) => (
-  <span {...props.attributes}>{props.children}</span>
-);
-
-export const QonsoleSmartInput = forwardRef<
-  IQonsoleSmartInputRef,
-  IQonsoleSmartInputProps
->(
-  (
-    {
-      value,
-      onChange,
-      useContext,
-      readOnly = false,
-      height = '40px',
-      onBlur,
-      onWizardStart,
-    },
-    ref
-  ) => {
-    const qonsole = useQonsoleSession({
-      useContext,
-      initialText: value,
-    });
-
-    // Branch wizard items into the consumer's `onWizardStart`
-    // callback. Memoised on the callback identity so the inserter
-    // reference is stable across renders when the callback is.
-    const completionInserter = useMemo(
-      () => makeQonsoleCompletionInserter(onWizardStart),
-      [onWizardStart]
-    );
-
-    const assist = useCallback(
-      (
-        position: { line: number; character: number },
-        features?: TQonsoleAssistFeature[]
-      ) => qonsole.assist(position, features),
-      [qonsole]
-    );
-
-    useImperativeHandle(
-      ref,
-      (): IQonsoleSmartInputRef => ({
-        validate: qonsole.validate,
-        assist,
-      }),
-      [qonsole, assist]
-    );
-
-    return (
-      <SmartEditor
-        session={qonsole.session}
-        value={value}
-        onChange={onChange}
-        triggerCharacters={QONSOLE_TRIGGERS}
-        customRenderLeaf={qonsoleRenderLeaf}
-        completionInserter={completionInserter}
-        height={height}
-        readOnly={readOnly}
-        onBlur={onBlur}
-      />
-    );
-  }
-);
-
-QonsoleSmartInput.displayName = 'QonsoleSmartInput';

package/src/components/qonsoleSmartInput/index.ts

@@ -1,16 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Public surface of the QonsoleSmartInput component.
-
-export { QonsoleSmartInput } from './QonsoleSmartInput';
-export type {
-  IQonsoleAssistContext,
-  IQonsoleAssistResult,
-  IQonsoleSmartInputProps,
-  IQonsoleSmartInputRef,
-  TQonsoleAssistFeature,
-} from './types';
-export { useQonsoleSession } from './useQonsoleSession';
-export type {
-  IUseQonsoleSessionOptions,
-  IUseQonsoleSessionResult,
-} from './useQonsoleSession';

package/src/components/qonsoleSmartInput/qonsoleInserter.ts

@@ -1,77 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Qonsole-specific completion inserter. Branches on the LSP item's
-// `command` field — when the server attaches
-// `{ command: "qonsole.startWizard", arguments: [{...}] }` (only on
-// `kind: 'wizard'` items), accept the item by firing the wrapper's
-// `onWizardStart` callback INSTEAD of inserting text. Everything
-// else falls through to the generic text inserter.
-//
-// The server explicitly rejects `workspace/executeCommand` for the
-// `qonsole.*` namespace (see qorus/Classes/QorusLspWebSocketHandler.qc:2197)
-// — wizard launch is REST-driven, not LSP-driven. So the client
-// owns the launch flow: pull `arguments[0].start_path` and POST to it
-// via the consumer's apiHost. That's a qorus-ide-side concern.
-
-import { Editor, Transforms } from 'slate';
-import { lspPositionToOffset } from '../smartEditor/helpers';
-import { TCompletionInserter } from '../smartEditor/types';
-
-/**
- * Factory — pass the wrapper's `onWizardStart` callback (or
- * `undefined` to fall back to text insertion for wizard items).
- */
-export function makeQonsoleCompletionInserter(
-  onWizardStart?: (args: Record<string, unknown>) => void
-): TCompletionInserter {
-  return (item, editor, ctx) => {
-    // Branch on the command field. When the server has attached a
-    // wizard-launch command AND the consumer has wired the callback,
-    // fire it and skip the text insertion entirely.
-    const cmd = item.command;
-    if (
-      cmd?.command === 'qonsole.startWizard' &&
-      onWizardStart &&
-      Array.isArray(cmd.arguments) &&
-      cmd.arguments.length > 0
-    ) {
-      const args = cmd.arguments[0];
-      if (args && typeof args === 'object') {
-        onWizardStart(args as Record<string, unknown>);
-        return;
-      }
-    }
-
-    // Default path — same shape as `defaultCompletionInserter` in
-    // SmartEditor.tsx. Apply textEdit when present (LSP-compliant
-    // partial-token replacement); otherwise insert at cursor.
-    const newText = item.textEdit?.newText ?? item.insertText ?? item.label;
-
-    // Replace mode (chip click) — atomic node swap. Same as
-    // defaultCompletionInserter.
-    if (ctx.replacementPath) {
-      const path = ctx.replacementPath;
-      Editor.withoutNormalizing(editor, () => {
-        Transforms.removeNodes(editor, { at: path });
-        Transforms.insertNodes(editor, [{ text: newText }] as any, {
-          at: path,
-          select: true,
-        });
-      });
-      return;
-    }
-
-    // Typing path — delete partial token using textEdit.range, then
-    // insert the server's replacement.
-    if (item.textEdit) {
-      const startOffset = lspPositionToOffset(
-        ctx.plainText,
-        item.textEdit.range.start
-      );
-      const charsToDelete = Math.max(0, ctx.cursorOffset - startOffset);
-      for (let i = 0; i < charsToDelete; i++) {
-        Editor.deleteBackward(editor, { unit: 'character' });
-      }
-    }
-    Transforms.insertText(editor, newText);
-  };
-}

package/src/components/qonsoleSmartInput/types.ts

@@ -1,133 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Type definitions for QonsoleSmartInput — a Reqraft component that
-// drives the Qorus Qonsole `/lsp` LSP from a SmartEditor.
-
-/**
- * `/use` context override for a Qonsole document. The server reads this
- * via `textDocument.metadata.context` on didOpen and via the
- * `qonsole/setContext` custom method. Matches the shape documented in
- * `qorus/design/qonsole-lsp.md` and confirmed by the live spike.
- */
-export interface IQonsoleAssistContext {
-  /** Resource kind — `'services'`, `'workflows'`, `'connections'`, … */
-  resource: string;
-  /** Resource public name (preferred) */
-  name?: string;
-  /** Resource identifier (alternative to `name`) */
-  identifier?: string;
-}
-
-/** Feature subset to request from `qonsole/assist`. */
-export type TQonsoleAssistFeature =
-  | 'completion'
-  | 'diagnostics'
-  | 'hover'
-  | 'signature'
-  | 'tokens'
-  | 'format'
-  | 'suggestions'
-  | 'wizards'
-  | 'all';
-
-/**
- * Raw `qonsole/assist` payload. Shape captured from the live spike on
- * 2026-05-25 and documented in `QONSOLE_LSP_REFERENCE.md`. Kept as a
- * loose record because the server has freedom to add fields; consumers
- * should validate specific feature blocks they consume.
- */
-export interface IQonsoleAssistResult {
-  version: string;
-  // Server literal — `"command"` (input starts with `/`), `"nl"`
-  // (free-form natural language), or `"empty"`. The earlier
-  // `"natural-language"` was a documentation error; the server
-  // returns the literal `"nl"` (see QonsoleAssistService.qc:282).
-  mode: 'command' | 'nl' | 'empty';
-  context?: Record<string, unknown>;
-  canonical?: {
-    command_name?: string;
-    verb?: string;
-    description?: string;
-    resource?: string;
-  };
-  completion?: {
-    state: string;
-    prefix: string;
-    replace_start: number;
-    replace_end: number;
-    items: Array<Record<string, any>>;
-  };
-  starter_suggestions?: Record<string, any>;
-  diagnostics?: Array<Record<string, any>>;
-  hover?: Record<string, any>;
-  signature?: Record<string, any>;
-  tokens?: Array<{ start: number; end: number; type: string; modifiers: string[] }>;
-  format?: Record<string, any>;
-  related_wizards?: Array<Record<string, any>>;
-  metrics?: {
-    duration_ms: number;
-    completion_items: number;
-    diagnostic_count: number;
-    suggestion_count: number;
-    wizard_count: number;
-  };
-}
-
-export interface IQonsoleSmartInputProps {
-  /** Current value as plain text. Single-line by convention but multi-line works. */
-  value: string;
-  /** Called with the new plain-text value whenever the document changes. */
-  onChange: (value: string) => void;
-  /**
-   * Optional `/use` context override. Sent as `textDocument.metadata.context`
-   * on the initial `didOpen` and re-dispatched via `qonsole/setContext`
-   * whenever it changes.
-   */
-  useContext?: IQonsoleAssistContext;
-  /** Read-only mode. */
-  readOnly?: boolean;
-  /** CSS height of the editable area. Default `'40px'` — single-line look. */
-  height?: string;
-  /** Called when the editor loses focus. */
-  onBlur?: () => void;
-  /**
-   * Called when the user accepts a wizard-launch completion item —
-   * i.e. an item whose `command.command === "qonsole.startWizard"`.
-   * The argument is the server-supplied wizard descriptor:
-   *
-   *   `{ action: 'start-wizard', name, title, short_desc, verb,
-   *      resource, start_path, source_command }`
-   *
-   * The consumer is responsible for launching the wizard flow —
-   * typically POSTing to `start_path` and rendering a step-by-step
-   * modal. Reqraft provides no wizard runner UI; that lives in the
-   * qorus-ide consumer.
-   *
-   * When this prop is set, wizard items are NOT inserted as text on
-   * accept; this callback fires instead. When it's `undefined`, the
-   * item's `label` falls through to plain-text insertion (degraded
-   * but harmless).
-   *
-   * See `qorus/Classes/QonsoleAssistService.qc:818` for the
-   * wizard descriptor's exact shape.
-   */
-  onWizardStart?: (args: Record<string, unknown>) => void;
-}
-
-export interface IQonsoleSmartInputRef {
-  /**
-   * Synchronous validation via `qonsole/validate`. Returns
-   * `{valid: true}` when the server reports no diagnostics, otherwise
-   * `{valid: false, errors: [{message}]}`.
-   */
-  validate: () => Promise<{ valid: boolean; errors?: Array<{ message: string }> }>;
-  /**
-   * Fetch a rich assist snapshot at the current cursor position.
-   * Returns the full server payload (completion + signature + hover +
-   * tokens + diagnostics + …) for callers that want one round-trip per
-   * keystroke instead of N requests.
-   */
-  assist: (
-    position: { line: number; character: number },
-    features?: TQonsoleAssistFeature[]
-  ) => Promise<IQonsoleAssistResult | null>;
-}

package/src/components/qonsoleSmartInput/useQonsoleSession.ts

@@ -1,124 +0,0 @@
-// Copyright 2026 Qore Technologies, s.r.o.
-// Qonsole-specific layer on top of the generic `useLspSession`. Handles
-// the `qonsole/setContext` lifecycle (sends initial context as didOpen
-// metadata, re-dispatches when context changes) and exposes typed
-// wrappers for the server's `qonsole/assist` and `qonsole/validate`
-// custom methods. Shape based on the live spike captured in
-// `qorus-frontend/QONSOLE_LSP_REFERENCE.md`.
-
-import { useCallback, useEffect } from 'react';
-import { ILspDiagnostic } from '../../utils/lspClient.types';
-import { IUseLspSessionResult, useLspSession } from '../smartEditor/useLspSession';
-import {
-  IQonsoleAssistContext,
-  IQonsoleAssistResult,
-  TQonsoleAssistFeature,
-} from './types';
-
-export interface IUseQonsoleSessionOptions {
-  /** Optional initial `/use` context. */
-  useContext?: IQonsoleAssistContext;
-  /** Initial document text sent on `didOpen`. */
-  initialText?: string;
-}
-
-export interface IUseQonsoleSessionResult {
-  /** The generic LSP session — pass through to SmartEditor. */
-  session: IUseLspSessionResult;
-  /** Most recent `publishDiagnostics`. */
-  diagnostics: ILspDiagnostic[];
-  /**
-   * `qonsole/assist` (uri form). Returns the full snapshot for the
-   * current document at the given position. Pass `features: ['all']`
-   * for everything; the default is also `['all']`.
-   */
-  assist: (
-    position: { line: number; character: number },
-    features?: TQonsoleAssistFeature[]
-  ) => Promise<IQonsoleAssistResult | null>;
-  /**
-   * `qonsole/validate` — synchronous diagnostics summary.
-   */
-  validate: () => Promise<{ valid: boolean; errors?: Array<{ message: string }> }>;
-}
-
-export function useQonsoleSession(
-  opts: IUseQonsoleSessionOptions
-): IUseQonsoleSessionResult {
-  const { useContext: ctx, initialText = '' } = opts;
-
-  const session = useLspSession({
-    languageId: 'qonsole',
-    initialText,
-    // The server reads context from `textDocument.metadata.context` on
-    // didOpen (per qorus-frontend/QONSOLE_LSP_REFERENCE.md).
-    initialMetadata: ctx ? { context: ctx } : undefined,
-  });
-
-  // React to `useContext` changes — re-dispatch `qonsole/setContext`.
-  useEffect(() => {
-    if (!session.client || !session.isReady || !ctx) return;
-    session.client
-      .customRequest('qonsole/setContext', {
-        uri: session.uri,
-        context: ctx,
-      })
-      .catch((err) => {
-        // eslint-disable-next-line no-console
-        console.error('[Qonsole] setContext failed:', err);
-      });
-  }, [session.client, session.isReady, session.uri, ctx]);
-
-  const assist = useCallback(
-    async (
-      position: { line: number; character: number },
-      features: TQonsoleAssistFeature[] = ['all']
-    ): Promise<IQonsoleAssistResult | null> => {
-      if (!session.client) return null;
-      try {
-        return await session.client.customRequest<IQonsoleAssistResult>(
-          'qonsole/assist',
-          {
-            uri: session.uri,
-            position,
-            features,
-          }
-        );
-      } catch {
-        return null;
-      }
-    },
-    [session.client, session.uri]
-  );
-
-  const validate = useCallback(async (): Promise<{
-    valid: boolean;
-    errors?: Array<{ message: string }>;
-  }> => {
-    if (!session.client) {
-      return { valid: false, errors: [{ message: 'No LSP connection' }] };
-    }
-    try {
-      const result = await session.client.customRequest<{
-        diagnostics?: ILspDiagnostic[];
-      }>('qonsole/validate', { uri: session.uri });
-      const diags = result?.diagnostics ?? [];
-      if (diags.length > 0) {
-        return {
-          valid: false,
-          errors: diags.map((d) => ({ message: d.message })),
-        };
-      }
-      return { valid: true };
-    } catch {
-      return { valid: false, errors: [{ message: 'Validation request failed' }] };
-    }
-  }, [session.client, session.uri]);
-
-  return {
-    session,
-    diagnostics: session.diagnostics,
-    assist,
-    validate,
-  };
-}

package/src/components/searchFilterBar/SearchFilterBar.stories.tsx

@@ -1,62 +0,0 @@
-import { StoryObj } from '@storybook/react-vite';
-import { expect, fn, within } from 'storybook/test';
-
-import { StoryMeta } from '../../types';
-import { SearchFilterBar } from './SearchFilterBar';
-
-/*
- * The strip that sits above a list and narrows it: a search box plus the filter
- * dropdowns that go with it.
- */
-const meta = {
-  component: SearchFilterBar,
-  title: 'Components/Search Filter Bar',
-  args: {
-    onChange: fn(),
-    placeholder: 'Search tickets…',
-    filters: [
-      {
-        icon: 'Filter3Line' as const,
-        label: 'Any status',
-        items: [
-          { label: 'Any status', selected: true, onClick: fn() },
-          { label: 'Open', onClick: fn() },
-          { label: 'Resolved', onClick: fn() },
-        ],
-      },
-    ],
-  },
-} as StoryMeta<typeof SearchFilterBar>;
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-export const Idle: Story = {
-  args: { value: '' },
-  parameters: {
-    docs: {
-      description: {
-        story: 'Nothing typed — the bar is quiet, and the list below it is the whole list.',
-      },
-    },
-  },
-  play: async ({ canvasElement }) => {
-    expect(within(canvasElement).getByPlaceholderText('Search tickets…')).toBeVisible();
-  },
-};
-
-export const Filtering: Story = {
-  args: { value: 'deploy', intent: 'info' },
-  parameters: {
-    docs: {
-      description: {
-        story:
-          'A query is active, so the box carries `intent="info"`. Without it a filtered list and a genuinely short list look identical, and a reader who lands on three rows cannot tell which they are looking at.',
-      },
-    },
-  },
-  play: async ({ canvasElement }) => {
-    const input = within(canvasElement).getByPlaceholderText('Search tickets…');
-    expect(input).toHaveValue('deploy');
-  },
-};

package/src/components/searchFilterBar/SearchFilterBar.tsx

@@ -1,144 +0,0 @@
-import { ReqoreControlGroup, ReqoreDropdown, ReqoreInput } from '@qoretechnologies/reqore';
-import { TReqoreIntent } from '@qoretechnologies/reqore/dist/constants/theme';
-import { IReqoreIconName } from '@qoretechnologies/reqore/dist/types/icons';
-import styled, { css } from 'styled-components';
-
-/*
- * A search box with filter dropdowns beside it — the strip that sits above a list
- * and narrows it.
- *
- * This existed twice, built independently either side of the package boundary: the
- * ticket list in qorus-ide and the References tab here in reqraft. Same
- * composition (ReqoreControlGroup > ReqoreInput + N ReqoreDropdowns), but they had
- * drifted — one sized the group, the other sized each control; one wrapped, the
- * other stacked; one moved the dropdown caret to the right slot and suppressed the
- * default, the other did not. Two strips that should be indistinguishable ended up
- * visibly different, and any fix had to be made twice.
- *
- * It lives in reqraft rather than Reqore because it is a composition of Reqore
- * primitives, not a new primitive — there is nothing here Reqore is missing.
- *
- * The frosted container is part of the component, not the caller's job. Extracting
- * only the controls left the two surfaces still looking different: one bar sat in a
- * bordered, blurred card, the other bare on the page. If the bar is meant to read
- * the same everywhere then its own chrome has to travel with it.
- */
-
-const Container = styled.div<{ $sticky?: boolean }>`
-  padding: 8px;
-  border-radius: 8px;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  background: rgba(255, 255, 255, 0.04);
-  backdrop-filter: blur(6px);
-
-  ${({ $sticky }) =>
-    $sticky &&
-    css`
-      position: sticky;
-      top: 0;
-      z-index: 2;
-    `}
-`;
-
-export interface ISearchFilterOption {
-  label: string;
-  icon?: IReqoreIconName;
-  selected?: boolean;
-  onClick: () => void;
-}
-
-export interface ISearchFilter {
-  /** Icon for the trigger — usually the selected option's. */
-  icon?: IReqoreIconName;
-  /** Trigger label — usually the selected option's. */
-  label: string;
-  items: ISearchFilterOption[];
-}
-
-export interface ISearchFilterBarProps {
-  value: string;
-  onChange: (value: string) => void;
-  placeholder: string;
-  filters?: ISearchFilter[];
-  /**
-   * Stack the search over its filters. On a phone the box and two dropdowns
-   * cannot share a row without the input collapsing to a few characters, so the
-   * caller passes its own breakpoint result rather than this guessing.
-   */
-  stacked?: boolean;
-  /**
-   * Pin the bar to the top of its scroll container. For a bar inside a scrolling
-   * panel (the References tab); a bar above a page-level list does not need it.
-   */
-  sticky?: boolean;
-  /**
-   * Intent for the search box.
-   *
-   * A bar that is narrowing the list should look different from one that is
-   * not — otherwise a reader who arrives at a short list cannot tell whether it
-   * is short or filtered. Callers pass `'info'` while a query is active. Left
-   * to the caller rather than derived from `value`, because a caller may hold
-   * other filter state this component never sees.
-   */
-  intent?: TReqoreIntent;
-}
-
-export const SearchFilterBar = ({
-  value,
-  onChange,
-  placeholder,
-  filters = [],
-  stacked,
-  sticky,
-  intent,
-}: ISearchFilterBarProps) => (
-  <Container $sticky={sticky}>
-    {/* `size='small'` on the GROUP, not per control: the bar filters the content, it
-        is not content — at the default size the dropdowns read as primary actions and
-        crowd the search field. */}
-    <ReqoreControlGroup
-      fluid
-      wrap
-      gapSize='small'
-      size='small'
-      vertical={stacked}
-      verticalAlign={stacked ? undefined : 'center'}
-    >
-      <ReqoreInput
-        icon='Search2Line'
-        placeholder={placeholder}
-        value={value}
-        onChange={(event) => onChange((event.currentTarget as HTMLInputElement).value)}
-        onClearClick={value ? () => onChange('') : undefined}
-        intent={intent}
-        minimal
-        fluid
-      />
-      {filters.length ?
-        <ReqoreControlGroup gapSize='small' size='small' fluid={stacked}>
-          {filters.map((filter, index) => (
-            <ReqoreDropdown
-              key={index}
-              icon={filter.icon}
-              label={filter.label}
-              minimal
-              flat
-              /* stretch to share the row when stacked; hug the label otherwise */
-              fixed={!stacked}
-              /* the caret defaults to the LEFT slot, where the filter's own icon
-               already sits — without this each trigger shows two glyphs */
-              rightIcon='ArrowDownSLine'
-              showCaret={false}
-              items={filter.items.map((item) => ({
-                label: item.label,
-                icon: item.icon,
-                selected: item.selected,
-                onClick: item.onClick,
-              }))}
-            />
-          ))}
-        </ReqoreControlGroup>
-      : null}
-    </ReqoreControlGroup>
-  </Container>
-);

package/src/components/searchFilterBar/index.ts

@@ -1 +0,0 @@
-export * from './SearchFilterBar';