eslint-doc-generator/dist/lib/rule-options.js

Automatic documentation generator for ESLint plugins and rules.

import traverse from 'json-schema-traverse';
import { capitalizeOnlyFirstLetter } from './string.js';
function typeToString(type) {
    return Array.isArray(type)
        ? type.map((item) => capitalizeOnlyFirstLetter(item)).join(', ')
        : capitalizeOnlyFirstLetter(type);
}
/**
 * Gather a list of named options from a rule schema.
 * @param jsonSchema - the JSON schema to check
 * @returns - list of named options we could detect from the schema
 */
export function getAllNamedOptions(jsonSchema) {
    if (!jsonSchema) {
        return [];
    }
    if (Array.isArray(jsonSchema)) {
        return jsonSchema.flatMap((js) => getAllNamedOptions(js));
    }
    const options = [];
    traverse(jsonSchema, (js) => {
        if (js.properties) {
            options.push(...Object.entries(js.properties).map(([key, value]) => ({
                name: key,
                type: value.type === 'array' &&
                    !Array.isArray(value.items) &&
                    value.items?.type
                    ? `${Array.isArray(value.items.type) && value.items.type.length > 1
                        ? `(${typeToString(value.items.type)})`
                        : typeToString(value.items.type)}[]`
                    : value.type
                        ? typeToString(value.type)
                        : undefined,
                description: value.description,
                default: value.default,
                enum: value.enum,
                required: typeof value.required === 'boolean'
                    ? value.required
                    : Array.isArray(js.required) && js.required.includes(key),
                deprecated: value.deprecated, // eslint-disable-line @typescript-eslint/no-unsafe-assignment -- property exists on future JSONSchema version but we can let it be used anyway.
            })));
        }
    });
    return options;
}
/**
 * Check if a rule schema is non-blank/empty and thus has actual options.
 * @param jsonSchema - the JSON schema to check
 * @returns - whether the schema has options
 */
export function hasOptions(jsonSchema) {
    return ((Array.isArray(jsonSchema) && jsonSchema.length > 0) ||
        (typeof jsonSchema === 'object' && Object.keys(jsonSchema).length > 0));
}