@scalar/api-client 2.36.0 → 2.36.2

package/dist/v2/features/{collection/components/Editor → editor}/helpers/ensure-monaco-environment.js

@@ -1,23 +1,20 @@
 import o from "monaco-editor/esm/vs/editor/editor.worker.js?worker";
-import n from "monaco-editor/esm/vs/language/json/json.worker.js?worker";
-import t from "./yaml.worker.js";
-const c = () => {
-  const r = {
-    getWorker(m, e) {
-      switch (e) {
+import e from "monaco-editor/esm/vs/language/json/json.worker.js?worker";
+import n from "monaco-yaml/yaml.worker.js?worker";
+const s = () => {
+  globalThis.MonacoEnvironment ??= {
+    getWorker(t, r) {
+      switch (r) {
         case "json":
-          return new n();
+          return new e();
         case "yaml":
-          return new t();
+          return new n();
         default:
           return new o();
       }
     }
   };
-  globalThis.MonacoEnvironment ??= {
-    getWorker: r.getWorker
-  };
 };
 export {
-  c as ensureMonacoEnvironment
+  s as ensureMonacoEnvironment
 };

package/dist/v2/features/editor/helpers/json/create-json-model.d.ts

@@ -0,0 +1,12 @@
+import type { EditorModel } from '../../../../../v2/features/editor/helpers/model';
+/**
+ * Creates a JSON Monaco editor model with enhanced language support.
+ *
+ * @param value - The initial JSON content for the model.
+ * @returns An object containing the Monaco model and a function to get a range from a JSON path.
+ *
+ * The returned `getRangeFromPath` function asynchronously finds the AST node for a JSON path,
+ * converts its offset and length to a Monaco Range, or returns null if not found.
+ */
+export declare const createJsonModel: (value?: string) => EditorModel;
+//# sourceMappingURL=create-json-model.d.ts.map

package/dist/v2/features/editor/helpers/json/create-json-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-json-model.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/json/create-json-model.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,oCAAoC,CAAA;AAI3E;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,WAqBhD,CAAA"}

package/dist/v2/features/editor/helpers/json/create-json-model.js

@@ -0,0 +1,19 @@
+import * as r from "monaco-editor";
+import { getJsonAstNodeFromPath as m } from "./get-json-ast-node-from-path.js";
+import { configureJson as a } from "../configure-language-support.js";
+const u = (s) => {
+  const o = r.editor.createModel(s ?? "", "json");
+  return a(o.uri.toString()), {
+    model: o,
+    getRangeFromPath: async (i) => {
+      const t = await m(o, i);
+      if (!t)
+        return null;
+      const e = o.getPositionAt(t.offset), n = o.getPositionAt(t.offset + t.length);
+      return new r.Range(e.lineNumber, e.column, n.lineNumber, n.column);
+    }
+  };
+};
+export {
+  u as createJsonModel
+};

package/dist/v2/features/editor/helpers/json/get-json-ast-node-from-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-json-ast-node-from-path.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/json/get-json-ast-node-from-path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG1C;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,GACjC,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAC/B,MAAM,QAAQ,KACb,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAW9C,CAAA"}

package/dist/v2/features/editor/helpers/json/json-ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-ast.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/json/json-ast.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,GAAG,SAAS,EAC/C,MAAM,QAAQ,KACb,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,GAAG,SAkClC,CAAA"}

package/dist/v2/features/editor/helpers/json/json-pointer-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer-links.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/json/json-pointer-links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAmEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B,GAAI,UAAU,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;;;CA2E/F,CAAA"}

package/dist/v2/features/editor/helpers/json/json-pointer-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-pointer-path.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/json/json-pointer-path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AA0B1C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,QAAQ,GAAG,IAOjE,CAAA"}

package/dist/v2/features/editor/helpers/json/json-pointer-path.js

@@ -0,0 +1,21 @@
+import { parseJsonPointerSegments as i } from "@scalar/helpers/json/parse-json-pointer-segments";
+const o = (r) => {
+  const t = r.trim();
+  if (t.startsWith("/"))
+    return t;
+  if (t.startsWith("#")) {
+    const s = t.slice(1);
+    return s.startsWith("/") ? s : null;
+  }
+  const n = t.indexOf("#");
+  if (n === -1)
+    return null;
+  const e = t.slice(n + 1);
+  return e.startsWith("/") ? e : null;
+}, c = (r) => {
+  const t = o(r);
+  return t ? i(t) : null;
+};
+export {
+  c as parseJsonPointerPath
+};

package/dist/v2/features/editor/helpers/model.d.ts

@@ -0,0 +1,9 @@
+import type * as monaco from 'monaco-editor';
+type MaybePromise<T> = T | Promise<T>;
+export type Path = readonly (string | number)[];
+export type EditorModel = {
+    model: monaco.editor.ITextModel;
+    getRangeFromPath: (path: Path) => MaybePromise<monaco.Range | null>;
+};
+export {};
+//# sourceMappingURL=model.d.ts.map

package/dist/v2/features/editor/helpers/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/helpers/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAA;AAE5C,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;AAErC,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAA;IAC/B,gBAAgB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,YAAY,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;CACpE,CAAA"}

package/dist/v2/features/editor/helpers/range-to-whole-line.d.ts

@@ -0,0 +1,14 @@
+import * as monaco from 'monaco-editor';
+/**
+ * Expands a given range to cover whole lines within a Monaco editor model.
+ *
+ * Given a text model and an input range, this function calculates the smallest
+ * and largest lines touched by the range and returns a new range that starts at
+ * the beginning of the first touched line and ends at the end of the last touched line.
+ *
+ * @param model The Monaco editor text model.
+ * @param range The Monaco Range to expand.
+ * @returns A new Monaco Range covering the whole lines spanned by the given range.
+ */
+export declare const rangeToWholeLine: (model: monaco.editor.ITextModel, range: monaco.Range) => monaco.Range;
+//# sourceMappingURL=range-to-whole-line.d.ts.map

package/dist/v2/features/editor/helpers/range-to-whole-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-to-whole-line.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/helpers/range-to-whole-line.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,MAAM,CAAC,KAAK,KAAG,MAAM,CAAC,KAS9F,CAAA"}

package/dist/v2/features/editor/helpers/range-to-whole-line.js

@@ -0,0 +1,8 @@
+import * as c from "monaco-editor";
+const g = (t, n) => {
+  const e = t.getOffsetAt(n.getStartPosition()), i = t.getOffsetAt(n.getEndPosition()), a = t.getPositionAt(e), f = Math.max(e, i - 1), r = t.getPositionAt(f), s = Math.max(1, a.lineNumber), o = Math.max(s, r.lineNumber);
+  return new c.Range(s, 1, o, t.getLineMaxColumn(o));
+};
+export {
+  g as rangeToWholeLine
+};

package/dist/v2/features/editor/helpers/theme/apply-scalar-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-scalar-theme.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/theme/apply-scalar-theme.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,GAAU,OAAO,MAAM,EAAE,YAAY,OAAO,kBAwExE,CAAA"}

package/dist/v2/features/editor/helpers/theme/load-css-variables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-css-variables.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/theme/load-css-variables.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAU,KAAK,MAAM;WAIU,GAAG;UAAQ,GAAG;EA2CzE,CAAA"}

package/dist/v2/features/editor/helpers/yaml/create-yaml-model.d.ts

@@ -0,0 +1,13 @@
+import type { EditorModel } from '../../../../../v2/features/editor/helpers/model';
+/**
+ * Creates a YAML model for use in the Monaco editor.
+ *
+ * @param value - The initial YAML string value for the model.
+ * @returns An object containing the Monaco model and a method to get a range from a YAML path.
+ *
+ * The created model is configured for YAML language support.
+ * The `getRangeFromPath` method returns a Monaco Range object indicating the text range
+ * that corresponds to a given path in the YAML document, or null if the path is not found.
+ */
+export declare const createYamlModel: (value?: string) => EditorModel;
+//# sourceMappingURL=create-yaml-model.d.ts.map

package/dist/v2/features/editor/helpers/yaml/create-yaml-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-yaml-model.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/yaml/create-yaml-model.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAQ,MAAM,oCAAoC,CAAA;AAG3E;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,WAoBhD,CAAA"}

package/dist/v2/features/editor/helpers/yaml/create-yaml-model.js

@@ -0,0 +1,19 @@
+import * as n from "monaco-editor";
+import { configureYaml as m } from "../configure-language-support.js";
+import { getYamlNodeRangeFromPath as l } from "./get-yaml-node-range-from-path.js";
+const c = (i) => {
+  const e = n.editor.createModel("", "yaml");
+  return m(e.uri.toString()), {
+    model: e,
+    getRangeFromPath: (a) => {
+      const t = l(e.getValue(), a);
+      if (!t)
+        return null;
+      const o = e.getPositionAt(t.startOffset), r = e.getPositionAt(t.endOffset);
+      return new n.Range(o.lineNumber, o.column, r.lineNumber, r.column);
+    }
+  };
+};
+export {
+  c as createYamlModel
+};

package/dist/v2/features/{collection/components/Editor/helpers → editor/helpers/yaml}/get-yaml-node-range-from-path.d.ts

@@ -1,4 +1,4 @@
-import type { JsonPath } from './json-ast.js';
+import type { Path } from '../../../../../v2/features/editor/helpers/model';
 type YamlNodeRange = {
     startOffset: number;
     endOffset: number;
@@ -14,6 +14,6 @@ type YamlNodeRange = {
  * @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)
  */
-export declare const getYamlNodeRangeFromPath: (yamlText: string, path: JsonPath) => YamlNodeRange | null;
+export declare const getYamlNodeRangeFromPath: (yamlText: string, path: Path) => YamlNodeRange | null;
 export {};
 //# sourceMappingURL=get-yaml-node-range-from-path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-yaml-node-range-from-path.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/features/editor/helpers/yaml/get-yaml-node-range-from-path.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAE9D,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAaD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,MAAM,IAAI,KAAG,aAAa,GAAG,IA0EvF,CAAA"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor-markers.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/hooks/use-editor-markers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,2CAA2C,CAAA;AACnE,OAAO,EAAE,KAAK,gBAAgB,EAAmD,MAAM,KAAK,CAAA;AAE5F,eAAO,MAAM,gBAAgB,GAAI,WAAW,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,GAAG,SAAS,CAAC;;;;;;;;;;;sBAkD0iJ,CAAC;yBAA2B,CAAC;oBAA6B,CAAC;qBAA8B,CAAC;wBAAiC,CAAC;;;;;;;;;;;;;;;;0BAA5H,CAAC;6BAA2B,CAAC;wBAA6B,CAAC;yBAA8B,CAAC;4BAAiC,CAAC;;;;;;;;;;;;;;;;;;;;;;0BAA5H,CAAC;6BAA2B,CAAC;wBAA6B,CAAC;yBAA8B,CAAC;4BAAiC,CAAC;;;;;;;;;;;;;;;;;;;;;;;sBAA5H,CAAC;yBAA2B,CAAC;oBAA6B,CAAC;qBAA8B,CAAC;wBAAiC,CAAC;;;;;;;;;;;;;;;;0BAA5H,CAAC;6BAA2B,CAAC;wBAA6B,CAAC;yBAA8B,CAAC;4BAAiC,CAAC;;;;;;;;;;;;;;;;;;;;;;0BAA5H,CAAC;6BAA2B,CAAC;wBAA6B,CAAC;yBAA8B,CAAC;4BAAiC,CAAC;;;;;;;;;;;;;;CADlxJ,CAAA"}

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

@@ -0,0 +1,39 @@
+import * as monaco from 'monaco-editor';
+import { type MaybeRefOrGetter } from 'vue';
+import type { EditorModel, Path } from '../../../../v2/features/editor/helpers/model';
+type MonacoEditorAction = {
+    id: string;
+    label: string;
+    keybindings?: number[];
+    run: () => void | Promise<void>;
+};
+/**
+ * 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.
+ */
+export declare const useEditor: ({ element, onChange, actions, readOnly, model, }: {
+    element: HTMLElement;
+    readOnly?: MaybeRefOrGetter<boolean>;
+    onChange?: (e: string) => void;
+    actions?: MonacoEditorAction[];
+    /** Editor model provided from outside; must implement EditorModel (model + getRangeFromPath). */
+    model: MaybeRefOrGetter<EditorModel>;
+}) => {
+    editor: monaco.editor.IStandaloneCodeEditor;
+    model: MaybeRefOrGetter<EditorModel>;
+    highlightPath: (path: Path) => Promise<void>;
+    focusPath: (path: Path) => Promise<void>;
+    formatDocument: () => Promise<void>;
+    getValue: () => string;
+    setValue: (nextValue: string, isProgrammaticUpdate?: boolean) => void;
+    hasTextFocus: () => boolean;
+    dispose: () => void;
+};
+export {};
+//# sourceMappingURL=use-editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-editor.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/hooks/use-editor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,KAAK,gBAAgB,EAAkB,MAAM,KAAK,CAAA;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAI3E,KAAK,kBAAkB,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,GAAG,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,GAAI,kDAMvB;IACD,OAAO,EAAE,WAAW,CAAA;IACpB,QAAQ,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAA;IAC9B,iGAAiG;IACjG,KAAK,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;CACrC;;;0BAyDoC,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;sBAoBxB,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC;0BAgDlB,OAAO,CAAC,IAAI,CAAC;oBAIzB,MAAM;0BAEE,MAAM,qCAAiC,IAAI;wBAQ/C,OAAO;mBAEZ,IAAI;CAezB,CAAA"}

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

@@ -0,0 +1,107 @@
+import * as m from "monaco-editor";
+import { toValue as a, watch as g } from "vue";
+const L = "json-focus-highlight", S = ({
+  element: f,
+  onChange: h,
+  actions: p,
+  readOnly: l = !1,
+  model: s
+}) => {
+  const n = () => a(s), t = m.editor.create(f, {
+    model: n().model,
+    automaticLayout: !0,
+    folding: !0,
+    showFoldingControls: "always",
+    glyphMargin: !0,
+    lineNumbers: "on",
+    minimap: { enabled: !1 },
+    overviewRulerLanes: 0,
+    readOnly: a(l),
+    scrollbar: {
+      useShadows: !1,
+      verticalScrollbarSize: 5
+    },
+    scrollBeyondLastLine: !1,
+    guides: {
+      indentation: !0
+    },
+    formatOnPaste: !0,
+    renderValidationDecorations: "on",
+    formatOnType: !0,
+    lineHeight: 20,
+    renderLineHighlight: "none",
+    fontFamily: "'JetBrains Mono', monospace"
+  });
+  t.updateOptions({ insertSpaces: !0, tabSize: 2 }), g(s, (e) => {
+    t.setModel(a(e).model);
+  });
+  let u = [], i = 0;
+  p?.forEach((e) => {
+    t.addAction({
+      id: e.id,
+      label: e.label,
+      keybindings: e.keybindings,
+      run: async () => {
+        await e.run();
+      }
+    });
+  });
+  const r = async (e) => {
+    await t.getAction(e)?.run();
+  }, c = async (e) => {
+    const o = await Promise.resolve(n().getRangeFromPath(e));
+    o && (u = t.deltaDecorations(u, [
+      {
+        range: o,
+        options: {
+          className: L
+        }
+      }
+    ]));
+  }, y = async (e) => {
+    const o = await Promise.resolve(n().getRangeFromPath(e));
+    if (!o)
+      return;
+    const w = n().model, b = new m.Range(
+      o.startLineNumber,
+      1,
+      o.endLineNumber,
+      w.getLineMaxColumn(o.endLineNumber)
+    );
+    await r("editor.foldAll"), t.setSelection(b), await r("editor.unfoldRecursively");
+    const d = { lineNumber: o.startLineNumber, column: o.startColumn };
+    t.setPosition(d), t.revealPositionNearTop(d), await c(e);
+  };
+  return t.onDidChangeModelContent(() => {
+    if (i > 0) {
+      i -= 1;
+      return;
+    }
+    const e = t.getValue();
+    typeof e == "string" && h?.(e ?? "");
+  }), g(
+    () => a(l),
+    (e) => {
+      t?.updateOptions({ readOnly: e });
+    }
+  ), {
+    editor: t,
+    model: s,
+    highlightPath: c,
+    focusPath: y,
+    formatDocument: async () => {
+      await r("editor.action.formatDocument");
+    },
+    getValue: () => t.getValue(),
+    setValue: (e, o = !1) => {
+      o && (i += 1), t.setValue(e);
+    },
+    hasTextFocus: () => t.hasTextFocus(),
+    dispose: () => {
+      t.dispose();
+    }
+  };
+};
+export {
+  S as useEditor
+};

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

@@ -0,0 +1,16 @@
+import { type MaybeRefOrGetter } from 'vue';
+import type { EditorModel } from '../../../../v2/features/editor/helpers/model';
+type EditorNavigationApi = {
+    focusPath: (path: string[]) => Promise<void>;
+};
+/**
+ * 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.
+ */
+export declare const useJsonPointerLinkSupport: (editorApi: MaybeRefOrGetter<EditorNavigationApi | undefined>, model: MaybeRefOrGetter<EditorModel | undefined>) => void;
+export {};
+//# sourceMappingURL=use-json-pointer-link-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-json-pointer-link-support.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/hooks/use-json-pointer-link-support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAkC,MAAM,KAAK,CAAA;AAI3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAIrE,KAAK,mBAAmB,GAAG;IACzB,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7C,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GACpC,WAAW,gBAAgB,CAAC,mBAAmB,GAAG,SAAS,CAAC,EAC5D,OAAO,gBAAgB,CAAC,WAAW,GAAG,SAAS,CAAC,KAC/C,IA+CF,CAAA"}

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

@@ -0,0 +1,27 @@
+import { watch as p, toValue as n, onScopeDispose as c } from "vue";
+import { ensureJsonPointerLinkSupport as l } from "../helpers/json/json-pointer-links.js";
+import { parseJsonPointerPath as f } from "../helpers/json/json-pointer-path.js";
+const g = "json", I = (o, e) => {
+  let t = null;
+  const i = () => {
+    const s = n(o), r = n(e);
+    if (t && (t(), t = null), !s?.focusPath || !r || r.model.getLanguageId() !== g)
+      return;
+    t = l(async (u) => {
+      const a = f(u);
+      a && await s.focusPath(a.map(String));
+    }).dispose;
+  };
+  p(
+    () => [n(o), n(e)],
+    () => {
+      i();
+    },
+    { immediate: !0 }
+  ), c(() => {
+    t && (t(), t = null);
+  });
+};
+export {
+  I as useJsonPointerLinkSupport
+};

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

@@ -0,0 +1,77 @@
+import { type merge } from '@scalar/json-magic/diff';
+import type { ComputedRef } from 'vue';
+import { type MaybeRefOrGetter } from 'vue';
+type UseThreeWayMergeEditorOptions = {
+    /** Base document (common ancestor). */
+    baseDocument: MaybeRefOrGetter<Record<string, unknown>>;
+    /** Document with resolved conflicts (current result). */
+    resolvedDocument: MaybeRefOrGetter<Record<string, unknown>>;
+    /** Merge conflicts from diff. */
+    conflicts: MaybeRefOrGetter<ReturnType<typeof merge>['conflicts']>;
+    /** Called when user applies resolved changes. */
+    onApplyChanges: (resolvedDocument: Record<string, unknown>) => void;
+    /** Optional: called with error message for conflicts left or parse errors. */
+    onError?: (message: string) => void;
+};
+type ThreeWayMergeEditorContainers = {
+    /** Container for the local (current) diff editor. */
+    local: HTMLElement;
+    /** Container for the remote diff editor. */
+    remote: HTMLElement;
+    /** Container for the result (editable) diff editor. */
+    result: HTMLElement;
+};
+/**
+ * Shared state and logic for a 3-way merge editor (base | local | remote → result).
+ * Create editors by calling init() with the three container elements (e.g. from refs in onMounted).
+ * Call dispose() in onUnmounted.
+ *
+ * @example
+ * ```vue
+ * <script setup lang="ts">
+ * const localRef = ref<HTMLDivElement>()
+ * const remoteRef = ref<HTMLDivElement>()
+ * const resultRef = ref<HTMLDivElement>()
+ *
+ * const mergeEditor = useThreeWayMergeEditor({
+ *   baseDocument,
+ *   resolvedDocument,
+ *   conflicts,
+ *   onApplyChanges: (doc) => emit('applyChanges', { resolvedDocument: doc }),
+ *   onError: (msg) => toast(msg, 'error'),
+ * })
+ *
+ * onMounted(() => {
+ *   const local = localRef.value
+ *   const remote = remoteRef.value
+ *   const result = resultRef.value
+ *   if (local && remote && result) {
+ *     mergeEditor.init({ local, remote, result })
+ *   }
+ * })
+ *
+ * onUnmounted(() => {
+ *   mergeEditor.dispose()
+ * })
+ * </script>
+ *
+ * <template>
+ *   <div ref="localRef" />
+ *   <div ref="remoteRef" />
+ *   <div ref="resultRef" />
+ *   <button @click="mergeEditor.goToNextConflict">Next conflict</button>
+ *   <button :disabled="mergeEditor.conflictsLeft > 0" @click="mergeEditor.applyResolvedConflicts">
+ *     Apply ({{ mergeEditor.conflictsLeft }} left)
+ *   </button>
+ * </template>
+ * ```
+ */
+export declare function useThreeWayMergeEditor(options: UseThreeWayMergeEditorOptions): {
+    init: (containers: ThreeWayMergeEditorContainers) => void;
+    dispose: () => void;
+    conflictsLeft: ComputedRef<number>;
+    goToNextConflict: () => void;
+    applyResolvedConflicts: () => void;
+};
+export {};
+//# sourceMappingURL=use-three-way-merge-editor.d.ts.map

package/dist/v2/features/editor/hooks/use-three-way-merge-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-three-way-merge-editor.d.ts","sourceRoot":"","sources":["../../../../../src/v2/features/editor/hooks/use-three-way-merge-editor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AACtC,OAAO,EAAE,KAAK,gBAAgB,EAAsD,MAAM,KAAK,CAAA;AAY/F,KAAK,6BAA6B,GAAG;IACnC,uCAAuC;IACvC,YAAY,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACvD,yDAAyD;IACzD,gBAAgB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,iCAAiC;IACjC,SAAS,EAAE,gBAAgB,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC,CAAA;IAClE,iDAAiD;IACjD,cAAc,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACnE,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC,CAAA;AAED,KAAK,6BAA6B,GAAG;IACnC,qDAAqD;IACrD,KAAK,EAAE,WAAW,CAAA;IAClB,4CAA4C;IAC5C,MAAM,EAAE,WAAW,CAAA;IACnB,uDAAuD;IACvD,MAAM,EAAE,WAAW,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG;IAC9E,IAAI,EAAE,CAAC,UAAU,EAAE,6BAA6B,KAAK,IAAI,CAAA;IACzD,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAClC,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,sBAAsB,EAAE,MAAM,IAAI,CAAA;CACnC,CAydA"}