@james_sww/metaform-asset-distribution 0.1.1 → 0.1.2

package/README.md

@@ -1,13 +1,15 @@
 # Metaform 源码资产分发（P1）
 
-这个包提供源码资产 CLI，并携带独立 `@james_sww/metaform-codebase-template` 的版本快照。基础模板唯一维护源已迁到桌面 `metaform-codebase/`，包含 RoleWorkspaceShell、设计系统原语、完整主题与语义骨架。业务组件按需复制，源码归应用维护；生成工程不依赖 Metaform workspace 或该 CLI 才能运行。
+这个包提供源码资产 CLI，并携带独立 `@james_sww/metaform-codebase-template` 的版本快照。基础模板工程与外壳维护源是独立 `metaform-codebase/`；其中基础 UI、主题和语义骨架按明确来源派生，不建立第二份人工维护源。业务组件按需复制，源码归应用维护；生成工程不依赖 Metaform workspace 或该 CLI 才能运行。
+
+本版为 `0.1.2`，包含独立资产库迁移与模板侧栏、间距和 cobalt 默认主题更新。资产源码及 CLI 已独立迁入 `metaform-asset-library`；本轮仅分发两个岗位任务组件、语义骨架及真实依赖，外壳随模板交付。
 
 ## npm 使用与沙箱接入
 
 发布版本使用 Node 24.18.0、pnpm 10.18.2。CLI 自带固定版本模板与源码 Registry，无需平台仓库或本机桌面目录。私有包需有下载权限；沙箱凭据由运行环境注入，不写入应用源码。
 
 ```sh
-npm install -g @james_sww/metaform-asset-distribution@0.1.1
+npm install -g @james_sww/metaform-asset-distribution@0.1.2
 metaform-assets init --project ./my-app
 cd my-app
 corepack pnpm install --frozen-lockfile
@@ -16,7 +18,7 @@ corepack pnpm install --frozen-lockfile
 不安装全局工具也可运行：
 
 ```sh
-npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.1 -- metaform-assets init --project ./my-app
+npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.2 -- metaform-assets init --project ./my-app
 ```
 
 Agent 根据应用本体和 skill 形成 `ApplicationDesign` JSON 后，在已初始化的应用目录执行：
@@ -31,11 +33,11 @@ corepack pnpm dev
 
 CLI 负责按底稿确定性装配；读取线上本体并作语义转译由 Agent 完成。匹配组件安装为应用内源码，未匹配区域保留语义骨架。模板初始化、安装成功不代表真实业务数据已绑定或平台 S7 已自动接通。
 
-基础模板也单独按 `@james_sww/metaform-codebase-template@0.1.1` 分发，可安装到工具目录后用 `--codebase /path/to/node_modules/@james_sww/metaform-codebase-template` 指定。初始化底稿的完整类型随 CLI 发布在 `dist/application-design.d.ts`，语义区域类型在 `dist/generated/semantic-region-contract.d.ts`。固定 CLI、模板和 Registry 版本用于沙箱重放；初始化后的源码和基线存入项目快照。
+基础模板也单独按 `@james_sww/metaform-codebase-template@0.1.2` 分发，可安装到工具目录后用 `--codebase /path/to/node_modules/@james_sww/metaform-codebase-template` 指定。初始化底稿的完整类型随 CLI 发布在 `dist/application-design.d.ts`，语义区域类型在 `dist/generated/semantic-region-contract.d.ts`。固定 CLI、模板和 Registry 版本用于沙箱重放；初始化后的源码和基线存入项目快照。
 
 ## 维护仓库
 
-在 frontend 目录使用 pnpm 10.18.2：
+在独立 `metaform-asset-library` 根目录使用 pnpm 10.18.2：
 
 ```sh
 corepack pnpm --filter @james_sww/metaform-asset-distribution test
@@ -45,7 +47,7 @@ corepack pnpm --filter @james_sww/metaform-asset-distribution pack --pack-destin
 corepack pnpm --filter @james_sww/metaform-asset-distribution test:standalone
 ```
 
-pack 前从独立基础模板包生成 `codebase/` 快照，再生成 CLI 和资产发布快照。`codebase-source.json` 固定模板名称、版本及本地来源；可用 `METAFORM_CODEBASE_SOURCE` 指向其他包目录（包括已安装或解压的 npm 包）。修改模板后先在模板包运行 `npm run seal`。CLI 发行包不依赖桌面路径。`prepare:release` 只写本地 registry 目录，不发布在线服务。默认 Registry URL 是本机验收地址；正式托管前显式设置 `METAFORM_REGISTRY_BASE=https://...`。每个 release 目录以完整内容摘要命名；同摘要的条目、依赖 URL 和 Catalog 不可改写。更换部署 URL 时使用新的输出目录，不能覆盖已发布版本。
+pack 前从独立基础模板包生成 `codebase/` 快照，再生成 CLI 和资产发布快照。`codebase-source.json` 固定模板名称、版本、清单摘要及库内快照来源。更新上游时按根目录 README 显式刷新固定来源；可用 `METAFORM_CODEBASE_SOURCE` 指向其他包目录（包括已安装或解压的 npm 包）。修改模板后先在模板包运行 `npm run seal`。CLI 发行包不依赖桌面路径。`prepare:release` 只写本地 registry 目录，不发布在线服务。默认 Registry URL 是本机验收地址；正式托管前显式设置 `METAFORM_REGISTRY_BASE=https://...`。每个 release 目录以完整内容摘要命名；同摘要的条目、依赖 URL 和 Catalog 不可改写。更换部署 URL 时使用新的输出目录，不能覆盖已发布版本。
 
 `registry/<digest>/registry.json`、`r/*.json` 遵守 shadcn Registry schema；`release.json` 是 Metaform 的原始字节和来源 sidecar。schema 校验 fixture 来自 [官方 registry-item schema](https://ui.shadcn.com/schema/registry-item.json)，2026-10-17 固定入库。Catalog 分开保留 component 与 asset 两种粒度，候选不会自动变成推荐。可发现但不在首批源码范围内的条目显示 `installable: false`。
 

package/codebase/codebase.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "@james_sww/metaform-codebase-template",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "files": {
     "_gitignore": "184ad45835c68a6d3fd5100366678797c5fe4d2a2aa6548749039912376faf54",
     ".env.example": "602ae0c89a09593ef560b5d1f7010439e228c7fb0dd7bbc69c9655cf82a8944f",
@@ -23,11 +23,12 @@
     ".metaform/asset-baselines/e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f": "e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f",
     ".metaform/asset-baselines/f3ce568d1ede383d9cb0d11dcc2acb6ce7984cbef8e2db0feec310df76303ccd": "f3ce568d1ede383d9cb0d11dcc2acb6ce7984cbef8e2db0feec310df76303ccd",
     ".metaform/asset-baselines/fc763d53079b51a789c1cfff23d40e00f844a9a093a2ad112f0ac68ab46fe080": "fc763d53079b51a789c1cfff23d40e00f844a9a093a2ad112f0ac68ab46fe080",
+    ".metaform/template-overrides.json": "4c9c16d05caf34c4ee4c76fd296c3cc94a07a1fa1db2b8c8ec1ff9af28115722",
     "application.json": "832c19243f16e38c7a6e100e995675d995537ea0d53da7df9cc1b239782b3ca0",
     "assets.lock.json": "cad385719b1d3b2ccbb56343ca5305d862b813a1e0013d2c12c827423ca47db4",
     "components.json": "bf8e563e20f684aad29b2b7671b3327effd62dc2cb3bd944fcd1ccb7d581217e",
     "eslint.config.js": "05a1c2fbaca8ec2c04985ca14e7da9ecf7b6722a5d9e27313e814de4b0393ccd",
-    "index.html": "0c8ce9649128d2ebbe282b1eee040524b78896b9df13f3ca1481c3965f66b823",
+    "index.html": "b0615e4fc6fdf82a768f44c818b3bf280897882ffc72c949c8a3ab5cd78ca37b",
     "LICENSES/NOTICE.md": "dc2bd63b6bcdf6007dcc823ae145828ae0fc3ff2768950a2899e752c1016e0b2",
     "package.json": "7b256b3982d5683f6279e75ee86280498b7ef444a4262158f8d622f77361f64f",
     "pnpm-lock.yaml": "46912c695ef4a2f351a7469aa26ab1312ccf6347b4d0aa2b075bf3a96632782b",
@@ -65,7 +66,7 @@
     "src/layouts/role-workspace-account.tsx": "3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f",
     "src/layouts/role-workspace-icons.tsx": "4b8ea69ef28a9699c0c3b28e12590a7521f91aa1a4a3d618fc0778455d39cbcc",
     "src/layouts/role-workspace-routes.ts": "0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e",
-    "src/layouts/role-workspace-shell.tsx": "bcc48c05cd912dad5373242ff699cdbec032c8ebb2de45a9df5de79a6daec59c",
+    "src/layouts/role-workspace-shell.tsx": "ab0c50c655d759643c77f634337b070807a601580f554796f50284f87c8fd100",
     "src/layouts/role-workspace-types.ts": "b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f",
     "src/lib/http-client.ts": "a284532dd0bcc18aaf444b92e883ec77750515c1ba01626d8fa96c3e540d2e37",
     "src/lib/utils.ts": "4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f",
@@ -73,7 +74,7 @@
     "src/styles/index.css": "72f8f255c56d117bab6f2aaa53ce5a37aa9b2d5d085b321b9fcb4b4b983e15eb",
     "src/styles/styles.css": "b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e",
     "src/styles/theme-tokens.css": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",
-    "src/workspace/default-workspace.tsx": "0239a9926ab2bc6aa6a0c4923a1af03d618bc245483b114c74b017a4a2051737",
+    "src/workspace/default-workspace.tsx": "083313a2e0d61e5eb7f2ee1c2d4dda3243bfdce6204249df85fef7acd751f19d",
     "src/workspace/routes.ts": "94275cc4d44abcfa672e7d56ac1abc7ecd9f5caf656aa54d3e3ef68eaa7e2085",
     "tests/workspace.test.mjs": "daf930b4db33de45eeecf8431663540ecd54aa90c3ba3dd1e683b539cbb8bf5d",
     "tooling/contracts.d.ts": "9ce9d9ac8e59c11c89aa41881b6e8d6edfc84fb4da115970b9f4a2c1e7486ba8",

package/codebase/template/.metaform/template-overrides.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": 1,
+  "previousTemplateVersion": "0.1.1",
+  "files": {
+    "index.html": {
+      "previousTemplateSha256": "0c8ce9649128d2ebbe282b1eee040524b78896b9df13f3ca1481c3965f66b823",
+      "currentSha256": "b0615e4fc6fdf82a768f44c818b3bf280897882ffc72c949c8a3ab5cd78ca37b",
+      "owner": "codebase-template",
+      "reason": "保留用户现有侧栏、间距及 cobalt 默认主题修改；不是原资产版本的未修改副本"
+    },
+    "src/layouts/role-workspace-shell.tsx": {
+      "previousTemplateSha256": "a9f11ecd7a83647859085f75b6d2ba98760240d474aeb38b9c9c2c8174bff31a",
+      "currentSha256": "ab0c50c655d759643c77f634337b070807a601580f554796f50284f87c8fd100",
+      "owner": "codebase-template",
+      "reason": "保留用户现有侧栏、间距及 cobalt 默认主题修改；不是原资产版本的未修改副本"
+    },
+    "src/workspace/default-workspace.tsx": {
+      "previousTemplateSha256": "0239a9926ab2bc6aa6a0c4923a1af03d618bc245483b114c74b017a4a2051737",
+      "currentSha256": "083313a2e0d61e5eb7f2ee1c2d4dda3243bfdce6204249df85fef7acd751f19d",
+      "owner": "codebase-template",
+      "reason": "保留用户现有侧栏、间距及 cobalt 默认主题修改；不是原资产版本的未修改副本"
+    }
+  }
+}

package/codebase/template/index.html

@@ -1,5 +1,5 @@
 <!doctype html>
-<html lang="zh-CN"
+<html lang="zh-CN" data-accent="cobalt"
   ><head
     ><meta charset="UTF-8" /><meta
       name="viewport"

package/codebase/template/src/layouts/role-workspace-shell.tsx

@@ -67,10 +67,33 @@ function NavigationItem({
       variant="ghost-neutral"
       data-route-id={theme.id}
       className={cn(
-        'h-9 w-full justify-start gap-2.5 rounded-md px-2.5 text-sm font-medium text-foreground/80 has-[>svg]:px-2.5',
-        collapsed && 'justify-center px-0 has-[>svg]:px-0',
-        theme.availability === 'planned' && 'text-muted-foreground disabled:opacity-100',
-        active && 'bg-muted font-semibold text-foreground hover:bg-muted hover:text-foreground',
+        // 基础样式
+        'group relative h-auto w-full justify-start gap-3 rounded-lg px-3 py-2.5 text-sm font-medium transition-all duration-200',
+        
+        // 激活状态
+        active && [
+          'bg-gradient-to-r from-[var(--theme-accent-soft)] via-[var(--theme-accent-soft)]/50 to-transparent',
+          'shadow-sm',
+          'border-l-2 border-[var(--theme-accent)]',
+          'font-semibold text-[var(--theme-accent)]',
+          'hover:from-[var(--theme-accent-soft)] hover:via-[var(--theme-accent-soft)]/60',
+        ],
+        
+        // 非激活状态
+        !active && [
+          'text-foreground/80',
+          'hover:bg-accent/50 hover:text-foreground',
+          'hover:translate-x-0.5 hover:shadow-sm',
+        ],
+        
+        // 计划中状态
+        theme.availability === 'planned' && [
+          'cursor-not-allowed opacity-50',
+          'hover:translate-x-0 hover:bg-transparent',
+        ],
+        
+        // 折叠状态
+        collapsed && 'justify-center px-2 border-l-0',
       )}
       aria-label={collapsed ? theme.label : undefined}
       aria-current={active ? 'page' : undefined}
@@ -80,25 +103,33 @@ function NavigationItem({
       <span
         aria-hidden="true"
         className={cn(
-          'flex w-6 shrink-0 justify-center',
-          active ? 'text-foreground' : 'text-foreground/70',
+          'relative flex size-5 shrink-0 items-center justify-center transition-transform duration-200',
+          active ? 'scale-110 text-[var(--theme-accent)]' : 'text-muted-foreground group-hover:scale-105 group-hover:text-foreground',
         )}
       >
         {theme.icon ?? <Layers3 className="size-4" />}
+        {/* 激活状态的微妙发光效果 */}
+        {active && (
+          <span className="absolute inset-0 animate-pulse rounded-full bg-[var(--theme-accent-soft)] blur-sm" />
+        )}
       </span>
-      {!collapsed ? <span className="truncate">{theme.label}</span> : null}
-      {!collapsed && theme.count !== undefined ? (
+      {!collapsed ? <span className="flex-1 truncate text-left">{theme.label}</span> : null}
+      {!collapsed && theme.count !== undefined && theme.count > 0 ? (
         <span
           className={cn(
-            'rounded-md px-1.5 py-0.5 text-xs leading-4 tabular-nums',
-            active ? 'bg-background text-foreground' : 'bg-muted text-muted-foreground',
+            'flex h-5 min-w-[20px] items-center justify-center rounded-full px-1.5 text-[11px] font-semibold shadow-sm transition-all duration-200',
+            active
+              ? 'bg-primary text-primary-foreground ring-1 ring-primary/20'
+              : 'bg-muted text-muted-foreground group-hover:bg-primary/10 group-hover:text-primary'
           )}
         >
-          {theme.count}
+          {theme.count > 99 ? '99+' : theme.count}
         </span>
       ) : null}
       {!collapsed && theme.availability === 'planned' ? (
-        <span className="ml-auto text-xs font-normal text-muted-foreground">待开放</span>
+        <span className="ml-auto text-[10px] font-medium uppercase tracking-wide text-muted-foreground/60">
+          即将推出
+        </span>
       ) : null}
     </Button>
   );
@@ -140,42 +171,99 @@ function ThemeNavigation({
   const extensions = themes.filter((theme) => !isWorkspaceRouteId(theme.id));
   return (
     <TooltipProvider delayDuration={200}>
-      <nav aria-label="角色工作主题" className="px-3">
-        {(['value', 'inbox', 'enterprise'] as const).map((group) => (
-          <div
-            key={group}
-            data-navigation-group={group}
-            className={cn('grid gap-0.5', group !== 'value' && 'mt-2 border-t border-border pt-2')}
-          >
-            {DEFAULT_WORKSPACE_ROUTES.filter((route) => route.group === group).map((route) => (
-              <NavigationItem
-                key={route.id}
-                theme={{
-                  ...route,
-                  availability: 'implemented',
-                  icon: <WorkspaceRouteIcon id={route.id} />,
-                  count: route.id === 'inbox' ? count : undefined,
-                }}
-                activeThemeId={activeThemeId}
-                onSelect={onSelect}
-                collapsed={collapsed}
-              />
-            ))}
-          </div>
-        ))}
-        {extensions.length ? (
-          <div data-navigation-group="extensions" className="mt-2.5 grid gap-[3px]">
-            {extensions.map((theme) => (
-              <NavigationItem
-                key={theme.id}
-                theme={theme}
-                activeThemeId={activeThemeId}
-                onSelect={onSelect}
-                collapsed={collapsed}
-              />
-            ))}
-          </div>
-        ) : null}
+      <nav aria-label="角色工作主题" className="space-y-1 px-3">
+        {/* 核心视图组 */}
+        <div className="space-y-1">
+          {!collapsed && (
+            <p className="mb-2 px-3 text-[11px] font-medium uppercase tracking-wider text-muted-foreground/70">
+              核心视图
+            </p>
+          )}
+          {DEFAULT_WORKSPACE_ROUTES.filter((route) => route.group === 'value').map((route) => (
+            <NavigationItem
+              key={route.id}
+              theme={{
+                ...route,
+                availability: 'implemented',
+                icon: <WorkspaceRouteIcon id={route.id} />,
+              }}
+              activeThemeId={activeThemeId}
+              onSelect={onSelect}
+              collapsed={collapsed}
+            />
+          ))}
+        </div>
+
+        {/* 渐变分隔线 */}
+        <div className="my-3 h-px bg-gradient-to-r from-transparent via-border to-transparent" />
+
+        {/* 待办事项组 */}
+        <div className="space-y-1">
+          {!collapsed && (
+            <p className="mb-2 px-3 text-[11px] font-medium uppercase tracking-wider text-muted-foreground/70">
+              工作台
+            </p>
+          )}
+          {DEFAULT_WORKSPACE_ROUTES.filter((route) => route.group === 'inbox').map((route) => (
+            <NavigationItem
+              key={route.id}
+              theme={{
+                ...route,
+                availability: 'implemented',
+                icon: <WorkspaceRouteIcon id={route.id} />,
+                count: route.id === 'inbox' ? count : undefined,
+              }}
+              activeThemeId={activeThemeId}
+              onSelect={onSelect}
+              collapsed={collapsed}
+            />
+          ))}
+        </div>
+
+        {/* 企业协作组 */}
+        {DEFAULT_WORKSPACE_ROUTES.some((route) => route.group === 'enterprise') && (
+          <>
+            <div className="my-3 h-px bg-gradient-to-r from-transparent via-border to-transparent" />
+            <div className="space-y-1">
+              {!collapsed && (
+                <p className="mb-2 px-3 text-[11px] font-medium uppercase tracking-wider text-muted-foreground/70">
+                  协作空间
+                </p>
+              )}
+              {DEFAULT_WORKSPACE_ROUTES.filter((route) => route.group === 'enterprise').map((route) => (
+                <NavigationItem
+                  key={route.id}
+                  theme={{
+                    ...route,
+                    availability: 'implemented',
+                    icon: <WorkspaceRouteIcon id={route.id} />,
+                  }}
+                  activeThemeId={activeThemeId}
+                  onSelect={onSelect}
+                  collapsed={collapsed}
+                />
+              ))}
+            </div>
+          </>
+        )}
+
+        {/* 扩展功能 */}
+        {extensions.length > 0 && (
+          <>
+            <div className="my-3 h-px bg-gradient-to-r from-transparent via-border to-transparent" />
+            <div className="space-y-1">
+              {extensions.map((theme) => (
+                <NavigationItem
+                  key={theme.id}
+                  theme={theme}
+                  activeThemeId={activeThemeId}
+                  onSelect={onSelect}
+                  collapsed={collapsed}
+                />
+              ))}
+            </div>
+          </>
+        )}
       </nav>
     </TooltipProvider>
   );

package/codebase/template/src/workspace/default-workspace.tsx

@@ -23,7 +23,7 @@ export function DefaultWorkspace() {
       }}
       slots={{
         content: (
-          <div className="mx-auto w-full max-w-6xl space-y-6 p-4 md:p-8">
+          <div className="mx-auto w-full max-w-6xl space-y-6">
             <h1 className="text-xl font-semibold text-foreground">
               {contract.title}
             </h1>

package/dist/application-source.d.ts

@@ -1,3 +1,5 @@
-import type { ApplicationDesign } from './application-design.js';
-import { type RegistryRelease } from './contracts.js';
-export declare function generateApplicationFiles(design: ApplicationDesign, release: RegistryRelease): Record<string, string>;
+import type { ApplicationDesign } from "./application-design.js";
+import { type RegistryRelease } from "./contracts.js";
+export declare function generateApplicationFiles(design: ApplicationDesign, release: RegistryRelease, options?: {
+    accent?: string;
+}): Record<string, string>;

package/dist/application-source.js

@@ -1,64 +1,75 @@
-import { posix } from 'node:path';
-import { DistributionError } from './contracts.js';
+import { posix } from "node:path";
+import { DistributionError } from "./contracts.js";
 const literal = (value) => JSON.stringify(value, null, 2)
-    .replaceAll('<', '\\u003c')
-    .replaceAll('\u2028', '\\u2028')
-    .replaceAll('\u2029', '\\u2029');
+    .replaceAll("<", "\\u003c")
+    .replaceAll("\u2028", "\\u2028")
+    .replaceAll("\u2029", "\\u2029");
 function modulePath(from, to) {
-    let p = posix.relative(posix.dirname(from), to).replace(/\.tsx?$/, '');
-    if (!p.startsWith('.'))
-        p = './' + p;
+    let p = posix.relative(posix.dirname(from), to).replace(/\.tsx?$/, "");
+    if (!p.startsWith("."))
+        p = "./" + p;
     return JSON.stringify(p);
 }
-function propsSource(value, events, path = '') {
+function propsSource(value, events, path = "") {
     if (events.has(path))
         return `(...args: unknown[]) => onAction(${literal(events.get(path))}, args[0])`;
     if (Array.isArray(value))
-        return ('[' +
-            value.map((x, i) => propsSource(x, events, path ? path + '.' + i : String(i))).join(',') +
-            ']');
-    if (value && typeof value === 'object') {
+        return ("[" +
+            value
+                .map((x, i) => propsSource(x, events, path ? path + "." + i : String(i)))
+                .join(",") +
+            "]");
+    if (value && typeof value === "object") {
         const keys = new Set(Object.keys(value));
         for (const eventPath of events.keys())
-            if (!path || eventPath.startsWith(path + '.'))
-                keys.add(eventPath.slice(path ? path.length + 1 : 0).split('.')[0]);
-        return ('{' +
+            if (!path || eventPath.startsWith(path + "."))
+                keys.add(eventPath.slice(path ? path.length + 1 : 0).split(".")[0]);
+        return ("{" +
             [...keys]
-                .map((k) => `${literal(k)}:${propsSource(Object.hasOwn(value, k) ? value[k] : {}, events, path ? path + '.' + k : k)}`)
-                .join(',') +
-            '}');
+                .map((k) => `${literal(k)}:${propsSource(Object.hasOwn(value, k) ? value[k] : {}, events, path ? path + "." + k : k)}`)
+                .join(",") +
+            "}");
     }
     return literal(value);
 }
-export function generateApplicationFiles(design, release) {
+export function generateApplicationFiles(design, release, options = {}) {
     const files = {};
-    const scaffold = 'src/components/common/semantic-region/semantic-region-scaffold.tsx';
-    const types = 'src/components/common/semantic-region/contract.ts';
+    const accent = options.accent && /^[a-z][a-z0-9-]*$/.test(options.accent)
+        ? ` data-accent="${options.accent}"`
+        : "";
+    const scaffold = "src/components/common/semantic-region/semantic-region-scaffold.tsx";
+    const types = "src/components/common/semantic-region/contract.ts";
     const targets = [];
     for (const role of design.roles) {
         const pages = design.pages.filter((p) => p.roleKey === role.roleKey);
         const regions = design.regions.filter((r) => pages.some((p) => p.id === r.contract.pageId));
         const root = `src/features/${role.roleKey}`;
         const entry = `${role.roleKey}/index.html`;
-        targets.push({ roleKey: role.roleKey, entry, path: `/${role.roleKey}/`, featuresRoot: root });
+        targets.push({
+            roleKey: role.roleKey,
+            entry,
+            path: `/${role.roleKey}/`,
+            featuresRoot: root,
+        });
         files[entry] =
-            `<!doctype html><html lang="zh-CN"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>${design.name.replace(/[<>&"']/g, '')}</title></head><body><div id="root"></div><script type="module" src="/${root}/main.tsx"></script></body></html>\n`;
+            `<!doctype html><html lang="zh-CN"${accent}><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>${design.name.replace(/[<>&"']/g, "")}</title></head><body><div id="root"></div><script type="module" src="/${root}/main.tsx"></script></body></html>\n`;
         for (const r of regions) {
             const componentPath = `${root}/regions/${r.contract.id}.tsx`;
             const contractPath = `${root}/regions/${r.contract.id}.contract.ts`;
             files[contractPath] =
                 `import type { SemanticRegionContract } from ${modulePath(contractPath, types)};\nexport const contract: SemanticRegionContract = ${literal(r.contract)};\n`;
             const common = `import { contract } from './${r.contract.id}.contract';\nexport { contract };\nexport interface RegionProps { onAction(id: string, context?: unknown): void; context?: unknown }\n`;
-            if (r.implementation.kind === 'scaffold') {
+            if (r.implementation.kind === "scaffold") {
                 files[componentPath] =
                     `import { SemanticRegionScaffold } from ${modulePath(componentPath, scaffold)};\n${common}export function Region({ onAction }: RegionProps) { return <SemanticRegionScaffold contract={contract} commands={{ onAction: (action) => onAction(action.id) }} />; }\n`;
             }
             else {
                 const impl = r.implementation;
                 const item = release.items.find((a) => a.assetId === impl.asset.id && a.version === impl.asset.version);
-                const source = item.files.find((f) => f.sourcePath === item.contractRef) ?? item.files[0];
+                const source = item.files.find((f) => f.sourcePath === item.contractRef) ??
+                    item.files[0];
                 if (!source)
-                    throw new DistributionError('asset_entry_missing', [item.assetId]);
+                    throw new DistributionError("asset_entry_missing", [item.assetId]);
                 files[componentPath] =
                     `import { ${impl.exportName} } from ${modulePath(componentPath, source.targetPath)};\n${common}export function Region({ onAction }: RegionProps) { return <section data-region-id={contract.id} data-region-implementation="asset"><${impl.exportName} {...${propsSource(impl.props, new Map(impl.events.map((e) => [e.propPath, e.actionId])))}} /></section>; }\n`;
             }
@@ -70,11 +81,11 @@ export function generateApplicationFiles(design, release) {
 import { RoleWorkspaceShell } from '../../layouts/role-workspace-shell';
 import { SemanticRegionScaffold } from '../../components/common/semantic-region/semantic-region-scaffold';
 import { activeWorkspaceRoute, resolveWorkspacePage, workspaceRouteContract, type WorkspaceRouteMap } from '../../workspace/routes';
-${regions.map((r, i) => `import { Region as Region${i}, contract as contract${i} } from './regions/${r.contract.id}';`).join('\n')}
+${regions.map((r, i) => `import { Region as Region${i}, contract as contract${i} } from './regions/${r.contract.id}';`).join("\n")}
 const pages = ${literal(pages)};
 const workspaceRoutes: WorkspaceRouteMap = ${literal(role.workspaceRoutes ?? {})};
 const mappedPages = new Set(Object.values(workspaceRoutes));
-const regions = { ${regions.map((r, i) => `${literal(r.contract.id)}: { View: Region${i}, contract: contract${i} }`).join(',')} };
+const regions = { ${regions.map((r, i) => `${literal(r.contract.id)}: { View: Region${i}, contract: contract${i} }`).join(",")} };
 export function Workspace() {
   const [state, setState] = useState<{pageId:string; contexts:Record<string,unknown>}>({pageId:${literal(role.entryPageId)},contexts:{}});
   const [feedback, setFeedback] = useState('');
@@ -97,10 +108,10 @@ export function Workspace() {
   }
   return <RoleWorkspaceShell model={{productName:${literal(design.name)},workspaceTitle:${literal(role.label)},actorLabel:'未连接登录服务',roleLabel:${literal(role.label)},themes:pages.filter((p) => p.menu !== false && !mappedPages.has(p.id)).map((p) => ({id:p.id,label:p.title,availability:'implemented' as const})),activeThemeId:page ? activeWorkspaceRoute(page.id,workspaceRoutes) : state.pageId}}
     commands={{onSelectTheme:selectPage}}
-    slots={{content:<div className="mx-auto w-full max-w-6xl space-y-6 p-4 md:p-8"><header className="space-y-2"><p className="text-sm text-muted-foreground">应用设计底稿 · 真实业务数据尚未接入</p><h1 className="text-2xl font-semibold text-foreground">{page?.title ?? placeholder?.title ?? '待确认页面'}</h1></header>{feedback ? <p role="status" className="text-sm text-muted-foreground">{feedback}</p> : null}{page ? page.regionIds.map((id) => {const View = regions[id as keyof typeof regions].View; return <View key={id} context={state.contexts[page.id]} onAction={(actionId,context) => onAction(id,actionId,context)} />;}) : placeholder ? <SemanticRegionScaffold contract={placeholder} /> : <p>页面映射待确认</p>}</div>}} />;
+    slots={{content:<div className="mx-auto w-full max-w-6xl space-y-6"><header className="space-y-2"><p className="text-sm text-muted-foreground">应用设计底稿 · 真实业务数据尚未接入</p><h1 className="text-2xl font-semibold text-foreground">{page?.title ?? placeholder?.title ?? '待确认页面'}</h1></header>{feedback ? <p role="status" className="text-sm text-muted-foreground">{feedback}</p> : null}{page ? page.regionIds.map((id) => {const View = regions[id as keyof typeof regions].View; return <View key={id} context={state.contexts[page.id]} onAction={(actionId,context) => onAction(id,actionId,context)} />;}) : placeholder ? <SemanticRegionScaffold contract={placeholder} /> : <p>页面映射待确认</p>}</div>}} />;
 }\n`;
     }
-    files['role-targets.json'] = literal(targets) + '\n';
-    files['docs/application-design.json'] = literal(design) + '\n';
+    files["role-targets.json"] = literal(targets) + "\n";
+    files["docs/application-design.json"] = literal(design) + "\n";
     return files;
 }

package/dist/contracts.d.ts

@@ -14,7 +14,7 @@ export type SourceFile = {
     contentBase64: string;
     sha256: string;
     bytes: number;
-    kind: 'source' | 'style' | 'resource' | 'license';
+    kind: "source" | "style" | "resource" | "license";
 };
 export type SourceItem = {
     assetId: string;
@@ -35,6 +35,11 @@ export type RegistryRelease = {
     id: string;
     version: string;
     sourceCommit: string;
+    sourceBaseline?: {
+        sourcesDigest: string;
+        contentDigest: string;
+        dirty?: boolean;
+    };
     digest: string;
     items: SourceItem[];
     catalog?: CatalogSnapshot;

package/dist/contracts.js

@@ -2,7 +2,7 @@ export class DistributionError extends Error {
     code;
     paths;
     constructor(code, paths = []) {
-        super(code + (paths.length ? ': ' + paths.join(', ') : ''));
+        super(code + (paths.length ? ": " + paths.join(", ") : ""));
         this.code = code;
         this.paths = paths;
     }

package/dist/export-source.js

@@ -111,7 +111,7 @@ export async function exportAssets(input) {
         const imports = new Map(), dependencies = new Set();
         function classify(specifier) {
             if (specifier.startsWith('@metaform/design-system/'))
-                return ('frontend/packages/design-system/src/' +
+                return ('vendor/design-system/src/' +
                     specifier.slice('@metaform/design-system/'.length));
             if (specifier.startsWith('.'))
                 return posix.normalize(posix.join(posix.dirname(source), specifier));
@@ -165,7 +165,7 @@ export async function exportAssets(input) {
         else
             text = rewriteModule(text, source, (s) => imports.get(s) ?? s);
         if (SEEDS[id]) {
-            const style = await collect('frontend/packages/design-system/src/styles.css');
+            const style = await collect('vendor/design-system/src/styles.css');
             dependencies.add(style);
             let cssImport = posix.relative(posix.dirname(target), 'src/styles/styles.css');
             if (!cssImport.startsWith('.'))
@@ -183,6 +183,6 @@ export async function exportAssets(input) {
             throw new DistributionError('asset_version', [ref.id]);
         await collect(SEEDS[ref.id].source);
     }
-    await collect('frontend/packages/design-system/src/styles.css');
+    await collect('vendor/design-system/src/styles.css');
     return [...items.values()].sort((a, b) => a.assetId.localeCompare(b.assetId));
 }

package/dist/prepare.d.ts

@@ -1,4 +1,4 @@
-import { type InstallPlan, type RegistryRelease } from './contracts.js';
+import { type InstallPlan, type RegistryRelease } from "./contracts.js";
 export declare function planPrepare(input: {
     projectRoot: string;
     release: RegistryRelease;