@cldmv/ prettier-plugin-jsonv (英语)

用于格式化的 Pretier 插件 杰森诺夫 文档.

曰如何是新来

最近:v1.2.2(2026年11月)

• 工具发布, 无插件更改 现在使用的 vitest 配置 devCondition() 从 @cldmv/configs,所以测试真的 逆 src/ 通过 prettier-plugin-jsonv-dev 导出条件,并且类型脚本被拆分为 types:check 财务报告和审定财务报表 types:build (单位:千美元)91号, (中文(简体) ), 93号) (中文(简体) ). 格式不变.
• 查看全文 v1.2.2 更改日志

最近发布的

• v1.2.1 (中文(简体) ) (2026年11月 - ) (中文(简体) ) engines.node 返回到 >=18.0.0;22.22.0开发层迁至 devEngines (单位:千美元)88号(中文(简体) )更改日志(中文(简体) )
• 页:1 (2026年11月) — 通用JS条目,tsup building and a prettier-plugin-jsonv-dev 出口条件; engines.node 升为 >=22.22.0; 格式不变 (# 84, #85) (更改日志(中文(简体) )
• 页:1 (2026年10月) – 正在开发工具 @cldmv/fix-headers 2.2.0和2 @cldmv/configs 1.2.4; 没有补印文件, 没有运行时间变化(# 51, #54) (更改日志(中文(简体) )
• 页:1 (2026年10月) — 中央情报局 ✅ Required PR Check 镜像任务运行在每条路径上,而不是跳过在repo PRs (# 49) (更改日志(中文(简体) )

📚 完整版本历史参见 文件/更改日志/ 编辑 GitHub 发布。 。 。 .

特征

• 格式 .jsonv 使用 @cldmv/jsonv 解析器的文件
• 支持所有ES2015-2025特性(JSON5, 二进制/八进制字元, BigInt, 数字分隔符等)
• 可配置的年份特征检测
• 正确处理评论意见和空白
• 与 Pretier 配置系统结合

安装

npm install --save-dev @cldmv/prettier-plugin-jsonv prettier @cldmv/jsonv

使用量

该插件需要Node.js 18.0.0或后期和Pretier 3. 它运载一个ES模块条目和一个普通JS条目,所以它从任一种类的Pretier配置中装入; require() 需要节点.js ^20.19.0或 ^22.13.0.

开发这个软件包需要节点22.22.0或以后(devEngines) (中文(简体) ).

使用 .prettierrc.mjs 或者说 prettier.config.mjs数字 :

import jsonv from "@cldmv/prettier-plugin-jsonv";

export default {
    plugins: [jsonv],
    overrides: [
        {
            files: "*.jsonv",
            options: {
                jsonvYear: 2025,
                strictBigInt: false
            }
        }
    ]
};

使用 .prettierrc.cjs 或者说 prettier.config.cjs数字 :

module.exports = {
    plugins: [require("@cldmv/prettier-plugin-jsonv")],
    overrides: [
        {
            files: "*.jsonv",
            options: {
                jsonvYear: 2025,
                strictBigInt: false
            }
        }
    ]
};

require("@cldmv/prettier-plugin-jsonv") 返回插件对象本身。 在一个JSON .prettierrc,将插件按名称列出: "plugins": ["@cldmv/prettier-plugin-jsonv"]。 。 。 .

配置选项

跟踪逗号

插件符合 Pretier 的 trailingComma 选项:

• "all" (prettier的默认)和 "es5" 在每个跨行对象或阵列的最后一个条目后加一个逗号。 非空对象和数组总是每行打印一个条目,所以只有空条目({ }, (中文(简体) ), [])被打印在一行上,他们永远得不到逗号.
• "none" 从来没有增加一个.

在源代码中已经存在拖放的逗号不保存为已写入: 选项使其正常化, 在最后一个条目后添加或去除逗号 。 每个jsonv 年(2011–2025年)允许后缀逗号,因此逗号永远不会使文档无效,也不会改变解析值. 在最后一个条目旁边保留的评论 : a: 1, // note 在逗号后保留注释, a: 1 /* note */, 留着它之前.

发展

已发布的软件包只包含已建 dist/ (单位:千美元)dist/index.mjs,以及 dist/index.cjs 页:1 require()+ 生成 types/在一次离职中 prettier-plugin-jsonv-dev 导出条件将包指向 src/ 相反:

每个外壳设定一次 export NODE_OPTIONS=--conditions=prettier-plugin-jsonv-dev。 。 。 . npm test 运行 Vitest 套件与 src/ 条件,然后构建和检查通用JS条目 dist/ 与 node --test。 。 。 .

许可证

阿帕奇-2.0 ©新来/ CLDMV