@scalar/api-client 2.38.3 → 2.39.0

package/dist/v2/features/editor/helpers/yaml/get-yaml-node-range-from-path.js

@@ -0,0 +1,70 @@
+import { isMap, isPair, isScalar, isSeq, parseDocument } from "yaml";
+//#region src/v2/features/editor/helpers/yaml/get-yaml-node-range-from-path.ts
+var isValidYamlRange = (range) => Array.isArray(range) && typeof range[0] === "number" && typeof range[1] === "number";
+var safeParseDocument = (yamlText) => {
+	try {
+		return parseDocument(yamlText);
+	} catch {
+		return null;
+	}
+};
+/**
+* Finds the byte range (offset) in the YAML text corresponding to a JSON path.
+* Given a YAML string and a path (array of segments), parses the document and walks
+* down the tree to find the target node or key, returning its start and end offsets.
+* Will prefer to highlight the "key" part for map entries, to avoid highlighting the value which
+* might be offset due to block structure.
+*
+* @param yamlText The YAML string
+* @param path An array representing the path to traverse
+* @returns The byte offsets in the YAML string of the node (or null if not found)
+*/
+var getYamlNodeRangeFromPath = (yamlText, path) => {
+	const doc = safeParseDocument(yamlText);
+	if (!doc) return null;
+	let current = doc.contents;
+	let lastPair = null;
+	for (const segment of path) {
+		if (isMap(current)) {
+			const key = String(segment);
+			const pair = current.items.find((p) => {
+				if (!isPair(p)) return false;
+				const pairKey = p.key;
+				return isScalar(pairKey) ? String(pairKey.value) === key : String(pairKey) === key;
+			});
+			if (!pair || !isPair(pair)) return null;
+			lastPair = pair;
+			current = pair.value;
+			continue;
+		}
+		if (isSeq(current)) {
+			const index = typeof segment === "number" ? segment : Number.parseInt(String(segment), 10);
+			if (!Number.isFinite(index) || index < 0 || index >= current.items.length) return null;
+			lastPair = null;
+			current = current.items[index];
+			continue;
+		}
+		return null;
+	}
+	if (lastPair && isPair(lastPair)) {
+		const keyRange = lastPair.key?.range;
+		const valueRange = lastPair.value?.range;
+		if (!isValidYamlRange(keyRange)) return null;
+		const startOffset = Math.max(0, keyRange[0]);
+		return {
+			startOffset,
+			endOffset: isValidYamlRange(valueRange) ? Math.max(startOffset, valueRange[1]) : Math.max(startOffset, keyRange[1])
+		};
+	}
+	const nodeRange = current?.range;
+	if (!isValidYamlRange(nodeRange)) return null;
+	const startOffset = Math.max(0, nodeRange[0]);
+	return {
+		startOffset,
+		endOffset: Math.max(startOffset, nodeRange[1])
+	};
+};
+//#endregion
+export { getYamlNodeRangeFromPath };
+
+//# sourceMappingURL=get-yaml-node-range-from-path.js.map

package/dist/v2/features/editor/helpers/yaml/get-yaml-node-range-from-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-yaml-node-range-from-path.js","names":[],"sources":["../../../../../../src/v2/features/editor/helpers/yaml/get-yaml-node-range-from-path.ts"],"sourcesContent":["import { isMap, isPair, isScalar, isSeq, parseDocument } from 'yaml'\n\nimport type { Path } from '@/v2/features/editor/helpers/model'\n\ntype YamlNodeRange = {\n  startOffset: number\n  endOffset: number\n}\n\nconst isValidYamlRange = (range: unknown): range is readonly [number, number, ...unknown[]] =>\n  Array.isArray(range) && typeof range[0] === 'number' && typeof range[1] === 'number'\n\nconst safeParseDocument = (yamlText: string) => {\n  try {\n    return parseDocument(yamlText)\n  } catch {\n    return null\n  }\n}\n\n/**\n * Finds the byte range (offset) in the YAML text corresponding to a JSON path.\n * Given a YAML string and a path (array of segments), parses the document and walks\n * down the tree to find the target node or key, returning its start and end offsets.\n * Will prefer to highlight the \"key\" part for map entries, to avoid highlighting the value which\n * might be offset due to block structure.\n *\n * @param yamlText The YAML string\n * @param path An array representing the path to traverse\n * @returns The byte offsets in the YAML string of the node (or null if not found)\n */\nexport const getYamlNodeRangeFromPath = (yamlText: string, path: Path): YamlNodeRange | null => {\n  const doc = safeParseDocument(yamlText)\n  if (!doc) {\n    return null\n  }\n\n  let current: unknown = doc.contents\n  let lastPair: unknown = null\n\n  // Traverse the path, descending through maps and sequences as needed.\n  for (const segment of path) {\n    if (isMap(current)) {\n      const key = String(segment)\n      const pair = current.items.find((p) => {\n        if (!isPair(p)) {\n          return false\n        }\n        const pairKey = p.key\n        return isScalar(pairKey) ? String(pairKey.value) === key : String(pairKey) === key\n      })\n\n      if (!pair || !isPair(pair)) {\n        // Path segment does not exist in this map\n        return null\n      }\n\n      lastPair = pair\n      current = pair.value\n      continue\n    }\n\n    if (isSeq(current)) {\n      // Ensure we have a valid integer index for arrays\n      const index = typeof segment === 'number' ? segment : Number.parseInt(String(segment), 10)\n      if (!Number.isFinite(index) || index < 0 || index >= current.items.length) {\n        return null\n      }\n\n      lastPair = null\n      current = current.items[index]\n      continue\n    }\n\n    // If current isn't traversable\n    return null\n  }\n\n  // Prefer highlighting the key line for map entries (avoids being off-by-one line for block values).\n  if (lastPair && isPair(lastPair)) {\n    const keyRange = (lastPair.key as { range?: unknown } | null)?.range\n    const valueRange = (lastPair.value as { range?: unknown } | null)?.range\n\n    if (!isValidYamlRange(keyRange)) {\n      return null\n    }\n\n    const startOffset = Math.max(0, keyRange[0])\n    const endOffset = isValidYamlRange(valueRange)\n      ? Math.max(startOffset, valueRange[1])\n      : Math.max(startOffset, keyRange[1])\n\n    return { startOffset, endOffset }\n  }\n\n  // For non-map entries, just use the node's own range property if it exists.\n  const nodeRange = (current as { range?: unknown } | null)?.range\n  if (!isValidYamlRange(nodeRange)) {\n    return null\n  }\n\n  const startOffset = Math.max(0, nodeRange[0])\n  const endOffset = Math.max(startOffset, nodeRange[1])\n\n  return { startOffset, endOffset }\n}\n"],"mappings":";;AASA,IAAM,oBAAoB,UACxB,MAAM,QAAQ,MAAM,IAAI,OAAO,MAAM,OAAO,YAAY,OAAO,MAAM,OAAO;AAE9E,IAAM,qBAAqB,aAAqB;AAC9C,KAAI;AACF,SAAO,cAAc,SAAS;SACxB;AACN,SAAO;;;;;;;;;;;;;;AAeX,IAAa,4BAA4B,UAAkB,SAAqC;CAC9F,MAAM,MAAM,kBAAkB,SAAS;AACvC,KAAI,CAAC,IACH,QAAO;CAGT,IAAI,UAAmB,IAAI;CAC3B,IAAI,WAAoB;AAGxB,MAAK,MAAM,WAAW,MAAM;AAC1B,MAAI,MAAM,QAAQ,EAAE;GAClB,MAAM,MAAM,OAAO,QAAQ;GAC3B,MAAM,OAAO,QAAQ,MAAM,MAAM,MAAM;AACrC,QAAI,CAAC,OAAO,EAAE,CACZ,QAAO;IAET,MAAM,UAAU,EAAE;AAClB,WAAO,SAAS,QAAQ,GAAG,OAAO,QAAQ,MAAM,KAAK,MAAM,OAAO,QAAQ,KAAK;KAC/E;AAEF,OAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,CAExB,QAAO;AAGT,cAAW;AACX,aAAU,KAAK;AACf;;AAGF,MAAI,MAAM,QAAQ,EAAE;GAElB,MAAM,QAAQ,OAAO,YAAY,WAAW,UAAU,OAAO,SAAS,OAAO,QAAQ,EAAE,GAAG;AAC1F,OAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,MAAM,OACjE,QAAO;AAGT,cAAW;AACX,aAAU,QAAQ,MAAM;AACxB;;AAIF,SAAO;;AAIT,KAAI,YAAY,OAAO,SAAS,EAAE;EAChC,MAAM,WAAY,SAAS,KAAoC;EAC/D,MAAM,aAAc,SAAS,OAAsC;AAEnE,MAAI,CAAC,iBAAiB,SAAS,CAC7B,QAAO;EAGT,MAAM,cAAc,KAAK,IAAI,GAAG,SAAS,GAAG;AAK5C,SAAO;GAAE;GAAa,WAJJ,iBAAiB,WAAW,GAC1C,KAAK,IAAI,aAAa,WAAW,GAAG,GACpC,KAAK,IAAI,aAAa,SAAS,GAAG;GAEL;;CAInC,MAAM,YAAa,SAAwC;AAC3D,KAAI,CAAC,iBAAiB,UAAU,CAC9B,QAAO;CAGT,MAAM,cAAc,KAAK,IAAI,GAAG,UAAU,GAAG;AAG7C,QAAO;EAAE;EAAa,WAFJ,KAAK,IAAI,aAAa,UAAU,GAAG;EAEpB"}

package/dist/v2/features/editor/hooks/use-editor-markers.js

@@ -0,0 +1,37 @@
+import { onBeforeUnmount, onMounted, ref, toValue, watch } from "vue";
+import * as monaco from "monaco-editor/esm/vs/editor/editor.api.js";
+//#region src/v2/features/editor/hooks/use-editor-markers.ts
+var useEditorMarkers = (editorRef) => {
+	const markers = ref([]);
+	let dispose = null;
+	const retryTimeouts = [];
+	const updateMarkers = () => {
+		const resource = toValue(editorRef)?.getModel()?.uri;
+		if (!resource) {
+			markers.value = [];
+			return;
+		}
+		markers.value = monaco.editor.getModelMarkers({}).filter((marker) => marker.resource.toString() === resource.toString());
+	};
+	const scheduleMarkerReads = () => {
+		retryTimeouts.push(setTimeout(updateMarkers, 0), setTimeout(updateMarkers, 80), setTimeout(updateMarkers, 220));
+	};
+	onMounted(() => {
+		dispose = monaco.editor.onDidChangeMarkers(() => {
+			scheduleMarkerReads();
+		});
+		scheduleMarkerReads();
+	});
+	onBeforeUnmount(() => {
+		dispose?.dispose();
+		retryTimeouts.forEach((timeout) => clearTimeout(timeout));
+	});
+	watch(() => toValue(editorRef)?.getModel()?.uri?.toString(), () => {
+		scheduleMarkerReads();
+	}, { immediate: true });
+	return { markers };
+};
+//#endregion
+export { useEditorMarkers };
+
+//# sourceMappingURL=use-editor-markers.js.map

package/dist/v2/features/editor/hooks/use-editor-markers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-markers.js","names":[],"sources":["../../../../../src/v2/features/editor/hooks/use-editor-markers.ts"],"sourcesContent":["import * as monaco from 'monaco-editor/esm/vs/editor/editor.api.js'\nimport { type MaybeRefOrGetter, onBeforeUnmount, onMounted, ref, toValue, watch } from 'vue'\n\nexport const useEditorMarkers = (editorRef: MaybeRefOrGetter<monaco.editor.IStandaloneCodeEditor | undefined>) => {\n  const markers = ref<monaco.editor.IMarker[]>([])\n\n  let dispose: monaco.IDisposable | null = null\n  const retryTimeouts: ReturnType<typeof setTimeout>[] = []\n\n  const updateMarkers = () => {\n    const editor = toValue(editorRef)\n    const resource = editor?.getModel()?.uri\n\n    if (!resource) {\n      markers.value = []\n      return\n    }\n\n    markers.value = monaco.editor\n      .getModelMarkers({})\n      .filter((marker) => marker.resource.toString() === resource.toString())\n  }\n\n  const scheduleMarkerReads = () => {\n    retryTimeouts.push(setTimeout(updateMarkers, 0), setTimeout(updateMarkers, 80), setTimeout(updateMarkers, 220))\n  }\n\n  onMounted(() => {\n    dispose = monaco.editor.onDidChangeMarkers(() => {\n      scheduleMarkerReads()\n    })\n\n    // initial fetch\n    scheduleMarkerReads()\n  })\n\n  onBeforeUnmount(() => {\n    dispose?.dispose()\n    retryTimeouts.forEach((timeout) => clearTimeout(timeout))\n  })\n\n  watch(\n    () => toValue(editorRef)?.getModel()?.uri?.toString(),\n    () => {\n      scheduleMarkerReads()\n    },\n    { immediate: true },\n  )\n\n  return {\n    markers,\n  }\n}\n"],"mappings":";;;AAGA,IAAa,oBAAoB,cAAiF;CAChH,MAAM,UAAU,IAA6B,EAAE,CAAC;CAEhD,IAAI,UAAqC;CACzC,MAAM,gBAAiD,EAAE;CAEzD,MAAM,sBAAsB;EAE1B,MAAM,WADS,QAAQ,UAAU,EACR,UAAU,EAAE;AAErC,MAAI,CAAC,UAAU;AACb,WAAQ,QAAQ,EAAE;AAClB;;AAGF,UAAQ,QAAQ,OAAO,OACpB,gBAAgB,EAAE,CAAC,CACnB,QAAQ,WAAW,OAAO,SAAS,UAAU,KAAK,SAAS,UAAU,CAAC;;CAG3E,MAAM,4BAA4B;AAChC,gBAAc,KAAK,WAAW,eAAe,EAAE,EAAE,WAAW,eAAe,GAAG,EAAE,WAAW,eAAe,IAAI,CAAC;;AAGjH,iBAAgB;AACd,YAAU,OAAO,OAAO,yBAAyB;AAC/C,wBAAqB;IACrB;AAGF,uBAAqB;GACrB;AAEF,uBAAsB;AACpB,WAAS,SAAS;AAClB,gBAAc,SAAS,YAAY,aAAa,QAAQ,CAAC;GACzD;AAEF,aACQ,QAAQ,UAAU,EAAE,UAAU,EAAE,KAAK,UAAU,QAC/C;AACJ,uBAAqB;IAEvB,EAAE,WAAW,MAAM,CACpB;AAED,QAAO,EACL,SACD"}

package/dist/v2/features/editor/hooks/use-editor.d.ts

@@ -1,6 +1,6 @@
 import * as monaco from 'monaco-editor';
 import { type MaybeRefOrGetter } from 'vue';
-import type { EditorModel, Path } from '@/v2/features/editor/helpers/model';
+import type { EditorModel, Path } from '../../../../v2/features/editor/helpers/model';
 type MonacoEditorAction = {
     id: string;
     label: string;

package/dist/v2/features/editor/hooks/use-editor.js

@@ -0,0 +1,133 @@
+import { toValue, watch } from "vue";
+import * as monaco from "monaco-editor";
+//#region src/v2/features/editor/hooks/use-editor.ts
+var HIGHLIGHT_DECORATION_CLASS = "json-focus-highlight";
+/**
+* Creates and manages a Monaco editor instance.
+*
+* @param element - The HTML element to mount the editor into.
+* @param onChange - A callback function to handle changes to the editor's value.
+* @param actions - An array of actions to add to the editor.
+* @param readOnly - Whether the editor should be read-only.
+* @param model - The editor model to use.
+* @returns An object containing the editor instance, model, and utility functions.
+*/
+var useEditor = ({ element, onChange, actions, readOnly = false, model }) => {
+	const currentModel = () => toValue(model);
+	const editor = monaco.editor.create(element, {
+		model: currentModel().model,
+		automaticLayout: true,
+		folding: true,
+		showFoldingControls: "always",
+		glyphMargin: true,
+		lineNumbers: "on",
+		minimap: { enabled: false },
+		overviewRulerLanes: 0,
+		readOnly: toValue(readOnly),
+		scrollbar: {
+			useShadows: false,
+			verticalScrollbarSize: 5
+		},
+		scrollBeyondLastLine: false,
+		guides: { indentation: true },
+		formatOnPaste: true,
+		renderValidationDecorations: "on",
+		formatOnType: true,
+		lineHeight: 20,
+		renderLineHighlight: "none",
+		fontFamily: `'JetBrains Mono', monospace`
+	});
+	editor.updateOptions({
+		insertSpaces: true,
+		tabSize: 2
+	});
+	watch(model, (newModel) => {
+		editor.setModel(toValue(newModel).model);
+	});
+	let highlightDecorations = [];
+	let suppressedChangeEvents = 0;
+	actions?.forEach((action) => {
+		editor.addAction({
+			id: action.id,
+			label: action.label,
+			keybindings: action.keybindings,
+			run: async () => {
+				await action.run();
+			}
+		});
+	});
+	const runEditorAction = async (actionId) => {
+		await editor.getAction(actionId)?.run();
+	};
+	/**
+	* Highlights the range at the given path using the model's getRangeFromPath.
+	* Replaces any previous path highlight.
+	*/
+	const highlightPath = async (path) => {
+		const range = await Promise.resolve(currentModel().getRangeFromPath(path));
+		if (!range) return;
+		highlightDecorations = editor.deltaDecorations(highlightDecorations, [{
+			range,
+			options: { className: HIGHLIGHT_DECORATION_CLASS }
+		}]);
+	};
+	/**
+	* Focuses the editor on the range at the given path: folds all, unfolds the target,
+	* reveals it near the top, and highlights it using the model's getRangeFromPath.
+	*/
+	const focusPath = async (path) => {
+		const range = await Promise.resolve(currentModel().getRangeFromPath(path));
+		if (!range) return;
+		const monacoModel = currentModel().model;
+		const unfoldRange = new monaco.Range(range.startLineNumber, 1, range.endLineNumber, monacoModel.getLineMaxColumn(range.endLineNumber));
+		await runEditorAction("editor.foldAll");
+		editor.setSelection(unfoldRange);
+		await runEditorAction("editor.unfoldRecursively");
+		const position = {
+			lineNumber: range.startLineNumber,
+			column: range.startColumn
+		};
+		editor.setPosition(position);
+		editor.revealPositionNearTop(position);
+		await highlightPath(path);
+	};
+	editor.onDidChangeModelContent(() => {
+		if (suppressedChangeEvents > 0) {
+			suppressedChangeEvents -= 1;
+			return;
+		}
+		const newValue = editor.getValue();
+		if (typeof newValue !== "string") return;
+		onChange?.(newValue ?? "");
+	});
+	watch(() => toValue(readOnly), (nextReadOnly) => {
+		editor?.updateOptions({ readOnly: nextReadOnly });
+	});
+	const formatDocument = async () => {
+		await runEditorAction("editor.action.formatDocument");
+	};
+	const getValue = () => editor.getValue();
+	const setValue = (nextValue, isProgrammaticUpdate = false) => {
+		if (isProgrammaticUpdate) suppressedChangeEvents += 1;
+		editor.setValue(nextValue);
+	};
+	const hasTextFocus = () => editor.hasTextFocus();
+	const dispose = () => {
+		editor.dispose();
+	};
+	return {
+		editor,
+		model,
+		highlightPath,
+		focusPath,
+		formatDocument,
+		getValue,
+		setValue,
+		hasTextFocus,
+		dispose
+	};
+};
+//#endregion
+export { useEditor };
+
+//# sourceMappingURL=use-editor.js.map

package/dist/v2/features/editor/hooks/use-editor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor.js","names":[],"sources":["../../../../../src/v2/features/editor/hooks/use-editor.ts"],"sourcesContent":["import * as monaco from 'monaco-editor'\nimport { type MaybeRefOrGetter, toValue, watch } from 'vue'\n\nimport type { EditorModel, Path } from '@/v2/features/editor/helpers/model'\n\nconst HIGHLIGHT_DECORATION_CLASS = 'json-focus-highlight'\n\ntype MonacoEditorAction = {\n  id: string\n  label: string\n  keybindings?: number[]\n  run: () => void | Promise<void>\n}\n\n/**\n * Creates and manages a Monaco editor instance.\n *\n * @param element - The HTML element to mount the editor into.\n * @param onChange - A callback function to handle changes to the editor's value.\n * @param actions - An array of actions to add to the editor.\n * @param readOnly - Whether the editor should be read-only.\n * @param model - The editor model to use.\n * @returns An object containing the editor instance, model, and utility functions.\n */\nexport const useEditor = ({\n  element,\n  onChange,\n  actions,\n  readOnly = false,\n  model,\n}: {\n  element: HTMLElement\n  readOnly?: MaybeRefOrGetter<boolean>\n  onChange?: (e: string) => void\n  actions?: MonacoEditorAction[]\n  /** Editor model provided from outside; must implement EditorModel (model + getRangeFromPath). */\n  model: MaybeRefOrGetter<EditorModel>\n}) => {\n  const currentModel = () => toValue(model)\n\n  const editor = monaco.editor.create(element, {\n    model: currentModel().model,\n    automaticLayout: true,\n    folding: true,\n    showFoldingControls: 'always',\n    glyphMargin: true,\n    lineNumbers: 'on',\n    minimap: { enabled: false },\n    overviewRulerLanes: 0,\n    readOnly: toValue(readOnly),\n    scrollbar: {\n      useShadows: false,\n      verticalScrollbarSize: 5,\n    },\n    scrollBeyondLastLine: false,\n    guides: {\n      indentation: true,\n    },\n    formatOnPaste: true,\n    renderValidationDecorations: 'on',\n    formatOnType: true,\n    lineHeight: 20,\n    renderLineHighlight: 'none',\n    fontFamily: `'JetBrains Mono', monospace`,\n  })\n\n  editor.updateOptions({ insertSpaces: true, tabSize: 2 })\n\n  watch(model, (newModel) => {\n    editor.setModel(toValue(newModel).model)\n  })\n\n  let highlightDecorations: string[] = []\n  let suppressedChangeEvents = 0\n\n  actions?.forEach((action) => {\n    editor.addAction({\n      id: action.id,\n      label: action.label,\n      keybindings: action.keybindings,\n      run: async () => {\n        await action.run()\n      },\n    })\n  })\n\n  const runEditorAction = async (actionId: string): Promise<void> => {\n    await editor.getAction(actionId)?.run()\n  }\n\n  /**\n   * Highlights the range at the given path using the model's getRangeFromPath.\n   * Replaces any previous path highlight.\n   */\n  const highlightPath = async (path: Path): Promise<void> => {\n    const range = await Promise.resolve(currentModel().getRangeFromPath(path))\n    if (!range) {\n      return\n    }\n\n    highlightDecorations = editor.deltaDecorations(highlightDecorations, [\n      {\n        range,\n        options: {\n          className: HIGHLIGHT_DECORATION_CLASS,\n        },\n      },\n    ])\n  }\n\n  /**\n   * Focuses the editor on the range at the given path: folds all, unfolds the target,\n   * reveals it near the top, and highlights it using the model's getRangeFromPath.\n   */\n  const focusPath = async (path: Path): Promise<void> => {\n    const range = await Promise.resolve(currentModel().getRangeFromPath(path))\n    if (!range) {\n      return\n    }\n\n    const monacoModel = currentModel().model\n    const unfoldRange = new monaco.Range(\n      range.startLineNumber,\n      1,\n      range.endLineNumber,\n      monacoModel.getLineMaxColumn(range.endLineNumber),\n    )\n\n    await runEditorAction('editor.foldAll')\n    editor.setSelection(unfoldRange)\n    await runEditorAction('editor.unfoldRecursively')\n\n    const position = { lineNumber: range.startLineNumber, column: range.startColumn }\n    editor.setPosition(position)\n    editor.revealPositionNearTop(position)\n\n    await highlightPath(path)\n  }\n\n  editor.onDidChangeModelContent(() => {\n    if (suppressedChangeEvents > 0) {\n      suppressedChangeEvents -= 1\n      return\n    }\n\n    const newValue = editor.getValue()\n    if (typeof newValue !== 'string') {\n      return\n    }\n\n    onChange?.(newValue ?? '')\n  })\n\n  //--------------------------------------------------\n  // Read Only\n  watch(\n    () => toValue(readOnly),\n    (nextReadOnly) => {\n      editor?.updateOptions({ readOnly: nextReadOnly })\n    },\n  )\n\n  const formatDocument = async (): Promise<void> => {\n    await runEditorAction('editor.action.formatDocument')\n  }\n\n  const getValue = (): string => editor.getValue()\n\n  const setValue = (nextValue: string, isProgrammaticUpdate = false): void => {\n    if (isProgrammaticUpdate) {\n      suppressedChangeEvents += 1\n    }\n\n    editor.setValue(nextValue)\n  }\n\n  const hasTextFocus = (): boolean => editor.hasTextFocus()\n\n  const dispose = (): void => {\n    editor.dispose()\n  }\n\n  return {\n    editor,\n    model,\n    highlightPath,\n    focusPath,\n    formatDocument,\n    getValue,\n    setValue,\n    hasTextFocus,\n    dispose,\n  }\n}\n"],"mappings":";;;AAKA,IAAM,6BAA6B;;;;;;;;;;;AAmBnC,IAAa,aAAa,EACxB,SACA,UACA,SACA,WAAW,OACX,YAQI;CACJ,MAAM,qBAAqB,QAAQ,MAAM;CAEzC,MAAM,SAAS,OAAO,OAAO,OAAO,SAAS;EAC3C,OAAO,cAAc,CAAC;EACtB,iBAAiB;EACjB,SAAS;EACT,qBAAqB;EACrB,aAAa;EACb,aAAa;EACb,SAAS,EAAE,SAAS,OAAO;EAC3B,oBAAoB;EACpB,UAAU,QAAQ,SAAS;EAC3B,WAAW;GACT,YAAY;GACZ,uBAAuB;GACxB;EACD,sBAAsB;EACtB,QAAQ,EACN,aAAa,MACd;EACD,eAAe;EACf,6BAA6B;EAC7B,cAAc;EACd,YAAY;EACZ,qBAAqB;EACrB,YAAY;EACb,CAAC;AAEF,QAAO,cAAc;EAAE,cAAc;EAAM,SAAS;EAAG,CAAC;AAExD,OAAM,QAAQ,aAAa;AACzB,SAAO,SAAS,QAAQ,SAAS,CAAC,MAAM;GACxC;CAEF,IAAI,uBAAiC,EAAE;CACvC,IAAI,yBAAyB;AAE7B,UAAS,SAAS,WAAW;AAC3B,SAAO,UAAU;GACf,IAAI,OAAO;GACX,OAAO,OAAO;GACd,aAAa,OAAO;GACpB,KAAK,YAAY;AACf,UAAM,OAAO,KAAK;;GAErB,CAAC;GACF;CAEF,MAAM,kBAAkB,OAAO,aAAoC;AACjE,QAAM,OAAO,UAAU,SAAS,EAAE,KAAK;;;;;;CAOzC,MAAM,gBAAgB,OAAO,SAA8B;EACzD,MAAM,QAAQ,MAAM,QAAQ,QAAQ,cAAc,CAAC,iBAAiB,KAAK,CAAC;AAC1E,MAAI,CAAC,MACH;AAGF,yBAAuB,OAAO,iBAAiB,sBAAsB,CACnE;GACE;GACA,SAAS,EACP,WAAW,4BACZ;GACF,CACF,CAAC;;;;;;CAOJ,MAAM,YAAY,OAAO,SAA8B;EACrD,MAAM,QAAQ,MAAM,QAAQ,QAAQ,cAAc,CAAC,iBAAiB,KAAK,CAAC;AAC1E,MAAI,CAAC,MACH;EAGF,MAAM,cAAc,cAAc,CAAC;EACnC,MAAM,cAAc,IAAI,OAAO,MAC7B,MAAM,iBACN,GACA,MAAM,eACN,YAAY,iBAAiB,MAAM,cAAc,CAClD;AAED,QAAM,gBAAgB,iBAAiB;AACvC,SAAO,aAAa,YAAY;AAChC,QAAM,gBAAgB,2BAA2B;EAEjD,MAAM,WAAW;GAAE,YAAY,MAAM;GAAiB,QAAQ,MAAM;GAAa;AACjF,SAAO,YAAY,SAAS;AAC5B,SAAO,sBAAsB,SAAS;AAEtC,QAAM,cAAc,KAAK;;AAG3B,QAAO,8BAA8B;AACnC,MAAI,yBAAyB,GAAG;AAC9B,6BAA0B;AAC1B;;EAGF,MAAM,WAAW,OAAO,UAAU;AAClC,MAAI,OAAO,aAAa,SACtB;AAGF,aAAW,YAAY,GAAG;GAC1B;AAIF,aACQ,QAAQ,SAAS,GACtB,iBAAiB;AAChB,UAAQ,cAAc,EAAE,UAAU,cAAc,CAAC;GAEpD;CAED,MAAM,iBAAiB,YAA2B;AAChD,QAAM,gBAAgB,+BAA+B;;CAGvD,MAAM,iBAAyB,OAAO,UAAU;CAEhD,MAAM,YAAY,WAAmB,uBAAuB,UAAgB;AAC1E,MAAI,qBACF,2BAA0B;AAG5B,SAAO,SAAS,UAAU;;CAG5B,MAAM,qBAA8B,OAAO,cAAc;CAEzD,MAAM,gBAAsB;AAC1B,SAAO,SAAS;;AAGlB,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD"}

package/dist/v2/features/editor/hooks/use-json-pointer-link-support.d.ts

@@ -1,5 +1,5 @@
 import { type MaybeRefOrGetter } from 'vue';
-import type { EditorModel } from '@/v2/features/editor/helpers/model';
+import type { EditorModel } from '../../../../v2/features/editor/helpers/model';
 type EditorNavigationApi = {
     focusPath: (path: string[]) => Promise<void>;
 };

package/dist/v2/features/editor/hooks/use-json-pointer-link-support.js

@@ -0,0 +1,45 @@
+import { parseJsonPointerPath } from "../helpers/json/json-pointer-path.js";
+import { ensureJsonPointerLinkSupport } from "../helpers/json/json-pointer-links.js";
+import { onScopeDispose, toValue, watch } from "vue";
+//#region src/v2/features/editor/hooks/use-json-pointer-link-support.ts
+var JSON_LANGUAGE_ID = "json";
+/**
+* Enables clickable JSON Pointer links when the editor model is JSON.
+* Relates link support to the current model and uses the provided editor API to navigate.
+*
+* Call this hook with the return value of useEditor (or a ref to it) and the same model
+* passed to useEditor. When the model's language is JSON, links like "#/paths/..." in
+* string values become clickable and trigger focusPath on the editor.
+*/
+var useJsonPointerLinkSupport = (editorApi, model) => {
+	let disposeLinkSupport = null;
+	const setupOrDispose = () => {
+		const api = toValue(editorApi);
+		const currentModel = toValue(model);
+		if (disposeLinkSupport) {
+			disposeLinkSupport();
+			disposeLinkSupport = null;
+		}
+		if (!api?.focusPath || !currentModel) return;
+		if (currentModel.model.getLanguageId() !== JSON_LANGUAGE_ID) return;
+		const navigate = async (pointer) => {
+			const path = parseJsonPointerPath(pointer);
+			if (!path) return;
+			await api.focusPath(path.map(String));
+		};
+		disposeLinkSupport = ensureJsonPointerLinkSupport(navigate).dispose;
+	};
+	watch(() => [toValue(editorApi), toValue(model)], () => {
+		setupOrDispose();
+	}, { immediate: true });
+	onScopeDispose(() => {
+		if (disposeLinkSupport) {
+			disposeLinkSupport();
+			disposeLinkSupport = null;
+		}
+	});
+};
+//#endregion
+export { useJsonPointerLinkSupport };
+
+//# sourceMappingURL=use-json-pointer-link-support.js.map

package/dist/v2/features/editor/hooks/use-json-pointer-link-support.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-json-pointer-link-support.js","names":[],"sources":["../../../../../src/v2/features/editor/hooks/use-json-pointer-link-support.ts"],"sourcesContent":["import { type MaybeRefOrGetter, onScopeDispose, toValue, watch } from 'vue'\n\nimport { ensureJsonPointerLinkSupport } from '@/v2/features/editor/helpers/json/json-pointer-links'\nimport { parseJsonPointerPath } from '@/v2/features/editor/helpers/json/json-pointer-path'\nimport type { EditorModel } from '@/v2/features/editor/helpers/model'\n\nconst JSON_LANGUAGE_ID = 'json'\n\ntype EditorNavigationApi = {\n  focusPath: (path: string[]) => Promise<void>\n}\n\n/**\n * Enables clickable JSON Pointer links when the editor model is JSON.\n * Relates link support to the current model and uses the provided editor API to navigate.\n *\n * Call this hook with the return value of useEditor (or a ref to it) and the same model\n * passed to useEditor. When the model's language is JSON, links like \"#/paths/...\" in\n * string values become clickable and trigger focusPath on the editor.\n */\nexport const useJsonPointerLinkSupport = (\n  editorApi: MaybeRefOrGetter<EditorNavigationApi | undefined>,\n  model: MaybeRefOrGetter<EditorModel | undefined>,\n): void => {\n  let disposeLinkSupport: (() => void) | null = null\n\n  const setupOrDispose = () => {\n    const api = toValue(editorApi)\n    const currentModel = toValue(model)\n\n    if (disposeLinkSupport) {\n      disposeLinkSupport()\n      disposeLinkSupport = null\n    }\n\n    if (!api?.focusPath || !currentModel) {\n      return\n    }\n\n    const languageId = currentModel.model.getLanguageId()\n    if (languageId !== JSON_LANGUAGE_ID) {\n      return\n    }\n\n    const navigate = async (pointer: string): Promise<void> => {\n      const path = parseJsonPointerPath(pointer)\n      if (!path) {\n        return\n      }\n      await api.focusPath(path.map(String))\n    }\n\n    const result = ensureJsonPointerLinkSupport(navigate)\n    disposeLinkSupport = result.dispose\n  }\n\n  watch(\n    () => [toValue(editorApi), toValue(model)] as const,\n    () => {\n      setupOrDispose()\n    },\n    { immediate: true },\n  )\n\n  onScopeDispose(() => {\n    if (disposeLinkSupport) {\n      disposeLinkSupport()\n      disposeLinkSupport = null\n    }\n  })\n}\n"],"mappings":";;;;AAMA,IAAM,mBAAmB;;;;;;;;;AAczB,IAAa,6BACX,WACA,UACS;CACT,IAAI,qBAA0C;CAE9C,MAAM,uBAAuB;EAC3B,MAAM,MAAM,QAAQ,UAAU;EAC9B,MAAM,eAAe,QAAQ,MAAM;AAEnC,MAAI,oBAAoB;AACtB,uBAAoB;AACpB,wBAAqB;;AAGvB,MAAI,CAAC,KAAK,aAAa,CAAC,aACtB;AAIF,MADmB,aAAa,MAAM,eAAe,KAClC,iBACjB;EAGF,MAAM,WAAW,OAAO,YAAmC;GACzD,MAAM,OAAO,qBAAqB,QAAQ;AAC1C,OAAI,CAAC,KACH;AAEF,SAAM,IAAI,UAAU,KAAK,IAAI,OAAO,CAAC;;AAIvC,uBADe,6BAA6B,SAAS,CACzB;;AAG9B,aACQ,CAAC,QAAQ,UAAU,EAAE,QAAQ,MAAM,CAAC,QACpC;AACJ,kBAAgB;IAElB,EAAE,WAAW,MAAM,CACpB;AAED,sBAAqB;AACnB,MAAI,oBAAoB;AACtB,uBAAoB;AACpB,wBAAqB;;GAEvB"}