@warp-ds/elements 2.9.0-next.2 → 2.9.0-next.4

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@warp-ds/elements",
-  "version": "2.9.0-next.1",
+  "version": "2.9.0-next.3",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -71,16 +71,8 @@
           "js": {
             "properties": [
               { "name": "ariaLabel", "type": "string" },
-              {
-                "name": "clear",
-                "description": "Add this property to render a clickable Warp close icon.\n\nSet an `aria-label` that explains the action when using this.",
-                "type": "boolean"
-              },
-              {
-                "name": "search",
-                "description": "Add this property to render a clickable Warp search icon.\n\nSet an `aria-label` that explains the action when using this.",
-                "type": "boolean"
-              },
+              { "name": "clear", "type": "boolean" },
+              { "name": "search", "type": "boolean" },
               { "name": "label", "type": "string" }
             ],
             "events": []
@@ -94,10 +86,14 @@
             {
               "name": "variant",
               "value": {
-                "type": "'negative' | 'positive' | 'warning' | 'info'"
+                "type": "'negative' | 'positive' | 'warning' | 'info'",
+                "default": "'info'"
               }
             },
-            { "name": "show", "value": { "type": "boolean" } },
+            {
+              "name": "show",
+              "value": { "type": "boolean", "default": "false" }
+            },
             {
               "name": "role",
               "value": { "type": "string", "default": "'alert'" }
@@ -108,10 +104,19 @@
             "properties": [
               {
                 "name": "variant",
+                "description": "Controls both the color treatment and icon used by the component. Accepted values are `info`, `warning`, `positive`, and `negative`. Use the variant that matches the message severity so users can quickly distinguish informative messages from warnings, errors, and confirmations.",
                 "type": "'negative' | 'positive' | 'warning' | 'info'"
               },
-              { "name": "show", "type": "boolean" },
-              { "name": "role", "type": "string" }
+              {
+                "name": "show",
+                "description": "Alerts are hidden by default (`false`). Set this to `true` to render and expand the content. This is reflected as an attribute, so visibility can be controlled from markup (`show`) or from JavaScript (`element.show = true`).",
+                "type": "boolean"
+              },
+              {
+                "name": "role",
+                "description": "Defaults to `alert` so urgent changes are announced by screen readers. Override this only when your use case requires a different announcement behavior, for example a less assertive live region strategy.",
+                "type": "string"
+              }
             ],
             "events": []
           }
@@ -674,81 +679,21 @@
           "events": [],
           "js": {
             "properties": [
-              {
-                "name": "options",
-                "description": "The available options to select from",
-                "type": "ComboboxOption[]"
-              },
-              {
-                "name": "label",
-                "description": "Label above input",
-                "type": "string | undefined"
-              },
-              {
-                "name": "placeholder",
-                "description": "Input placeholder",
-                "type": "string | undefined"
-              },
-              {
-                "name": "value",
-                "description": "The input value",
-                "type": "string"
-              },
-              {
-                "name": "openOnFocus",
-                "description": "Whether the popover opens when focus is on the text field",
-                "type": "boolean"
-              },
-              {
-                "name": "selectOnBlur",
-                "description": "Select active option on blur",
-                "type": "boolean"
-              },
-              {
-                "name": "matchTextSegments",
-                "description": "Whether the matching text segments in the options should be highlighted",
-                "type": "boolean"
-              },
-              {
-                "name": "disableStaticFiltering",
-                "description": "Disable client-side static filtering",
-                "type": "boolean"
-              },
-              {
-                "name": "invalid",
-                "description": "Renders the input field in an invalid state",
-                "type": "boolean"
-              },
-              {
-                "name": "helpText",
-                "description": "The content to display as the help text",
-                "type": "string | undefined"
-              },
-              {
-                "name": "disabled",
-                "description": "Whether the element is disabled",
-                "type": "boolean"
-              },
-              {
-                "name": "required",
-                "description": "Whether the element is required",
-                "type": "boolean"
-              },
-              {
-                "name": "optional",
-                "description": "Whether to show optional text",
-                "type": "boolean"
-              },
-              {
-                "name": "name",
-                "description": "Name attribute for form submission",
-                "type": "string | undefined"
-              },
-              {
-                "name": "autocomplete",
-                "description": "Autocomplete attribute for the input field",
-                "type": "string | undefined"
-              }
+              { "name": "options", "type": "ComboboxOption[]" },
+              { "name": "label", "type": "string | undefined" },
+              { "name": "placeholder", "type": "string | undefined" },
+              { "name": "value", "type": "string" },
+              { "name": "openOnFocus", "type": "boolean" },
+              { "name": "selectOnBlur", "type": "boolean" },
+              { "name": "matchTextSegments", "type": "boolean" },
+              { "name": "disableStaticFiltering", "type": "boolean" },
+              { "name": "invalid", "type": "boolean" },
+              { "name": "helpText", "type": "string | undefined" },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "required", "type": "boolean" },
+              { "name": "optional", "type": "boolean" },
+              { "name": "name", "type": "string | undefined" },
+              { "name": "autocomplete", "type": "string | undefined" }
             ],
             "events": []
           }
@@ -786,33 +731,13 @@
           "js": {
             "properties": [
               { "name": "label", "type": "string" },
-              {
-                "name": "lang",
-                "description": "Takes precedence over the `<html>` lang attribute.",
-                "type": "string"
-              },
+              { "name": "lang", "type": "string" },
               { "name": "name", "type": "string" },
               { "name": "value", "type": "string" },
-              {
-                "name": "headerFormat",
-                "description": "Decides the format of the date as shown in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
-                "type": "string"
-              },
-              {
-                "name": "weekdayFormat",
-                "description": "Decides the format of the weekday as shown above the grid of dates in the calendar.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
-                "type": "string"
-              },
-              {
-                "name": "isDayDisabled",
-                "description": "Lets you control if a date in the calendar should be disabled.\n\nThis needs to be set on the element instance in JavaScript, not as an HTML attribute.",
-                "type": "(day: Date) => boolean"
-              },
-              {
-                "name": "dayFormat",
-                "description": "Decides the format of the day in the calendar as read to screen readers.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
-                "type": "string"
-              },
+              { "name": "headerFormat", "type": "string" },
+              { "name": "weekdayFormat", "type": "string" },
+              { "name": "isDayDisabled", "type": "(day: Date) => boolean" },
+              { "name": "dayFormat", "type": "string" },
               { "name": "isCalendarOpen", "type": "boolean" },
               { "name": "navigationDate", "type": "Date" },
               { "name": "selectedDate", "type": "Date | null" },
@@ -1005,16 +930,8 @@
           "events": [],
           "js": {
             "properties": [
-              {
-                "name": "selectedPage",
-                "description": "Currently selected page (1-based index, clamped to valid range)",
-                "type": "number"
-              },
-              {
-                "name": "pageCount",
-                "description": "Total number of pages (minimum 1)",
-                "type": "number"
-              }
+              { "name": "selectedPage", "type": "number" },
+              { "name": "pageCount", "type": "number" }
             ],
             "events": []
           }
@@ -1307,63 +1224,20 @@
           "events": [{ "name": "change", "type": "CustomEvent" }],
           "js": {
             "properties": [
-              {
-                "name": "autoFocus",
-                "description": "Whether the element should receive focus on render.",
-                "type": "boolean"
-              },
-              {
-                "name": "autofocus",
-                "description": "Whether the element should receive focus on render",
-                "type": "boolean"
-              },
-              {
-                "name": "helpText",
-                "description": "The content displayed as the help text. Paired with `invalid` to show the text as a validation error.",
-                "type": "string"
-              },
-              {
-                "name": "invalid",
-                "description": "Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.",
-                "type": "boolean"
-              },
-              {
-                "name": "always",
-                "description": "Whether to always show a hint.",
-                "type": "boolean"
-              },
-              {
-                "name": "hint",
-                "description": "The content displayed as the help text.",
-                "type": "string"
-              },
-              {
-                "name": "label",
-                "description": "The content to disply as the label",
-                "type": "string"
-              },
-              {
-                "name": "optional",
-                "description": "Whether to show optional text",
-                "type": "boolean"
-              },
-              {
-                "name": "disabled",
-                "description": "Renders the field in a disabled state.",
-                "type": "boolean"
-              },
-              {
-                "name": "readOnly",
-                "description": "Renders the field in a readonly state.",
-                "type": "boolean"
-              },
-              {
-                "name": "readonly",
-                "description": "Renders the field in a readonly state.",
-                "type": "boolean"
-              },
+              { "name": "autoFocus", "type": "boolean" },
+              { "name": "autofocus", "type": "boolean" },
+              { "name": "helpText", "type": "string" },
+              { "name": "invalid", "type": "boolean" },
+              { "name": "always", "type": "boolean" },
+              { "name": "hint", "type": "string" },
+              { "name": "label", "type": "string" },
+              { "name": "optional", "type": "boolean" },
+              { "name": "disabled", "type": "boolean" },
+              { "name": "readOnly", "type": "boolean" },
+              { "name": "readonly", "type": "boolean" },
               { "name": "name", "type": "string" },
-              { "name": "value", "type": "string" }
+              { "name": "value", "type": "string" },
+              { "name": "_options" }
             ],
             "events": [{ "name": "change", "type": "CustomEvent" }]
           }
@@ -1435,11 +1309,9 @@
               { "name": "name", "type": "string" },
               { "name": "step", "type": "number" },
               { "name": "autocomplete", "type": "string | undefined" },
-              {
-                "name": "formatter",
-                "description": "Function to format value when the input field.\n\nOnly active when the input field does not have focus,\nsimilar to the accessible input masking example from Filament Group\n\nhttps://css-tricks.com/input-masking/\nhttps://filamentgroup.github.io/politespace/demo/demo.html",
-                "type": "(value: string) => string"
-              }
+              { "name": "formatter", "type": "(value: string) => string" },
+              { "name": "_hasPrefix" },
+              { "name": "_hasSuffix" }
             ],
             "events": []
           }
@@ -1479,7 +1351,13 @@
                 "description": "Value to display in the tooltip",
                 "type": "string | number"
               },
-              { "name": "ariaDescriptionText" }
+              { "name": "ariaDescriptionText" },
+              { "name": "disabled" },
+              { "name": "invalid" },
+              { "name": "openEnded" },
+              { "name": "valueFormatter" },
+              { "name": "tooltipFormatter" },
+              { "name": "labelFormatter" }
             ],
             "events": [
               { "name": "thumbreset", "type": "CustomEvent" },
@@ -1560,54 +1438,32 @@
           "events": [],
           "js": {
             "properties": [
-              {
-                "name": "label",
-                "description": "The slider fieldset label. Required for proper accessibility.\n\nIf you need to display HTML, use the `label` slot instead (f. ex. `<legend class=\"sr-only\" slot=\"label\">Production year</legend>`)",
-                "type": "string"
-              },
+              { "name": "label", "type": "string" },
               { "name": "disabled", "type": "boolean" },
-              {
-                "name": "openEnded",
-                "description": "Whether or not to allow values outside the range such as \"Before 1950\" and \"2025+\".",
-                "type": "boolean"
-              },
+              { "name": "openEnded", "type": "boolean" },
               { "name": "error", "type": "string" },
               { "name": "helpText", "type": "string" },
               { "name": "invalid", "type": "boolean" },
-              {
-                "name": "required",
-                "description": "Ensures a child slider thumb has a value before allowing the containing form to submit.",
-                "type": "boolean"
-              },
+              { "name": "required", "type": "boolean" },
               { "name": "min", "type": "string" },
               { "name": "max", "type": "string" },
-              {
-                "name": "markers",
-                "description": "Pass a value similar to step to create visual markers at that interval",
-                "type": "number"
-              },
+              { "name": "markers", "type": "number" },
               { "name": "step", "type": "number" },
-              {
-                "name": "suffix",
-                "description": "Suffix used in text input fields and for the min and max values of the slider.",
-                "type": "string"
-              },
+              { "name": "suffix", "type": "string" },
               { "name": "hiddenTextfield", "type": "boolean" },
               {
                 "name": "valueFormatter",
-                "description": "Formatter for the tooltip and input mask values.",
                 "type": "(value: string, slot: SliderSlot) => string"
               },
               {
                 "name": "tooltipFormatter",
-                "description": "Replaces valueFormatter for the tooltip. Use in open-ended sliders to show for example \"300+ hk\" instead of \"Max\" in the tooltip.",
                 "type": "(value: string, slot: SliderSlot) => string"
               },
               {
                 "name": "labelFormatter",
-                "description": "Formatter for the min and max labels below the range.",
                 "type": "(slot: SliderSlot) => string"
               },
+              { "name": "fieldset", "type": "HTMLFieldSetElement" },
               { "name": "_invalidMessage", "type": "string" },
               { "name": "_hasInternalError", "type": "boolean" },
               { "name": "_showError", "type": "boolean" },
@@ -1734,7 +1590,9 @@
               },
               { "name": "ariaSelected", "type": "'true' | 'false'" },
               { "name": "active", "type": "boolean" },
-              { "name": "over", "type": "boolean" }
+              { "name": "over", "type": "boolean" },
+              { "name": "_parentTabIndex" },
+              { "name": "_parentAriaSelected" }
             ],
             "events": []
           }
@@ -1757,7 +1615,9 @@
                 "name": "active",
                 "description": "Whether this panel is active (visible).\nSet by parent w-tabs via the _parentActive property.",
                 "type": "boolean"
-              }
+              },
+              { "name": "_parentActive" },
+              { "name": "_parentAriaLabelledBy" }
             ],
             "events": []
           }
@@ -1845,14 +1705,6 @@
             ],
             "events": []
           }
-        },
-        {
-          "name": "w-toast-container",
-          "description": "\n---\n",
-          "doc-url": "",
-          "attributes": [],
-          "events": [],
-          "js": { "properties": [], "events": [] }
         }
       ]
     },

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@warp-ds/elements",
   "type": "module",
-  "version": "2.9.0-next.2",
+  "version": "2.9.0-next.4",
   "packageManager": "pnpm@10.33.0",
   "description": "Custom elements for Warp",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./eik/index.js"
     },
     "./components/affix": "./dist/packages/affix/affix.js",
     "./components/alert": "./dist/packages/alert/alert.js",
@@ -140,6 +140,9 @@
       "types": "./dist/packages/*/react.d.ts",
       "import": "./dist/packages/*/react.js"
     },
+    "./docs/*": {
+      "default": "./dist/docs/*"
+    },
     "./*": {
       "types": "./dist/packages/*/*.d.ts",
       "import": "./dist/packages/*/*.js"
@@ -270,6 +273,7 @@
     "build:bundle": "tsc --project tsconfig.json --outDir .tmp --declaration false --sourceMap true && rollup -c ./build/bundle.js && rimraf .tmp",
     "build:cloak": "node ./build/cloak.js",
     "build:components": "node ./build/components.js",
+    "build:docs": "node ./build/docs.js",
     "build:eik-components-backwards-compat": "node ./build/components-eik.js",
     "build:editor": "node ./build/editor.js",
     "build:entrypoint": "node ./build/entrypoint.js",
@@ -277,7 +281,7 @@
     "build:polyfill": "node ./build/polyfill.js",
     "build:storybook": "pnpm run messages:compile && tsc && pnpm run build:manifest && pnpm run build:entrypoint && storybook build && pnpm run build:polyfill && touch ./storybook-static/.nojekyll",
     "build:styles": "node ./build/styles.js",
-    "build": "rimraf dist && rimraf eik && pnpm messages:compile && tsc && pnpm build:manifest && pnpm build:editor && pnpm build:components && pnpm run build:cloak && pnpm build:bundle && pnpm build:eik-components-backwards-compat && pnpm run build:polyfill",
+    "build": "rimraf dist && rimraf eik && pnpm messages:compile && tsc && pnpm build:manifest && pnpm build:editor && pnpm build:components && pnpm run build:cloak && pnpm build:bundle && pnpm build:eik-components-backwards-compat && pnpm run build:polyfill && pnpm run build:docs",
     "check": "pnpm biome check --write .",
     "clean": "rimraf .pnpm-store node_modules dist eik storybook-static entrypoint.js",
     "commit": "cz",
@@ -340,6 +344,7 @@
     "@warp-ds/css": "2.1.1",
     "@warp-ds/uno": "2.1.0",
     "@wc-toolkit/cem-validator": "^1.0.3",
+    "@wc-toolkit/jsdoc-tags": "^1.2.0",
     "@wc-toolkit/jsx-types": "^1.4.2",
     "@wc-toolkit/storybook-helpers": "^10.0.0",
     "@wc-toolkit/type-parser": "^1.2.0",