@blackbyte/sugar 1.0.0-beta.1

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

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from './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.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.js.map

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

@@ -0,0 +1,76 @@
+import unique from '../array/unique.js';
+import commonAudioFileExtensions from './commonAudioFileExtensions.js';
+import commonCompressedFileExtensions from './commonCompressedFileExtensions.js';
+import commonDataFileExtensions from './commonDataFileExtensions.js';
+import commonDiscFileExtensions from './commonDiscFileExtensions.js';
+import commonEmailFileExtensions from './commonEmailFileExtensions.js';
+import commonExecutableFileExtensions from './commonExecutableFileExtensions.js';
+import commonFontFileExtensions from './commonFontFileExtensions.js';
+import commonImageFileExtensions from './commonImageFileExtensions.js';
+import commonMediaFileExtensions from './commonMediaFileExtensions.js';
+import commonProgrammingFileExtensions from './commonProgrammingFileExtensions.js';
+import commonTextFileExtensions from './commonTextFileExtensions.js';
+import commonVideoFileExtensions from './commonVideoFileExtensions.js';
+import commonWebFileExtensions from './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.js.map

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

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

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from './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.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.js.map

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

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

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
+/**
+ * @name            commonImageFileExtensions
+ * @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: jpg, jpeg, png, gif, bmp, svg, webp, ico, tiff, tif
+ * Extended formats includes: psd, ai, ps, avif, heic, heif, raw, cr2, nef, orf, sr2, arw, dng, rw2, raf, pef, x3f, crw, mrw, dcr, kdc, srf, erf, 3fr, mef, mos, ptx, r3d, fff, iiq, rwl, rwz, bay, cap, dcs, dcx, eip, emf, eps, exr, fax, fpx, g3, hdr, img, j2c, j2k, jp2, jpc, jpf, jpx.
+ *
+ * @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         commonImageFileExtensions()
+ *
+ * @example         js
+ * import { commonImageFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonImageFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonImageFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonImageFileExtensions.js

@@ -0,0 +1,120 @@
+/**
+ * @name            commonImageFileExtensions
+ * @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: jpg, jpeg, png, gif, bmp, svg, webp, ico, tiff, tif
+ * Extended formats includes: psd, ai, ps, avif, heic, heif, raw, cr2, nef, orf, sr2, arw, dng, rw2, raf, pef, x3f, crw, mrw, dcr, kdc, srf, erf, 3fr, mef, mos, ptx, r3d, fff, iiq, rwl, rwz, bay, cap, dcs, dcx, eip, emf, eps, exr, fax, fpx, g3, hdr, img, j2c, j2k, jp2, jpc, jpf, jpx.
+ *
+ * @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         commonImageFileExtensions()
+ *
+ * @example         js
+ * import { commonImageFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonImageFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonImageFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [] }, settings);
+    const commons = [
+        'jpg',
+        'jpeg',
+        'png',
+        'gif',
+        'bmp',
+        'svg',
+        'webp',
+        'ico',
+        'tiff',
+        'tif',
+    ];
+    const extended = [
+        'psd',
+        'ai',
+        'ps',
+        'avif',
+        'heic',
+        'heif',
+        'raw',
+        'cr2',
+        'nef',
+        'orf',
+        'sr2',
+        'arw',
+        'dng',
+        'rw2',
+        'raf',
+        'pef',
+        'x3f',
+        'crw',
+        'mrw',
+        'dcr',
+        'kdc',
+        'srf',
+        'erf',
+        '3fr',
+        'mef',
+        'mos',
+        'ptx',
+        'r3d',
+        'fff',
+        'iiq',
+        'rwl',
+        'rwz',
+        'bay',
+        'cap',
+        'dcs',
+        'dcx',
+        'eip',
+        'emf',
+        'eps',
+        'exr',
+        'fax',
+        'fpx',
+        'g3',
+        'hdr',
+        'img',
+        'j2c',
+        'j2k',
+        'jp2',
+        'jpc',
+        'jpf',
+        'jpx',
+        'mac',
+        'mng',
+        'pbm',
+        'pcd',
+        'pcx',
+        'pgm',
+        'pic',
+        'pict',
+        'pnm',
+        'ppm',
+        'psp',
+        'ras',
+        'rgb',
+        'sgi',
+        'tga',
+        'wmf',
+        'wpg',
+        'xbm',
+        'xpm',
+        'xwd',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonImageFileExtensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonImageFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonImageFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;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,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,MAAM;QACN,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;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,KAAK;QACL,KAAK;QACL,KAAK;QACL,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,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,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;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/commonMediaFileExtensions.d.ts

@@ -0,0 +1,28 @@
+import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
+/**
+ * @name            commonMediaFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common media file extensions with or without the dot
+ *
+ * @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         commonMediaFileExtensions()
+ *
+ * @example         js
+ * import { commonMediaFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonMediaFileExtensions(); // => ['avi','mp3',...]
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonMediaFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonMediaFileExtensions.js

@@ -0,0 +1,41 @@
+import unique from '../array/unique.js';
+import commonAudioFileExtensions from './commonAudioFileExtensions.js';
+import commonImageFileExtensions from './commonImageFileExtensions.js';
+import commonVideoFileExtensions from './commonVideoFileExtensions.js';
+/**
+ * @name            commonMediaFileExtensions
+ * @namespace       shared.extension
+ * @type            Function
+ * @platform        node
+ * @platform        js
+ * @status          stable
+ *
+ * This function allows you to get an array of common media file extensions with or without the dot
+ *
+ * @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         commonMediaFileExtensions()
+ *
+ * @example         js
+ * import { commonMediaFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonMediaFileExtensions(); // => ['avi','mp3',...]
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonMediaFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    return unique([
+        ...commonImageFileExtensions(finalSettings),
+        ...commonVideoFileExtensions(finalSettings),
+        ...commonAudioFileExtensions(finalSettings),
+    ])
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonMediaFileExtensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonMediaFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonMediaFileExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AACvE,OAAO,yBAAyB,MAAM,gCAAgC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAC/C,WAAmD,EAAE;IAErD,MAAM,aAAa,mBACjB,GAAG,EAAE,KAAK,EACV,OAAO,EAAE,EAAE,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IACF,OAAO,MAAM,CAAC;QACZ,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;QAC3C,GAAG,yBAAyB,CAAC,aAAa,CAAC;KAC5C,CAAC;SACC,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/commonProgrammingFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
+/**
+ * @name            commonProgrammingFileExtensions
+ * @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: js, ts, jsx, tsx, py, java, c, cpp, cs, php, rb, go, rs, swift, kt, dart, html, css, scss, sass, less, json, xml, sql, sh, bat, ps1, r, scala, clj, h, hpp, asp, jsp, cfm, pl, vb, class
+ * Extended formats includes: asm, awk, bas, boa, boo, cbl, cob, coffee, cr, d, diff, e, erl, ex, exs, f, f77, f90, f95, for, forth, fs, fsx, groovy, hs, iml, inc, io, jl, lisp, lsp, lua, m, ml, mli, nim, p, pas, patch, pike, pro, prolog, pyx, rkt, sc, scm, smalltalk, sml, st, tcl, v, vhd, vhdl, vim, ws, xsl, xslt, yacc, zig.
+ *
+ * @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         commonProgrammingFileExtensions()
+ *
+ * @example         js
+ * import { commonProgrammingFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonProgrammingFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonProgrammingFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];