@dynatrace/strato-components 3.11.2 → 3.12.0

package/esm/editors/dql-editor/autocomplete/open-autocomplete.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/editors/dql-editor/autocomplete/open-autocomplete.ts"],
+  "sourcesContent": ["/* oxlint-disable tsdoc/syntax */\nimport { CompletionContext } from '@codemirror/autocomplete';\nimport { EditorState } from '@codemirror/state';\n\nimport { verifyQuery } from '../dql/dql-linter.js';\n\n// Look back a bounded amount while typing to keep per-keystroke checks predictable.\nconst SUBQUERY_PREFIX_LOOKBACK_CHARS = 100;\n\n/**\n * Checks whether the cursor is at a position where a command or parameter is expected,\n * following a comma or pipe separator, with only whitespace in between.\n * @param context - the current completion context\n * @returns true if the cursor is at the start of a command or parameter, false otherwise\n */\nfunction isStartOfCommandOrParameter(context: CompletionContext): boolean {\n  return context.matchBefore(/[,|]\\s+$/) !== null;\n}\n\n/**\n * Checks whether the user is typing a command prefix (e.g. `d`, `da`, `fet`)\n * at a valid command boundary: start of query, after a `|` or `,` separator,\n * or after a block comment close (`*\\/`). The latter covers reopening\n * suggestions after ESC and continued typing following an inline block\n * comment, e.g. `/* note *\\/ fetc`.\n * @param context - the current completion context\n * @returns true if the user is typing a command prefix at a valid command boundary, false otherwise\n */\nfunction isTypingCommandPrefixAtCommandBoundary(\n  context: CompletionContext,\n): boolean {\n  return (\n    context.matchBefore(/(?:^|[|,]\\s*|\\*\\/\\s*)[A-Za-z][A-Za-z0-9]*$/) !== null\n  );\n}\n\n/**\n * Covers nested subqueries where a command starts after `[` on a new indented line,\n * e.g. `lookup(..., [\\n    fetc ...)`.\n *\n * Uses a manual slice instead of context.matchBefore because `[` may be on a\n * previous line, which matchBefore cannot see.\n *\n * @param context - the current completion context\n * @returns true if the user is typing a command prefix at the start of a subquery, false otherwise\n */\nfunction isTypingCommandPrefixAtSubqueryStart(\n  context: CompletionContext,\n): boolean {\n  // Slice at most SUBQUERY_PREFIX_LOOKBACK_CHARS before the cursor \u2014 bounding input size\n  // prevents the regex from backtracking excessively on large documents.\n  const slice = context.state.doc.sliceString(\n    Math.max(0, context.pos - SUBQUERY_PREFIX_LOOKBACK_CHARS),\n    context.pos,\n  );\n\n  // Safe and fast regex: we only check a small slice and match a command\n  // prefix at the end of the slice.\n  return /\\[\\s*[A-Za-z]+$/.test(slice);\n}\n\n/**\n * Checks whether the user is typing a parameter prefix after a command.\n * This covers reopening suggestions after ESC when typing continues within\n * the first parameter token at query start, for example\n * `fetch app` -> `fetch appl`.\n * @param context - the current completion context\n * @returns true if the user is typing a parameter prefix after a command, false otherwise\n */\nfunction isTypingParameterPrefixAfterCommand(\n  context: CompletionContext,\n): boolean {\n  const commandAndParameter = context.matchBefore(\n    /^[A-Za-z][A-Za-z0-9]*\\s+[A-Za-z_][A-Za-z0-9_.]*\\s*$/,\n  );\n\n  return commandAndParameter !== null;\n}\n\n/**\n * Checks whether the cursor is within a digit-led token, such as an integer, a decimal number,\n * or a number followed by a unit suffix (e.g. `1`, `1mon`, `1.5`, `1.5h`).\n * @param context - the current completion context\n * @returns true if the cursor is within a digit-led token, false otherwise\n */\nfunction isTypingNumericContext(context: CompletionContext): boolean {\n  return context.matchBefore(/\\d[\\w.]*$/) !== null;\n}\n\n/**\n * Allows opening autocomplete when the cursor is at a token boundary:\n * immediately before whitespace, before a comment, or at end of content.\n * This supports selected-token replacement where content can still follow\n * after whitespace, while blocking autocomplete in the middle of identifiers.\n * @param state - the current editor state\n * @returns true if the cursor is at a token boundary, false otherwise\n */\nfunction isAtTokenBoundary(state: EditorState): boolean {\n  const afterCursor = state.doc.slice(state.selection.main.to).toString();\n  const immediateCharacterAfterCursor = afterCursor.slice(0, 1);\n  const afterCursorTrimmed = afterCursor.trimStart();\n\n  return (\n    immediateCharacterAfterCursor.trim().length === 0 ||\n    afterCursorTrimmed.startsWith('//') ||\n    afterCursorTrimmed.startsWith('/*')\n  );\n}\n\n/**\n * Checks whether the query is invalid at the end.\n *\n * @param query - The query string to check\n * @returns A promise that resolves to true if the query is invalid at the end, false otherwise\n */\nexport async function isInvalidAtEnd(query: string): Promise<boolean> {\n  const trimmedQuery = query.trimEnd();\n  const { valid = true, notifications = [] } =\n    (await verifyQuery(trimmedQuery)) ?? {};\n\n  const hasErrorNotificationAtEnd = notifications?.some(\n    (notification) =>\n      notification.severity === 'ERROR' &&\n      notification.syntaxPosition?.end.index === trimmedQuery.length - 1,\n  );\n\n  return !valid && hasErrorNotificationAtEnd;\n}\n\n/**\n * Determines if the autocomplete dropdown should be opened.\n *\n * @param update - Information on the current changes from the update listener\n * @param state - EditorState\n * @returns true when the autocomplete should be opened\n */\nexport async function openAutocomplete(\n  update: {\n    isTyping: boolean;\n    isDeleting: boolean;\n    isFocused: boolean;\n  },\n  state: EditorState,\n): Promise<boolean> {\n  const { isTyping, isDeleting, isFocused } = update;\n\n  const context = new CompletionContext(state, state.selection.main.to, false);\n\n  // While deleting, suppress reopen if the cursor still has a run of trailing\n  // whitespace (including empty lines) behind it. This avoids popup flicker\n  // while users clean up spacing. Reopen can happen again once the run shrinks\n  // to at most one trailing whitespace character.\n  if (isDeleting) {\n    const beforeCursor = state.doc.sliceString(\n      Math.max(0, state.selection.main.to - 2),\n      state.selection.main.to,\n    );\n\n    // We only slice the 2 chars directly before the cursor.\n    // If both are whitespace (`\\s\\s$`), it means there are at least two\n    // trailing whitespace chars before the cursor, so we suppress reopen.\n    if (/\\s\\s$/.test(beforeCursor)) {\n      return false;\n    }\n  }\n\n  if (\n    isTyping &&\n    (isTypingCommandPrefixAtCommandBoundary(context) ||\n      isTypingCommandPrefixAtSubqueryStart(context) ||\n      isTypingParameterPrefixAfterCommand(context) ||\n      isTypingNumericContext(context)) &&\n    isAtTokenBoundary(state)\n  ) {\n    return true;\n  }\n\n  // open autocomplete when an empty editor receives focus\n  if (isFocused && state.doc.toString().trim() === '') {\n    return true;\n  }\n\n  const hasWhitespaceBefore = context.matchBefore(/\\s/);\n\n  // open autocomplete when the user is typing following a command (==keyword)\n  if (\n    (isTyping || isDeleting) &&\n    context.tokenBefore(['keyword']) &&\n    hasWhitespaceBefore\n  ) {\n    return true;\n  }\n\n  // open autocomplete if the user is typing following a comma or pipe\n  if (isTyping && isStartOfCommandOrParameter(context)) {\n    return true;\n  }\n\n  // open autocomplete if query is invalid and a space was typed beforehand\n  if (isTyping && hasWhitespaceBefore) {\n    const query = state.doc.slice(0, state.selection.main.to).toString();\n    if (await isInvalidAtEnd(query)) {\n      return true;\n    }\n  }\n\n  const characterAfter = state.doc\n    .slice(state.selection.main.to, state.selection.main.to + 1)\n    .toString();\n  const hasSpaceOrEndOfContentAfter = characterAfter.trim().length === 0;\n\n  // open autocomplete if\n  //  - a whitespace was deleted\n  //  - the last char was deleted\n  if (isDeleting && hasSpaceOrEndOfContentAfter) {\n    return true;\n  }\n\n  return false;\n}\n"],
+  "mappings": "AACA,SAAS,yBAAyB;AAGlC,SAAS,mBAAmB;AAG5B,MAAM,iCAAiC;AAQvC,SAAS,4BAA4B,SAAqC;AACxE,SAAO,QAAQ,YAAY,UAAU,MAAM;AAC7C;AAWA,SAAS,uCACP,SACS;AACT,SACE,QAAQ,YAAY,4CAA4C,MAAM;AAE1E;AAYA,SAAS,qCACP,SACS;AAGT,QAAM,QAAQ,QAAQ,MAAM,IAAI;AAAA,IAC9B,KAAK,IAAI,GAAG,QAAQ,MAAM,8BAA8B;AAAA,IACxD,QAAQ;AAAA,EACV;AAIA,SAAO,kBAAkB,KAAK,KAAK;AACrC;AAUA,SAAS,oCACP,SACS;AACT,QAAM,sBAAsB,QAAQ;AAAA,IAClC;AAAA,EACF;AAEA,SAAO,wBAAwB;AACjC;AAQA,SAAS,uBAAuB,SAAqC;AACnE,SAAO,QAAQ,YAAY,WAAW,MAAM;AAC9C;AAUA,SAAS,kBAAkB,OAA6B;AACtD,QAAM,cAAc,MAAM,IAAI,MAAM,MAAM,UAAU,KAAK,EAAE,EAAE,SAAS;AACtE,QAAM,gCAAgC,YAAY,MAAM,GAAG,CAAC;AAC5D,QAAM,qBAAqB,YAAY,UAAU;AAEjD,SACE,8BAA8B,KAAK,EAAE,WAAW,KAChD,mBAAmB,WAAW,IAAI,KAClC,mBAAmB,WAAW,IAAI;AAEtC;AAQA,eAAsB,eAAe,OAAiC;AACpE,QAAM,eAAe,MAAM,QAAQ;AACnC,QAAM,EAAE,QAAQ,MAAM,gBAAgB,CAAC,EAAE,IACtC,MAAM,YAAY,YAAY,KAAM,CAAC;AAExC,QAAM,4BAA4B,eAAe;AAAA,IAC/C,CAAC,iBACC,aAAa,aAAa,WAC1B,aAAa,gBAAgB,IAAI,UAAU,aAAa,SAAS;AAAA,EACrE;AAEA,SAAO,CAAC,SAAS;AACnB;AASA,eAAsB,iBACpB,QAKA,OACkB;AAClB,QAAM,EAAE,UAAU,YAAY,UAAU,IAAI;AAE5C,QAAM,UAAU,IAAI,kBAAkB,OAAO,MAAM,UAAU,KAAK,IAAI,KAAK;AAM3E,MAAI,YAAY;AACd,UAAM,eAAe,MAAM,IAAI;AAAA,MAC7B,KAAK,IAAI,GAAG,MAAM,UAAU,KAAK,KAAK,CAAC;AAAA,MACvC,MAAM,UAAU,KAAK;AAAA,IACvB;AAKA,QAAI,QAAQ,KAAK,YAAY,GAAG;AAC9B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MACE,aACC,uCAAuC,OAAO,KAC7C,qCAAqC,OAAO,KAC5C,oCAAoC,OAAO,KAC3C,uBAAuB,OAAO,MAChC,kBAAkB,KAAK,GACvB;AACA,WAAO;AAAA,EACT;AAGA,MAAI,aAAa,MAAM,IAAI,SAAS,EAAE,KAAK,MAAM,IAAI;AACnD,WAAO;AAAA,EACT;AAEA,QAAM,sBAAsB,QAAQ,YAAY,IAAI;AAGpD,OACG,YAAY,eACb,QAAQ,YAAY,CAAC,SAAS,CAAC,KAC/B,qBACA;AACA,WAAO;AAAA,EACT;AAGA,MAAI,YAAY,4BAA4B,OAAO,GAAG;AACpD,WAAO;AAAA,EACT;AAGA,MAAI,YAAY,qBAAqB;AACnC,UAAM,QAAQ,MAAM,IAAI,MAAM,GAAG,MAAM,UAAU,KAAK,EAAE,EAAE,SAAS;AACnE,QAAI,MAAM,eAAe,KAAK,GAAG;AAC/B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,iBAAiB,MAAM,IAC1B,MAAM,MAAM,UAAU,KAAK,IAAI,MAAM,UAAU,KAAK,KAAK,CAAC,EAC1D,SAAS;AACZ,QAAM,8BAA8B,eAAe,KAAK,EAAE,WAAW;AAKrE,MAAI,cAAc,6BAA6B;AAC7C,WAAO;AAAA,EACT;AAEA,SAAO;AACT;",
+  "names": []
+}

package/esm/editors/dql-editor/{dql → autocomplete}/suggestion-autocompletions.js

@@ -1,5 +1,4 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { verifyQuery } from "./dql-linter.js";
 import {
   convertToMiddleEllipsis,
   fuzzyMatch,
@@ -7,11 +6,12 @@ import {
   labelShouldBeTruncated
 } from "./fuzzy-match.js";
 import { getSuggestions } from "./get-suggestions.js";
-import { SuggestionPart } from "./SuggestionPart.js";
+import { SuggestionPart } from "./suggestion-popup/SuggestionPart.js";
 import { getTokenTypeLabel } from "./token-type-label.js";
 import { combinedDurationUnits } from "../../../core/dql/dql-common.js";
 import { Flex } from "../../../layouts/flex/Flex.js";
 import { Text } from "../../../typography/text/Text.js";
+import { verifyQuery } from "../dql/dql-linter.js";
 function extractWordToken(content) {
   const rawCapture = /\W?([\w.]*)$/.exec(content)?.[1] ?? "";
   const trimmedCapture = rawCapture.replace(/^\d+(\.\d+)?/, "");
@@ -24,6 +24,11 @@ const TOKEN_TYPES = {
   ANCHOR: "FIELD_VALUE",
   SYNOPSIS_INFO: "SYNOPSIS_INFO"
 };
+const TITLE_TYPES = /* @__PURE__ */ new Set([
+  "COMMAND_NAME",
+  "FUNCTION_NAME",
+  "TIMESERIES_AGGREGATION"
+]);
 function isHiddenPart(part) {
   const type = part.type;
   return type === TOKEN_TYPES.ANCHOR || type === TOKEN_TYPES.SYNOPSIS_INFO;
@@ -92,6 +97,20 @@ async function getFilteredSuggestions(autocompleteContent, patternLength, explic
     explicit
   );
 }
+function getSuggestionTitle(suggestion) {
+  for (const part of suggestion.parts) {
+    if (!TITLE_TYPES.has(part.type)) {
+      continue;
+    }
+    const label = getTokenTypeLabel([part]);
+    if (label !== void 0) {
+      const { suggestion: text } = part;
+      return `${text.charAt(0).toUpperCase()}${text.slice(
+        1
+      )} ${label.toLowerCase()}`;
+    }
+  }
+}
 function buildSuggestionInfoPopup(suggestion) {
   const infoParts = suggestion.parts.filter(
     (part) => !!part.info && !isHiddenPart(part)
@@ -99,7 +118,15 @@ function buildSuggestionInfoPopup(suggestion) {
   if (infoParts.length === 0) {
     return void 0;
   }
-  return () => /* @__PURE__ */ jsx(Flex, { flexDirection: "column", gap: 16, children: infoParts.map((part) => /* @__PURE__ */ jsx(SuggestionPart, { suggestionPart: part }, part.info)) });
+  const title = getSuggestionTitle(suggestion);
+  if (infoParts.length === 1) {
+    return () => /* @__PURE__ */ jsx(SuggestionPart, { suggestionPart: infoParts[0], title });
+  }
+  const [firstPart, ...remainingParts] = infoParts;
+  return () => /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: 16, children: [
+    /* @__PURE__ */ jsx(SuggestionPart, { suggestionPart: firstPart, title }),
+    remainingParts.map((part) => /* @__PURE__ */ jsx(SuggestionPart, { suggestionPart: part }, part.info))
+  ] });
 }
 function buildSuggestionPopup(label, truncated, infoPopup) {
   if (label.length === 0) {
@@ -225,6 +252,7 @@ const createSuggestionAutocompletion = (cache) => async (context) => {
   };
 };
 export {
-  createSuggestionAutocompletion
+  createSuggestionAutocompletion,
+  getSuggestionTitle
 };
 //# sourceMappingURL=suggestion-autocompletions.js.map

package/esm/editors/dql-editor/autocomplete/suggestion-autocompletions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/editors/dql-editor/autocomplete/suggestion-autocompletions.tsx"],
+  "sourcesContent": ["import { Completion } from '@codemirror/autocomplete';\n\nimport {\n  AutocompleteSuggestion,\n  AutocompleteSuggestionPart,\n} from '@dynatrace-sdk/client-query';\n\nimport {\n  convertToMiddleEllipsis,\n  fuzzyMatch,\n  getFuzzyMatchFullLabelPosition,\n  labelShouldBeTruncated,\n} from './fuzzy-match.js';\nimport { getSuggestions, type SuggestionCache } from './get-suggestions.js';\nimport { SuggestionPart } from './suggestion-popup/SuggestionPart.js';\nimport { getTokenTypeLabel } from './token-type-label.js';\nimport { combinedDurationUnits } from '../../../core/dql/dql-common.js';\nimport { Flex } from '../../../layouts/flex/Flex.js';\nimport { Text } from '../../../typography/text/Text.js';\nimport type {\n  AutocompleteProvider,\n  AutocompletionResult,\n  Suggestion,\n} from '../../base-code-editor/auto-completion/autocompletion.extension.js';\nimport { verifyQuery } from '../dql/dql-linter.js';\n\n/**\n * Extracts the last word or dot-separated word from the content.\n * @param content - the content of the editor up to the cursor position.\n * @returns an object containing the raw captured word and the trimmed word without leading digits.\n */\nfunction extractWordToken(content: string): {\n  rawCapture: string;\n  trimmedCapture: string;\n} {\n  const rawCapture = /\\W?([\\w.]*)$/.exec(content)?.[1] ?? '';\n  // Strip any leading integer or decimal so the unit suffix (e.g. \"h\", \"ms\") is used\n  // as the match pattern to ensure duration unit suggestions are shown correctly after a number.\n  const trimmedCapture = rawCapture.replace(/^\\d+(\\.\\d+)?/, '');\n\n  return { rawCapture, trimmedCapture };\n}\n\n/**\n * Checks whether the user is typing a duration unit alias after a number.\n * @param rawCapture - the raw captured word token.\n * @param trimmedCapture - the captured word token with any leading numeric prefix removed.\n * @returns true if the user is typing a duration unit alias after a number, false otherwise.\n */\nfunction getIsTypingUnitAlias(\n  rawCapture: string,\n  trimmedCapture: string,\n): boolean {\n  return (\n    trimmedCapture.length > 0 &&\n    trimmedCapture !== rawCapture &&\n    combinedDurationUnits.some((unit) => unit.startsWith(trimmedCapture))\n  );\n}\n\ntype FilteredSuggestion = AutocompleteSuggestion & {\n  score: number;\n  startPos: number;\n};\n\nconst TOKEN_TYPES = {\n  ANCHOR: 'FIELD_VALUE',\n  SYNOPSIS_INFO: 'SYNOPSIS_INFO',\n} as const;\n\n// Part types that can serve as a tooltip title (named entities, not separators).\nconst TITLE_TYPES = new Set([\n  'COMMAND_NAME',\n  'FUNCTION_NAME',\n  'TIMESERIES_AGGREGATION',\n]);\n\n/**\n * Whether a suggestion part must be hidden from descriptions and popups.\n * Value anchors and command-level synopsis text are excluded from all\n * user-visible surfaces.\n */\nfunction isHiddenPart(part: AutocompleteSuggestionPart): boolean {\n  // Cast: not yet in the SDK's `type` union. See [APPDEV-19104].\n  const type = part.type as string;\n  return type === TOKEN_TYPES.ANCHOR || type === TOKEN_TYPES.SYNOPSIS_INFO;\n}\n\n/**\n * Builds the cursor-position description from the empty suggestions' parts.\n * Excludes value anchors and command-level synopsis; field-name info is kept.\n */\nfunction getPositionDescription(\n  emptySuggestionParts: AutocompleteSuggestionPart[],\n): string {\n  return emptySuggestionParts\n    .filter((part) => !!part.info && !isHiddenPart(part))\n    .map((part) => part.info as string)\n    .join(' ');\n}\n\n/**\n * Filters out and trims quote suggestions.\n * @param suggestions - suggestions list\n */\nfunction removeQuoteSuggestions(\n  suggestions: FilteredSuggestion[],\n): FilteredSuggestion[] {\n  const excludedSuggestions = ['\"', '\"\"', '\"\"\"', ' '];\n  return suggestions\n    .filter((elem) => !excludedSuggestions.includes(elem.suggestion))\n    .map((elem) => {\n      // trim trailing quotation marks\n      const trimmed = elem.suggestion.replace(/\"{1,3}$/, '');\n      return { ...elem, suggestion: trimmed };\n    })\n    .filter((elem) => elem.suggestion.length > 0);\n}\n\n/**\n *  Filters the suggestions based on matching pattern and suggestions as well as the\n *  autocomplete trigger pattern.\n *\n * @param suggestions - suggestions for the pattern\n * @param pattern - pattern matched\n * @param requestCursorPosition - the request cursor position\n * @param cursorPosition - editor cursor position\n * @param disableFilter - flag for whether the autocomplete was triggered via ctrl+space or having a pattern length of 1 or less\n */\nfunction filterSuggestions(\n  suggestions: AutocompleteSuggestion[],\n  pattern: string,\n  requestCursorPosition: number,\n  cursorPosition: number,\n  disableFilter: boolean,\n): Array<FilteredSuggestion> {\n  return suggestions\n    .reduce<Array<FilteredSuggestion>>((result, suggestion) => {\n      // Check if the suggestion matches part of the pattern\n      const matchResult = fuzzyMatch(pattern, suggestion.suggestion);\n      const match =\n        suggestion.alreadyTypedCharacters === 0 ? true : matchResult.match;\n      // Give the match a score for sorting the suggestions based on the closest match to the pattern\n      const score =\n        suggestion.alreadyTypedCharacters === 0 ? 1 : matchResult.score;\n      const startPos =\n        suggestion.alreadyTypedCharacters === 0\n          ? cursorPosition\n          : requestCursorPosition - suggestion.alreadyTypedCharacters;\n      if (suggestion.suggestion.length > 0 && (disableFilter || match)) {\n        result.push({ ...suggestion, score, startPos });\n      }\n      return result;\n    }, [])\n    .sort((a, b) => b.score - a.score);\n}\n\n/**\n * Builds the query string sent to the autocomplete backend.\n * @param autocompleteContent - editor content up to the cursor position\n * @param patternLength - length of the full typed pattern\n * @param requestLength - how many characters of the pattern to include; use 1 to maximise\n *   cache hits, or `patternLength` for explicit (Ctrl+Space) completions\n */\nfunction getRequestString(\n  autocompleteContent: string,\n  patternLength: number,\n  requestLength: number,\n) {\n  return autocompleteContent.slice(\n    0,\n    autocompleteContent.length - patternLength + requestLength,\n  );\n}\n\n// max. number of suggestions fetched from autocomplete endpoint\nconst MAX_DATA_SUGGESTIONS = 10_000;\n\n// Usable horizontal space in the autocomplete dropdown (476px with scrollbar minus 2\u00D712px padding).\nconst AUTOCOMPLETE_PANEL_USABLE_PX = 452;\n// Approximate pixels per character for the suggestion label (code font, ~14px).\nconst CODE_FONT_PX_PER_CHAR = 9;\n// Approximate pixels per character for the type label (text-small font, ~12px).\nconst TYPE_LABEL_PX_PER_CHAR = 7;\n// Gap between suggestion label and type label \u2014 matches the flex gap on the list item (Spacings.Size4).\nconst LABEL_GAP_PX = 4;\n// Minimum label length to keep suggestions readable even when the type label is very long.\nconst MIN_LABEL_LENGTH_WITH_TYPE = 20;\n\n/**\n * Estimates the maximum character length for a suggestion label when a type label is shown\n * alongside it. Uses approximate per-character pixel widths (code font \u22489px, text-small \u22487px)\n * against {@link AUTOCOMPLETE_PANEL_USABLE_PX}. Floored at {@link MIN_LABEL_LENGTH_WITH_TYPE}\n * to keep suggestions readable even when the type label is very long.\n * @param typeLabelLength - character length of the type label (e.g. \"Metric key\" \u2192 10)\n */\nfunction getLabelMaxLengthWithType(typeLabelLength: number): number {\n  // Pixels consumed by the type label and the gap between label and type label.\n  const reservedPx = typeLabelLength * TYPE_LABEL_PX_PER_CHAR + LABEL_GAP_PX;\n  // Remaining pixels available for the suggestion label, converted to character count.\n  const availableChars = Math.floor(\n    (AUTOCOMPLETE_PANEL_USABLE_PX - reservedPx) / CODE_FONT_PX_PER_CHAR,\n  );\n  return Math.max(MIN_LABEL_LENGTH_WITH_TYPE, availableChars);\n}\n\n/**\n * Fetches suggestions from the backend and filters them against the current pattern.\n * @param autocompleteContent - editor content up to the cursor position\n * @param patternLength - length of the typed pattern used for filtering\n * @param explicit - when true (Ctrl+Space), the full pattern is sent to the backend so all\n *   matching suggestions are returned; when false, only 1 character is sent to maximise cache hits\n * @param cache - per-editor suggestion cache\n */\nasync function getFilteredSuggestions(\n  autocompleteContent: string,\n  patternLength: number,\n  explicit: boolean,\n  cache: SuggestionCache,\n): Promise<FilteredSuggestion[]> {\n  const requestString = getRequestString(\n    autocompleteContent,\n    patternLength,\n    explicit ? patternLength : 1,\n  );\n  const suggestions = await getSuggestions(\n    requestString,\n    requestString.length,\n    MAX_DATA_SUGGESTIONS,\n    cache,\n  );\n\n  const pattern = autocompleteContent.slice(\n    autocompleteContent.length - patternLength,\n  );\n  return filterSuggestions(\n    suggestions,\n    pattern,\n    requestString.length,\n    autocompleteContent.length,\n    explicit,\n  );\n}\n\n/**\n * Derives the tooltip title for a suggestion by finding the first part that\n * produces a token type label, then combining that part's suggestion text\n * (capitalized) with the lower-cased label (e.g. part `\"arrayAvg\"` + `\"Function\"` \u2192 `\"ArrayAvg function\"`).\n * @param suggestion - the suggestion to derive the title for.\n * @returns the derived title string, or `undefined` when no part produces a token type label.\n */\nexport function getSuggestionTitle(\n  suggestion: FilteredSuggestion,\n): string | undefined {\n  for (const part of suggestion.parts) {\n    if (!TITLE_TYPES.has(part.type)) {\n      continue;\n    }\n    const label = getTokenTypeLabel([part]);\n    if (label !== undefined) {\n      const { suggestion: text } = part;\n      return `${text.charAt(0).toUpperCase()}${text.slice(\n        1,\n      )} ${label.toLowerCase()}`;\n    }\n  }\n}\n\n/**\n * Builds the popup render function for a suggestion's info parts (anchors\n * excluded), or `undefined` when there is no info to show.\n * @param suggestion - the suggestion whose info parts should be rendered.\n * @returns a popup render function, or `undefined` when there is no info.\n */\nfunction buildSuggestionInfoPopup(\n  suggestion: FilteredSuggestion,\n): Suggestion['popup'] {\n  const infoParts = suggestion.parts.filter(\n    (part) => !!part.info && !isHiddenPart(part),\n  );\n  if (infoParts.length === 0) {\n    return undefined;\n  }\n  const title = getSuggestionTitle(suggestion);\n  if (infoParts.length === 1) {\n    return () => <SuggestionPart suggestionPart={infoParts[0]} title={title} />;\n  }\n  const [firstPart, ...remainingParts] = infoParts;\n  return () => (\n    <Flex flexDirection=\"column\" gap={16}>\n      <SuggestionPart suggestionPart={firstPart} title={title} />\n      {remainingParts.map((part) => (\n        <SuggestionPart key={part.info} suggestionPart={part} />\n      ))}\n    </Flex>\n  );\n}\n\n/**\n * Builds the popup for an autocomplete suggestion.\n *\n * @param label - the full (non-truncated) suggestion label.\n * @param truncated - whether the label was shortened with a middle ellipsis.\n * @param infoPopup - the pre-built info popup for this suggestion, or `undefined` if there is none.\n * @returns a popup render function, or `undefined`.\n */\nfunction buildSuggestionPopup(\n  label: string,\n  truncated: boolean,\n  infoPopup: Suggestion['popup'],\n): Suggestion['popup'] {\n  if (label.length === 0) {\n    return undefined;\n  }\n  if (truncated) {\n    return () => (\n      <>\n        <Text fontStyle=\"code\" as=\"p\">\n          {label}\n        </Text>\n        {infoPopup ?? null}\n      </>\n    );\n  }\n  return infoPopup;\n}\n\n/**\n * Creates the DQL autocomplete provider bound to a `cache` owned by the calling\n * editor instance. Keeping the cache per-instance ensures suggestions never\n * outlive the editor or leak between editors (or between dev-app stories).\n * @param cache - the suggestion cache owned by the editor instance.\n */\nexport const createSuggestionAutocompletion =\n  (cache: SuggestionCache): AutocompleteProvider =>\n  async (context): Promise<AutocompletionResult | null> => {\n    if (context.matchBefore(/[^\\w.]/) && !context.explicit) {\n      return null;\n    }\n    // For performance, only take the query up until the cursor position.\n    // This allows the backend to be queried less often and the cache more often\n    const autocompleteContent = context.state.doc\n      .slice(0, context.pos)\n      .toString();\n    const { rawCapture, trimmedCapture: pattern } =\n      extractWordToken(autocompleteContent);\n\n    const infoSuggestions = await getSuggestions(\n      getRequestString(autocompleteContent, pattern.length, 0),\n      undefined,\n      undefined,\n      cache,\n    );\n\n    let filteredSuggestions = await getFilteredSuggestions(\n      autocompleteContent,\n      pattern.length,\n      pattern.length <= 1 ||\n        getIsTypingUnitAlias(rawCapture, pattern) ||\n        pattern.endsWith('.'),\n      cache,\n    );\n\n    if (filteredSuggestions.length === 0) {\n      if (pattern.length > 1) {\n        filteredSuggestions = await getFilteredSuggestions(\n          autocompleteContent,\n          pattern.length,\n          true,\n          cache,\n        );\n      }\n    }\n\n    // Filter out suggestions (mainly quotes) if the cursor is within a string token and\n    // the autocomplete query was not the full query (there are characters after the cursor).\n    // This is necessary as we only send the autocomplete request with the query up to the cursor,\n    // omitting text after the cursor (if present).\n    // We still do want to show quotes if the cursor is at the end of the text and even within a string token.\n    if (\n      context.tokenBefore(['string']) !== null &&\n      autocompleteContent.length !== context.state.doc.length\n    ) {\n      filteredSuggestions = removeQuoteSuggestions(filteredSuggestions);\n    }\n\n    const emptySuggestionParts = infoSuggestions\n      .filter((suggestion) => !suggestion.suggestion)\n      .flatMap((suggestion) => suggestion.parts);\n\n    const section = getPositionDescription(emptySuggestionParts);\n\n    /*\n     * If there are no autocomplete suggestions but there is a position\n     * description to show, we still surface it as a \"section header\". CodeMirror\n     * does not allow sections without items, so we push one empty (hidden)\n     * suggestion to carry it. When the description is empty (e.g. only value\n     * anchors are present), we skip this so the popup does not open empty.\n     */\n    if (filteredSuggestions.length === 0 && section) {\n      const emptySuggestion = infoSuggestions.find(\n        (s) => s.suggestion.length === 0,\n      );\n      if (emptySuggestion) {\n        filteredSuggestions.push({\n          ...emptySuggestion,\n          score: -99,\n          startPos: context.pos,\n        });\n      }\n    }\n\n    if (filteredSuggestions.length === 0) {\n      return null;\n    }\n\n    const autocompletePos = Math.min(\n      ...filteredSuggestions.map((s) => s.startPos),\n    );\n\n    return {\n      suggestions: filteredSuggestions.map((suggestion): Suggestion => {\n        const infoPopup = buildSuggestionInfoPopup(suggestion);\n        const tokenTypeLabel = getTokenTypeLabel(suggestion.parts);\n\n        const effectiveMaxLength = tokenTypeLabel\n          ? getLabelMaxLengthWithType(tokenTypeLabel.length)\n          : undefined;\n        const shouldBeTruncated = labelShouldBeTruncated(\n          suggestion.suggestion,\n          effectiveMaxLength,\n        );\n        const middleEllipsisText = shouldBeTruncated\n          ? convertToMiddleEllipsis(suggestion.suggestion, effectiveMaxLength)\n          : suggestion.suggestion;\n\n        return {\n          ...suggestion,\n          label: middleEllipsisText,\n          section,\n          postfix: tokenTypeLabel,\n          apply: (view) => {\n            view.dispatch({\n              changes: {\n                from: suggestion.startPos,\n                to: autocompleteContent.length,\n                insert: suggestion.suggestion,\n              },\n              selection: {\n                anchor: suggestion.startPos + suggestion.suggestion.length,\n              },\n              userEvent: 'input.complete',\n            });\n          },\n\n          popup: buildSuggestionPopup(\n            suggestion.suggestion,\n            shouldBeTruncated,\n            infoPopup,\n          ),\n        };\n      }),\n      from: autocompletePos,\n      async reopen(completion: Completion & Partial<FilteredSuggestion>) {\n        const queryToEnd = context.state.doc.slice(context.pos).toString();\n\n        // Heuristic: if non-whitespace content exists to the right of the cursor,\n        // treat this as inline token editing and skip reopen to avoid noisy popup\n        // behavior while the user is fixing text in place.\n        if (queryToEnd.trim().length > 0) {\n          return false;\n        }\n\n        const completedQuery =\n          autocompleteContent.slice(0, completion.startPos) +\n          completion.suggestion +\n          queryToEnd;\n\n        const { valid = true } = (await verifyQuery(completedQuery)) ?? {};\n        return !valid;\n      },\n      filter: false,\n      getMatch: (completion: Completion & Partial<FilteredSuggestion>) => {\n        const completionTypeLabel =\n          completion.parts && getTokenTypeLabel(completion.parts);\n        const matchMaxLength = completionTypeLabel\n          ? getLabelMaxLengthWithType(completionTypeLabel.length)\n          : undefined;\n        return (\n          getFuzzyMatchFullLabelPosition(\n            pattern,\n            completion.suggestion,\n            matchMaxLength,\n          ) ??\n          fuzzyMatch(\n            autocompleteContent.slice(autocompletePos),\n            completion.suggestion ?? '',\n          ).pos ??\n          []\n        );\n      },\n    };\n  };\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/editors/dql-editor/autocomplete/suggestion-popup/DocumentationLink.js

@@ -0,0 +1,31 @@
+import { jsx } from "react/jsx-runtime";
+import { useIntl } from "react-intl";
+import { DQL_DOCUMENTATION_URL_PREFIX } from "../../../../core/external-links.js";
+import { ExternalLink } from "../../../../typography/external-link/ExternalLink.js";
+import { Text } from "../../../../typography/text/Text.js";
+import { dqlEditorMessages as messages } from "../messages.js";
+const DOCUMENTATION_URL_PARTS = /* @__PURE__ */ new Map([
+  ["COMMAND_NAME", "command"],
+  ["FUNCTION_NAME", "function"],
+  ["TIMESERIES_AGGREGATION", "timeseries"]
+]);
+function generateDocumentationLink(suggestion) {
+  const urlPart = suggestion?.type && DOCUMENTATION_URL_PARTS.get(suggestion.type);
+  if (!urlPart) {
+    return void 0;
+  }
+  const encoded = encodeURI(`${urlPart}_${suggestion.suggestion}`);
+  return `${DQL_DOCUMENTATION_URL_PREFIX}${encoded}`;
+}
+const DocumentationLink = ({
+  suggestionPart
+}) => {
+  const intl = useIntl();
+  const docUrl = generateDocumentationLink(suggestionPart);
+  return docUrl ? /* @__PURE__ */ jsx(Text, { textStyle: "small", children: /* @__PURE__ */ jsx(ExternalLink, { href: docUrl, "data-dt-name": "LearnMore", children: intl.formatMessage(messages.suggestionDocumentationLink) }) }) : null;
+};
+export {
+  DocumentationLink,
+  generateDocumentationLink
+};
+//# sourceMappingURL=DocumentationLink.js.map

package/esm/editors/dql-editor/autocomplete/suggestion-popup/DocumentationLink.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/editors/dql-editor/autocomplete/suggestion-popup/DocumentationLink.tsx"],
+  "sourcesContent": ["import { useIntl } from 'react-intl';\n\nimport type { AutocompleteSuggestionPart } from '@dynatrace-sdk/client-query';\n\nimport { DQL_DOCUMENTATION_URL_PREFIX } from '../../../../core/external-links.js';\nimport { ExternalLink } from '../../../../typography/external-link/ExternalLink.js';\nimport { Text } from '../../../../typography/text/Text.js';\nimport { dqlEditorMessages as messages } from '../messages.js';\n\nconst DOCUMENTATION_URL_PARTS = new Map([\n  ['COMMAND_NAME', 'command'],\n  ['FUNCTION_NAME', 'function'],\n  ['TIMESERIES_AGGREGATION', 'timeseries'],\n]);\n\n/**\n * Generates a documentation URL for a DQL suggestion part, or `undefined` if\n * the part's token type has no corresponding docs page.\n * @param suggestion - the autocomplete suggestion part as returned by the endpoint\n */\nexport function generateDocumentationLink(\n  suggestion: AutocompleteSuggestionPart | undefined,\n): string | undefined {\n  const urlPart =\n    suggestion?.type && DOCUMENTATION_URL_PARTS.get(suggestion.type);\n  if (!urlPart) {\n    return undefined;\n  }\n\n  const encoded = encodeURI(`${urlPart}_${suggestion.suggestion}`);\n  return `${DQL_DOCUMENTATION_URL_PREFIX}${encoded}`;\n}\n\n/**\n * Renders a small \"Documentation\" external link for a DQL suggestion part,\n * or nothing when the part's token type has no associated docs page.\n */\nexport const DocumentationLink = ({\n  suggestionPart,\n}: {\n  suggestionPart: AutocompleteSuggestionPart | undefined;\n}) => {\n  const intl = useIntl();\n  const docUrl = generateDocumentationLink(suggestionPart);\n  return docUrl ? (\n    <Text textStyle=\"small\">\n      <ExternalLink href={docUrl} data-dt-name=\"LearnMore\">\n        {intl.formatMessage(messages.suggestionDocumentationLink)}\n      </ExternalLink>\n    </Text>\n  ) : null;\n};\n"],
+  "mappings": "AA8CM;AA9CN,SAAS,eAAe;AAIxB,SAAS,oCAAoC;AAC7C,SAAS,oBAAoB;AAC7B,SAAS,YAAY;AACrB,SAAS,qBAAqB,gBAAgB;AAE9C,MAAM,0BAA0B,oBAAI,IAAI;AAAA,EACtC,CAAC,gBAAgB,SAAS;AAAA,EAC1B,CAAC,iBAAiB,UAAU;AAAA,EAC5B,CAAC,0BAA0B,YAAY;AACzC,CAAC;AAOM,SAAS,0BACd,YACoB;AACpB,QAAM,UACJ,YAAY,QAAQ,wBAAwB,IAAI,WAAW,IAAI;AACjE,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,UAAU,GAAG,OAAO,IAAI,WAAW,UAAU,EAAE;AAC/D,SAAO,GAAG,4BAA4B,GAAG,OAAO;AAClD;AAMO,MAAM,oBAAoB,CAAC;AAAA,EAChC;AACF,MAEM;AACJ,QAAM,OAAO,QAAQ;AACrB,QAAM,SAAS,0BAA0B,cAAc;AACvD,SAAO,SACL,oBAAC,QAAK,WAAU,SACd,8BAAC,gBAAa,MAAM,QAAQ,gBAAa,aACtC,eAAK,cAAc,SAAS,2BAA2B,GAC1D,GACF,IACE;AACN;",
+  "names": []
+}

package/esm/editors/dql-editor/autocomplete/suggestion-popup/SuggestionPart.js

@@ -0,0 +1,37 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useIntl } from "react-intl";
+import { DocumentationLink } from "./DocumentationLink.js";
+import { CodeSnippet } from "../../../../content/code-snippet/CodeSnippet.js";
+import { Flex } from "../../../../layouts/flex/Flex.js";
+import { Text } from "../../../../typography/text/Text.js";
+import { dqlEditorMessages as messages } from "../messages.js";
+const SuggestionPart = ({
+  suggestionPart,
+  title
+}) => {
+  const intl = useIntl();
+  return /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: 8, children: [
+    /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: 4, children: [
+      title && /* @__PURE__ */ jsx(Text, { textStyle: "base-emphasized", children: title }),
+      /* @__PURE__ */ jsx(Text, { textStyle: "base", children: suggestionPart.info })
+    ] }),
+    suggestionPart.synopsis && /* @__PURE__ */ jsxs(Flex, { flexDirection: "column", gap: 4, children: [
+      /* @__PURE__ */ jsx(Text, { textStyle: "small", children: intl.formatMessage(messages.suggestionSyntaxLabel) }),
+      /* @__PURE__ */ jsx(
+        CodeSnippet,
+        {
+          language: "dql",
+          showLineNumbers: false,
+          showCopyAction: false,
+          lineBreaks: true,
+          children: suggestionPart.synopsis
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(DocumentationLink, { suggestionPart })
+  ] });
+};
+export {
+  SuggestionPart
+};
+//# sourceMappingURL=SuggestionPart.js.map

package/esm/editors/dql-editor/autocomplete/suggestion-popup/SuggestionPart.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/editors/dql-editor/autocomplete/suggestion-popup/SuggestionPart.tsx"],
+  "sourcesContent": ["import { useIntl } from 'react-intl';\n\nimport type { AutocompleteSuggestionPart } from '@dynatrace-sdk/client-query';\n\nimport { DocumentationLink } from './DocumentationLink.js';\nimport { CodeSnippet } from '../../../../content/code-snippet/CodeSnippet.js';\nimport { Flex } from '../../../../layouts/flex/Flex.js';\nimport { Text } from '../../../../typography/text/Text.js';\nimport { dqlEditorMessages as messages } from '../messages.js';\n\ntype SuggestionPartProps = {\n  /**\n   * The autocomplete suggestion part supplying the info text and optional synopsis.\n   */\n  suggestionPart: AutocompleteSuggestionPart;\n  /**\n   * Optional heading displayed above the info text.\n   */\n  title?: string;\n};\n\n/**\n * Renders the detail body for a single autocomplete suggestion info part.\n */\nexport const SuggestionPart = ({\n  suggestionPart,\n  title,\n}: SuggestionPartProps) => {\n  const intl = useIntl();\n  return (\n    <Flex flexDirection=\"column\" gap={8}>\n      <Flex flexDirection=\"column\" gap={4}>\n        {title && <Text textStyle=\"base-emphasized\">{title}</Text>}\n        <Text textStyle=\"base\">{suggestionPart.info}</Text>\n      </Flex>\n\n      {suggestionPart.synopsis && (\n        <Flex flexDirection=\"column\" gap={4}>\n          <Text textStyle=\"small\">\n            {intl.formatMessage(messages.suggestionSyntaxLabel)}\n          </Text>\n          <CodeSnippet\n            language=\"dql\"\n            showLineNumbers={false}\n            showCopyAction={false}\n            lineBreaks\n          >\n            {suggestionPart.synopsis}\n          </CodeSnippet>\n        </Flex>\n      )}\n\n      <DocumentationLink suggestionPart={suggestionPart} />\n    </Flex>\n  );\n};\n"],
+  "mappings": "AA+BM,SACY,KADZ;AA/BN,SAAS,eAAe;AAIxB,SAAS,yBAAyB;AAClC,SAAS,mBAAmB;AAC5B,SAAS,YAAY;AACrB,SAAS,YAAY;AACrB,SAAS,qBAAqB,gBAAgB;AAgBvC,MAAM,iBAAiB,CAAC;AAAA,EAC7B;AAAA,EACA;AACF,MAA2B;AACzB,QAAM,OAAO,QAAQ;AACrB,SACE,qBAAC,QAAK,eAAc,UAAS,KAAK,GAChC;AAAA,yBAAC,QAAK,eAAc,UAAS,KAAK,GAC/B;AAAA,eAAS,oBAAC,QAAK,WAAU,mBAAmB,iBAAM;AAAA,MACnD,oBAAC,QAAK,WAAU,QAAQ,yBAAe,MAAK;AAAA,OAC9C;AAAA,IAEC,eAAe,YACd,qBAAC,QAAK,eAAc,UAAS,KAAK,GAChC;AAAA,0BAAC,QAAK,WAAU,SACb,eAAK,cAAc,SAAS,qBAAqB,GACpD;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,UAAS;AAAA,UACT,iBAAiB;AAAA,UACjB,gBAAgB;AAAA,UAChB,YAAU;AAAA,UAET,yBAAe;AAAA;AAAA,MAClB;AAAA,OACF;AAAA,IAGF,oBAAC,qBAAkB,gBAAgC;AAAA,KACrD;AAEJ;",
+  "names": []
+}

package/esm/editors/dql-editor/{dql → autocomplete}/suggestions-info-section-extension.js

@@ -12,6 +12,12 @@ const SUGGESTIONS_INFO_ATTR = "data-dql-suggestions-info";
 function findTooltipElement() {
   return document.querySelector(".cm-tooltip-autocomplete");
 }
+function ensureCompletionSectionFirst(ul) {
+  const sectionHeader = ul.querySelector("completion-section");
+  if (sectionHeader && ul.firstElementChild !== sectionHeader) {
+    ul.insertBefore(sectionHeader, ul.firstElementChild);
+  }
+}
 const suggestionsInfoSectionTheme = EditorView.baseTheme({
   ".cm-tooltip.cm-tooltip-autocomplete": {
     background: "transparent !important",
@@ -47,18 +53,25 @@ const suggestionsInfoSectionPlugin = ViewPlugin.fromClass(
   class {
     container = null;
     root = null;
+    currentUl = null;
     update(update) {
       const status = completionStatus(update.state);
       if (status === null) {
         queueMicrotask(() => this.unmount());
+        this.currentUl = null;
         return;
       }
       queueMicrotask(() => {
+        const tooltipEl = findTooltipElement();
+        const ul = tooltipEl?.querySelector("ul") ?? null;
+        if (ul && ul !== this.currentUl) {
+          this.currentUl = ul;
+          ensureCompletionSectionFirst(ul);
+        }
         if (this.container?.isConnected) {
           return;
         }
         this.unmount();
-        const tooltipEl = findTooltipElement();
         if (tooltipEl) {
           this.mount(tooltipEl);
         }

package/esm/editors/dql-editor/autocomplete/suggestions-info-section-extension.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/editors/dql-editor/autocomplete/suggestions-info-section-extension.ts"],
+  "sourcesContent": ["import { completionStatus } from '@codemirror/autocomplete';\nimport { EditorView, ViewPlugin, ViewUpdate } from '@codemirror/view';\nimport { type ComponentType, type ReactNode, createElement } from 'react';\nimport { createRoot, Root } from 'react-dom/client';\nimport { IntlProvider } from 'react-intl';\n\nimport Borders from '@dynatrace/strato-design-tokens/borders';\nimport BoxShadows from '@dynatrace/strato-design-tokens/box-shadows';\nimport Colors from '@dynatrace/strato-design-tokens/colors';\nimport Spacings from '@dynatrace/strato-design-tokens/spacings';\n\nimport { SuggestionsInfoSection } from './SuggestionsInfoSection.js';\n\nconst SUGGESTIONS_INFO_ATTR = 'data-dql-suggestions-info';\n\nfunction findTooltipElement(): HTMLElement | null {\n  return document.querySelector<HTMLElement>('.cm-tooltip-autocomplete');\n}\n\n/**\n * Moves the `<completion-section>` to the top of the list when CodeMirror places it after the\n * first `<li>` on paginated pages. This happens because CodeMirror suppresses the section header\n * for the first item of non-first pages and the next item triggers it instead.\n */\nfunction ensureCompletionSectionFirst(ul: HTMLUListElement): void {\n  const sectionHeader = ul.querySelector('completion-section');\n  if (sectionHeader && ul.firstElementChild !== sectionHeader) {\n    ul.insertBefore(sectionHeader, ul.firstElementChild);\n  }\n}\n\n// Strips the floating-box styling from the autocomplete tooltip container and\n// reapplies it to the suggestion list (`ul`) so the suggestion list and the\n// info section render as two visually independent floating boxes with a gap.\nconst suggestionsInfoSectionTheme = EditorView.baseTheme({\n  '.cm-tooltip.cm-tooltip-autocomplete': {\n    background: 'transparent !important',\n    boxShadow: 'none !important',\n    padding: '0 !important',\n    borderRadius: '0 !important',\n    display: 'flex !important',\n    flexDirection: 'column',\n    gap: Spacings.Size4,\n    // Override the fixed `width: 500px` from the base editor config with a\n    // responsive width, so the tooltip shrinks on narrow viewports. This is\n    // what allows the container query in `SuggestionsInfoSection.css.ts` to\n    // actually fire and reflow the info section to a column layout.\n    width: `min(500px, calc(100vw - ${Spacings.Size16}))`,\n  },\n  '.cm-tooltip.cm-tooltip-autocomplete > ul': {\n    background: Colors.Background.Surface.Default,\n    borderRadius: Borders.Radius.Surface.Subdued,\n    boxShadow: BoxShadows.Surface.Floating.Rest,\n    padding: `${Spacings.Size4} !important`,\n    flex: '0 1 auto',\n    minHeight: 0,\n  },\n  // Pin the info section to the bottom regardless of DOM insertion order:\n  // CodeMirror sometimes appends new children (e.g. the rebuilt `ul`) after our\n  // section, leaving it visually above the suggestions. Setting a higher `order`\n  // value forces flex to render it last while the `ul` keeps the default 0.\n  [`.cm-tooltip.cm-tooltip-autocomplete > [${SUGGESTIONS_INFO_ATTR}]`]: {\n    order: 1,\n  },\n});\n\nconst suggestionsInfoSectionPlugin = ViewPlugin.fromClass(\n  class {\n    private container: HTMLElement | null = null;\n    private root: Root | null = null;\n    private currentUl: HTMLUListElement | null = null;\n\n    update(update: ViewUpdate) {\n      const status = completionStatus(update.state);\n\n      if (status === null) {\n        // Defer the unmount so that root.unmount() is not called synchronously\n        // inside a CodeMirror dispatch \u2192 plugin update stack. In React 19,\n        // root.unmount() triggers a synchronous flush that conflicts with an\n        // outer act() boundary in tests (and with React's batching in general).\n        queueMicrotask(() => this.unmount());\n        this.currentUl = null;\n        return;\n      }\n\n      // Defer to ensure CodeMirror has finished creating the tooltip DOM.\n      queueMicrotask(() => {\n        const tooltipEl = findTooltipElement();\n        const ul = tooltipEl?.querySelector<HTMLUListElement>('ul') ?? null;\n\n        // Fix section-header position whenever the ul is (re)built, e.g. on pagination.\n        if (ul && ul !== this.currentUl) {\n          this.currentUl = ul;\n          ensureCompletionSectionFirst(ul);\n        }\n\n        if (this.container?.isConnected) {\n          return;\n        }\n        this.unmount();\n\n        if (tooltipEl) {\n          this.mount(tooltipEl);\n        }\n      });\n    }\n\n    private mount(tooltipEl: HTMLElement) {\n      this.container = document.createElement('div');\n      this.container.setAttribute(SUGGESTIONS_INFO_ATTR, '');\n      tooltipEl.appendChild(this.container);\n\n      this.root = createRoot(this.container);\n      this.root.render(\n        createElement(\n          // react-intl ships @types/react@18 types. Its `contextType` references\n          // the React 18 `Context<any>` which is missing the `$$typeof` symbol\n          // required by React 19. The cast sidesteps the cross-version mismatch\n          // while keeping the props shape explicit.\n          IntlProvider as unknown as ComponentType<{\n            locale: string;\n            defaultLocale: string;\n            messages: Record<string, string>;\n            children?: ReactNode;\n          }>,\n          { locale: 'en', defaultLocale: 'en', messages: {} },\n          createElement(SuggestionsInfoSection),\n        ),\n      );\n    }\n\n    private unmount() {\n      this.root?.unmount();\n      this.root = null;\n      this.container?.remove();\n      this.container = null;\n    }\n\n    destroy() {\n      this.unmount();\n    }\n  },\n);\n\nexport const suggestionsInfoSectionExtension = [\n  suggestionsInfoSectionTheme,\n  suggestionsInfoSectionPlugin,\n];\n"],
+  "mappings": "AAAA,SAAS,wBAAwB;AACjC,SAAS,YAAY,kBAA8B;AACnD,SAA6C,qBAAqB;AAClE,SAAS,kBAAwB;AACjC,SAAS,oBAAoB;AAE7B,OAAO,aAAa;AACpB,OAAO,gBAAgB;AACvB,OAAO,YAAY;AACnB,OAAO,cAAc;AAErB,SAAS,8BAA8B;AAEvC,MAAM,wBAAwB;AAE9B,SAAS,qBAAyC;AAChD,SAAO,SAAS,cAA2B,0BAA0B;AACvE;AAOA,SAAS,6BAA6B,IAA4B;AAChE,QAAM,gBAAgB,GAAG,cAAc,oBAAoB;AAC3D,MAAI,iBAAiB,GAAG,sBAAsB,eAAe;AAC3D,OAAG,aAAa,eAAe,GAAG,iBAAiB;AAAA,EACrD;AACF;AAKA,MAAM,8BAA8B,WAAW,UAAU;AAAA,EACvD,uCAAuC;AAAA,IACrC,YAAY;AAAA,IACZ,WAAW;AAAA,IACX,SAAS;AAAA,IACT,cAAc;AAAA,IACd,SAAS;AAAA,IACT,eAAe;AAAA,IACf,KAAK,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,IAKd,OAAO,2BAA2B,SAAS,MAAM;AAAA,EACnD;AAAA,EACA,4CAA4C;AAAA,IAC1C,YAAY,OAAO,WAAW,QAAQ;AAAA,IACtC,cAAc,QAAQ,OAAO,QAAQ;AAAA,IACrC,WAAW,WAAW,QAAQ,SAAS;AAAA,IACvC,SAAS,GAAG,SAAS,KAAK;AAAA,IAC1B,MAAM;AAAA,IACN,WAAW;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,CAAC,0CAA0C,qBAAqB,GAAG,GAAG;AAAA,IACpE,OAAO;AAAA,EACT;AACF,CAAC;AAED,MAAM,+BAA+B,WAAW;AAAA,EAC9C,MAAM;AAAA,IACI,YAAgC;AAAA,IAChC,OAAoB;AAAA,IACpB,YAAqC;AAAA,IAE7C,OAAO,QAAoB;AACzB,YAAM,SAAS,iBAAiB,OAAO,KAAK;AAE5C,UAAI,WAAW,MAAM;AAKnB,uBAAe,MAAM,KAAK,QAAQ,CAAC;AACnC,aAAK,YAAY;AACjB;AAAA,MACF;AAGA,qBAAe,MAAM;AACnB,cAAM,YAAY,mBAAmB;AACrC,cAAM,KAAK,WAAW,cAAgC,IAAI,KAAK;AAG/D,YAAI,MAAM,OAAO,KAAK,WAAW;AAC/B,eAAK,YAAY;AACjB,uCAA6B,EAAE;AAAA,QACjC;AAEA,YAAI,KAAK,WAAW,aAAa;AAC/B;AAAA,QACF;AACA,aAAK,QAAQ;AAEb,YAAI,WAAW;AACb,eAAK,MAAM,SAAS;AAAA,QACtB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEQ,MAAM,WAAwB;AACpC,WAAK,YAAY,SAAS,cAAc,KAAK;AAC7C,WAAK,UAAU,aAAa,uBAAuB,EAAE;AACrD,gBAAU,YAAY,KAAK,SAAS;AAEpC,WAAK,OAAO,WAAW,KAAK,SAAS;AACrC,WAAK,KAAK;AAAA,QACR;AAAA;AAAA;AAAA;AAAA;AAAA,UAKE;AAAA,UAMA,EAAE,QAAQ,MAAM,eAAe,MAAM,UAAU,CAAC,EAAE;AAAA,UAClD,cAAc,sBAAsB;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAAA,IAEQ,UAAU;AAChB,WAAK,MAAM,QAAQ;AACnB,WAAK,OAAO;AACZ,WAAK,WAAW,OAAO;AACvB,WAAK,YAAY;AAAA,IACnB;AAAA,IAEA,UAAU;AACR,WAAK,QAAQ;AAAA,IACf;AAAA,EACF;AACF;AAEO,MAAM,kCAAkC;AAAA,EAC7C;AAAA,EACA;AACF;",
+  "names": []
+}

package/esm/editors/dql-editor/{dql → autocomplete}/token-type-label.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../../../../src/editors/dql-editor/dql/token-type-label.ts"],
+  "sources": ["../../../../../src/editors/dql-editor/autocomplete/token-type-label.ts"],
   "sourcesContent": ["import type { AutocompleteSuggestionPart } from '@dynatrace-sdk/client-query';\n\nimport { upperSnakeCaseToSentenceCase } from '../../base-code-editor/utils/string-utils.js';\n\n// Widened to Record<string, string> to cover experimental SDK types (e.g. JSON_PATH, URL)\n// not yet present in the stable AutocompleteSuggestionPart['type'] union.\n// APPDEV-19104 tracks the stable SDK bump that will eventually type these properly.\nconst KEYWORD_OVERRIDES: Partial<Record<string, string>> = {\n  COMMA: 'Add parameter',\n  COLON: 'Add parameter key',\n  ASSIGNMENT: 'Add value',\n  PIPE: 'Add command',\n  COMMAND_NAME: 'Command',\n  FUNCTION_NAME: 'Function',\n  SIMPLE_IDENTIFIER: 'Identifier',\n  NULL: 'Keyword',\n  BOOLEAN_TRUE: 'Boolean, keyword',\n  BOOLEAN_FALSE: 'Boolean, keyword',\n  SEARCH_PATTERN: 'Search across all fields',\n  TIMESERIES_AGGREGATION: 'Timeseries aggregation function',\n  TIMESERIES_AGGREGATION_EXPRESSION: 'MakeTimeseries aggregation function',\n  TIMESTAMP_VALUE: 'Timestamp',\n  UID_VALUE: 'UID',\n  JSON_PATH: 'JSON path',\n  URL: 'URL',\n};\n\n// Stable SDK types that produce a label via upperSnakeCaseToSentenceCase.\n// Any type not listed here, not in KEYWORD_OVERRIDES, and not handled by a\n// special-cased branch returns undefined \u2014 unknown/future types are hidden\n// rather than shown with a potentially wrong auto-generated label.\nconst SENTENCE_CASE_TYPES: ReadonlySet<string> = new Set([\n  'ENTITY_TYPE',\n  'PARAMETER_KEY',\n  'DATA_OBJECT',\n  'NUMBER',\n  'STRING',\n  'METRIC_KEY',\n  'VARIABLE',\n  'END_COMMENT',\n  'PARSE_PATTERN',\n  'FIELD_PATTERN',\n  'ENTITY_SELECTOR_PART',\n  'TABULAR_FILE_NAME',\n  'FIELD_MODIFIER',\n  'SMARTSCAPE_ID_VALUE',\n  'ENUM_STRING',\n  'FIELD_PREFIX',\n  'BUCKET',\n  'SMARTSCAPE_NODE_PATTERN',\n  'SMARTSCAPE_EDGE_PATTERN',\n  'SMARTSCAPE_NODE_TYPE',\n  'SMARTSCAPE_EDGE_TYPE',\n]);\n\nconst OPERATOR_LABELS: Record<string, string> = {\n  '+': 'Addition',\n  '-': 'Subtraction or arithmetic negation',\n  '*': 'Multiplication',\n  '/': 'Division',\n  '%': 'Modulo',\n  '<': 'Less than',\n  '<=': 'Less than or equal to',\n  '>': 'Greater than',\n  '>=': 'Greater than or equal to',\n  '==': 'Equals',\n  '!=': 'Does not equal',\n  not: 'Logical NOT (negation)',\n  and: 'Logical AND',\n  or: 'Logical OR',\n  xor: 'Logical XOR (exclusive or)',\n  in: 'Subquery comparison',\n  '@': 'Time alignment',\n  '~': 'Search',\n};\n\nconst SEARCH_OPERATOR_LABELS: Record<string, string> = {\n  '~': 'Search in field',\n};\n\nconst PARAMETER_MODIFIER_LABELS: Record<string, string> = {\n  asc: 'Sort direction ascending',\n  desc: 'Sort direction descending',\n};\n\nconst TIME_UNIT_LABELS: Record<string, string> = {\n  ns: 'nanoseconds',\n  us: 'microseconds',\n  ms: 'milliseconds',\n  s: 'seconds',\n  m: 'minutes',\n  h: 'hours',\n  d: 'days',\n  w: 'weeks',\n  M: 'months',\n  q: 'quarters',\n  y: 'years',\n};\n\n// Types whose label depends on the suggestion text.\n// A suggestion missing from its table falls back to the sentence-cased type name.\nconst SUGGESTION_LABELS: Partial<Record<string, Record<string, string>>> = {\n  OPERATOR: OPERATOR_LABELS,\n  SEARCH_OPERATOR: SEARCH_OPERATOR_LABELS,\n  PARAMETER_MODIFIER: PARAMETER_MODIFIER_LABELS,\n  TIME_UNIT: TIME_UNIT_LABELS,\n};\n\nfunction getLabelForPart(type: string, suggestion: string): string | undefined {\n  const keywordOverride = KEYWORD_OVERRIDES[type];\n  if (keywordOverride !== undefined) {\n    return keywordOverride;\n  }\n\n  const suggestionLabels = SUGGESTION_LABELS[type];\n  if (suggestionLabels !== undefined) {\n    return suggestionLabels[suggestion] ?? upperSnakeCaseToSentenceCase(type);\n  }\n\n  return SENTENCE_CASE_TYPES.has(type)\n    ? upperSnakeCaseToSentenceCase(type)\n    : undefined;\n}\n\n/**\n * Returns a human-readable label for the token type represented by the given suggestion parts,\n * or `undefined` if no part produces a label.\n *\n * Iterates through parts in order, returning the label from the first part that resolves to one.\n * Parts with no explicit mapping (e.g. whitespace, brackets, parens) naturally return `undefined`\n * and are skipped. Resolution order per part:\n * 1. Keyword overrides (e.g. COMMA \u2192 \"Add parameter\").\n * 2. Suggestion-based lookup via {@link SUGGESTION_LABELS} (e.g. OPERATOR, TIME_UNIT), falling back to sentence case.\n * 3. Known stable types in {@link SENTENCE_CASE_TYPES} converted to sentence case.\n * 4. `undefined` for anything else \u2014 unknown/future types are hidden, not guessed.\n */\nexport function getTokenTypeLabel(\n  parts: AutocompleteSuggestionPart[],\n): string | undefined {\n  for (const { type, suggestion } of parts) {\n    const label = getLabelForPart(type, suggestion);\n    if (label !== undefined) {\n      return label;\n    }\n  }\n  return undefined;\n}\n"],
   "mappings": "AAEA,SAAS,oCAAoC;AAK7C,MAAM,oBAAqD;AAAA,EACzD,OAAO;AAAA,EACP,OAAO;AAAA,EACP,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,mBAAmB;AAAA,EACnB,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,gBAAgB;AAAA,EAChB,wBAAwB;AAAA,EACxB,mCAAmC;AAAA,EACnC,iBAAiB;AAAA,EACjB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,KAAK;AACP;AAMA,MAAM,sBAA2C,oBAAI,IAAI;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,MAAM,kBAA0C;AAAA,EAC9C,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,MAAM;AAAA,EACN,KAAK;AAAA,EACL,MAAM;AAAA,EACN,MAAM;AAAA,EACN,MAAM;AAAA,EACN,KAAK;AAAA,EACL,KAAK;AAAA,EACL,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,IAAI;AAAA,EACJ,KAAK;AAAA,EACL,KAAK;AACP;AAEA,MAAM,yBAAiD;AAAA,EACrD,KAAK;AACP;AAEA,MAAM,4BAAoD;AAAA,EACxD,KAAK;AAAA,EACL,MAAM;AACR;AAEA,MAAM,mBAA2C;AAAA,EAC/C,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,IAAI;AAAA,EACJ,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAIA,MAAM,oBAAqE;AAAA,EACzE,UAAU;AAAA,EACV,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EACpB,WAAW;AACb;AAEA,SAAS,gBAAgB,MAAc,YAAwC;AAC7E,QAAM,kBAAkB,kBAAkB,IAAI;AAC9C,MAAI,oBAAoB,QAAW;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,kBAAkB,IAAI;AAC/C,MAAI,qBAAqB,QAAW;AAClC,WAAO,iBAAiB,UAAU,KAAK,6BAA6B,IAAI;AAAA,EAC1E;AAEA,SAAO,oBAAoB,IAAI,IAAI,IAC/B,6BAA6B,IAAI,IACjC;AACN;AAcO,SAAS,kBACd,OACoB;AACpB,aAAW,EAAE,MAAM,WAAW,KAAK,OAAO;AACxC,UAAM,QAAQ,gBAAgB,MAAM,UAAU;AAC9C,QAAI,UAAU,QAAW;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;",
   "names": []

package/esm/editors/dql-editor/dql/dql-language.js

@@ -5,9 +5,9 @@ import { EditorView } from "@codemirror/view";
 import { dqlFoldService } from "./dql-fold-service.js";
 import { dqlLinter, toDiagnostics } from "./dql-linter.js";
 import { dql } from "./dql.js";
-import { openAutocomplete } from "./open-autocomplete.js";
-import { createSuggestionAutocompletion } from "./suggestion-autocompletions.js";
-import { suggestionsInfoSectionExtension } from "./suggestions-info-section-extension.js";
+import { openAutocomplete } from "../autocomplete/open-autocomplete.js";
+import { createSuggestionAutocompletion } from "../autocomplete/suggestion-autocompletions.js";
+import { suggestionsInfoSectionExtension } from "../autocomplete/suggestions-info-section-extension.js";
 const VALIDATION_DELAY = 500;
 function getDqlConfig(readOnly, onValidationStart, onValidationEnd, setValidityInfo) {
   const language = StreamLanguage.define(dql);

package/esm/editors/dql-editor/dql/dql-language.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/editors/dql-editor/dql/dql-language.ts"],
-  "sourcesContent": ["import { closeCompletion, startCompletion } from '@codemirror/autocomplete';\nimport { StreamLanguage } from '@codemirror/language';\nimport { linter, setDiagnostics } from '@codemirror/lint';\nimport { EditorView } from '@codemirror/view';\n\nimport { EditorLanguageConfiguration } from '../../base-code-editor/configuration/configuration.js';\nimport type { DQLEditorValidityInfo } from '../dql-editor-types.js';\nimport { dqlFoldService } from './dql-fold-service.js';\nimport { dqlLinter, toDiagnostics } from './dql-linter.js';\nimport { dql } from './dql.js';\nimport type { SuggestionCache } from './get-suggestions.js';\nimport { openAutocomplete } from './open-autocomplete.js';\nimport { createSuggestionAutocompletion } from './suggestion-autocompletions.js';\nimport { suggestionsInfoSectionExtension } from './suggestions-info-section-extension.js';\n\nconst VALIDATION_DELAY = 500;\n\n/**\n * @internal\n * Gets editor configuration for DQL.\n **/\nexport function getDqlConfig(\n  readOnly: boolean,\n  onValidationStart?: () => void,\n  onValidationEnd?: (validityInfo: DQLEditorValidityInfo[]) => void,\n  setValidityInfo?: (validityInfo: DQLEditorValidityInfo[]) => void,\n): EditorLanguageConfiguration {\n  const language = StreamLanguage.define(dql);\n\n  // Suggestion cache scoped to this config (and therefore to the editor\n  // instance that created it). It is discarded when the editor unmounts, so\n  // cached suggestions never outlive the editor or leak between editors.\n  const suggestionCache: SuggestionCache = new Map();\n\n  return {\n    language,\n    extendWith: [\n      dqlFoldService,\n      language.data.of({\n        commentTokens: {\n          block: {\n            open: '/*',\n            close: '*/',\n          },\n          line: '//',\n        },\n        closeBrackets: {\n          brackets: ['(', '[', '{', '\"'],\n          before: ')]}:;>|',\n          stringPrefixes: [],\n        },\n      }),\n      EditorView.domEventObservers({\n        // Clear lint decorations when composition starts. Lint spans in the DOM\n        // corrupt CodeMirror's DOM reconciliation during IME / dead-key composition.\n        // The linter re-runs automatically after composition ends since the\n        // composed character is a document change.\n        compositionstart: (_event, view) => {\n          closeCompletion(view);\n          view.dispatch(setDiagnostics(view.state, []));\n        },\n      }),\n      linter(\n        async (view) => {\n          const editorContent = view.state.doc.toString();\n\n          const validityResult = await dqlLinter(\n            editorContent,\n            onValidationStart,\n            onValidationEnd,\n          );\n\n          if (view.composing) {\n            return [];\n          }\n\n          setValidityInfo?.(validityResult);\n          return toDiagnostics(validityResult);\n        },\n        {\n          delay: VALIDATION_DELAY,\n        },\n      ),\n      EditorView.updateListener.of((update) => {\n        const isTyping =\n          update.docChanged &&\n          update.transactions.some((transaction) =>\n            transaction.isUserEvent('input.type'),\n          );\n\n        const isDeleting =\n          update.docChanged &&\n          update.transactions.some((transaction) =>\n            transaction.isUserEvent('delete.backward'),\n          );\n\n        const isFocused = update.focusChanged && update.view.hasFocus;\n\n        if (!(isTyping || isDeleting || isFocused)) {\n          return;\n        }\n\n        if (update.view.composing) {\n          return;\n        }\n\n        void openAutocomplete(\n          {\n            isTyping,\n            isDeleting,\n            isFocused,\n          },\n          update.state,\n        ).then((shouldComplete) => {\n          if (shouldComplete) {\n            startCompletion(update.view);\n          }\n        });\n      }),\n      ...(readOnly ? [] : [suggestionsInfoSectionExtension]),\n    ],\n    autocompleteOptions: readOnly\n      ? undefined\n      : {\n          activateOnTyping: false,\n          optionClass: (completion) =>\n            completion.label.length === 0 ? 'cm-empty-option' : '',\n          providers: [createSuggestionAutocompletion(suggestionCache)],\n        },\n  };\n}\n"],
+  "sourcesContent": ["import { closeCompletion, startCompletion } from '@codemirror/autocomplete';\nimport { StreamLanguage } from '@codemirror/language';\nimport { linter, setDiagnostics } from '@codemirror/lint';\nimport { EditorView } from '@codemirror/view';\n\nimport { EditorLanguageConfiguration } from '../../base-code-editor/configuration/configuration.js';\nimport type { DQLEditorValidityInfo } from '../dql-editor-types.js';\nimport { dqlFoldService } from './dql-fold-service.js';\nimport { dqlLinter, toDiagnostics } from './dql-linter.js';\nimport { dql } from './dql.js';\nimport type { SuggestionCache } from '../autocomplete/get-suggestions.js';\nimport { openAutocomplete } from '../autocomplete/open-autocomplete.js';\nimport { createSuggestionAutocompletion } from '../autocomplete/suggestion-autocompletions.js';\nimport { suggestionsInfoSectionExtension } from '../autocomplete/suggestions-info-section-extension.js';\n\nconst VALIDATION_DELAY = 500;\n\n/**\n * @internal\n * Gets editor configuration for DQL.\n **/\nexport function getDqlConfig(\n  readOnly: boolean,\n  onValidationStart?: () => void,\n  onValidationEnd?: (validityInfo: DQLEditorValidityInfo[]) => void,\n  setValidityInfo?: (validityInfo: DQLEditorValidityInfo[]) => void,\n): EditorLanguageConfiguration {\n  const language = StreamLanguage.define(dql);\n\n  // Suggestion cache scoped to this config (and therefore to the editor\n  // instance that created it). It is discarded when the editor unmounts, so\n  // cached suggestions never outlive the editor or leak between editors.\n  const suggestionCache: SuggestionCache = new Map();\n\n  return {\n    language,\n    extendWith: [\n      dqlFoldService,\n      language.data.of({\n        commentTokens: {\n          block: {\n            open: '/*',\n            close: '*/',\n          },\n          line: '//',\n        },\n        closeBrackets: {\n          brackets: ['(', '[', '{', '\"'],\n          before: ')]}:;>|',\n          stringPrefixes: [],\n        },\n      }),\n      EditorView.domEventObservers({\n        // Clear lint decorations when composition starts. Lint spans in the DOM\n        // corrupt CodeMirror's DOM reconciliation during IME / dead-key composition.\n        // The linter re-runs automatically after composition ends since the\n        // composed character is a document change.\n        compositionstart: (_event, view) => {\n          closeCompletion(view);\n          view.dispatch(setDiagnostics(view.state, []));\n        },\n      }),\n      linter(\n        async (view) => {\n          const editorContent = view.state.doc.toString();\n\n          const validityResult = await dqlLinter(\n            editorContent,\n            onValidationStart,\n            onValidationEnd,\n          );\n\n          if (view.composing) {\n            return [];\n          }\n\n          setValidityInfo?.(validityResult);\n          return toDiagnostics(validityResult);\n        },\n        {\n          delay: VALIDATION_DELAY,\n        },\n      ),\n      EditorView.updateListener.of((update) => {\n        const isTyping =\n          update.docChanged &&\n          update.transactions.some((transaction) =>\n            transaction.isUserEvent('input.type'),\n          );\n\n        const isDeleting =\n          update.docChanged &&\n          update.transactions.some((transaction) =>\n            transaction.isUserEvent('delete.backward'),\n          );\n\n        const isFocused = update.focusChanged && update.view.hasFocus;\n\n        if (!(isTyping || isDeleting || isFocused)) {\n          return;\n        }\n\n        if (update.view.composing) {\n          return;\n        }\n\n        void openAutocomplete(\n          {\n            isTyping,\n            isDeleting,\n            isFocused,\n          },\n          update.state,\n        ).then((shouldComplete) => {\n          if (shouldComplete) {\n            startCompletion(update.view);\n          }\n        });\n      }),\n      ...(readOnly ? [] : [suggestionsInfoSectionExtension]),\n    ],\n    autocompleteOptions: readOnly\n      ? undefined\n      : {\n          activateOnTyping: false,\n          optionClass: (completion) =>\n            completion.label.length === 0 ? 'cm-empty-option' : '',\n          providers: [createSuggestionAutocompletion(suggestionCache)],\n        },\n  };\n}\n"],
   "mappings": "AAAA,SAAS,iBAAiB,uBAAuB;AACjD,SAAS,sBAAsB;AAC/B,SAAS,QAAQ,sBAAsB;AACvC,SAAS,kBAAkB;AAI3B,SAAS,sBAAsB;AAC/B,SAAS,WAAW,qBAAqB;AACzC,SAAS,WAAW;AAEpB,SAAS,wBAAwB;AACjC,SAAS,sCAAsC;AAC/C,SAAS,uCAAuC;AAEhD,MAAM,mBAAmB;AAMlB,SAAS,aACd,UACA,mBACA,iBACA,iBAC6B;AAC7B,QAAM,WAAW,eAAe,OAAO,GAAG;AAK1C,QAAM,kBAAmC,oBAAI,IAAI;AAEjD,SAAO;AAAA,IACL;AAAA,IACA,YAAY;AAAA,MACV;AAAA,MACA,SAAS,KAAK,GAAG;AAAA,QACf,eAAe;AAAA,UACb,OAAO;AAAA,YACL,MAAM;AAAA,YACN,OAAO;AAAA,UACT;AAAA,UACA,MAAM;AAAA,QACR;AAAA,QACA,eAAe;AAAA,UACb,UAAU,CAAC,KAAK,KAAK,KAAK,GAAG;AAAA,UAC7B,QAAQ;AAAA,UACR,gBAAgB,CAAC;AAAA,QACnB;AAAA,MACF,CAAC;AAAA,MACD,WAAW,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA,QAK3B,kBAAkB,CAAC,QAAQ,SAAS;AAClC,0BAAgB,IAAI;AACpB,eAAK,SAAS,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC;AAAA,QAC9C;AAAA,MACF,CAAC;AAAA,MACD;AAAA,QACE,OAAO,SAAS;AACd,gBAAM,gBAAgB,KAAK,MAAM,IAAI,SAAS;AAE9C,gBAAM,iBAAiB,MAAM;AAAA,YAC3B;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAEA,cAAI,KAAK,WAAW;AAClB,mBAAO,CAAC;AAAA,UACV;AAEA,4BAAkB,cAAc;AAChC,iBAAO,cAAc,cAAc;AAAA,QACrC;AAAA,QACA;AAAA,UACE,OAAO;AAAA,QACT;AAAA,MACF;AAAA,MACA,WAAW,eAAe,GAAG,CAAC,WAAW;AACvC,cAAM,WACJ,OAAO,cACP,OAAO,aAAa;AAAA,UAAK,CAAC,gBACxB,YAAY,YAAY,YAAY;AAAA,QACtC;AAEF,cAAM,aACJ,OAAO,cACP,OAAO,aAAa;AAAA,UAAK,CAAC,gBACxB,YAAY,YAAY,iBAAiB;AAAA,QAC3C;AAEF,cAAM,YAAY,OAAO,gBAAgB,OAAO,KAAK;AAErD,YAAI,EAAE,YAAY,cAAc,YAAY;AAC1C;AAAA,QACF;AAEA,YAAI,OAAO,KAAK,WAAW;AACzB;AAAA,QACF;AAEA,aAAK;AAAA,UACH;AAAA,YACE;AAAA,YACA;AAAA,YACA;AAAA,UACF;AAAA,UACA,OAAO;AAAA,QACT,EAAE,KAAK,CAAC,mBAAmB;AACzB,cAAI,gBAAgB;AAClB,4BAAgB,OAAO,IAAI;AAAA,UAC7B;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAAA,MACD,GAAI,WAAW,CAAC,IAAI,CAAC,+BAA+B;AAAA,IACtD;AAAA,IACA,qBAAqB,WACjB,SACA;AAAA,MACE,kBAAkB;AAAA,MAClB,aAAa,CAAC,eACZ,WAAW,MAAM,WAAW,IAAI,oBAAoB;AAAA,MACtD,WAAW,CAAC,+BAA+B,eAAe,CAAC;AAAA,IAC7D;AAAA,EACN;AACF;",
   "names": []
 }