@brightsideoy/kama 0.1.0-alpha.1 → 0.1.0-alpha.100

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,29 @@
+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
+
+  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/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

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

@@ -0,0 +1,41 @@
+id: three-column
+label: Three Column
+
+layout:
+  columns: "2fr 7fr 3fr"
+  areas:
+    - ["header", "header", "header"]
+    - ["left_nav", "content", "right_sidebar"]
+    - ["footer", "footer", "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
+  left_nav:
+    label: Left Navigation
+  content:
+    label: Content
+  right_sidebar:
+    label: Right Sidebar
+  footer:
+    label: Footer
+    inherit: parent

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

@@ -0,0 +1,40 @@
+# defaults/definitions/layouts/two-column-split.yml
+id: two-column
+label: Two Column
+
+layout:
+  columns: "10fr 4fr"
+  areas:
+    - ["header", "header"]
+    - ["content", "sidebar"] # 👈 Changed 'main' to 'content' to match old data!
+    - ["footer", "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: # 👈 Changed 'main' to 'content'
+    label: Content
+  sidebar:
+    label: Sidebar
+  footer:
+    label: Footer
+    inherit: parent

package/defaults/definitions/nodes/address.yaml

@@ -0,0 +1,32 @@
+id: address
+label: Address
+inTree: false
+
+# 👉 TABS DEFINITION
+tabs:
+  settings:
+    label: "Address"
+    fields:
+      - title:
+          label: Address Title
+          required: true
+      - street:
+          label: Street
+      - city:
+          label: City
+      - area:
+          label: County / Area
+      - zip:
+          label: ZIP
+      - country:
+          label: Country
+  geolocation:
+    label: "Geolocation"
+    fields:
+      - lat:
+          label: Latitude
+      - lng:
+          label: Longitude
+      - timezone:
+          label: Timezone
+      - fieldSet: access

package/defaults/definitions/nodes/article.yaml

@@ -0,0 +1,43 @@
+id: article
+label: Article
+inTree: false
+hasCanvas: true
+directLinking: true
+
+regions:
+  content:
+    label: Content
+
+allowedBlocks:
+  - header
+  - hero
+  - text
+  - image_card
+  - header_image
+  - two-column
+  - three-column
+  - single_image
+
+tabs:
+  settings:
+    label: "Article"
+    fields:
+      - fieldSet: page-base
+      - title:
+          label: Article title
+          required: true
+      - slug:
+          linkedTo: "title"
+      - articleDate:
+          type: date
+          label: Article Date
+          public: true
+          default: now
+          index: true
+      - abstract:
+          label: Abstract
+          type: textarea
+          public: true
+      - fieldSet: page-meta
+      - fieldSet: page-social
+      - fieldSet: access

package/defaults/definitions/nodes/event.yaml

@@ -0,0 +1,49 @@
+id: event
+label: Event
+inTree: false
+hasCanvas: true
+directLinking: true
+
+regions:
+  main:
+    label: Content
+
+allowedBlocks:
+  - header
+  - hero
+  - text
+  - image_card
+  - header_image
+  - two-column
+  - three-column
+  - single_image
+
+tabs:
+  settings:
+    label: Event
+    fields:
+      - fieldSet: page-base
+      - title:
+          label: Event Title
+          required: true
+          showAsEditorTitle: true
+      - slug:
+          linkedTo: "title"
+      - startTime:
+          type: datetime
+          label: Starts
+          public: true
+          index: true
+          showAsEditorTitle: true
+      - endTime:
+          type: datetime
+          label: Finishes
+          public: true
+          index: true
+      - abstract:
+          label: Abstract
+          type: textarea
+          public: true
+      - fieldSet: page-meta
+      - fieldSet: page-social
+      - fieldSet: access

package/defaults/definitions/nodes/external-link.yaml

@@ -0,0 +1,26 @@
+id: external-link
+label: External Link
+inTree: true
+
+tabs:
+  settings:
+    label: "Link"
+    fields:
+      - fieldSet: page-base
+      - nodeType
+      - title:
+          label: Link Text
+      - iconName:
+          label: Icon
+          type: icon
+          dbType: text
+          packages: ["heroicons", "lucide", "mdi"]
+      - slug:
+          label: Slug
+          linkedTo: "menuTitle, title"
+      - url:
+          label: URL
+          type: text
+          public: true
+
+      - fieldSet: access

package/defaults/definitions/nodes/page.yaml

@@ -0,0 +1,65 @@
+id: page
+label: Page
+inTree: true
+inVault: true
+hasCanvas: true
+directLinking: true
+
+# 👈 Keep this as the absolute last-resort fallback for the Public API
+defaultLayout: "single-column"
+
+# 👈 Cleaned up naming!
+allowedBlocks:
+  - header
+  - hero
+  - text
+  - image_card
+  - header_image
+  - two-column
+  - three-column
+  - single_image
+
+tabs:
+  settings:
+    label: "Page"
+    fields:
+      - fieldSet: page-base
+
+      # 👉 THE CURRENT PAGE'S LAYOUT
+      - layoutId:
+          label: Page Layout
+          type: layout-select
+          dbType: text
+          default: "inherit"
+          inheritsFromParent: true # 👈 Tells the UI to bind to the parent!
+          allowedLayouts:
+            - two-column
+            - single-column
+            - three-column
+            - landing-page
+          options:
+            - { label: "Inherit Layout", value: "inherit" }
+
+      # 👉 THE BEHAVIOR FOR ALL CHILDREN
+      - subpageLayoutId:
+          label: Subpages Layout Rule
+          type: layout-select
+          dbType: text
+          default: "inherit"
+          inheritsFromParent: true # 👈 A child's subpage rules can ALSO inherit!
+          allowedLayouts:
+            - two-column
+            - three-column
+            - single-column
+            - landing-page
+          options:
+            - { label: "Inherit Layout", value: "inherit" }
+
+      - menuTitle:
+          label: Menu Title
+          type: text
+          dbType: text
+          public: true
+      - fieldSet: page-meta
+      - fieldSet: page-social
+      - fieldSet: access

package/defaults/definitions/nodes/person.yaml

@@ -0,0 +1,37 @@
+id: person
+label: Person
+inTree: false
+inVault: true
+hasCanvas: false
+
+# 👉 TABS DEFINITION
+tabs:
+  settings:
+    label: "Person"
+    fields:
+      - image:
+          label: Image
+          type: asset
+          multiple: false
+          maxSizeMB: 15
+          allowedTypes: ["image/*"]
+          maxPreviewWidth: 300
+          crops:
+            list_thumb:
+              label: "List View"
+              aspectRatio: 1
+              shape: "circle"
+          public: true
+
+      - title:
+          label: Title
+          required: false
+      - firstName:
+          label: First Name
+          showAsEditorTitle: true
+      - lastName:
+          label: Last Name
+          showAsEditorTitle: true
+      - position:
+
+      - fieldSet: access