@james_sww/metaform-asset-distribution 0.1.4 → 0.1.5

package/README.md

@@ -2,7 +2,7 @@
 
 这个包提供源码资产 CLI，并携带独立 `@james_sww/metaform-codebase-template` 的版本快照。基础模板工程与外壳维护源是独立 `metaform-codebase/`；其中基础 UI、主题和语义骨架按明确来源派生，不建立第二份人工维护源。业务组件按需复制，源码归应用维护；生成工程不依赖 Metaform workspace 或该 CLI 才能运行。
 
-本版为 `0.1.4`，包含当前组件装配流程、模板区域边界、层级导航，模板不携带历史资产源码副本。资产源码及 CLI 已独立迁入 `metaform-asset-library`。当前源码的 `prepare:release` 会将已验证的各来源资产统一登记到发行中；外壳仍随模板交付。CLI 发行与线上 MCP 分别更新；远程版本与验证结果以发行记录为准。
+本版为 `0.1.5`，包含当前组件装配流程、模板区域边界、层级导航，模板不携带历史资产源码副本。资产源码及 CLI 已独立迁入 `metaform-asset-library`。当前源码的 `prepare:release` 会将已验证的各来源资产统一登记到发行中；外壳仍随模板交付。CLI 发行与线上 MCP 分别更新；远程版本与验证结果以发行记录为准。
 
 ## 统一 add 入口
 
@@ -34,12 +34,20 @@ metaform-assets plan add shadcn.button --variant radix --json
 
 资源刷新脚本会将同一发行的 `metadata.installation`、`installId`、摘要和安装资格同步到资源目录，保留原始 reference 字节与交付方式。MCP 消费固定快照，须另行刷新、验证并部署后才会显示新状态；本地 CLI 打包不会自动更新线上服务。
 
+### 图标随组件交付
+
+图标资产定义位于 `packages/asset-resources/src/icon-assets.ts`，登记当前组件使用的 17 个 Lucide 图标名称及用途，复用固定 `lucide-react@0.468.0`。发行时核对依赖包版本、真实导出和 ISC 许可证，将上游 `IconPlaceholder` 转换为按需静态导入；保留原有样式、SVG 属性、无障碍属性和 `use client` 指令。动态或未登记图标明确报错，不猜测替代名称。
+
+展开属性仅用于 SVG 属性，不能携带图标供应商选择字段。转换器拒绝展开对象中可见的供应商字段或动态计算键；普通 `...props` 按上游 SVG props 契约保留，调用方不得借此动态切换图标。
+
+`add` 会连同组件安装图标依赖，保留 `LICENSES/lucide-react/LICENSE` 和 `references/icons/lucide-react.json`；`inspect` 的 `installation.icons` 记录实际使用的图标及固定版本。原先因图标占位符阻断的 71 个变体均进入同一安装流程，当前仍缺实现的三个 Form 变体继续返回 `source_unavailable`。自定义 SVG 尚需提供真实文件、来源和许可证后登记。
+
 ## npm 使用与沙箱接入
 
 发布版本使用 Node 24.18.0、pnpm 10.18.2。CLI 自带固定版本模板与源码 Registry，无需平台仓库或本机桌面目录。私有包需有下载权限；沙箱凭据由运行环境注入，不写入应用源码。
 
 ```sh
-npm install -g @james_sww/metaform-asset-distribution@0.1.4
+npm install -g @james_sww/metaform-asset-distribution@0.1.5
 metaform-assets init --project ./my-app
 cd my-app
 corepack pnpm install --frozen-lockfile
@@ -48,7 +56,7 @@ corepack pnpm install --frozen-lockfile
 不安装全局工具也可运行：
 
 ```sh
-npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.4 -- metaform-assets init --project ./my-app
+npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.5 -- metaform-assets init --project ./my-app
 ```
 
 Agent 根据应用本体和 skill 形成 `ApplicationDesign` JSON 后，在已初始化的应用目录执行：

package/dist/contracts.d.ts

@@ -42,6 +42,12 @@ export type InstallationInfo = {
     details?: string[];
     entry?: string;
     declaredDependencies?: Record<string, string>;
+    icons?: {
+        package: string;
+        version: string;
+        license: string;
+        names: string[];
+    };
 };
 export type RegistryRelease = {
     schemaVersion: 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@james_sww/metaform-asset-distribution",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "bin": {
     "metaform-assets": "./dist/bin.js"