@gitlab/duo-ui 0.1.0 → 0.3.0

package/src/vendor/bootstrap-vue/src/components/toast/helpers/bv-toast.spec.js

@@ -0,0 +1,131 @@
+import { createWrapper, mount } from '@vue/test-utils'
+import { Vue } from '../../../vue'
+import { waitNT, waitRAF } from '../../../../tests/utils'
+import { ToastPlugin } from '../index'
+
+Vue.use(ToastPlugin)
+
+describe('$bvToast', () => {
+  it('$bvToast.show() and $bvToast.hide() works', async () => {
+    const App = {
+      render(h) {
+        return h(
+          'b-toast',
+          {
+            props: {
+              id: 'test1',
+              static: true,
+              visible: false,
+              noAutoHide: true
+            }
+          },
+          'content'
+        )
+      }
+    }
+    const wrapper = mount(App, {
+      attachTo: document.body
+    })
+
+    expect(wrapper.vm).toBeDefined()
+
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+
+    expect(wrapper.vm.$bvToast).toBeDefined()
+    expect(wrapper.vm.$bvToast.show).toBeDefined()
+    expect(typeof wrapper.vm.$bvToast.show).toEqual('function')
+    expect(wrapper.vm.$bvToast.hide).toBeDefined()
+    expect(typeof wrapper.vm.$bvToast.hide).toEqual('function')
+
+    expect(wrapper.find('.toast').exists()).toBe(false)
+
+    wrapper.vm.$bvToast.show('test1')
+
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+
+    expect(wrapper.find('.toast').exists()).toBe(true)
+
+    wrapper.vm.$bvToast.hide('test1')
+
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+
+    expect(wrapper.find('.toast').exists()).toBe(false)
+
+    wrapper.destroy()
+  })
+
+  it('$bvModal.toast() works', async () => {
+    const App = {
+      render(h) {
+        return h('div', 'app')
+      }
+    }
+    const wrapper = mount(App, {
+      attachTo: document.body
+    })
+
+    expect(wrapper.vm).toBeDefined()
+
+    // `$bvModal.toast`
+    expect(wrapper.vm.$bvToast).toBeDefined()
+    const bvToast = wrapper.vm.$bvToast
+    expect(bvToast.toast).toBeDefined()
+    expect(typeof bvToast.toast).toEqual('function')
+
+    // Trigger a toast
+    bvToast.toast('message', {
+      id: 'test2',
+      title: 'title',
+      noAutoHide: true
+    })
+
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+    await waitNT(wrapper.vm)
+    await waitRAF()
+
+    // Find the toast
+    const toast = document.querySelector('#test2')
+    expect(toast).toBeDefined()
+    expect(toast).not.toEqual(null)
+    const $toast = createWrapper(toast)
+    expect($toast.element.tagName).toBe('DIV')
+
+    // Find  header
+    expect($toast.find('.toast-header').exists()).toBe(true)
+    expect($toast.find('.toast-header').text()).toContain('title')
+
+    // Find body
+    expect($toast.find('.toast-body').exists()).toBe(true)
+    expect($toast.find('.toast-body').text()).toContain('message')
+
+    // Find the Close button and click it
+    expect($toast.findAll('button').length).toBe(1)
+    const $button = $toast.find('button')
+    expect($button.classes()).toContain('close')
+
+    await $button.trigger('click')
+    await waitRAF()
+    await waitRAF()
+    await waitRAF()
+    await waitRAF()
+
+    // Toast should be gone from DOM
+    expect(document.querySelector('#test2')).toBe(null)
+  })
+})

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

@@ -0,0 +1,70 @@
+//
+// Toast
+//
+import Vue, { VNode } from 'vue'
+import { BvPlugin, BvComponent } from '../../'
+
+// Toast Plugin
+export declare const ToastPlugin: BvPlugin
+
+// Component: b-toast
+export declare class BToast extends BvComponent {
+  show: () => void
+  hide: () => void
+}
+
+// Component: b-toaster
+export declare class BToaster extends BvComponent {}
+
+//
+// Interfaces
+//
+export interface BvToastOptions {
+  // Commonly used props
+  toaster?: string
+  title?: string | VNode | Array<VNode>
+  variant?: string
+  solid?: boolean
+  noAutoHide?: boolean
+  noHoverPause?: boolean
+  autoHideDelay?: number
+  noCloseButton?: boolean
+  appendToast?: boolean
+  isStatus?: boolean
+  noFade?: boolean
+  toastClass?: string | string[] | Array<any> | object | any
+  headerClass?: string | string[] | Array<any> | object | any
+  bodyClass?: string | string[] | Array<any> | object | any
+  href?: string
+  to?: string | object | any
+  // Catch all
+  [key: string]: any
+}
+
+export interface BvToastShortcutMethod {
+  (message: string | VNode | Array<VNode>, options?: BvToastOptions): void
+  // Future
+  // (options?: BvToastOptions): void
+  // (message: string | VNode | Array<VNode>, title: string | VNode | Array<VNode>, options?: BvToastOptions): void
+}
+
+export interface BvToast {
+  // Show a toast
+  toast: BvToastShortcutMethod
+
+  // Show a toast by id
+  show: (id: string) => void
+
+  // Hide a toast by id (or hide all tosts)
+  hide: (id?: string) => void
+}
+
+//
+// Vue Prototype Injections
+//
+declare module 'vue/types/vue' {
+  interface Vue {
+    // Toast injection
+    readonly $bvToast: BvToast
+  }
+}

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

@@ -0,0 +1,188 @@
+{
+  "name": "@bootstrap-vue/toast",
+  "version": "1.0.0",
+  "meta": {
+    "title": "Toast",
+    "slug": "toast",
+    "description": "Push notifications to your visitors with a toast, a lightweight and easily customizable alert message.",
+    "plugins": [
+      "BVToastPlugin"
+    ],
+    "components": [
+      {
+        "component": "BToast",
+        "props": [
+          {
+            "prop": "appendToast",
+            "description": "When true, the toast will be appended to the bottom on the visible toasts, otherwise it will be prepended"
+          },
+          {
+            "prop": "autoHideDelay",
+            "description": "The number of milliseconds before the toast auto dismisses itself"
+          },
+          {
+            "prop": "bodyClass",
+            "description": "CSS class (or classes) to add to the toast body element"
+          },
+          {
+            "prop": "headerClass",
+            "description": "CSS class (or classes) to add to the toast header element"
+          },
+          {
+            "prop": "headerTag",
+            "version": "2.22.0",
+            "description": "Specify the HTML tag to render instead of the default tag for the footer"
+          },
+          {
+            "prop": "isStatus",
+            "description": "When set to 'true', makes the toast have attributes aria-live=polite and role=status. When 'false' aria-live will be 'assertive' and role will be 'alert'"
+          },
+          {
+            "prop": "noAutoHide",
+            "description": "When set, disabled the toast from automatically dismissing itself"
+          },
+          {
+            "prop": "noCloseButton",
+            "description": "When set, hides the close button in the toast header"
+          },
+          {
+            "prop": "noHoverPause",
+            "description": "When set, disables the pausing of the auto hide delay when the mouse hovers the toast"
+          },
+          {
+            "prop": "solid",
+            "description": "When set, renderes the toast with a solid background rather than translucent"
+          },
+          {
+            "prop": "title",
+            "description": "The toast's title text"
+          },
+          {
+            "prop": "toastClass",
+            "description": "CSS class (or classes) to add to the toast wrapper element"
+          },
+          {
+            "prop": "toaster",
+            "description": "The name of the toaster target to render the toast in"
+          },
+          {
+            "prop": "variant",
+            "description": "Applies one of the Bootstrap theme color variants to the component"
+          },
+          {
+            "prop": "visible",
+            "description": "When true, shows the toast"
+          }
+        ],
+        "events": [
+          {
+            "event": "change",
+            "description": "Toast visibility state. Used to update the v-model",
+            "args": [
+              {
+                "arg": "visible",
+                "type": "Boolean",
+                "description": "`true` if toast is visible, `false` otherwise"
+              }
+            ]
+          },
+          {
+            "event": "hidden",
+            "description": "Always emits after toast is hidden",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "hide",
+            "description": "Always emits just before toast has hidden",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "show",
+            "description": "Always emits just before toast is shown",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          },
+          {
+            "event": "shown",
+            "description": "Always emits when toast is shown",
+            "args": [
+              {
+                "arg": "bvEvent",
+                "type": "BvEvent",
+                "description": "BvEvent object"
+              }
+            ]
+          }
+        ],
+        "slots": [
+          {
+            "name": "default",
+            "description": "Toast body content. Optionally scoped",
+            "scope": [
+              {
+                "prop": "hide",
+                "type": "Function",
+                "description": "Hides the toast when called. Useful if you are providing your own close button"
+              }
+            ]
+          },
+          {
+            "name": "toast-title",
+            "description": "Toast title. Optionally scoped",
+            "scope": [
+              {
+                "prop": "hide",
+                "type": "Function",
+                "description": "Hides the toast when called. Useful if you are providing your own close button"
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "component": "BToaster",
+        "props": [
+          {
+            "prop": "ariaAtomic",
+            "description": "When screen reader's should read out the entire contents (set to string 'true') or just the changes (set to string 'false'). Leave blank for most cases"
+          },
+          {
+            "prop": "ariaLive",
+            "description": "When the rendered element is an aria-live region (for screen reader users), set to either 'polite' or 'assertive'"
+          },
+          {
+            "prop": "name",
+            "description": "The toaster's target name"
+          },
+          {
+            "prop": "role",
+            "description": "Sets the ARIA attribute 'role' to a specific value"
+          }
+        ],
+        "slots": [
+          {
+            "name": "default",
+            "description": "Content (toasts) to place in the toaster element"
+          }
+        ]
+      }
+    ]
+  }
+}