Skip to content

armgit / dashy

Public Imported from GitHub
0

πŸš€ A self-hostable personal dashboard built for you. Includes status-checking, widgets, themes, icon packs, a UI editor and tons more!

3.9 KB
Raw Blame
/**
 * Shared YAML + JSON-Schema walkers for the linter and the config tooltip extension
 */
import { isMap, isSeq } from 'yaml';

const decodeToken = (s) => s.replace(/~1/g, '/').replace(/~0/g, '~');

// JSON Pointer (Ajv's instancePath, e.g. "/sections/0/items/2") -> path parts.
export const pointerToPath = (pointer) => (pointer
  ? pointer.split('/').slice(1).map(decodeToken)
  : []);

// Return the source range [start, end] for a specific key's pair inside a map
// (covers both the key and its value). Null if the map or key doesn't exist.
export const pairRange = (map, key) => {
  if (!isMap(map)) return null;
  const pair = map.items.find((p) => {
    const k = p.key && 'value' in p.key ? p.key.value : p.key;
    return String(k) === String(key);
  });
  if (!pair) return null;
  const keyRange = pair.key?.range;
  const valRange = pair.value?.range;
  const start = keyRange?.[0] ?? valRange?.[0];
  const end = valRange?.[2] ?? valRange?.[1] ?? keyRange?.[1];
  return (start != null && end != null) ? [start, end] : null;
};

// Walk a parsed YAML Document by path parts, returning the target Node or null.
export const yamlNodeAt = (root, parts) => {
  let node = root;
  for (const key of parts) {
    if (!node) return null;
    if (isMap(node)) {
      const pair = node.items.find((p) => {
        const k = p.key && 'value' in p.key ? p.key.value : p.key;
        return String(k) === String(key);
      });
      node = pair ? pair.value : null;
    } else if (isSeq(node)) {
      node = node.items[Number(key)] ?? null;
    } else {
      return null;
    }
  }
  return node;
};

// yaml Nodes expose range as [start, valueEnd, nodeEnd]; fall back if shorter.
const nodeEnd = (r) => (r ? (r[2] ?? r[1] ?? r[0]) : -1);
const inside = (r, offset) => !!r && offset >= r[0] && offset <= nodeEnd(r);

// Given a parsed YAML Document and a cursor offset, return the path from
// document root to the smallest containing node (e.g. ['sections', 0, 'url']).
// Returns [] when the cursor isn't inside any addressable node.
export const yamlPathAtOffset = (doc, offset) => {
  const path = [];
  let node = doc?.contents ?? null;

  while (node) {
    if (isMap(node)) {
      const pair = node.items.find((p) => inside(p.key?.range, offset) || inside(p.value?.range, offset));
      if (!pair) break;
      const keyName = pair.key && 'value' in pair.key ? pair.key.value : pair.key;
      path.push(String(keyName));
      // Cursor on the key but not the value β€” stop here rather than descending.
      if (inside(pair.key?.range, offset) && !inside(pair.value?.range, offset)) break;
      node = pair.value;
    } else if (isSeq(node)) {
      const idx = node.items.findIndex((it) => inside(it?.range, offset));
      if (idx < 0) break;
      path.push(idx);
      node = node.items[idx];
    } else {
      break;
    }
  }
  return path;
};

// Walk a JSON Schema by path parts, resolving `properties`, `items`,
// `patternProperties` and simple `oneOf`/`anyOf`. Returns the sub-schema at
// the path, or null if the schema doesn't describe that location.
export const schemaAt = (schema, parts) => {
  const pickBranch = (s) => {
    if (!s) return s;
    if (Array.isArray(s.oneOf) && s.oneOf.length) return s.oneOf[0];
    if (Array.isArray(s.anyOf) && s.anyOf.length) return s.anyOf[0];
    return s;
  };

  let cur = pickBranch(schema);
  for (const key of parts) {
    if (!cur) return null;
    if (cur.items) {
      cur = pickBranch(cur.items);
    } else if (cur.properties && Object.prototype.hasOwnProperty.call(cur.properties, key)) {
      cur = pickBranch(cur.properties[key]);
    } else if (cur.patternProperties) {
      const entry = Object.entries(cur.patternProperties)
        .find(([pat]) => new RegExp(pat).test(String(key)));
      cur = entry ? pickBranch(entry[1]) : null;
    } else if (cur.additionalProperties && typeof cur.additionalProperties === 'object') {
      cur = pickBranch(cur.additionalProperties);
    } else {
      return null;
    }
  }
  return cur;
};