@gitlab/ui 66.1.0 → 66.3.0

package/dist/utils/i18n.js

@@ -0,0 +1,15 @@
+import { i18n } from '../config';
+
+/**
+ * Mark a label as translatable.
+ *
+ * @param {string} key Translation key to be leveraged by the consumer to provide a generic translation at configuration time.
+ * @param {string} defaultValue A fallback value to be relied on if the consumer doesn't have translation capabilities.
+ * @returns {string} The translated label.
+ */
+const translate = (key, defaultValue) => {
+  var _i18n$key;
+  return (_i18n$key = i18n[key]) !== null && _i18n$key !== void 0 ? _i18n$key : defaultValue;
+};
+
+export { translate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitlab/ui",
-  "version": "66.1.0",
+  "version": "66.3.0",
   "description": "GitLab UI Components",
   "license": "MIT",
   "main": "dist/index.js",
@@ -17,7 +17,8 @@
   "files": [
     "src",
     "dist",
-    "scss_to_js"
+    "scss_to_js",
+    "translations.json"
   ],
   "scripts": {
     "build": "NODE_ENV=production rollup -c",
@@ -60,7 +61,8 @@
     "markdownlint:fix": "yarn markdownlint --fix",
     "lint": "run-p prettier eslint stylelint markdownlint",
     "lint:fix": "run-s prettier:fix eslint:fix stylelint:fix markdownlint:fix",
-    "generate:component": "plop"
+    "generate:component": "plop",
+    "translations:collect": "make translations.json"
   },
   "dependencies": {
     "@floating-ui/dom": "1.2.9",
@@ -126,7 +128,7 @@
     "eslint-import-resolver-jest": "3.0.2",
     "eslint-plugin-cypress": "2.14.0",
     "eslint-plugin-storybook": "0.6.13",
-    "glob": "^7.2.0",
+    "glob": "10.3.3",
     "identity-obj-proxy": "^3.0.0",
     "inquirer-select-directory": "^1.2.0",
     "jest": "^29.6.4",

package/src/charts.js

@@ -1,8 +1,3 @@
-// Add config files
-import setConfigs from './config';
-
-setConfigs();
-
 export { default as GlChart } from './components/charts/chart/chart.vue';
 export { default as GlAreaChart } from './components/charts/area/area.vue';
 export { default as GlBarChart } from './components/charts/bar/bar.vue';

package/src/components/base/search_box_by_type/search_box_by_type.vue

@@ -3,6 +3,7 @@ import GlClearIconButton from '../../shared_components/clear_icon_button/clear_i
 import GlFormInput from '../form/form_input/form_input.vue';
 import GlIcon from '../icon/icon.vue';
 import GlLoadingIcon from '../loading_icon/loading_icon.vue';
+import { translate } from '../../../utils/i18n';
 
 export default {
   name: 'GlSearchboxByType',
@@ -34,7 +35,7 @@ export default {
     clearButtonTitle: {
       type: String,
       required: false,
-      default: 'Clear',
+      default: () => translate('GlSearchBoxByType.clearButtonTitle', 'Clear'),
     },
     /**
      * If provided and true, disables the input and controls
@@ -66,7 +67,7 @@ export default {
     inputAttributes() {
       const attributes = {
         type: 'search',
-        placeholder: 'Search',
+        placeholder: translate('GlSearchBoxByType.input.placeholder', 'Search'),
         ...this.$attrs,
       };
 

package/src/components/shared_components/clear_icon_button/clear_icon_button.vue

@@ -1,6 +1,7 @@
 <script>
 import { GlTooltipDirective } from '../../../directives/tooltip';
 import GlButton from '../../base/button/button.vue';
+import { translate } from '../../../utils/i18n';
 
 export default {
   name: 'ClearIconButton',
@@ -14,7 +15,7 @@ export default {
     title: {
       type: String,
       required: false,
-      default: 'Clear',
+      default: () => translate('ClearIconButton.title', 'Clear'),
     },
     tooltipContainer: {
       required: false,

package/src/config.js

@@ -1,5 +1,6 @@
 import { BVConfigPlugin } from 'bootstrap-vue';
 import Vue from 'vue';
+import translationKeys from '../translations.json';
 import { tooltipDelay } from './utils/constants';
 
 const bFormTextGlobalConfig = {
@@ -31,11 +32,53 @@ try {
   // localStorage doesn't exist (or the value is not properly formatted)
 }
 
-const setConfigs = () => {
+export const i18n = translationKeys;
+
+let configured = false;
+
+/**
+ * Set GitLab UI configuration.
+ *
+ * @typedef {object} GitLabUIConfiguration
+ * @template TValue=string
+ * @property {undefined | Object} translations Generic translations for component labels to fall back to.
+ * @property {boolean} disableTranslations Whether translation capabilities should be disabled. Suppresses the warning about missing translations.
+ */
+const setConfigs = ({ translations } = {}) => {
+  if (configured) {
+    if (process.env.NODE_ENV === 'development') {
+      throw new Error('GitLab UI can only be configured once!');
+    }
+
+    return;
+  }
+  configured = true;
+
   Vue.use(BVConfigPlugin, {
     BFormText: bFormTextGlobalConfig,
     BTooltip: tooltipGlobalConfig,
   });
+
+  if (typeof translations === 'object') {
+    if (process.env.NODE_ENV === 'development') {
+      const undefinedTranslationKeys = Object.keys(i18n).reduce((acc, current) => {
+        if (!(current in translations)) {
+          acc.push(current);
+        }
+        return acc;
+      }, []);
+      if (undefinedTranslationKeys.length) {
+        /* eslint-disable no-console */
+        console.warn(
+          '[@gitlab/ui] The following translations have not been given, so will fall back to their default US English strings:'
+        );
+        console.table(undefinedTranslationKeys);
+        /* eslint-enable no-console */
+      }
+    }
+
+    Object.assign(i18n, translations);
+  }
 };
 
 export default setConfigs;

package/src/scss/utilities.scss

@@ -6435,6 +6435,12 @@
 .gl-mb-8\! {
   margin-bottom: $gl-spacing-scale-8 !important;
 }
+.gl-mb-n8 {
+  margin-bottom: -$gl-spacing-scale-8;
+}
+.gl-mb-n8\! {
+  margin-bottom: -$gl-spacing-scale-8 !important;
+}
 .gl-mb-9 {
   margin-bottom: $gl-spacing-scale-9;
 }

package/src/scss/utility-mixins/spacing.scss

@@ -591,6 +591,10 @@
   margin-bottom: $gl-spacing-scale-8;
 }
 
+@mixin gl-mb-n8 {
+  margin-bottom: -$gl-spacing-scale-8;
+}
+
 @mixin gl-mb-9 {
   margin-bottom: $gl-spacing-scale-9;
 }

package/src/utils/i18n.js

@@ -0,0 +1,10 @@
+import { i18n } from '../config';
+
+/**
+ * Mark a label as translatable.
+ *
+ * @param {string} key Translation key to be leveraged by the consumer to provide a generic translation at configuration time.
+ * @param {string} defaultValue A fallback value to be relied on if the consumer doesn't have translation capabilities.
+ * @returns {string} The translated label.
+ */
+export const translate = (key, defaultValue) => i18n[key] ?? defaultValue;

package/translations.json

@@ -0,0 +1,5 @@
+{
+  "ClearIconButton.title": "Clear",
+  "GlSearchBoxByType.clearButtonTitle": "Clear",
+  "GlSearchBoxByType.input.placeholder": "Search"
+}