@svadmin/create 0.41.0 → 0.41.1

package/blueprints/product-workspace/src/ProductSurfacePage.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+  import type { ProductPagePlan } from '@svadmin/core/product-pages';
   import { productPagePlans, productSurfaceRoutes } from './generated/pages';
 
   interface Props {
@@ -6,8 +7,24 @@
     params: Record<string, string | undefined>;
   }
 
+  type SurfaceState = ProductPagePlan['states'][number];
+  const stateByScenario: Record<string, SurfaceState | undefined> = {
+    empty: 'empty',
+    loading: 'loading',
+    error: 'error',
+    denied: 'forbidden',
+  };
+
   let { route }: Props = $props();
   const page = $derived(productPagePlans.find(candidate => productSurfaceRoutes[route] === candidate.id));
+  const requestedScenario = typeof location !== 'undefined'
+    ? new URLSearchParams(location.search).get('scenario') ?? 'normal'
+    : 'normal';
+  const scenarioState = $derived.by(() => {
+    const candidate = page;
+    const state = stateByScenario[requestedScenario];
+    return candidate && state !== undefined && candidate.states.includes(state) ? state : undefined;
+  });
 </script>
 
 <svelte:head>
@@ -33,31 +50,53 @@
       {/each}
     </div>
 
-    <div class="surface-grid">
-      {#each page.sections as section (section.id)}
-        <section class="surface-card">
-          <div class="card-heading">
-            <h2>{section.title}</h2>
-            <span>区块</span>
-          </div>
-          <p>此区块服务于当前工作流，并展示产品计划声明的资源。</p>
-          {#if section.resourceIds.length}
-            <div class="resource-list">
-              {#each section.resourceIds as resourceId (resourceId)}
-                <span>{resourceId}</span>
-              {/each}
+    {#if scenarioState}
+      <section class="surface-state" data-state={scenarioState}>
+        {#if scenarioState === 'loading'}
+          <span class="state-icon" aria-hidden="true">◌</span>
+          <h2>正在加载工作台</h2>
+          <p>正在准备当前工作流需要的数据。</p>
+        {:else if scenarioState === 'empty'}
+          <span class="state-icon" aria-hidden="true">○</span>
+          <h2>当前没有待处理数据</h2>
+          <p>工作流已经准备好；当业务数据进入后，这里会显示下一步操作。</p>
+        {:else if scenarioState === 'error'}
+          <span class="state-icon" aria-hidden="true">!</span>
+          <h2>暂时无法加载工作台</h2>
+          <p>数据 provider 返回了错误，请稍后重试或联系管理员。</p>
+        {:else if scenarioState === 'forbidden'}
+          <span class="state-icon" aria-hidden="true">×</span>
+          <h2>没有访问权限</h2>
+          <p>当前角色没有访问这个工作流的权限。</p>
+        {/if}
+      </section>
+    {:else}
+      <div class="surface-grid">
+        {#each page.sections as section (section.id)}
+          <section class="surface-card">
+            <div class="card-heading">
+              <h2>{section.title}</h2>
+              <span>区块</span>
             </div>
-          {:else}
-            <p class="muted">此区块暂无数据资源，等待接入真实 provider。</p>
-          {/if}
-        </section>
-      {/each}
-    </div>
+            <p>此区块服务于当前工作流，并展示产品计划声明的资源。</p>
+            {#if section.resourceIds.length}
+              <div class="resource-list">
+                {#each section.resourceIds as resourceId (resourceId)}
+                  <span>{resourceId}</span>
+                {/each}
+              </div>
+            {:else}
+              <p class="muted">此区块暂无数据资源，等待接入真实 provider。</p>
+            {/if}
+          </section>
+        {/each}
+      </div>
 
-    <aside class="contract-note">
-      <strong>动作仍是产品元数据</strong>
-      <span>接入 defineCommand 或资源契约后，再启用真实提交、审批和写入。</span>
-    </aside>
+      <aside class="contract-note">
+        <strong>动作仍是产品元数据</strong>
+        <span>接入 defineCommand 或资源契约后，再启用真实提交、审批和写入。</span>
+      </aside>
+    {/if}
   {:else}
     <section class="surface-card">
       <h1>未找到页面计划</h1>
@@ -78,6 +117,10 @@
   .state-strip { display: flex; flex-wrap: wrap; gap: 8px; margin-bottom: 20px; }
   .state { background: #eef0f3; color: #596273; }
   .surface-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 16px; }
+  .surface-state { display: grid; justify-items: center; gap: 8px; min-height: 220px; padding: 42px 24px; border: 1px dashed #cdd5e4; border-radius: 18px; background: #f8faff; text-align: center; }
+  .surface-state h2, .surface-state p { margin: 0; }
+  .surface-state p { max-width: 520px; color: #65708a; line-height: 1.6; }
+  .state-icon { display: grid; place-items: center; width: 36px; height: 36px; border-radius: 50%; background: #e8eefc; color: #3558a8; font-size: 22px; font-weight: 700; }
   .surface-card { min-height: 150px; padding: 22px; border: 1px solid #e4e7ed; border-radius: 18px; background: #fff; box-shadow: 0 10px 30px rgb(32 45 72 / 5%); }
   .card-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
   .card-heading span { color: #8a94a7; font-size: 12px; }

package/dist/index.js

@@ -18923,7 +18923,11 @@ function buildProductPagePlan(surface, plan) {
   const actionById = new Map(plan.actions.map((action) => [action.id, action]));
   const primaryAction = surface.primaryActionId === undefined ? undefined : actionById.get(surface.primaryActionId);
   const secondaryActions = surface.actionIds.filter((id) => id !== surface.primaryActionId).map((id) => actionById.get(id)).filter((action) => action !== undefined);
-  const sections = surface.sections.length ? surface.sections.map((title, index) => ({ id: `${surface.id}.section.${index + 1}`, title, resourceIds: surface.resourceIds })) : [{ id: `${surface.id}.content`, title: surface.name, resourceIds: surface.resourceIds }];
+  const sections = surface.sections.length ? surface.sections.map((title, index) => ({
+    id: `${surface.id}.section.${index + 1}`,
+    title,
+    resourceIds: index === 0 ? surface.resourceIds : []
+  })) : [{ id: `${surface.id}.content`, title: surface.name, resourceIds: surface.resourceIds }];
   return {
     id: surface.id,
     kind: surface.kind,
@@ -18952,6 +18956,38 @@ function reviewProductPlan(plan) {
   const resourceIds = new Set(plan.resources.map((resource) => resource.id));
   const surfaceIds = new Set(plan.surfaces.map((surface) => surface.id));
   const actionIds = new Set(plan.actions.map((action) => action.id));
+  const runtimeNames = new Map;
+  for (const resource of plan.resources) {
+    const runtimeName = resource.runtimeName ?? resource.name;
+    const previous = runtimeNames.get(runtimeName);
+    if (previous !== undefined) {
+      addIssue(issues, {
+        code: "resource.duplicate-runtime-name",
+        severity: "error",
+        message: `Resources "${resource.label}" and "${previous}" resolve to the same runtime name "${runtimeName}".`,
+        path: `resources.${resource.id}.runtimeName`,
+        suggestion: "Give every generated resource route a unique runtime name."
+      });
+    } else {
+      runtimeNames.set(runtimeName, resource.label);
+    }
+  }
+  const surfaceRoutes = new Map;
+  for (const surface of plan.surfaces) {
+    const route = surface.route ?? `/workflows/${surface.id}`;
+    const previous = surfaceRoutes.get(route);
+    if (previous !== undefined) {
+      addIssue(issues, {
+        code: "surface.duplicate-route",
+        severity: "error",
+        message: `Surfaces "${surface.name}" and "${previous}" resolve to the same route "${route}".`,
+        path: `surfaces.${surface.id}.route`,
+        suggestion: "Give every generated surface a unique route."
+      });
+    } else {
+      surfaceRoutes.set(route, surface.name);
+    }
+  }
   for (const workflow of plan.workflows) {
     if (!workflow.actorRoleIds.length)
       addIssue(issues, { code: "workflow.missing-actor", severity: "error", message: `Workflow "${workflow.name}" has no actor role.`, path: `workflows.${workflow.id}.actorRoleIds` });
@@ -18967,10 +19003,42 @@ function reviewProductPlan(plan) {
     for (const workflowId of resource.workflowIds)
       if (!has2(workflowIds, workflowId))
         addIssue(issues, { code: "resource.unknown-workflow", severity: "error", message: `Resource "${resource.label}" references unknown workflow "${workflowId}".`, path: `resources.${resource.id}.workflowIds` });
+    for (const roleId of resource.roleIds)
+      if (!has2(roleIds, roleId))
+        addIssue(issues, { code: "resource.unknown-role", severity: "error", message: `Resource "${resource.label}" references unknown role "${roleId}".`, path: `resources.${resource.id}.roleIds` });
+    resource.fields.forEach((field) => {
+      for (const roleId of field.readableBy)
+        if (!has2(roleIds, roleId))
+          addIssue(issues, { code: "field.unknown-role", severity: "error", message: `Field "${field.label}" references unknown readable role "${roleId}".`, path: `resources.${resource.id}.fields.${field.id}.readableBy` });
+      for (const roleId of field.writableBy)
+        if (!has2(roleIds, roleId))
+          addIssue(issues, { code: "field.unknown-role", severity: "error", message: `Field "${field.label}" references unknown writable role "${roleId}".`, path: `resources.${resource.id}.fields.${field.id}.writableBy` });
+      for (const workflowId of field.usedByWorkflowIds)
+        if (!has2(workflowIds, workflowId))
+          addIssue(issues, { code: "field.unknown-workflow", severity: "error", message: `Field "${field.label}" references unknown workflow "${workflowId}".`, path: `resources.${resource.id}.fields.${field.id}.usedByWorkflowIds` });
+    });
   }
   for (const surface of plan.surfaces) {
-    reviewSurface(surface, { workflowIds, actionIds, resourceIds }, issues);
+    reviewSurface(surface, { workflowIds, actionIds, resourceIds, roleIds, surfaceIds }, issues);
   }
+  const visitingSurfaces = new Set;
+  const visitedSurfaces = new Set;
+  const visitSurface = (id) => {
+    if (visitingSurfaces.has(id)) {
+      addIssue(issues, { code: "surface.cycle", severity: "error", message: `Surface hierarchy contains a cycle at "${id}".`, path: `surfaces.${id}.parentSurfaceId` });
+      return;
+    }
+    if (visitedSurfaces.has(id))
+      return;
+    visitingSurfaces.add(id);
+    const parentId = plan.surfaces.find((surface) => surface.id === id)?.parentSurfaceId;
+    if (parentId !== undefined && surfaceIds.has(parentId))
+      visitSurface(parentId);
+    visitingSurfaces.delete(id);
+    visitedSurfaces.add(id);
+  };
+  for (const surface of plan.surfaces)
+    visitSurface(surface.id);
   const menuById = new Map(plan.menu.map((item) => [item.id, item]));
   for (const item of plan.menu) {
     if (item.parentId !== undefined && !menuById.has(item.parentId)) {
@@ -19002,12 +19070,21 @@ function reviewProductPlan(plan) {
       addIssue(issues, { code: "menu.unknown-surface", severity: "error", message: `Menu item "${item.label}" references unknown surface.`, path: `menu.${item.id}.surfaceId` });
     if (item.resourceId && !has2(resourceIds, item.resourceId))
       addIssue(issues, { code: "menu.unknown-resource", severity: "error", message: `Menu item "${item.label}" references unknown resource.`, path: `menu.${item.id}.resourceId` });
+    for (const workflowId of item.workflowIds)
+      if (!has2(workflowIds, workflowId))
+        addIssue(issues, { code: "menu.unknown-workflow", severity: "error", message: `Menu item "${item.label}" references unknown workflow "${workflowId}".`, path: `menu.${item.id}.workflowIds` });
+    for (const roleId of item.roleIds)
+      if (!has2(roleIds, roleId))
+        addIssue(issues, { code: "menu.unknown-role", severity: "error", message: `Menu item "${item.label}" references unknown role "${roleId}".`, path: `menu.${item.id}.roleIds` });
     if (!item.roleIds.length && item.placement !== "hidden")
       addIssue(issues, { code: "menu.public-entry", severity: "info", message: `Menu item "${item.label}" is public at the UI hint layer.`, path: `menu.${item.id}.roleIds`, suggestion: "Keep server authorization independent from menu visibility." });
   }
   for (const action of plan.actions) {
     if (!has2(workflowIds, action.workflowId))
       addIssue(issues, { code: "action.unknown-workflow", severity: "error", message: `Action "${action.label}" references unknown workflow.`, path: `actions.${action.id}.workflowId` });
+    for (const roleId of action.roleIds)
+      if (!has2(roleIds, roleId))
+        addIssue(issues, { code: "action.unknown-role", severity: "error", message: `Action "${action.label}" references unknown role "${roleId}".`, path: `actions.${action.id}.roleIds` });
     if (!action.roleIds.length)
       addIssue(issues, { code: "action.missing-roles", severity: "warning", message: `Action "${action.label}" has no role visibility contract.`, path: `actions.${action.id}.roleIds` });
   }
@@ -19036,6 +19113,11 @@ function reviewProductPlan(plan) {
 function reviewSurface(surface, refs, issues) {
   if (!surface.purpose.trim())
     addIssue(issues, { code: "surface.missing-purpose", severity: "error", message: `Surface "${surface.name}" has no purpose.`, path: `surfaces.${surface.id}.purpose` });
+  for (const roleId of surface.roleIds)
+    if (!refs.roleIds.has(roleId))
+      addIssue(issues, { code: "surface.unknown-role", severity: "error", message: `Surface "${surface.name}" references unknown role "${roleId}".`, path: `surfaces.${surface.id}.roleIds` });
+  if (surface.parentSurfaceId !== undefined && !refs.surfaceIds.has(surface.parentSurfaceId))
+    addIssue(issues, { code: "surface.unknown-parent", severity: "error", message: `Surface "${surface.name}" references unknown parent surface "${surface.parentSurfaceId}".`, path: `surfaces.${surface.id}.parentSurfaceId` });
   if (!surface.workflowIds.length)
     addIssue(issues, { code: "surface.no-workflow", severity: "warning", message: `Surface "${surface.name}" is not attached to a workflow.`, path: `surfaces.${surface.id}.workflowIds` });
   surface.workflowIds.forEach((id) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/create",
-  "version": "0.41.0",
+  "version": "0.41.1",
   "description": "Scaffolding tool for svadmin projects",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "@types/node": "^26.4.0",
     "@types/prompts": "^2.4.9",
     "typescript": "^7.0.2",
-    "@svadmin/core": "^0.61.0"
+    "@svadmin/core": "^0.61.1"
   },
   "keywords": [
     "svadmin",

package/scaffold-manifest.json

@@ -10,10 +10,10 @@
     "check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@svadmin/core": "^0.61.0",
-    "@svadmin/app": "^0.2.4",
-    "@svadmin/ai-elements": "^0.11.2",
-    "@svadmin/ui": "^0.84.0",
+    "@svadmin/core": "^0.61.1",
+    "@svadmin/app": "^0.2.5",
+    "@svadmin/ai-elements": "^0.11.3",
+    "@svadmin/ui": "^0.84.1",
     "typebox": "^1.3.34",
     "@tanstack/svelte-query": "^6.1.48",
     "@lucide/svelte": "^1.35.0"
@@ -42,76 +42,76 @@
         "graphql": "^16.8.0"
       },
       "simple-rest": {
-        "@svadmin/simple-rest": "^0.12.5",
+        "@svadmin/simple-rest": "^0.12.6",
         "@refinedev/simple-rest": "^6.0.1"
       },
       "supabase": {
-        "@svadmin/supabase": "^0.19.2",
+        "@svadmin/supabase": "^0.19.3",
         "@supabase/supabase-js": "^2.112.4",
         "@refinedev/supabase": "^6.0.2"
       },
       "graphql": {
-        "@svadmin/graphql": "^0.12.5",
+        "@svadmin/graphql": "^0.12.6",
         "@refinedev/graphql": "^8.0.1",
         "graphql-request": "^7.4.0",
         "graphql": "^16.8.0"
       },
       "rest": {
-        "@svadmin/rest": "^0.2.4",
+        "@svadmin/rest": "^0.2.5",
         "@refinedev/rest": "^2.1.1",
         "@nestjsx/crud-request": "^5.0.0-alpha.3"
       },
       "airtable": {
-        "@svadmin/airtable": "^0.12.5",
+        "@svadmin/airtable": "^0.12.6",
         "@refinedev/airtable": "^5.0.1"
       },
       "appwrite": {
-        "@svadmin/appwrite": "^0.11.5",
+        "@svadmin/appwrite": "^0.11.6",
         "appwrite": ">=26.2.0",
         "@refinedev/appwrite": "^8.0.1"
       },
       "directus": {
-        "@svadmin/directus": "^0.11.5"
+        "@svadmin/directus": "^0.11.6"
       },
       "drizzle": {
-        "@svadmin/drizzle": "^0.14.2",
+        "@svadmin/drizzle": "^0.14.3",
         "drizzle-orm": "^1.0.0-rc.1",
         "refine-sqlx": "^0.10.3"
       },
       "elysia": {
-        "@svadmin/elysia": "^0.14.5",
+        "@svadmin/elysia": "^0.14.6",
         "elysia": ">=1.4.30",
         "@elysiajs/eden": ">=1.4.9"
       },
       "firebase": {
-        "@svadmin/firebase": "^0.12.5"
+        "@svadmin/firebase": "^0.12.6"
       },
       "hasura": {
-        "@svadmin/hasura": "^0.12.5",
+        "@svadmin/hasura": "^0.12.6",
         "@refinedev/hasura": "^7.0.1",
         "graphql-request": "^7.4.0"
       },
       "medusa": {
-        "@svadmin/medusa": "^0.12.5",
+        "@svadmin/medusa": "^0.12.6",
         "@refinedev/medusa": "^5.0.0"
       },
       "nestjs-query": {
-        "@svadmin/nestjs-query": "^0.12.5",
+        "@svadmin/nestjs-query": "^0.12.6",
         "@refinedev/nestjs-query": "^5.0.0"
       },
       "nestjsx-crud": {
-        "@svadmin/nestjsx-crud": "^0.12.5",
+        "@svadmin/nestjsx-crud": "^0.12.6",
         "@refinedev/nestjsx-crud": "^6.0.1"
       },
       "pocketbase": {
-        "@svadmin/pocketbase": "^0.13.2",
+        "@svadmin/pocketbase": "^0.13.3",
         "pocketbase": ">=0.28.0"
       },
       "sanity": {
-        "@svadmin/sanity": "^0.11.5"
+        "@svadmin/sanity": "^0.11.6"
       },
       "strapi": {
-        "@svadmin/strapi": "^0.12.5",
+        "@svadmin/strapi": "^0.12.6",
         "@refinedev/strapi-v4": "^7.0.1"
       }
     },