1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768 |
- import { ignoreOverride } from "./Options.js";
- import { selectParser } from "./selectParser.js";
- export function parseDef(def, refs, forceResolution = false) {
- const seenItem = refs.seen.get(def);
- if (refs.override) {
- const overrideResult = refs.override?.(def, refs, seenItem, forceResolution);
- if (overrideResult !== ignoreOverride) {
- return overrideResult;
- }
- }
- if (seenItem && !forceResolution) {
- const seenSchema = get$ref(seenItem, refs);
- if (seenSchema !== undefined) {
- return seenSchema;
- }
- }
- const newItem = { def, path: refs.currentPath, jsonSchema: undefined };
- refs.seen.set(def, newItem);
- const jsonSchemaOrGetter = selectParser(def, def.typeName, refs);
- // If the return was a function, then the inner definition needs to be extracted before a call to parseDef (recursive)
- const jsonSchema = typeof jsonSchemaOrGetter === "function"
- ? parseDef(jsonSchemaOrGetter(), refs)
- : jsonSchemaOrGetter;
- if (jsonSchema) {
- addMeta(def, refs, jsonSchema);
- }
- if (refs.postProcess) {
- const postProcessResult = refs.postProcess(jsonSchema, def, refs);
- newItem.jsonSchema = jsonSchema;
- return postProcessResult;
- }
- newItem.jsonSchema = jsonSchema;
- return jsonSchema;
- }
- const get$ref = (item, refs) => {
- switch (refs.$refStrategy) {
- case "root":
- return { $ref: item.path.join("/") };
- case "relative":
- return { $ref: getRelativePath(refs.currentPath, item.path) };
- case "none":
- case "seen": {
- if (item.path.length < refs.currentPath.length &&
- item.path.every((value, index) => refs.currentPath[index] === value)) {
- console.warn(`Recursive reference detected at ${refs.currentPath.join("/")}! Defaulting to any`);
- return {};
- }
- return refs.$refStrategy === "seen" ? {} : undefined;
- }
- }
- };
- const getRelativePath = (pathA, pathB) => {
- let i = 0;
- for (; i < pathA.length && i < pathB.length; i++) {
- if (pathA[i] !== pathB[i])
- break;
- }
- return [(pathA.length - i).toString(), ...pathB.slice(i)].join("/");
- };
- const addMeta = (def, refs, jsonSchema) => {
- if (def.description) {
- jsonSchema.description = def.description;
- if (refs.markdownDescription) {
- jsonSchema.markdownDescription = def.description;
- }
- }
- return jsonSchema;
- };
|