@sudajs/cli 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudajs/cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "type": "module",
   "bin": {
     "suda": "./bin/suda.js"
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@puckeditor/core": "^0.21.3",
+    "@puckeditor/core": "^0.22.0",
     "commander": "^12.1.0",
     "esbuild": "^0.25.12",
     "lucide-react": "^1.17.0",
@@ -34,7 +34,7 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "zod": "^3.24.1",
-    "@sudajs/theme-engine": "3.0.0"
+    "@sudajs/theme-engine": "4.0.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.0",
@@ -49,8 +49,8 @@
     "typescript": "^5.7.2",
     "vite": "^7.3.3",
     "vitest": "^3.2.4",
-    "@suda/eslint-config": "0.0.0",
     "@suda/build-config": "0.0.0",
+    "@suda/eslint-config": "0.0.0",
     "@suda/tsconfig": "0.0.0"
   },
   "scripts": {

package/templates/theme/AGENTS.md

@@ -308,8 +308,8 @@ example `FeaturedPosts`, `LatestPosts`, or `TopicPosts`. Use it for homepage
 insights, featured articles, case studies, news teasers, or tag-filtered post
 groups on ordinary pages.
 
-Define that section with exactly one top-level `type: "posts"` field and a
-default query on the same prop:
+Define that section with one or more top-level `type: "posts"` fields and a
+default query on each matching prop:
 
 ```tsx
 fields: {
@@ -320,10 +320,13 @@ defaultProps: {
 },
 ```
 
-Supported strategies are `latest`, `featured`, `by_tag`, and `manual`. In the
-section render function, call `getPostResource(puck?.metadata, id)` to get the
-posts. Never import Prisma, call platform APIs, or query the database from
-theme code.
+Supported strategies are `latest`, `featured`, `by_tag`, and `manual`. Manual
+queries store only `items` and must not include `limit`. Runtime post resources
+are keyed as `${props.id}.${fieldKey}` with both parts URL-encoded by the
+platform. In the section render function, call
+`getPostResource(puck?.metadata, { componentId: props.id, fieldKey: "postList" })`
+with the exact posts field key. Never import Prisma, call platform APIs, or
+query the database from theme code.
 
 Starter pages must include one home/index page with `isHome: true`. Recommended
 starter pages include `index`, `about-us`, `contact-us`, `services`, and `team`.

package/templates/theme/package.json

@@ -19,7 +19,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.4",
     "@tailwindcss/postcss": "^4.3.0",
-    "@puckeditor/core": "^0.21.3",
+    "@puckeditor/core": "^0.22.0",
     "@sudajs/cli": "*",
     "@sudajs/theme-engine": "*",
     "@types/node": "^24.13.2",
@@ -42,7 +42,7 @@
     "vite": "^8.1.0"
   },
   "peerDependencies": {
-    "@puckeditor/core": "^0.21.3",
+    "@puckeditor/core": "^0.22.0",
     "@sudajs/theme-engine": "*",
     "lucide-react": "^1.17.0",
     "react": "^19.2.7",

package/templates/theme/src/layout.tsx

@@ -1,11 +1,21 @@
 import type { SudaComponentConfig, SudaRootConfig } from "@sudajs/theme-engine";
-import { getIcpRecord, getPageSlot, getWhiteLabel } from "@sudajs/theme-engine/runtime";
+import {
+  createThemeDesignCssVariables,
+  createThemeDesignDefault,
+  designSystemField,
+  getIcpRecord,
+  getPageSlot,
+  getWhiteLabel,
+  resolveThemeDesignTokens,
+  type ThemeDesignValue,
+} from "@sudajs/theme-engine/runtime";
 import type { ReactElement, ReactNode } from "react";
 
 import { t } from "./i18n.js";
+import { sourceManifest } from "./manifest.js";
 
 type PuckExtras = { puck?: { metadata?: Record<string, unknown> } };
-type RootProps = { children?: ReactNode; title?: string };
+type RootProps = { children?: ReactNode; title?: string; designSystem?: ThemeDesignValue };
 type HeaderProps = { siteName?: string };
 type PageOutletProps = PuckExtras;
 type FooterProps = { text?: string } & PuckExtras;
@@ -13,13 +23,21 @@ type FooterProps = { text?: string } & PuckExtras;
 export const rootConfig: SudaRootConfig<RootProps> = {
   fields: {
     title: { type: "text", label: t("layout.root.fields.title") },
+    designSystem: designSystemField(t("layout.root.fields.designSystem"), sourceManifest.designSystem),
+  },
+  defaultProps: {
+    title: "__SUDA_THEME_KEY__",
+    designSystem: createThemeDesignDefault(sourceManifest.designSystem),
+  },
+  render: ({ children, designSystem, title }) => {
+    const tokens = resolveThemeDesignTokens(sourceManifest.designSystem, designSystem);
+    const style = createThemeDesignCssVariables(tokens);
+    return (
+      <div className="__SUDA_THEME_KEY__-root" data-site-name={title} style={style}>
+        {children}
+      </div>
+    );
   },
-  defaultProps: { title: "__SUDA_THEME_KEY__" },
-  render: ({ children, title }) => (
-    <div className="__SUDA_THEME_KEY__-root" data-site-name={title}>
-      {children}
-    </div>
-  ),
 };
 
 export const Header: SudaComponentConfig<HeaderProps> = {

package/templates/theme/src/locales/en.json

@@ -2,7 +2,8 @@
   "layout": {
     "root": {
       "fields": {
-        "title": "Site title"
+        "title": "Site title",
+        "designSystem": "Design system"
       }
     },
     "header": {

package/templates/theme/src/manifest.ts

@@ -8,7 +8,55 @@ export const sourceManifest: ThemeSourceManifest = {
   key: "__SUDA_THEME_KEY__",
   name: "__SUDA_THEME_KEY__",
   categories: ["other"],
-  minEngineVersion: "0.0.0",
+  minEngineVersion: "4.0.0",
+  designSystem: {
+    version: 1,
+    defaultPresetId: "default",
+    presets: [
+      {
+        id: "default",
+        label: "Default",
+        tokens: {
+          colors: {
+            background: "#ffffff",
+            foreground: "#111827",
+            primary: "#111827",
+            primaryForeground: "#ffffff",
+            accent: "#f8fafc",
+            accentForeground: "#111827",
+            muted: "#f4f5f7",
+            mutedForeground: "#4b5563",
+          },
+          radius: {
+            card: "8px",
+            button: "8px",
+            input: "8px",
+          },
+        },
+      },
+      {
+        id: "ocean",
+        label: "Ocean",
+        tokens: {
+          colors: {
+            background: "#f8fbff",
+            foreground: "#0e1b36",
+            primary: "#2563eb",
+            primaryForeground: "#ffffff",
+            accent: "#dbeafe",
+            accentForeground: "#0e1b36",
+            muted: "#eff6ff",
+            mutedForeground: "#42526e",
+          },
+          radius: {
+            card: "14px",
+            button: "9999px",
+            input: "10px",
+          },
+        },
+      },
+    ],
+  },
   entry: "index.js",
   clientEntry: "runtime.client.js",
   // Required. SudaCloud currently hosts SSR themes only; CSR/Hybrid postures

package/templates/theme/src/sections.tsx

@@ -240,7 +240,10 @@ export const FeaturedPosts: SudaComponentConfig<FeaturedPostsProps> = {
     postList: { strategy: "featured", limit: 3 },
   },
   render: ({ id, title, description, puck }) => {
-    const resource = getPostResource(puck?.metadata, id);
+    const resource = getPostResource(puck?.metadata, {
+      componentId: id,
+      fieldKey: "postList",
+    });
     const posts = resource.posts;
     return (
       <section className="__SUDA_THEME_KEY__-section">

package/templates/theme/src/styles.css

@@ -3,22 +3,22 @@
 
 .__SUDA_THEME_KEY__-root {
   font-family: Inter, ui-sans-serif, system-ui, sans-serif;
-  color: #111827;
-  background: #ffffff;
+  color: var(--suda-color-foreground, #111827);
+  background: var(--suda-color-background, #ffffff);
 }
 .__SUDA_THEME_KEY__-header,
 .__SUDA_THEME_KEY__-footer {
   padding: 20px clamp(20px, 5vw, 64px);
-  border-bottom: 1px solid #e5e7eb;
+  border-bottom: 1px solid var(--suda-color-muted, #e5e7eb);
 }
 .__SUDA_THEME_KEY__-footer {
   display: flex;
   flex-wrap: wrap;
   align-items: center;
   gap: 12px 20px;
-  border-top: 1px solid #e5e7eb;
+  border-top: 1px solid var(--suda-color-muted, #e5e7eb);
   border-bottom: 0;
-  color: #6b7280;
+  color: var(--suda-color-muted-foreground, #6b7280);
 }
 .__SUDA_THEME_KEY__-footer a {
   display: inline-flex;
@@ -35,19 +35,19 @@
   padding: 64px clamp(20px, 5vw, 64px);
 }
 .__SUDA_THEME_KEY__-hero {
-  background: #f8fafc;
+  background: var(--suda-color-accent, #f8fafc);
 }
 .__SUDA_THEME_KEY__-hero-logo {
   width: 64px;
   height: 64px;
-  border-radius: 14px;
+  border-radius: var(--suda-radius-card, 14px);
   margin-bottom: 24px;
 }
 .__SUDA_THEME_KEY__-eyebrow {
   text-transform: uppercase;
   letter-spacing: 0.08em;
   font-size: 12px;
-  color: #2563eb;
+  color: var(--suda-color-primary, #2563eb);
   font-weight: 700;
 }
 .__SUDA_THEME_KEY__-section h1 {
@@ -65,16 +65,16 @@
 .__SUDA_THEME_KEY__-section p {
   max-width: 680px;
   line-height: 1.7;
-  color: #4b5563;
+  color: var(--suda-color-muted-foreground, #4b5563);
 }
 .__SUDA_THEME_KEY__-button {
   display: inline-flex;
   align-items: center;
   min-height: 42px;
   padding: 0 18px;
-  border-radius: 8px;
-  background: #111827;
-  color: #ffffff;
+  border-radius: var(--suda-radius-button, 8px);
+  background: var(--suda-color-primary, #111827);
+  color: var(--suda-color-primary-foreground, #ffffff);
   text-decoration: none;
   font-weight: 700;
 }
@@ -85,14 +85,14 @@
   margin-top: 28px;
 }
 .__SUDA_THEME_KEY__-card {
-  border: 1px solid #e5e7eb;
-  border-radius: 8px;
+  border: 1px solid var(--suda-color-muted, #e5e7eb);
+  border-radius: var(--suda-radius-card, 8px);
   padding: 20px;
 }
 .__SUDA_THEME_KEY__-card-icon {
   width: 24px;
   height: 24px;
-  color: #2563eb;
+  color: var(--suda-color-primary, #2563eb);
 }
 .__SUDA_THEME_KEY__-quote blockquote {
   max-width: 780px;
@@ -101,15 +101,15 @@
   margin: 0 0 16px;
 }
 .__SUDA_THEME_KEY__-cta {
-  background: #111827;
-  color: #ffffff;
+  background: var(--suda-color-foreground, #111827);
+  color: var(--suda-color-background, #ffffff);
 }
 .__SUDA_THEME_KEY__-cta p {
-  color: #d1d5db;
+  color: var(--suda-color-muted, #d1d5db);
 }
 .__SUDA_THEME_KEY__-cta .__SUDA_THEME_KEY__-button {
-  background: #ffffff;
-  color: #111827;
+  background: var(--suda-color-background, #ffffff);
+  color: var(--suda-color-foreground, #111827);
 }
 @media (max-width: 760px) {
   .__SUDA_THEME_KEY__-grid {