@svadmin/create 0.40.3 → 0.41.1

package/guidance/AGENTS.md

@@ -4,6 +4,17 @@ Read `DESIGN.md` before creating, revising, or reviewing any UI. It is the
 authority for visual language, page hierarchy, feedback ownership, and
 acceptance checks in this project.
 
+## Product-first generation
+
+Read `PRODUCT.md` before converting a schema, API, or feature list into pages. Build the product brief, workflows, resources, actions, surfaces, and menu in that order. Resources are data contracts; they are not automatic pages or menu entries.
+
+- Keep one primary purpose and one dominant next action per surface.
+- Give every core workflow a serving surface or contextual entry.
+- Declare loading, empty, error, forbidden, and success states before writing markup.
+- Menu count is determined by actual business needs. Never apply a fixed global cap; use roles, task frequency, placement, grouping, and context to keep it legible.
+- Run `svadmin vibe review ./svadmin.product.json` before generating UI and `svadmin vibe plan ./svadmin.product.json --role <role-id>` to inspect role-specific navigation.
+- Treat review warnings as prompts for product judgment. Do not silently delete business-required workflows or menu entries to make a count pass.
+
 ## Platform entrypoints
 
 Before generating or modifying application code, read these stable files

package/guidance/PRODUCT.md

@@ -0,0 +1,29 @@
+# Product-first generation rules
+
+svadmin generates an admin application from business decisions, not from a raw resource list. Read this file before turning an API, database schema, or feature request into UI.
+
+## Decision order
+
+1. Write the product brief: primary outcome, audience, constraints, non-goals, and assumptions.
+2. List the real workflows in actor language. Each core workflow needs a trigger, goal, steps, success criteria, exceptions, priority, and frequency.
+3. Register resources as data contracts. A resource can be contextual or internal; it does not automatically become a page or menu item.
+4. Define actions with an owning workflow and role visibility.
+5. Define surfaces by purpose. Keep one primary action per surface, declare empty/loading/error/forbidden/success states, and move secondary actions into context or More.
+6. Define menu nodes last. Every node should point to a workflow, resource, or surface and declare the roles that need it.
+
+## Menu policy
+
+There is no fixed menu-count limit. A small product may need one entry; a large operational product may need many. Do not delete business-required entries to satisfy an arbitrary count. Use role visibility, workflow frequency, placement, grouping, and contextual entries to keep the navigation legible. Backend authorization remains authoritative; menu visibility is only a UI hint.
+
+## CLI review loop
+
+Store the plan as JSON using schema version `product/v1`, then run:
+
+- `svadmin vibe review ./svadmin.product.json` to report orphan resources, unserved workflows, unknown references, missing states, and dense surfaces.
+- `svadmin vibe plan ./svadmin.product.json --role operator` to inspect the role-specific menu and generated page plans.
+
+Fix product review errors before generating Svelte markup. Warnings are review prompts, not automatic page deletion rules.
+
+## Visual acceptance
+
+Generated pages must have one clear purpose, one dominant next action, and an explicit state contract. Prefer the existing `@svadmin/ui` page families and semantic tokens. Inspect long labels, dense tables, empty results, denied permissions, failures, and mobile layouts before accepting the result.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/create",
-  "version": "0.40.3",
+  "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.60.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.60.0",
-    "@svadmin/app": "^0.2.3",
-    "@svadmin/ai-elements": "^0.11.1",
-    "@svadmin/ui": "^0.83.2",
+    "@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.4",
+        "@svadmin/simple-rest": "^0.12.6",
         "@refinedev/simple-rest": "^6.0.1"
       },
       "supabase": {
-        "@svadmin/supabase": "^0.19.1",
+        "@svadmin/supabase": "^0.19.3",
         "@supabase/supabase-js": "^2.112.4",
         "@refinedev/supabase": "^6.0.2"
       },
       "graphql": {
-        "@svadmin/graphql": "^0.12.4",
+        "@svadmin/graphql": "^0.12.6",
         "@refinedev/graphql": "^8.0.1",
         "graphql-request": "^7.4.0",
         "graphql": "^16.8.0"
       },
       "rest": {
-        "@svadmin/rest": "^0.2.3",
+        "@svadmin/rest": "^0.2.5",
         "@refinedev/rest": "^2.1.1",
         "@nestjsx/crud-request": "^5.0.0-alpha.3"
       },
       "airtable": {
-        "@svadmin/airtable": "^0.12.4",
+        "@svadmin/airtable": "^0.12.6",
         "@refinedev/airtable": "^5.0.1"
       },
       "appwrite": {
-        "@svadmin/appwrite": "^0.11.4",
+        "@svadmin/appwrite": "^0.11.6",
         "appwrite": ">=26.2.0",
         "@refinedev/appwrite": "^8.0.1"
       },
       "directus": {
-        "@svadmin/directus": "^0.11.4"
+        "@svadmin/directus": "^0.11.6"
       },
       "drizzle": {
-        "@svadmin/drizzle": "^0.14.1",
+        "@svadmin/drizzle": "^0.14.3",
         "drizzle-orm": "^1.0.0-rc.1",
         "refine-sqlx": "^0.10.3"
       },
       "elysia": {
-        "@svadmin/elysia": "^0.14.4",
+        "@svadmin/elysia": "^0.14.6",
         "elysia": ">=1.4.30",
         "@elysiajs/eden": ">=1.4.9"
       },
       "firebase": {
-        "@svadmin/firebase": "^0.12.4"
+        "@svadmin/firebase": "^0.12.6"
       },
       "hasura": {
-        "@svadmin/hasura": "^0.12.4",
+        "@svadmin/hasura": "^0.12.6",
         "@refinedev/hasura": "^7.0.1",
         "graphql-request": "^7.4.0"
       },
       "medusa": {
-        "@svadmin/medusa": "^0.12.4",
+        "@svadmin/medusa": "^0.12.6",
         "@refinedev/medusa": "^5.0.0"
       },
       "nestjs-query": {
-        "@svadmin/nestjs-query": "^0.12.4",
+        "@svadmin/nestjs-query": "^0.12.6",
         "@refinedev/nestjs-query": "^5.0.0"
       },
       "nestjsx-crud": {
-        "@svadmin/nestjsx-crud": "^0.12.4",
+        "@svadmin/nestjsx-crud": "^0.12.6",
         "@refinedev/nestjsx-crud": "^6.0.1"
       },
       "pocketbase": {
-        "@svadmin/pocketbase": "^0.13.1",
+        "@svadmin/pocketbase": "^0.13.3",
         "pocketbase": ">=0.28.0"
       },
       "sanity": {
-        "@svadmin/sanity": "^0.11.4"
+        "@svadmin/sanity": "^0.11.6"
       },
       "strapi": {
-        "@svadmin/strapi": "^0.12.4",
+        "@svadmin/strapi": "^0.12.6",
         "@refinedev/strapi-v4": "^7.0.1"
       }
     },