@almadar/std 16.228.0 → 16.230.0

package/behaviors/lolo/infra/atoms/std-notify-on-event.lolo

@@ -92,7 +92,7 @@ orbital NotifyOnEventOrbital {
           recipient: @entity.recipient
           recordedAt: @now
           severity: @entity.severity
-        }) (if (and (str/includes @entity.prefQuietHours "-") ["!=", (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)] (if ["<", (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)] (and [">=", (time/hour @now), (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2)] ["<", (time/hour @now), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)]) (or [">=", (time/hour @now), (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2)] ["<", (time/hour @now), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)]))) (persist create NotificationRecord {
+        }) (if (and (str/includes @entity.prefQuietHours "-") ["!=", (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)] (if ["<", (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)] (and [">=", (str/padStart (str/concat "" (time/hour @now)) 2 "0"), (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2)] ["<", (str/padStart (str/concat "" (time/hour @now)) 2 "0"), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)]) (or [">=", (str/padStart (str/concat "" (time/hour @now)) 2 "0"), (str/slice (array/first (str/split @entity.prefQuietHours "-")) 0 2)] ["<", (str/padStart (str/concat "" (time/hour @now)) 2 "0"), (str/slice (array/nth (str/split @entity.prefQuietHours "-") 1) 0 2)]))) (persist create NotificationRecord {
           channel: @entity.channel
           dispatched: false
           error: "quiet-hours"
@@ -427,7 +427,7 @@ orbital NotifyOnEventOrbital {
         @description "Signing secret forwarded to the webhook service so the receiving endpoint can verify the payload. Ignored when `webhookUrl` is blank."
         @synonyms "signing secret, hmac secret, webhook signature, shared secret"
         @tier "internal"
-      template : string = ""
+      template : string = "You have a new notification"
         @label "Message template"
         @description "Text shown to the recipient; supports payload interpolation"
         @synonyms "notification text, message body, alert text"

package/behaviors/lolo/ui/core/atoms/std-book-reader.lolo

@@ -0,0 +1,316 @@
+app std-book-reader "1.0.0"
+"std-book-reader — reads a multi-chapter book one chapter at a time. Opens on a cover (cover image, title, subtitle, author, a start button and the table of contents); reading shows a contents rail with the current chapter marked, the chapter title and progress, the chapter text (markdown) and previous/next buttons. Supports right-to-left books. Emits CHAPTER_OPENED on every chapter change. Pick for handbooks, manifestos, course readers and long-form guides."
+type BookChapter = { title : string!, content : string! }
+orbital BookReaderOrbital {
+
+  entity BookReaderView [runtime] {
+    id : string!
+    chapterIndex : number = 0
+    chapterTitle : string = ""
+    chapterContent : string = ""
+    progressLabel : string = ""
+    isFirst : boolean = true
+    isLast : boolean = false
+  }
+
+  trait BookReaderRead -> @rebindable BookReaderView [interaction, instance] {
+    initial: cover
+
+    state cover {
+      INIT -> cover
+        (render-ui main @config.coverContent)
+      START_READING -> reading
+        (set @entity.chapterIndex 0)
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters 0) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters 0) content ""))
+        (set @entity.isFirst true)
+        (set @entity.isLast (<= (array/len @config.chapters) 1))
+        (set @entity.progressLabel (str/concat "1 / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
+        (emit CHAPTER_OPENED { index: 0, title: @entity.chapterTitle })
+      OPEN_CHAPTER -> reading
+        (set @entity.chapterIndex ?index)
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters ?index) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters ?index) content ""))
+        (set @entity.isFirst (== ?index 0))
+        (set @entity.isLast (>= ?index (- (array/len @config.chapters) 1)))
+        (set @entity.progressLabel (str/concat (+ ?index 1) " / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
+        (emit CHAPTER_OPENED { index: ?index, title: @entity.chapterTitle })
+    }
+
+    state reading {
+      INIT -> reading
+        (render-ui main @config.readingContent)
+      OPEN_CHAPTER -> reading
+        (set @entity.chapterIndex ?index)
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters ?index) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters ?index) content ""))
+        (set @entity.isFirst (== ?index 0))
+        (set @entity.isLast (>= ?index (- (array/len @config.chapters) 1)))
+        (set @entity.progressLabel (str/concat (+ ?index 1) " / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
+        (emit CHAPTER_OPENED { index: ?index, title: @entity.chapterTitle })
+      NEXT_CHAPTER -> reading when (not @entity.isLast)
+        (set @entity.chapterIndex (+ @entity.chapterIndex 1))
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters @entity.chapterIndex) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters @entity.chapterIndex) content ""))
+        (set @entity.isFirst false)
+        (set @entity.isLast (>= @entity.chapterIndex (- (array/len @config.chapters) 1)))
+        (set @entity.progressLabel (str/concat (+ @entity.chapterIndex 1) " / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
+        (emit CHAPTER_OPENED { index: @entity.chapterIndex, title: @entity.chapterTitle })
+      PREV_CHAPTER -> reading when (not @entity.isFirst)
+        (set @entity.chapterIndex (- @entity.chapterIndex 1))
+        (set @entity.chapterTitle (object/get (array/nth @config.chapters @entity.chapterIndex) title ""))
+        (set @entity.chapterContent (object/get (array/nth @config.chapters @entity.chapterIndex) content ""))
+        (set @entity.isFirst (== @entity.chapterIndex 0))
+        (set @entity.isLast false)
+        (set @entity.progressLabel (str/concat (+ @entity.chapterIndex 1) " / " (array/len @config.chapters)))
+        (render-ui main @config.readingContent)
+        (emit CHAPTER_OPENED { index: @entity.chapterIndex, title: @entity.chapterTitle })
+      BACK_TO_COVER -> cover
+        (render-ui main @config.coverContent)
+    }
+
+    emits {
+      CHAPTER_OPENED -> external {
+        index : number
+        title : string
+      }
+        @description "The reader moved to a chapter; carries its index and title."
+        @synonyms "page turned, chapter changed, reading progress"
+        @tier "domain"
+    }
+
+    listens {
+      OPEN_CHAPTER {
+        index : number!
+      }
+        @description "Jump to a chapter from the table of contents."
+        @tier "internal"
+    }
+
+    config {
+      title : string = "Untitled book"
+        @label "Title"
+        @tier "presentation"
+      subtitle : string = ""
+        @label "Subtitle"
+        @tier "presentation"
+      author : string = ""
+        @label "Author"
+        @tier "presentation"
+      coverImage : string = ""
+        @label "Cover image"
+        @description "Cover image URL; empty hides it"
+        @tier "presentation"
+      direction : "ltr" | "rtl" = ltr
+        @label "Text direction"
+        @description "rtl for Arabic, Hebrew and other right-to-left books"
+        @synonyms "right to left, arabic book"
+        @tier "presentation"
+      chapters : [BookChapter] = [{ title: "Chapter one", content: "The first chapter's text, in **markdown**." }, { title: "Chapter two", content: "The second chapter's text." }]
+        @label "Chapters"
+        @description "Ordered chapters: a title and markdown content each"
+        @synonyms "sections, parts, pages, table of contents"
+        @tier "presentation"
+      startLabel : string = "Start reading"
+        @label "Start button label"
+        @tier "presentation"
+      contentsLabel : string = "Contents"
+        @label "Contents heading"
+        @tier "presentation"
+      previousLabel : string = "Previous"
+        @label "Previous button label"
+        @tier "presentation"
+      nextLabel : string = "Next"
+        @label "Next button label"
+        @tier "presentation"
+      coverLabel : string = "Cover"
+        @label "Back-to-cover label"
+        @tier "presentation"
+      coverContent : render-ui = {
+        type: box
+        paddingY: "2xl"
+        fullWidth: true
+        dir: @config.direction
+        children: [{
+          type: container
+          size: md
+          maxWidth: md
+          padding: lg
+          children: [{
+            type: stack
+            direction: vertical
+            gap: xl
+            children: [{
+              type: stack
+              direction: vertical
+              gap: md
+              align: center
+              children: [{
+              type: image
+              src: @config.coverImage
+              alt: @config.title
+              rounded: lg
+              bordered: true
+              loading: eager
+              className: "max-w-xs"
+            }, {
+              type: typography
+              content: @config.title
+              variant: h1
+              weight: bold
+              align: center
+              className: "tracking-tight text-balance"
+            }, {
+              type: typography
+              content: @config.subtitle
+              variant: large
+              color: muted
+              align: center
+              className: (if (== @config.subtitle "") hidden "text-pretty")
+            }, {
+              type: typography
+              content: @config.author
+              variant: label
+              color: muted
+              align: center
+              className: (if (== @config.author "") hidden "")
+            }, {
+              type: button
+              label: @config.startLabel
+              variant: primary
+              size: lg
+              action: START_READING
+              className: (if (== (array/len @config.chapters) 0) hidden "")
+            }]
+            }, {
+              type: stack
+              direction: vertical
+              gap: xs
+              className: (if (== (array/len @config.chapters) 0) hidden "")
+              children: [{
+                type: typography
+                content: @config.contentsLabel
+                variant: label
+                weight: semibold
+              }, {
+                type: stack
+                direction: vertical
+                gap: none
+                align: start
+                children: (array/map @config.chapters (fn chapter {
+                  type: button
+                  variant: link
+                  label: (str/concat (+ @index 1) ". " (object/get @chapter title ""))
+                  action: OPEN_CHAPTER
+                  actionPayload: { index: @index }
+                }))
+              }]
+            }]
+          }]
+        }]
+      }
+        @label "Cover body"
+        @tier "internal"
+      readingContent : render-ui = {
+        type: box
+        paddingY: xl
+        fullWidth: true
+        dir: @config.direction
+        children: [{
+          type: container
+          size: xl
+          maxWidth: xl
+          padding: lg
+          children: [{
+            type: split
+            ratio: "1:3"
+            gap: xl
+            children: [{
+              type: stack
+              direction: vertical
+              gap: xs
+              align: start
+              className: "lg:sticky lg:top-6 self-start"
+              children: [{
+                type: button
+                variant: link
+                label: @config.coverLabel
+                leftIcon: book-open
+                action: BACK_TO_COVER
+              }, {
+                type: typography
+                content: @config.contentsLabel
+                variant: label
+                weight: semibold
+                className: "pt-2"
+              }, {
+                type: stack
+                direction: vertical
+                gap: none
+                align: start
+                children: (array/map @config.chapters (fn chapter {
+                  type: button
+                  variant: link
+                  label: (object/get @chapter title "")
+                  action: OPEN_CHAPTER
+                  actionPayload: { index: @index }
+                  className: (if (== @index @entity.chapterIndex) "text-foreground font-semibold" "")
+                }))
+              }]
+            }, {
+              type: stack
+              direction: vertical
+              gap: lg
+              children: [{
+                type: typography
+                content: @entity.progressLabel
+                variant: caption
+                color: muted
+              }, {
+                type: typography
+                content: @entity.chapterTitle
+                variant: h2
+                weight: bold
+                className: "tracking-tight"
+              }, {
+                type: markdown-content
+                content: @entity.chapterContent
+                direction: @config.direction
+              }, {
+                type: divider
+              }, {
+                type: stack
+                direction: horizontal
+                gap: md
+                justify: between
+                children: [{
+                  type: button
+                  variant: secondary
+                  label: @config.previousLabel
+                  leftIcon: (if (== @config.direction rtl) chevron-right chevron-left)
+                  action: PREV_CHAPTER
+                  disabled: @entity.isFirst
+                }, {
+                  type: button
+                  variant: primary
+                  label: @config.nextLabel
+                  rightIcon: (if (== @config.direction rtl) chevron-left chevron-right)
+                  action: NEXT_CHAPTER
+                  disabled: @entity.isLast
+                }]
+              }]
+            }]
+          }]
+        }]
+      }
+        @label "Reading body"
+        @tier "internal"
+    }
+  }
+
+  page "/book" as BookReaderPage -> BookReaderRead
+}

package/behaviors/lolo/ui/core/atoms/std-card-grid.lolo

@@ -0,0 +1,172 @@
+app std-card-grid "1.0.0"
+"std-card-grid — a titled grid of content cards from a config list. Each card can carry an image (screenshots, portfolio, case studies), a portrait (team members), an icon, a badge, a title, a description and a link. `look` picks media cards, centered profile cards, or plain text cards. Pick for showcases, team pages, case studies, service catalogs and testimonials."
+type CardItem = { title : string!, description : string, image : string, imageAlt : string, avatar : string, icon : string, badge : string, meta : string, href : string, linkLabel : string }
+orbital CardGridOrbital {
+
+  entity CardGridView [runtime] {
+    id : string!
+  }
+
+  trait CardGridRender -> @rebindable CardGridView [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          type: box
+          paddingY: xl
+          bg: (if (== @config.surface muted) muted transparent)
+          fullWidth: true
+          children: [{
+            type: container
+            size: xl
+            maxWidth: xl
+            padding: lg
+            children: [{ type: stack, direction: vertical, gap: xl, children: [{
+              type: stack
+              direction: vertical
+              gap: sm
+              align: (if (== @config.alignment center) center start)
+              className: (if (== @config.heading "") (if (== @config.lede "") hidden "") "")
+              children: [{
+              type: typography
+              content: @config.heading
+              variant: h2
+              weight: bold
+              align: (if (== @config.alignment center) center left)
+              className: (if (== @config.heading "") hidden "tracking-tight text-balance")
+            }, {
+              type: typography
+              content: @config.lede
+              variant: large
+              color: muted
+              align: (if (== @config.alignment center) center left)
+              className: (if (== @config.lede "") hidden "max-w-2xl text-pretty")
+            }]
+            }, {
+              type: simple-grid
+              cols: (math/min (math/max @config.columns 1) 6)
+              gap: lg
+              children: (array/map @config.items (fn item {
+                type: card
+                look: (if (== @config.look media) tile-image-first elevated)
+                padding: (if (== @config.look media) none md)
+                className: "h-full"
+                children: [{
+                  type: image
+                  src: (object/get @item image "")
+                  alt: (object/get @item imageAlt (object/get @item title ""))
+                  aspect: "16/9"
+                  rounded: none
+                }, {
+                  type: stack
+                  direction: vertical
+                  gap: sm
+                  align: (if (== @config.look profile) center start)
+                  className: (if (== @config.look media) "p-5" "")
+                  children: [{
+                    type: avatar
+                    src: (object/get @item avatar "")
+                    name: (object/get @item title "")
+                    size: xl
+                    className: (if (== (object/get @item avatar "") "") hidden "")
+                  }, {
+                    type: icon
+                    name: (object/get @item icon "")
+                    size: lg
+                    className: (if (== (object/get @item icon "") "") hidden "text-primary")
+                  }, {
+                    type: badge
+                    label: (object/get @item badge "")
+                    variant: primary
+                  }, {
+                    type: typography
+                    content: (object/get @item title "")
+                    variant: h4
+                    weight: semibold
+                    align: (if (== @config.look profile) center left)
+                  }, {
+                    type: typography
+                    content: (object/get @item meta "")
+                    variant: caption
+                    color: muted
+                    align: (if (== @config.look profile) center left)
+                    className: (if (== (object/get @item meta "") "") hidden "")
+                  }, {
+                    type: typography
+                    content: (object/get @item description "")
+                    variant: body
+                    color: muted
+                    align: (if (== @config.look profile) center left)
+                    className: (if (== (object/get @item description "") "") hidden "text-pretty")
+                  }, {
+                    type: button
+                    label: (object/get @item linkLabel "")
+                    href: (object/get @item href "")
+                    variant: link
+                    rightIcon: arrow-right
+                    action: CARD_OPEN
+                    actionPayload: { href: (object/get @item href ""), title: (object/get @item title "") }
+                    className: (if (== (object/get @item linkLabel "") "") hidden "")
+                  }]
+                }]
+              }))
+            }] }]
+          }]
+        })
+      CARD_OPEN -> idle
+        (emit CARD_OPENED { href: ?href, title: ?title })
+    }
+
+    emits {
+      CARD_OPENED -> external {
+        href : string
+        title : string
+      }
+        @description "A card's link was clicked; carries its href and title."
+        @tier "domain"
+    }
+
+    listens {
+      CARD_OPEN {
+        href : string
+        title : string
+      }
+        @description "Card link click."
+        @tier "internal"
+    }
+
+    config {
+      heading : string = ""
+        @label "Heading"
+        @description "Section heading above the grid; empty hides it"
+        @synonyms "title"
+        @tier "presentation"
+      lede : string = ""
+        @label "Supporting text"
+        @description "Text under the heading; empty hides it"
+        @tier "presentation"
+      alignment : "center" | "start" = center
+        @label "Heading alignment"
+        @tier "presentation"
+      items : [CardItem] = [{ title: "First card", description: "What this card is about." }, { title: "Second card", description: "What this card is about." }, { title: "Third card", description: "What this card is about." }]
+        @label "Cards"
+        @description "One card per entry: title plus any of image, avatar, icon, badge, meta, description, href + linkLabel"
+        @synonyms "items, entries, showcase, portfolio, team members, case studies, services, testimonials"
+        @tier "presentation"
+      look : "media" | "profile" | "plain" = plain
+        @label "Card look"
+        @description "media = image-led cards, profile = centered portrait cards, plain = text cards"
+        @tier "presentation"
+      columns : number = 3
+        @label "Max columns"
+        @tier "presentation"
+      surface : "plain" | "muted" = plain
+        @label "Surface"
+        @description "Background behind the section"
+        @tier "presentation"
+    }
+  }
+
+  page "/card-grid" as CardGridPage -> CardGridRender
+}