feature: /json-to-jsdoc

未指定文件、测试或入口点。首先定位独立工具的 JavaScript 转换代码和 HTML textarea UI，然后将实现与所请求的中间类型、enum 处理、字母顺序以及 CSS 变量进行比较；完成的标准是列出的 JSON 和 enum 示例能够生成预期的 JSDoc 输出。

The Big Idea

I'd like to host a standalone online tool like https://transform.tools/json-to-jsdoc, but that will break down intermediary types, and also handle enums.

• JavaScript conversion function (no frameworks or libraries)
  • JSON.stringify(input, null, 2) to prettify JSON
  • Traverses JSON to produce JSDoc
  • Checkbox for "treat arrays as enums"
  • Order types alphabetically
  • "" is type String
  • "a|b|c" creates a typedef MyTypeStatusEnum ?
• HTML Textareas
  • CSS with variables (see MVP.css)

Example Output: JSON

/** @typedef {object} json
 * @property {object} about
 * @property {string} about.legalBusinessName
 * @property {string} about.website
 * @property {string} about.industry
 * @property {string} about.countryOfOperation
 * @property {string} about.description
 * @property {string} about.operations
 */

should instead be

/** 
 * @typedef MyType
 * @prop {MyTypeAbout} about
 */

/**
  * @typedef MyTypeAbout
  * @prop {String} legalBusinessName
  * @prop {String} website
  * @prop {String} industry
  * @prop {String} countryOfOperation
  * @prop {String} description
  * @prop {String} operations
  */

Example Output: Enums

Maybe any props that are all caps and assigned an array could be considered enums?

/**
 * @typedef {"IsPep"|"IsNotPep"} PepOption
 */
Mercury.POLITICALLY_EXPOSED_OPTIONS = ["IsPep", "IsNotPep"];