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

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

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,41 @@
+id: article
+label: Article
+inTree: false
+hasCanvas: true
+
+regions:
+  content:
+    label: Content
+
+allowedElements:
+  - header
+  - hero
+  - text
+  - image_card
+  - header_image
+  - two-column
+  - three-column
+
+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,40 @@
+id: event
+label: Event
+inTree: false
+hasCanvas: true
+
+regions:
+  main:
+    label: Content
+
+allowedElements:
+  - title-set
+  - text-block
+
+tabs:
+  settings:
+    label: Event
+    fields:
+      - fieldSet: page-base
+      - title:
+          label: Event Title
+          required: true
+      - slug:
+          linkedTo: "title"
+      - startTime:
+          type: datetime
+          label: Starts
+          public: true
+          index: 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,63 @@
+id: page
+label: Page
+inTree: true
+inVault: true
+hasCanvas: 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
+
+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,35 @@
+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
+      - lastName:
+          label: Last Name
+      - position:
+
+      - fieldSet: access

package/defaults/definitions/nodes/product.yaml

@@ -0,0 +1,79 @@
+id: product
+label: Product
+inTree: false
+inVault: true
+hasCanvas: false
+
+layout:
+  columns: "3fr 1fr"
+  areas:
+    - ["main", "sidebar"]
+
+regions:
+  main:
+    label: Product Content
+  sidebar:
+    label: Sidebar
+
+allowedElements:
+  - text-block
+  - image_card
+
+tabs:
+  settings:
+    label: "Product"
+    fields:
+      - fieldSet: page-base
+      - title:
+          label: Product Name
+          required: true
+          public: true
+      - slug:
+          linkedTo: "title"
+      - price:
+          label: Price (€)
+          type: number
+          public: true
+      - description:
+          label: Short Abstract
+          type: textarea
+          public: true
+      - fieldSet: meta
+      - fieldSet: access
+
+  media:
+    label: "Media"
+    fields:
+      # 🎯 ZONE 1: The Main Image (Strict crops for lists/catalogs)
+      - featuredImage:
+          label: Main Product Image
+          description: "This is the primary image used in product grids, search results, and catalogs."
+          type: asset
+          multiple: false
+          maxSizeMB: 15
+          allowedTypes: ["image/jpeg", "image/png", "image/webp"]
+          crops:
+            list_thumb:
+              label: "List View (4:3)"
+              aspectRatio: 1.333
+            catalog_card:
+              label: "Portrait Card (3:4)"
+              aspectRatio: 0.75
+          public: true
+
+      # 🎯 ZONE 2: The Gallery (Different crops for the carousel)
+      - gallery:
+          label: Product Gallery
+          description: "Drag up to 10 images here for the product detail carousel."
+          type: asset
+          multiple: true
+          maxItems: 10
+          allowedTypes: ["image/jpeg", "image/png", "image/webp"]
+          crops:
+            carousel:
+              label: "Carousel Hero (16:9)"
+              aspectRatio: 1.777
+            zoom:
+              label: "Detail Zoom (Square)"
+              aspectRatio: 1.0
+          public: true

package/defaults/definitions/trees/navigation.yaml

@@ -0,0 +1,29 @@
+id: navigation
+label: "Site Navigation"
+
+tabs:
+  settings:
+    label: "Tree"
+    fields:
+      - fieldSet: tree-base
+      - baseUrl:
+          label: Base URL
+          type: text
+          dbType: text
+          public: true
+      - defaultLanguage:
+          label: Channel Language / Locale
+          type: language-select
+          dbType: text
+          public: true
+      - maxDepth:
+          type: select
+          label: "Maximum Menu Depth"
+          default: "3"
+          options:
+            - "1"
+            - "2"
+            - "3"
+            - "4"
+
+      - fieldSet: access

package/defaults/definitions/trees/social-links.yaml

@@ -0,0 +1,9 @@
+id: social-links
+label: "Social links"
+
+tabs:
+  settings:
+    label: "Tree"
+    fields:
+      - fieldSet: tree-base
+      - fieldSet: access

package/definitions/_page.yaml

@@ -0,0 +1,52 @@
+id: _page
+label: Page Old
+inTree: true
+inVault: true
+hasCanvas: true
+
+layout:
+  columns: "10fr 4fr"
+  areas:
+    - ["header", "header"]
+    - ["main", "sidebar"]
+    - ["footer", "footer"]
+
+regions:
+  header:
+    label: Header
+    inherit: parent
+  main:
+    label: Content
+  sidebar:
+    label: Sidebar
+  footer:
+    label: Footer
+    inherit: parent
+
+allowedElements:
+  - header
+  - hero
+  - text
+  - image_card
+
+# 👉 TABS DEFINITION
+tabs:
+  settings:
+    label: "Page"
+    fields:
+      # Imports core fields: title, slug, isHidden
+      - fieldSet: page-base
+
+      # Overrides & custom properties
+      - menuTitle:
+          label: Menu Title
+          type: text
+          dbType: text
+          public: true
+          placeholder: "Short title for navigation menus"
+
+      # SEO / OpenGraph metadata
+      - fieldSet: meta
+
+      # Role permissions & access control
+      - fieldSet: access

package/definitions/editor/default.ts

@@ -0,0 +1,17 @@
+import StarterKit from "@tiptap/starter-kit";
+import Link from "@tiptap/extension-link";
+import type { RteProfile } from "../../utils/rteProfiles";
+
+export const profile: RteProfile = {
+  extensions: [StarterKit, Link.configure({ openOnClick: false })],
+  toolbar: [
+    "heading-1",
+    "heading-2",
+    "bold",
+    "italic",
+    "bullet-list",
+    "ordered-list",
+    "blockquote",
+    "link",
+  ],
+};

package/definitions/editor/header.ts

@@ -0,0 +1,33 @@
+// definitions/editor/header.ts
+import StarterKit from "@tiptap/starter-kit";
+import Document from "@tiptap/extension-document";
+import Subscript from "@tiptap/extension-subscript";
+import Superscript from "@tiptap/extension-superscript";
+import type { RteProfile } from "../../src/utils/rteProfiles";
+
+// Custom document node forcing default top-level block to be a heading (H2)
+const CustomDocument = Document.extend({
+  content: "heading block*",
+});
+
+export const profile: RteProfile = {
+  extensions: [
+    CustomDocument,
+    StarterKit.configure({
+      document: false, // Replaces TipTap's default Document with CustomDocument
+      heading: { levels: [1, 2, 3, 4] },
+    }),
+    Subscript.configure(),
+    Superscript.configure(),
+  ],
+  toolbar: [
+    "heading-1",
+    "heading-2",
+    "heading-3",
+    "heading-4",
+    "bold",
+    "italic",
+    "superscript",
+    "subscript",
+  ],
+};

package/definitions/editor/minimal.ts

@@ -0,0 +1,13 @@
+import StarterKit from "@tiptap/starter-kit";
+import Link from "@tiptap/extension-link";
+import type { RteProfile } from "../../utils/rteProfiles";
+
+export const profile: RteProfile = {
+  extensions: [StarterKit, Link.configure({ openOnClick: false })],
+  toolbar: [
+    "bold",
+    "italic",
+    "bullet-list",
+    "ordered-list",
+  ],
+};

package/definitions/validators/iban.ts

@@ -0,0 +1,12 @@
+// definitions/validators/iban.ts
+
+export const iban = (value: any, ruleValue: any, field: any) => {
+  if (!value || !ruleValue) return "";
+  
+  const isValid = /^[A-Z]{2}[0-9]{2}[A-Z0-9]{1,30}$/.test(String(value).toUpperCase());
+  if (!isValid) {
+    return field.rules?.customMessage || "Invalid IBAN format.";
+  }
+  
+  return "";
+};

package/definitions/validators/magic-word.ts

@@ -0,0 +1,7 @@
+// definitions/validators/test.ts
+export const isMagicWord = (value: any, ruleValue: any, field: any) => {
+  if (value && value.toLowerCase() !== "magic") {
+    return field.rules?.customMessage || "You didn't say the magic word!";
+  }
+  return "";
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brightsideoy/kama",
-  "version": "0.1.0-alpha.39",
+  "version": "0.1.0-alpha.40",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,8 @@
   },
   "files": [
     "dist",
+    "defaults",
+    "definitions",
     "bin",
     "scripts",
     "schema.sql"

package/scripts/bundle-definitions.js

@@ -1,12 +1,29 @@
 // scripts/bundle-definitions.js
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import YAML from 'yaml';
 
-// Look for definitions across package core folders
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 🎯 Package root is one directory up from scripts/
+const packageRootDir = path.resolve(__dirname, '..');
+
+// Look for definitions across package core AND consumer project overrides
 function getDefinitionFiles(subDir) {
     const fileMap = new Map();
+
     const possibleDirs = [
+        // 1. Core package defaults (from inside node_modules or package source)
+        path.resolve(packageRootDir, "defaults/definitions", subDir),
+        path.resolve(packageRootDir, "definitions", subDir),
+
+        // 2. Fallbacks relative to node_modules if running from workspace root
+        path.resolve(process.cwd(), "node_modules/@brightsideoy/kama/defaults/definitions", subDir),
+        path.resolve(process.cwd(), "node_modules/@brightsideoy/kama/definitions", subDir),
+
+        // 3. Consumer project local overrides (highest priority — overwrites defaults)
         path.resolve(process.cwd(), "defaults/definitions", subDir),
         path.resolve(process.cwd(), "definitions", subDir),
         path.resolve(process.cwd(), "schemas", subDir),
@@ -29,6 +46,7 @@ function getDefinitionFiles(subDir) {
                     entry.name.endsWith(".yml") ||
                     entry.name.endsWith(".json")
                 ) {
+                    // Overwrite earlier entries so local consumer files override package defaults
                     fileMap.set(entryRelPath, fullPath);
                 }
             }
@@ -103,23 +121,31 @@ const outputContent = `// Auto-generated pre-bundled definitions for Kama Core E
 export const BUNDLED_DEFINITIONS = ${JSON.stringify(bundled, null, 2)};
 `;
 
-const outputDir = path.resolve(process.cwd(), 'server/db');
-if (!fs.existsSync(outputDir)) {
-    fs.mkdirSync(outputDir, { recursive: true });
+// 🎯 Write to BOTH package dist/server locations so imports resolve cleanly
+const targetDirs = [
+    path.resolve(packageRootDir, 'server/db'),
+    path.resolve(process.cwd(), 'node_modules/@brightsideoy/kama/server/db'),
+    path.resolve(process.cwd(), 'node_modules/@brightsideoy/kama/dist'),
+    path.resolve(process.cwd(), 'server/db'),
+];
+
+for (const dir of targetDirs) {
+    if (fs.existsSync(dir)) {
+        const outputPath = path.resolve(dir, 'bundled-definitions.ts');
+        fs.writeFileSync(outputPath, outputContent, 'utf-8');
+        // Also write .js version for built packages
+        const jsOutputPath = path.resolve(dir, 'bundled-definitions.js');
+        fs.writeFileSync(jsOutputPath, `export const BUNDLED_DEFINITIONS = ${JSON.stringify(bundled, null, 2)};\n`, 'utf-8');
+    }
 }
 
-const outputPath = path.resolve(outputDir, 'bundled-definitions.ts');
-fs.writeFileSync(outputPath, outputContent, 'utf-8');
-
-console.log(`✅ Definitions bundled successfully into Kama Core:
+console.log(`✅ Definitions bundled successfully:
   • Nodes: ${Object.keys(bundled.rawNodes).length} (${Object.keys(bundled.rawNodes).join(', ')})
-  • Blocks: ${Object.keys(bundled.rawBlocks).length}
-  • Channels: ${Object.keys(bundled.rawChannels).length}
-  ↳ Saved into ${outputPath}`);
+  • Blocks: ${Object.keys(bundled.rawBlocks).length} (${Object.keys(bundled.rawBlocks).join(', ')})
+  • Channels: ${Object.keys(bundled.rawChannels).length} (${Object.keys(bundled.rawChannels).join(', ')})
+  • Trees: ${Object.keys(bundled.rawTrees).length} (${Object.keys(bundled.rawTrees).join(', ')})`);
 
-// ==========================================
-// AUTO-GENERATE SQL INDEXES FROM SCHEMA
-// ==========================================
+// Auto-generate SQL Indexes
 const indexQueries = new Set([
     "-- Native Columns",
     "CREATE INDEX IF NOT EXISTS idx_content_nodes_slug ON content_nodes (slug);",
@@ -130,7 +156,6 @@ const indexQueries = new Set([
 
 function extractIndexes(obj) {
     if (typeof obj !== 'object' || obj === null) return;
-
     for (const [key, value] of Object.entries(obj)) {
         if (typeof value === 'object' && value !== null) {
             if (value.index === true && key !== "id" && key !== "slug" && key !== "contentType") {
@@ -148,5 +173,4 @@ const schemaSqlPath = path.resolve(process.cwd(), 'schema.sql');
 
 if (fs.existsSync(schemaSqlPath)) {
     fs.appendFileSync(schemaSqlPath, '\n\n' + sqlContent + '\n', 'utf-8');
-    console.log(`✅ Appended JSON auto-indexes directly to schema.sql`);
 }