@f-ewald/components 1.19.0 → 1.21.1

package/custom-elements.json

@@ -6793,6 +6793,22 @@
             "module": "./stat-meter.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "StatusBanner",
+          "declaration": {
+            "name": "StatusBanner",
+            "module": "./status-banner.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "StatusBannerVariant",
+          "declaration": {
+            "name": "StatusBannerVariant",
+            "module": "./status-banner.js"
+          }
+        },
         {
           "kind": "js",
           "name": "StatusPill",
@@ -7241,6 +7257,62 @@
             "module": "./split-hero.js"
           }
         },
+        {
+          "kind": "js",
+          "name": "TabBar",
+          "declaration": {
+            "name": "TabBar",
+            "module": "./tab-bar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TabChangeDetail",
+          "declaration": {
+            "name": "TabChangeDetail",
+            "module": "./tab-bar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "TabItem",
+          "declaration": {
+            "name": "TabItem",
+            "module": "./tab-item.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "MarkdownEditor",
+          "declaration": {
+            "name": "MarkdownEditor",
+            "module": "./markdown-editor.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "parseFrontMatter",
+          "declaration": {
+            "name": "parseFrontMatter",
+            "module": "./utils/front-matter.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatFrontMatterValue",
+          "declaration": {
+            "name": "formatFrontMatterValue",
+            "module": "./utils/front-matter.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "FrontMatterResult",
+          "declaration": {
+            "name": "FrontMatterResult",
+            "module": "./utils/front-matter.js"
+          }
+        },
         {
           "kind": "js",
           "name": "formatDuration",
@@ -9290,6 +9362,154 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/markdown-editor.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "GitHub-style markdown editor: a \"Write\" tab holding a plain textarea and a\n\"Preview\" tab rendering the markdown body (via `markdown-view`). Leading\nYAML front matter (a `---`-delimited block) is detected, parsed, and shown\nas a key-value table above the rendered body rather than as raw text.",
+          "name": "MarkdownEditor",
+          "members": [
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Full raw document text, including any front matter block.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "Visible row count for the Write tab's textarea.",
+              "attribute": "rows"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Placeholder text shown when the Write tab is empty.",
+              "attribute": "placeholder"
+            },
+            {
+              "kind": "method",
+              "name": "_onInput",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "name": "input",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fires on every keystroke in the Write tab; detail: { value: string }."
+            },
+            {
+              "name": "change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Native change semantics (on blur, if the value changed); detail: { value: string }."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Full raw document text, including any front matter block.",
+              "fieldName": "value"
+            },
+            {
+              "name": "rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "Visible row count for the Write tab's textarea.",
+              "fieldName": "rows"
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Placeholder text shown when the Write tab is empty.",
+              "fieldName": "placeholder"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "markdown-editor",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "MarkdownEditor",
+          "declaration": {
+            "name": "MarkdownEditor",
+            "module": "src/markdown-editor.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "markdown-editor",
+          "declaration": {
+            "name": "MarkdownEditor",
+            "module": "src/markdown-editor.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/markdown-view.ts",
@@ -13231,6 +13451,84 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/status-banner.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Full-width, app-level status bar for a persistent condition — \"Reconnecting…\",\n\"Read-only mode\", \"New version available\". Unlike `toast-notification` (which\nis transient, imperative, and stacks in a corner) this stays put for as long\nas the condition holds, so the consumer controls its presence by rendering it\nor not.\n\nColors mirror `status-pill`: a tinted background with accent-colored text.\nAnnounced to assistive tech via `role=\"status\"` (or `role=\"alert\"` for the\n`danger` variant, matching `toast-notification`'s split).",
+          "name": "StatusBanner",
+          "slots": [
+            {
+              "description": "The message text.",
+              "name": ""
+            },
+            {
+              "description": "Optional trailing controls, e.g. a \"Retry\" button.",
+              "name": "actions"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "StatusBannerVariant"
+              },
+              "default": "\"info\"",
+              "description": "Visual style; also selects the accent color.",
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "icon",
+              "type": {
+                "text": "TemplateResult | null"
+              },
+              "default": "null",
+              "description": "Optional leading icon, pre-rendered by the consumer (e.g. `iconInfo(14)`),\nmatching `nav-item`/`icon-button` — icons are passed in, not named, so the\ncomponent never has to know the icon catalog."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "variant",
+              "type": {
+                "text": "StatusBannerVariant"
+              },
+              "default": "\"info\"",
+              "description": "Visual style; also selects the accent color.",
+              "fieldName": "variant"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "status-banner",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "StatusBanner",
+          "declaration": {
+            "name": "StatusBanner",
+            "module": "src/status-banner.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "status-banner",
+          "declaration": {
+            "name": "StatusBanner",
+            "module": "src/status-banner.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/status-pill.ts",
@@ -13329,38 +13627,358 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/text-area.ts",
+      "path": "src/tab-bar.ts",
       "declarations": [
         {
           "kind": "class",
-          "description": "Plain multi-line text field — a thin, tokenized wrapper around a native\n`<textarea>`, styled to match the other value-entry form fields\n(autocomplete-input, form-select, ...). Not a rich editor; use `readonly`\nto display pre-formatted text (e.g. an error message) that the user can\nstill select and copy, typically paired with `<copy-link-button>`.",
-          "name": "TextArea",
+          "description": "WAI-ARIA tabs pattern (automatic activation, roving tabindex) driving a\nstrip of declarative `tab-item` children. `tab-bar` renders the `role=\"tab\"`\nbutton strip itself, reading `label`/`value`/`selected` off each slotted\n`tab-item`; each `tab-item` owns its own visibility via its reflected\n`selected` attribute.\n\nThe active tab's underline uses `--ui-primary`; a `--ui-border` line spans\nthe full strip beneath every tab, standing in for the inactive state since\nthis design system has no dedicated secondary accent color.",
+          "name": "TabBar",
+          "slots": [
+            {
+              "description": "`tab-item` elements.",
+              "name": ""
+            }
+          ],
           "members": [
             {
               "kind": "field",
-              "name": "value",
+              "name": "label",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Current text content.",
-              "attribute": "value"
+              "description": "Accessible name for the tablist (e.g. \"Editor mode\").",
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "rows",
+              "name": "_tabItems",
               "type": {
-                "text": "number"
+                "text": "TabItem[]"
               },
-              "default": "4",
-              "description": "Visible row count (native `<textarea rows>`).",
-              "attribute": "rows"
+              "privacy": "private",
+              "readonly": true
             },
             {
               "kind": "field",
-              "name": "placeholder",
+              "name": "_version",
               "type": {
-                "text": "string"
+                "text": "number"
+              },
+              "privacy": "private",
+              "default": "0"
+            },
+            {
+              "kind": "field",
+              "name": "_uid",
+              "privacy": "private",
+              "readonly": true,
+              "default": "`tab-bar-${++instanceCount}`"
+            },
+            {
+              "kind": "field",
+              "name": "_observer",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_ensureSelection",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Defaults the first tab-item to selected if none was marked so by the consumer."
+            },
+            {
+              "kind": "method",
+              "name": "_currentIndex",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "number"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_tabButtonId",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_select",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "{ focus?: boolean }"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_focusButton",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_onKeydown",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "event",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "description": "Arrow/Home/End roving-tabindex navigation with automatic activation."
+            }
+          ],
+          "events": [
+            {
+              "name": "change",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "The active tab changed via click or keyboard; detail: `TabChangeDetail`."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible name for the tablist (e.g. \"Editor mode\").",
+              "fieldName": "label"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "tab-bar",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TabBar",
+          "declaration": {
+            "name": "TabBar",
+            "module": "src/tab-bar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tab-bar",
+          "declaration": {
+            "name": "TabBar",
+            "module": "src/tab-bar.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/tab-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "A single labeled panel inside a `tab-bar`. Renders its default slot as an\nARIA `tabpanel`, shown or hidden based on `selected` — `tab-bar` reads\n`label`/`value` to build its tab strip and toggles `selected` on the\nactive panel.",
+          "name": "TabItem",
+          "slots": [
+            {
+              "description": "Panel content, shown only while `selected`.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Text shown in the tab-bar's tab button for this panel.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Stable identifier reported in `tab-bar`'s `change` event; defaults to `label`.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this panel is the active one; `tab-bar` owns this.",
+              "attribute": "selected",
+              "reflects": true
+            }
+          ],
+          "attributes": [
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Text shown in the tab-bar's tab button for this panel.",
+              "fieldName": "label"
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Stable identifier reported in `tab-bar`'s `change` event; defaults to `label`.",
+              "fieldName": "value"
+            },
+            {
+              "name": "selected",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Whether this panel is the active one; `tab-bar` owns this.",
+              "fieldName": "selected"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "tab-item",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "TabItem",
+          "declaration": {
+            "name": "TabItem",
+            "module": "src/tab-item.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "tab-item",
+          "declaration": {
+            "name": "TabItem",
+            "module": "src/tab-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/text-area.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Plain multi-line text field — a thin, tokenized wrapper around a native\n`<textarea>`, styled to match the other value-entry form fields\n(autocomplete-input, form-select, ...). Not a rich editor; use `readonly`\nto display pre-formatted text (e.g. an error message) that the user can\nstill select and copy, typically paired with `<copy-link-button>`.",
+          "name": "TextArea",
+          "members": [
+            {
+              "kind": "field",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Current text content.",
+              "attribute": "value"
+            },
+            {
+              "kind": "field",
+              "name": "rows",
+              "type": {
+                "text": "number"
+              },
+              "default": "4",
+              "description": "Visible row count (native `<textarea rows>`).",
+              "attribute": "rows"
+            },
+            {
+              "kind": "field",
+              "name": "placeholder",
+              "type": {
+                "text": "string"
               },
               "default": "\"\"",
               "description": "Placeholder text shown when empty.",
@@ -15577,6 +16195,66 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/utils/front-matter.ts",
+      "declarations": [
+        {
+          "kind": "function",
+          "name": "parseFrontMatter",
+          "return": {
+            "type": {
+              "text": "FrontMatterResult"
+            }
+          },
+          "parameters": [
+            {
+              "name": "text",
+              "type": {
+                "text": "string"
+              }
+            }
+          ],
+          "description": "Splits a leading `---`-delimited YAML front matter block off a document.\n\nOnly treats the block as front matter if it parses as a non-empty plain\nobject — this avoids misreading a markdown horizontal rule (also `---`) as\nfront matter, and tolerates malformed YAML typed mid-edit by falling back\nto treating the whole document as plain body text."
+        },
+        {
+          "kind": "function",
+          "name": "formatFrontMatterValue",
+          "return": {
+            "type": {
+              "text": "string"
+            }
+          },
+          "parameters": [
+            {
+              "name": "value",
+              "type": {
+                "text": "unknown"
+              }
+            }
+          ],
+          "description": "Stringifies a parsed front matter value for key-value table display."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "parseFrontMatter",
+          "declaration": {
+            "name": "parseFrontMatter",
+            "module": "src/utils/front-matter.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "formatFrontMatterValue",
+          "declaration": {
+            "name": "formatFrontMatterValue",
+            "module": "src/utils/front-matter.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/utils/layer-stack.ts",