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

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.2",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -94,10 +94,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 +112,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": []
           }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@warp-ds/elements",
   "type": "module",
-  "version": "2.9.0-next.2",
+  "version": "2.9.0-next.3",
   "packageManager": "pnpm@10.33.0",
   "description": "Custom elements for Warp",
   "exports": {
@@ -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",