@brightsideoy/kama 0.1.0-alpha.37 → 0.1.0-alpha.40

package/bin/cli.js

@@ -42,6 +42,10 @@ async function createFullWorkspace() {
     console.log(`\n📁 Creating workspace folder at ./${projName}...`);
     mkdirSync(rootDir, { recursive: true });
 
+    // 🎯 Scaffold schemas directory for custom project YAML definitions
+    mkdirSync(join(rootDir, 'schemas', 'nodes'), { recursive: true });
+    mkdirSync(join(rootDir, 'schemas', 'blocks'), { recursive: true });
+
     // --- AUTO D1 CREATION MAGIC ---
     let d1DatabaseId = 'REPLACE_WITH_YOUR_D1_ID';
     let isAuthenticated = false;
@@ -112,7 +116,7 @@ async function createFullWorkspace() {
     }
     // ------------------------------
 
-    // 1. Root package.json
+    // 🎯 1. Root package.json with bundle:schemas hooked
     writeFileSync(
         join(rootDir, 'package.json'),
         JSON.stringify({
@@ -121,18 +125,21 @@ async function createFullWorkspace() {
             type: 'module',
             workspaces: ['cms-worker', 'sites/*'],
             scripts: {
-                'dev:cms': 'npm run dev -w cms-worker',
-                'deploy:cms': 'npm run deploy -w cms-worker',
+                'bundle:schemas': 'node node_modules/@brightsideoy/kama/scripts/bundle-definitions.js',
+                'dev:cms': 'npm run bundle:schemas && npm run dev -w cms-worker',
+                'deploy:cms': 'npm run bundle:schemas && npm run deploy -w cms-worker',
             },
+            dependencies: {
+                '@brightsideoy/kama': 'alpha',
+            }
         }, null, 2)
     );
 
-    // 2. Setup CMS Worker
+    // 🎯 2. Setup CMS Worker
     console.log(`\n☁️ Configuring CMS Worker (${cmsDomain})...`);
     const cmsDir = join(rootDir, 'cms-worker');
     mkdirSync(cmsDir, { recursive: true });
 
-    // 🛑 The critical local entry point file!
     writeFileSync(
         join(cmsDir, 'index.js'),
         `export { default } from '@brightsideoy/kama';\n`
@@ -145,8 +152,9 @@ async function createFullWorkspace() {
             type: 'module',
             version: '1.0.0',
             scripts: {
-                "schema:local": `wrangler d1 execute ${dbName} --local --file=../node_modules/@brightsideoy/kama/schema.sql`,
-                "schema:remote": `wrangler d1 execute ${dbName} --remote --file=../node_modules/@brightsideoy/kama/schema.sql`,
+                "bundle:schemas": "node ../node_modules/@brightsideoy/kama/scripts/bundle-definitions.js",
+                "schema:local": `npm run bundle:schemas && wrangler d1 execute ${dbName} --local --file=../node_modules/@brightsideoy/kama/schema.sql`,
+                "schema:remote": `npm run bundle:schemas && wrangler d1 execute ${dbName} --remote --file=../node_modules/@brightsideoy/kama/schema.sql`,
                 "dev": "npm run schema:local && wrangler dev",
                 "deploy": "npm run schema:remote && wrangler deploy"
             },
@@ -165,7 +173,7 @@ async function createFullWorkspace() {
         JSON.stringify({
             $schema: '../node_modules/wrangler/config-schema.json',
             name: 'kama-worker',
-            main: 'index.js', // 🛑 Pointing to our generated local entry point
+            main: 'index.js',
             compatibility_date: '2026-08-01',
             compatibility_flags: ['nodejs_compat'],
             assets: {

package/defaults/definitions/block-layouts/three-column.yaml

@@ -0,0 +1,20 @@
+id: three-column
+label: Three Columns (33/33/33)
+showLabel: false
+group: Sub-Layouts
+
+layout:
+  columns: "1fr 1fr 1fr"
+  areas:
+    - ["left", "middle", "right"]
+
+regions:
+  left:
+    label: Left Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  middle:
+    label: Middle Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  right:
+    label: Right Column
+    showLabel: false # 👈 Keeps "RIGHT COLUMN" visible

package/defaults/definitions/block-layouts/two-column.yaml

@@ -0,0 +1,29 @@
+id: two-column
+label: Two Columns (50/50)
+showLabel: false # 👈 Hides the main "Two Columns" badge on the canvas
+group: Sub-Layouts
+
+layout:
+  columns: "1fr 1fr"
+  areas:
+    - ["left", "right"]
+
+regions:
+  left:
+    label: Left Column
+    showLabel: false # 👈 Hides "LEFT COLUMN" header on this region cell
+  right:
+    label: Right Column
+    showLabel: false # 👈 Keeps "RIGHT COLUMN" visible
+
+# Optional: We can give the layout block its own settings!
+fields:
+  gap:
+    label: Column Gap
+    type: select
+    default: "2rem"
+    options:
+      - { label: "None", value: "0" }
+      - { label: "Small", value: "1rem" }
+      - { label: "Medium", value: "2rem" }
+      - { label: "Large", value: "4rem" }

package/defaults/definitions/blocks/header.yaml

@@ -0,0 +1,15 @@
+id: header
+label: Header
+group: Content
+
+fields:
+  - headline:
+      type: richtext
+      editor: header
+      label: Headline
+      public: true
+      default: "Header here..."
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/header_image.yaml

@@ -0,0 +1,22 @@
+id: header_image
+label: Header Image
+group: Content
+description: Image for page header.
+
+fields:
+  - image:
+      label: Image
+      type: asset
+      required: true
+      multiple: false
+      maxSizeMB: 15
+      allowedTypes: ["image/*"]
+      crops:
+        standard:
+          label: "Page header (21:9)"
+          aspectRatio: 2.333
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/hero.yaml

@@ -0,0 +1,27 @@
+id: hero
+label: Hero
+group: Content
+
+fields:
+  - heroBadge:
+      type: text
+      label: Badge
+      public: true
+  - heroTitle:
+      type: text
+      label: Title
+      public: true
+  - heroSubTitle:
+      type: text
+      label: Sub-Title
+      public: true
+  - headline:
+      type: richtext
+      editor: header
+      label: Headline
+      public: true
+      default: "Header here..."
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/image_card.yaml

@@ -0,0 +1,53 @@
+id: image_card
+label: Image Card
+Group: Content
+description: A versatile card with an image, text, and a CTA button.
+
+fields:
+  - image:
+      label: Card Image
+      showLabel: false
+      type: asset
+      required: true
+      multiple: false
+      maxSizeMB: 15
+      maxPreviewWidth: 300px
+      allowedTypes: ["image/*"]
+      crops:
+        standard:
+          label: "Card Header (16:9)"
+          aspectRatio: 3.0
+      public: true
+
+  - headline:
+      label: Headline
+      type: text
+      required: true
+      public: true
+      default: "Headline..."
+
+  - summary:
+      label: Text
+      description: Keep it brief, 2-3 sentences max.
+      type: richtext
+      editor: minimal
+      public: true
+      default: "Card text content..."
+
+  - linkUrl:
+      label: Link URL
+      type: text
+      description: Where should this card link to? (e.g., /about or https://...)
+      public: true
+      default: "https://"
+
+  - linkText:
+      label: Button Text
+      type: text
+      description: "e.g., 'Read More' or 'Buy Now'"
+      default: "Read More"
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/blocks/text.yaml

@@ -0,0 +1,16 @@
+id: text
+label: Text
+group: Content
+description: Paragraph body
+
+fields:
+  - body:
+      label: Text
+      type: richtext
+      editor: default
+      default: "Write content here..."
+      public: true
+
+  - fieldSet: access
+  - hidden:
+      default: false

package/defaults/definitions/channels/ecommerce.yaml

@@ -0,0 +1,24 @@
+id: ecommerce
+label: "E-Commerce"
+
+tabs:
+  settings:
+    label: "Channel"
+    fields:
+      - fieldSet: channel-base
+
+      - currency:
+          label: Default Currency
+          type: select
+          default: "EUR"
+          options:
+            - "EUR"
+            - "USD"
+            - "GBP"
+
+      - checkoutUrl:
+          label: Checkout Endpoint URL
+          type: text
+          public: true
+
+      - fieldSet: access

package/defaults/definitions/channels/website.yaml

@@ -0,0 +1,32 @@
+id: website
+label: "Website"
+
+tabs:
+  settings:
+    label: "Channel"
+    fields:
+      - fieldSet: channel-base
+
+      - domain:
+          label: Hostname
+          type: text
+          dbType: text
+          index: true
+          public: true
+
+      - baseUrl:
+          label: Base URL
+          type: text
+          dbType: text
+          public: true
+
+      - defaultLanguage:
+          label: Channel Language / Locale
+          type: language-select
+          dbType: text
+          public: true
+
+  access:
+    label: "Access"
+    fields:
+      - fieldSet: access

package/defaults/definitions/field-sets/access.yaml

@@ -0,0 +1,29 @@
+tab:
+  id: access
+  label: "Access"
+
+fields:
+  isHidden: # 🎯 Renamed from 'hidden' to match the DB column
+    type: boolean
+    label: Hidden
+    default: false
+    public: false
+    variant: danger
+    dbType: integer
+    index: true
+    position: sidebar
+    liveSync: true
+
+  startShowingAt:
+    type: datetime
+    label: Start Showing At
+    position: sidebar
+    public: false
+    index: true
+
+  stopShowingAt:
+    type: datetime
+    label: Stop Showing At
+    position: sidebar
+    public: false
+    index: true

package/defaults/definitions/field-sets/channel-base.yaml

@@ -0,0 +1,31 @@
+id: channel-base
+label: Channel Base Properties
+
+fields:
+  - id:
+      label: Internal ID
+      type: hidden
+      dbType: integer
+      primaryKey: true
+
+  - label:
+      label: Channel Name
+      type: text
+      dbType: text
+      public: true
+      rules:
+        required: true
+
+  - key:
+      label: "API Identifier"
+      type: slug
+      dbType: text
+      public: true
+      index: true
+      linkedTo: label
+      placeholder: "e.g. main-site, store-eu"
+      rules:
+        required: true
+        unique: true
+        pattern: "^[a-z0-9-_]+$"
+        customMessage: "API key must be unique and contain only lowercase letters, numbers, hyphens, or underscores."

package/defaults/definitions/field-sets/comments.yaml

@@ -0,0 +1,11 @@
+tab:
+  id: comments
+  label: "Comments"
+
+fields:
+  isHidden:
+    type: textarea
+    label: Comments
+    public: false
+    index: true
+    position: sidebar

package/defaults/definitions/field-sets/content-block.yaml

@@ -0,0 +1,46 @@
+# definitions/field-sets/content-block.yaml
+id: content-block
+label: Content Block Base Properties
+
+fields:
+  - id:
+      label: ID
+      type: hidden
+      dbType: text
+      primaryKey: true
+
+  - contentId:
+      label: Node ID
+      type: text
+      dbType: text
+      rules:
+        required: true
+
+  - sortOrder:
+      label: Sort Order
+      type: number
+      dbType: integer
+      rules:
+        required: true
+
+  - elementType:
+      label: Element Component Type
+      type: text
+      dbType: text
+      rules:
+        required: true
+
+  - dataJson:
+      label: Content Field Data
+      type: json
+      dbType: json
+      rules:
+        required: true
+
+  - region:
+      label: Grid Region
+      type: text
+      dbType: text
+      default: "main"
+      rules:
+        required: true

package/defaults/definitions/field-sets/page-base.yaml

@@ -0,0 +1,49 @@
+# definitions/field-sets/page-base.yaml
+id: page-base
+label: Base Page Properties
+
+fields:
+  - id:
+      label: ID
+      type: hidden
+      dbType: text
+      primaryKey: true
+      public: true
+
+  - channelId:
+      label: Channel ID
+      type: hidden
+      dbType: text
+      public: true
+      index: true
+
+  - nodeType:
+      label: Type
+      type: select
+      dbType: text
+      default: "page"
+      public: true
+      position: sidebar
+      rules:
+        required: true
+
+  - title:
+      label: Page Title
+      type: text
+      dbType: text
+      public: true
+      rules:
+        required: true
+
+  - slug:
+      label: URL Slug
+      type: slug
+      linkedTo: title
+      dbType: text
+      public: true
+      index: true
+      rules:
+        required: true
+        uniqueSibling: true
+        pattern: "^[a-z0-9_-]+$"
+        customMessage: "Slug can only contain lowercase letters, numbers, hyphens, and underscores."

package/defaults/definitions/field-sets/page-meta.yaml

@@ -0,0 +1,15 @@
+tab:
+  id: page-meta
+  label: "Meta"
+
+fields:
+  metaDescription:
+    label: Meta Description
+    type: textarea
+    public: true
+
+  metaKeywords:
+    label: Meta Keywords
+    type: textarea
+    required: false
+    public: true

package/defaults/definitions/field-sets/page-social.yaml

@@ -0,0 +1,80 @@
+tab:
+  id: page-social
+  label: "Social"
+
+fields:
+  # --- Facebook / Open Graph Texts ---
+  fbTitle:
+    label: "Facebook Title (og:title)"
+    type: text
+    inherits: title # 🔗 Syncs from SEO Title automatically
+    public: true
+    description: "The title of your article as it should appear on Facebook."
+
+  fbDescription:
+    label: "Facebook Description (og:description)"
+    type: textarea
+    inherits: metaDescription # 🔗 Or whatever your main SEO description field is named
+    public: true
+    description: "A 2-4 sentence summary of the content."
+
+  # --- X (Twitter) Texts ---
+  xTitle:
+    label: "X Title (twitter:title)"
+    type: text
+    inherits: fbTitle # 🔗 Cascades from Facebook Title (which cascades from SEO)
+    public: true
+    description: "Keep it concise (under 70 characters is ideal for X)."
+
+  xDescription:
+    label: "X Description (twitter:description)"
+    type: textarea
+    inherits: fbDescription
+    public: true
+
+  # ==========================================
+  # SOCIAL IMAGES (The Waterfall)
+  # ==========================================
+
+  # 1. The Source Image
+  socialImage:
+    label: "Master Social Image"
+    type: image
+    maxPreviewWidth: 620px
+    multiple: false
+    maxSizeMB: 10
+    allowedTypes: ["image/jpeg", "image/png", "image/webp"]
+    public: true
+
+  # 2. The Auto-Synced Crops
+  fbImage:
+    label: "Facebook / LinkedIn Image"
+    type: image
+    maxPreviewWidth: 620px
+    inherits: socialImage # 🔗 Syncs from socialImage
+    public: true
+    description: "Auto-cropped to 1.91:1. Drop a new image here to override."
+    crops:
+      aspectRatio: 1.91
+
+  xImage:
+    label: "X (Twitter) Image"
+    type: image
+    maxPreviewWidth: 620px
+    inherits: socialImage # 🔗 Syncs from socialImage
+    public: true
+    description: "Auto-cropped to 2:1. Drop a new image here to override."
+    crops:
+      aspectRatio: 2.0
+
+  whatsappImage:
+    label: "Messaging / Square Image"
+    type: image
+    maxPreviewWidth: 620px
+    inherits: socialImage # 🔗 Syncs from socialImage
+    public: true
+    description: "Auto-cropped to 1:1. Drop a new image here to override."
+    crops:
+      whatsappImage:
+        label: "WhatsApp Image (1:1)"
+        aspectRatio: 1.0

package/defaults/definitions/field-sets/tree-base.yaml

@@ -0,0 +1,31 @@
+id: tree-base
+label: Tree Base Properties
+
+fields:
+  - id:
+      label: Internal ID
+      type: hidden
+      dbType: integer
+      primaryKey: true
+
+  - label:
+      label: "Label"
+      type: text
+      dbType: text
+      public: true
+      rules:
+        required: true
+
+  - key:
+      label: "API Identifier"
+      type: slug
+      dbType: text
+      index: true
+      public: true
+      linkedTo: label
+      placeholder: "e.g. main-site, store-eu"
+      rules:
+        required: true
+        unique: true
+        pattern: "^[a-z0-9-_]+$"
+        customMessage: "API key must be unique and contain only lowercase letters, numbers, hyphens, or underscores."

package/defaults/definitions/field-sets/visibility.yaml

@@ -0,0 +1,8 @@
+fields:
+  showInMenus:
+    type: boolean
+    label: Show in Menus
+    default: true
+    position: sidebar
+    public: true
+    variant: alert

package/defaults/definitions/node-layouts/landing-page.yml

@@ -0,0 +1,22 @@
+id: landing-page
+label: Landing Page
+
+layout:
+  columns: "1fr"
+  areas:
+    - ["header"]
+    - ["hero"]
+    - ["content"]
+    - ["footer"]
+
+regions:
+  header:
+    label: Header
+    inherit: parent
+  hero:
+    label: Hero / Top Banner
+  content:
+    label: Content
+  footer:
+    label: Footer
+    inherit: parent

package/defaults/definitions/node-layouts/single-column.yml

@@ -0,0 +1,38 @@
+id: single-column
+label: Single Column
+
+layout:
+  columns: "1fr"
+  areas:
+    - ["header"]
+    - ["content"]
+    - ["footer"]
+
+regions:
+  header:
+    label: Header Image
+    showLabel: true
+    inherit: parent
+    allowOverride: true
+    dropType: image
+    maxPreviewWidth: 800px
+    multiple: false
+    maxSizeMB: 20
+    allowedTypes: ["image/*"]
+    crops:
+      standard:
+        label: "Desktop Header (4:1)"
+        aspectRatio: 4.0
+      tablet:
+        label: "Tablet Header (2:1)"
+        aspectRatio: 2.0
+      mobile:
+        label: "Mobile Header (4:3)"
+        aspectRatio: 1.33
+    public: true
+
+  content:
+    label: Content
+  footer:
+    label: Footer
+    inherit: parent