@gitlab/ui 118.0.0 → 118.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/ui",
-  "version": "118.0.0",
+  "version": "118.1.1",
   "description": "GitLab UI Components",
   "license": "MIT",
   "main": "dist/index.js",
@@ -70,7 +70,7 @@
   "dependencies": {
     "@floating-ui/dom": "1.7.3",
     "echarts": "^5.6.0",
-    "gridstack": "^12.3.0",
+    "gridstack": "^12.3.3",
     "iframe-resizer": "^4.4.5",
     "lodash": "^4.17.21",
     "popper.js": "^1.16.1",
@@ -95,10 +95,10 @@
     "rollup-plugin-vue/@vue/component-compiler/postcss-modules-sync/generic-names/loader-utils": "3.3.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.28.0",
+    "@babel/core": "^7.28.3",
     "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6",
     "@babel/plugin-proposal-optional-chaining": "^7.21.0",
-    "@babel/preset-env": "^7.28.0",
+    "@babel/preset-env": "^7.28.3",
     "@babel/preset-react": "^7.27.1",
     "@cypress/grep": "^4.1.1",
     "@gitlab/fonts": "^1.3.0",
@@ -138,7 +138,7 @@
     "cypress-real-events": "^1.14.0",
     "dompurify": "^3.1.2",
     "emoji-regex": "^10.4.0",
-    "esbuild": "^0.25.8",
+    "esbuild": "^0.25.9",
     "gitlab-api-async-iterator": "^1.3.1",
     "glob": "11.0.3",
     "globby": "^14.1.0",

package/src/components/base/illustration/illustration.vue

@@ -0,0 +1,56 @@
+<!-- eslint-disable vue/multi-word-component-names -->
+<script>
+import illustrationsPath from '@gitlab/svgs/dist/illustrations.svg';
+import illustrationsInfo from '@gitlab/svgs/dist/illustrations.json';
+
+const knownIllustrations = illustrationsInfo.icons;
+
+/** This is a re-usable vue component for rendering a svg sprite icon
+ *  @example
+ *  <illustration
+ *    name="status-success-sm"
+ *  />
+ */
+export default {
+  name: 'GlIllustration',
+  props: {
+    /**
+     * One of the illustrations from https://gitlab-org.gitlab.io/gitlab-svgs/ project
+     */
+    name: {
+      type: String,
+      required: true,
+      validator: (value) => {
+        if (knownIllustrations.some((obj) => obj.name === value)) {
+          return true;
+        }
+        // eslint-disable-next-line no-console
+        console.warn(`Illustration '${value}' is not a known illustration of @gitlab/svgs`);
+        return false;
+      },
+    },
+  },
+  computed: {
+    spriteHref() {
+      return `${illustrationsPath}#${this.name}`;
+    },
+    illustrationSize() {
+      return knownIllustrations.find((obj) => obj.name === this.name).svg_size;
+    },
+  },
+};
+</script>
+
+<template>
+  <svg
+    :key="spriteHref"
+    :data-testid="`${name}-illustration`"
+    aria-label=""
+    role="presentation"
+    :width="illustrationSize"
+    :height="illustrationSize"
+    v-on="$listeners"
+  >
+    <use :href="spriteHref" />
+  </svg>
+</template>

package/src/components/base/token_selector/token_selector.vue

@@ -414,12 +414,11 @@ export default {
         @cancel-focus="cancelTokenFocus"
         @clear-all="clearAll"
       >
-        <template #token-content="{ token }">
-          <!-- @slot Content to pass to the token component slot. Can be used
-            to add an avatar to the token. Default content is "{{ token.name }}".
-               @binding {object} token
-          -->
-          <slot name="token-content" :token="token"></slot>
+        <template #token-content="{ token }"
+          ><!--
+            @slot Content to pass to the token component slot. Can be used to add an avatar to the token. Default content is "{{ token.name }}".
+            @binding {object} token
+          --><slot name="token-content" :token="token"></slot>
         </template>
         <template #text-input>
           <!-- Can't use `v-model` due to this bug: -->
@@ -465,34 +464,32 @@ export default {
       @dropdown-item-click="addToken"
       @show="openDropdown"
     >
-      <template #loading-content>
-        <!-- @slot Content to display when `loading` prop is `true`. Default
-          content is "Searching..." -->
-        <slot name="loading-content"></slot>
+      <template #loading-content
+        ><!--
+          @slot Content to display when `loading` prop is `true`. Default content is "Searching..."
+        --><slot name="loading-content"></slot>
       </template>
-      <template #user-defined-token-content>
-        <!-- @slot Content to display when adding a user defined token. Default content is 'Add "{{ inputText }}"'.
-             @binding {string} inputText
-        -->
-        <slot name="user-defined-token-content" :input-text="inputText"></slot>
+      <template #user-defined-token-content
+        ><!--
+          @slot Content to display when adding a user defined token. Default content is 'Add "{{ inputText }}"'.
+          @binding {string} inputText
+        --><slot name="user-defined-token-content" :input-text="inputText"></slot>
       </template>
-      <template #no-results-content>
-        <!-- @slot Content to display when `dropdown-items` is empty and
-          both `allow-user-defined-tokens` and `show-add-new-always` is `false`. Default content is "No matches found". -->
-        <slot name="no-results-content"></slot>
+      <template #no-results-content
+        ><!--
+          @slot Content to display when `dropdown-items` is empty and both `allow-user-defined-tokens` and `show-add-new-always` is `false`. Default content is "No matches found".
+        --><slot name="no-results-content"></slot>
       </template>
-      <template #dropdown-item-content="{ dropdownItem }">
-        <!-- @slot Dropdown item content. Default content is "{{ dropdownItem.name }}".
-             @binding {object} dropdownItem
-        -->
-        <slot name="dropdown-item-content" :dropdown-item="dropdownItem"></slot>
+      <template #dropdown-item-content="{ dropdownItem }"
+        ><!--
+          @slot Dropdown item content. Default content is "{{ dropdownItem.name }}".
+          @binding {object} dropdownItem
+        --><slot name="dropdown-item-content" :dropdown-item="dropdownItem"></slot>
       </template>
-      <template #dropdown-footer>
-        <!-- @slot Content to add to the bottom of the dropdown.
-          Can be used in conjunction with `gl-intersection-observer` to load
-          more items as the user scrolls.
-        -->
-        <slot name="dropdown-footer"></slot>
+      <template #dropdown-footer
+        ><!--
+          @slot Content to add to the bottom of the dropdown. Can be used in conjunction with `gl-intersection-observer` to load more items as the user scrolls.
+        --><slot name="dropdown-footer"></slot>
       </template>
     </gl-token-selector-dropdown>
   </div>

package/src/components/index.js

@@ -8,6 +8,7 @@ export { default as GlTokenSelector } from './base/token_selector/token_selector
 export { default as GlMarkdown } from './base/markdown/markdown.vue';
 export { default as GlLink, default as GlDeprecatedLink } from './base/link/link.vue';
 export { default as GlIcon } from './base/icon/icon.vue';
+export { default as GlIllustration } from './base/illustration/illustration.vue';
 export { default as GlAnimatedChevronRightDownIcon } from './base/animated_icon/animated_chevron_right_down_icon.vue';
 export { default as GlAnimatedChevronLgRightDownIcon } from './base/animated_icon/animated_chevron_lg_right_down_icon.vue';
 export { default as GlAnimatedChevronDownUpIcon } from './base/animated_icon/animated_chevron_down_up_icon.vue';

package/src/components/regions/empty_state/empty_state.vue

@@ -15,6 +15,19 @@ export default {
       required: false,
       default: null,
     },
+    /**
+     * The header tag used in the empty state component (h1/h2/h3/h4/h5/h6).
+     * For accessibility this should be set to an appropriate value in the context where the component is used.
+     * Defaults to `h2`
+     */
+    headerLevel: {
+      type: Number,
+      required: false,
+      default: 2,
+      validator(value) {
+        return value > 0 && value <= 6;
+      },
+    },
     /**
      * The illustration's URL.
      */
@@ -94,6 +107,10 @@ export default {
     },
   },
   computed: {
+    headerComponent() {
+      const level = this.headerLevel;
+      return `h${level}`;
+    },
     height() {
       return this.shouldPreventImageReflow ? this.svgHeight : null;
     },
@@ -141,12 +158,13 @@ export default {
           Overrides the `title` prop.
         -->
       <slot ref="title" name="title">
-        <h1
+        <component
+          :is="headerComponent"
           class="gl-mb-0 gl-mt-0 gl-text-size-h-display gl-leading-36"
           :class="compact ? 'h5' : 'h4'"
         >
           {{ title }}
-        </h1>
+        </component>
       </slot>
       <p
         v-if="description || $scopedSlots.description"