@svadmin/create 0.33.0 → 0.34.0

package/dist/index.js

@@ -5103,6 +5103,10 @@ function assertScaffoldManifest(candidate) {
   assertStringRecord(candidate["scripts"], "scaffold manifest.scripts");
   assertStringRecord(candidate["dependencies"], "scaffold manifest.dependencies");
   assertStringRecord(candidate["devDependencies"], "scaffold manifest.devDependencies");
+  for (const key of ["overrides", "patchedDependencies"]) {
+    if (candidate[key] !== undefined)
+      assertStringRecord(candidate[key], `scaffold manifest.${key}`);
+  }
   assertJsonObject(candidate["svadmin"], "scaffold manifest.svadmin");
   assertDependencyPacks(candidate["svadmin"]["dependencyPacks"]);
   assertSelectionMap(candidate["svadmin"]["dataProviders"], DATA_PROVIDER_CHOICES, "scaffold manifest.svadmin.dataProviders");
@@ -5145,7 +5149,9 @@ function createProjectPackageJson(scaffold, options) {
     type: scaffold.type,
     scripts: { ...scaffold.scripts },
     dependencies,
-    devDependencies: { ...scaffold.devDependencies }
+    devDependencies: { ...scaffold.devDependencies },
+    ...scaffold.overrides ? { overrides: { ...scaffold.overrides } } : {},
+    ...scaffold.patchedDependencies ? { patchedDependencies: { ...scaffold.patchedDependencies } } : {}
   };
 }
 
@@ -7187,6 +7193,17 @@ var SCAFFOLD_MIGRATION_NOTES = [
 var SCAFFOLD_UI_COMPONENTS = [
   ...[
     "AdminApp",
+    "ResourceOverview",
+    "DashboardPage",
+    "PageSection",
+    "ContentPageShell",
+    "ContentPageHeader",
+    "SectionHeader",
+    "WorkspaceLayout",
+    "MetricBlock",
+    "FilterToolbar",
+    "SettingsGroup",
+    "SettingsFieldRow",
     "AutoTable",
     "AutoForm",
     "ShowPage",
@@ -8391,6 +8408,8 @@ ${import_picocolors4.default.bold("Scaffolding")} project in ${import_picocolors
     const entries = fs5.readdirSync(src, { withFileTypes: true });
     for (const entry of entries) {
       const srcPath = path5.join(src, entry.name);
+      if (srcPath === path5.join(templateDir, "src", "providers", "supabase.ts") && response.dataProvider !== "supabase" && response.authProvider !== "supabase")
+        continue;
       const destPath = path5.join(dest, entry.name === "_gitignore" ? ".gitignore" : entry.name);
       if (entry.isDirectory()) {
         copyDir(srcPath, destPath);
@@ -8457,24 +8476,23 @@ bun run dev
 - **State**: TanStack Query v6
 `);
   console.log(import_picocolors4.default.green("  ✔") + " README.md generated");
+  let dependenciesInstalled = false;
   if (response.installDeps) {
     console.log(`
 ${import_picocolors4.default.bold("Installing dependencies...")}
 `);
     const bunInstall = spawnSync("bun", ["install"], { cwd: projectDir, stdio: "inherit" });
-    if (bunInstall.status !== 0) {
-      const npmInstall = spawnSync("npm", ["install"], { cwd: projectDir, stdio: "inherit" });
-      if (npmInstall.status !== 0) {
-        console.log(import_picocolors4.default.yellow("\n  ⚠ Auto-install failed. Run `bun install` or `npm install` manually."));
-      }
+    dependenciesInstalled = bunInstall.status === 0;
+    if (!dependenciesInstalled) {
+      console.log(import_picocolors4.default.yellow("\n  ⚠ Auto-install failed. Run `bun install` manually; this template requires Bun to apply dependency patches."));
     }
   }
   console.log();
-  console.log(import_picocolors4.default.green(import_picocolors4.default.bold("  ✔ Project ready!")));
+  console.log(import_picocolors4.default.green(import_picocolors4.default.bold(dependenciesInstalled ? "  ✔ Project ready!" : "  ✔ Project generated. Dependencies still need installation.")));
   console.log();
   console.log("  Next steps:");
   console.log(`    ${import_picocolors4.default.cyan(`cd ${response.projectName}`)}`);
-  if (!response.installDeps) {
+  if (!dependenciesInstalled) {
     console.log(`    ${import_picocolors4.default.cyan("bun install")}`);
   }
   console.log(`    ${import_picocolors4.default.cyan("bun run dev")}`);

package/guidance/AGENTS.md

@@ -26,6 +26,29 @@ business code inside `src/features/<module>/` and expose it through the module's
 
 ## Required workflow
 
+### Default-first page composition
+
+- Start with `AdminApp`, a provider bundle, and schema-backed resources. Its
+  default layout is clean-flat; the default color is Stripe unless the user has
+  saved another selection. Keep explicit theme overrides only for intentional changes.
+- Keep the built-in list/create/edit/show routes unless the business workflow
+  needs a different composition. Do not replace CRUD with static demo tables.
+- Use `ResourceOverview` for a permission-aware resource entry page.
+- Use `DashboardPage` with `metrics`, `actions`, `secondary`, and default snippets
+  for dashboards; use `PageSection`, `WorkspaceLayout`, `FilterToolbar`,
+  `SettingsGroup`, and `SettingsFieldRow` for other page compositions.
+- Import components from `@svadmin/ui` and styles from `@svadmin/ui/app.css`.
+  Never import example files or copy example-only CSS into a consumer.
+- Metrics must come from the application's provider. Do not manufacture totals,
+  success states, actions, or backend capabilities to fill a layout.
+- Verify a generated application without resource-page overrides or custom CSS
+  before adding domain-specific presentation. Check list, create, edit, show,
+  validation, denied permissions, empty/error/loading states, and mobile layouts.
+- Keep the generated Bun dependency overrides and `patches/` together. They
+  carry tested upstream declaration fixes; do not remove them or enable
+  `skipLibCheck` merely to silence dependency errors. Re-run `bun run check`
+  and `bun run build` after upgrading a patched dependency.
+
 1. Name the page's single primary workflow and dominant next action.
 2. Inventory every heading, description, notice, metric, badge, and data view.
 3. Assign each fact and event to one primary UI surface.

package/guidance/DESIGN.md

@@ -141,12 +141,43 @@ The same contract is used at every delivery surface:
   `clean-flat + stripe` refinement; host applications consume this stylesheet.
 - `packages/core/src/theme.svelte.ts` owns the `stripe` color preset and mode
   attributes; it must stay aligned with the CSS fallback values.
-- `example/src/App.svelte` is the reference application and starts with
-  `layoutPreset: 'clean-flat'` and `colorPreset: 'stripe'`.
+- `AdminApp` supplies `clean-flat` as a fallback layout without taking over an
+  explicit theme owner. Core supplies the default Stripe color and preserves
+  saved user selections; `layoutPreset: 'default'` remains an explicit opt-out.
+- `example/src/App.svelte` consumes these defaults without repeating theme
+  configuration. A bare `AdminApp` renders `ResourceOverview` on its home route.
+- `DashboardPage`, `PageSection`, `WorkspaceLayout`, and the content components
+  own reusable page composition in the published UI package. Example modules
+  own business queries and decisions, not private replacements for these layouts.
 - `packages/create-svadmin/template` starts new projects with the same theme
   and guidance document, so generated apps do not drift from the example.
 - `design/admin-ui/preview` renders the published package CSS and uses the same
   Stripe preset for component and state review.
+- `packages/flow` resolves explicit flow overrides first, then host semantic
+  tokens, then standalone Stripe-compatible fallback colors.
+- `packages/editor`, `packages/surface`, and `packages/ai-elements` consume
+  complete CSS color tokens, not HSL channel tuples. Independent stylesheets
+  use motion-token fallbacks so they also work without the full UI package.
+- `packages/lite` mirrors the palette with literal colors. Its legacy-browser
+  contract deliberately excludes custom properties and modern selectors;
+  visual alignment must not remove that compatibility.
+
+Theme refinements must preserve component density, 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.
+
+Settings pages use `ContentPageHeader` with one page-level `h1`. When embedded
+inside another page, pass `headingLevel="h2"` and use `h3` for nested
+`SettingsGroup` headings. `SettingsFieldRow.controlId` associates the visible
+label with its native control; IDs must be unique per component instance.
+Segmented settings expose their selected option with `aria-pressed`, retain
+their value after reload, and normalize unsupported persisted values.
+Invalid fields expose `aria-invalid` and associate the visible error through
+`aria-describedby`; valid sibling fields stay neutral. Clearing an error also
+removes its association. Verify label activation with two mounted instances,
+not only matching label text. Provider-backed settings retain their disabled
+state when no provider is configured; demo screenshots are not persistence
+evidence.
 
 Do not add page-local palettes or shadow values when a semantic token exists.
 If a new reference suggests a different treatment, record its responsibility
@@ -247,8 +278,8 @@ glow. Dialogs and menus receive stronger depth because they are floating
 layers. Dark mode keeps the same hierarchy with low-chroma surfaces.
 
 - **Control Shadow**: `0 1px 2px rgb(15 23 42 / 0.04), 0 0 0 1px rgb(15 23 42 / 0.02)`
-- **Surface Shadow**: `0 2px 4px rgb(15 23 42 / 0.04), 0 8px 16px rgb(15 23 42 / 0.08)`
-- **Surface Hover Shadow**: `0 4px 8px rgb(15 23 42 / 0.06), 0 16px 32px rgb(15 23 42 / 0.1)`
+- **Surface Shadow**: `0 1px 3px rgb(15 23 42 / 0.04), 0 4px 8px rgb(15 23 42 / 0.04)`
+- **Surface Hover Shadow**: `0 2px 4px rgb(15 23 42 / 0.06), 0 6px 12px rgb(15 23 42 / 0.06)`
 - **Overlay Shadow**: `0 20px 52px rgb(15 23 42 / 0.18), 0 6px 16px rgb(15 23 42 / 0.1)`
 
 ## Shapes
@@ -270,8 +301,10 @@ Transitions provide clear state confirmation without delaying user action:
 
 - **Timing**: Micro-transitions use 150ms–200ms with `ease-out`; never use
   `ease-in-out` for routine controls.
-- **Feedback**: Buttons may lift by 2px on hover and depress to `scale(0.98)`
-  on press. Interactive cards may lift by 4px; hover never scales a card.
+- **Feedback**: Enabled buttons may lift by 2px on fine-pointer hover and
+  depress to `scale(0.98)` on press. Neither transform runs with reduced
+  motion. Interactive cards change border and shadow only, without moving.
+  Disabled controls never lift or depress.
 - **Focus Rings**: Operable controls declare `:focus-visible` with a 2px solid
   ring and a 2px offset.
 - **Accessibility**: All transitions and keyframe animations collapse to 0.01ms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@svadmin/create",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Scaffolding tool for svadmin projects",
   "type": "module",
   "bin": {

package/scaffold-manifest.json

@@ -13,22 +13,33 @@
     "@svadmin/core": "^0.57.0",
     "@svadmin/app": "^0.2.0",
     "@svadmin/ai-elements": "^0.10.2",
-    "@svadmin/ui": "^0.77.0",
+    "@svadmin/ui": "^0.78.0",
     "@sinclair/typebox": "^0.34.52",
     "@tanstack/svelte-query": "^6.1.48",
     "@lucide/svelte": "^1.35.0"
   },
   "devDependencies": {
+    "@types/node": "^22.0.0",
+    "esbuild": "^0.28.2",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "svelte": "^5.56.10",
     "svelte-check": "^4.7.6",
     "typescript": "~6.0.3",
     "vite": "^8.2.2"
   },
+  "overrides": {
+    "bits-ui": "2.19.0",
+    "@refinedev/core": "5.0.12"
+  },
+  "patchedDependencies": {
+    "bits-ui@2.19.0": "patches/bits-ui@2.19.0.patch",
+    "@refinedev/core@5.0.12": "patches/@refinedev%2Fcore@5.0.12.patch"
+  },
   "svadmin": {
     "dependencyPacks": {
       "refine-core": {
-        "@refinedev/core": "^5.0.12"
+        "@refinedev/core": "^5.0.12",
+        "graphql": "^16.8.0"
       },
       "simple-rest": {
         "@svadmin/simple-rest": "^0.12.1",

package/template/patches/@refinedev%2Fcore@5.0.12.patch

@@ -0,0 +1,30 @@
+diff --git a/dist/hooks/useKeys/index.d.cts b/dist/hooks/useKeys/index.d.cts
+index 84d443c471dbcf0d4206dd7130703eec3be0b19d..bb4574fcee52c3f0588a18f78ec5d8a0e2059bf5 100644
+--- a/dist/hooks/useKeys/index.d.cts
++++ b/dist/hooks/useKeys/index.d.cts
+@@ -1,4 +1,4 @@
+ export declare const useKeys: () => {
+-    keys: () => import("@definitions/index").KeyBuilder;
++    keys: () => import("../../definitions/index").KeyBuilder;
+ };
+ //# sourceMappingURL=index.d.ts.map
+diff --git a/dist/hooks/useKeys/index.d.mts b/dist/hooks/useKeys/index.d.mts
+index 84d443c471dbcf0d4206dd7130703eec3be0b19d..bb4574fcee52c3f0588a18f78ec5d8a0e2059bf5 100644
+--- a/dist/hooks/useKeys/index.d.mts
++++ b/dist/hooks/useKeys/index.d.mts
+@@ -1,4 +1,4 @@
+ export declare const useKeys: () => {
+-    keys: () => import("@definitions/index").KeyBuilder;
++    keys: () => import("../../definitions/index").KeyBuilder;
+ };
+ //# sourceMappingURL=index.d.ts.map
+diff --git a/dist/hooks/useKeys/index.d.ts b/dist/hooks/useKeys/index.d.ts
+index 84d443c471dbcf0d4206dd7130703eec3be0b19d..bb4574fcee52c3f0588a18f78ec5d8a0e2059bf5 100644
+--- a/dist/hooks/useKeys/index.d.ts
++++ b/dist/hooks/useKeys/index.d.ts
+@@ -1,4 +1,4 @@
+ export declare const useKeys: () => {
+-    keys: () => import("@definitions/index").KeyBuilder;
++    keys: () => import("../../definitions/index").KeyBuilder;
+ };
+ //# sourceMappingURL=index.d.ts.map