@sky.ui/core 0.0.24 → 0.0.26

package/dist/custom-elements.json

@@ -2,238 +2,6 @@
   "schemaVersion": "1.0.0",
   "readme": "",
   "modules": [
-    {
-      "kind": "javascript-module",
-      "path": "src/sky-appbar/sky-appbar.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SkyAppbar",
-          "cssParts": [
-            {
-              "description": "Wrapper that contains the leading slot, title, and actions.",
-              "name": "content"
-            },
-            {
-              "description": "Container for the leading slot (e.g. menu button).",
-              "name": "leading"
-            },
-            {
-              "description": "The title area (contains .title-text with the title string).",
-              "name": "title"
-            },
-            {
-              "description": "The trailing actions container.",
-              "name": "actions"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Leading area (e.g., menu/back button). Defaults to a hamburger icon.",
-              "name": "button"
-            },
-            {
-              "description": "Trailing actions (icons/buttons). This is the default slot.",
-              "name": ""
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
-              "name": "dependencies",
-              "type": {
-                "text": "Record<string, CustomElementConstructor>"
-              },
-              "static": true,
-              "default": "{ \"sky-icon\": SkyIcon, }"
-            },
-            {
-              "kind": "field",
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"App Bar\"",
-              "description": "Title text displayed in the app bar.",
-              "attribute": "title"
-            },
-            {
-              "kind": "field",
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"default\"",
-              "description": "Semantic token or CSS color for bar background; foreground color is derived for contrast.",
-              "attribute": "color"
-            },
-            {
-              "kind": "field",
-              "name": "url",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Background image URL.",
-              "attribute": "url"
-            },
-            {
-              "kind": "field",
-              "name": "banner",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Uses `role=\"banner\"` when true, otherwise `role=\"group\"`.",
-              "attribute": "banner"
-            },
-            {
-              "kind": "field",
-              "name": "dense",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Enables compact vertical spacing.",
-              "attribute": "dense"
-            },
-            {
-              "kind": "field",
-              "name": "elevated",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Applies elevated shadow styling.",
-              "attribute": "elevated"
-            },
-            {
-              "kind": "field",
-              "name": "leadingLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"Open menu\"",
-              "description": "Accessible label for default leading button fallback.",
-              "attribute": "leadingLabel"
-            },
-            {
-              "kind": "method",
-              "name": "_applyColorSurface",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Applies glass vs solid surface tokens from `color`."
-            },
-            {
-              "kind": "method",
-              "name": "_applyBackgroundImage",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "description": "Sets background image CSS variable from `url`."
-            }
-          ],
-          "attributes": [
-            {
-              "name": "title",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"App Bar\"",
-              "description": "Title text displayed in the app bar.",
-              "fieldName": "title"
-            },
-            {
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"default\"",
-              "description": "Semantic token or CSS color for bar background; foreground color is derived for contrast.",
-              "fieldName": "color"
-            },
-            {
-              "name": "url",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Background image URL.",
-              "fieldName": "url"
-            },
-            {
-              "name": "banner",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "true",
-              "description": "Uses `role=\"banner\"` when true, otherwise `role=\"group\"`.",
-              "fieldName": "banner"
-            },
-            {
-              "name": "dense",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Enables compact vertical spacing.",
-              "fieldName": "dense"
-            },
-            {
-              "name": "elevated",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Applies elevated shadow styling.",
-              "fieldName": "elevated"
-            },
-            {
-              "name": "leadingLabel",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"Open menu\"",
-              "description": "Accessible label for default leading button fallback.",
-              "fieldName": "leadingLabel"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "sky-appbar",
-          "customElement": true,
-          "summary": "Application top bar with title, optional leading control, trailing actions, and optional color/image background."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkyAppbar",
-          "declaration": {
-            "name": "SkyAppbar",
-            "module": "src/sky-appbar/sky-appbar.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "sky-appbar",
-          "declaration": {
-            "name": "SkyAppbar",
-            "module": "src/sky-appbar/sky-appbar.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/sky-alert/sky-alert.ts",
@@ -685,135 +453,233 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/sky-avatar/sky-avatar.ts",
+      "path": "src/sky-badge/sky-badge.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "SkyAvatar",
+          "name": "SkyBadge",
           "cssParts": [
             {
-              "description": "The avatar container element.",
-              "name": "avatar"
+              "description": "Wrapper around the slotted content and the badge.",
+              "name": "container"
             },
             {
-              "description": "The loading overlay container (shown when `loading` is true).",
-              "name": "loading-overlay"
+              "description": "The badge element. Use `badgeRef` for positioning (e.g. tooltip anchor).",
+              "name": "badge"
             },
             {
-              "description": "The spinner element shown when loading.",
-              "name": "spinner"
+              "description": "The icon element when `isIcon` is true.",
+              "name": "icon"
             }
           ],
           "slots": [
             {
-              "description": "Fallback content (e.g., initials or an icon) rendered when `image` is empty.",
+              "description": "The content the badge attaches to.",
               "name": ""
+            },
+            {
+              "description": "Optional slot to override the badge content entirely.",
+              "name": "badge"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "size",
+              "name": "dependencies",
+              "type": {
+                "text": "Record<string, CustomElementConstructor>"
+              },
+              "static": true,
+              "default": "{ \"sky-icon\": SkyIcon, }"
+            },
+            {
+              "kind": "field",
+              "name": "statusColor",
               "type": {
                 "text": "string"
               },
-              "default": "\"50px\"",
-              "description": "Avatar size: preset `sm` | `md` | `lg` or CSS length (for example `50px`).",
-              "attribute": "size"
+              "default": "\"success\"",
+              "description": "Badge background token or CSS color.",
+              "attribute": "statusColor",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "image",
+              "name": "textColor",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"default\"",
+              "description": "Text color token or CSS color.",
+              "attribute": "textColor",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "iconColor",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Image URL; fallback slot is shown on load error.",
-              "attribute": "image"
+              "description": "Icon color token or CSS color; falls back to `textColor` when empty.",
+              "attribute": "iconColor",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "fit",
+              "name": "position",
               "type": {
-                "text": "SkyAvatarFit"
+                "text": "SkyBadgePosition"
               },
-              "default": "\"cover\"",
-              "description": "Image fill mode: `cover` (default) or `contain`.",
-              "attribute": "fit",
+              "default": "\"default\"",
+              "description": "Layout mode: `default | floating | inline`.",
+              "attribute": "position",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "radius",
+              "name": "value",
               "type": {
                 "text": "string"
               },
-              "default": "\"md\"",
-              "description": "Border radius token or CSS value.",
-              "attribute": "radius"
+              "default": "\"\"",
+              "description": "Badge text/count or icon name in icon mode.",
+              "attribute": "value"
             },
             {
               "kind": "field",
-              "name": "alt",
+              "name": "isIcon",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Renders icon mode when true.",
+              "attribute": "isIcon",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "size",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Accessible name when image content conveys meaning.",
-              "attribute": "alt"
+              "description": "Badge and icon size CSS length.",
+              "attribute": "size",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "color",
+              "name": "shape",
               "type": {
-                "text": "string"
+                "text": "SkyBadgeShape"
               },
-              "default": "\"dark\"",
-              "description": "Token or CSS color applied to fallback slot content.",
-              "attribute": "color"
+              "default": "\"custom\"",
+              "description": "Badge shape: `circle | pill | custom`.",
+              "attribute": "shape",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "outline",
+              "name": "max",
+              "type": {
+                "text": "number"
+              },
+              "default": "99",
+              "description": "Maximum numeric count before rendering overflow label.",
+              "attribute": "max"
+            },
+            {
+              "kind": "field",
+              "name": "hideWhenZero",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides badge when value resolves to numeric zero.",
+              "attribute": "hideWhenZero"
+            },
+            {
+              "kind": "field",
+              "name": "show",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Forces badge visibility independent of value.",
+              "attribute": "show",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "offsetX",
               "type": {
                 "text": "string"
               },
-              "default": "\"\"",
-              "description": "CSS `outline` value.",
-              "attribute": "outline"
+              "default": "\"0px\"",
+              "description": "Horizontal offset CSS length.",
+              "attribute": "offsetX"
             },
             {
               "kind": "field",
-              "name": "outlineOffset",
+              "name": "offsetY",
               "type": {
                 "text": "string"
               },
-              "default": "\"2px\"",
-              "description": "CSS `outline-offset` value.",
-              "attribute": "outlineOffset"
+              "default": "\"0px\"",
+              "description": "Vertical offset CSS length.",
+              "attribute": "offsetY"
             },
             {
               "kind": "field",
-              "name": "loading",
+              "name": "ring",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Shows loading overlay when true.",
-              "attribute": "loading",
-              "reflects": true
+              "description": "Enables visual ring around the badge.",
+              "attribute": "ring"
             },
             {
               "kind": "field",
-              "name": "disabled",
+              "name": "ringColor",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"primary\"",
+              "description": "Ring color token or CSS color.",
+              "attribute": "ringColor"
+            },
+            {
+              "kind": "field",
+              "name": "ringOffset",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"1px\"",
+              "description": "Ring offset CSS length.",
+              "attribute": "ringOffset"
+            },
+            {
+              "kind": "field",
+              "name": "badgeLabel",
+              "type": {
+                "text": "string | null"
+              },
+              "default": "null",
+              "description": "ARIA label override.",
+              "attribute": "badgeLabel"
+            },
+            {
+              "kind": "field",
+              "name": "badgeAriaHidden",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Dims and disables pointer interactions.",
-              "attribute": "disabled",
-              "reflects": true
+              "description": "Hides badge from assistive technology when true.",
+              "attribute": "badgeAriaHidden"
             },
             {
               "kind": "field",
@@ -822,787 +688,689 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Enables interactive behavior with keyboard/click activation.",
+              "description": "Enables focus/activation and `badge-click` emission.",
               "attribute": "interactive"
             },
             {
               "kind": "field",
-              "name": "shadow",
+              "name": "placement",
               "type": {
-                "text": "boolean"
+                "text": "SkyBadgePlacement"
               },
-              "default": "false",
-              "description": "When true, applies solid surface, border ring, and elevation; no backdrop blur.",
-              "attribute": "shadow",
+              "default": "\"custom\"",
+              "description": "Anchor placement preset for badge positioning.",
+              "attribute": "placement",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_imageError",
+              "name": "_badgeEl",
               "type": {
-                "text": "boolean"
+                "text": "HTMLSpanElement"
               },
-              "privacy": "private",
-              "default": "false",
-              "description": "True when image failed to load; show slot instead."
+              "privacy": "private"
             },
             {
               "kind": "field",
-              "name": "_onImageLoad",
-              "privacy": "private",
-              "description": "Marks image load success and keeps image rendering active."
+              "name": "badgeRef",
+              "privacy": "public",
+              "description": "Ref for the badge element (e.g. for tooltip anchor or positioning)."
             },
             {
               "kind": "field",
-              "name": "_onImageError",
-              "privacy": "private",
-              "description": "Marks image load failure and enables fallback slot rendering."
+              "name": "shadowRootOptions",
+              "type": {
+                "text": "ShadowRootInit"
+              },
+              "static": true,
+              "default": "{ mode: \"open\", delegatesFocus: true, }"
             },
             {
               "kind": "method",
-              "name": "_handleInteractiveClick",
-              "privacy": "private",
+              "name": "showBadge",
+              "privacy": "public",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "Event"
-                  }
-                }
-              ],
-              "description": "Re-dispatches click in interactive mode for host-level consumers."
+              "description": "Forces badge visibility on."
             },
             {
               "kind": "method",
-              "name": "_handleInteractiveKeydown",
-              "privacy": "private",
+              "name": "hideBadge",
+              "privacy": "public",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "parameters": [
-                {
-                  "name": "e",
-                  "type": {
-                    "text": "KeyboardEvent"
-                  }
-                }
-              ],
-              "description": "Handles keyboard activation in interactive mode."
+              "description": "Forces badge visibility off."
             },
             {
               "kind": "method",
-              "name": "adjustSpinnerSize",
-              "privacy": "private",
+              "name": "setValue",
+              "privacy": "public",
               "return": {
                 "type": {
                   "text": "void"
                 }
               },
-              "description": "Derives spinner dimensions from current avatar size."
-            }
-          ],
-          "events": [
+              "parameters": [
+                {
+                  "name": "value",
+                  "type": {
+                    "text": "string"
+                  },
+                  "description": "Badge value or icon name."
+                }
+              ],
+              "description": "Updates badge value for text/count or icon modes."
+            },
             {
-              "name": "click",
-              "type": {
-                "text": "Event"
-              }
-            }
-          ],
-          "attributes": [
-            {
-              "name": "size",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"50px\"",
-              "description": "Avatar size: preset `sm` | `md` | `lg` or CSS length (for example `50px`).",
-              "fieldName": "size"
-            },
-            {
-              "name": "image",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Image URL; fallback slot is shown on load error.",
-              "fieldName": "image"
-            },
-            {
-              "name": "fit",
-              "type": {
-                "text": "SkyAvatarFit"
-              },
-              "default": "\"cover\"",
-              "description": "Image fill mode: `cover` (default) or `contain`.",
-              "fieldName": "fit"
-            },
-            {
-              "name": "radius",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"md\"",
-              "description": "Border radius token or CSS value.",
-              "fieldName": "radius"
-            },
-            {
-              "name": "alt",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Accessible name when image content conveys meaning.",
-              "fieldName": "alt"
-            },
-            {
-              "name": "color",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"dark\"",
-              "description": "Token or CSS color applied to fallback slot content.",
-              "fieldName": "color"
-            },
-            {
-              "name": "outline",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "CSS `outline` value.",
-              "fieldName": "outline"
-            },
-            {
-              "name": "outlineOffset",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"2px\"",
-              "description": "CSS `outline-offset` value.",
-              "fieldName": "outlineOffset"
+              "kind": "field",
+              "name": "_onActivate",
+              "privacy": "private",
+              "description": "Emits `badge-click` for interactive activation."
             },
             {
-              "name": "loading",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Shows loading overlay when true.",
-              "fieldName": "loading"
+              "kind": "field",
+              "name": "_onKeydown",
+              "privacy": "private",
+              "description": "Handles keyboard activation with Enter and Space."
             },
             {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "_computeAriaLabel",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
               },
-              "default": "false",
-              "description": "Dims and disables pointer interactions.",
-              "fieldName": "disabled"
+              "parameters": [
+                {
+                  "name": "displayValue",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ],
+              "description": "Computes accessible badge label from current render state."
             },
             {
-              "name": "interactive",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "_computeAnchors",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{\r\n    top: string;\r\n    right: string;\r\n    bottom: string;\r\n    left: string;\r\n  }"
+                }
               },
-              "default": "false",
-              "description": "Enables interactive behavior with keyboard/click activation.",
-              "fieldName": "interactive"
+              "parameters": [
+                {
+                  "name": "placement",
+                  "type": {
+                    "text": "SkyBadgePlacement"
+                  }
+                }
+              ],
+              "description": "Resolves anchor edges from placement preset."
             },
             {
-              "name": "shadow",
-              "type": {
-                "text": "boolean"
+              "kind": "method",
+              "name": "_resolveBadgeSurface",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "{\r\n    bg: string;\r\n    color: string;\r\n    border: string;\r\n  }"
+                }
               },
-              "default": "false",
-              "description": "When true, applies solid surface, border ring, and elevation; no backdrop blur.",
-              "fieldName": "shadow"
-            }
-          ],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "sky-avatar",
-          "customElement": true,
-          "summary": "Avatar that renders image content or fallback slot content with configurable size, radius, outline, and loading state."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkyAvatar",
-          "declaration": {
-            "name": "SkyAvatar",
-            "module": "src/sky-avatar/sky-avatar.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "sky-avatar",
-          "declaration": {
-            "name": "SkyAvatar",
-            "module": "src/sky-avatar/sky-avatar.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/sky-badge/sky-badge.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SkyBadge",
-          "cssParts": [
-            {
-              "description": "Wrapper around the slotted content and the badge.",
-              "name": "container"
-            },
-            {
-              "description": "The badge element. Use `badgeRef` for positioning (e.g. tooltip anchor).",
-              "name": "badge"
-            },
-            {
-              "description": "The icon element when `isIcon` is true.",
-              "name": "icon"
-            }
-          ],
-          "slots": [
-            {
-              "description": "The content the badge attaches to.",
-              "name": ""
-            },
-            {
-              "description": "Optional slot to override the badge content entirely.",
-              "name": "badge"
+              "description": "Maps semantic status tokens to soft badge surface colors."
             }
           ],
-          "members": [
+          "events": [
             {
-              "kind": "field",
-              "name": "dependencies",
               "type": {
-                "text": "Record<string, CustomElementConstructor>"
+                "text": "CustomEvent<SkyBadgeClickEventDetail>"
               },
-              "static": true,
-              "default": "{ \"sky-icon\": SkyIcon, }"
-            },
+              "description": "Emitted when badge activation occurs via click, Enter, or Space while `interactive` is true.",
+              "name": "badge-click"
+            }
+          ],
+          "attributes": [
             {
-              "kind": "field",
               "name": "statusColor",
               "type": {
                 "text": "string"
               },
               "default": "\"success\"",
               "description": "Badge background token or CSS color.",
-              "attribute": "statusColor",
-              "reflects": true
+              "fieldName": "statusColor"
             },
             {
-              "kind": "field",
               "name": "textColor",
               "type": {
                 "text": "string"
               },
               "default": "\"default\"",
               "description": "Text color token or CSS color.",
-              "attribute": "textColor",
-              "reflects": true
+              "fieldName": "textColor"
             },
             {
-              "kind": "field",
               "name": "iconColor",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
               "description": "Icon color token or CSS color; falls back to `textColor` when empty.",
-              "attribute": "iconColor",
-              "reflects": true
+              "fieldName": "iconColor"
             },
             {
-              "kind": "field",
               "name": "position",
               "type": {
                 "text": "SkyBadgePosition"
               },
               "default": "\"default\"",
               "description": "Layout mode: `default | floating | inline`.",
-              "attribute": "position",
-              "reflects": true
+              "fieldName": "position"
             },
             {
-              "kind": "field",
               "name": "value",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
               "description": "Badge text/count or icon name in icon mode.",
-              "attribute": "value"
+              "fieldName": "value"
             },
             {
-              "kind": "field",
               "name": "isIcon",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Renders icon mode when true.",
-              "attribute": "isIcon",
-              "reflects": true
+              "fieldName": "isIcon"
             },
             {
-              "kind": "field",
               "name": "size",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
               "description": "Badge and icon size CSS length.",
-              "attribute": "size",
-              "reflects": true
+              "fieldName": "size"
             },
             {
-              "kind": "field",
               "name": "shape",
               "type": {
                 "text": "SkyBadgeShape"
               },
               "default": "\"custom\"",
               "description": "Badge shape: `circle | pill | custom`.",
-              "attribute": "shape",
-              "reflects": true
+              "fieldName": "shape"
             },
             {
-              "kind": "field",
               "name": "max",
               "type": {
                 "text": "number"
               },
               "default": "99",
               "description": "Maximum numeric count before rendering overflow label.",
-              "attribute": "max"
+              "fieldName": "max"
             },
             {
-              "kind": "field",
               "name": "hideWhenZero",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Hides badge when value resolves to numeric zero.",
-              "attribute": "hideWhenZero"
+              "fieldName": "hideWhenZero"
             },
             {
-              "kind": "field",
               "name": "show",
               "type": {
                 "text": "boolean"
               },
               "default": "true",
               "description": "Forces badge visibility independent of value.",
-              "attribute": "show",
-              "reflects": true
+              "fieldName": "show"
             },
             {
-              "kind": "field",
               "name": "offsetX",
               "type": {
                 "text": "string"
               },
               "default": "\"0px\"",
               "description": "Horizontal offset CSS length.",
-              "attribute": "offsetX"
+              "fieldName": "offsetX"
             },
             {
-              "kind": "field",
               "name": "offsetY",
               "type": {
                 "text": "string"
               },
               "default": "\"0px\"",
               "description": "Vertical offset CSS length.",
-              "attribute": "offsetY"
+              "fieldName": "offsetY"
             },
             {
-              "kind": "field",
               "name": "ring",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Enables visual ring around the badge.",
-              "attribute": "ring"
+              "fieldName": "ring"
             },
             {
-              "kind": "field",
               "name": "ringColor",
               "type": {
                 "text": "string"
               },
               "default": "\"primary\"",
               "description": "Ring color token or CSS color.",
-              "attribute": "ringColor"
+              "fieldName": "ringColor"
             },
             {
-              "kind": "field",
               "name": "ringOffset",
               "type": {
                 "text": "string"
               },
               "default": "\"1px\"",
               "description": "Ring offset CSS length.",
-              "attribute": "ringOffset"
+              "fieldName": "ringOffset"
             },
             {
-              "kind": "field",
               "name": "badgeLabel",
               "type": {
                 "text": "string | null"
               },
               "default": "null",
               "description": "ARIA label override.",
-              "attribute": "badgeLabel"
+              "fieldName": "badgeLabel"
             },
             {
-              "kind": "field",
               "name": "badgeAriaHidden",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Hides badge from assistive technology when true.",
-              "attribute": "badgeAriaHidden"
+              "fieldName": "badgeAriaHidden"
             },
             {
-              "kind": "field",
               "name": "interactive",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Enables focus/activation and `badge-click` emission.",
-              "attribute": "interactive"
+              "fieldName": "interactive"
             },
             {
-              "kind": "field",
               "name": "placement",
               "type": {
                 "text": "SkyBadgePlacement"
               },
               "default": "\"custom\"",
               "description": "Anchor placement preset for badge positioning.",
-              "attribute": "placement",
+              "fieldName": "placement"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "sky-badge",
+          "customElement": true,
+          "summary": "Badge for status dots, counts, or icons anchored to slotted content."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkyBadge",
+          "declaration": {
+            "name": "SkyBadge",
+            "module": "src/sky-badge/sky-badge.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "sky-badge",
+          "declaration": {
+            "name": "SkyBadge",
+            "module": "src/sky-badge/sky-badge.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/sky-avatar/sky-avatar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SkyAvatar",
+          "cssParts": [
+            {
+              "description": "The avatar container element.",
+              "name": "avatar"
+            },
+            {
+              "description": "The loading overlay container (shown when `loading` is true).",
+              "name": "loading-overlay"
+            },
+            {
+              "description": "The spinner element shown when loading.",
+              "name": "spinner"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Fallback content (e.g., initials or an icon) rendered when `image` is empty.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"50px\"",
+              "description": "Avatar size: preset `sm` | `md` | `lg` or CSS length (for example `50px`).",
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "image",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Image URL; fallback slot is shown on load error.",
+              "attribute": "image"
+            },
+            {
+              "kind": "field",
+              "name": "fit",
+              "type": {
+                "text": "SkyAvatarFit"
+              },
+              "default": "\"cover\"",
+              "description": "Image fill mode: `cover` (default) or `contain`.",
+              "attribute": "fit",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_badgeEl",
+              "name": "radius",
               "type": {
-                "text": "HTMLSpanElement"
+                "text": "string"
               },
-              "privacy": "private"
+              "default": "\"md\"",
+              "description": "Border radius token or CSS value.",
+              "attribute": "radius"
             },
             {
               "kind": "field",
-              "name": "badgeRef",
-              "privacy": "public",
-              "description": "Ref for the badge element (e.g. for tooltip anchor or positioning)."
+              "name": "alt",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Accessible name when image content conveys meaning.",
+              "attribute": "alt"
             },
             {
               "kind": "field",
-              "name": "shadowRootOptions",
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"dark\"",
+              "description": "Token or CSS color applied to fallback slot content.",
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "outline",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "CSS `outline` value.",
+              "attribute": "outline"
+            },
+            {
+              "kind": "field",
+              "name": "outlineOffset",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"2px\"",
+              "description": "CSS `outline-offset` value.",
+              "attribute": "outlineOffset"
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows loading overlay when true.",
+              "attribute": "loading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
               "type": {
-                "text": "ShadowRootInit"
+                "text": "boolean"
               },
-              "static": true,
-              "default": "{ mode: \"open\", delegatesFocus: true, }"
+              "default": "false",
+              "description": "Dims and disables pointer interactions.",
+              "attribute": "disabled",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "showBadge",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "interactive",
+              "type": {
+                "text": "boolean"
               },
-              "description": "Forces badge visibility on."
+              "default": "false",
+              "description": "Enables interactive behavior with keyboard/click activation.",
+              "attribute": "interactive"
             },
             {
-              "kind": "method",
-              "name": "hideBadge",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "shadow",
+              "type": {
+                "text": "boolean"
               },
-              "description": "Forces badge visibility off."
+              "default": "false",
+              "description": "When true, applies solid surface, border ring, and elevation; no backdrop blur.",
+              "attribute": "shadow",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "setValue",
-              "privacy": "public",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
+              "kind": "field",
+              "name": "_imageError",
+              "type": {
+                "text": "boolean"
               },
-              "parameters": [
-                {
-                  "name": "value",
-                  "type": {
-                    "text": "string"
-                  },
-                  "description": "Badge value or icon name."
-                }
-              ],
-              "description": "Updates badge value for text/count or icon modes."
+              "privacy": "private",
+              "default": "false",
+              "description": "True when image failed to load; show slot instead."
             },
             {
               "kind": "field",
-              "name": "_onActivate",
+              "name": "_onImageLoad",
               "privacy": "private",
-              "description": "Emits `badge-click` for interactive activation."
+              "description": "Marks image load success and keeps image rendering active."
             },
             {
               "kind": "field",
-              "name": "_onKeydown",
+              "name": "_onImageError",
               "privacy": "private",
-              "description": "Handles keyboard activation with Enter and Space."
+              "description": "Marks image load failure and enables fallback slot rendering."
             },
             {
               "kind": "method",
-              "name": "_computeAriaLabel",
+              "name": "_handleInteractiveClick",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "string | null"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "displayValue",
+                  "name": "e",
                   "type": {
-                    "text": "string | null"
+                    "text": "Event"
                   }
                 }
               ],
-              "description": "Computes accessible badge label from current render state."
+              "description": "Re-dispatches click in interactive mode for host-level consumers."
             },
             {
               "kind": "method",
-              "name": "_computeAnchors",
+              "name": "_handleInteractiveKeydown",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "{\r\n    top: string;\r\n    right: string;\r\n    bottom: string;\r\n    left: string;\r\n  }"
+                  "text": "void"
                 }
               },
               "parameters": [
                 {
-                  "name": "placement",
+                  "name": "e",
                   "type": {
-                    "text": "SkyBadgePlacement"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "description": "Resolves anchor edges from placement preset."
+              "description": "Handles keyboard activation in interactive mode."
             },
             {
               "kind": "method",
-              "name": "_resolveBadgeSurface",
+              "name": "adjustSpinnerSize",
               "privacy": "private",
               "return": {
                 "type": {
-                  "text": "{\r\n    bg: string;\r\n    color: string;\r\n    border: string;\r\n  }"
+                  "text": "void"
                 }
               },
-              "description": "Maps semantic status tokens to soft badge surface colors."
+              "description": "Derives spinner dimensions from current avatar size."
             }
           ],
           "events": [
             {
+              "name": "click",
               "type": {
-                "text": "CustomEvent<SkyBadgeClickEventDetail>"
-              },
-              "description": "Emitted when badge activation occurs via click, Enter, or Space while `interactive` is true.",
-              "name": "badge-click"
+                "text": "Event"
+              }
             }
           ],
           "attributes": [
             {
-              "name": "statusColor",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"success\"",
-              "description": "Badge background token or CSS color.",
-              "fieldName": "statusColor"
-            },
-            {
-              "name": "textColor",
+              "name": "size",
               "type": {
                 "text": "string"
               },
-              "default": "\"default\"",
-              "description": "Text color token or CSS color.",
-              "fieldName": "textColor"
+              "default": "\"50px\"",
+              "description": "Avatar size: preset `sm` | `md` | `lg` or CSS length (for example `50px`).",
+              "fieldName": "size"
             },
             {
-              "name": "iconColor",
+              "name": "image",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Icon color token or CSS color; falls back to `textColor` when empty.",
-              "fieldName": "iconColor"
+              "description": "Image URL; fallback slot is shown on load error.",
+              "fieldName": "image"
             },
             {
-              "name": "position",
+              "name": "fit",
               "type": {
-                "text": "SkyBadgePosition"
+                "text": "SkyAvatarFit"
               },
-              "default": "\"default\"",
-              "description": "Layout mode: `default | floating | inline`.",
-              "fieldName": "position"
+              "default": "\"cover\"",
+              "description": "Image fill mode: `cover` (default) or `contain`.",
+              "fieldName": "fit"
             },
             {
-              "name": "value",
+              "name": "radius",
               "type": {
                 "text": "string"
               },
-              "default": "\"\"",
-              "description": "Badge text/count or icon name in icon mode.",
-              "fieldName": "value"
-            },
-            {
-              "name": "isIcon",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Renders icon mode when true.",
-              "fieldName": "isIcon"
+              "default": "\"md\"",
+              "description": "Border radius token or CSS value.",
+              "fieldName": "radius"
             },
             {
-              "name": "size",
+              "name": "alt",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "Badge and icon size CSS length.",
-              "fieldName": "size"
-            },
-            {
-              "name": "shape",
-              "type": {
-                "text": "SkyBadgeShape"
-              },
-              "default": "\"custom\"",
-              "description": "Badge shape: `circle | pill | custom`.",
-              "fieldName": "shape"
-            },
-            {
-              "name": "max",
-              "type": {
-                "text": "number"
-              },
-              "default": "99",
-              "description": "Maximum numeric count before rendering overflow label.",
-              "fieldName": "max"
-            },
-            {
-              "name": "hideWhenZero",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Hides badge when value resolves to numeric zero.",
-              "fieldName": "hideWhenZero"
+              "description": "Accessible name when image content conveys meaning.",
+              "fieldName": "alt"
             },
             {
-              "name": "show",
+              "name": "color",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "true",
-              "description": "Forces badge visibility independent of value.",
-              "fieldName": "show"
+              "default": "\"dark\"",
+              "description": "Token or CSS color applied to fallback slot content.",
+              "fieldName": "color"
             },
             {
-              "name": "offsetX",
+              "name": "outline",
               "type": {
                 "text": "string"
               },
-              "default": "\"0px\"",
-              "description": "Horizontal offset CSS length.",
-              "fieldName": "offsetX"
+              "default": "\"\"",
+              "description": "CSS `outline` value.",
+              "fieldName": "outline"
             },
             {
-              "name": "offsetY",
+              "name": "outlineOffset",
               "type": {
                 "text": "string"
               },
-              "default": "\"0px\"",
-              "description": "Vertical offset CSS length.",
-              "fieldName": "offsetY"
+              "default": "\"2px\"",
+              "description": "CSS `outline-offset` value.",
+              "fieldName": "outlineOffset"
             },
             {
-              "name": "ring",
+              "name": "loading",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Enables visual ring around the badge.",
-              "fieldName": "ring"
-            },
-            {
-              "name": "ringColor",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"primary\"",
-              "description": "Ring color token or CSS color.",
-              "fieldName": "ringColor"
-            },
-            {
-              "name": "ringOffset",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"1px\"",
-              "description": "Ring offset CSS length.",
-              "fieldName": "ringOffset"
-            },
-            {
-              "name": "badgeLabel",
-              "type": {
-                "text": "string | null"
-              },
-              "default": "null",
-              "description": "ARIA label override.",
-              "fieldName": "badgeLabel"
+              "description": "Shows loading overlay when true.",
+              "fieldName": "loading"
             },
             {
-              "name": "badgeAriaHidden",
+              "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Hides badge from assistive technology when true.",
-              "fieldName": "badgeAriaHidden"
+              "description": "Dims and disables pointer interactions.",
+              "fieldName": "disabled"
             },
             {
               "name": "interactive",
@@ -1610,43 +1378,43 @@
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Enables focus/activation and `badge-click` emission.",
+              "description": "Enables interactive behavior with keyboard/click activation.",
               "fieldName": "interactive"
             },
             {
-              "name": "placement",
+              "name": "shadow",
               "type": {
-                "text": "SkyBadgePlacement"
+                "text": "boolean"
               },
-              "default": "\"custom\"",
-              "description": "Anchor placement preset for badge positioning.",
-              "fieldName": "placement"
+              "default": "false",
+              "description": "When true, applies solid surface, border ring, and elevation; no backdrop blur.",
+              "fieldName": "shadow"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "sky-badge",
+          "tagName": "sky-avatar",
           "customElement": true,
-          "summary": "Badge for status dots, counts, or icons anchored to slotted content."
+          "summary": "Avatar that renders image content or fallback slot content with configurable size, radius, outline, and loading state."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkyBadge",
+          "name": "SkyAvatar",
           "declaration": {
-            "name": "SkyBadge",
-            "module": "src/sky-badge/sky-badge.ts"
+            "name": "SkyAvatar",
+            "module": "src/sky-avatar/sky-avatar.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "sky-badge",
+          "name": "sky-avatar",
           "declaration": {
-            "name": "SkyBadge",
-            "module": "src/sky-badge/sky-badge.ts"
+            "name": "SkyAvatar",
+            "module": "src/sky-avatar/sky-avatar.ts"
           }
         }
       ]
@@ -3739,8 +3507,240 @@
           "kind": "custom-element-definition",
           "name": "sky-checkbox",
           "declaration": {
-            "name": "SkyCheckbox",
-            "module": "src/sky-checkbox/sky-checkbox.ts"
+            "name": "SkyCheckbox",
+            "module": "src/sky-checkbox/sky-checkbox.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/sky-appbar/sky-appbar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SkyAppbar",
+          "cssParts": [
+            {
+              "description": "Wrapper that contains the leading slot, title, and actions.",
+              "name": "content"
+            },
+            {
+              "description": "Container for the leading slot (e.g. menu button).",
+              "name": "leading"
+            },
+            {
+              "description": "The title area (contains .title-text with the title string).",
+              "name": "title"
+            },
+            {
+              "description": "The trailing actions container.",
+              "name": "actions"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Leading area (e.g., menu/back button). Defaults to a hamburger icon.",
+              "name": "button"
+            },
+            {
+              "description": "Trailing actions (icons/buttons). This is the default slot.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "Record<string, CustomElementConstructor>"
+              },
+              "static": true,
+              "default": "{ \"sky-icon\": SkyIcon, }"
+            },
+            {
+              "kind": "field",
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"App Bar\"",
+              "description": "Title text displayed in the app bar.",
+              "attribute": "title"
+            },
+            {
+              "kind": "field",
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"default\"",
+              "description": "Semantic token or CSS color for bar background; foreground color is derived for contrast.",
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "url",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Background image URL.",
+              "attribute": "url"
+            },
+            {
+              "kind": "field",
+              "name": "banner",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Uses `role=\"banner\"` when true, otherwise `role=\"group\"`.",
+              "attribute": "banner"
+            },
+            {
+              "kind": "field",
+              "name": "dense",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables compact vertical spacing.",
+              "attribute": "dense"
+            },
+            {
+              "kind": "field",
+              "name": "elevated",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Applies elevated shadow styling.",
+              "attribute": "elevated"
+            },
+            {
+              "kind": "field",
+              "name": "leadingLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Open menu\"",
+              "description": "Accessible label for default leading button fallback.",
+              "attribute": "leadingLabel"
+            },
+            {
+              "kind": "method",
+              "name": "_applyColorSurface",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Applies glass vs solid surface tokens from `color`."
+            },
+            {
+              "kind": "method",
+              "name": "_applyBackgroundImage",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Sets background image CSS variable from `url`."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "title",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"App Bar\"",
+              "description": "Title text displayed in the app bar.",
+              "fieldName": "title"
+            },
+            {
+              "name": "color",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"default\"",
+              "description": "Semantic token or CSS color for bar background; foreground color is derived for contrast.",
+              "fieldName": "color"
+            },
+            {
+              "name": "url",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Background image URL.",
+              "fieldName": "url"
+            },
+            {
+              "name": "banner",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "true",
+              "description": "Uses `role=\"banner\"` when true, otherwise `role=\"group\"`.",
+              "fieldName": "banner"
+            },
+            {
+              "name": "dense",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Enables compact vertical spacing.",
+              "fieldName": "dense"
+            },
+            {
+              "name": "elevated",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Applies elevated shadow styling.",
+              "fieldName": "elevated"
+            },
+            {
+              "name": "leadingLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"Open menu\"",
+              "description": "Accessible label for default leading button fallback.",
+              "fieldName": "leadingLabel"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "sky-appbar",
+          "customElement": true,
+          "summary": "Application top bar with title, optional leading control, trailing actions, and optional color/image background."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkyAppbar",
+          "declaration": {
+            "name": "SkyAppbar",
+            "module": "src/sky-appbar/sky-appbar.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "sky-appbar",
+          "declaration": {
+            "name": "SkyAppbar",
+            "module": "src/sky-appbar/sky-appbar.ts"
           }
         }
       ]
@@ -6769,551 +6769,551 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/sky-flexbox/sky-flexbox.ts",
+      "path": "src/sky-divider/sky-divider.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "SkyFlexbox",
-          "cssParts": [
-            {
-              "description": "The flex container element.",
-              "name": "container"
-            }
-          ],
-          "slots": [
-            {
-              "description": "Default slot for flex items (`<sky-flexcol>` or plain elements with `span` attributes).",
-              "name": ""
-            }
-          ],
-          "members": [
+          "name": "SkyDivider",
+          "cssProperties": [
             {
-              "kind": "field",
-              "name": "direction",
-              "type": {
-                "text": "SkyFlexboxDirection"
-              },
-              "default": "\"row\"",
-              "description": "Flex direction.",
-              "privacy": "public",
-              "attribute": "direction"
+              "description": "CSS custom property for divider color.",
+              "name": "--divider-color"
             },
             {
-              "kind": "field",
-              "name": "wrap",
-              "type": {
-                "text": "SkyFlexboxWrap"
-              },
-              "default": "\"wrap\"",
-              "description": "Flex wrap behavior.",
-              "privacy": "public",
-              "attribute": "wrap"
+              "description": "CSS custom property for divider thickness.",
+              "name": "--divider-thickness"
             },
             {
-              "kind": "field",
-              "name": "justify",
-              "type": {
-                "text": "SkyFlexboxJustify"
-              },
-              "default": "\"flex-start\"",
-              "description": "Main-axis alignment.",
-              "privacy": "public",
-              "attribute": "justify"
+              "description": "CSS custom property for divider margin.",
+              "name": "--divider-margin"
             },
             {
-              "kind": "field",
-              "name": "align",
-              "type": {
-                "text": "SkyFlexboxAlign"
-              },
-              "default": "\"stretch\"",
-              "description": "Cross-axis alignment.",
-              "privacy": "public",
-              "attribute": "align"
-            },
+              "description": "CSS custom property for vertical divider height.",
+              "name": "--divider-height"
+            }
+          ],
+          "cssParts": [
             {
-              "kind": "field",
-              "name": "alignContent",
-              "type": {
-                "text": "SkyFlexboxAlignContent"
-              },
-              "default": "\"normal\"",
-              "description": "Multi-line cross-axis distribution.",
-              "privacy": "public",
-              "attribute": "alignContent"
-            },
+              "description": "The divider line element (either `<hr>` or `<div>` depending on direction).",
+              "name": "divider"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "gap",
+              "name": "color",
               "type": {
                 "text": "string"
               },
-              "default": "\"16px\"",
-              "description": "Shared row/column gap value.",
+              "default": "\"muted\"",
+              "description": "Divider color token or CSS color.",
               "privacy": "public",
-              "attribute": "gap"
+              "attribute": "color"
             },
             {
               "kind": "field",
-              "name": "gapX",
+              "name": "thickness",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "Horizontal gap override.",
+              "default": "\"1px\"",
+              "description": "Divider thickness (for example `1px` or `2px`).",
               "privacy": "public",
-              "attribute": "gapX"
+              "attribute": "thickness"
             },
             {
               "kind": "field",
-              "name": "gapY",
+              "name": "margin",
               "type": {
-                "text": "string | undefined"
+                "text": "string"
               },
-              "description": "Vertical gap override.",
+              "default": "\"\"",
+              "description": "Outer margin around the divider.",
               "privacy": "public",
-              "attribute": "gapY"
+              "attribute": "margin"
             },
             {
               "kind": "field",
-              "name": "col",
+              "name": "direction",
               "type": {
-                "text": "number"
+                "text": "SkyDividerDirection"
               },
-              "default": "12",
-              "description": "Total column count used for span calculations.",
+              "default": "\"horizontal\"",
+              "description": "Divider orientation.",
               "privacy": "public",
-              "attribute": "col"
+              "attribute": "direction"
             },
             {
               "kind": "field",
-              "name": "_childMo",
+              "name": "inset",
               "type": {
-                "text": "MutationObserver | undefined"
+                "text": "boolean"
               },
-              "privacy": "private"
-            },
-            {
-              "kind": "method",
-              "name": "syncVars",
-              "privacy": "private",
-              "description": "Syncs component properties to CSS custom properties."
-            },
-            {
-              "kind": "method",
-              "name": "recalculateSpans",
+              "default": "false",
+              "description": "Enables indented divider layout.",
               "privacy": "public",
-              "description": "Forces recalculation of spans for all child elements.\r\nUseful when dynamically adding/removing items."
+              "attribute": "inset"
             },
             {
               "kind": "field",
-              "name": "updateSpans",
-              "privacy": "private",
-              "description": "Reads span attributes off slotted children and maps them to CSS vars:\r\nspan, span-lg, span-md, span-sm, span-xs"
-            },
-            {
-              "kind": "method",
-              "name": "readSpanRaw",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "string | null"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "el",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                },
-                {
-                  "name": "attrName",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "propName",
-                  "type": {
-                    "text": "string"
-                  }
-                }
-              ],
-              "description": "Reads a span value from an HTML attribute or element property."
-            },
-            {
-              "kind": "method",
-              "name": "applySpanVar",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "void"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "el",
-                  "type": {
-                    "text": "HTMLElement"
-                  }
-                },
-                {
-                  "name": "cssVar",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "raw",
-                  "type": {
-                    "text": "string | null"
-                  }
-                }
-              ],
-              "description": "Sets or clears a span CSS variable on a slotted child."
-            },
-            {
-              "kind": "method",
-              "name": "clampSpan",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": ""
-                }
-              },
-              "parameters": [
-                {
-                  "name": "raw",
-                  "type": {
-                    "text": "string | null"
-                  },
-                  "description": "Raw span value from attribute"
-                }
-              ],
-              "description": "Clamps span value to valid range (1 to column count)."
-            }
-          ],
-          "events": [
-            {
-              "type": {
-                "text": "Event"
-              },
-              "description": "Fired when slotted children change.",
-              "name": "slotchange"
-            }
-          ],
-          "attributes": [
-            {
-              "name": "direction",
-              "type": {
-                "text": "SkyFlexboxDirection"
-              },
-              "default": "\"row\"",
-              "description": "Flex direction.",
-              "fieldName": "direction"
-            },
-            {
-              "name": "wrap",
+              "name": "height",
               "type": {
-                "text": "SkyFlexboxWrap"
+                "text": "string"
               },
-              "default": "\"wrap\"",
-              "description": "Flex wrap behavior.",
-              "fieldName": "wrap"
+              "default": "\"100%\"",
+              "description": "Height used for vertical orientation.",
+              "privacy": "public",
+              "attribute": "height"
             },
             {
-              "name": "justify",
-              "type": {
-                "text": "SkyFlexboxJustify"
+              "kind": "method",
+              "name": "getComputedColor",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
               },
-              "default": "\"flex-start\"",
-              "description": "Main-axis alignment.",
-              "fieldName": "justify"
+              "description": "Gets the current computed color of the divider."
             },
             {
-              "name": "align",
+              "kind": "method",
+              "name": "getComputedThickness",
+              "privacy": "public",
+              "return": {
+                "type": {
+                  "text": ""
+                }
+              },
+              "description": "Gets the current computed thickness of the divider."
+            }
+          ],
+          "attributes": [
+            {
+              "name": "color",
               "type": {
-                "text": "SkyFlexboxAlign"
+                "text": "string"
               },
-              "default": "\"stretch\"",
-              "description": "Cross-axis alignment.",
-              "fieldName": "align"
+              "default": "\"muted\"",
+              "description": "Divider color token or CSS color.",
+              "fieldName": "color"
             },
             {
-              "name": "alignContent",
+              "name": "thickness",
               "type": {
-                "text": "SkyFlexboxAlignContent"
+                "text": "string"
               },
-              "default": "\"normal\"",
-              "description": "Multi-line cross-axis distribution.",
-              "fieldName": "alignContent"
+              "default": "\"1px\"",
+              "description": "Divider thickness (for example `1px` or `2px`).",
+              "fieldName": "thickness"
             },
             {
-              "name": "gap",
+              "name": "margin",
               "type": {
                 "text": "string"
               },
-              "default": "\"16px\"",
-              "description": "Shared row/column gap value.",
-              "fieldName": "gap"
+              "default": "\"\"",
+              "description": "Outer margin around the divider.",
+              "fieldName": "margin"
             },
             {
-              "name": "gapX",
+              "name": "direction",
               "type": {
-                "text": "string | undefined"
+                "text": "SkyDividerDirection"
               },
-              "description": "Horizontal gap override.",
-              "fieldName": "gapX"
+              "default": "\"horizontal\"",
+              "description": "Divider orientation.",
+              "fieldName": "direction"
             },
             {
-              "name": "gapY",
+              "name": "inset",
               "type": {
-                "text": "string | undefined"
+                "text": "boolean"
               },
-              "description": "Vertical gap override.",
-              "fieldName": "gapY"
+              "default": "false",
+              "description": "Enables indented divider layout.",
+              "fieldName": "inset"
             },
             {
-              "name": "col",
+              "name": "height",
               "type": {
-                "text": "number"
+                "text": "string"
               },
-              "default": "12",
-              "description": "Total column count used for span calculations.",
-              "fieldName": "col"
+              "default": "\"100%\"",
+              "description": "Height used for vertical orientation.",
+              "fieldName": "height"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "sky-flexbox",
+          "tagName": "sky-divider",
           "customElement": true,
-          "summary": "Flexbox container with grid-like span support for slotted children."
+          "summary": "Visual separator component for horizontal and vertical layout separation."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkyFlexbox",
+          "name": "SkyDivider",
           "declaration": {
-            "name": "SkyFlexbox",
-            "module": "src/sky-flexbox/sky-flexbox.ts"
+            "name": "SkyDivider",
+            "module": "src/sky-divider/sky-divider.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "sky-flexbox",
+          "name": "sky-divider",
           "declaration": {
-            "name": "SkyFlexbox",
-            "module": "src/sky-flexbox/sky-flexbox.ts"
+            "name": "SkyDivider",
+            "module": "src/sky-divider/sky-divider.ts"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/sky-divider/sky-divider.ts",
+      "path": "src/sky-flexbox/sky-flexbox.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "SkyDivider",
-          "cssProperties": [
-            {
-              "description": "CSS custom property for divider color.",
-              "name": "--divider-color"
-            },
-            {
-              "description": "CSS custom property for divider thickness.",
-              "name": "--divider-thickness"
-            },
-            {
-              "description": "CSS custom property for divider margin.",
-              "name": "--divider-margin"
-            },
+          "name": "SkyFlexbox",
+          "cssParts": [
             {
-              "description": "CSS custom property for vertical divider height.",
-              "name": "--divider-height"
+              "description": "The flex container element.",
+              "name": "container"
             }
           ],
-          "cssParts": [
+          "slots": [
             {
-              "description": "The divider line element (either `<hr>` or `<div>` depending on direction).",
-              "name": "divider"
+              "description": "Default slot for flex items (`<sky-flexcol>` or plain elements with `span` attributes).",
+              "name": ""
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "color",
+              "name": "direction",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxDirection"
               },
-              "default": "\"muted\"",
-              "description": "Divider color token or CSS color.",
+              "default": "\"row\"",
+              "description": "Flex direction.",
               "privacy": "public",
-              "attribute": "color"
+              "attribute": "direction"
             },
             {
               "kind": "field",
-              "name": "thickness",
+              "name": "wrap",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxWrap"
               },
-              "default": "\"1px\"",
-              "description": "Divider thickness (for example `1px` or `2px`).",
+              "default": "\"wrap\"",
+              "description": "Flex wrap behavior.",
               "privacy": "public",
-              "attribute": "thickness"
+              "attribute": "wrap"
             },
             {
               "kind": "field",
-              "name": "margin",
+              "name": "justify",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxJustify"
               },
-              "default": "\"\"",
-              "description": "Outer margin around the divider.",
+              "default": "\"flex-start\"",
+              "description": "Main-axis alignment.",
               "privacy": "public",
-              "attribute": "margin"
+              "attribute": "justify"
             },
             {
               "kind": "field",
-              "name": "direction",
+              "name": "align",
               "type": {
-                "text": "SkyDividerDirection"
+                "text": "SkyFlexboxAlign"
               },
-              "default": "\"horizontal\"",
-              "description": "Divider orientation.",
+              "default": "\"stretch\"",
+              "description": "Cross-axis alignment.",
               "privacy": "public",
-              "attribute": "direction"
+              "attribute": "align"
             },
             {
               "kind": "field",
-              "name": "inset",
+              "name": "alignContent",
               "type": {
-                "text": "boolean"
+                "text": "SkyFlexboxAlignContent"
               },
-              "default": "false",
-              "description": "Enables indented divider layout.",
+              "default": "\"normal\"",
+              "description": "Multi-line cross-axis distribution.",
               "privacy": "public",
-              "attribute": "inset"
+              "attribute": "alignContent"
             },
             {
               "kind": "field",
-              "name": "height",
+              "name": "gap",
               "type": {
                 "text": "string"
               },
-              "default": "\"100%\"",
-              "description": "Height used for vertical orientation.",
+              "default": "\"16px\"",
+              "description": "Shared row/column gap value.",
               "privacy": "public",
-              "attribute": "height"
+              "attribute": "gap"
+            },
+            {
+              "kind": "field",
+              "name": "gapX",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Horizontal gap override.",
+              "privacy": "public",
+              "attribute": "gapX"
+            },
+            {
+              "kind": "field",
+              "name": "gapY",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Vertical gap override.",
+              "privacy": "public",
+              "attribute": "gapY"
+            },
+            {
+              "kind": "field",
+              "name": "col",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "Total column count used for span calculations.",
+              "privacy": "public",
+              "attribute": "col"
+            },
+            {
+              "kind": "field",
+              "name": "_childMo",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "syncVars",
+              "privacy": "private",
+              "description": "Syncs component properties to CSS custom properties."
+            },
+            {
+              "kind": "method",
+              "name": "recalculateSpans",
+              "privacy": "public",
+              "description": "Forces recalculation of spans for all child elements.\r\nUseful when dynamically adding/removing items."
+            },
+            {
+              "kind": "field",
+              "name": "updateSpans",
+              "privacy": "private",
+              "description": "Reads span attributes off slotted children and maps them to CSS vars:\r\nspan, span-lg, span-md, span-sm, span-xs"
+            },
+            {
+              "kind": "method",
+              "name": "readSpanRaw",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string | null"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "attrName",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "propName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ],
+              "description": "Reads a span value from an HTML attribute or element property."
             },
             {
               "kind": "method",
-              "name": "getComputedColor",
-              "privacy": "public",
+              "name": "applySpanVar",
+              "privacy": "private",
               "return": {
                 "type": {
-                  "text": ""
+                  "text": "void"
                 }
               },
-              "description": "Gets the current computed color of the divider."
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "HTMLElement"
+                  }
+                },
+                {
+                  "name": "cssVar",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "raw",
+                  "type": {
+                    "text": "string | null"
+                  }
+                }
+              ],
+              "description": "Sets or clears a span CSS variable on a slotted child."
             },
             {
               "kind": "method",
-              "name": "getComputedThickness",
-              "privacy": "public",
+              "name": "clampSpan",
+              "privacy": "private",
               "return": {
                 "type": {
                   "text": ""
                 }
               },
-              "description": "Gets the current computed thickness of the divider."
+              "parameters": [
+                {
+                  "name": "raw",
+                  "type": {
+                    "text": "string | null"
+                  },
+                  "description": "Raw span value from attribute"
+                }
+              ],
+              "description": "Clamps span value to valid range (1 to column count)."
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "Event"
+              },
+              "description": "Fired when slotted children change.",
+              "name": "slotchange"
             }
           ],
           "attributes": [
             {
-              "name": "color",
+              "name": "direction",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxDirection"
               },
-              "default": "\"muted\"",
-              "description": "Divider color token or CSS color.",
-              "fieldName": "color"
+              "default": "\"row\"",
+              "description": "Flex direction.",
+              "fieldName": "direction"
             },
             {
-              "name": "thickness",
+              "name": "wrap",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxWrap"
               },
-              "default": "\"1px\"",
-              "description": "Divider thickness (for example `1px` or `2px`).",
-              "fieldName": "thickness"
+              "default": "\"wrap\"",
+              "description": "Flex wrap behavior.",
+              "fieldName": "wrap"
             },
             {
-              "name": "margin",
+              "name": "justify",
               "type": {
-                "text": "string"
+                "text": "SkyFlexboxJustify"
               },
-              "default": "\"\"",
-              "description": "Outer margin around the divider.",
-              "fieldName": "margin"
+              "default": "\"flex-start\"",
+              "description": "Main-axis alignment.",
+              "fieldName": "justify"
             },
             {
-              "name": "direction",
+              "name": "align",
               "type": {
-                "text": "SkyDividerDirection"
+                "text": "SkyFlexboxAlign"
               },
-              "default": "\"horizontal\"",
-              "description": "Divider orientation.",
-              "fieldName": "direction"
+              "default": "\"stretch\"",
+              "description": "Cross-axis alignment.",
+              "fieldName": "align"
             },
             {
-              "name": "inset",
+              "name": "alignContent",
               "type": {
-                "text": "boolean"
+                "text": "SkyFlexboxAlignContent"
               },
-              "default": "false",
-              "description": "Enables indented divider layout.",
-              "fieldName": "inset"
+              "default": "\"normal\"",
+              "description": "Multi-line cross-axis distribution.",
+              "fieldName": "alignContent"
             },
             {
-              "name": "height",
+              "name": "gap",
               "type": {
                 "text": "string"
               },
-              "default": "\"100%\"",
-              "description": "Height used for vertical orientation.",
-              "fieldName": "height"
+              "default": "\"16px\"",
+              "description": "Shared row/column gap value.",
+              "fieldName": "gap"
+            },
+            {
+              "name": "gapX",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Horizontal gap override.",
+              "fieldName": "gapX"
+            },
+            {
+              "name": "gapY",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Vertical gap override.",
+              "fieldName": "gapY"
+            },
+            {
+              "name": "col",
+              "type": {
+                "text": "number"
+              },
+              "default": "12",
+              "description": "Total column count used for span calculations.",
+              "fieldName": "col"
             }
           ],
           "superclass": {
             "name": "LitElement",
             "package": "lit"
           },
-          "tagName": "sky-divider",
+          "tagName": "sky-flexbox",
           "customElement": true,
-          "summary": "Visual separator component for horizontal and vertical layout separation."
+          "summary": "Flexbox container with grid-like span support for slotted children."
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SkyDivider",
+          "name": "SkyFlexbox",
           "declaration": {
-            "name": "SkyDivider",
-            "module": "src/sky-divider/sky-divider.ts"
+            "name": "SkyFlexbox",
+            "module": "src/sky-flexbox/sky-flexbox.ts"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "sky-divider",
+          "name": "sky-flexbox",
           "declaration": {
-            "name": "SkyDivider",
-            "module": "src/sky-divider/sky-divider.ts"
+            "name": "SkyFlexbox",
+            "module": "src/sky-flexbox/sky-flexbox.ts"
           }
         }
       ]
@@ -12122,49 +12122,6 @@
         }
       ]
     },
-    {
-      "kind": "javascript-module",
-      "path": "src/sky-row/sky-row.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SkyRow",
-          "slots": [
-            {
-              "description": "Default slot for child content.",
-              "name": ""
-            }
-          ],
-          "members": [],
-          "superclass": {
-            "name": "LitElement",
-            "package": "lit"
-          },
-          "tagName": "sky-row",
-          "customElement": true,
-          "summary": "Lightweight semantic row wrapper for use inside `sky-grid`."
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SkyRow",
-          "declaration": {
-            "name": "SkyRow",
-            "module": "src/sky-row/sky-row.ts"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "sky-row",
-          "declaration": {
-            "name": "SkyRow",
-            "module": "src/sky-row/sky-row.ts"
-          }
-        }
-      ]
-    },
     {
       "kind": "javascript-module",
       "path": "src/sky-sheet/sky-sheet.ts",
@@ -12347,6 +12304,49 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/sky-row/sky-row.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SkyRow",
+          "slots": [
+            {
+              "description": "Default slot for child content.",
+              "name": ""
+            }
+          ],
+          "members": [],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "sky-row",
+          "customElement": true,
+          "summary": "Lightweight semantic row wrapper for use inside `sky-grid`."
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SkyRow",
+          "declaration": {
+            "name": "SkyRow",
+            "module": "src/sky-row/sky-row.ts"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "sky-row",
+          "declaration": {
+            "name": "SkyRow",
+            "module": "src/sky-row/sky-row.ts"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/sky-simple-table/sky-simple-table.ts",