@sudajs/cli 0.18.4 → 0.18.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudajs/cli",
-  "version": "0.18.4",
+  "version": "0.18.6",
   "type": "module",
   "bin": {
     "suda": "./bin/suda.js"
@@ -25,7 +25,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@puckeditor/core": "^0.22.0",
+    "@puckeditor/core": "^0.22.4",
     "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": "6.3.1"
+    "@sudajs/theme-engine": "6.4.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.3.0",

package/templates/theme/AGENTS.md

@@ -448,6 +448,25 @@ or AI examples.
 - React, React DOM, Puck, and `@sudajs/theme-engine` are host-provided peers. Do not bundle private copies into the theme runtime.
 - Keep persisted props JSON-serializable. Do not store functions, React nodes, class instances, database ids for media, or environment-specific absolute filesystem paths.
 
+### Public site language list
+
+Read public-site language switch targets with `getSiteLocale(puck?.metadata)`
+from `@sudajs/theme-engine/runtime`. Render the host-provided `label` and link
+to the host-provided `href`; do not derive a language name or construct a locale
+URL in theme code.
+
+```tsx
+const siteLocale = getSiteLocale(puck?.metadata);
+
+{
+  siteLocale?.locales.map((item) => (
+    <a key={item.locale} href={item.href} lang={item.locale}>
+      {item.label}
+    </a>
+  ));
+}
+```
+
 ## Puck editor CSS isolation
 
 Puck renders the editable preview in a same-origin iframe. The outer
@@ -922,10 +941,28 @@ radius, shadows, or spacing.
   and apply `createThemeDesignCssVariables(tokens)` to the theme root element.
   Components should consume CSS variables; they should not resolve design
   presets themselves.
-- In `src/styles.css`, map Suda variables to theme-local or Tailwind variables
-  once, for example `--color-primary: var(--suda-color-primary, #...)` and
-  `--radius-card: var(--suda-radius-card, 24px)`. Use those variables across
-  sections, cards, CMS layouts, post lists, forms, and local blocks.
+- Pure Tailwind themes should map Suda tokens only through `@theme inline`, then
+  consume utilities such as `bg-primary`, `text-primary-foreground`, and
+  `rounded-card`. The `inline` keyword is required so generated utilities read
+  `--suda-*` on the rendered theme root instead of resolving a `--color-*`
+  alias on `:root`.
+- Hand-written CSS classes must consume `--suda-*` directly. Do not use
+  `var(--color-primary)`, `var(--color-background)`, `var(--radius-card)`, or
+  another Suda-backed alias declared by `@theme inline`; those compiler aliases
+  live on `:root` while Suda injects editable tokens on the descendant theme
+  root in production.
+- When hand-written CSS needs a derived value, declare a theme-prefixed custom
+  property on the theme root and consume that property, for example:
+  ```css
+  .my-theme-root {
+    --my-theme-primary-hover: color-mix(in srgb, var(--suda-color-primary) 84%, black);
+  }
+  .my-theme-button:hover {
+    background: var(--my-theme-primary-hover);
+  }
+  ```
+  `suda theme check`, build, and publish reject hand-written consumption of
+  Suda-backed `@theme inline` aliases.
 - Keep typography and spacing scales centralized in `src/styles.css`. Define
   reusable classes or variables for containers, section padding, headings,
   eyebrow text, body copy, cards, buttons, inputs, and media frames. Reuse those

package/templates/theme/package.json

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