popper.js dep

2017-08-16 17:27:59 -05:00
parent f4365053a0
commit 09502153ed
24 changed files with 68 additions and 47 deletions
@@ -22,15 +22,14 @@
    "bower_components",
    "tests"
  ],
-  "version": "1.12.0",
-  "_release": "1.12.0",
+  "version": "1.12.2",
+  "_release": "1.12.2",
  "_resolution": {
    "type": "version",
-    "tag": "v1.12.0",
-    "commit": "786e2f351bb9655c4ac0802e01a96ca7f8f5dbca"
+    "tag": "v1.12.2",
+    "commit": "f0620ae9583bd516dab60dfbfb4379d0d5272e84"
  },
  "_source": "https://github.com/FezVrasta/popper.js.git",
  "_target": "^1.12.0",
-  "_originalSource": "popper.js",
-  "_direct": true
+  "_originalSource": "popper.js"
 }
@@ -73,7 +73,7 @@ Popper.js is available on the following package managers and CDNs:
 | npm    | `npm install popper.js --save`                                                   |
 | yarn   | `yarn add popper.js`                                                             |
 | NuGet  | `PM> Install-Package popper.js`                                                  |
-| Bower* | `bower install popper.js=https://unpkg.com/popper.js --save`                     |
+| Bower  | `bower install popper.js --save`                     |
 | unpkg  | [`https://unpkg.com/popper.js`](https://unpkg.com/popper.js)                     |
 | cdnjs  | [`https://cdnjs.com/libraries/popper.js`](https://cdnjs.com/libraries/popper.js) |

@@ -87,7 +87,18 @@ Tooltip.js as well:
 | unpkg  | [`https://unpkg.com/tooltip.js`](https://unpkg.com/tooltip.js)                   |
 | cdnjs  | [`https://cdnjs.com/libraries/popper.js`](https://cdnjs.com/libraries/popper.js) |

-\*: Bower isn't officially supported, it can be used to install both libraries only trough the unpkg.com CDN. This method has the limitation of not being able to define a specific version of the library. Bower and Popper.js suggests to use npm or Yarn for your projects.
+\*: Bower isn't officially supported, it can be used to install Tooltip.js only trough the unpkg.com CDN. This method has the limitation of not being able to define a specific version of the library. Bower and Popper.js suggests to use npm or Yarn for your projects.  
+For more info, [read the related issue](https://github.com/FezVrasta/popper.js/issues/390).
+
+### Dist targets
+
+Popper.js is currently shipped with 3 targets in mind: UMD, ESM and ESNext.
+
+- UMD - Universal Module Definition: AMD, RequireJS and globals;
+- ESM - ES Modules: For webpack/Rollup or browser supporting the spec;
+- ESNext: Available in `dist/`, can be used with webpack and `babel-preset-env`;
+
+Make sure to use the right one for your needs. If you want to import it with a `<script>` tag, use UMD.

 ## Usage

@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1858,7 +1858,7 @@ function inner(data) {

  var subtractLength = ['top', 'left'].indexOf(basePlacement) === -1;

-  popper[isHoriz ? 'left' : 'top'] = reference[placement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);
+  popper[isHoriz ? 'left' : 'top'] = reference[basePlacement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);

  data.placement = getOppositePlacement(placement);
  data.offsets.popper = getClientRect(popper);
@@ -1936,6 +1936,9 @@ var modifiers = {
   * '10 - 5vh + 3%'
   * '-10px + 5vh, 5px - 6%'
   * ```
+   * > **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap
+   * > with their reference element, unfortunately, you will have to disable the `flip` modifier.
+   * > More on this [reading this issue](https://github.com/FezVrasta/popper.js/issues/373)
   *
   * @memberof modifiers
   * @inner
@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1741,7 +1741,7 @@ function inner(data) {

  const subtractLength = ['top', 'left'].indexOf(basePlacement) === -1;

-  popper[isHoriz ? 'left' : 'top'] = reference[placement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);
+  popper[isHoriz ? 'left' : 'top'] = reference[basePlacement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);

  data.placement = getOppositePlacement(placement);
  data.offsets.popper = getClientRect(popper);
@@ -1819,6 +1819,9 @@ var modifiers = {
   * '10 - 5vh + 3%'
   * '-10px + 5vh, 5px - 6%'
   * ```
+   * > **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap
+   * > with their reference element, unfortunately, you will have to disable the `flip` modifier.
+   * > More on this [reading this issue](https://github.com/FezVrasta/popper.js/issues/373)
   *
   * @memberof modifiers
   * @inner
@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1,6 +1,6 @@
 /**!
 * @fileOverview Kickass library to create and place poppers near their reference elements.
- * @version 1.12.0
+ * @version 1.12.2
 * @license
 * Copyright (c) 2016 Federico Zivolo and contributors
 *
@@ -1864,7 +1864,7 @@ function inner(data) {

  var subtractLength = ['top', 'left'].indexOf(basePlacement) === -1;

-  popper[isHoriz ? 'left' : 'top'] = reference[placement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);
+  popper[isHoriz ? 'left' : 'top'] = reference[basePlacement] - (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);

  data.placement = getOppositePlacement(placement);
  data.offsets.popper = getClientRect(popper);
@@ -1942,6 +1942,9 @@ var modifiers = {
   * '10 - 5vh + 3%'
   * '-10px + 5vh, 5px - 6%'
   * ```
+   * > **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap
+   * > with their reference element, unfortunately, you will have to disable the `flip` modifier.
+   * > More on this [reading this issue](https://github.com/FezVrasta/popper.js/issues/373)
   *
   * @memberof modifiers
   * @inner
@@ -48,10 +48,10 @@ make sure they are performant enough to avoid performance bottlenecks.</p>
 ## Typedefs

 <dl>
-<dt><a href="#onCreate">onCreate</a> : <code>function</code></dt>
-<dd></dd>
 <dt><a href="#onUpdate">onUpdate</a> : <code>function</code></dt>
 <dd></dd>
+<dt><a href="#onCreate">onCreate</a> : <code>function</code></dt>
+<dd></dd>
 </dl>

 <a name="Popper"></a>
@@ -274,6 +274,7 @@ this object get passed to modifiers and to the `onCreate` and `onUpdate` callbac
 | data.hide | <code>Boolean</code> | True if the reference element is out of boundaries, useful to know when to hide the popper. |
 | data.arrowElement | <code>HTMLElement</code> | Node used as arrow by arrow modifier |
 | data.styles | <code>Object</code> | Any CSS property defined here will be applied to the popper, it expects the JavaScript nomenclature (eg. `marginBottom`) |
+| data.arrowStyles | <code>Object</code> | Any CSS property defined here will be applied to the popper arrow, it expects the JavaScript nomenclature (eg. `marginBottom`) |
 | data.boundaries | <code>Object</code> | Offsets of the popper boundaries |
 | data.offsets | <code>Object</code> | The measurements of popper, reference and arrow elements. |
 | data.offsets.popper | <code>Object</code> | `top`, `left`, `width`, `height` values |
@@ -448,6 +449,9 @@ Valid examples are:
 '10 - 5vh + 3%'
 '-10px + 5vh, 5px - 6%'
 ```
+> **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap
+> with their reference element, unfortunately, you will have to disable the `flip` modifier.
+> More on this [reading this issue](https://github.com/FezVrasta/popper.js/issues/373)

 **Kind**: inner property of [<code>modifiers</code>](#modifiers)  

@@ -1034,15 +1038,6 @@ make sure they are performant enough to avoid performance bottlenecks.
 | data | [<code>dataObject</code>](#dataObject) | The data object generated by `update` method |
 | options | <code>Object</code> | Modifiers configuration and options |

-<a name="onCreate"></a>
-
-## onCreate : <code>function</code>
-**Kind**: global typedef  
-
-| Param | Type |
-| --- | --- |
-| data | [<code>dataObject</code>](#dataObject) | 
-
 <a name="onUpdate"></a>

 ## onUpdate : <code>function</code>
@@ -1052,3 +1047,12 @@ make sure they are performant enough to avoid performance bottlenecks.
 | --- | --- |
 | data | [<code>dataObject</code>](#dataObject) | 

+<a name="onCreate"></a>
+
+## onCreate : <code>function</code>
+**Kind**: global typedef  
+
+| Param | Type |
+| --- | --- |
+| data | [<code>dataObject</code>](#dataObject) | 
+
@@ -5,7 +5,6 @@
  ],
  "version": "0.0.0",
  "npmClient": "npm",
-  "useWorkspaces": false,
  "commands": {
    "run": {
      "ignore": "\\@popperjs/*"
@@ -44,8 +44,5 @@
      "threshold": "2 Kb"
    }
  ],
-  "dependencies": {},
-  "workspaces": [
-    "packages/*"
-  ]
+  "dependencies": {}
 }
@@ -8,8 +8,7 @@ git add -f ../../dist/*
 git add ../../bower.json
 git commit --no-verify -m "chore(automatic): v${version} (dist files)"
 git tag -a v${version} -m "chore(automatic): v${version} (tag release)"
-rm -rf ../../dist
-rm -f ../../bower.json
 git rm ../../dist/**/*
+git rm ../../dist/*
 git rm ../../bower.json
 git commit --no-verify -m "chore(automatic): v${version} (dist files cleanup)"
@@ -1,6 +1,6 @@
 {
  "name": "popper.js",
-  "version": "1.12.0",
+  "version": "1.12.2",
  "description": "A kickass library to manage your poppers",
  "homepage": "https://popper.js.org",
  "repository": {
@@ -41,7 +41,7 @@
  "devDependencies": {
    "@popperjs/bundle": "^1.0.2",
    "@popperjs/eslint-config-popper": "^1.0.0",
-    "nuget-publish": "^1.0.0",
+    "nuget-publish": "^1.0.1",
    "@popperjs/test": "^1.0.0",
    "@popperjs/test-utils": "^1.0.0",
    "eslint": "^4.1.1"
@@ -79,6 +79,9 @@ export default {
   * '10 - 5vh + 3%'
   * '-10px + 5vh, 5px - 6%'
   * ```
+   * > **NB**: If you desire to apply offsets to your poppers in a way that may make them overlap
+   * > with their reference element, unfortunately, you will have to disable the `flip` modifier.
+   * > More on this [reading this issue](https://github.com/FezVrasta/popper.js/issues/373)
   *
   * @memberof modifiers
   * @inner
@@ -17,7 +17,7 @@ export default function inner(data) {
  const subtractLength = ['top', 'left'].indexOf(basePlacement) === -1;

  popper[isHoriz ? 'left' : 'top'] =
-    reference[placement] -
+    reference[basePlacement] -
    (subtractLength ? popper[isHoriz ? 'width' : 'height'] : 0);

  data.placement = getOppositePlacement(placement);