@james_sww/metaform-asset-distribution 0.1.0 → 0.1.1

package/README.md

@@ -7,7 +7,7 @@
 发布版本使用 Node 24.18.0、pnpm 10.18.2。CLI 自带固定版本模板与源码 Registry，无需平台仓库或本机桌面目录。私有包需有下载权限；沙箱凭据由运行环境注入，不写入应用源码。
 
 ```sh
-npm install -g @james_sww/metaform-asset-distribution@0.1.0
+npm install -g @james_sww/metaform-asset-distribution@0.1.1
 metaform-assets init --project ./my-app
 cd my-app
 corepack pnpm install --frozen-lockfile
@@ -16,7 +16,7 @@ corepack pnpm install --frozen-lockfile
 不安装全局工具也可运行：
 
 ```sh
-npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.0 -- metaform-assets init --project ./my-app
+npm exec --yes --package=@james_sww/metaform-asset-distribution@0.1.1 -- metaform-assets init --project ./my-app
 ```
 
 Agent 根据应用本体和 skill 形成 `ApplicationDesign` JSON 后，在已初始化的应用目录执行：
@@ -31,7 +31,7 @@ corepack pnpm dev
 
 CLI 负责按底稿确定性装配；读取线上本体并作语义转译由 Agent 完成。匹配组件安装为应用内源码，未匹配区域保留语义骨架。模板初始化、安装成功不代表真实业务数据已绑定或平台 S7 已自动接通。
 
-基础模板也单独按 `@james_sww/metaform-codebase-template@0.1.0` 分发，可安装到工具目录后用 `--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.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 版本用于沙箱重放；初始化后的源码和基线存入项目快照。
 
 ## 维护仓库
 

package/codebase/codebase.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 1,
   "name": "@james_sww/metaform-codebase-template",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "files": {
     "_gitignore": "184ad45835c68a6d3fd5100366678797c5fe4d2a2aa6548749039912376faf54",
-    ".env.example": "5c15c4f0187d52019398f42ced14c7e6d54211ddb554c2142c4b8a9d250573c0",
+    ".env.example": "602ae0c89a09593ef560b5d1f7010439e228c7fb0dd7bbc69c9655cf82a8944f",
     ".metaform/asset-baselines/0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e": "0551d7ee067550cd2757cf693414c5e180adbb5efe3af4f5f9b1242aa9cd788e",
     ".metaform/asset-baselines/0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",
     ".metaform/asset-baselines/3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f": "3d1a9a8a1f7ed83eaf3422d1497cac02b643fe1c470b5c5f357f3bd26c585a0f",
@@ -33,10 +33,11 @@
     "pnpm-lock.yaml": "46912c695ef4a2f351a7469aa26ab1312ccf6347b4d0aa2b075bf3a96632782b",
     "README.md": "d738a1bfbe9e9221f15e2bdcb46af9fae112afd0c1354bd9d45bdf3ae5205e38",
     "role-targets.json": "37517e5f3dc66819f61f5a7bb8ace1921282415f10551d2defa5c3eb0985b570",
-    "src/components/common/error-boundary.tsx": "990d7a72a5634dc854f3acbe9b9d4aac8f13540ca0901be8dbc2f27d77a76f3e",
+    "src/components/common/empty-state.tsx": "6008a3193b715c5453eee3dba6ee20608fca3e6cf8bba9af774ba898a1890fea",
+    "src/components/common/error-boundary.tsx": "1fef1c92e27d8206448cb0e1840bfe81826a95fc58b1ec4c1e2f14462293bf5b",
     "src/components/common/semantic-region/contract.ts": "92cd18a919b549b4827f611c3a4157652c4a6ae034850da1254ca422693c759d",
     "src/components/common/semantic-region/semantic-region-scaffold.tsx": "567f039384fb23a20a4cd5e1d4fda56255abda6fc04d80b36c4bb6f6c040691b",
-    "src/components/ui/alert.tsx": "d03dcae5cdb63c381c1144ca9a0c49ba0e46466967d7deb94662034042acb034",
+    "src/components/ui/alert.tsx": "9c380bb1703ba96fe873d5b3094153fa3402d305719e60aa733e4ab202ffddaa",
     "src/components/ui/avatar.tsx": "e9d4784c2ad5bceccdc4f2f19f367fdc37537a10e3f99f510e42c0226adfbf8f",
     "src/components/ui/badge.tsx": "bf9e1bbb252c1fa5da20a17eeee1ac163c7d3a0b6deff817d30ba04b766fb8a1",
     "src/components/ui/breadcrumb.tsx": "c75fcd3d9e8470188bc0dd4b27a2b26fff3ad42b9c9c534a953dc090ae2cba33",
@@ -59,16 +60,16 @@
     "src/components/ui/tabs.tsx": "e1df6e2f95ece373ca909c1d54b8ba8cf4c47dd425c1784bbb9a01c38dd0936b",
     "src/components/ui/tooltip.tsx": "5f56cd15afc07567f7b80b8b4d9e89da405e070a562583bbbc2414fd981af324",
     "src/contexts/toast-context.tsx": "a3af91f8915d7753ef15888997ba941d07459d4df3e3e6d58e25365143bf336f",
-    "src/hooks/index.ts": "31e5708e471dbeb44413632535b8f846686de9be28c8ad18e2d930761de8b73b",
-    "src/integrations/platform.ts": "2deb59e0f2938342cb66600b7310da0a67f8754ed291330a18034e819b448c4e",
+    "src/hooks/index.ts": "ddfe80f0fc8b0b49c0b31f27d9aadc4a54715b5ccee40996a205ecec36958b79",
+    "src/integrations/platform.ts": "6edb9755c91f6bf1f16815911739f64c4f45405948eaf0d7bbd5cd2fa939dbe9",
     "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-types.ts": "b9e31158082ce71a2b3bdb904d9462619e3690735e73e138b1ce57f8f036347f",
-    "src/lib/http-client.ts": "da19f0a16d8be3672573346d59c7242aa87440fc8b97b68a35867291f4da6af7",
+    "src/lib/http-client.ts": "a284532dd0bcc18aaf444b92e883ec77750515c1ba01626d8fa96c3e540d2e37",
     "src/lib/utils.ts": "4acbc7165a8d54738ff62b51414e772c08fe78434e524e6d8770180d3ba2925f",
-    "src/main.tsx": "60221d67b63e9e685f2669f8deea9e4e56d5f285ea248d399e87fa69134b191f",
+    "src/main.tsx": "6fa2b2eb510ef94ca04b894c573a041419191f6896043f227eb160ab49bd6efa",
     "src/styles/index.css": "72f8f255c56d117bab6f2aaa53ce5a37aa9b2d5d085b321b9fcb4b4b983e15eb",
     "src/styles/styles.css": "b48c73f51ff3e148f20ad2c9dbd2847235e4fdf1cdb304d5e2feec9c2febd65e",
     "src/styles/theme-tokens.css": "0e7bb494140c2c4118b919496a4246b26935367453282bd654fedecd2b16f1a5",

package/codebase/template/.env.example

@@ -1 +1,11 @@
-# 在打造前完成基础能力接入设计后填写；默认不配置业务服务地址。
+# 应用配置
+VITE_APP_TITLE=Metaform 应用
+
+# API 配置
+VITE_API_BASE_URL=/api
+
+# 开发模式配置
+VITE_USE_MOCK_API=true
+
+# 环境标识
+VITE_ENV=development

package/codebase/template/src/components/common/empty-state.tsx

@@ -0,0 +1,52 @@
+import { type ReactNode } from 'react';
+import { InboxIcon } from 'lucide-react';
+
+import { cn } from '../../lib/utils';
+import { Button } from '../ui/button';
+
+export interface EmptyStateProps {
+  icon?: ReactNode;
+  title: string;
+  description?: string;
+  action?: {
+    label: string;
+    onClick: () => void;
+  };
+  className?: string;
+}
+
+/**
+ * 空状态组件
+ * 当列表、表格或其他数据容器没有内容时显示
+ */
+export function EmptyState({
+  icon,
+  title,
+  description,
+  action,
+  className,
+}: EmptyStateProps) {
+  return (
+    <div
+      className={cn(
+        'flex min-h-[400px] flex-col items-center justify-center gap-4 rounded-lg border border-dashed border-border bg-muted/30 p-8 text-center',
+        className,
+      )}
+    >
+      <div className="flex size-20 items-center justify-center rounded-full bg-muted text-muted-foreground">
+        {icon || <InboxIcon className="size-10" />}
+      </div>
+      <div className="space-y-2">
+        <h3 className="text-lg font-semibold text-foreground">{title}</h3>
+        {description && (
+          <p className="max-w-md text-sm text-muted-foreground">{description}</p>
+        )}
+      </div>
+      {action && (
+        <Button onClick={action.onClick} className="mt-2">
+          {action.label}
+        </Button>
+      )}
+    </div>
+  );
+}

package/codebase/template/src/components/common/error-boundary.tsx

@@ -1,7 +1,7 @@
 import React, { Component, type ErrorInfo, type ReactNode } from 'react';
 
-import { Button } from '../components/ui/button';
-import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../components/ui/card';
+import { Button } from '../ui/button';
+import { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from '../ui/card';
 
 interface ErrorBoundaryProps {
   children: ReactNode;

package/codebase/template/src/components/ui/alert.tsx

@@ -1,65 +1,63 @@
-import * as React from "react"
-import { cva, type VariantProps } from "class-variance-authority"
-import { cn } from "cn"
+import * as React from "react";
+import { cva, type VariantProps } from "class-variance-authority";
+
+import { cn } from "../../lib/utils";
 
 const alertVariants = cva(
-  "relative grid w-full grid-cols-[0_1fr] items-start gap-y-0.5 rounded-lg border px-4 py-3 text-sm has-[>svg]:grid-cols-[calc(var(--spacing)*4)_1fr] has-[>svg]:gap-x-3 [&>svg]:size-4 [&>svg]:translate-y-0.5 [&>svg]:text-current",
+  "relative w-full rounded-lg border p-4 [&>svg~*]:pl-7 [&>svg+div]:translate-y-[-3px] [&>svg]:absolute [&>svg]:left-4 [&>svg]:top-4 [&>svg]:text-foreground",
   {
     variants: {
       variant: {
-        default: "bg-card text-card-foreground",
+        default: "bg-background text-foreground",
+        success:
+          "border-semantic-success/50 bg-semantic-success-soft text-semantic-success-foreground [&>svg]:text-semantic-success",
+        warning:
+          "border-semantic-warning/50 bg-semantic-warning-soft text-semantic-warning-foreground [&>svg]:text-semantic-warning",
         destructive:
-          "bg-card text-destructive *:data-[slot=alert-description]:text-destructive/90 [&>svg]:text-current",
+          "border-semantic-danger/50 bg-semantic-danger-soft text-semantic-danger-foreground [&>svg]:text-semantic-danger",
       },
     },
     defaultVariants: {
       variant: "default",
     },
-  }
-)
+  },
+);
 
-function Alert({
-  className,
-  variant,
-  ...props
-}: React.ComponentProps<"div"> & VariantProps<typeof alertVariants>) {
-  return (
-    <div
-      data-slot="alert"
-      role="alert"
-      className={cn(alertVariants({ variant }), className)}
-      {...props}
-    />
-  )
-}
+const Alert = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement> & VariantProps<typeof alertVariants>
+>(({ className, variant, ...props }, ref) => (
+  <div
+    ref={ref}
+    role="alert"
+    className={cn(alertVariants({ variant }), className)}
+    {...props}
+  />
+));
+Alert.displayName = "Alert";
 
-function AlertTitle({ className, ...props }: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="alert-title"
-      className={cn(
-        "col-start-2 line-clamp-1 min-h-4 font-medium tracking-tight",
-        className
-      )}
-      {...props}
-    />
-  )
-}
+const AlertTitle = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLHeadingElement>
+>(({ className, ...props }, ref) => (
+  <h5
+    ref={ref}
+    className={cn("mb-1 font-medium leading-none tracking-tight", className)}
+    {...props}
+  />
+));
+AlertTitle.displayName = "AlertTitle";
 
-function AlertDescription({
-  className,
-  ...props
-}: React.ComponentProps<"div">) {
-  return (
-    <div
-      data-slot="alert-description"
-      className={cn(
-        "col-start-2 grid justify-items-start gap-1 text-sm text-muted-foreground [&_p]:leading-relaxed",
-        className
-      )}
-      {...props}
-    />
-  )
-}
+const AlertDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => (
+  <div
+    ref={ref}
+    className={cn("text-sm [&_p]:leading-relaxed", className)}
+    {...props}
+  />
+));
+AlertDescription.displayName = "AlertDescription";
 
-export { Alert, AlertTitle, AlertDescription }
+export { Alert, AlertTitle, AlertDescription };

package/codebase/template/src/hooks/index.ts

@@ -166,8 +166,8 @@ export function useMediaQuery(query: string): boolean {
  */
 export function useClickOutside<T extends HTMLElement = HTMLElement>(
   handler: () => void,
-): React.RefObject<T> {
-  const ref = useRef<T>(null);
+): React.RefObject<T | null> {
+  const ref = useRef<T | null>(null);
 
   useEffect(() => {
     const listener = (event: MouseEvent | TouchEvent) => {

package/codebase/template/src/integrations/platform.ts

@@ -1,6 +1,70 @@
-// 基础能力设计的扩展点；不提供默认登录流程或虚构 API。
+import { httpClient } from '../lib/http-client';
+
+/**
+ * 平台集成接口
+ * 提供统一的认证、查询和操作能力
+ */
 export interface PlatformIntegration {
   getSession(): Promise<{ actorId: string } | null>;
   query<T>(operation: string, input: unknown): Promise<T>;
   execute<T>(operation: string, input: unknown): Promise<T>;
 }
+
+/**
+ * 默认平台集成实现
+ * 使用 HTTP 客户端与后端通信
+ */
+class DefaultPlatformIntegration implements PlatformIntegration {
+  async getSession(): Promise<{ actorId: string } | null> {
+    try {
+      const response = await httpClient.get<{ actorId: string }>('/auth/session');
+      return response.data;
+    } catch (error) {
+      console.warn('Failed to get session:', error);
+      return null;
+    }
+  }
+
+  async query<T>(operation: string, input: unknown): Promise<T> {
+    const response = await httpClient.post<T>('/query', {
+      operation,
+      input,
+    });
+    return response.data;
+  }
+
+  async execute<T>(operation: string, input: unknown): Promise<T> {
+    const response = await httpClient.post<T>('/execute', {
+      operation,
+      input,
+    });
+    return response.data;
+  }
+}
+
+/**
+ * Mock 平台集成(用于开发和测试)
+ */
+class MockPlatformIntegration implements PlatformIntegration {
+  async getSession(): Promise<{ actorId: string } | null> {
+    // 模拟已登录用户
+    return { actorId: 'mock-user-001' };
+  }
+
+  async query<T>(operation: string, input: unknown): Promise<T> {
+    console.log('[Mock Query]', operation, input);
+    // 返回模拟数据
+    return {} as T;
+  }
+
+  async execute<T>(operation: string, input: unknown): Promise<T> {
+    console.log('[Mock Execute]', operation, input);
+    return {} as T;
+  }
+}
+
+// 根据环境变量选择实现
+const useMock = (import.meta as { env?: { VITE_USE_MOCK_API?: string } }).env?.VITE_USE_MOCK_API === 'true';
+export const platform: PlatformIntegration = useMock
+  ? new MockPlatformIntegration()
+  : new DefaultPlatformIntegration();

package/codebase/template/src/lib/http-client.ts

@@ -228,7 +228,7 @@ export class HttpClient {
 
 // 创建默认实例
 export const httpClient = new HttpClient({
-  baseURL: import.meta.env.VITE_API_BASE_URL || '/api',
+  baseURL: (import.meta as { env?: { VITE_API_BASE_URL?: string } }).env?.VITE_API_BASE_URL || '/api',
   onRequest: async (config) => {
     // 自动添加认证 token
     const token = localStorage.getItem('auth_token');

package/codebase/template/src/main.tsx

@@ -1,6 +1,16 @@
 import { createRoot } from "react-dom/client";
+import { Toaster } from "sonner";
 
+import { ErrorBoundary } from "./components/common/error-boundary";
+import { ToastProvider } from "./contexts/toast-context";
 import { DefaultWorkspace } from "./workspace/default-workspace";
 import "./styles/index.css";
 
-createRoot(document.getElementById("root")!).render(<DefaultWorkspace />);
+createRoot(document.getElementById("root")!).render(
+  <ErrorBoundary>
+    <ToastProvider>
+      <DefaultWorkspace />
+      <Toaster position="top-right" richColors closeButton />
+    </ToastProvider>
+  </ErrorBoundary>,
+);

package/dist/cli.js

@@ -96,7 +96,7 @@ export async function runCLI(argv, io) {
         else if (cmd === 'init')
             output = await initProject({
                 projectRoot: root,
-                templateVersion: options.get('template') ?? '0.1.0',
+                templateVersion: options.get('template'),
                 codebaseRoot: options.get('codebase'),
             });
         else if (cmd === 'reconcile')

package/dist/template.d.ts

@@ -2,7 +2,7 @@ import { type RegistryRelease } from './contracts.js';
 export declare function initProject(input: {
     projectRoot: string;
     release?: RegistryRelease;
-    templateVersion: string;
+    templateVersion?: string;
     codebaseRoot?: string;
 }): Promise<{
     codebase: {

package/dist/template.js

@@ -22,7 +22,7 @@ export async function initProject(input) {
         Array.isArray(manifest.files) ||
         typeof manifest.files !== 'object')
         throw new DistributionError('invalid_codebase');
-    if (manifest.version !== input.templateVersion)
+    if (input.templateVersion && manifest.version !== input.templateVersion)
         throw new DistributionError('template_version');
     const template = validateTargetPath(packageRoot, 'template');
     const actual = await projectFiles(template);

package/package.json

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