@almadar/std 16.230.0 → 16.232.0

package/behaviors/lolo/ui/core/molecules/ui-commit-row.lolo

@@ -0,0 +1,143 @@
+app ui-commit-row "1.0.0"
+"One version in a history list — a commit row with select and restore. — UI factory (1:1 with the @almadar/ui commit-row pattern)."
+;; @capabilities "version history row, commit entry, revision list item, change log entry, restore point, undo history item"
+;; @pattern "commit-row"
+orbital CommitRowOrbital {
+  entity CommitRowItem [runtime] {
+    id : string!
+    sha : string @intrinsic = ""
+  }
+
+  trait CommitRowRender -> @rebindable CommitRowItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (set @entity.sha @config.sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+      SELECT -> idle
+        (set @entity.sha ?sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+      RESTORE -> idle
+        (set @entity.sha ?sha)
+        (render-ui main {
+          sha: @entity.sha
+          message: @config.message
+          author: @config.author
+          timestamp: @config.timestamp
+          kind: @config.kind
+          additions: @config.additions
+          deletions: @config.deletions
+          selected: @config.selected
+          current: @config.current
+          selectEvent: @config.selectEvent
+          restoreEvent: @config.restoreEvent
+          className: @config.className
+          type: commit-row
+        })
+    }
+
+    emits {
+      @config.selectEvent -> external {
+        sha : string!
+      }
+        @description "Emitted when the row is picked. Payload: { sha }."
+        @tier "essential"
+      @config.restoreEvent -> external {
+        sha : string!
+      }
+        @description "Emitted by the Restore button. Payload: { sha }."
+        @tier "essential"
+    }
+
+    listens {
+      SELECT {
+        sha : string!
+      }
+      RESTORE {
+        sha : string!
+      }
+    }
+
+    config {
+      sha : string = ""
+        @label "Sha"
+        @description "Commit id; the first 7 characters are shown, the whole id on hover."
+        @tier "presentation"
+      message : string = ""
+        @label "Message"
+        @description "Commit message."
+        @tier "presentation"
+      author : string
+        @label "Author"
+        @description "author prop"
+        @tier "presentation"
+      timestamp : string
+        @label "Timestamp"
+        @description "Display time (already formatted, e.g. '2 min ago')."
+        @tier "presentation"
+      kind : "user" | "agent" | "restore" | "undo" | "redo" | "snapshot" = user
+        @label "Kind"
+        @description "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot)."
+        @tier "presentation"
+      additions : number
+        @label "Additions"
+        @description "additions prop"
+        @tier "presentation"
+      deletions : number
+        @label "Deletions"
+        @description "deletions prop"
+        @tier "presentation"
+      selected : boolean = false
+        @label "Selected"
+        @description "The row the user picked (shows its detail)."
+        @tier "presentation"
+      current : boolean = false
+        @label "Current"
+        @description "The version the app is at now — it cannot be restored to."
+        @tier "presentation"
+      selectEvent : event = "SELECT"
+        @label "Select Event"
+        @description "Emitted when the row is picked. Payload: { sha }."
+        @tier "presentation"
+      restoreEvent : event = "RESTORE"
+        @label "Restore Event"
+        @description "Emitted by the Restore button. Payload: { sha }."
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/commit-row" as CommitRowPage -> CommitRowRender
+}

package/behaviors/lolo/ui/core/molecules/ui-header.lolo

@@ -8,6 +8,7 @@ orbital HeaderOrbital {
     icon : icon
     badge : string
     active : boolean
+    children : [HeaderNavigationItemsItem]
   }
   type HeaderUserAvatar = {
     src : asset

package/behaviors/lolo/ui/core/molecules/ui-icon-button.lolo

@@ -0,0 +1,105 @@
+app ui-icon-button "1.0.0"
+"IconButton — UI factory (1:1 with the @almadar/ui icon-button pattern)."
+;; @pattern "icon-button"
+orbital IconButtonOrbital {
+  type IconButtonIconAsset = {
+    url : asset!
+    role : string!
+    category : string!
+    animations : [string]
+    style : "pixel" | "vector" | "hd" | "1-bit" | "isometric"
+    variant : string
+    dimension : "2d" | "3d"
+    aspect : "1:1" | "16:9" | "5:7" | "8:1" | "4:1" | "5:3" | "1:2"
+    atlas : asset
+    sprite : string
+    name : string
+    thumbnailUrl : string
+  }
+
+  entity IconButtonItem [runtime] {
+    id : string!
+  }
+
+  trait IconButtonRender -> @rebindable IconButtonItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          className: @config.className
+          variant: @config.variant
+          size: @config.size
+          isLoading: @config.isLoading
+          iconAsset: @config.iconAsset
+          action: @config.action
+          actionPayload: @config.actionPayload
+          disabled: @config.disabled
+          href: @config.href
+          icon: @config.icon
+          label: @config.label
+          tooltipPosition: @config.tooltipPosition
+          type: icon-button
+        })
+    }
+
+    emits {
+      @config.action -> external { }
+        @description "Declarative event name — emits UI:{action} via eventBus on click"
+        @tier "essential"
+    }
+
+    config {
+      className : string
+        @label "Class Name"
+        @description "Additional CSS classes applied to the root element."
+        @tier "presentation"
+      variant : "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default" | "link" = ghost
+        @label "Variant"
+        @description "variant prop"
+        @tier "presentation"
+      size : "sm" | "md" | "lg" = sm
+        @label "Size"
+        @description "size prop"
+        @tier "presentation"
+      isLoading : boolean
+        @label "Is Loading"
+        @description "isLoading prop"
+        @tier "presentation"
+      iconAsset : IconButtonIconAsset
+        @label "Icon Asset"
+        @description "Asset image rendered as the leading icon; takes precedence over icon/leftIcon when provided."
+        @tier "presentation"
+      action : event = "ACTION"
+        @label "Action"
+        @description "Declarative event name — emits UI:{action} via eventBus on click"
+        @tier "presentation"
+      actionPayload : @payload @config.action
+        @label "Action Payload"
+        @description "Payload to include with the action event"
+        @tier "presentation"
+      disabled : boolean
+        @label "Disabled"
+        @description "Disable the button (greys out, blocks click events)"
+        @tier "presentation"
+      href : string
+        @label "Href"
+        @description "Makes the button a link: `#anchor` scrolls, an absolute URL loads, a path navigates in-app"
+        @tier "presentation"
+      icon : icon = "circle"
+        @label "Icon"
+        @description "icon prop"
+        @tier "presentation"
+      label : string = ""
+        @label "Label"
+        @description "What the button does — its accessible name and its tooltip."
+        @tier "presentation"
+      tooltipPosition : "top" | "bottom" | "left" | "right" = right
+        @label "Tooltip Position"
+        @description "Where the tooltip opens."
+        @tier "presentation"
+    }
+  }
+
+  page "/icon-button" as IconButtonPage -> IconButtonRender
+}

package/behaviors/lolo/ui/core/molecules/ui-menu.lolo

@@ -10,6 +10,7 @@ orbital MenuOrbital {
     disabled : boolean
     title : string
     event : event
+    href : string
     url : string
     variant : "default" | "danger"
     subMenu : [MenuItemsItem]

package/behaviors/lolo/ui/core/molecules/ui-top-nav-item.lolo

@@ -0,0 +1,53 @@
+app ui-top-nav-item "1.0.0"
+"TopNavItem — UI factory (1:1 with the @almadar/ui top-nav-item pattern)."
+;; @pattern "top-nav-item"
+orbital TopNavItemOrbital {
+  type TopNavItemItem = {
+    label : string!
+    href : string
+    icon : icon
+    badge : string
+    active : boolean
+    children : [TopNavItemItem]
+  }
+
+  entity TopNavItemItem [runtime] {
+    id : string!
+  }
+
+  trait TopNavItemRender -> @rebindable TopNavItemItem [interaction, instance] {
+    initial: idle
+
+    state idle {
+      INIT -> idle
+        (render-ui main {
+          item: @config.item
+          activeHref: @config.activeHref
+          tone: @config.tone
+          className: @config.className
+          type: top-nav-item
+        })
+    }
+
+    config {
+      item : TopNavItemItem = { label: "Label", href: "Href", icon: "circle", badge: "Badge", active: false, children: [] }
+        @label "Item"
+        @description "item prop"
+        @tier "presentation"
+      activeHref : string
+        @label "Active Href"
+        @description "The href of the active page, used to mark the item (or its parent) active."
+        @tier "presentation"
+      tone : "solid" | "soft" = solid
+        @label "Tone"
+        @description "Active styling: `solid` fills with the primary colour (dashboard top bar); `soft` tints it (site header)."
+        @tier "presentation"
+      className : string
+        @label "Class Name"
+        @description "className prop"
+        @tier "presentation"
+    }
+  }
+
+  page "/top-nav-item" as TopNavItemPage -> TopNavItemRender
+}

package/behaviors/lolo/ui/core/molecules/ui-version-diff.lolo

@@ -1,5 +1,6 @@
 app ui-version-diff "1.0.0"
-"VersionDiff — UI factory (1:1 with the @almadar/ui version-diff pattern)."
+"A line diff between two versions — two whole texts, or a pre-computed diff such as one commit. — UI factory (1:1 with the @almadar/ui version-diff pattern)."
+;; @capabilities "version diff, compare revisions, what changed, before and after, code diff, commit diff, revision comparison"
 ;; @pattern "version-diff"
 orbital VersionDiffOrbital {
   type VersionDiffRevisionsItem = {
@@ -9,6 +10,16 @@ orbital VersionDiffOrbital {
     timestamp : string
     content : string!
   }
+  type VersionDiffHunksItem = {
+    header : string!
+    lines : [VersionDiffHunksItemLinesItem]!
+  }
+  type VersionDiffHunksItemLinesItem = {
+    type : "added" | "removed" | "unchanged" | "context"!
+    beforeLineNumber : number
+    afterLineNumber : number
+    content : string!
+  }
 
   entity VersionDiffItem [runtime] {
     id : string!
@@ -21,6 +32,7 @@ orbital VersionDiffOrbital {
       INIT -> idle
         (render-ui main {
           revisions: @config.revisions
+          hunks: @config.hunks
           beforeId: @config.beforeId
           afterId: @config.afterId
           view: @config.view
@@ -55,10 +67,14 @@ orbital VersionDiffOrbital {
     }
 
     config {
-      revisions : [VersionDiffRevisionsItem] = [{ id: "Id", label: "Label", author: "Author", timestamp: "Timestamp", content: "Content" }, { id: "Id 2", label: "Label 2", author: "Author 2", timestamp: "Timestamp 2", content: "Content 2" }]
+      revisions : [VersionDiffRevisionsItem] = []
         @label "Revisions"
         @description "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array."
         @tier "presentation"
+      hunks : [VersionDiffHunksItem] = []
+        @label "Hunks"
+        @description "A pre-computed diff to render instead of diffing `revisions` (no revision pickers)."
+        @tier "presentation"
       beforeId : string
         @label "Before Id"
         @description "Currently selected 'before' revision id."
@@ -69,7 +85,7 @@ orbital VersionDiffOrbital {
         @tier "presentation"
       view : "side-by-side" | "inline" = "side-by-side"
         @label "View"
-        @description "Display mode."
+        @description "Display mode to start in; the toggle switches it."
         @tier "presentation"
       onSelectBefore : event = "SELECT_BEFORE"
         @label "On Select Before"

package/behaviors/lolo/ui/core/organisms/ui-dock-layout.lolo

@@ -32,6 +32,12 @@ orbital DockLayoutOrbital {
           bottomPanelMinSize: @config.bottomPanelMinSize
           secondarySidebarCollapsed: @config.secondarySidebarCollapsed
           onSecondarySidebarCollapsedChange: @config.onSecondarySidebarCollapsedChange
+          compact: @config.compact
+          secondarySidebarLabel: @config.secondarySidebarLabel
+          secondarySidebarIcon: @config.secondarySidebarIcon
+          bottomPanelLabel: @config.bottomPanelLabel
+          bottomPanelIcon: @config.bottomPanelIcon
+          topBarActions: @config.topBarActions
           className: @config.className
           railClassName: @config.railClassName
           sidebarClassName: @config.sidebarClassName
@@ -96,15 +102,15 @@ orbital DockLayoutOrbital {
         @label "Secondary Sidebar"
         @description "Collapsible right sidebar."
         @tier "presentation"
-      railWidth : number = 56
+      railWidth : number
         @label "Rail Width"
-        @description "Width of `rail` in pixels. @default 56"
+        @description "Width of `rail` in pixels; the rail sizes the column itself when omitted."
         @tier "presentation"
       secondarySidebarWidth : number = 280
         @label "Secondary Sidebar Width"
         @description "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280"
         @tier "presentation"
-      sidebarCollapsed : boolean = false
+      sidebarCollapsed : boolean
         @label "Sidebar Collapsed"
         @description "Whether `sidebar` is collapsed. @default false"
         @tier "presentation"
@@ -124,7 +130,7 @@ orbital DockLayoutOrbital {
         @label "Sidebar Min Size"
         @description "Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160"
         @tier "presentation"
-      bottomPanelCollapsed : boolean = false
+      bottomPanelCollapsed : boolean
         @label "Bottom Panel Collapsed"
         @description "Whether `bottomPanel` is collapsed. @default false"
         @tier "presentation"
@@ -144,7 +150,7 @@ orbital DockLayoutOrbital {
         @label "Bottom Panel Min Size"
         @description "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120"
         @tier "presentation"
-      secondarySidebarCollapsed : boolean = false
+      secondarySidebarCollapsed : boolean
         @label "Secondary Sidebar Collapsed"
         @description "Whether `secondarySidebar` is collapsed. @default false"
         @tier "presentation"
@@ -152,6 +158,30 @@ orbital DockLayoutOrbital {
         @label "On Secondary Sidebar Collapsed Change"
         @description "onSecondarySidebarCollapsedChange prop"
         @tier "presentation"
+      compact : boolean
+        @label "Compact"
+        @description "The mobile variant; decided by the viewport (narrower than 1024px) when omitted."
+        @tier "presentation"
+      secondarySidebarLabel : string
+        @label "Secondary Sidebar Label"
+        @description "Compact: the top-bar button that opens `secondarySidebar` (e.g. 'Inspector', 'Chat')."
+        @tier "presentation"
+      secondarySidebarIcon : icon
+        @label "Secondary Sidebar Icon"
+        @description "secondarySidebarIcon prop"
+        @tier "presentation"
+      bottomPanelLabel : string
+        @label "Bottom Panel Label"
+        @description "Compact: the top-bar button that opens `bottomPanel`."
+        @tier "presentation"
+      bottomPanelIcon : icon
+        @label "Bottom Panel Icon"
+        @description "bottomPanelIcon prop"
+        @tier "presentation"
+      topBarActions : node
+        @label "Top Bar Actions"
+        @description "Compact: the host's own actions at the end of the top bar (e.g. Run)."
+        @tier "presentation"
       className : string
         @label "Class Name"
         @description "Additional CSS classes on the root frame."

package/behaviors/lolo/ui/game/atoms/ui-canvas.lolo

@@ -146,6 +146,7 @@ orbital CanvasOrbital {
         featureId : string!
         x : number!
         z : number!
+        type : string
         elevation : number
       }
         @description "Feature-click event (3D only)."