@gitlab/duo-ui 0.1.0 → 0.3.0

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

@@ -0,0 +1,7 @@
+//
+// Popover
+//
+import { BvComponent } from '../../'
+
+// Component: b-popover
+export declare class BPopover extends BvComponent {}

package/src/vendor/bootstrap-vue/src/components/popover/package.json

@@ -0,0 +1,261 @@
+{
+  "name": "@bootstrap-vue/popover",
+  "version": "1.0.0",
+  "meta": {
+    "title": "Popover",
+    "description": "The Popover feature provides a tooltip-like behavior, can be easily applied to any interactive element via the <b-popover> component.",
+    "components": [
+      {
+        "component": "BPopover",
+        "props": [
+          {
+            "prop": "boundary",
+            "description": "The boundary constraint of the popover: 'scrollParent', 'window', 'viewport', or a reference to an HTMLElement or component"
+          },
+          {
+            "prop": "boundaryPadding",
+            "description": "The popover will try and stay away from the edge of the boundary element by the number of pixels specified"
+          },
+          {
+            "prop": "container",
+            "description": "The container element to append the rendered popover when visible. Default's to the body element"
+          },
+          {
+            "prop": "content",
+            "description": "Text to place in the body of the popover"
+          },
+          {
+            "prop": "customClass",
+            "description": "CSS class (or classes) to apply to the popover's root element"
+          },
+          {
+            "prop": "delay",
+            "description": "Value for the show and hide delay. Applies to both show and hide when specified as a number or string. Use object form to set show and hide delays individually"
+          },
+          {
+            "prop": "fallbackPlacement",
+            "description": "Placement to use when the popover would be out of boundaries. Refer to the docs for more details"
+          },
+          {
+            "prop": "offset",
+            "description": "Offset (in pixels) for the arrow center compared to the trigger target element"
+          },
+          {
+            "prop": "placement",
+            "description": "Placement of the popover: One of 'top', 'bottom', 'right', 'left', 'topleft', 'topright', 'bottomleft', 'bottomright', 'lefttop', 'leftbottom', 'righttop', 'rightbottom'"
+          },
+          {
+            "prop": "show",
+            "description": "When set will show the popover"
+          },
+          {
+            "prop": "target",
+            "description": "Element string ID, or a reference to an element or component, that you want to trigger the popover"
+          },
+          {
+            "prop": "title",
+            "description": "Text to place in the popovers title"
+          },
+          {
+            "prop": "triggers",
+            "description": "Specify which triggers will show the popover. Supported values are 'click', 'hover', 'focus'. Refer to the docs for special triggers 'blur' and 'manual'"
+          },
+          {
+            "prop": "variant",
+            "description": "Applies one of the Bootstrap theme color variants to the component"
+          }
+        ],
+        "events": [
+          {
+            "event": "bv::popover::disabled",
+            "description": "Emitted on $root when popover becomes disabled",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "bv::popover::enabled",
+            "description": "Emitted on $root when popover becomes enabled",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "bv::popover::hidden",
+            "description": "Emitted on $root when popover is hidden",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "bv::popover::hide",
+            "description": "Emitted on $root when popover is about to be hidden. Cancelable. Call bvEvent.preventDefault() to cancel hide",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "bv::popover::show",
+            "description": "Emitted on $root when popover is about to be shown. Cancelable. Call bvEvent.preventDefault() to cancel show",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "bv::popover::shown",
+            "description": "Emitted on $root when popover is shown",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "disabled",
+            "description": "Emitted when popover becomes disabled",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "enabled",
+            "description": "Emitted when popover becomes enabled",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "hidden",
+            "description": "Emitted when popover is hidden",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "hide",
+            "description": "Emitted when popover is about to be hidden. Cancelable. Call bvEvent.preventDefault() to cancel hide",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "show",
+            "description": "Emitted when popover is about to be shown. Cancelable. Call bvEvent.preventDefault() to cancel show",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "shown",
+            "description": "Emitted when popover is shown",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          }
+        ],
+        "rootEventListeners": [
+          {
+            "event": "bv::disable::popover",
+            "description": "Disable all or a specific popover when this event is emitted on $root",
+            "args": [
+              {
+                "arg": "id",
+                "type": "String",
+                "description": "Popover ID to disable (optional)"
+              }
+            ]
+          },
+          {
+            "event": "bv::enable::popover",
+            "description": "Enable all or a specific popover when this event is emitted on $root",
+            "args": [
+              {
+                "arg": "id",
+                "type": "String",
+                "description": "Popover ID to enable (optional)"
+              }
+            ]
+          },
+          {
+            "event": "bv::hide::popover",
+            "description": "Close (hide) all or a specific open popover when this event is emitted on $root",
+            "args": [
+              {
+                "arg": "id",
+                "type": "String",
+                "description": "Popover ID to hide (optional)"
+              }
+            ]
+          },
+          {
+            "event": "bv::show::popover",
+            "description": "Open (show) all or a specific popover when this event is emitted on $root",
+            "args": [
+              {
+                "arg": "id",
+                "type": "String",
+                "description": "Popover ID to show (optional)"
+              }
+            ]
+          }
+        ],
+        "slots": [
+          {
+            "name": "default",
+            "description": "Slot for content (HTML/components supported)"
+          },
+          {
+            "name": "title",
+            "description": "Optional slot for title (HTML/components supported)"
+          }
+        ]
+      }
+    ]
+  }
+}

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/MODIFICATIONS.md

@@ -0,0 +1,23 @@
+# Modifications to Vendored Code
+
+**Library**: BootstrapVue  
+**Version**: 2.23.1
+
+This file documents modifications made to the original BootstrapVue component files.
+
+## Removed variants
+
+The following files have been modified from the original:
+
+- `README.md`: Removed variants.
+
+The following variants of the property `variant` have been removed as they are no longer supported
+in our implementation:
+
+- `secondary`
+- `info`
+- `light`
+- `dark`
+
+It was not necessary to adapt `.js` files for this change, as the propery `variant` accepts any
+string. It would still be technically possible to pass down one of the removed variants.