create-kywi-app 0.6.4 → 0.6.5

package/assets/agent-patterns.md

@@ -308,8 +308,12 @@ Full recipe, worked example and hazards: the **`kywi-custom-modules` skill**.
 **Design the props for the owner, not for yourself.** The props panel gives the
 owner real controls for `text`/`textarea`/`richText` (text inputs),
 `image`/`file` (media picker), `boolean` (checkbox) and `number`/`date`/`color`
-(native inputs); `select`, `slug`, `relationship` and `multiSelect` fall back to
-a plain text input, so name the allowed values in the label. A `json` prop is a
+(native inputs); `select` and `multiSelect` render a real dropdown or checkbox
+group when the prop declares `options` — `{ value, label }` pairs, or bare
+strings where the string serves as both — so declare options for every closed
+choice instead of trusting the owner to type the right value. `slug` and
+`relationship` have no options field and are still plain text inputs; that's
+the one place to name the allowed values in the label. A `json` prop is a
 raw JSON textarea — developer territory. A "three stats" module with `stats: {
 type: 'json' }` has taken the copy away from the owner; the same module with
 `stat1Value` / `stat1Label` … as `text` props hasn't.

package/assets/kywi-custom-modules-skill.md

@@ -53,7 +53,8 @@ it — then pick the type:
 | `image` / `file` | media picker | anything from the Media library |
 | `boolean` | checkbox | layout flips (`reverse`), show/hide |
 | `number` / `date` / `color` | native inputs | counts, deadlines, accents |
-| `select` / `slug` / `relationship` | plain text input (today) | constrained values — name the options in the label |
+| `select` / `multiSelect` | dropdown / checkbox group (needs `options`) | closed choices — declare `options: [{ value, label }, …]` (bare strings also work) per prop |
+| `slug` / `relationship` | plain text input | constrained values with no options field yet — name the allowed values in the label |
 | `json` | raw JSON textarea | **developer territory** — structure the owner never edits |
 
 Two rules that decide whether the module is really editable:
@@ -84,6 +85,15 @@ export default defineKywiConfig({
         body: { type: 'richText', label: 'Body' },
         image: { type: 'image', label: 'Image' },
         imageAlt: { type: 'text', label: 'Image alt text' },
+        layout: {
+          type: 'select',
+          label: 'Layout',
+          options: [
+            { value: 'split', label: 'Media / text split' },
+            { value: 'stacked', label: 'Stacked' },
+          ],
+          defaultValue: 'split',
+        },                                                  // closed choice = real dropdown
         reverse: { type: 'boolean', label: 'Image on the left', defaultValue: false },
       },
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kywi-app",
-  "version": "0.6.4",
+  "version": "0.6.5",
   "description": "Scaffold a new Kywi CMS project — npx create-kywi-app my-site",
   "type": "module",
   "homepage": "https://github.com/Kywi-Software/kywi-cms#readme",