@fortawesome/vue-fontawesome 3.1.0 → 3.1.2

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/) and this project adheres to [Semantic Versioning](http://semver.org/).
 
+## [3.1.2](https://github.com/FortAwesome/vue-fontawesome/releases/tag/3.1.2) - 2025-09-09
+
+### Changed
+
+- Replaced Jest with Vitest as the test runner for unit tests. This will help improve test performance and better aligns
+  with the Vue 3 + Vite ecosystem.
+
+- Updated `FontAwesomeIconProps`:
+  - `flip` now accepts the `boolean` type in addition to `'horizontal' | 'vertical' | 'both'`
+  - `maskId` is now correctly typed as `string`
+
+- Updated `DEVELOPMENT.md` with revised release instructions
+
+---
+
+## [3.1.1](https://github.com/FortAwesome/vue-fontawesome/releases/tag/3.1.1) - 2025-07-24
+
+### Changed
+
+- Removed version checks related to `props.fixedWidth`, `iconProps.title`, and `iconProps.title`.
+
+- The use of `require` to retrieve the version from `@fortawesome/fontawesome-svg-core` for version checks has been
+  removed to help ensure compatibility with ESM builds.
+
+---
+
 ## [3.1.0](https://github.com/FortAwesome/vue-fontawesome/releases/tag/3.1.0) - 2025-07-22
 
 ### Changed

package/index.d.ts

@@ -4,10 +4,10 @@ import { DefineComponent } from 'vue'
 interface FontAwesomeIconProps {
   border?: boolean
   fixedWidth?: boolean
-  flip?: 'horizontal' | 'vertical' | 'both'
+  flip?: 'horizontal' | 'vertical' | 'both' | boolean
   icon: object | Array<string> | string | IconDefinition
   mask?: object | Array<string> | string
-  maskId?: object | Array<string> | string
+  maskId?: string
   listItem?: boolean
   pull?: 'right' | 'left'
   pulse?: boolean

package/index.es.js

@@ -6,9 +6,6 @@ function _arrayLikeToArray(r, a) {
   for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
   return n;
 }
-function _arrayWithHoles(r) {
-  if (Array.isArray(r)) return r;
-}
 function _arrayWithoutHoles(r) {
   if (Array.isArray(r)) return _arrayLikeToArray(r);
 }
@@ -23,36 +20,6 @@ function _defineProperty(e, r, t) {
 function _iterableToArray(r) {
   if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
 }
-function _iterableToArrayLimit(r, l) {
-  var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
-  if (null != t) {
-    var e,
-      n,
-      i,
-      u,
-      a = [],
-      f = !0,
-      o = !1;
-    try {
-      if (i = (t = t.call(r)).next, 0 === l) {
-        if (Object(t) !== t) return;
-        f = !1;
-      } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
-    } catch (r) {
-      o = !0, n = r;
-    } finally {
-      try {
-        if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
-      } finally {
-        if (o) throw n;
-      }
-    }
-    return a;
-  }
-}
-function _nonIterableRest() {
-  throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-}
 function _nonIterableSpread() {
   throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
 }
@@ -97,9 +64,6 @@ function _objectWithoutPropertiesLoose(r, e) {
   }
   return t;
 }
-function _slicedToArray(r, e) {
-  return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
-}
 function _toConsumableArray(r) {
   return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
 }
@@ -134,9 +98,6 @@ function _unsupportedIterableToArray(r, a) {
   }
 }
 
-var ICON_PACKS_STARTING_VERSION = '7.0.0';
-var svgCorePackageJson = require('@fortawesome/fontawesome-svg-core/package.json');
-var SVG_CORE_VERSION = svgCorePackageJson.version;
 function objectWithKey(key, value) {
   return Array.isArray(value) && value.length > 0 || !Array.isArray(value) && value ? _defineProperty({}, key, value) : {};
 }
@@ -161,34 +122,6 @@ function classList(props) {
   });
 }
 
-// check if verion1 is less than version2
-function versionCheckLt(version1, version2) {
-  var _version1$split = version1.split('-'),
-    _version1$split2 = _slicedToArray(_version1$split, 2),
-    v1Base = _version1$split2[0],
-    v1PreRelease = _version1$split2[1];
-  var _version2$split = version2.split('-'),
-    _version2$split2 = _slicedToArray(_version2$split, 2),
-    v2Base = _version2$split2[0],
-    v2PreRelease = _version2$split2[1];
-  var v1Parts = v1Base.split('.').map(Number);
-  var v2Parts = v2Base.split('.').map(Number);
-
-  // Compare version numbers first
-  for (var i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    var v1Part = v1Parts[i] || 0;
-    var v2Part = v2Parts[i] || 0;
-    if (v1Part < v2Part) return true;
-    if (v1Part > v2Part) return false;
-  }
-
-  // If version numbers are equal, compare pre-release identifiers
-  // A version with a pre-release identifier is less than one without
-  if (v1PreRelease && !v2PreRelease) return true;
-  if (!v1PreRelease && v2PreRelease) return false;
-  return false;
-}
-
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
 var humps$1 = {exports: {}};
@@ -598,11 +531,10 @@ var FontAwesomeIcon = defineComponent({
         symbol: props.symbol,
         maskId: props.maskId
       });
-      if (versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION)) {
-        // the title attribute will only apply to versions prior to version 7.0.0
-        iconProps.title = props.title;
-        iconProps.titleId = props.titleId;
-      }
+
+      // the title attribute will only apply to versions prior to version 7.0.0
+      iconProps.title = props.title;
+      iconProps.titleId = props.titleId;
       return icon(icon$1.value, iconProps);
     });
     watch(renderedIcon, function (value) {
@@ -633,7 +565,7 @@ var FontAwesomeLayers = defineComponent({
     var slots = _ref.slots;
     var familyPrefix = config.familyPrefix;
     var className = computed(function () {
-      return ["".concat(familyPrefix, "-layers")].concat(_toConsumableArray(versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION) && props.fixedWidth ? ["".concat(familyPrefix, "-fw")] : []));
+      return ["".concat(familyPrefix, "-layers")].concat(_toConsumableArray(props.fixedWidth ? ["".concat(familyPrefix, "-fw")] : []));
     });
     return function () {
       return h('div', {

package/index.js

@@ -9,9 +9,6 @@
     for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e];
     return n;
   }
-  function _arrayWithHoles(r) {
-    if (Array.isArray(r)) return r;
-  }
   function _arrayWithoutHoles(r) {
     if (Array.isArray(r)) return _arrayLikeToArray(r);
   }
@@ -26,36 +23,6 @@
   function _iterableToArray(r) {
     if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r);
   }
-  function _iterableToArrayLimit(r, l) {
-    var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"];
-    if (null != t) {
-      var e,
-        n,
-        i,
-        u,
-        a = [],
-        f = !0,
-        o = !1;
-      try {
-        if (i = (t = t.call(r)).next, 0 === l) {
-          if (Object(t) !== t) return;
-          f = !1;
-        } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0);
-      } catch (r) {
-        o = !0, n = r;
-      } finally {
-        try {
-          if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return;
-        } finally {
-          if (o) throw n;
-        }
-      }
-      return a;
-    }
-  }
-  function _nonIterableRest() {
-    throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
-  }
   function _nonIterableSpread() {
     throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
   }
@@ -100,9 +67,6 @@
     }
     return t;
   }
-  function _slicedToArray(r, e) {
-    return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest();
-  }
   function _toConsumableArray(r) {
     return _arrayWithoutHoles(r) || _iterableToArray(r) || _unsupportedIterableToArray(r) || _nonIterableSpread();
   }
@@ -137,9 +101,6 @@
     }
   }
 
-  var ICON_PACKS_STARTING_VERSION = '7.0.0';
-  var svgCorePackageJson = require('@fortawesome/fontawesome-svg-core/package.json');
-  var SVG_CORE_VERSION = svgCorePackageJson.version;
   function objectWithKey(key, value) {
     return Array.isArray(value) && value.length > 0 || !Array.isArray(value) && value ? _defineProperty({}, key, value) : {};
   }
@@ -164,34 +125,6 @@
     });
   }
 
-  // check if verion1 is less than version2
-  function versionCheckLt(version1, version2) {
-    var _version1$split = version1.split('-'),
-      _version1$split2 = _slicedToArray(_version1$split, 2),
-      v1Base = _version1$split2[0],
-      v1PreRelease = _version1$split2[1];
-    var _version2$split = version2.split('-'),
-      _version2$split2 = _slicedToArray(_version2$split, 2),
-      v2Base = _version2$split2[0],
-      v2PreRelease = _version2$split2[1];
-    var v1Parts = v1Base.split('.').map(Number);
-    var v2Parts = v2Base.split('.').map(Number);
-
-    // Compare version numbers first
-    for (var i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-      var v1Part = v1Parts[i] || 0;
-      var v2Part = v2Parts[i] || 0;
-      if (v1Part < v2Part) return true;
-      if (v1Part > v2Part) return false;
-    }
-
-    // If version numbers are equal, compare pre-release identifiers
-    // A version with a pre-release identifier is less than one without
-    if (v1PreRelease && !v2PreRelease) return true;
-    if (!v1PreRelease && v2PreRelease) return false;
-    return false;
-  }
-
   var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
   var humps$1 = {exports: {}};
@@ -601,11 +534,10 @@
           symbol: props.symbol,
           maskId: props.maskId
         });
-        if (versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION)) {
-          // the title attribute will only apply to versions prior to version 7.0.0
-          iconProps.title = props.title;
-          iconProps.titleId = props.titleId;
-        }
+
+        // the title attribute will only apply to versions prior to version 7.0.0
+        iconProps.title = props.title;
+        iconProps.titleId = props.titleId;
         return fontawesomeSvgCore.icon(icon.value, iconProps);
       });
       vue.watch(renderedIcon, function (value) {
@@ -636,7 +568,7 @@
       var slots = _ref.slots;
       var familyPrefix = fontawesomeSvgCore.config.familyPrefix;
       var className = vue.computed(function () {
-        return ["".concat(familyPrefix, "-layers")].concat(_toConsumableArray(versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION) && props.fixedWidth ? ["".concat(familyPrefix, "-fw")] : []));
+        return ["".concat(familyPrefix, "-layers")].concat(_toConsumableArray(props.fixedWidth ? ["".concat(familyPrefix, "-fw")] : []));
       });
       return function () {
         return vue.h('div', {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fortawesome/vue-fontawesome",
   "description": "Official Vue component for Font Awesome 7",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "main": "index.js",
   "files": [
     "README.md",
@@ -14,15 +14,6 @@
     "src/components/**.js",
     "src/**.js"
   ],
-  "jest": {
-    "verbose": true,
-    "testEnvironmentOptions": {
-      "customExportConditions": [
-        "node",
-        "node-addons"
-      ]
-    }
-  },
   "module": "index.es.js",
   "jsnext:main": "index.es.js",
   "types": "index.d.ts",
@@ -55,7 +46,7 @@
   "scripts": {
     "build": "rollup -c rollup.config.js",
     "dist": "cross-env NODE_ENV=production npm run build",
-    "test": "jest --silent",
+    "test": "vitest run",
     "prepack": "npm run dist"
   },
   "lint-staged": {
@@ -84,15 +75,14 @@
     "@rollup/plugin-node-resolve": "^13.3.0",
     "@vue/test-utils": "^2.4.6",
     "babel-core": "^7.0.0-bridge.0",
-    "babel-jest": "^28.1.1",
     "concurrently": "^7.2.1",
     "cross-env": "^7.0.3",
     "humps": "^2.0.1",
     "husky": "^8.0.1",
     "install": "^0.13.0",
-    "jest": "^28.1.1",
-    "jest-environment-jsdom": "^28.1.1",
+    "jsdom": "^22.1.0",
     "lint-staged": "^13.0.0",
+    "vitest": "^0.34.4",
     "markdown-toc": "^1.2.0",
     "npm": "^10.2.2",
     "prettier": "^3.0.3",

package/src/components/FontAwesomeIcon.js

@@ -1,6 +1,5 @@
 import { classList, objectWithKey } from '../utils'
 import { computed, defineComponent, watch } from 'vue'
-import { ICON_PACKS_STARTING_VERSION, SVG_CORE_VERSION, versionCheckLt } from '../utils'
 import { icon as faIcon, parse as faParse } from '@fortawesome/fontawesome-svg-core'
 
 import convert from '../converter'
@@ -172,11 +171,9 @@ export default defineComponent({
         maskId: props.maskId
       }
 
-      if (versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION)) {
-        // the title attribute will only apply to versions prior to version 7.0.0
-        iconProps.title = props.title
-        iconProps.titleId = props.titleId
-      }
+      // the title attribute will only apply to versions prior to version 7.0.0
+      iconProps.title = props.title
+      iconProps.titleId = props.titleId
 
       return faIcon(icon.value, iconProps)
     })

package/src/components/FontAwesomeLayers.js

@@ -1,6 +1,5 @@
 import { computed, defineComponent, h } from 'vue'
 import { config } from '@fortawesome/fontawesome-svg-core'
-import { ICON_PACKS_STARTING_VERSION, SVG_CORE_VERSION, versionCheckLt } from '../utils'
 
 export default defineComponent({
   name: 'FontAwesomeLayers',
@@ -15,10 +14,7 @@ export default defineComponent({
   setup(props, { slots }) {
     const { familyPrefix } = config
 
-    const className = computed(() => [
-      `${familyPrefix}-layers`,
-      ...(versionCheckLt(SVG_CORE_VERSION, ICON_PACKS_STARTING_VERSION) && props.fixedWidth ? [`${familyPrefix}-fw`] : [])
-    ])
+    const className = computed(() => [`${familyPrefix}-layers`, ...(props.fixedWidth ? [`${familyPrefix}-fw`] : [])])
 
     return () => h('div', { class: className.value }, slots.default ? slots.default() : [])
   }

package/src/utils.js

@@ -1,9 +1,3 @@
-export const ICON_PACKS_STARTING_VERSION = '7.0.0'
-
-const svgCorePackageJson = require('@fortawesome/fontawesome-svg-core/package.json')
-
-export const SVG_CORE_VERSION = svgCorePackageJson.version
-
 export function objectWithKey(key, value) {
   return (Array.isArray(value) && value.length > 0) || (!Array.isArray(value) && value) ? { [key]: value } : {}
 }
@@ -47,73 +41,3 @@ export function addStaticClass(to, what) {
 
   return val.concat(what).join(' ')
 }
-
-// check if verion1 is less than version2
-export function versionCheckLt(version1, version2) {
-  const [v1Base, v1PreRelease] = version1.split('-')
-  const [v2Base, v2PreRelease] = version2.split('-')
-
-  const v1Parts = v1Base.split('.').map(Number)
-  const v2Parts = v2Base.split('.').map(Number)
-
-  // Compare version numbers first
-  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    const v1Part = v1Parts[i] || 0
-    const v2Part = v2Parts[i] || 0
-
-    if (v1Part < v2Part) return true
-    if (v1Part > v2Part) return false
-  }
-
-  // If version numbers are equal, compare pre-release identifiers
-  // A version with a pre-release identifier is less than one without
-  if (v1PreRelease && !v2PreRelease) return true
-  if (!v1PreRelease && v2PreRelease) return false
-
-  return false
-}
-
-// check if verion1 is greater than or equal to version2
-export function versionCheckGte(version1, version2) {
-  const [v1Base, v1PreRelease] = version1.split('-')
-  const [v2Base, v2PreRelease] = version2.split('-')
-
-  const v1Parts = v1Base.split('.')
-  const v2Parts = v2Base.split('.')
-
-  // Compare version numbers first
-  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    const v1Part = v1Parts[i] || '0'
-    const v2Part = v2Parts[i] || '0'
-
-    // Compare numeric values
-    const v1Num = parseInt(v1Part, 10)
-    const v2Num = parseInt(v2Part, 10)
-
-    if (v1Num !== v2Num) {
-      return v1Num > v2Num
-    }
-  }
-
-  // If numeric values are equal, look for any remaining parts
-  // that would make one version greater than the other
-  for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
-    const v1Part = v1Parts[i] || '0'
-    const v2Part = v2Parts[i] || '0'
-
-    if (v1Part !== v2Part) {
-      // When numeric values are equal but strings differ,
-      // the one without leading zeros is greater
-      if (v1Part.length !== v2Part.length) {
-        return v1Part.length < v2Part.length
-      }
-    }
-  }
-
-  // If version numbers are equal, compare pre-release identifiers
-  // A version with a pre-release identifier is less than one without
-  if (v1PreRelease && !v2PreRelease) return false
-  if (!v1PreRelease && v2PreRelease) return true
-
-  return true
-}