Function readRefsFromJSON

pkgs/docs/src/json.ts:18–85

(
  config: DateFnsDocs.Config,
  configDir: string,
)

 * @returns parsed function reflections
 */
export async function readRefsFromJSON(
  config: DateFnsDocs.Config,
  configDir: string,
): Promise<DateFnsDocs.Reflection[]> {
  const jsonPath = path.resolve(configDir, config.json);
  const docs = await readDocsJSON(jsonPath);
  const map = typesMap(docs);

  return (
    docs.children?.reduce<DateFnsDocs.Reflection[]>((acc, reflection) => {
      // Use set to avoid duplicates
      const recoveredRefs = new Set<DeclarationReflection>();
      const refMap = typesMap(reflection);

      function recoverRefs(refl: DeclarationReflection) {
        const refs = extractRefs(refl);

        const missingRefs = new Set<number>();
        refs.forEach((id) => {
          if (refMap[id]) return;
          missingRefs.add(id);
        });

        missingRefs.forEach((id) => {
          const missingRef = map[id];
          if (!missingRef) return;

          recoveredRefs.add(missingRef);

          // Update map, to avoid adding types included with the missing ref
          refMap[id] = missingRef;
          Object.assign(refMap, typesMap(missingRef));

          // Recursively recover missing refs
          recoverRefs(missingRef);
        });
      }

      recoverRefs(reflection);

      const completedRef = {
        ...reflection,
        children: [...(reflection.children || []), ...recoveredRefs],
      } as DeclarationReflection;

      const fileName = completedRef.sources?.[0].fileName;
      const refOverrides = (fileName && config.kindsMap[fileName]) || undefined;

      if (refOverrides?.kind === "constants") {
        return acc.concat({
          kind: "constants",
          ref: completedRef,
          category: refOverrides?.category,
        });
      } else {
        const fn = findFn(reflection);
        if (!fn) return acc;