@composy/vector-cli

LDesign 矢量图形的无头 CLI 工具，提供项目创建、分析、校验、编译、构建、打包与解包命令。

安装

pnpm add @composy/vector-cli @composy/vector
npm install @composy/vector-cli

目录结构

src/
├── index.ts
└── project.js    # 项目命令实现

命令清单

| 命令 | 说明 | | -------------- | ---------------------------------------------- | | ldv create | 创建新矢量项目 | | ldv analyze | 打印特征计数、兼容性、资源依赖、诊断 | | ldv inspect | 检查文档结构 | | ldv validate | 校验文档（不安全 SVG、未解析引用、重复 id 等） | | ldv compile | 编译为 JSON/SVG/HTML/Web Component/Vue | | ldv build | 递归发现源集合并输出 | | ldv bundle | 打包为确定性 ZIP | | ldv unbundle | 解包 |

使用示例

# 编译单个文档
ldv compile path/to/name.vector dist/vector --target html,web-component,vue

# 构建目录
ldv build path/to/vectors dist/vectors

# 分析
ldv analyze path/to/name.vector

构建脚本 & 验证命令

pnpm build
pnpm type-check
pnpm run type-check:cjs
pnpm run lint:check
pnpm run test:run

产物说明

• dist/ 提供浏览器入口与压缩产物；es/ 提供 ESM 发布入口；esm/ 提供独立 ESM 模块；lib/ 提供 CJS 模块和 bin/ldv.cjs 命令入口。各模块目录都带有对应 .d.ts 声明。
• API 与命令入口分别由 .ldesign/builder.config.ts、.ldesign/bin.builder.config.ts 使用 @composy/builder 和 Rolldown 构建；类型检查配置集中在 .ldesign/tsconfig.*.json。

备注

• validate、compile、build、bundle 共享 Core 的 Analyzer 发布门禁，遇到不安全 SVG 或无法解析的资源时返回非零退出码。
• bundle 使用确定性 ZIP 元数据，便于与 Studio 浏览器包写入器交换。
• 资产路径统一为项目相对 POSIX 路径；Windows 反斜杠会被规范化，路径穿越和规范化后的重复路径会被拒绝。