@cordwainer/cw-elements 1.2.3 → 1.3.0-alpha.0

package/dist/custom-elements.json

@@ -6309,6 +6309,14 @@
               "static": true,
               "default": "{ 'cw-checkbox': CwCheckbox, 'cw-icon': CwIcon, 'cw-spinner': CwSpinner }"
             },
+            {
+              "kind": "field",
+              "name": "#stopThemeFallback",
+              "privacy": "private",
+              "type": {
+                "text": "() => void | undefined"
+              }
+            },
             {
               "kind": "field",
               "name": "columns",
@@ -11760,6 +11768,198 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/logo/logo.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwLogo",
+          "cssProperties": [
+            {
+              "description": "The height of the logo. Width scales automatically.",
+              "name": "--cw-logo-height"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The component's base wrapper (an `<a>` when `href` is set, otherwise a `<span>`).",
+              "name": "base"
+            },
+            {
+              "description": "The light-mode (default) logo image.",
+              "name": "image"
+            },
+            {
+              "description": "The dark-mode logo image.",
+              "name": "image-dark"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Custom logo markup (e.g. an inline `<svg>` or `<picture>`), overriding `image`/`dark-image`.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "localize",
+              "privacy": "private",
+              "readonly": true,
+              "default": "new LocalizeController(this)"
+            },
+            {
+              "kind": "field",
+              "name": "image",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The default (light-mode) logo image URL.",
+              "attribute": "image"
+            },
+            {
+              "kind": "field",
+              "name": "darkImage",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The dark-mode logo image URL. Falls back to `image` when unset.",
+              "attribute": "dark-image"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "When set, the logo renders as a link to this URL — typically the site's home page.",
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "'_blank' | '_parent' | '_self' | '_top' | ''"
+              },
+              "default": "''",
+              "description": "Tells the browser where to open the link. Only used when `href` is present.",
+              "attribute": "target"
+            },
+            {
+              "kind": "field",
+              "name": "rel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'noreferrer noopener'",
+              "description": "The `rel` attribute for the link. Only used when `href` is present. Mirrors `<cw-button>`'s\ndefault of `noreferrer noopener` as a safe default when `target` is used.",
+              "attribute": "rel"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The accessible name for the logo. Defaults to a localized \"Home\" — for the best experience,\npass a brand-specific value instead, e.g. `label=\"Acme home\"`.",
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "#stopThemeFallback",
+              "privacy": "private",
+              "type": {
+                "text": "() => void | undefined"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "image",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The default (light-mode) logo image URL.",
+              "fieldName": "image"
+            },
+            {
+              "name": "dark-image",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The dark-mode logo image URL. Falls back to `image` when unset.",
+              "fieldName": "darkImage"
+            },
+            {
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "When set, the logo renders as a link to this URL — typically the site's home page.",
+              "fieldName": "href"
+            },
+            {
+              "name": "target",
+              "type": {
+                "text": "'_blank' | '_parent' | '_self' | '_top' | ''"
+              },
+              "default": "''",
+              "description": "Tells the browser where to open the link. Only used when `href` is present.",
+              "fieldName": "target"
+            },
+            {
+              "name": "rel",
+              "type": {
+                "text": "string"
+              },
+              "default": "'noreferrer noopener'",
+              "description": "The `rel` attribute for the link. Only used when `href` is present. Mirrors `<cw-button>`'s\ndefault of `noreferrer noopener` as a safe default when `target` is used.",
+              "fieldName": "rel"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The accessible name for the logo. Defaults to a localized \"Home\" — for the best experience,\npass a brand-specific value instead, e.g. `label=\"Acme home\"`.",
+              "fieldName": "label"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "A branding mark for a site's navigation, header, or footer, with automatic light/dark\nimage swapping and an optional home link.",
+          "tagNameWithoutPrefix": "logo",
+          "tagName": "cw-logo",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary A branding mark for a site's navigation, header, or footer, with automatic light/dark\n * image swapping and an optional home link.\n * @documentation https://cordwainer.dev/components/logo\n * @status experimental\n * @since 1.3\n *\n * @slot - Custom logo markup (e.g. an inline `<svg>` or `<picture>`), overriding `image`/`dark-image`.\n *\n * @csspart base - The component's base wrapper (an `<a>` when `href` is set, otherwise a `<span>`).\n * @csspart image - The light-mode (default) logo image.\n * @csspart image-dark - The dark-mode logo image.\n *\n * @cssproperty --cw-logo-height - The height of the logo. Width scales automatically.\n */",
+          "documentation": "https://cordwainer.dev/components/logo",
+          "status": "experimental",
+          "since": "1.3"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwLogo",
+            "module": "components/logo/logo.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/menu/menu.js",
@@ -22023,7 +22223,7 @@
   "package": {
     "name": "@cordwainer/cw-elements",
     "description": "Cordwainer Elements — Web Component Library, a hard fork of Shoelace (@shoelace-style/shoelace).",
-    "version": "1.2.3",
+    "version": "1.3.0-alpha.0",
     "author": "Matt Hand",
     "homepage": "https://cordwainer.dev",
     "license": "MIT"

package/dist/cw-elements.d.ts

@@ -62,6 +62,7 @@ export { default as CwDatePicker } from './components/date-picker/date-picker.js
 export { default as CwPagination } from './components/pagination/pagination.js';
 export { default as CwDataTable } from './components/data-table/data-table.js';
 export { default as CwDataTableColumn } from './components/data-table/data-table-column.js';
+export { default as CwLogo } from './components/logo/logo.js';
 export * from './utilities/animation.js';
 export * from './utilities/base-path.js';
 export * from './utilities/icon-library.js';