@oicl/openbridge-webcomponents 2.2.0-next.4 → 2.2.0-next.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/bundle/openbridge-webcomponents.bundle.js +548 -6
  2. package/bundle/openbridge-webcomponents.bundle.js.map +1 -1
  3. package/custom-elements.json +856 -195
  4. package/dist/components/alert-button-item/alert-button-item.css.js +65 -1
  5. package/dist/components/alert-button-item/alert-button-item.css.js.map +1 -1
  6. package/dist/components/alert-button-item/alert-button-item.d.ts +14 -1
  7. package/dist/components/alert-button-item/alert-button-item.d.ts.map +1 -1
  8. package/dist/components/alert-button-item/alert-button-item.js +19 -2
  9. package/dist/components/alert-button-item/alert-button-item.js.map +1 -1
  10. package/dist/components/alert-subsystem-button/alert-subsystem-button.css.js +120 -0
  11. package/dist/components/alert-subsystem-button/alert-subsystem-button.css.js.map +1 -0
  12. package/dist/components/alert-subsystem-button/alert-subsystem-button.d.ts +105 -0
  13. package/dist/components/alert-subsystem-button/alert-subsystem-button.d.ts.map +1 -0
  14. package/dist/components/alert-subsystem-button/alert-subsystem-button.js +107 -0
  15. package/dist/components/alert-subsystem-button/alert-subsystem-button.js.map +1 -0
  16. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.css.js +4 -0
  17. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.css.js.map +1 -1
  18. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.d.ts +3 -1
  19. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.d.ts.map +1 -1
  20. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.js +7 -1
  21. package/dist/components/alert-subsystem-counter/alert-subsystem-counter.js.map +1 -1
  22. package/dist/components/diagnostic-button/diagnostic-button.css.js +18 -0
  23. package/dist/components/diagnostic-button/diagnostic-button.css.js.map +1 -0
  24. package/dist/components/diagnostic-button/diagnostic-button.d.ts +71 -0
  25. package/dist/components/diagnostic-button/diagnostic-button.d.ts.map +1 -0
  26. package/dist/components/diagnostic-button/diagnostic-button.js +52 -0
  27. package/dist/components/diagnostic-button/diagnostic-button.js.map +1 -0
  28. package/dist/components/diagnostic-menu/diagnostic-menu.css.js +109 -0
  29. package/dist/components/diagnostic-menu/diagnostic-menu.css.js.map +1 -0
  30. package/dist/components/diagnostic-menu/diagnostic-menu.d.ts +111 -0
  31. package/dist/components/diagnostic-menu/diagnostic-menu.d.ts.map +1 -0
  32. package/dist/components/diagnostic-menu/diagnostic-menu.js +90 -0
  33. package/dist/components/diagnostic-menu/diagnostic-menu.js.map +1 -0
  34. package/dist/components/icon-button/icon-button.js +2 -2
  35. package/dist/components/icon-button/icon-button.js.map +1 -1
  36. package/dist/components/top-bar/top-bar.css.js +6 -0
  37. package/dist/components/top-bar/top-bar.css.js.map +1 -1
  38. package/dist/components/top-bar/top-bar.d.ts +9 -1
  39. package/dist/components/top-bar/top-bar.d.ts.map +1 -1
  40. package/dist/components/top-bar/top-bar.js +2 -0
  41. package/dist/components/top-bar/top-bar.js.map +1 -1
  42. package/dist/generated/locales/es-419.d.ts +6 -0
  43. package/dist/generated/locales/es-419.d.ts.map +1 -1
  44. package/dist/generated/locales/es-419.js +6 -0
  45. package/dist/generated/locales/es-419.js.map +1 -1
  46. package/dist/generated/locales/fi-FI.d.ts +6 -0
  47. package/dist/generated/locales/fi-FI.d.ts.map +1 -1
  48. package/dist/generated/locales/fi-FI.js +6 -0
  49. package/dist/generated/locales/fi-FI.js.map +1 -1
  50. package/package.json +1 -1
@@ -59956,8 +59956,14 @@
59956
59956
  "declarations": [
59957
59957
  {
59958
59958
  "kind": "class",
59959
- "description": "`<obc-alert-button-item>` – The bell button that shows the alert state and count.\n\nShows the alert status as a bell in the style of the given alert type, with\nan optional counter, or as a global counter: one badge per severity, then\nthe bell and the total. `obc-alert-button` renders the item next to its\nsilence button; use the item on its own where no silence button is needed.\n\n---\n\n### Features\n- **Variants (`type`):** `flat` (icon only), `normal` (bordered, icon and\n counter) and `enhanced` (filled in the severity colour).\n- **Alert types:** `alarm`, `warning`, `caution` and the `level-*` family;\n `nAlerts` of 0 shows the idle bell.\n- **Counter:** `counter` shows `nAlerts` next to the bell, except in `flat`.\n- **Global counter:** `globalCounter` shows the per-severity `counts` as\n badges, then the bell and `nAlerts`, always in the normal style;\n `globalCounterType` picks filled badges or the severity shapes.\n- **Flashing:** `blinking` flashes the bell at the tempo `flashingSpeed`\n resolves (#1224).\n- **Fill height:** `fillHeight` stretches the visible button to the host\n height, as the tall `obc-alert-button` does.\n\n---\n\n### Usage Guidelines\n- Keep `nAlerts` and `counts` consistent; the item shows both as given.\n- The generated label reads e.g. \"Alerts, 12, 2 Alarm, 4 Warning,\n 6 Caution\"; an `aria-label` on the host replaces it. A visually hidden\n polite live region repeats that name, so a change of counts is announced\n without the button holding focus; the name attribute alone would change\n silently.\n- A native button, so Enter and Space activate it (APG button pattern).\n- A parent that joins another button to the item's end sets the\n `data-group-item-not-last` attribute on the host.\n- **TODO(designer):** the Figma file draws the flat item's hover, active and\n focused variants at 20 % opacity; the item uses the standard flat states.\n- **TODO(designer):** the Figma file defines no flashing for the global\n counter, so it never flashes.\n\n---\n\n### Example\n\n```html\n<obc-alert-button-item alertType=\"alarm\" nAlerts=\"3\" counter blinking></obc-alert-button-item>\n<obc-alert-button-item\n globalCounter\n nAlerts=\"12\"\n .counts=${{countAlarm: 2, countWarning: 4, countCaution: 6}}\n></obc-alert-button-item>\n```",
59959
+ "description": "`<obc-alert-button-item>` – The bell button that shows the alert state and count.\n\nShows the alert status as a bell in the style of the given alert type, with\nan optional counter, or as a global counter: one badge per severity, then\nthe bell and the total. `obc-alert-button` renders the item next to its\nsilence button; use the item on its own where no silence button is needed.\n\n---\n\n### Features\n- **Variants (`type`):** `flat` (icon only), `normal` (bordered, icon and\n counter) and `enhanced` (filled in the severity colour).\n- **Alert types:** `alarm`, `warning`, `caution` and the `level-*` family;\n `nAlerts` of 0 shows the idle bell.\n- **Counter:** `counter` shows `nAlerts` next to the bell, except in `flat`.\n- **Global counter:** `globalCounter` shows the per-severity `counts` as\n badges, then the bell and `nAlerts`, always in the normal style;\n `globalCounterType` picks filled badges or the severity shapes.\n- **Flashing:** `blinking` flashes the bell at the tempo `flashingSpeed`\n resolves (#1224).\n- **Fill height:** `fillHeight` stretches the visible button to the host\n height, as the tall `obc-alert-button` does.\n- **Icon slot:** the `icon` slot replaces the bell with any icon; the item\n then never flashes.\n- **Activated:** `activated` draws the selected style, for a button whose\n panel is showing.\n\n---\n\n### Usage Guidelines\n- Keep `nAlerts` and `counts` consistent; the item shows both as given.\n- The generated label reads e.g. \"Alerts, 12, 2 Alarm, 4 Warning,\n 6 Caution\"; an `aria-label` on the host replaces it. A visually hidden\n polite live region repeats that name, so a change of counts is announced\n without the button holding focus; the name attribute alone would change\n silently.\n- A native button, so Enter and Space activate it (APG button pattern).\n- A parent that joins another button to the item's end sets the\n `data-group-item-not-last` attribute on the host.\n- **TODO(designer):** the Figma file draws the flat item's hover, active and\n focused variants at 20 % opacity; the item uses the standard flat states.\n- **TODO(designer):** the Figma file defines no flashing for the global\n counter, so it never flashes.\n\n---\n\n### Example\n\n```html\n<obc-alert-button-item alertType=\"alarm\" nAlerts=\"3\" counter blinking></obc-alert-button-item>\n<obc-alert-button-item\n globalCounter\n nAlerts=\"12\"\n .counts=${{countAlarm: 2, countWarning: 4, countCaution: 6}}\n></obc-alert-button-item>\n```",
59960
59960
  "name": "ObcAlertButtonItem",
59961
+ "slots": [
59962
+ {
59963
+ "description": "Replaces the bell. The flash cross-fades two bells, so a slotted icon never flashes and `blinking` has no effect while the slot is filled.",
59964
+ "name": "icon"
59965
+ }
59966
+ ],
59961
59967
  "members": [
59962
59968
  {
59963
59969
  "kind": "field",
@@ -60104,6 +60110,16 @@
60104
60110
  "description": "Stretches the visible button to the host height instead of the 32 px visual target.",
60105
60111
  "attribute": "fillHeight"
60106
60112
  },
60113
+ {
60114
+ "kind": "field",
60115
+ "name": "activated",
60116
+ "type": {
60117
+ "text": "boolean"
60118
+ },
60119
+ "default": "false",
60120
+ "description": "Draws the button in the selected style, for a button whose panel is showing.",
60121
+ "attribute": "activated"
60122
+ },
60107
60123
  {
60108
60124
  "kind": "field",
60109
60125
  "name": "ariaLabel",
@@ -60114,6 +60130,25 @@
60114
60130
  "description": "Accessible name forwarded to the inner `<button>`, mapped to the `aria-label` attribute; replaces the generated label. `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
60115
60131
  "attribute": "aria-label"
60116
60132
  },
60133
+ {
60134
+ "kind": "field",
60135
+ "name": "ariaExpanded",
60136
+ "type": {
60137
+ "text": "string | null"
60138
+ },
60139
+ "default": "null",
60140
+ "description": "Whether the panel the button opens is showing, forwarded to the inner `<button>` as `aria-expanded`; mapped to the `aria-expanded` attribute. Set it with `activated` from the flag that drives the panel; left unset, the button announces no panel.",
60141
+ "attribute": "aria-expanded"
60142
+ },
60143
+ {
60144
+ "kind": "field",
60145
+ "name": "hasSlottedIcon",
60146
+ "type": {
60147
+ "text": "boolean"
60148
+ },
60149
+ "privacy": "private",
60150
+ "default": "false"
60151
+ },
60117
60152
  {
60118
60153
  "kind": "field",
60119
60154
  "name": "flashing",
@@ -60267,6 +60302,15 @@
60267
60302
  "description": "Stretches the visible button to the host height instead of the 32 px visual target.",
60268
60303
  "fieldName": "fillHeight"
60269
60304
  },
60305
+ {
60306
+ "name": "activated",
60307
+ "type": {
60308
+ "text": "boolean"
60309
+ },
60310
+ "default": "false",
60311
+ "description": "Draws the button in the selected style, for a button whose panel is showing.",
60312
+ "fieldName": "activated"
60313
+ },
60270
60314
  {
60271
60315
  "name": "aria-label",
60272
60316
  "type": {
@@ -60275,6 +60319,15 @@
60275
60319
  "default": "null",
60276
60320
  "description": "Accessible name forwarded to the inner `<button>`, mapped to the `aria-label` attribute; replaces the generated label. `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
60277
60321
  "fieldName": "ariaLabel"
60322
+ },
60323
+ {
60324
+ "name": "aria-expanded",
60325
+ "type": {
60326
+ "text": "string | null"
60327
+ },
60328
+ "default": "null",
60329
+ "description": "Whether the panel the button opens is showing, forwarded to the inner `<button>` as `aria-expanded`; mapped to the `aria-expanded` attribute. Set it with `activated` from the flag that drives the panel; left unset, the button announces no panel.",
60330
+ "fieldName": "ariaExpanded"
60278
60331
  }
60279
60332
  ],
60280
60333
  "superclass": {
@@ -62955,14 +63008,280 @@
62955
63008
  }
62956
63009
  ]
62957
63010
  },
63011
+ {
63012
+ "kind": "javascript-module",
63013
+ "path": "src/components/alert-subsystem-button/alert-subsystem-button.ts",
63014
+ "declarations": [
63015
+ {
63016
+ "kind": "class",
63017
+ "description": "`<obc-alert-subsystem-button>` – A subsystem's alert counts as a split\ncontrol: the counts open the alert menu, the list icon goes to the alert\nlist page.\n\nThe left half is `obc-alert-subsystem-counter` with the per-severity\n`counts` drawn by `obc-alert-counter-item`, inside a button of the normal\nstyle; the right half is an icon button with the alert list icon. The two\nshare one edge, as the halves of `obc-split-button` do.\n\n---\n\n### Features\n- **Counts:** `counts` per severity, drawn as badges; `hasAlert` off, or\n on with nothing counted, shows `emptyText` instead.\n- **Label and icon:** `label` and the `icon` slot, as on the counter.\n- **Two halves:** `counter-click` from the counts, `alert-list-click` from\n the list icon; `counterDisabled` and `listDisabled` disable one half,\n `disabled` both.\n- **List icon:** the `list-icon` slot, the alert list icon when empty.\n\n---\n\n### Usage Guidelines\n- Show `obc-alert-menu` on `counter-click` and navigate on\n `alert-list-click`; the button reports the clicks and nothing more.\n- Two native buttons, each a tab stop, activated by Enter and Space\n ([APG button pattern](https://www.w3.org/WAI/ARIA/apg/patterns/button/)).\n Left out: nothing.\n- **TODO(designer):** the design draws an empty placeholder badge for each\n zero count; no counter in the library does, so only non-zero counts are\n drawn (#1396).\n- **TODO(designer):** a disabled counter half dims its frame, while the\n severity badges keep their colour and the label its active colour; the\n design has no disabled variant.\n\n---\n\n### Example\n\n```html\n<obc-alert-subsystem-button label=\"HVAC\" hasAlert .counts=${{countCaution: 2}}>\n <obi-placeholder slot=\"icon\"></obi-placeholder>\n</obc-alert-subsystem-button>\n```",
63018
+ "name": "ObcAlertSubsystemButton",
63019
+ "slots": [
63020
+ {
63021
+ "description": "Leading icon of the counter half.",
63022
+ "name": "icon"
63023
+ },
63024
+ {
63025
+ "description": "Icon of the list half; the alert list icon when empty.",
63026
+ "name": "list-icon"
63027
+ }
63028
+ ],
63029
+ "members": [
63030
+ {
63031
+ "kind": "field",
63032
+ "name": "counts",
63033
+ "type": {
63034
+ "text": "AlertCounts"
63035
+ },
63036
+ "default": "{}",
63037
+ "description": "Alert count per severity, drawn as badges in the counter half.\n\nAvailable when `hasAlert==true`.",
63038
+ "availableWhen": "hasAlert==true",
63039
+ "availableWhenIf": {
63040
+ "arg": "hasAlert",
63041
+ "truthy": true
63042
+ }
63043
+ },
63044
+ {
63045
+ "kind": "field",
63046
+ "name": "hasAlert",
63047
+ "type": {
63048
+ "text": "boolean"
63049
+ },
63050
+ "default": "false",
63051
+ "description": "Whether the subsystem has active alerts: `true` draws the badges, `false` the `emptyText`; `true` with nothing counted shows the `emptyText` as well.",
63052
+ "attribute": "hasAlert"
63053
+ },
63054
+ {
63055
+ "kind": "field",
63056
+ "name": "label",
63057
+ "type": {
63058
+ "text": "string"
63059
+ },
63060
+ "default": "''",
63061
+ "description": "The subsystem label, before the badges.",
63062
+ "attribute": "label"
63063
+ },
63064
+ {
63065
+ "kind": "field",
63066
+ "name": "emptyText",
63067
+ "type": {
63068
+ "text": "string"
63069
+ },
63070
+ "default": "'No alerts'",
63071
+ "description": "Text shown instead of the badges when `hasAlert` is `false` or nothing is counted.",
63072
+ "attribute": "emptyText"
63073
+ },
63074
+ {
63075
+ "kind": "field",
63076
+ "name": "disabled",
63077
+ "type": {
63078
+ "text": "boolean"
63079
+ },
63080
+ "default": "false",
63081
+ "description": "Disables both halves.",
63082
+ "attribute": "disabled"
63083
+ },
63084
+ {
63085
+ "kind": "field",
63086
+ "name": "counterDisabled",
63087
+ "type": {
63088
+ "text": "boolean"
63089
+ },
63090
+ "default": "false",
63091
+ "description": "Disables the counter half alone.",
63092
+ "attribute": "counterDisabled"
63093
+ },
63094
+ {
63095
+ "kind": "field",
63096
+ "name": "listDisabled",
63097
+ "type": {
63098
+ "text": "boolean"
63099
+ },
63100
+ "default": "false",
63101
+ "description": "Disables the list half alone.",
63102
+ "attribute": "listDisabled"
63103
+ },
63104
+ {
63105
+ "kind": "field",
63106
+ "name": "listButtonLabel",
63107
+ "type": {
63108
+ "text": "string"
63109
+ },
63110
+ "default": "''",
63111
+ "description": "Accessible name of the list half; \"Alert list\" when left empty.",
63112
+ "attribute": "listButtonLabel"
63113
+ },
63114
+ {
63115
+ "kind": "field",
63116
+ "name": "ariaLabel",
63117
+ "type": {
63118
+ "text": "string | null"
63119
+ },
63120
+ "default": "null",
63121
+ "description": "Accessible name of the counter half, mapped to the `aria-label` attribute; replaces the generated \"HVAC, 2 Caution\", or \"Alerts\" when the half has neither a label nor text. `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
63122
+ "attribute": "aria-label"
63123
+ },
63124
+ {
63125
+ "kind": "field",
63126
+ "name": "showsCounts",
63127
+ "type": {
63128
+ "text": "boolean"
63129
+ },
63130
+ "privacy": "private",
63131
+ "description": "The flag the counter gets: `hasAlert` with nothing to draw reads as none.",
63132
+ "readonly": true
63133
+ },
63134
+ {
63135
+ "kind": "field",
63136
+ "name": "counterName",
63137
+ "type": {
63138
+ "text": "string"
63139
+ },
63140
+ "privacy": "private",
63141
+ "readonly": true
63142
+ },
63143
+ {
63144
+ "kind": "field",
63145
+ "name": "handleCounterClick",
63146
+ "privacy": "private"
63147
+ },
63148
+ {
63149
+ "kind": "field",
63150
+ "name": "handleListClick",
63151
+ "privacy": "private"
63152
+ }
63153
+ ],
63154
+ "events": [
63155
+ {
63156
+ "type": {
63157
+ "text": "CustomEvent<void>"
63158
+ },
63159
+ "description": "Fired when the counter half is clicked.",
63160
+ "name": "counter-click"
63161
+ },
63162
+ {
63163
+ "type": {
63164
+ "text": "CustomEvent<void>"
63165
+ },
63166
+ "description": "Fired when the list half is clicked.",
63167
+ "name": "alert-list-click"
63168
+ }
63169
+ ],
63170
+ "attributes": [
63171
+ {
63172
+ "name": "hasAlert",
63173
+ "type": {
63174
+ "text": "boolean"
63175
+ },
63176
+ "default": "false",
63177
+ "description": "Whether the subsystem has active alerts: `true` draws the badges, `false` the `emptyText`; `true` with nothing counted shows the `emptyText` as well.",
63178
+ "fieldName": "hasAlert"
63179
+ },
63180
+ {
63181
+ "name": "label",
63182
+ "type": {
63183
+ "text": "string"
63184
+ },
63185
+ "default": "''",
63186
+ "description": "The subsystem label, before the badges.",
63187
+ "fieldName": "label"
63188
+ },
63189
+ {
63190
+ "name": "emptyText",
63191
+ "type": {
63192
+ "text": "string"
63193
+ },
63194
+ "default": "'No alerts'",
63195
+ "description": "Text shown instead of the badges when `hasAlert` is `false` or nothing is counted.",
63196
+ "fieldName": "emptyText"
63197
+ },
63198
+ {
63199
+ "name": "disabled",
63200
+ "type": {
63201
+ "text": "boolean"
63202
+ },
63203
+ "default": "false",
63204
+ "description": "Disables both halves.",
63205
+ "fieldName": "disabled"
63206
+ },
63207
+ {
63208
+ "name": "counterDisabled",
63209
+ "type": {
63210
+ "text": "boolean"
63211
+ },
63212
+ "default": "false",
63213
+ "description": "Disables the counter half alone.",
63214
+ "fieldName": "counterDisabled"
63215
+ },
63216
+ {
63217
+ "name": "listDisabled",
63218
+ "type": {
63219
+ "text": "boolean"
63220
+ },
63221
+ "default": "false",
63222
+ "description": "Disables the list half alone.",
63223
+ "fieldName": "listDisabled"
63224
+ },
63225
+ {
63226
+ "name": "listButtonLabel",
63227
+ "type": {
63228
+ "text": "string"
63229
+ },
63230
+ "default": "''",
63231
+ "description": "Accessible name of the list half; \"Alert list\" when left empty.",
63232
+ "fieldName": "listButtonLabel"
63233
+ },
63234
+ {
63235
+ "name": "aria-label",
63236
+ "type": {
63237
+ "text": "string | null"
63238
+ },
63239
+ "default": "null",
63240
+ "description": "Accessible name of the counter half, mapped to the `aria-label` attribute; replaces the generated \"HVAC, 2 Caution\", or \"Alerts\" when the half has neither a label nor text. `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
63241
+ "fieldName": "ariaLabel"
63242
+ }
63243
+ ],
63244
+ "superclass": {
63245
+ "name": "LitElement",
63246
+ "package": "lit"
63247
+ },
63248
+ "tagName": "obc-alert-subsystem-button",
63249
+ "customElement": true
63250
+ }
63251
+ ],
63252
+ "exports": [
63253
+ {
63254
+ "kind": "js",
63255
+ "name": "ObcAlertSubsystemButton",
63256
+ "declaration": {
63257
+ "name": "ObcAlertSubsystemButton",
63258
+ "module": "src/components/alert-subsystem-button/alert-subsystem-button.ts"
63259
+ }
63260
+ },
63261
+ {
63262
+ "kind": "custom-element-definition",
63263
+ "name": "obc-alert-subsystem-button",
63264
+ "declaration": {
63265
+ "name": "ObcAlertSubsystemButton",
63266
+ "module": "src/components/alert-subsystem-button/alert-subsystem-button.ts"
63267
+ }
63268
+ }
63269
+ ]
63270
+ },
62958
63271
  {
62959
63272
  "kind": "javascript-module",
62960
63273
  "path": "src/components/alert-subsystem-counter/alert-subsystem-counter.ts",
62961
63274
  "declarations": [
62962
63275
  {
62963
63276
  "kind": "class",
62964
- "description": "`<obc-alert-subsystem-counter>` – A framed summary of a subsystem's alert\ncounts: a leading icon, a label, and a trailing set of slotted count badges.\n\nWhen there are no active alerts it shows a muted label and an empty-state\nmessage instead of the badges. The count badges themselves are supplied by\nthe consumer as slotted `obc-badge` elements; this component provides only\nthe frame, layout, label, and empty state.\n\n---\n\n### Features\n- **Orientation:** `horizontal` (single row) or `vertical` (badges on a line\n below the label).\n- **Alert state:** `hasAlert` toggles between an active (bold label, badges)\n and an inactive (muted label, empty text) presentation.\n- **Freeform label:** Pass a full title or an abbreviation — the label is\n plain text decided by the caller and truncates with an ellipsis.\n- **Configurable empty text:** Customize the message shown when there are no\n alerts via `emptyText`.\n- **Optional leading icon:** Provide an icon through the `icon` slot; omit it\n and the leading box collapses with no empty gap.\n\n---\n\n### Usage Guidelines\n- Use this component to give an at-a-glance count of outstanding alerts for a\n single subsystem, grouped by severity.\n- Provide one slotted badge per severity in the `badges` slot, typically\n `<obc-badge size=\"large\">` with a severity `type` and a `number`. The\n badge `type` values are the same severity vocabulary as `AlertType`\n (`alarm`, `warning`, `caution` and the `level-*` family); order them\n highest severity first, as `ALERT_SEVERITY_PRIORITY` does.\n- Set `hasAlert` to `false` to present the resolved/clear state; the badges\n are then not rendered and `emptyText` is shown. The component does not\n derive the state from the slotted badges — the consumer owns it.\n- Choose `vertical` orientation in narrow containers where the badges do not\n fit beside the label.\n- The counter is display-only: it renders no button and fires no events. For\n a clickable subsystem entry with badges, see `obc-tree-navigation-item`\n (`alertBadges`) or `obc-integration-fleet-button` (`alerts`).\n\n---\n\n### Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|------------------------|----------------------------------------------------|\n| `icon` | The slot has content | Leading 24px icon (e.g. `<obi-placeholder>`). |\n| `badges` | `hasAlert` is true | Count badges, one per severity (`<obc-badge>`). |\n\n---\n\n### Example\n\n```html\n<obc-alert-subsystem-counter label=\"Label\" hasAlert>\n <obi-placeholder slot=\"icon\"></obi-placeholder>\n <obc-badge slot=\"badges\" size=\"large\" type=\"alarm\" .number=${9}></obc-badge>\n <obc-badge slot=\"badges\" size=\"large\" type=\"warning\" .number=${4}></obc-badge>\n <obc-badge slot=\"badges\" size=\"large\" type=\"caution\" .number=${2}></obc-badge>\n</obc-alert-subsystem-counter>\n```",
63277
+ "description": "`<obc-alert-subsystem-counter>` – A framed summary of a subsystem's alert\ncounts: a leading icon, a label, and a trailing set of slotted count badges.\n\nWhen there are no active alerts it shows a muted label and an empty-state\nmessage instead of the badges. The count badges themselves are supplied by\nthe consumer as slotted `obc-badge` elements; this component provides only\nthe frame, layout, label, and empty state.\n\n---\n\n### Features\n- **Orientation:** `horizontal` (single row) or `vertical` (badges on a line\n below the label).\n- **Alert state:** `hasAlert` toggles between an active (bold label, badges)\n and an inactive (muted label, empty text) presentation.\n- **Freeform label:** Pass a full title or an abbreviation — the label is\n plain text decided by the caller and truncates with an ellipsis.\n- **Configurable empty text:** Customize the message shown when there are no\n alerts via `emptyText`.\n- **Optional leading icon:** Provide an icon through the `icon` slot; omit it\n and the leading box collapses with no empty gap; with no label either, the\n whole leading column goes and the badges take the frame.\n\n---\n\n### Usage Guidelines\n- Use this component to give an at-a-glance count of outstanding alerts for a\n single subsystem, grouped by severity.\n- Provide one slotted badge per severity in the `badges` slot, typically\n `<obc-badge size=\"large\">` with a severity `type` and a `number`. The\n badge `type` values are the same severity vocabulary as `AlertType`\n (`alarm`, `warning`, `caution` and the `level-*` family); order them\n highest severity first, as `ALERT_SEVERITY_PRIORITY` does.\n- Set `hasAlert` to `false` to present the resolved/clear state; the badges\n are then not rendered and `emptyText` is shown. The component does not\n derive the state from the slotted badges — the consumer owns it.\n- Choose `vertical` orientation in narrow containers where the badges do not\n fit beside the label.\n- The counter is display-only: it renders no button and fires no events. For\n a clickable subsystem entry with badges, see `obc-tree-navigation-item`\n (`alertBadges`) or `obc-integration-fleet-button` (`alerts`).\n\n---\n\n### Slots\n\n| Slot Name | Renders When... | Purpose |\n|-----------|------------------------|----------------------------------------------------|\n| `icon` | The slot has content | Leading 24px icon (e.g. `<obi-placeholder>`). |\n| `badges` | `hasAlert` is true | Count badges, one per severity (`<obc-badge>`). |\n\n---\n\n### Example\n\n```html\n<obc-alert-subsystem-counter label=\"Label\" hasAlert>\n <obi-placeholder slot=\"icon\"></obi-placeholder>\n <obc-badge slot=\"badges\" size=\"large\" type=\"alarm\" .number=${9}></obc-badge>\n <obc-badge slot=\"badges\" size=\"large\" type=\"warning\" .number=${4}></obc-badge>\n <obc-badge slot=\"badges\" size=\"large\" type=\"caution\" .number=${2}></obc-badge>\n</obc-alert-subsystem-counter>\n```",
62965
63278
  "name": "ObcAlertSubsystemCounter",
63279
+ "cssParts": [
63280
+ {
63281
+ "description": "The framed box, for a host that draws its own frame around the counter.",
63282
+ "name": "frame"
63283
+ }
63284
+ ],
62966
63285
  "slots": [
62967
63286
  {
62968
63287
  "description": "Optional leading 24px icon.",
@@ -68641,322 +68960,656 @@
68641
68960
  "name": "LitElement",
68642
68961
  "package": "lit"
68643
68962
  },
68644
- "tagName": "obc-context-menu-input",
68963
+ "tagName": "obc-context-menu-input",
68964
+ "customElement": true
68965
+ }
68966
+ ],
68967
+ "exports": [
68968
+ {
68969
+ "kind": "js",
68970
+ "name": "ObcContextMenuInput",
68971
+ "declaration": {
68972
+ "name": "ObcContextMenuInput",
68973
+ "module": "src/components/context-menu-input/context-menu-input.ts"
68974
+ }
68975
+ },
68976
+ {
68977
+ "kind": "custom-element-definition",
68978
+ "name": "obc-context-menu-input",
68979
+ "declaration": {
68980
+ "name": "ObcContextMenuInput",
68981
+ "module": "src/components/context-menu-input/context-menu-input.ts"
68982
+ }
68983
+ }
68984
+ ]
68985
+ },
68986
+ {
68987
+ "kind": "javascript-module",
68988
+ "path": "src/components/date-item/date-item.ts",
68989
+ "declarations": [
68990
+ {
68991
+ "kind": "class",
68992
+ "description": "`<obc-date-item>` – A calendar date cell component for displaying a single day, with optional event indicators and details.",
68993
+ "name": "ObcDateItem",
68994
+ "slots": [
68995
+ {
68996
+ "description": "No slots. All content is provided via properties.",
68997
+ "name": ""
68998
+ }
68999
+ ],
69000
+ "members": [
69001
+ {
69002
+ "kind": "field",
69003
+ "name": "size",
69004
+ "default": "DateItemSize.Small",
69005
+ "description": "Size of the date item: `small` (default) shows only the date and the event dots, `large` shows titles and descriptions for as many events as its height fits and aggregates the rest into a count.",
69006
+ "attribute": "size"
69007
+ },
69008
+ {
69009
+ "kind": "field",
69010
+ "name": "disabled",
69011
+ "type": {
69012
+ "text": "boolean"
69013
+ },
69014
+ "default": "false",
69015
+ "description": "Whether the date item is disabled. When true, the button is visually muted and not interactive.",
69016
+ "attribute": "disabled"
69017
+ },
69018
+ {
69019
+ "kind": "field",
69020
+ "name": "events",
69021
+ "type": {
69022
+ "text": "DateItemEvent[]"
69023
+ },
69024
+ "default": "[]",
69025
+ "description": "Array of events to display on this date. In small size, shows an event dot indicator. In large size, displays event details using obc-event-item components."
69026
+ },
69027
+ {
69028
+ "kind": "field",
69029
+ "name": "eventCount",
69030
+ "type": {
69031
+ "text": "number"
69032
+ },
69033
+ "default": "0",
69034
+ "description": "Number of events to display from the events array. When 0, shows all events. In small size, always caps at 2 dots regardless of this value.",
69035
+ "attribute": "eventCount"
69036
+ },
69037
+ {
69038
+ "kind": "field",
69039
+ "name": "isToday",
69040
+ "type": {
69041
+ "text": "boolean"
69042
+ },
69043
+ "default": "false",
69044
+ "description": "Whether the date item represents today. When true, displays the \"Today\" label (in large size) and uses amplified styling.",
69045
+ "attribute": "isToday"
69046
+ },
69047
+ {
69048
+ "kind": "field",
69049
+ "name": "checked",
69050
+ "type": {
69051
+ "text": "boolean"
69052
+ },
69053
+ "default": "false",
69054
+ "description": "Whether the date item is checked/selected. When true, uses selected styling (blue filled background).",
69055
+ "attribute": "checked"
69056
+ },
69057
+ {
69058
+ "kind": "field",
69059
+ "name": "_date",
69060
+ "type": {
69061
+ "text": "number"
69062
+ },
69063
+ "privacy": "private",
69064
+ "default": "1"
69065
+ },
69066
+ {
69067
+ "kind": "field",
69068
+ "name": "date",
69069
+ "description": "The numeric day of the month to display (1–31). Values outside this range are clamped.",
69070
+ "default": "1",
69071
+ "attribute": "date"
69072
+ },
69073
+ {
69074
+ "kind": "field",
69075
+ "name": "_maxVisibleEvents",
69076
+ "type": {
69077
+ "text": "number | null"
69078
+ },
69079
+ "privacy": "private",
69080
+ "default": "null"
69081
+ },
69082
+ {
69083
+ "kind": "field",
69084
+ "name": "_resizeObserver",
69085
+ "type": {
69086
+ "text": "ResizeObserver | undefined"
69087
+ },
69088
+ "privacy": "private"
69089
+ },
69090
+ {
69091
+ "kind": "field",
69092
+ "name": "_HEADER_HEIGHT",
69093
+ "type": {
69094
+ "text": "number"
69095
+ },
69096
+ "privacy": "private",
69097
+ "static": true,
69098
+ "readonly": true,
69099
+ "default": "48"
69100
+ },
69101
+ {
69102
+ "kind": "field",
69103
+ "name": "_EVENT_HEIGHT",
69104
+ "type": {
69105
+ "text": "number"
69106
+ },
69107
+ "privacy": "private",
69108
+ "static": true,
69109
+ "readonly": true,
69110
+ "default": "48"
69111
+ },
69112
+ {
69113
+ "kind": "method",
69114
+ "name": "_recalcVisibleEvents",
69115
+ "privacy": "private",
69116
+ "parameters": [
69117
+ {
69118
+ "name": "containerHeight",
69119
+ "type": {
69120
+ "text": "number"
69121
+ }
69122
+ }
69123
+ ]
69124
+ },
69125
+ {
69126
+ "kind": "field",
69127
+ "name": "_pressing",
69128
+ "type": {
69129
+ "text": "boolean"
69130
+ },
69131
+ "privacy": "private",
69132
+ "default": "false"
69133
+ },
69134
+ {
69135
+ "kind": "method",
69136
+ "name": "_handleDateClick",
69137
+ "privacy": "private",
69138
+ "parameters": [
69139
+ {
69140
+ "name": "e",
69141
+ "optional": true,
69142
+ "type": {
69143
+ "text": "Event"
69144
+ }
69145
+ }
69146
+ ]
69147
+ },
69148
+ {
69149
+ "kind": "method",
69150
+ "name": "_handleKeyDown",
69151
+ "privacy": "private",
69152
+ "parameters": [
69153
+ {
69154
+ "name": "e",
69155
+ "type": {
69156
+ "text": "KeyboardEvent"
69157
+ }
69158
+ }
69159
+ ]
69160
+ },
69161
+ {
69162
+ "kind": "method",
69163
+ "name": "_getDisplayEvents",
69164
+ "privacy": "private",
69165
+ "return": {
69166
+ "type": {
69167
+ "text": "{\n visibleEvents: DateItemEvent[];\n aggregatedCount: number;\n }"
69168
+ }
69169
+ },
69170
+ "description": "Get the events to display, applying auto-aggregation if needed.\nReturns an object with visibleEvents and aggregatedCount."
69171
+ }
69172
+ ],
69173
+ "events": [
69174
+ {
69175
+ "name": "date-click",
69176
+ "type": {
69177
+ "text": "CustomEvent<{date: number, events: DateItemEvent[], isToday: boolean, checked: boolean}>"
69178
+ },
69179
+ "description": "Fired when the date item is clicked."
69180
+ },
69181
+ {
69182
+ "type": {
69183
+ "text": "CustomEvent<{title: string, startTime: string, endTime: string}>"
69184
+ },
69185
+ "description": "Passed on from the event items in the cell when one is clicked, with its title, start and end time.",
69186
+ "name": "event-click"
69187
+ }
69188
+ ],
69189
+ "attributes": [
69190
+ {
69191
+ "name": "size",
69192
+ "default": "DateItemSize.Small",
69193
+ "description": "Size of the date item: `small` (default) shows only the date and the event dots, `large` shows titles and descriptions for as many events as its height fits and aggregates the rest into a count.",
69194
+ "fieldName": "size"
69195
+ },
69196
+ {
69197
+ "name": "disabled",
69198
+ "type": {
69199
+ "text": "boolean"
69200
+ },
69201
+ "default": "false",
69202
+ "description": "Whether the date item is disabled. When true, the button is visually muted and not interactive.",
69203
+ "fieldName": "disabled"
69204
+ },
69205
+ {
69206
+ "name": "eventCount",
69207
+ "type": {
69208
+ "text": "number"
69209
+ },
69210
+ "default": "0",
69211
+ "description": "Number of events to display from the events array. When 0, shows all events. In small size, always caps at 2 dots regardless of this value.",
69212
+ "fieldName": "eventCount"
69213
+ },
69214
+ {
69215
+ "name": "isToday",
69216
+ "type": {
69217
+ "text": "boolean"
69218
+ },
69219
+ "default": "false",
69220
+ "description": "Whether the date item represents today. When true, displays the \"Today\" label (in large size) and uses amplified styling.",
69221
+ "fieldName": "isToday"
69222
+ },
69223
+ {
69224
+ "name": "checked",
69225
+ "type": {
69226
+ "text": "boolean"
69227
+ },
69228
+ "default": "false",
69229
+ "description": "Whether the date item is checked/selected. When true, uses selected styling (blue filled background).",
69230
+ "fieldName": "checked"
69231
+ },
69232
+ {
69233
+ "name": "date",
69234
+ "description": "The numeric day of the month to display (1–31). Values outside this range are clamped.",
69235
+ "default": "1",
69236
+ "fieldName": "date"
69237
+ }
69238
+ ],
69239
+ "superclass": {
69240
+ "name": "LitElement",
69241
+ "package": "lit"
69242
+ },
69243
+ "summary": "Represents an interactive date item within a calendar or date-picker interface.\nIt visually communicates the current date, selection state, and whether events are scheduled for that day.\nThe component adapts its layout and content based on size, supporting both compact and detailed views.\n\n**Synonyms:** date item, calendar cell, day cell, date picker item, schedule day\n\n### Features\n- **Today Highlight:** When `isToday` is true, shows \"Today\" label (in large size) and uses amplified styling.\n- **Checked State:** When `checked` is true, uses selected styling (blue filled background).\n- **Size Options:**\n- `small` (default): Compact, shows only the date and event dot indicator.\n- `large`: Expands to show event details; visible events are auto-aggregated based on available space.\n- **Event Indicators:** Shows a colored dot in small size; in large size, displays event details with auto-aggregation.\n- **Disabled State:** Visually and functionally disables the date item.\n- **Accessibility:** Uses `aria-label` to describe the date and event count for assistive technologies.\n- **Date Range Enforcement:** The `date` property is clamped between 1 and 31.\n\n### Usage Guidelines\nUse `obc-date-item` to represent individual days in a calendar, date picker, or scheduling interface.\n- Set `isToday` to true for the current day to highlight it with amplified styling.\n- Set `checked` to true to indicate a selected or active date.\n- Add events to the `events` array to show scheduled events on that day.\n- Use the `large` size when you want to display event details directly within the date cell.\n- Use the `small` size for compact calendar grids or navigation bars.\n- Use `eventCount` to limit the number of visible events; remaining events are auto-aggregated.\n- For disabled dates, set `disabled` to prevent interaction.\n\n### Slots\nThis component does not use slots. All content is provided via properties.\n\n### Events\n| Event Name | Detail | Description |\n|--------------|-------------------------------------------------------------------------------------|----------------------------------------------------|\n| `date-click` | `{ date: number, events: DateItemEvent[], isToday: boolean, checked: boolean }` | Fired when the date item is clicked. |\n\n### Properties\n- `size` (`small` | `large`): Controls layout. In `large` mode, event details are shown and the visible event list is auto-aggregated based on available space and `eventCount`. Default: `small`.\n- `date` (number): The numeric day of the month (1–31). Values outside this range are clamped.\n- `isToday` (boolean): Shows \"Today\" label in large size and uses amplified styling. Default: `false`.\n- `checked` (boolean): Uses selected styling (blue filled background). Default: `false`.\n- `disabled` (boolean): Disables the button and applies a muted style. Default: `false`.\n- `events` (DateItemEvent[]): Array of events to display. In small size, shows an event dot. In large size, displays event details with auto-aggregation based on available space.\n- `eventCount` (number): Maximum number of events to display before aggregating. When 0, shows all events that fit; remaining events are shown as an aggregated count. Default: `0`.\n\n### Best Practices\n- In `small` size, only an event dot is shown; event details are not displayed.\n- In `large` size, events are auto-aggregated based on available space and `eventCount`.\n- Ensure event titles are concise as they may be truncated.\n- Do not use for multi-day event summaries; this component is for single-day representation.\n\n### Example\n```html\n<obc-date-item\nchecked\nsize=\"large\"\ndate=\"15\"\n.events=${[\n{title: \"Meeting\", startTime: \"09:00\", endTime: \"10:00\"},\n{title: \"Deadline\", startTime: \"14:00\", endTime: \"15:30\"}\n]}",
69244
+ "tagName": "obc-date-item",
69245
+ "customElement": true
69246
+ }
69247
+ ],
69248
+ "exports": [
69249
+ {
69250
+ "kind": "js",
69251
+ "name": "DateItemEvent",
69252
+ "declaration": {
69253
+ "name": "DateItemEvent",
69254
+ "module": "src/components/date-item/date-item.ts"
69255
+ }
69256
+ },
69257
+ {
69258
+ "kind": "js",
69259
+ "name": "EventItemType",
69260
+ "declaration": {
69261
+ "name": "EventItemType",
69262
+ "module": "src/components/date-item/date-item.ts"
69263
+ }
69264
+ },
69265
+ {
69266
+ "kind": "js",
69267
+ "name": "ObcDateItem",
69268
+ "declaration": {
69269
+ "name": "ObcDateItem",
69270
+ "module": "src/components/date-item/date-item.ts"
69271
+ }
69272
+ },
69273
+ {
69274
+ "kind": "custom-element-definition",
69275
+ "name": "obc-date-item",
69276
+ "declaration": {
69277
+ "name": "ObcDateItem",
69278
+ "module": "src/components/date-item/date-item.ts"
69279
+ }
69280
+ }
69281
+ ]
69282
+ },
69283
+ {
69284
+ "kind": "javascript-module",
69285
+ "path": "src/components/diagnostic-button/diagnostic-button.ts",
69286
+ "declarations": [
69287
+ {
69288
+ "kind": "class",
69289
+ "description": "`<obc-diagnostic-button>` – The top bar's diagnostic button: the asterisk\nand the number of diagnostics, selected while its menu is showing.\n\nThe diagnostic counterpart of `obc-alert-button`: `obc-alert-button-item`\nwith the diagnostic asterisk in its icon slot and a name of its own. It\nopens `obc-diagnostic-menu`, as the alert button opens the alert menu.\n\n---\n\n### Features\n- **Counter:** `nAlerts` is drawn next to the asterisk; 0 shows the\n asterisk alone.\n- **Activated:** `activated` draws the selected style while the diagnostic\n menu is showing.\n- **Name:** \"Diagnostics, 3\" is announced, and repeated when the count\n changes; `aria-label` replaces it.\n\n---\n\n### Usage Guidelines\n- Slot it into `obc-top-bar`'s `diagnostics` slot, after the alert button,\n or place it in a toolbar on its own.\n- Open the menu from `click` the way a bar button opens a menu: flip a\n flag of your own, bind it to the menu's `open`, to `activated` and to\n `aria-expanded`, and reset it on the menu's `close`.\n- A native button, so Enter and Space activate it\n ([APG button pattern](https://www.w3.org/WAI/ARIA/apg/patterns/button/)).\n Left out: nothing.\n- **TODO(designer):** the design draws a six-armed asterisk with rounded\n arms that is not in the icon library; the button draws\n `obi-diagnostic-badge`, the sharp asterisk of the diagnostic alert icon,\n until the icon is added (#1396).\n\n---\n\n### Example\n\n```html\n<obc-diagnostic-button nAlerts=\"3\" activated></obc-diagnostic-button>\n```",
69290
+ "name": "ObcDiagnosticButton",
69291
+ "members": [
69292
+ {
69293
+ "kind": "field",
69294
+ "name": "nAlerts",
69295
+ "type": {
69296
+ "text": "number"
69297
+ },
69298
+ "default": "0",
69299
+ "description": "Number of diagnostics, drawn as the counter; 0 shows the asterisk alone.",
69300
+ "attribute": "nAlerts"
69301
+ },
69302
+ {
69303
+ "kind": "field",
69304
+ "name": "activated",
69305
+ "type": {
69306
+ "text": "boolean"
69307
+ },
69308
+ "default": "false",
69309
+ "description": "Draws the selected style while the diagnostic menu is showing; bind it to the flag that drives the menu's `open`.",
69310
+ "attribute": "activated"
69311
+ },
69312
+ {
69313
+ "kind": "field",
69314
+ "name": "ariaLabel",
69315
+ "type": {
69316
+ "text": "string | null"
69317
+ },
69318
+ "default": "null",
69319
+ "description": "Accessible name forwarded to the inner `<button>`, mapped to the `aria-label` attribute; replaces the generated \"Diagnostics, 3\". `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
69320
+ "attribute": "aria-label"
69321
+ },
69322
+ {
69323
+ "kind": "field",
69324
+ "name": "ariaExpanded",
69325
+ "type": {
69326
+ "text": "string | null"
69327
+ },
69328
+ "default": "null",
69329
+ "description": "Whether the diagnostic menu is showing, forwarded to the inner `<button>` as `aria-expanded`; mapped to the `aria-expanded` attribute. Bind it with `activated`; left unset, the button announces no menu.",
69330
+ "attribute": "aria-expanded"
69331
+ },
69332
+ {
69333
+ "kind": "field",
69334
+ "name": "accessibleName",
69335
+ "type": {
69336
+ "text": "string"
69337
+ },
69338
+ "privacy": "private",
69339
+ "readonly": true
69340
+ }
69341
+ ],
69342
+ "events": [
69343
+ {
69344
+ "description": "Fired when the button is clicked.",
69345
+ "name": "click"
69346
+ }
69347
+ ],
69348
+ "attributes": [
69349
+ {
69350
+ "name": "nAlerts",
69351
+ "type": {
69352
+ "text": "number"
69353
+ },
69354
+ "default": "0",
69355
+ "description": "Number of diagnostics, drawn as the counter; 0 shows the asterisk alone.",
69356
+ "fieldName": "nAlerts"
69357
+ },
69358
+ {
69359
+ "name": "activated",
69360
+ "type": {
69361
+ "text": "boolean"
69362
+ },
69363
+ "default": "false",
69364
+ "description": "Draws the selected style while the diagnostic menu is showing; bind it to the flag that drives the menu's `open`.",
69365
+ "fieldName": "activated"
69366
+ },
69367
+ {
69368
+ "name": "aria-label",
69369
+ "type": {
69370
+ "text": "string | null"
69371
+ },
69372
+ "default": "null",
69373
+ "description": "Accessible name forwarded to the inner `<button>`, mapped to the `aria-label` attribute; replaces the generated \"Diagnostics, 3\". `aria-labelledby` is not supported: ID references cannot cross the shadow boundary.",
69374
+ "fieldName": "ariaLabel"
69375
+ },
69376
+ {
69377
+ "name": "aria-expanded",
69378
+ "type": {
69379
+ "text": "string | null"
69380
+ },
69381
+ "default": "null",
69382
+ "description": "Whether the diagnostic menu is showing, forwarded to the inner `<button>` as `aria-expanded`; mapped to the `aria-expanded` attribute. Bind it with `activated`; left unset, the button announces no menu.",
69383
+ "fieldName": "ariaExpanded"
69384
+ }
69385
+ ],
69386
+ "superclass": {
69387
+ "name": "LitElement",
69388
+ "package": "lit"
69389
+ },
69390
+ "tagName": "obc-diagnostic-button",
68645
69391
  "customElement": true
68646
69392
  }
68647
69393
  ],
68648
69394
  "exports": [
68649
69395
  {
68650
69396
  "kind": "js",
68651
- "name": "ObcContextMenuInput",
69397
+ "name": "ObcDiagnosticButton",
68652
69398
  "declaration": {
68653
- "name": "ObcContextMenuInput",
68654
- "module": "src/components/context-menu-input/context-menu-input.ts"
69399
+ "name": "ObcDiagnosticButton",
69400
+ "module": "src/components/diagnostic-button/diagnostic-button.ts"
68655
69401
  }
68656
69402
  },
68657
69403
  {
68658
69404
  "kind": "custom-element-definition",
68659
- "name": "obc-context-menu-input",
69405
+ "name": "obc-diagnostic-button",
68660
69406
  "declaration": {
68661
- "name": "ObcContextMenuInput",
68662
- "module": "src/components/context-menu-input/context-menu-input.ts"
69407
+ "name": "ObcDiagnosticButton",
69408
+ "module": "src/components/diagnostic-button/diagnostic-button.ts"
68663
69409
  }
68664
69410
  }
68665
69411
  ]
68666
69412
  },
68667
69413
  {
68668
69414
  "kind": "javascript-module",
68669
- "path": "src/components/date-item/date-item.ts",
69415
+ "path": "src/components/diagnostic-menu/diagnostic-menu.ts",
68670
69416
  "declarations": [
68671
69417
  {
68672
69418
  "kind": "class",
68673
- "description": "`<obc-date-item>` – A calendar date cell component for displaying a single day, with optional event indicators and details.",
68674
- "name": "ObcDateItem",
69419
+ "description": "`<obc-diagnostic-menu>` – The panel the diagnostic button opens: a titled\nlist of diagnostics with an acknowledge-all and a list button.\n\nThe diagnostic counterpart of `obc-alert-menu`, without its tabs and its\nsilence button: a title row, the slotted `obc-message-menu-item` rows in a\nscrolling list with an empty state, and a footer with \"ACK all visible\" and\n\"Diagnostics list\".\n\n---\n\n### Features\n- **Title row:** `menuTitle`, \"Diagnostics\" when left empty.\n- **Rows:** any number of `obc-message-menu-item` children; the list\n scrolls, slides new rows into place and shows an empty state the\n `empty-*` slots replace.\n- **ACK all visible:** enabled by `canAckAll`; fires\n `ack-all-visible-click` with the rows in view, as the alert menu does.\n- **Diagnostics list:** `showDiagnosticListButton` shows the button that\n fires `go-to-diagnostic-list-click` for the full list page.\n- **Soft dismiss:** `softDismiss` and `open` close the menu on a click\n outside or `Escape`, as every menu does.\n\n---\n\n### Usage Guidelines\n- Open it from `obc-diagnostic-button`'s `click` with a flag of your own,\n bound to `open` and to the button's `activated`, and reset on `close`.\n- A row is acknowledged through its own `primary-action-click`; the footer\n button reports every row in view at once.\n- Position it yourself, under the top bar's diagnostic button.\n- **TODO(designer):** the design draws an open-in-new glyph after\n \"Diagnostics list\" and a 696 px card that hugs its rows; neither the\n glyph nor a width token is in the library, so the button draws the\n chevron of the alert menu's \"Alerts\" button and the card keeps the alert\n menu's width and height (#1396).\n\n---\n\n### Example\n\n```html\n<obc-diagnostic-menu canAckAll>\n <obc-message-menu-item title=\"Simulate\" description=\"Value is simulated\" day=\"Yesterday\" time=\"09:12:34\" primaryActionLabel=\"Action\" hasPrimaryIcon>\n <obi-placeholder slot=\"primary-icon\"></obi-placeholder>\n </obc-message-menu-item>\n</obc-diagnostic-menu>\n```",
69420
+ "name": "ObcDiagnosticMenu",
68675
69421
  "slots": [
68676
69422
  {
68677
- "description": "No slots. All content is provided via properties.",
69423
+ "description": "The diagnostics as `obc-message-menu-item` rows.",
68678
69424
  "name": ""
68679
- }
68680
- ],
68681
- "members": [
68682
- {
68683
- "kind": "field",
68684
- "name": "size",
68685
- "default": "DateItemSize.Small",
68686
- "description": "Size of the date item: `small` (default) shows only the date and the event dots, `large` shows titles and descriptions for as many events as its height fits and aggregates the rest into a count.",
68687
- "attribute": "size"
68688
69425
  },
68689
69426
  {
68690
- "kind": "field",
68691
- "name": "disabled",
68692
- "type": {
68693
- "text": "boolean"
68694
- },
68695
- "default": "false",
68696
- "description": "Whether the date item is disabled. When true, the button is visually muted and not interactive.",
68697
- "attribute": "disabled"
69427
+ "description": "Title of the empty state, \"No diagnostics\" when left unfilled.",
69428
+ "name": "empty-title"
68698
69429
  },
68699
69430
  {
68700
- "kind": "field",
68701
- "name": "events",
68702
- "type": {
68703
- "text": "DateItemEvent[]"
68704
- },
68705
- "default": "[]",
68706
- "description": "Array of events to display on this date. In small size, shows an event dot indicator. In large size, displays event details using obc-event-item components."
69431
+ "description": "Description of the empty state.",
69432
+ "name": "empty-description"
68707
69433
  },
68708
69434
  {
68709
- "kind": "field",
68710
- "name": "eventCount",
68711
- "type": {
68712
- "text": "number"
68713
- },
68714
- "default": "0",
68715
- "description": "Number of events to display from the events array. When 0, shows all events. In small size, always caps at 2 dots regardless of this value.",
68716
- "attribute": "eventCount"
68717
- },
69435
+ "description": "Icon of the empty state, the diagnostic asterisk when left unfilled.",
69436
+ "name": "empty-icon"
69437
+ }
69438
+ ],
69439
+ "members": [
68718
69440
  {
68719
69441
  "kind": "field",
68720
- "name": "isToday",
69442
+ "name": "softDismiss",
68721
69443
  "type": {
68722
69444
  "text": "boolean"
68723
69445
  },
68724
69446
  "default": "false",
68725
- "description": "Whether the date item represents today. When true, displays the \"Today\" label (in large size) and uses amplified styling.",
68726
- "attribute": "isToday"
69447
+ "description": "Lets the menu close itself on a click outside it, on `Escape`, or when another menu opens. The page is covered while the menu is open, so the closing click reaches nothing there; only the top bar's strip stays clickable, which is how its buttons switch or close menus in one click. Wire it with three bindings: set `softDismiss`, bind `open` to a flag you keep, and reset that flag on `close`. The button that opens the menu needs no wiring of its own: flip the flag from its click. Leave it off to show and hide the menu yourself.",
69448
+ "attribute": "softDismiss"
68727
69449
  },
68728
69450
  {
68729
69451
  "kind": "field",
68730
- "name": "checked",
69452
+ "name": "open",
68731
69453
  "type": {
68732
69454
  "text": "boolean"
68733
69455
  },
68734
69456
  "default": "false",
68735
- "description": "Whether the date item is checked/selected. When true, uses selected styling (blue filled background).",
68736
- "attribute": "checked"
68737
- },
68738
- {
68739
- "kind": "field",
68740
- "name": "_date",
68741
- "type": {
68742
- "text": "number"
68743
- },
68744
- "privacy": "private",
68745
- "default": "1"
69457
+ "description": "Whether the menu is showing. Bind it to a flag you keep rather than toggling it from the menu's own value: when the menu closes itself, `open` is written back to `false` before the button's click reaches your handler, so `menu.open = !menu.open` gets out of step. Reset the flag on `close`.\n\nAvailable when `softDismiss==true`.",
69458
+ "attribute": "open",
69459
+ "availableWhen": "softDismiss==true",
69460
+ "availableWhenIf": {
69461
+ "arg": "softDismiss",
69462
+ "truthy": true
69463
+ }
68746
69464
  },
68747
69465
  {
68748
69466
  "kind": "field",
68749
- "name": "date",
68750
- "description": "The numeric day of the month to display (1–31). Values outside this range are clamped.",
68751
- "default": "1",
68752
- "attribute": "date"
69467
+ "name": "softDismissController",
69468
+ "privacy": "protected",
69469
+ "readonly": true,
69470
+ "default": "new PopoverController(this)"
68753
69471
  },
68754
69472
  {
68755
69473
  "kind": "field",
68756
- "name": "_maxVisibleEvents",
69474
+ "name": "menuTitle",
68757
69475
  "type": {
68758
- "text": "number | null"
69476
+ "text": "string"
68759
69477
  },
68760
- "privacy": "private",
68761
- "default": "null"
69478
+ "default": "''",
69479
+ "description": "Title of the menu; \"Diagnostics\" when left empty.",
69480
+ "attribute": "menuTitle"
68762
69481
  },
68763
69482
  {
68764
69483
  "kind": "field",
68765
- "name": "_resizeObserver",
69484
+ "name": "canAckAll",
68766
69485
  "type": {
68767
- "text": "ResizeObserver | undefined"
69486
+ "text": "boolean"
68768
69487
  },
68769
- "privacy": "private"
69488
+ "default": "false",
69489
+ "description": "Enables the \"ACK all visible\" button; set it while a row in view can be acknowledged.\n\nAvailable when `showAckAllButton==true`.",
69490
+ "attribute": "canAckAll",
69491
+ "availableWhen": "showAckAllButton==true",
69492
+ "availableWhenIf": {
69493
+ "arg": "showAckAllButton",
69494
+ "truthy": true
69495
+ }
68770
69496
  },
68771
69497
  {
68772
69498
  "kind": "field",
68773
- "name": "_HEADER_HEIGHT",
69499
+ "name": "showAckAllButton",
68774
69500
  "type": {
68775
- "text": "number"
69501
+ "text": "boolean"
68776
69502
  },
68777
- "privacy": "private",
68778
- "static": true,
68779
- "readonly": true,
68780
- "default": "48"
69503
+ "default": "true",
69504
+ "description": "Shows the \"ACK all visible\" button in the footer."
68781
69505
  },
68782
69506
  {
68783
69507
  "kind": "field",
68784
- "name": "_EVENT_HEIGHT",
69508
+ "name": "showDiagnosticListButton",
68785
69509
  "type": {
68786
- "text": "number"
69510
+ "text": "boolean"
68787
69511
  },
68788
- "privacy": "private",
68789
- "static": true,
68790
- "readonly": true,
68791
- "default": "48"
68792
- },
68793
- {
68794
- "kind": "method",
68795
- "name": "_recalcVisibleEvents",
68796
- "privacy": "private",
68797
- "parameters": [
68798
- {
68799
- "name": "containerHeight",
68800
- "type": {
68801
- "text": "number"
68802
- }
68803
- }
68804
- ]
69512
+ "default": "true",
69513
+ "description": "Shows the \"Diagnostics list\" button in the footer."
68805
69514
  },
68806
69515
  {
68807
69516
  "kind": "field",
68808
- "name": "_pressing",
69517
+ "name": "list",
68809
69518
  "type": {
68810
- "text": "boolean"
69519
+ "text": "ObcAlertList"
68811
69520
  },
68812
- "privacy": "private",
68813
- "default": "false"
68814
- },
68815
- {
68816
- "kind": "method",
68817
- "name": "_handleDateClick",
68818
- "privacy": "private",
68819
- "parameters": [
68820
- {
68821
- "name": "e",
68822
- "optional": true,
68823
- "type": {
68824
- "text": "Event"
68825
- }
68826
- }
68827
- ]
68828
- },
68829
- {
68830
- "kind": "method",
68831
- "name": "_handleKeyDown",
68832
- "privacy": "private",
68833
- "parameters": [
68834
- {
68835
- "name": "e",
68836
- "type": {
68837
- "text": "KeyboardEvent"
68838
- }
68839
- }
68840
- ]
69521
+ "privacy": "private"
68841
69522
  },
68842
69523
  {
68843
69524
  "kind": "method",
68844
- "name": "_getDisplayEvents",
68845
- "privacy": "private",
68846
- "return": {
68847
- "type": {
68848
- "text": "{\n visibleEvents: DateItemEvent[];\n aggregatedCount: number;\n }"
68849
- }
68850
- },
68851
- "description": "Get the events to display, applying auto-aggregation if needed.\nReturns an object with visibleEvents and aggregatedCount."
69525
+ "name": "handleAckAllVisibleClick",
69526
+ "privacy": "private"
68852
69527
  }
68853
69528
  ],
68854
69529
  "events": [
68855
69530
  {
68856
- "name": "date-click",
69531
+ "name": "ack-all-visible-click",
68857
69532
  "type": {
68858
- "text": "CustomEvent<{date: number, events: DateItemEvent[], isToday: boolean, checked: boolean}>"
69533
+ "text": "ObcDiagnosticMenuAckAllVisibleClickEvent"
68859
69534
  },
68860
- "description": "Fired when the date item is clicked."
69535
+ "description": "Fired when the \"ACK all visible\" button is clicked, with the rows in view."
68861
69536
  },
68862
69537
  {
69538
+ "name": "go-to-diagnostic-list-click",
68863
69539
  "type": {
68864
- "text": "CustomEvent<{title: string, startTime: string, endTime: string}>"
69540
+ "text": "CustomEvent<void>"
68865
69541
  },
68866
- "description": "Passed on from the event items in the cell when one is clicked, with its title, start and end time.",
68867
- "name": "event-click"
69542
+ "description": "Fired when the \"Diagnostics list\" button is clicked."
69543
+ },
69544
+ {
69545
+ "type": {
69546
+ "text": "CustomEvent<void>"
69547
+ },
69548
+ "description": "Fired when the menu closed on its own, from a click outside, `Escape`, or another menu opening. `open` is already `false` by the time it arrives; reset the flag you bind to `open` here, or the next click on the button finds it still set and asks a closed menu to close.",
69549
+ "name": "close"
68868
69550
  }
68869
69551
  ],
68870
69552
  "attributes": [
68871
69553
  {
68872
- "name": "size",
68873
- "default": "DateItemSize.Small",
68874
- "description": "Size of the date item: `small` (default) shows only the date and the event dots, `large` shows titles and descriptions for as many events as its height fits and aggregates the rest into a count.",
68875
- "fieldName": "size"
68876
- },
68877
- {
68878
- "name": "disabled",
69554
+ "name": "softDismiss",
68879
69555
  "type": {
68880
69556
  "text": "boolean"
68881
69557
  },
68882
69558
  "default": "false",
68883
- "description": "Whether the date item is disabled. When true, the button is visually muted and not interactive.",
68884
- "fieldName": "disabled"
69559
+ "description": "Lets the menu close itself on a click outside it, on `Escape`, or when another menu opens. The page is covered while the menu is open, so the closing click reaches nothing there; only the top bar's strip stays clickable, which is how its buttons switch or close menus in one click. Wire it with three bindings: set `softDismiss`, bind `open` to a flag you keep, and reset that flag on `close`. The button that opens the menu needs no wiring of its own: flip the flag from its click. Leave it off to show and hide the menu yourself.",
69560
+ "fieldName": "softDismiss"
68885
69561
  },
68886
69562
  {
68887
- "name": "eventCount",
69563
+ "name": "open",
68888
69564
  "type": {
68889
- "text": "number"
69565
+ "text": "boolean"
68890
69566
  },
68891
- "default": "0",
68892
- "description": "Number of events to display from the events array. When 0, shows all events. In small size, always caps at 2 dots regardless of this value.",
68893
- "fieldName": "eventCount"
69567
+ "default": "false",
69568
+ "description": "Whether the menu is showing. Bind it to a flag you keep rather than toggling it from the menu's own value: when the menu closes itself, `open` is written back to `false` before the button's click reaches your handler, so `menu.open = !menu.open` gets out of step. Reset the flag on `close`.\n\nAvailable when `softDismiss==true`.",
69569
+ "fieldName": "open"
68894
69570
  },
68895
69571
  {
68896
- "name": "isToday",
69572
+ "name": "menuTitle",
68897
69573
  "type": {
68898
- "text": "boolean"
69574
+ "text": "string"
68899
69575
  },
68900
- "default": "false",
68901
- "description": "Whether the date item represents today. When true, displays the \"Today\" label (in large size) and uses amplified styling.",
68902
- "fieldName": "isToday"
69576
+ "default": "''",
69577
+ "description": "Title of the menu; \"Diagnostics\" when left empty.",
69578
+ "fieldName": "menuTitle"
68903
69579
  },
68904
69580
  {
68905
- "name": "checked",
69581
+ "name": "canAckAll",
68906
69582
  "type": {
68907
69583
  "text": "boolean"
68908
69584
  },
68909
69585
  "default": "false",
68910
- "description": "Whether the date item is checked/selected. When true, uses selected styling (blue filled background).",
68911
- "fieldName": "checked"
68912
- },
68913
- {
68914
- "name": "date",
68915
- "description": "The numeric day of the month to display (1–31). Values outside this range are clamped.",
68916
- "default": "1",
68917
- "fieldName": "date"
69586
+ "description": "Enables the \"ACK all visible\" button; set it while a row in view can be acknowledged.\n\nAvailable when `showAckAllButton==true`.",
69587
+ "fieldName": "canAckAll"
68918
69588
  }
68919
69589
  ],
68920
69590
  "superclass": {
68921
69591
  "name": "LitElement",
68922
69592
  "package": "lit"
68923
69593
  },
68924
- "summary": "Represents an interactive date item within a calendar or date-picker interface.\nIt visually communicates the current date, selection state, and whether events are scheduled for that day.\nThe component adapts its layout and content based on size, supporting both compact and detailed views.\n\n**Synonyms:** date item, calendar cell, day cell, date picker item, schedule day\n\n### Features\n- **Today Highlight:** When `isToday` is true, shows \"Today\" label (in large size) and uses amplified styling.\n- **Checked State:** When `checked` is true, uses selected styling (blue filled background).\n- **Size Options:**\n- `small` (default): Compact, shows only the date and event dot indicator.\n- `large`: Expands to show event details; visible events are auto-aggregated based on available space.\n- **Event Indicators:** Shows a colored dot in small size; in large size, displays event details with auto-aggregation.\n- **Disabled State:** Visually and functionally disables the date item.\n- **Accessibility:** Uses `aria-label` to describe the date and event count for assistive technologies.\n- **Date Range Enforcement:** The `date` property is clamped between 1 and 31.\n\n### Usage Guidelines\nUse `obc-date-item` to represent individual days in a calendar, date picker, or scheduling interface.\n- Set `isToday` to true for the current day to highlight it with amplified styling.\n- Set `checked` to true to indicate a selected or active date.\n- Add events to the `events` array to show scheduled events on that day.\n- Use the `large` size when you want to display event details directly within the date cell.\n- Use the `small` size for compact calendar grids or navigation bars.\n- Use `eventCount` to limit the number of visible events; remaining events are auto-aggregated.\n- For disabled dates, set `disabled` to prevent interaction.\n\n### Slots\nThis component does not use slots. All content is provided via properties.\n\n### Events\n| Event Name | Detail | Description |\n|--------------|-------------------------------------------------------------------------------------|----------------------------------------------------|\n| `date-click` | `{ date: number, events: DateItemEvent[], isToday: boolean, checked: boolean }` | Fired when the date item is clicked. |\n\n### Properties\n- `size` (`small` | `large`): Controls layout. In `large` mode, event details are shown and the visible event list is auto-aggregated based on available space and `eventCount`. Default: `small`.\n- `date` (number): The numeric day of the month (1–31). Values outside this range are clamped.\n- `isToday` (boolean): Shows \"Today\" label in large size and uses amplified styling. Default: `false`.\n- `checked` (boolean): Uses selected styling (blue filled background). Default: `false`.\n- `disabled` (boolean): Disables the button and applies a muted style. Default: `false`.\n- `events` (DateItemEvent[]): Array of events to display. In small size, shows an event dot. In large size, displays event details with auto-aggregation based on available space.\n- `eventCount` (number): Maximum number of events to display before aggregating. When 0, shows all events that fit; remaining events are shown as an aggregated count. Default: `0`.\n\n### Best Practices\n- In `small` size, only an event dot is shown; event details are not displayed.\n- In `large` size, events are auto-aggregated based on available space and `eventCount`.\n- Ensure event titles are concise as they may be truncated.\n- Do not use for multi-day event summaries; this component is for single-day representation.\n\n### Example\n```html\n<obc-date-item\nchecked\nsize=\"large\"\ndate=\"15\"\n.events=${[\n{title: \"Meeting\", startTime: \"09:00\", endTime: \"10:00\"},\n{title: \"Deadline\", startTime: \"14:00\", endTime: \"15:30\"}\n]}",
68925
- "tagName": "obc-date-item",
69594
+ "tagName": "obc-diagnostic-menu",
68926
69595
  "customElement": true
68927
69596
  }
68928
69597
  ],
68929
69598
  "exports": [
68930
69599
  {
68931
69600
  "kind": "js",
68932
- "name": "DateItemEvent",
68933
- "declaration": {
68934
- "name": "DateItemEvent",
68935
- "module": "src/components/date-item/date-item.ts"
68936
- }
68937
- },
68938
- {
68939
- "kind": "js",
68940
- "name": "EventItemType",
68941
- "declaration": {
68942
- "name": "EventItemType",
68943
- "module": "src/components/date-item/date-item.ts"
68944
- }
68945
- },
68946
- {
68947
- "kind": "js",
68948
- "name": "ObcDateItem",
69601
+ "name": "ObcDiagnosticMenu",
68949
69602
  "declaration": {
68950
- "name": "ObcDateItem",
68951
- "module": "src/components/date-item/date-item.ts"
69603
+ "name": "ObcDiagnosticMenu",
69604
+ "module": "src/components/diagnostic-menu/diagnostic-menu.ts"
68952
69605
  }
68953
69606
  },
68954
69607
  {
68955
69608
  "kind": "custom-element-definition",
68956
- "name": "obc-date-item",
69609
+ "name": "obc-diagnostic-menu",
68957
69610
  "declaration": {
68958
- "name": "ObcDateItem",
68959
- "module": "src/components/date-item/date-item.ts"
69611
+ "name": "ObcDiagnosticMenu",
69612
+ "module": "src/components/diagnostic-menu/diagnostic-menu.ts"
68960
69613
  }
68961
69614
  }
68962
69615
  ]
@@ -91370,7 +92023,7 @@
91370
92023
  "declarations": [
91371
92024
  {
91372
92025
  "kind": "class",
91373
- "description": "`<obc-top-bar>` – A responsive top navigation bar component for application layouts.\n\nProvides a flexible, highly configurable top bar for application interfaces, supporting navigation, context display, quick actions, and status indicators. The top bar adapts to screen size and can show or hide elements such as menu, app icon, breadcrumbs, user/profile, clock, and alert notifications.\n\nAppears at the top of the UI, organizing primary navigation and contextual actions in a single, persistent region. Designed for use as the main app bar or header in multi-pane or dashboard-style layouts.\n\n## Features\n- **Configurable Sections:** Supports left and right-aligned groups for navigation, context, and actions.\n- **Menu Button:** Optional menu button for opening navigation drawers or sidebars; can be styled as wide or regular.\n- **App Icon Slot:** Customizable slot for displaying an application or brand icon.\n- **App Title & Page Name:** Displays the current application and page context.\n- **Breadcrumbs:** Optional breadcrumb navigation for hierarchical context (in settings mode).\n- **Command Button Slot:** Slot for inserting a primary command/action button.\n- **Alert/Notification Area:** Slot for alert indicators, notification badges, or custom alert components.\n- **Dimming Button:** Optional button for toggling display modes (e.g., day/night).\n- **User/Profile Button:** Optional user icon for profile/account actions.\n- **Apps Button:** Optional button for accessing additional applications or modules.\n- **Clock & Date:** Optional digital clock and date display, responsive to screen size.\n- **Responsive Layout:** Multiple breakpoint properties to control visibility and layout of elements based on viewport width.\n- **Settings Mode:** Special mode with close, back, and forward navigation, breadcrumbs, and app title.\n- **Tall Variant:** Optional increased height for touch or accessibility needs.\n- **Inactive State:** Disables interactive elements and visually de-emphasizes the bar.\n\n## Variants\n- **Regular:** Standard top bar with menu, app icon, title, page name, and action slots.\n- **Settings:** Shows close, back, forward buttons, breadcrumbs, and app title for configuration or settings screens.\n- **Inactive:** Visually muted and disables interaction (e.g., when the app is locked or in a modal state).\n- **Tall:** Increases the height of the bar for improved touch targets.\n\n## Usage Guidelines\nUse `<obc-top-bar>` as the persistent header for your application, providing navigation, context, and quick access to key actions or status. Configure which elements appear via boolean properties and slots. Adjust breakpoint properties to control responsive behavior for each section.\n\n- Place navigation, branding, and context (title, breadcrumbs) on the left; actions, alerts, and status (clock, user, apps) on the right.\n- Use the `settings` property for configuration or setup screens to enable close/back/forward navigation and breadcrumbs.\n- Use the `inactive` property to visually disable the bar and its actions when the app is not interactive.\n- Insert custom icons or buttons using the `app-icon` and `command-button` slots.\n- Use the `alerts` slot to display alert indicators, notification badges, or custom alert components.\n\n**TODO(designer):** Clarify recommended combinations of visible elements for different app contexts (e.g., when to show both user and apps buttons, or best practices for alert placement).\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|------------------|---------------------------------|----------------------------------------------------------------|\n| `app-icon` | `showAppIcon` is true | Custom icon representing the application or brand. |\n| `command-button` | Always (if provided) | Primary command or action button for the current context. |\n| `alerts` | Always (if provided) | Area for alert indicators, notification badges, or alert items.|\n| `clock` | Always (if provided) | Clock component for displaying the current time. |\n\n## Events\n- `menu-button-clicked` – Fired when the menu button is clicked.\n- `dimming-button-clicked` – Fired when the dimming (day/night) button is clicked.\n- `apps-button-clicked` – Fired when the apps button is clicked.\n- `more-button-clicked` – Fired when the more button is clicked.\n- `left-more-button-clicked` – Deprecated alias of `more-button-clicked`, fired with it; removed in 4.0.0.\n- `user-button-clicked` – Fired when the user/profile button is clicked.\n- `close` – Fired in settings mode when the close button is clicked.\n- `back` – Fired in settings mode when the back button is clicked.\n- `forward` – Fired in settings mode when the forward button is clicked.\n- `emergency-brightness-start` – Fired when the menu button is held for 500ms. This should increase the brightness of the screen slowly. Used when the screen is too dark.\n- `emergency-brightness-stop` – Fired when the menu button is released.\n\n## Keyboard\nEvery control in the bar is its own tab stop and activates on `Enter` and\n`Space`. The bar is a navigation landmark, not an APG toolbar: its controls\nare separate components and slotted consumer content, so a roving tabindex\nacross them is deliberately not implemented. The emergency-brightness hold\nis a pointer gesture only; from the keyboard the menu button opens the menu.\n\n## Best Practices and Constraints\n- Only show interactive elements relevant to the current context to avoid clutter.\n- Use the `alerts` slot for transient or critical notifications; persistent alerts may require a different component.\n- For accessibility, give all interactive elements labels and focus handling.\n- Adjust breakpoint properties to optimize the layout for different device sizes.\n- In settings mode, use breadcrumbs to provide clear navigation context.\n\n## Example\n\n```html\n<obc-top-bar\n appTitle=\"My App\"\n pageName=\"Dashboard\"\n showAppsButton\n showDimmingButton\n showClock\n showUserButton\n showAppIcon\n>\n <obi-placeholder slot=\"app-icon\"></obi-placeholder>\n <obc-command-button slot=\"command-button\"></obc-command-button>\n <obc-topbar-message-item slot=\"alerts\"></obc-topbar-message-item>\n <obc-clock slot=\"clock\"></obc-clock>\n</obc-top-bar>\n```",
92026
+ "description": "`<obc-top-bar>` – A responsive top navigation bar component for application layouts.\n\nProvides a flexible, highly configurable top bar for application interfaces, supporting navigation, context display, quick actions, and status indicators. The top bar adapts to screen size and can show or hide elements such as menu, app icon, breadcrumbs, user/profile, clock, and alert notifications.\n\nAppears at the top of the UI, organizing primary navigation and contextual actions in a single, persistent region. Designed for use as the main app bar or header in multi-pane or dashboard-style layouts.\n\n## Features\n- **Configurable Sections:** Supports left and right-aligned groups for navigation, context, and actions.\n- **Menu Button:** Optional menu button for opening navigation drawers or sidebars; can be styled as wide or regular.\n- **App Icon Slot:** Customizable slot for displaying an application or brand icon.\n- **App Title & Page Name:** Displays the current application and page context.\n- **Breadcrumbs:** Optional breadcrumb navigation for hierarchical context (in settings mode).\n- **Command Button Slot:** Slot for inserting a primary command/action button.\n- **Asset Picker Slot:** Slot for a control that switches between the assets the page can show, such as an `obc-dropdown-button` whose label is the current asset.\n- **Alert/Notification Area:** Slot for alert indicators, notification badges, or custom alert components.\n- **Diagnostics Slot:** Slot for the diagnostic button, after the alert area.\n- **Dimming Button:** Optional button for toggling display modes (e.g., day/night).\n- **User/Profile Button:** Optional user icon for profile/account actions.\n- **Apps Button:** Optional button for accessing additional applications or modules.\n- **Clock & Date:** Optional digital clock and date display, responsive to screen size.\n- **Responsive Layout:** Multiple breakpoint properties to control visibility and layout of elements based on viewport width.\n- **Settings Mode:** Special mode with close, back, and forward navigation, breadcrumbs, and app title.\n- **Tall Variant:** Optional increased height for touch or accessibility needs.\n- **Inactive State:** Disables interactive elements and visually de-emphasizes the bar.\n\n## Variants\n- **Regular:** Standard top bar with menu, app icon, title, page name, and action slots.\n- **Settings:** Shows close, back, forward buttons, breadcrumbs, and app title for configuration or settings screens.\n- **Inactive:** Visually muted and disables interaction (e.g., when the app is locked or in a modal state).\n- **Tall:** Increases the height of the bar for improved touch targets.\n\n## Usage Guidelines\nUse `<obc-top-bar>` as the persistent header for your application, providing navigation, context, and quick access to key actions or status. Configure which elements appear via boolean properties and slots. Adjust breakpoint properties to control responsive behavior for each section.\n\n- Place navigation, branding, and context (title, breadcrumbs) on the left; actions, alerts, and status (clock, user, apps) on the right.\n- Use the `settings` property for configuration or setup screens to enable close/back/forward navigation and breadcrumbs.\n- Use the `inactive` property to visually disable the bar and its actions when the app is not interactive.\n- Insert custom icons or buttons using the `app-icon` and `command-button` slots.\n- Slot an `obc-dropdown-button` into `asset-picker` when the page shows one of several assets; the app owns the list and the selection and listens for the button's `change`.\n- Use the `alerts` slot to display alert indicators, notification badges, or custom alert components.\n- Slot an `obc-diagnostic-button` into `diagnostics`; open its `obc-diagnostic-menu` from the button's `click` the way the user menu is opened from the user button.\n\n**TODO(designer):** Clarify recommended combinations of visible elements for different app contexts (e.g., when to show both user and apps buttons, or best practices for alert placement).\n\n## Slots\n\n| Slot Name | Renders When... | Purpose |\n|------------------|---------------------------------|----------------------------------------------------------------|\n| `app-icon` | `showAppIcon` is true | Custom icon representing the application or brand. |\n| `command-button` | `settings` is false (if provided) | Primary command or action button for the current context. |\n| `asset-picker` | `settings` is false (if provided) | Control that switches the asset the page shows; its label is the current asset. |\n| `alerts` | Always (if provided) | Area for alert indicators, notification badges, or alert items.|\n| `diagnostics` | Always (if provided) | The diagnostic button (`obc-diagnostic-button`), after the alert area and before the dimming button. |\n| `clock` | Always (if provided) | Clock component for displaying the current time. |\n\n## Events\n- `menu-button-clicked` – Fired when the menu button is clicked.\n- `dimming-button-clicked` – Fired when the dimming (day/night) button is clicked.\n- `apps-button-clicked` – Fired when the apps button is clicked.\n- `more-button-clicked` – Fired when the more button is clicked.\n- `left-more-button-clicked` – Deprecated alias of `more-button-clicked`, fired with it; removed in 4.0.0.\n- `user-button-clicked` – Fired when the user/profile button is clicked.\n- `close` – Fired in settings mode when the close button is clicked.\n- `back` – Fired in settings mode when the back button is clicked.\n- `forward` – Fired in settings mode when the forward button is clicked.\n- `emergency-brightness-start` – Fired when the menu button is held for 500ms. This should increase the brightness of the screen slowly. Used when the screen is too dark.\n- `emergency-brightness-stop` – Fired when the menu button is released.\n\n## Keyboard\nEvery control in the bar is its own tab stop and activates on `Enter` and\n`Space`. The bar is a navigation landmark, not an APG toolbar: its controls\nare separate components and slotted consumer content, so a roving tabindex\nacross them is deliberately not implemented. The emergency-brightness hold\nis a pointer gesture only; from the keyboard the menu button opens the menu.\n\n## Best Practices and Constraints\n- Only show interactive elements relevant to the current context to avoid clutter.\n- Use the `alerts` slot for transient or critical notifications; persistent alerts may require a different component.\n- For accessibility, give all interactive elements labels and focus handling.\n- Adjust breakpoint properties to optimize the layout for different device sizes.\n- In settings mode, use breadcrumbs to provide clear navigation context.\n\n## Example\n\n```html\n<obc-top-bar\n appTitle=\"My App\"\n pageName=\"Dashboard\"\n showAppsButton\n showDimmingButton\n showClock\n showUserButton\n showAppIcon\n>\n <obi-placeholder slot=\"app-icon\"></obi-placeholder>\n <obc-command-button slot=\"command-button\"></obc-command-button>\n <obc-topbar-message-item slot=\"alerts\"></obc-topbar-message-item>\n <obc-clock slot=\"clock\"></obc-clock>\n</obc-top-bar>\n```",
91374
92027
  "name": "ObcTopBar",
91375
92028
  "cssParts": [
91376
92029
  {
@@ -91391,10 +92044,18 @@
91391
92044
  "description": "Primary command/action button for the current context",
91392
92045
  "name": "command-button"
91393
92046
  },
92047
+ {
92048
+ "description": "Control that switches the asset the page shows, with the current asset as its label; an `obc-dropdown-button` fits (regular layout only, not in settings mode)",
92049
+ "name": "asset-picker"
92050
+ },
91394
92051
  {
91395
92052
  "description": "Area for alert indicators, notification badges, or alert items",
91396
92053
  "name": "alerts"
91397
92054
  },
92055
+ {
92056
+ "description": "The diagnostic button, after the alert area and before the dimming button",
92057
+ "name": "diagnostics"
92058
+ },
91398
92059
  {
91399
92060
  "description": "Clock component for displaying the current time (shown when `showClock` is true)",
91400
92061
  "name": "clock"