@blackbyte/sugar 1.0.0-beta.28 → 1.0.0-beta.29

package/dist/shared/extension/commonDiscFileExtensions/commonDiscFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from '../commonFileExtensions/commonFileExtensions.js';
+/**
+ * @name            commonDiscFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: iso, dmg, img, bin, cue, nrg, mdf, mds, toast, vcd, cdi, b5t, b6t, bwt, ccd, clone, dao, tao.
+ * Extended formats includes: c2d, cif, fcd, p01, pdi, pxi, xmd, gi, pqi, disc, ratdvd, sdi, xdi, mdx, ashdisk, bif, daa, dao, dvd, fdi, gbi, ima, lcd, md0, md1, md2, ncd, pvm, vcm, vdi, vhd, vmdk, wim, xva.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonDiscFileExtensions()
+ *
+ * @example         js
+ * import { commonDiscFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonDiscFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonDiscFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonDiscFileExtensions/commonDiscFileExtensions.js

@@ -0,0 +1,91 @@
+/**
+ * @name            commonDiscFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: iso, dmg, img, bin, cue, nrg, mdf, mds, toast, vcd, cdi, b5t, b6t, bwt, ccd, clone, dao, tao.
+ * Extended formats includes: c2d, cif, fcd, p01, pdi, pxi, xmd, gi, pqi, disc, ratdvd, sdi, xdi, mdx, ashdisk, bif, daa, dao, dvd, fdi, gbi, ima, lcd, md0, md1, md2, ncd, pvm, vcm, vdi, vhd, vmdk, wim, xva.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonDiscFileExtensions()
+ *
+ * @example         js
+ * import { commonDiscFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonDiscFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonDiscFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'iso',
+        'dmg',
+        'img',
+        'bin',
+        'cue',
+        'nrg',
+        'mdf',
+        'mds',
+        'toast',
+        'vcd',
+        'cdi',
+        'b5t',
+        'b6t',
+        'bwt',
+        'ccd',
+        'clone',
+        'dao',
+        'tao',
+    ];
+    const extended = [
+        'c2d',
+        'cif',
+        'fcd',
+        'p01',
+        'pdi',
+        'pxi',
+        'xmd',
+        'gi',
+        'pqi',
+        'disc',
+        'ratdvd',
+        'sdi',
+        'xdi',
+        'mdx',
+        'ashdisc',
+        'bif',
+        'daa',
+        'dao',
+        'dvd',
+        'fdi',
+        'gbi',
+        'ima',
+        'lcd',
+        'md0',
+        'md1',
+        'md2',
+        'ncd',
+        'pvm',
+        'vcm',
+        'vdi',
+        'vhd',
+        'vmdk',
+        'wim',
+        'xva',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonDiscFileExtensions.js.map

package/dist/shared/extension/commonDiscFileExtensions/commonDiscFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonDiscFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonDiscFileExtensions/commonDiscFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,KAAK;QACL,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,QAAQ;QACR,KAAK;QACL,KAAK;QACL,KAAK;QACL,SAAS;QACT,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/shared/extension/commonEmailFileExtensions/commonEmailFileExtensions.d.ts

@@ -0,0 +1,29 @@
+import { type TCommonFileExtensionsSettings } from '../commonFileExtensions/commonFileExtensions.js';
+/**
+ * @name            commonEmailFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: eml, msg, pst, ost, oft, vcf, mbox, emlx, dbx.
+ * Extended formats includes: email, emix, mbx, tbb, wab, contact, group, p7m, p7s, smime, winmail.dat, tnef, vcs, vcard, ldif, nws, fol, pmm, pmr, pmi, mmf, msf, snm, bms, ims, mbg, arc, pab, oab, nk2, pip.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included * *
+ * @snippet         commonEmailFileExtensions()
+ *
+ * @example         js
+ * import { commonEmailFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonEmailFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonEmailFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonEmailFileExtensions/commonEmailFileExtensions.js

@@ -0,0 +1,78 @@
+/**
+ * @name            commonEmailFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: eml, msg, pst, ost, oft, vcf, mbox, emlx, dbx.
+ * Extended formats includes: email, emix, mbx, tbb, wab, contact, group, p7m, p7s, smime, winmail.dat, tnef, vcs, vcard, ldif, nws, fol, pmm, pmr, pmi, mmf, msf, snm, bms, ims, mbg, arc, pab, oab, nk2, pip.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included * *
+ * @snippet         commonEmailFileExtensions()
+ *
+ * @example         js
+ * import { commonEmailFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonEmailFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonEmailFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [] }, settings);
+    const commons = [
+        'eml',
+        'msg',
+        'pst',
+        'ost',
+        'oft',
+        'vcf',
+        'mbox',
+        'emlx',
+        'dbx',
+    ];
+    const extended = [
+        'email',
+        'emix',
+        'mbx',
+        'tbb',
+        'wab',
+        'contact',
+        'group',
+        'p7m',
+        'p7s',
+        'smime',
+        'winmail.dat',
+        'tnef',
+        'vcs',
+        'vcard',
+        'ldif',
+        'nws',
+        'fol',
+        'pmm',
+        'pmr',
+        'pmi',
+        'mmf',
+        'msf',
+        'snm',
+        'bms',
+        'ims',
+        'mbg',
+        'arc',
+        'pab',
+        'oab',
+        'nk2',
+        'pip',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonEmailFileExtensions.js.map

package/dist/shared/extension/commonEmailFileExtensions/commonEmailFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonEmailFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonEmailFileExtensions/commonEmailFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,IACR,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,OAAO;QACP,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,SAAS;QACT,OAAO;QACP,KAAK;QACL,KAAK;QACL,OAAO;QACP,aAAa;QACb,MAAM;QACN,KAAK;QACL,OAAO;QACP,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/shared/extension/commonExecutableFileExtensions/commonExecutableFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from '../commonFileExtensions/commonFileExtensions.js';
+/**
+ * @name            commonExecutableFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: exe, msi, bat, cmd, com, scr, bin, run, app, deb, rpm, dmg, pkg, apk, ipa, jar, sh, py, pl, rb, php, js, vbs, ps1, cgi
+ * Extended formats includes: gadget, jsr, wsf, pi, pif, scf, lnk, inf, reg, msc, cpl, drv, sys, ocx, dll, so, dylib, bundle, framework, action, workflow, command, tool, out, elf, bin32, bin64, x86, x64, arm, mips, sparc, ppc, prg, prc, xex, xbe, nro, nso, rpx, wbfs, cia, gb, gbc, gba, nds, nes, smc, sfc, n64, z64, v64
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonExecutableFileExtensions()
+ *
+ * @example         js
+ * import { commonExecutableFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonExecutableFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonExecutableFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonExecutableFileExtensions/commonExecutableFileExtensions.js

@@ -0,0 +1,116 @@
+/**
+ * @name            commonExecutableFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: exe, msi, bat, cmd, com, scr, bin, run, app, deb, rpm, dmg, pkg, apk, ipa, jar, sh, py, pl, rb, php, js, vbs, ps1, cgi
+ * Extended formats includes: gadget, jsr, wsf, pi, pif, scf, lnk, inf, reg, msc, cpl, drv, sys, ocx, dll, so, dylib, bundle, framework, action, workflow, command, tool, out, elf, bin32, bin64, x86, x64, arm, mips, sparc, ppc, prg, prc, xex, xbe, nro, nso, rpx, wbfs, cia, gb, gbc, gba, nds, nes, smc, sfc, n64, z64, v64
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonExecutableFileExtensions()
+ *
+ * @example         js
+ * import { commonExecutableFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonExecutableFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonExecutableFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'exe',
+        'msi',
+        'bat',
+        'cmd',
+        'com',
+        'scr',
+        'bin',
+        'run',
+        'app',
+        'deb',
+        'rpm',
+        'dmg',
+        'pkg',
+        'apk',
+        'ipa',
+        'jar',
+        'sh',
+        'py',
+        'pl',
+        'rb',
+        'php',
+        'js',
+        'vbs',
+        'ps1',
+        'cgi',
+    ];
+    const extended = [
+        'gadget',
+        'jsr',
+        'wsf',
+        'pi',
+        'pif',
+        'scf',
+        'lnk',
+        'inf',
+        'reg',
+        'msc',
+        'cpl',
+        'drv',
+        'sys',
+        'ocx',
+        'dll',
+        'so',
+        'dylib',
+        'bundle',
+        'framework',
+        'action',
+        'workflow',
+        'command',
+        'tool',
+        'out',
+        'elf',
+        'bin32',
+        'bin64',
+        'x86',
+        'x64',
+        'arm',
+        'mips',
+        'sparc',
+        'ppc',
+        'prg',
+        'prc',
+        'xex',
+        'xbe',
+        'nro',
+        'nso',
+        'rpx',
+        'wbfs',
+        'cia',
+        'gb',
+        'gbc',
+        'gba',
+        'nds',
+        'nes',
+        'smc',
+        'sfc',
+        'n64',
+        'z64',
+        'v64',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonExecutableFileExtensions.js.map

package/dist/shared/extension/commonExecutableFileExtensions/commonExecutableFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonExecutableFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonExecutableFileExtensions/commonExecutableFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,8BAA8B,CACpD,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,QAAQ;QACR,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,WAAW;QACX,QAAQ;QACR,UAAU;QACV,SAAS;QACT,MAAM;QACN,KAAK;QACL,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,OAAO;QACP,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/shared/extension/commonFileExtensions/commonFileExtensions.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @name                    commonFileExtensions
+ * @namespace               shared.extension
+ * @type                    Function
+ * @platform                node
+ * @platform                js
+ * @status                  stable
+ *
+ * This function allows you to get an array of common file extensions with or without the dot.
+ * You can filter extensions by types:
+ * - audio
+ * - compressed
+ * - data
+ * - disc
+ * - email
+ * - executable
+ * - font
+ * - image
+ * - media
+ * - programming
+ * - text
+ * - video
+ * - web
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {Types}          [types=[]]          An array of types to include in the result
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonFileExtensions()
+ *
+ * @example         js
+ * import { commonFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonFileExtensions(); // => ['avi','mp3',...]
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export type Types = ('audio' | 'compressed' | 'data' | 'disc' | 'email' | 'executable' | 'font' | 'image' | 'media' | 'programming' | 'text' | 'video' | 'web')[];
+export type TCommonFileExtensionsSettings = {
+    types?: Types;
+    dot: boolean;
+    exclude: string[];
+    extended?: boolean;
+};
+export default function commonFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonFileExtensions/commonFileExtensions.js

@@ -0,0 +1,76 @@
+import unique from '../../array/unique/unique.js';
+import commonAudioFileExtensions from '../commonAudioFileExtensions/commonAudioFileExtensions.js';
+import commonCompressedFileExtensions from '../commonCompressedFileExtensions/commonCompressedFileExtensions.js';
+import commonDataFileExtensions from '../commonDataFileExtensions/commonDataFileExtensions.js';
+import commonDiscFileExtensions from '../commonDiscFileExtensions/commonDiscFileExtensions.js';
+import commonEmailFileExtensions from '../commonEmailFileExtensions/commonEmailFileExtensions.js';
+import commonExecutableFileExtensions from '../commonExecutableFileExtensions/commonExecutableFileExtensions.js';
+import commonFontFileExtensions from '../commonFontFileExtensions/commonFontFileExtensions.js';
+import commonImageFileExtensions from '../commonImageFileExtensions/commonImageFileExtensions.js';
+import commonMediaFileExtensions from '../commonMediaFileExtensions/commonMediaFileExtensions.js';
+import commonProgrammingFileExtensions from '../commonProgrammingFileExtensions/commonProgrammingFileExtensions.js';
+import commonTextFileExtensions from '../commonTextFileExtensions/commonTextFileExtensions.js';
+import commonVideoFileExtensions from '../commonVideoFileExtensions/commonVideoFileExtensions.js';
+import commonWebFileExtensions from '../commonWebFileExtensions/commonWebFileExtensions.js';
+export default function commonFileExtensions(settings = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+    const finalSettings = Object.assign({ types: [
+            'audio',
+            'compressed',
+            'data',
+            'disc',
+            'email',
+            'executable',
+            'font',
+            'image',
+            'media',
+            'programming',
+            'text',
+            'video',
+            'web',
+        ], dot: false, exclude: [], extended: false }, settings);
+    return unique([
+        ...(((_a = finalSettings.types) === null || _a === void 0 ? void 0 : _a.includes('audio'))
+            ? commonAudioFileExtensions(finalSettings)
+            : []),
+        ...(((_b = finalSettings.types) === null || _b === void 0 ? void 0 : _b.includes('compressed'))
+            ? commonCompressedFileExtensions(finalSettings)
+            : []),
+        ...(((_c = finalSettings.types) === null || _c === void 0 ? void 0 : _c.includes('data'))
+            ? commonDataFileExtensions(finalSettings)
+            : []),
+        ...(((_d = finalSettings.types) === null || _d === void 0 ? void 0 : _d.includes('disc'))
+            ? commonDiscFileExtensions(finalSettings)
+            : []),
+        ...(((_e = finalSettings.types) === null || _e === void 0 ? void 0 : _e.includes('email'))
+            ? commonEmailFileExtensions(finalSettings)
+            : []),
+        ...(((_f = finalSettings.types) === null || _f === void 0 ? void 0 : _f.includes('executable'))
+            ? commonExecutableFileExtensions(finalSettings)
+            : []),
+        ...(((_g = finalSettings.types) === null || _g === void 0 ? void 0 : _g.includes('font'))
+            ? commonFontFileExtensions(finalSettings)
+            : []),
+        ...(((_h = finalSettings.types) === null || _h === void 0 ? void 0 : _h.includes('image'))
+            ? commonImageFileExtensions(finalSettings)
+            : []),
+        ...(((_j = finalSettings.types) === null || _j === void 0 ? void 0 : _j.includes('media'))
+            ? commonMediaFileExtensions(finalSettings)
+            : []),
+        ...(((_k = finalSettings.types) === null || _k === void 0 ? void 0 : _k.includes('programming'))
+            ? commonProgrammingFileExtensions(finalSettings)
+            : []),
+        ...(((_l = finalSettings.types) === null || _l === void 0 ? void 0 : _l.includes('text'))
+            ? commonTextFileExtensions(finalSettings)
+            : []),
+        ...(((_m = finalSettings.types) === null || _m === void 0 ? void 0 : _m.includes('video'))
+            ? commonVideoFileExtensions(finalSettings)
+            : []),
+        ...(((_o = finalSettings.types) === null || _o === void 0 ? void 0 : _o.includes('web'))
+            ? commonWebFileExtensions(finalSettings)
+            : []),
+    ])
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonFileExtensions.js.map

package/dist/shared/extension/commonFileExtensions/commonFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonFileExtensions/commonFileExtensions.ts"],"names":[],"mappings":"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"}

package/dist/shared/extension/commonFontFileExtensions/commonFontFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from '../commonFileExtensions/commonFileExtensions.js';
+/**
+ * @name                commonFontFileExtensions
+ * @namespace           shared.extension
+ * @type                Function
+ * @platform            node
+ * @platform            js
+ * @status              stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: ttf, otf, woff, woff2, eot
+ * Extended formats includes: fnt, fon, pfb, pfm, afm, bdf, pcf, snf, pfa, gsf, cff, otc, ttc, dfont, suit, lwfn, ffil, pdb, etx, gdr, cha, chr, bmap, fdb, fd, pk, gf, mf, vf, tfm, ofm, ufm, wfn, fft, sfd, ufo, glif.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonFontFileExtensions()
+ *
+ * @example         js
+ * import { commonFontFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonFontFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonFontFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonFontFileExtensions/commonFontFileExtensions.js

@@ -0,0 +1,75 @@
+/**
+ * @name                commonFontFileExtensions
+ * @namespace           shared.extension
+ * @type                Function
+ * @platform            node
+ * @platform            js
+ * @status              stable
+ *
+ * This function allows you to get an array of common text file extensions with or without the dot
+ * Common formats includes: ttf, otf, woff, woff2, eot
+ * Extended formats includes: fnt, fon, pfb, pfm, afm, bdf, pcf, snf, pfa, gsf, cff, otc, ttc, dfont, suit, lwfn, ffil, pdb, etx, gdr, cha, chr, bmap, fdb, fd, pk, gf, mf, vf, tfm, ofm, ufm, wfn, fft, sfd, ufo, glif.
+ *
+ * @param       {TCommonFileExtensionsSettings}           [settings={}]         Settings to customize the function behavior
+ * @return      {Array<String>}                           The array of extensions
+ *
+ * @setting     {boolean}         [dot=false]         If true, the dot will be added to the extension
+ * @setting     {Array<String>}   [exclude=[]]        An array of extensions to exclude
+ * @setting     {boolean}         [extended=false]    If true, the extended formats will be included *
+ *
+ * @snippet         commonFontFileExtensions()
+ *
+ * @example         js
+ * import { commonFontFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonFontFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonFontFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = ['ttf', 'otf', 'woff', 'woff2', 'eot'];
+    const extended = [
+        'fnt',
+        'fon',
+        'pfb',
+        'pfm',
+        'afm',
+        'bdf',
+        'pcf',
+        'snf',
+        'pfa',
+        'gsf',
+        'cff',
+        'otc',
+        'ttc',
+        'dfont',
+        'suit',
+        'lwfn',
+        'ffil',
+        'pdb',
+        'etx',
+        'gdr',
+        'cha',
+        'chr',
+        'bmap',
+        'fdb',
+        'fd',
+        'pk',
+        'gf',
+        'mf',
+        'vf',
+        'tfm',
+        'ofm',
+        'ufm',
+        'wfn',
+        'fft',
+        'sfd',
+        'ufo',
+        'glif',
+    ];
+    return ['fnt', 'fon', 'otf', 'ttf', 'woff', 'woff2']
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonFontFileExtensions.js.map

package/dist/shared/extension/commonFontFileExtensions/commonFontFileExtensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commonFontFileExtensions.js","sourceRoot":"","sources":["../../../../src/shared/extension/commonFontFileExtensions/commonFontFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAC9C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;KACP,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;SACjD,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,CAAC"}