@svadmin/create 0.41.2 → 0.43.0

package/blueprints/customer-workspace/README.md

@@ -16,7 +16,7 @@ bun run dev
 
 在编码助手中提出需求即可，例如：
 
-> 基于当前客户工作台，把全站调整为高密度运营，保留客户 CRUD 和跟进流程。
+> 基于当前客户工作台，把全站调整为宽屏运营布局，保留客户 CRUD 和跟进流程。
 > 先读取 svadmin.vibe.json 和设计规范，修改后运行检查并查看移动端截图。
 
 `AGENTS.md` 提供通用规则，`.agents/skills/svadmin-vibe/SKILL.md` 提供生成与

package/blueprints/customer-workspace/src/design.svelte.ts

@@ -3,7 +3,6 @@ import { initialPreset } from './design-selection';
 
 interface DesignPreset {
   label: string;
-  density: 'compact' | 'comfortable';
   width: 'wide' | 'default';
   formColumns: 1 | 2;
   detailLayout: 'list' | 'grid';
@@ -12,17 +11,17 @@ interface DesignPreset {
 
 export const designPresets = {
   operations: {
-    label: '高密度运营', density: 'compact', width: 'wide',
+    label: '宽屏运营', width: 'wide',
     formColumns: 2, detailLayout: 'list',
     theme: { colorPreset: 'neutral', layoutPreset: 'clean-flat' },
   },
   enterprise: {
-    label: '标准企业', density: 'comfortable', width: 'wide',
+    label: '标准企业', width: 'wide',
     formColumns: 2, detailLayout: 'grid',
     theme: { colorPreset: 'stripe', layoutPreset: 'clean-flat' },
   },
   collaboration: {
-    label: '轻量协作', density: 'comfortable', width: 'default',
+    label: '轻量协作', width: 'default',
     formColumns: 1, detailLayout: 'list',
     theme: { colorPreset: 'green', layoutPreset: 'clean-flat' },
   },

package/blueprints/customer-workspace/src/features/customers/Dashboard.svelte

@@ -2,8 +2,6 @@
   import { useList, useCan } from '@svadmin/core';
   import { AutoTable, Button, DashboardPage, DataState, MetricBlock, PageSection } from '@svadmin/ui';
   import { customers, followups, approvals } from './contracts';
-  import { getDesign } from '../../design.svelte';
-  const design = $derived(getDesign());
   const access = useCan(() => ({ resource: 'customers', action: 'list' }));
   const followupAccess = useCan(() => ({ resource: 'followups', action: 'list' }));
   const approvalAccess = useCan(() => ({ resource: 'approvals', action: 'list' }));
@@ -37,7 +35,7 @@
   {/if}
   <PageSection title="客户">
     <AutoTable resourceName="customers" showHeader={false} selectable={false}
-      syncWithLocation={false} density={design.density} />
+      syncWithLocation={false} />
   </PageSection>
   {#snippet secondary()}
     <PageSection title="待办">

package/blueprints/customer-workspace/src/features/customers/Detail.svelte

@@ -15,9 +15,9 @@
   }));
 </script>
 
-<ContentPageShell pageId="customer-detail" width={design.width} density={design.density}>
+<ContentPageShell pageId="customer-detail" width={design.width}>
   {#if id !== undefined}
-    <ShowPage {resourceName} {id} layout={design.detailLayout} density={design.density}>
+    <ShowPage {resourceName} {id} layout={design.detailLayout}>
       <PageSection title="最近跟进">
         {#snippet actions()}<Button variant="ghost" href="#/followups">全部记录</Button>{/snippet}
         {#if permission.isLoading || records.isLoading}

package/blueprints/customer-workspace/src/features/customers/Form.svelte

@@ -7,7 +7,7 @@
   const design = $derived(getDesign());
 </script>
 
-<ContentPageShell pageId="customer-form" width={design.width} density={design.density}>
+<ContentPageShell pageId="customer-form" width={design.width}>
   <AutoForm {resourceName} {mode} {...(id === undefined ? {} : { id })}
-    columns={design.formColumns} density={design.density} />
+    columns={design.formColumns} />
 </ContentPageShell>

package/blueprints/customer-workspace/src/features/customers/List.svelte

@@ -5,6 +5,6 @@
   const design = $derived(getDesign());
 </script>
 
-<ContentPageShell pageId="customer-list" width={design.width} density={design.density}>
-  <AutoTable {resourceName} density={design.density} />
+<ContentPageShell pageId="customer-list" width={design.width}>
+  <AutoTable {resourceName} />
 </ContentPageShell>

package/blueprints/customer-workspace/src/features/customers/Review.svelte

@@ -1,13 +1,11 @@
 <script lang="ts">
   import { AutoForm, ContentPageShell, DataState, PageSection, ShowPage } from '@svadmin/ui';
-  import { getDesign } from '../../design.svelte';
   let { resourceName, id }: { resourceName: string; id?: string | number } = $props();
-  const design = $derived(getDesign());
 </script>
 
-<ContentPageShell pageId="approval-review" width="default" density={design.density}>
+<ContentPageShell pageId="approval-review" width="default">
   {#if id !== undefined}
-    <ShowPage {resourceName} {id} density={design.density}>
+    <ShowPage {resourceName} {id}>
       <PageSection title="审批决定">
         <AutoForm {resourceName} {id} mode="edit" showHeader={false} columns={1} />
       </PageSection>

package/blueprints/customer-workspace/tests/workspace.spec.ts

@@ -70,7 +70,6 @@ test('global design preset changes without losing customer data', async ({ page
   await page.goto('/#/workspace_settings');
   await page.getByRole('combobox', { name: '设计预设', exact: true }).selectOption('operations');
   await page.evaluate(() => { location.hash = '/customers'; });
-  await expect(page.locator('[data-svadmin-content-page="customer-list"]')).toHaveAttribute('data-density', 'compact');
   await expect(visibleText(page, '澄川科技')).toBeVisible();
   await page.evaluate(() => { location.hash = '/workspace_settings'; });
   await page.getByRole('combobox', { name: '设计预设', exact: true }).selectOption('collaboration');
@@ -84,7 +83,6 @@ for (const preset of catalog.presets) {
     await page.getByRole('combobox', { name: '设计预设', exact: true }).selectOption(preset);
     await page.evaluate(() => { location.hash = '/customers'; });
     await expect(visibleText(page, '澄川科技')).toBeVisible();
-    await expect(page.locator('[data-svadmin-content-page="customer-list"]')).toHaveAttribute('data-density', preset === 'operations' ? 'compact' : 'comfortable');
     await page.screenshot({ path: testInfo.outputPath(`${preset}.png`), fullPage: true, animations: 'disabled' });
   });
 }

package/blueprints/customer-workspace/vibe-skill.md

@@ -36,7 +36,7 @@ The CLI commands remain the fallback when no MCP client is configured.
   internal/example-only imports.
 - Translate "compact", "standard", or "lightweight" requests into the existing
   application-wide presets in `src/design.svelte.ts`. Keep layout, form columns,
-  table density, and detail layout consistent. Change `src/design-selection.ts`
+  and detail layout consistent. Change `src/design-selection.ts`
   for the initial preset. Do not silently reset a user's saved preferences.
 - Preserve resource contracts, providers, permissions, routes, and active form
   values when making visual-only changes. Keep metric values provider-backed.

package/guidance/DESIGN.md

@@ -115,6 +115,12 @@ feedback for repeated operational work. The interface should feel like a real
 administrative product with trustworthy states, not a collection of dashboard
 templates.
 
+For business workflow, page selection, list density, operation ownership, and
+acceptance gates, read `docs/ENTERPRISE_PRODUCT_SYSTEM.md`. This document is
+the product-usage layer above the visual system: it explains how to use the
+published components to build useful enterprise workflows instead of treating
+the component catalog as a page design.
+
 Metronic is a capability reference only. Its page families, information
 architecture, and scenario coverage may expose missing components or examples,
 but its palette, decoration, card treatment, typography, and branding are not
@@ -131,7 +137,7 @@ not become a mixed visual theme:
 | --- | --- | --- |
 | Stripe style prompt | theme-menu chip `#635bff`, painted `--primary: oklch(0.54 0.24 293)`, technical grid, hairline borders, layered elevation, lift/depress feedback | Stripe brand assets, marketing gradients, oversized hero treatment |
 | Corporate-clean prompt | neutral enterprise surfaces, readable hierarchy, generous spacing, focus-ring offset, motion capped at 200ms | blue-only palette, rigid utility-class recipes, decorative cards |
-| Fuse / Midone / Skote | navigation anatomy, page-family coverage, toolbar/table/form composition, density observations | vendor palette, logos, fonts, CSS, copied markup or component chrome |
+| Fuse / Midone / Skote | navigation anatomy, page-family coverage, toolbar/table/form composition, layout observations | vendor palette, logos, fonts, CSS, copied markup or component chrome |
 | svadmin | semantic tokens, component API, state ownership, accessibility, responsive contracts | no second visual authority |
 
 When references conflict, svadmin semantics and accessibility win first, the
@@ -170,7 +176,7 @@ The same contract is used at every delivery surface:
   remains the preset chip `#635bff`, not the oklch `--primary` used by
   `@svadmin/ui`.
 
-Theme refinements must preserve component density, invalid and selected states.
+Theme refinements must preserve component geometry, invalid and selected states.
 Focus belongs to the active control, not every enclosing card. Search icons and
 clear actions use logical positioning so the same layout works in RTL.
 
@@ -205,7 +211,7 @@ and documentation:
    move the primary action or force an unnecessary page transition.
 3. **Consistent by contract:** semantic tokens, component variants, state names,
    page skeletons, and feedback lifecycles remain stable across products. Layout
-   presets may change density and composition, not interaction meaning.
+   presets may change composition, not interaction meaning.
 4. **Trustworthy in every state:** loading, empty, partial, error, forbidden,
    destructive, reversible, and completed states expose their scope and next
    step. Data freshness, permission boundaries, and action consequences must be
@@ -298,18 +304,20 @@ unframed layouts with a stable content width. Cards represent individual
 objects or bounded tools; page sections are not decorative floating cards and
 cards are not nested for visual effect.
 
-### Visual Density Dials
+### Spacing Rhythm
+
+svadmin components ship one comfortable baseline rhythm so pages scan
+consistently and generated output matches hand-built pages:
 
-svadmin components support systematic density levels to balance scanning speed
-and operational throughput:
+- **Components**: 4px/8px/16px rhythm with 40px–44px control heights and
+  40px–44px table row heights, used across `AutoTable`, `FilterToolbar`,
+  `RecordDetailDrawer`, forms, and operations work areas.
+- **Spacious onboarding or marketing surfaces** may widen vertical padding with
+  page-local layout choices, but must not fork component recipes.
 
-- **Density 8–10 (Dense / Dashboard)**: 2px/4px/8px rhythm with 28px–32px row
-  heights. Used for `AutoTable`, `FilterToolbar`, `RecordDetailDrawer`, and
-  operations work areas.
-- **Density 4–6 (Comfortable / Standard)**: 4px/8px/16px rhythm with 40px–44px
-  control heights. Used for settings forms, account profiles, and overview cards.
-- **Density 1–3 (Spacious / Onboarding)**: 16px/24px/32px rhythm for public
-  portals and introductory workflows.
+Density is not a component or page-pattern option; there is no compact or
+comfortable modifier to coordinate across `AutoTable`, `ContentPageShell`, or
+Surface widgets.
 
 ## Elevation & Depth
 
@@ -339,7 +347,9 @@ another titled page shell. Keep `DashboardPage` for existing dashboards.
 
 Use `PagePattern` for custom business compositions that do not fit those
 resource routes. It supplies layout only, not querying, permissions, form
-submission, or loading/error handling:
+submission, or business data fetching. It owns the default page-state
+presentation so custom pages do not need to recreate loading/error/empty
+layouts:
 
 - `list`: comfortable title, toolbar, table/list content, and list empty states.
 - `form`: narrow reading width, comfortable grouped fields and a single save area.
@@ -347,6 +357,13 @@ submission, or loading/error handling:
 - `workspace`: comfortable primary work area plus an optional secondary panel.
 - `dashboard`: wide layout with optional metrics and secondary context.
 
+Set `state` to `loading`, `empty`, `filtered-empty`, `error`, or `forbidden`
+while the page is not ready. Use `empty` only when the underlying collection is
+empty; use `filtered-empty` when filters excluded all records. Page content is
+hidden during those states, and the shared `DataState` component supplies the
+accessible default. Use `retry` only for `error`; use `stateAction` for an
+explicitly permitted next step. `ready` is the default.
+
 Optional `secondary` content renders beside the primary content for every kind.
 For advanced resizable, collapsible, or independently scrolling work areas,
 compose `WorkspaceLayout` or `MasterDetailView` directly. The pattern does not
@@ -398,10 +415,8 @@ cards, repeated title bars, or unrestricted two-column fields.
   persistence request succeeds; preserve edits after failure.
 - Separate initial-empty content from filtered-no-results content. Offer
   creation only when permitted, and clearing filters only when filters exist.
-- Page patterns default to comfortable density so generated and custom pages
-  have a consistent baseline. Use compact density explicitly for operational
-  work that prioritizes scanning speed; use comfortable density for forms and
-  general-purpose pages.
+- Page patterns use a single comfortable baseline so generated and custom pages
+  share the same rhythm across forms, detail, list, and workspace families.
 - Reference `packages/ui/stories/ConfigurationExample.svelte` in the SVAdmin
   source for a working composition; its save action is in-memory demo state,
   not a persistence implementation.
@@ -414,7 +429,7 @@ passing component tests alone does not establish visual acceptance.
 
 Buttons, fields, tabs, tables, badges, empty states, skeletons, alerts, and
 feedback use shared components and semantic tokens. Layout presets may adjust
-density and composition, but they must not replace component color, typography,
+composition, but they must not replace component color, typography,
 focus, or elevation with hard-coded values.
 
 ### Shell anatomy
@@ -462,11 +477,11 @@ Transitions provide clear state confirmation without delaying user action:
 The reference stack is layered. It is not a visual mixture:
 
 - **svadmin owns its visual principles:** hierarchy, restraint, neutral surfaces,
-  typography, density, and interaction tone.
+  typography, spacing, and interaction tone.
 - **Refine is an application-model reference:** resource routing, CRUD flows,
   provider state, access control, and mutation ownership.
 - **Ant Design is a behavior reference:** field validation, alerts, messages,
-  notifications, results, empty states, loading, and high-density data tasks.
+  notifications, results, empty states, loading, and data-heavy tasks.
 - **shadcn/ui is a composition reference:** accessible primitives, source-owned
   components, semantic tokens, variants, and AI-readable assembly patterns.
 - **Carbon and PatternFly are enterprise-pattern references:** notification

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/create",
-  "version": "0.41.2",
+  "version": "0.43.0",
   "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.1"
+    "@svadmin/core": "^0.62.0"
   },
   "keywords": [
     "svadmin",

package/scaffold-manifest.json

@@ -10,10 +10,10 @@
     "check": "svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "@svadmin/core": "^0.61.1",
-    "@svadmin/app": "^0.2.5",
-    "@svadmin/ai-elements": "^0.11.3",
-    "@svadmin/ui": "^0.85.0",
+    "@svadmin/core": "^0.62.0",
+    "@svadmin/app": "^0.2.6",
+    "@svadmin/ai-elements": "^0.12.0",
+    "@svadmin/ui": "^0.88.0",
     "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.6",
+        "@svadmin/simple-rest": "^0.12.7",
         "@refinedev/simple-rest": "^6.0.1"
       },
       "supabase": {
-        "@svadmin/supabase": "^0.19.3",
+        "@svadmin/supabase": "^0.19.4",
         "@supabase/supabase-js": "^2.112.4",
         "@refinedev/supabase": "^6.0.2"
       },
       "graphql": {
-        "@svadmin/graphql": "^0.12.6",
+        "@svadmin/graphql": "^0.12.7",
         "@refinedev/graphql": "^8.0.1",
         "graphql-request": "^7.4.0",
         "graphql": "^16.8.0"
       },
       "rest": {
-        "@svadmin/rest": "^0.2.5",
+        "@svadmin/rest": "^0.2.6",
         "@refinedev/rest": "^2.1.1",
         "@nestjsx/crud-request": "^5.0.0-alpha.3"
       },
       "airtable": {
-        "@svadmin/airtable": "^0.12.6",
+        "@svadmin/airtable": "^0.12.7",
         "@refinedev/airtable": "^5.0.1"
       },
       "appwrite": {
-        "@svadmin/appwrite": "^0.11.6",
+        "@svadmin/appwrite": "^0.11.7",
         "appwrite": ">=26.2.0",
         "@refinedev/appwrite": "^8.0.1"
       },
       "directus": {
-        "@svadmin/directus": "^0.11.6"
+        "@svadmin/directus": "^0.11.7"
       },
       "drizzle": {
-        "@svadmin/drizzle": "^0.14.3",
+        "@svadmin/drizzle": "^0.14.4",
         "drizzle-orm": "^1.0.0-rc.1",
         "refine-sqlx": "^0.10.3"
       },
       "elysia": {
-        "@svadmin/elysia": "^0.14.6",
+        "@svadmin/elysia": "^0.14.7",
         "elysia": ">=1.4.30",
         "@elysiajs/eden": ">=1.4.9"
       },
       "firebase": {
-        "@svadmin/firebase": "^0.12.6"
+        "@svadmin/firebase": "^0.12.7"
       },
       "hasura": {
-        "@svadmin/hasura": "^0.12.6",
+        "@svadmin/hasura": "^0.12.7",
         "@refinedev/hasura": "^7.0.1",
         "graphql-request": "^7.4.0"
       },
       "medusa": {
-        "@svadmin/medusa": "^0.12.6",
+        "@svadmin/medusa": "^0.12.7",
         "@refinedev/medusa": "^5.0.0"
       },
       "nestjs-query": {
-        "@svadmin/nestjs-query": "^0.12.6",
+        "@svadmin/nestjs-query": "^0.12.7",
         "@refinedev/nestjs-query": "^5.0.0"
       },
       "nestjsx-crud": {
-        "@svadmin/nestjsx-crud": "^0.12.6",
+        "@svadmin/nestjsx-crud": "^0.12.7",
         "@refinedev/nestjsx-crud": "^6.0.1"
       },
       "pocketbase": {
-        "@svadmin/pocketbase": "^0.13.3",
+        "@svadmin/pocketbase": "^0.13.4",
         "pocketbase": ">=0.28.0"
       },
       "sanity": {
-        "@svadmin/sanity": "^0.11.6"
+        "@svadmin/sanity": "^0.11.7"
       },
       "strapi": {
-        "@svadmin/strapi": "^0.12.6",
+        "@svadmin/strapi": "^0.12.7",
         "@refinedev/strapi-v4": "^7.0.1"
       }
     },