@sudajs/cli 0.8.1 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudajs/cli",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "type": "module",
   "bin": {
     "suda": "./bin/suda.js"
@@ -32,7 +32,7 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "zod": "^3.24.1",
-    "@sudajs/theme-engine": "2.2.0"
+    "@sudajs/theme-engine": "2.3.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.0",
@@ -47,9 +47,9 @@
     "typescript": "^5.7.2",
     "vite": "^7.3.3",
     "vitest": "^3.2.4",
+    "@suda/build-config": "0.0.0",
     "@suda/eslint-config": "0.0.0",
-    "@suda/tsconfig": "0.0.0",
-    "@suda/build-config": "0.0.0"
+    "@suda/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/templates/theme/AGENTS.md

@@ -12,7 +12,8 @@ This directory is a standalone Vite + React + Tailwind Suda theme generated by `
 ## Styling
 
 - Tailwind v4 starts in `src/styles.css` with `@import "tailwindcss";` and `@source "./**/*.{ts,tsx}";`.
-- Theme-local assets live in `src/assets/`; the CLI copies them to `dist/assets/` during build.
+- Theme-local assets live in top-level `assets/`; the CLI copies them to `dist/assets/` during build. Use `themeAsset("assets/...")` instead of importing images from React code.
+- Preview screenshots are required at `assets/preview/desktop.png`, `assets/preview/tablet.png`, and `assets/preview/mobile.png`; run `suda theme capture` to generate them.
 - Customize `vite.config.ts`, `postcss.config.mjs`, and `src/styles.css` as needed.
 
 ## Commands

package/templates/theme/README.md

@@ -19,9 +19,18 @@ pnpm build
 pnpm validate
 ```
 
-`pnpm dev` starts the Vite-powered preview. `pnpm build` produces the Suda artifact contract in `dist/`, including `dist/index.js`, `dist/runtime.client.js`, `dist/manifest.json`, and `dist/styles.css`.
+`pnpm dev` starts the Vite-powered preview. `pnpm build` produces the Suda artifact contract in `dist/`, including `dist/index.js`, `dist/runtime.client.js`, `dist/manifest.json`, and `dist/styles.css`. Published artifact paths omit the local `dist/` prefix.
 
-Theme-local assets live in `src/assets/`. The starter hero exposes a Logo field that defaults to `src/assets/suda-logo.svg`, so you can replace it with your own brand image or choose a different image in the editor.
+Theme-local assets live in top-level `assets/`. The starter hero exposes a Logo field that defaults to `assets/brand/suda-logo.svg`, so you can replace it with your own brand image or choose a different image in the editor.
+
+Preview screenshots are required before publishing:
+
+```bash
+suda theme capture
+pnpm build
+```
+
+By default capture writes `assets/preview/desktop.png`, `assets/preview/tablet.png`, and `assets/preview/mobile.png`.
 
 Fields can use `visibleIf: ({ props }, { fields }) => boolean` for synchronous dynamic visibility. The starter hero shows this by hiding the Logo picker when `showLogo` is false. Suda converts `visibleIf` to Puck `resolveFields` during normalization, and the generated AI/MCP section schema marks those fields as dynamically visible.
 

package/templates/theme/src/manifest.ts

@@ -9,8 +9,8 @@ export const sourceManifest: ThemeSourceManifest = {
   name: "__SUDA_THEME_KEY__",
   categories: ["other"],
   minEngineVersion: "0.0.0",
-  entry: "dist/index.js",
-  clientEntry: "dist/runtime.client.js",
+  entry: "index.js",
+  clientEntry: "runtime.client.js",
   // Required. SudaCloud currently hosts SSR themes only; CSR/Hybrid postures
   // are on the roadmap. Authoring `renderMode` is the contract a theme uses
   // to declare which posture it expects from the host.

package/templates/theme/src/sections.tsx

@@ -63,7 +63,7 @@ export const Hero: SudaComponentConfig<HeroProps> = {
   },
   defaultProps: {
     showLogo: true,
-    logo: themeAsset("assets/suda-logo.svg"),
+    logo: themeAsset("assets/brand/suda-logo.svg"),
     eyebrow: "New theme",
     title: "Build with SudaCloud",
     description: "Edit this starter section in the visual editor.",

package/templates/theme/src/templates.ts

@@ -14,7 +14,7 @@ export const starterPages: ThemeStarterPage[] = [
           type: "Hero",
           props: {
             id: "Hero-1",
-            logo: themeAsset("assets/suda-logo.svg"),
+            logo: themeAsset("assets/brand/suda-logo.svg"),
             eyebrow: "Starter page",
             title: "Welcome to __SUDA_THEME_KEY__",
             description: "This page was generated by suda theme init.",