@gitlab/ui 84.1.0 → 85.0.0

package/src/vendor/bootstrap-vue/src/components/popover/popover.spec.js

@@ -0,0 +1,199 @@
+import { mount } from '@vue/test-utils'
+import { waitNT, waitRAF } from '../../../tests/utils'
+import { BPopover } from './popover'
+
+// Our test application definition
+const App = {
+  props: [
+    'triggers',
+    'show',
+    'disabled',
+    'noFade',
+    'title',
+    'titleAttr',
+    'btnDisabled',
+    'variant',
+    'customClass'
+  ],
+  render(h) {
+    return h('article', { attrs: { id: 'wrapper' } }, [
+      h(
+        'button',
+        {
+          attrs: {
+            id: 'foo',
+            type: 'button',
+            disabled: this.btnDisabled || null,
+            title: this.titleAttr || null
+          }
+        },
+        'text'
+      ),
+      h(
+        BPopover,
+        {
+          attrs: {
+            id: 'bar',
+            'data-foo': 'bar'
+          },
+          props: {
+            target: 'foo',
+            triggers: this.triggers,
+            show: this.show,
+            disabled: this.disabled,
+            noFade: this.noFade || false,
+            variant: this.variant,
+            customClass: this.customClass
+          }
+        },
+        [h('template', { slot: 'title' }, this.$slots.title), this.$slots.default || '']
+      )
+    ])
+  }
+}
+
+// The majority of functionality has been tested in the tooltip component tests
+// as popover shares a common mixin with tooltip
+// So we just test a few key differences
+
+// Note: `wrapper.destroy()` MUST be called at the end of each test in order for
+// the next test to function properly!
+describe('b-popover', () => {
+  const originalCreateRange = document.createRange
+  const origGetBCR = Element.prototype.getBoundingClientRect
+
+  beforeEach(() => {
+    // https://github.com/FezVrasta/popper.js/issues/478#issuecomment-407422016
+    // Hack to make Popper not bork out during tests
+    // Note popper still does not do any positioning calculation in JSDOM though
+    // So we cannot test actual positioning, just detect when it is open
+    document.createRange = () => ({
+      setStart: () => {},
+      setEnd: () => {},
+      commonAncestorContainer: {
+        nodeName: 'BODY',
+        ownerDocument: document
+      }
+    })
+    // Mock `getBoundingClientRect()` so that the `isVisible(el)` test returns `true`
+    // Needed for visibility checks of trigger element, etc
+    Element.prototype.getBoundingClientRect = jest.fn(() => ({
+      width: 24,
+      height: 24,
+      top: 0,
+      left: 0,
+      bottom: 0,
+      right: 0
+    }))
+  })
+
+  afterEach(async () => {
+    // Reset overrides
+    document.createRange = originalCreateRange
+    Element.prototype.getBoundingClientRect = origGetBCR
+    await waitRAF()
+  })
+
+  it('has expected default structure', async () => {
+    const wrapper = mount(App, {
+      attachTo: document.body,
+      propsData: {
+        triggers: 'click'
+      },
+      slots: {
+        title: 'title',
+        default: 'content'
+      }
+    })
+
+    expect(wrapper.vm).toBeDefined()
+    await waitNT(wrapper.vm)
+
+    expect(wrapper.element.tagName).toBe('ARTICLE')
+    expect(wrapper.attributes('id')).toBeDefined()
+    expect(wrapper.attributes('id')).toEqual('wrapper')
+
+    // The trigger button
+    const $button = wrapper.find('button')
+    expect($button.exists()).toBe(true)
+    expect($button.attributes('id')).toBeDefined()
+    expect($button.attributes('id')).toEqual('foo')
+    expect($button.attributes('aria-describedby')).toBeUndefined()
+
+    // <b-popover> wrapper
+    const $tipHolder = wrapper.findComponent(BPopover)
+    expect($tipHolder.exists()).toBe(true)
+    expect($tipHolder.element.nodeType).toEqual(Node.COMMENT_NODE)
+
+    wrapper.destroy()
+  })
+
+  it('initially open has expected structure', async () => {
+    jest.useFakeTimers()
+    const wrapper = mount(App, {
+      attachTo: document.body,
+      propsData: {
+        triggers: 'click',
+        show: true
+      },
+      slots: {
+        title: 'title',
+        default: 'content'
+      }
+    })
+
+    expect(wrapper.vm).toBeDefined()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    jest.runOnlyPendingTimers()
+    await waitNT(wrapper.vm)
+
+    expect(wrapper.element.tagName).toBe('ARTICLE')
+    expect(wrapper.attributes('id')).toBeDefined()
+    expect(wrapper.attributes('id')).toEqual('wrapper')
+
+    // The trigger button
+    const $button = wrapper.find('button')
+    expect($button.exists()).toBe(true)
+    expect($button.attributes('id')).toBeDefined()
+    expect($button.attributes('id')).toEqual('foo')
+    expect($button.attributes('data-original-title')).toBeUndefined()
+    // ID of the tooltip that will be in the body
+    const $adb = $button.attributes('aria-describedby')
+
+    // <b-popover> wrapper
+    const $tipHolder = wrapper.findComponent(BPopover)
+    expect($tipHolder.exists()).toBe(true)
+    expect($tipHolder.element.nodeType).toEqual(Node.COMMENT_NODE)
+
+    // Find the popover element in the document
+    const $tip = document.getElementById($adb)
+    expect($tip).not.toBe(null)
+    expect($tip).toBeInstanceOf(HTMLElement)
+    expect($tip.tagName).toEqual('DIV')
+    expect($tip.getAttribute('id')).toEqual('bar')
+    expect($tip.getAttribute('data-foo')).toEqual('bar')
+    expect($tip.classList.contains('popover')).toBe(true)
+    expect($tip.classList.contains('b-popover')).toBe(true)
+
+    // Hide the Popover
+    await wrapper.setProps({
+      show: false
+    })
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    jest.runOnlyPendingTimers()
+
+    expect($button.attributes('aria-describedby')).toBeUndefined()
+
+    // Popover element should not be in the document
+    expect(document.body.contains($tip)).toBe(false)
+    expect(document.getElementById($adb)).toBe(null)
+
+    wrapper.destroy()
+  })
+})

package/src/vendor/bootstrap-vue/src/components/progress/README.md

@@ -0,0 +1,376 @@
+# Progress
+
+> Use our custom progress component for displaying simple or complex progress bars, featuring
+> support for horizontally stacked bars, animated backgrounds, and text labels.
+
+```html
+<template>
+  <div>
+    <b-progress :value="value" :max="max" show-progress animated></b-progress>
+    <b-progress class="mt-2" :max="max" show-value>
+      <b-progress-bar :value="value * (6 / 10)" variant="success"></b-progress-bar>
+      <b-progress-bar :value="value * (2.5 / 10)" variant="warning"></b-progress-bar>
+      <b-progress-bar :value="value * (1.5 / 10)" variant="danger"></b-progress-bar>
+    </b-progress>
+
+    <b-button class="mt-3" @click="randomValue">Click me</b-button>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        value: 45,
+        max: 100
+      }
+    },
+    methods: {
+      randomValue() {
+        this.value = Math.random() * this.max
+      }
+    }
+  }
+</script>
+
+<!-- b-progress.vue -->
+```
+
+## Value
+
+Set the maximum value with the `max` prop (default is `100`), and the current value via the `value`
+prop (default `0`).
+
+When creating multiple bars in a single process, place the value prop on the individual
+`<b-progress-bar>` sub components (see the **Multiple Bars** section below for more details)
+
+## Labels
+
+Add labels to your progress bars by either enabling `show-progress` (percentage of max) or
+`show-value`for the current absolute value. You may also set the precision (number of digits after
+the decimal) via the `precision` prop (default is `0`digits after the decimal).
+
+```html
+<template>
+  <div>
+    <h5>No label</h5>
+    <b-progress :value="value" :max="max" class="mb-3"></b-progress>
+
+    <h5>Value label</h5>
+    <b-progress :value="value" :max="max" show-value class="mb-3"></b-progress>
+
+    <h5>Progress label</h5>
+    <b-progress :value="value" :max="max" show-progress class="mb-3"></b-progress>
+
+    <h5>Value label with precision</h5>
+    <b-progress :value="value" :max="max" :precision="2" show-value class="mb-3"></b-progress>
+
+    <h5>Progress label with precision</h5>
+    <b-progress :value="value" :max="max" :precision="2" show-progress class="mb-3"></b-progress>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        value: 33.333333333,
+        max: 50
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-labels.vue -->
+```
+
+### Custom progress label
+
+Need more control over the label? Provide your own label by using the default slot within a
+`<b-progress-bar>` sub-component, or by using the `label` or `label-html` property on
+`<b-progress-bar>`:
+
+```html
+<template>
+  <div>
+    <h5>Custom label via default slot</h5>
+    <b-progress :max="max" height="2rem">
+      <b-progress-bar :value="value">
+        <span>Progress: <strong>{{ value.toFixed(2) }} / {{ max }}</strong></span>
+      </b-progress-bar>
+    </b-progress>
+
+    <h5 class="mt-3">Custom label via property</h5>
+    <b-progress :max="max">
+      <b-progress-bar :value="value" :label="`${((value / max) * 100).toFixed(2)}%`"></b-progress-bar>
+    </b-progress>
+
+    <h5 class="mt-3">Custom label via property (HTML support)</h5>
+    <b-progress :max="max">
+      <b-progress-bar :value="value" :label-html="`<del>${value}</del>`"></b-progress-bar>
+    </b-progress>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        value: 33.333333333,
+        max: 50
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-custom-labels.vue -->
+```
+
+Precedence order for label methods (top-most has precedence):
+
+- default slot of `<b-progress-bar>`
+- `label` prop of `<b-progress-bar>`
+- `show-progress` prop of `<b-progress-bar>`
+- `show-value` prop of `<b-progress-bar>`
+- `show-progress` prop of `<b-progress>`
+- `show-value` prop of `<b-progress>`
+- no label
+
+## Width and height
+
+`<b-progress>` will always expand to the maximum with of its parent container. To change the width,
+place `<b-progress>` in a standard Bootstrap column or apply one of the standard Bootstrap width
+classes.
+
+```html
+<template>
+  <div>
+    <h5>Default width</h5>
+    <b-progress :value="value" class="mb-3"></b-progress>
+
+    <h5>Custom widths</h5>
+    <b-progress :value="value" class="w-75 mb-2"></b-progress>
+    <b-progress :value="value" class="w-50 mb-2"></b-progress>
+    <b-progress :value="value" class="w-25"></b-progress>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        value: 75
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-width.vue -->
+```
+
+The height of the progress bar can be controlled with the `height` prop. The height value should be
+a standard CSS dimension (`px`, `rem`, `em`, etc.). The default height is `1rem`.
+
+```html
+<template>
+  <div>
+    <h5>Default height</h5>
+    <b-progress :value="value" show-progress class="mb-3"></b-progress>
+
+    <h5>Custom heights</h5>
+    <b-progress height="2rem" :value="value" show-progress class="mb-2"></b-progress>
+    <b-progress height="20px" :value="value" show-progress class="mb-2"></b-progress>
+    <b-progress height="2px" :value="value"></b-progress>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        value: 75
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-height.vue -->
+```
+
+## Backgrounds
+
+Use background variants to change the appearance of individual progress bars. The default variant is
+`primary`.
+
+### Solid background variants
+
+```html
+<template>
+  <div>
+    <div v-for="bar in bars" class="row mb-1">
+      <div class="col-sm-2">{{ bar.variant }}:</div>
+      <div class="col-sm-10 pt-1">
+        <b-progress :value="bar.value" :variant="bar.variant" :key="bar.variant"></b-progress>
+      </div>
+    </div>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        bars: [
+          { variant: 'success', value: 75 },
+          { variant: 'info', value: 75 },
+          { variant: 'warning', value: 75 },
+          { variant: 'danger', value: 75 },
+          { variant: 'primary', value: 75 },
+          { variant: 'secondary', value: 75 },
+          { variant: 'dark', value: 75 }
+        ],
+        timer: null
+      }
+    },
+    mounted() {
+      this.timer = setInterval(() => {
+        this.bars.forEach(bar => (bar.value = 25 + Math.random() * 75))
+      }, 2000)
+    },
+    beforeDestroy() {
+      clearInterval(this.timer)
+      this.timer = null
+    }
+  }
+</script>
+
+<!-- b-progress-backgrounds.vue -->
+```
+
+### Striped backgrounds
+
+Set `striped` to apply a stripe via CSS gradient over the progress bar's background variant.
+
+```html
+<template>
+  <div>
+    <b-progress :value="25" variant="success" :striped="striped"></b-progress>
+    <b-progress :value="50" variant="info" :striped="striped" class="mt-2"></b-progress>
+    <b-progress :value="75" variant="warning" :striped="striped" class="mt-2"></b-progress>
+    <b-progress :value="100" variant="danger" :striped="striped" class="mt-2"></b-progress>
+
+    <b-button variant="secondary" @click="striped = !striped" class="mt-3">
+      {{ striped ? 'Remove' : 'Add' }} Striped
+    </b-button>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        striped: true
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-striped.vue -->
+```
+
+### Animated backgrounds
+
+The striped gradient can also be animated by setting the `animated`prop.
+
+```html
+<template>
+  <div>
+    <b-progress :value="25" variant="success" striped :animated="animate"></b-progress>
+    <b-progress :value="50" variant="info" striped :animated="animate" class="mt-2"></b-progress>
+    <b-progress :value="75" variant="warning" striped :animated="animate" class="mt-2"></b-progress>
+    <b-progress :value="100" variant="danger" :animated="animate" class="mt-3"></b-progress>
+
+    <b-button variant="secondary" @click="animate = !animate" class="mt-3">
+      {{ animate ? 'Stop' : 'Start' }} Animation
+    </b-button>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        animate: true
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-animated.vue -->
+```
+
+Notes:
+
+- if `animated` is true, `striped` will automatically be enabled.
+- Animated progress bars don't work in Opera 12 — as they don't support CSS3 animations.
+- The animation effect of this component is dependent on the `prefers-reduced-motion` media query.
+  See the [reduced motion section of our accessibility documentation](/docs/reference/accessibility)
+  for additional details.
+
+## Multiple bars
+
+Include multiple `<b-progress-bar>` sub-components in a `<b-progress>` component to build a
+horizontally stacked set of progress bars.
+
+```html
+<template>
+  <div>
+    <b-progress :max="max" class="mb-3">
+      <b-progress-bar variant="primary" :value="values[0]"></b-progress-bar>
+      <b-progress-bar variant="success" :value="values[1]"></b-progress-bar>
+      <b-progress-bar variant="info" :value="values[2]"></b-progress-bar>
+    </b-progress>
+
+    <b-progress show-progress :max="max" class="mb-3">
+      <b-progress-bar variant="primary" :value="values[0]"></b-progress-bar>
+      <b-progress-bar variant="success" :value="values[1]"></b-progress-bar>
+      <b-progress-bar variant="info" :value="values[2]"></b-progress-bar>
+    </b-progress>
+
+    <b-progress show-value striped :max="max" class="mb-3">
+      <b-progress-bar variant="primary" :value="values[0]"></b-progress-bar>
+      <b-progress-bar variant="success" :value="values[1]"></b-progress-bar>
+      <b-progress-bar variant="info" :value="values[2]"></b-progress-bar>
+    </b-progress>
+
+    <b-progress :max="max">
+      <b-progress-bar variant="primary" :value="values[0]" show-progress></b-progress-bar>
+      <b-progress-bar variant="success" :value="values[1]" animated show-progress></b-progress-bar>
+      <b-progress-bar variant="info" :value="values[2]" striped show-progress></b-progress-bar>
+    </b-progress>
+  </div>
+</template>
+
+<script>
+  export default {
+    data() {
+      return {
+        values: [15, 30, 20],
+        max: 100
+      }
+    }
+  }
+</script>
+
+<!-- b-progress-multiple.vue -->
+```
+
+`<b-progress-bar>` will inherit most of the props from the `<b-progress>` parent component, but you
+can override any of the props by setting them on the `<b-progress-bar>`
+
+Notes:
+
+- `height`, if specified, should always set on the `<b-progress>` component.
+- `<b-progress-bar>` will not inherit `value` from `<b-progress>`.
+
+<!-- Component reference added automatically from component package.json -->

package/src/vendor/bootstrap-vue/src/components/progress/index.d.ts

@@ -0,0 +1,14 @@
+//
+// Progress
+//
+import Vue from 'vue'
+import { BvPlugin, BvComponent } from '../../'
+
+// Plugin
+export declare const ProgressPlugin: BvPlugin
+
+// Component: b-progress
+export declare class BProgress extends BvComponent {}
+
+// Component: b-progress-bar
+export declare class BProgressBar extends BvComponent {}

package/src/vendor/bootstrap-vue/src/components/progress/index.js

@@ -0,0 +1,12 @@
+import { BProgress } from './progress'
+import { BProgressBar } from './progress-bar'
+import { pluginFactory } from '../../utils/plugins'
+
+const ProgressPlugin = /*#__PURE__*/ pluginFactory({
+  components: {
+    BProgress,
+    BProgressBar
+  }
+})
+
+export { ProgressPlugin, BProgress, BProgressBar }