weave-custom-components

将 packages/weave-custom-components 内的组件源码打包为可发布的 ESM 子路径入口。

目录约定

• 源组件：src/*.js（例如 src/globe.js）
• 组件清单：components.manifest.json
• 发布产物：dist/*.js（自动生成）

新增组件

在 components.manifest.json 增加一项：

{
  "comp": "starfield",
  "source": "src/starfield.js"
}

然后执行：

npm run build

build 会自动：

• 生成 dist/<comp>.js 与 dist/index.js
• 同步 package.json.exports，为每个组件写入显式子路径（如 ./globe、./starfield）

发布

先把 package.json 里的 name 改成你的真实 npm 包名（例如 @xxx/weave-custom-components）：

npm publish --access public

prepack 会自动执行构建。

线上使用（按需加载）

推荐使用子路径避免整包加载：

• https://esm.sh/@your-scope/weave-custom-components/[email protected]
• https://esm.sh/@your-scope/weave-custom-components/[email protected]

不建议直接使用包根入口进行运行时加载。

迁移说明

如果你已有主项目里的组件脚本（例如 public/effect/weave-globe.js），请复制一份到本包 src/ 下维护。发布流程只依赖 packages/weave-custom-components 目录，不依赖仓库其它目录。