@brightsideoy/kama 0.1.0-alpha.14 → 0.1.0-alpha.141

package/content/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/content/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/content/definitions/blocks/button.yaml

@@ -0,0 +1,24 @@
+id: button
+label: Button
+group: Content
+description: A customizable button link.
+
+fields:
+  text:
+    label: Text
+    type: richtext
+    editor: button
+    public: true
+  link:
+    label: Link
+    type: link
+    position: sidebar
+    allowedLinkTypes:
+      - tree
+      - node
+      - url
+      - file
+      - email
+      - telephone
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/header.yaml

@@ -0,0 +1,13 @@
+id: header
+label: Header
+group: Content
+
+fields:
+  headline:
+    type: richtext
+    editor: header
+    label: Headline
+    public: true
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/header_image.yaml

@@ -0,0 +1,21 @@
+id: header_image
+label: Header Image
+group: Media
+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
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/hero.yaml

@@ -0,0 +1,28 @@
+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
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/html.yaml

@@ -0,0 +1,12 @@
+id: html
+label: HTML
+group: Content
+
+fields:
+  body:
+    label: HTML
+    type: textarea
+    public: true
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/image_card.yaml

@@ -0,0 +1,56 @@
+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..."
+
+  link:
+    label: Link
+    type: link
+    allowedLinkTypes:
+      - tree
+      - node
+      - url
+      - file
+      - email
+      - telephone
+
+  linkText:
+    label: Button Text
+    type: text
+    description: "e.g., 'Read More' or 'Buy Now'"
+    default: "Read More"
+    public: true
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/single_image.yaml

@@ -0,0 +1,27 @@
+id: single_image
+label: Single Image
+group: Media
+description: Just a single image block.
+
+fields:
+  image:
+    label: Image
+    type: asset
+    required: true
+    multiple: false
+    maxSizeMB: 15
+    allowedTypes: ["image/*"]
+    public: true
+
+  link:
+    label: Link
+    type: link
+    position: sidebar
+    allowedLinkTypes:
+      - tree
+      - node
+      - url
+      - file
+
+tabs:
+  access: !include ../field-sets/access.yaml

package/content/definitions/blocks/text.yaml

@@ -0,0 +1,15 @@
+id: text
+label: Text
+group: Content
+description: Paragraph body
+
+# Main content fields
+fields:
+  body:
+    label: Text
+    type: richtext
+    editor: default
+    allowSplit: true
+    public: true
+
+access: !include ../field-sets/access.yaml

package/content/definitions/channels/ecommerce.yaml

@@ -0,0 +1,28 @@
+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
+  meta:
+    label: "SEO"
+    fields:
+      fieldSet: channel-seo
+  access:
+    label: "Access"
+    fields:
+      fieldSet: access

package/content/definitions/channels/website.yaml

@@ -0,0 +1,41 @@
+id: website
+label: "Website"
+
+# 🎯 2. Mounts the access tab automatically (engine natively resolves fieldSets into tabs if configured in the field set)
+fieldSets:
+  - access
+
+tabs:
+  settings:
+    label: "Channel"
+    fields:
+      # 🎯 1. Natively merges channel-base fields into this tab
+      fieldSet: channel-base
+  design:
+    label: "Design"
+    fields:
+      favicon:
+        label: "Favicon"
+        type: image
+        maxPreviewWidth: 200px
+        multiple: true
+        allowedTypes: ["image/png", "image/x-icon", "image/svg"]
+        public: true
+      logoText:
+        label: Logo Text
+        type: text
+        required: false
+        public: true
+
+      logoImage:
+        label: "Logo Image"
+        type: image
+        maxPreviewWidth: 300px
+        multiple: false
+        allowedTypes: ["image/svg"]
+        public: true
+
+  meta:
+    label: "SEO"
+    fields:
+      fieldSet: channel-seo

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

@@ -0,0 +1,27 @@
+# 📂 content/definitions/field-sets/access.yaml
+label: "Access"
+fields:
+  isHidden:
+    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/content/definitions/field-sets/channel-base.yaml

@@ -0,0 +1,50 @@
+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."
+
+  baseUrl:
+    label: Base URL
+    type: text
+    dbType: text
+    public: true
+
+  defaultLanguage:
+    label: Default Language
+    type: language-select
+    dbType: text
+    public: true
+
+  supportedLanguages:
+    label: Supported Languages
+    type: language-select
+    multiple: true
+    dbType: json
+    public: true

package/content/definitions/field-sets/channel-seo.yaml

@@ -0,0 +1,21 @@
+fields:
+  metaDescription:
+    label: Meta Description
+    type: textarea
+    dbType: text
+    required: false
+    public: true
+
+  titlePrefix:
+    label: Title Prefix
+    type: text
+    dbType: text
+    required: false
+    public: true
+
+  titleSuffix:
+    label: Title Suffix
+    type: text
+    dbType: text
+    required: false
+    public: true

package/content/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/content/definitions/field-sets/content-block.yaml

@@ -0,0 +1,41 @@
+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/content/definitions/field-sets/page-base.yaml

@@ -0,0 +1,44 @@
+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/content/definitions/field-sets/page-seo.yaml

@@ -0,0 +1,34 @@
+label: "SEO"
+fields:
+  # 🎯 1. Include the single field definition file
+  - schemaType: !include ./schema-type.yaml
+
+  # 🎯 2. Override the default for this specific section
+  - schemaType:
+      default: "WebPage"
+
+  # 🎯 3. Standard inline fields as sequence array items
+  - metaDescription:
+      label: Meta Description
+      type: textarea
+      public: true
+
+  - metaKeywords:
+      label: Meta Keywords
+      type: textarea
+      required: false
+      public: true
+
+  - titlePrefix:
+      label: Title Prefix
+      type: text
+      required: false
+      public: true
+      inherits: titlePrefix
+
+  - titleSuffix:
+      label: Title Suffix
+      type: text
+      required: false
+      public: true
+      inherits: titleSuffix

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

@@ -0,0 +1,78 @@
+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 # 🔗 Syncs from main SEO description
+    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
+    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
+    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
+    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
+    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/content/definitions/field-sets/schema-type.yaml

@@ -0,0 +1,43 @@
+type: select
+label: "Schema.org Entity Type"
+default: "WebPage"
+public: true
+options:
+  - label: "Standard Pages"
+    choices:
+      - label: "Standard Web Page"
+        value: "WebPage"
+      - label: "About Page"
+        value: "AboutPage"
+      - label: "Contact Page"
+        value: "ContactPage"
+      - label: "FAQ / Help Page"
+        value: "FAQPage"
+      - label: "Directory / Collection Page"
+        value: "CollectionPage"
+
+  - label: "Editorial & Articles"
+    choices:
+      - label: "General Article"
+        value: "Article"
+      - label: "Blog Post"
+        value: "BlogPosting"
+      - label: "Technical Docs / Guide"
+        value: "TechArticle"
+      - label: "News / Press Release"
+        value: "NewsArticle"
+      - label: "Whitepaper / Report"
+        value: "Report"
+
+  - label: "Commercial & Intent"
+    choices:
+      - label: "Service / Capability"
+        value: "Service"
+      - label: "Product / E-commerce Item"
+        value: "Product"
+      - label: "Educational Course"
+        value: "Course"
+      - label: "Event / Webinar"
+        value: "Event"
+      - label: "Job Career Listing"
+        value: "JobPosting"