@almadar/std 16.236.0 → 16.238.0

package/behaviors/lolo/agent/atoms/std-agent-trace.lolo

@@ -1,64 +1,157 @@
-app std-agent-trace "1.0.0"
-"Wraps trace/emit + trace/log — observability for agent loops."
+app std-agent-trace "2.0.0"
+"std-agent-trace — the persisted record of what an in-app assistant did. Each REPLIED (from std-agent-tool-loop) stores one AgentRun row: the reply, every tool step (which input or entity, the arguments, whether it took effect and why not), the tokens and the model calls; each REPLY_FAILED stores a failed run with its error. The record verification grades and later optimisation reads, in one format for tests and production. AgentTraceRecorder is headless; AgentRunBrowse is the run list. Rows carry ownerId (the real @user); the binding organism scopes @read."
+
+type AgentStep = {
+  kind : "input" | "read" | "invalid"
+  target : string!
+  args : string!
+  ok : boolean!
+  detail : string
+}
+type AgentUsage = {
+  promptTokens : number!
+  completionTokens : number!
+  totalTokens : number!
+  modelCalls : number!
+}
+
 orbital AgentTraceOrbital {
+  type AgentRunsLoaded = Event { data : [AgentRun] } "Fired when the run record finishes loading"
+  type AgentRunsLoadFailed = Event { error : string, code : string } "Fired when the run record fails to load"
 
-  entity AgentTrace [runtime] {
-    event : string = ""
-    level : string = "info"
-    message : string = ""
+  entity AgentRun [persistent: agentRuns] {
+    id : string!
+    ownerId : string! @description "Whose request this run answered (the real @user). The binding organism scopes @read to it." @synonyms "user, owner, account"
+    outcome : "answered" | "failed" @description "Whether the assistant answered." @synonyms "result, status" = answered
+    reply : string @description "What the assistant said." @synonyms "answer, response" = ""
+    error : string @description "Why the run failed." = ""
+    steps : [AgentStep] @description "Every tool use, in order." @synonyms "actions, tool calls, trace" = []
+    promptTokens : number @description "Tokens sent to the model." = 0
+    completionTokens : number @description "Tokens the model produced." = 0
+    totalTokens : number @description "All tokens for the run." = 0
+    modelCalls : number @description "Model round-trips." @synonyms "turns, calls" = 0
+    recordedAt : number @description "When the run finished (ms)." @synonyms "time, timestamp" = 0
   }
 
-  trait TraceEmitter -> AgentTrace [lifecycle, instance] {
-    initial: idle
+  trait AgentTraceRecorder -> @rebindable AgentRun [lifecycle] {
+    initial: recording
 
-    state idle {
-      INIT -> idle
-        (set @entity.event "")
-        (set @entity.level "info")
-        (set @entity.message "")
-      EMIT_TRACE -> idle
-        (set @entity.event ?event)
-        (trace/emit @entity.event)
-        (emit TRACED)
-      LOG_TRACE -> idle
-        (set @entity.level ?level)
-        (set @entity.message ?message)
-        (trace/log @entity.level @entity.message)
-        (emit TRACED)
+    state recording {
+      INIT -> recording
+        (set @entity.outcome answered)
+      REPLIED -> recording
+        (persist create AgentRun {
+          ownerId: @user.id
+          outcome: answered
+          reply: ?reply
+          steps: ?steps
+          promptTokens: ?usage.promptTokens
+          completionTokens: ?usage.completionTokens
+          totalTokens: ?usage.totalTokens
+          modelCalls: ?usage.modelCalls
+          recordedAt: @now
+        } {
+          emit: { success: RUN_RECORDED }
+        })
+      REPLY_FAILED -> recording
+        (persist create AgentRun {
+          ownerId: @user.id
+          outcome: failed
+          error: ?error
+          recordedAt: @now
+        } {
+          emit: { success: RUN_RECORDED }
+        })
+      RUN_RECORDED -> recording
+        (set @entity.outcome answered)
     }
 
     emits {
-      TRACED
+      RUN_RECORDED -> external
+        @description "A run was recorded — payload is the created AgentRun row itself."
+        @synonyms "recorded, logged, traced"
+        @tier "domain"
     }
 
     listens {
-      EMIT_TRACE {
-        event : string!
+      REPLIED {
+        reply : string!
+        steps : [AgentStep]!
+        usage : AgentUsage!
       }
-      LOG_TRACE {
-        level : string!
-        message : string!
+        @description "Record an answered run."
+      REPLY_FAILED {
+        error : string!
       }
+        @description "Record a failed run."
     }
   }
 
-  trait TraceListener -> AgentTrace [lifecycle, instance] {
-    initial: ready
+  trait AgentRunBrowse -> @rebindable AgentRun [interaction, collection] {
+    initial: browsing
 
-    state ready {
-      INIT -> ready
-        (set @entity.event "")
-        (set @entity.level "info")
-        (set @entity.message "")
-      TRACED -> ready
-        (set @entity.event "")
-        (set @entity.message "")
+    state browsing {
+      INIT -> browsing
+        (fetch AgentRun {
+          emit: { failure: AgentRunsLoadFailed, success: AgentRunsLoaded }
+        })
+        (render-ui main { type: skeleton, variant: list, rows: 6 })
+      AgentRunsLoaded -> browsing
+        (render-ui main {
+          emptyTitle: "No runs yet"
+          entity: (array/sort ?data recordedAt desc)
+          fields: []
+          gap: sm
+          renderItem: (fn item {
+            children: [{
+              label: @item.outcome
+              size: sm
+              type: badge
+              variant: neutral
+            }, {
+              content: @item.reply
+              type: typography
+              variant: body
+            }, {
+              content: (str/concat @item.modelCalls " model calls, " @item.totalTokens " tokens")
+              type: typography
+              variant: caption
+            }]
+            direction: vertical
+            gap: xs
+            type: stack
+          })
+          type: data-list
+        })
+      AgentRunsLoadFailed -> browsing
+        (render-ui main {
+          message: ?error
+          type: alert
+          variant: error
+        })
+      RUN_RECORDED -> browsing
+        (fetch AgentRun {
+          emit: { failure: AgentRunsLoadFailed, success: AgentRunsLoaded }
+        })
+    }
+
+    emits {
+      AgentRunsLoaded {
+        data : [AgentRun]
+      }
+        @description "The run record finished loading."
+        @tier "internal"
+      AgentRunsLoadFailed {
+        error : string
+        code : string
+      }
+        @tier "internal"
     }
 
     listens {
-      TraceEmitter.TRACED -> TRACED
+      AgentTraceRecorder.RUN_RECORDED -> RUN_RECORDED
     }
   }
 
-  page "/agent-trace" as AgentTracePage -> TraceEmitter, TraceListener
+  page "/agent-trace" as AgentTracePage -> AgentRunBrowse, AgentTraceRecorder
 }

package/behaviors/lolo/agent/organisms/std-agent-assistant.lolo

@@ -0,0 +1,137 @@
+app std-agent-assistant "1.0.0"
+"std-agent-assistant — an in-app assistant that operates the running app for the signed-in user. One request flows down a chain of std agent atoms on the bus: the conversation (std-agent-session) SENDs → CONVERSE → std-agent-context bounds it → std-agent-memory adds what it recalls → std-agent-tool-loop answers it through `call-service llm call-tools`, firing only the inputs and reading only the entities the `tools` allowlist names, as the signed-in user → REPLIED goes back to the conversation, to memory (remembered) and to std-agent-trace (the run record). Import the orbital and supply the allowlist: `orbital Assistant = Agent.orbitals.AgentAssistantOrbital { config { tools: [{ event: TaskOrbital.TaskPersistor.DO_CREATE }, { read: Task }], instructions: \"…\" } }`. The conversation, memory and run records live in AgentRecordsOrbital; retarget them onto your own owner-scoped entities (`ownerId` a relation to your [identity] roster, with @read/@create) with `entities { AgentMessage: …, AgentMemory: …, AgentRun: … }`."
+
+type AgentTool = {
+  event : event
+  read : string
+}
+type AgentLink = {
+  label : string!
+  href : string!
+}
+
+orbital AgentAssistantOrbital {
+  uses Session from "std/behaviors/std-agent-session"
+  uses Context from "std/behaviors/std-agent-context"
+  uses Memory from "std/behaviors/std-agent-memory"
+  uses Loop from "std/behaviors/std-agent-tool-loop"
+  uses Trace from "std/behaviors/std-agent-trace"
+
+  config {
+    tools : [AgentTool] = []
+      @label "What may the assistant do?"
+      @description "The declared inputs it may fire (`{ event: Trait.EVENT }` / `{ event: Orbital.Trait.EVENT }`) and the entities it may read (`{ read: Entity }`), as the signed-in user."
+      @synonyms "allowlist, abilities, actions, permissions"
+      @tier "domain"
+    instructions : string = "You operate this app for the signed-in user. Use the tools to act and to look things up; when a tool reports that something was refused or denied, say so plainly."
+      @label "How should the assistant behave?"
+      @description "Standing instructions sent with every request."
+      @synonyms "system prompt, persona, guidance"
+      @tier "domain"
+    maxSteps : number = 8
+      @label "Model round-trips per request"
+      @tier "policy"
+    keepMessages : number = 12
+      @label "Turns kept verbatim"
+      @tier "policy"
+    recallLimit : number = 3
+      @label "Memories recalled per request"
+      @tier "policy"
+    links : [AgentLink] = [{ label: "Run history", href: "/assistant/runs" }, { label: "What I remember", href: "/assistant/memory" }]
+      @label "Links above the conversation"
+      @description "The pages showing the assistant's run history and memory."
+      @tier "presentation"
+  }
+
+  entity AgentAssistant [runtime] {
+    id : string!
+  }
+
+  trait AssistantThread = Session.traits.AgentThread -> AgentMessage {
+    config {
+      links: @config.links
+    }
+    events {
+      CONVERSE: REQUEST_CONTEXT
+    }
+    listens {
+      SEND {
+        message : string!
+      }
+      AssistantLoop.REPLIED -> REPLIED
+      AssistantLoop.REPLY_FAILED -> REPLY_FAILED
+    }
+  }
+
+  trait AssistantContext = Context.traits.AgentContextCompactor {
+    config {
+      keepMessages: @config.keepMessages
+    }
+    listens {
+      AssistantThread.REQUEST_CONTEXT -> COMPACT
+    }
+  }
+
+  trait AssistantMemory = Memory.traits.AgentMemoryRecall -> AgentMemory {
+    config {
+      recallLimit: @config.recallLimit
+    }
+    listens {
+      AssistantContext.COMPACTED -> RECALL
+      AssistantLoop.REPLIED -> REMEMBER
+    }
+  }
+
+  trait AssistantLoop = Loop.traits.AgentToolLoop {
+    config {
+      tools: @config.tools
+      instructions: @config.instructions
+      maxSteps: @config.maxSteps
+    }
+    listens {
+      AssistantMemory.RECALLED -> CONVERSE
+    }
+  }
+
+  trait AssistantTrace = Trace.traits.AgentTraceRecorder -> AgentRun {
+    listens {
+      AssistantLoop.REPLIED -> REPLIED
+      AssistantLoop.REPLY_FAILED -> REPLY_FAILED
+    }
+  }
+
+  page "/assistant" as AssistantPage -> AssistantThread, AssistantContext, AssistantMemory, AssistantLoop, AssistantTrace
+}
+
+;; The assistant's records live outside AgentAssistantOrbital, so a consumer
+;; importing that orbital retargets them onto its own owner-scoped entities:
+;; `entities { AgentMessage: MyMessage, AgentMemory: MyMemory, AgentRun: MyRun }`.
+orbital AgentRecordsOrbital {
+  uses Memory from "std/behaviors/std-agent-memory"
+  uses Trace from "std/behaviors/std-agent-trace"
+
+  entity AgentRun [persistent: agentRuns] {
+    id : string!
+  }
+  entity AgentMessage [persistent: agentMessages] {
+    id : string!
+  }
+  entity AgentMemory [persistent: agentMemories] {
+    id : string!
+  }
+
+  trait AgentRunHistory = Trace.traits.AgentRunBrowse -> AgentRun {
+    listens {
+      AgentAssistantOrbital.AssistantTrace.RUN_RECORDED -> RUN_RECORDED
+    }
+  }
+
+  trait AgentMemoryList = Memory.traits.AgentMemoryBrowse -> AgentMemory {
+    listens {
+      AgentAssistantOrbital.AssistantMemory.MEMORY_STORED -> MEMORY_STORED
+    }
+  }
+
+  page "/assistant/runs" as AssistantRunsPage -> AgentRunHistory
+  page "/assistant/memory" as AssistantMemoryPage -> AgentMemoryList
+}

package/behaviors/lolo/infra/atoms/std-approval-gate.lolo

@@ -189,10 +189,12 @@ orbital ApprovalGateOrbital {
               variant: caption
             }, {
               label: Requested
+              format: date
               name: requestedAt
               variant: caption
             }]
             gap: sm
+            itemClickEvent: @config.itemClickEvent
             itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
             look: @config.tableLook
             type: data-grid
@@ -337,6 +339,7 @@ orbital ApprovalGateOrbital {
         @tier "domain"
       OPEN_SUBJECT -> external {
         id : string!
+        row : ApprovalRequest
         subjectId : string
         subjectLabel : string
       }
@@ -496,6 +499,10 @@ orbital ApprovalGateOrbital {
         @label "Review slot"
         @description "UI slot the review queue renders into. Defaults to the modal overlay so the queue never seizes the host's main content; summoned via OPEN, cleared via CLOSE."
         @tier "internal"
+      itemClickEvent : event = OPEN_SUBJECT
+        @label "Row click"
+        @description "Event emitted when a row is clicked; opens the subject under review. Empty disables the row click."
+        @tier "presentation"
       itemActions : [ItemAction] = [{
         event: OPEN_SUBJECT
         icon: eye

package/behaviors/lolo/infra/atoms/std-cache-aside.lolo

@@ -91,14 +91,7 @@ orbital CacheEntryOrbital {
         (fetch CacheEntry {
           emit: { failure: CacheEntryLoadFailed, success: CacheEntryLoaded }
         })
-        (render-ui main {
-          align: center
-          children: [<Spinner.traits.SpinnerRender linkedEntity={CacheEntry} />, <Typography.traits.TypographyRender color={muted} content={"Fetching cache…"} linkedEntity={CacheEntry} variant={caption} />]
-          className: py-12
-          direction: vertical
-          gap: md
-          type: stack
-        })
+        (render-ui main { type: skeleton, variant: detail })
     }
 
     state loading {
@@ -208,16 +201,12 @@ orbital CacheEntryOrbital {
         (fetch CacheEntry {
           emit: { failure: CacheEntryLoadFailed, success: CacheEntryLoaded }
         })
-        (render-ui main <Stack>
-          <Spinner.traits.SpinnerRender linkedEntity={CacheEntry} />
-        </Stack>)
+        (render-ui main { type: skeleton, variant: detail })
       FETCH -> loading
         (fetch CacheEntry {
           emit: { failure: CacheEntryLoadFailed, success: CacheEntryLoaded }
         })
-        (render-ui main <Stack>
-          <Spinner.traits.SpinnerRender linkedEntity={CacheEntry} />
-        </Stack>)
+        (render-ui main { type: skeleton, variant: detail })
     }
 
     state error {
@@ -229,9 +218,7 @@ orbital CacheEntryOrbital {
         (fetch CacheEntry {
           emit: { failure: CacheEntryLoadFailed, success: CacheEntryLoaded }
         })
-        (render-ui main <Stack>
-          <Spinner.traits.SpinnerRender linkedEntity={CacheEntry} />
-        </Stack>)
+        (render-ui main { type: skeleton, variant: detail })
     }
 
     emits {

package/behaviors/lolo/infra/atoms/std-migration-job.lolo

@@ -4,7 +4,7 @@ orbital MigrationJobOrbital {
 
   type MigrationFile = { name : string, size : number, type : string, lastModified : number }
   type ImportSourceOption = { id : string!, kind : string!, label : string!, event : string }
-  type ImportUnit = { ref : string!, targetEntity : string!, fields : Map string scalar, parentRef : string }
+  type ImportUnit = { ref : string!, targetEntity : string!, title : string, fields : Map string scalar, parentRef : string }
   type ImportSkip = { ref : string!, reason : string! }
   type MigrationStats = { committed : number, failed : [Map string scalar] }
 
@@ -17,7 +17,7 @@ orbital MigrationJobOrbital {
     documents : [Map string scalar] @description "Document metadata listed from the source — migration.listDocuments service result, never destructured by the atom." = []
     document : Map string scalar @description "Most recently fetched document content — migration.fetchDocument service result, never destructured by the atom." = {}
     stats : MigrationStats @description "Staged/committed/failed/skipped counts — merged from host staging and migration.commit service results, never destructured by the atom." = {}
-    units : [ImportUnit] @description "Staged ImportUnits ready for review (ref/targetEntity/fields/parentRef), when the host stages the full rows rather than aggregate stats only." @synonyms "staged units, preview rows, import rows, staged rows" = []
+    units : [ImportUnit] @description "Staged ImportUnits ready for review (ref/targetEntity/title/fields/parentRef), when the host stages the full rows rather than aggregate stats only." @synonyms "staged units, preview rows, import rows, staged rows" = []
     skipped : [ImportSkip] @description "Source elements skipped during staging with a reason each, when the host stages the full rows rather than aggregate stats only." @synonyms "skipped rows, skipped elements, staging skips" = []
     validationErrors : [Map string scalar] @description "Validation errors surfaced during staging, when the host stages the full rows rather than aggregate stats only." @synonyms "staging errors, validation issues, import errors" = []
     error : string @description "Failure detail when status is failed." = ""

package/behaviors/lolo/infra/atoms/std-notification-preferences.lolo

@@ -43,17 +43,10 @@ orbital NotificationPreferencesOrbital {
           emit: { failure: PreferencesLoadFailed, success: PreferencesLoaded }
         })
         (render-ui main {
-          align: center
-          children: [{ type: spinner }, {
-            color: muted
-            content: "Loading notification preferences…"
-            type: typography
-            variant: caption
-          }]
-          className: py-12
-          direction: vertical
-          gap: md
           type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: grid, rows: 6 }]
         })
       PreferencesLoaded -> browsing
         (render-ui main {
@@ -103,6 +96,7 @@ orbital NotificationPreferencesOrbital {
               variant: caption
             }]
             gap: sm
+            itemClickEvent: @config.itemClickEvent
             itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
             look: @config.tableLook
             type: data-grid
@@ -137,7 +131,12 @@ orbital NotificationPreferencesOrbital {
         (fetch NotificationPreference {
           emit: { failure: PreferencesLoadFailed, success: PreferencesLoaded }
         })
-        (render-ui main { size: sm, type: spinner })
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: grid, rows: 6 }]
+        })
       ;; CREATE/EDIT open the modal trait refs (modal slot) — the grid stays
       ;; mounted behind them, so no arm here.
       DELETE -> browsing
@@ -201,14 +200,24 @@ orbital NotificationPreferencesOrbital {
         (fetch NotificationPreference {
           emit: { failure: PreferencesLoadFailed, success: PreferencesLoaded }
         })
-        (render-ui main { size: sm, type: spinner })
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: grid, rows: 6 }]
+        })
       ;; the error screen's Retry button: INIT is lifecycle-only and the bus
       ;; never delivers it, so the affordance must target a first-class event
       RETRY -> loading
         (fetch NotificationPreference {
           emit: { failure: PreferencesLoadFailed, success: PreferencesLoaded }
         })
-        (render-ui main { size: sm, type: spinner })
+        (render-ui main {
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: grid, rows: 6 }]
+        })
     }
 
     emits {
@@ -333,6 +342,10 @@ orbital NotificationPreferencesOrbital {
         @label "Table look"
         @description "Layer 2 visual treatment for the preference data table rendered by this atom."
         @tier "presentation"
+      itemClickEvent : event = EDIT
+        @label "Row click"
+        @description "Event emitted when a row is clicked; opens the preference for editing. Empty disables the row click."
+        @tier "presentation"
       itemActions : [ItemAction] = [{
         event: EDIT
         icon: pencil

package/behaviors/lolo/infra/atoms/std-permission-matrix.lolo

@@ -162,6 +162,7 @@ orbital PermissionMatrixOrbital {
               variant: caption
             }]
             gap: sm
+            itemClickEvent: @config.itemClickEvent
             itemActions: (array/filter @config.itemActions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
             type: data-grid
           }]
@@ -248,6 +249,10 @@ orbital PermissionMatrixOrbital {
     config {}
 
     config {
+      itemClickEvent : event = EDIT
+        @label "Row click"
+        @description "Event emitted when a row is clicked; opens the grant for editing. Empty disables the row click."
+        @tier "presentation"
       itemActions : [ItemAction] = [{
         event: EDIT
         icon: pencil

package/behaviors/lolo/ui/avl/atoms/ui-avl-glyph.lolo

@@ -18,6 +18,22 @@ orbital AvlGlyphOrbital {
           size: @config.size
           showCaption: @config.showCaption
           className: @config.className
+          enter: @config.enter
+          enterDelay: @config.enterDelay
+          aria-label: @config.ariaLabel
+          aria-labelledby: @config.ariaLabelledby
+          aria-describedby: @config.ariaDescribedby
+          aria-live: @config.ariaLive
+          aria-current: @config.ariaCurrent
+          aria-pressed: @config.ariaPressed
+          aria-expanded: @config.ariaExpanded
+          aria-selected: @config.ariaSelected
+          aria-hidden: @config.ariaHidden
+          aria-busy: @config.ariaBusy
+          role: @config.role
+          lang: @config.lang
+          dir: @config.dir
+          tabIndex: @config.tabIndex
           type: avl-glyph
         })
     }
@@ -47,6 +63,80 @@ orbital AvlGlyphOrbital {
         @label "Class Name"
         @description "className prop"
         @tier "presentation"
+      enter : "none" | "fade" | "rise" | "scale" | "slide"
+        @label "Enter"
+        @description "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out."
+        @tier "presentation"
+      enterDelay : number
+        @label "Enter Delay"
+        @description "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating."
+        @tier "presentation"
+      ariaLabel : string
+        @label "Aria-label"
+        @description "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control)."
+        @synonyms "aria-label"
+        @tier "presentation"
+      ariaLabelledby : string
+        @label "Aria-labelledby"
+        @description "Id of the element whose text names this one."
+        @synonyms "aria-labelledby"
+        @tier "presentation"
+      ariaDescribedby : string
+        @label "Aria-describedby"
+        @description "Id of the element whose text describes this one (help text, error)."
+        @synonyms "aria-describedby"
+        @tier "presentation"
+      ariaLive : "off" | "polite" | "assertive"
+        @label "Aria-live"
+        @description "Announce changes to this region: polite waits for a pause, assertive interrupts."
+        @synonyms "aria-live"
+        @tier "presentation"
+      ariaCurrent : "page" | "step" | "location" | "date" | "time" | "true" | "false"
+        @label "Aria-current"
+        @description "Marks the current item in a set: the current page, step, location, date or time."
+        @synonyms "aria-current"
+        @tier "presentation"
+      ariaPressed : "true" | "false" | "mixed"
+        @label "Aria-pressed"
+        @description "Toggle-button state."
+        @synonyms "aria-pressed"
+        @tier "presentation"
+      ariaExpanded : boolean
+        @label "Aria-expanded"
+        @description "Whether the element it controls is expanded."
+        @synonyms "aria-expanded"
+        @tier "presentation"
+      ariaSelected : boolean
+        @label "Aria-selected"
+        @description "Whether this item is selected (tabs, options, grid cells)."
+        @synonyms "aria-selected"
+        @tier "presentation"
+      ariaHidden : boolean
+        @label "Aria-hidden"
+        @description "Hide from assistive technology (decorative content only)."
+        @synonyms "aria-hidden"
+        @tier "presentation"
+      ariaBusy : boolean
+        @label "Aria-busy"
+        @description "This region is updating; assistive technology waits before announcing it."
+        @synonyms "aria-busy"
+        @tier "presentation"
+      role : "alert" | "alertdialog" | "application" | "article" | "banner" | "blockquote" | "button" | "caption" | "cell" | "checkbox" | "code" | "columnheader" | "combobox" | "complementary" | "contentinfo" | "definition" | "deletion" | "dialog" | "document" | "emphasis" | "feed" | "figure" | "form" | "generic" | "grid" | "gridcell" | "group" | "heading" | "img" | "insertion" | "link" | "list" | "listbox" | "listitem" | "log" | "main" | "marquee" | "math" | "menu" | "menubar" | "menuitem" | "menuitemcheckbox" | "menuitemradio" | "meter" | "navigation" | "none" | "note" | "option" | "paragraph" | "presentation" | "progressbar" | "radio" | "radiogroup" | "region" | "row" | "rowgroup" | "rowheader" | "scrollbar" | "search" | "searchbox" | "separator" | "slider" | "spinbutton" | "status" | "strong" | "subscript" | "superscript" | "switch" | "tab" | "table" | "tablist" | "tabpanel" | "term" | "textbox" | "time" | "timer" | "toolbar" | "tooltip" | "tree" | "treegrid" | "treeitem"
+        @label "Role"
+        @description "WAI-ARIA role when the element's native semantics don't describe it."
+        @tier "presentation"
+      lang : string
+        @label "Lang"
+        @description "Language of this element's content (BCP 47, e.g. ar, sl, en)."
+        @tier "presentation"
+      dir : "ltr" | "rtl" | "auto"
+        @label "Dir"
+        @description "Text direction of this element's content."
+        @tier "presentation"
+      tabIndex : number
+        @label "Tab Index"
+        @description "0 puts the element in the Tab order; -1 makes it focusable only programmatically."
+        @tier "presentation"
     }
   }