@blackbyte/sugar 1.0.0-beta.1

package/dist/shared/extension/commonAudioFileExtensions.js

@@ -0,0 +1,140 @@
+/**
+ * @name            commonAudioFileExtensions
+ * @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: mp3, wav, flac, aac, m4a, ogg, wma, opus, aiff, alac, ape, webm, ac3, dts, amr, mid, midi, cda, ra, au, voc, gsm, pcm
+ * Extended formats includes: 3gp, 8svx, aa, aax, ac4, act, aif, amv, awb, awg, bwf, caf, dct, dff, dsf, dss, dvf, dxd, eac3, ec3, flv, iklax, it, ivs, kar, la, m1a, m2a, m3u, m3u8, m4b, m4p, mka, mld, mlp, mmf, mod, mogg, mp2, mpa, mpc, mpp, mpu, msv, nmf, oga, ogm, ogv, ogx, pls, ram, raw, rax, rf64, rmi, s3m, saf, sd2, shn, sln, smp, snd, spx, tak, thd, tta, vox, vqf, w64, wax, wm, wmv, wpl, wv, wvx, xa, xm, xspf
+ *
+ * @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         commonAudioFileExtensions()
+ *
+ * @example         js
+ * import { commonAudioFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonAudioFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonAudioFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'mp3',
+        'wav',
+        'flac',
+        'aac',
+        'm4a',
+        'ogg',
+        'wma',
+        'opus',
+        'aiff',
+        'alac',
+        'ape',
+        'webm',
+        'ac3',
+        'dts',
+        'amr',
+        'mid',
+        'midi',
+        'cda',
+        'ra',
+        'au',
+        'voc',
+        'gsm',
+        'pcm',
+    ];
+    const extended = [
+        '3gp',
+        '8svx',
+        'aa',
+        'aax',
+        'ac4',
+        'act',
+        'aif',
+        'amv',
+        'awb',
+        'awg',
+        'bwf',
+        'caf',
+        'dct',
+        'dff',
+        'dsf',
+        'dss',
+        'dvf',
+        'dxd',
+        'eac3',
+        'ec3',
+        'flv',
+        'iklax',
+        'it',
+        'ivs',
+        'kar',
+        'la',
+        'm1a',
+        'm2a',
+        'm3u',
+        'm3u8',
+        'm4b',
+        'm4p',
+        'mka',
+        'mld',
+        'mlp',
+        'mmf',
+        'mod',
+        'mogg',
+        'mp2',
+        'mpa',
+        'mpc',
+        'mpp',
+        'mpu',
+        'msv',
+        'nmf',
+        'oga',
+        'ogm',
+        'ogv',
+        'ogx',
+        'pls',
+        'ram',
+        'raw',
+        'rax',
+        'rf64',
+        'rmi',
+        's3m',
+        'saf',
+        'sd2',
+        'shn',
+        'sln',
+        'smp',
+        'snd',
+        'spx',
+        'tak',
+        'thd',
+        'tta',
+        'vox',
+        'vqf',
+        'w64',
+        'wax',
+        'wm',
+        'wmv',
+        'wpl',
+        'wv',
+        'wvx',
+        'xa',
+        'xm',
+        'xspf',
+    ];
+    return [...(finalSettings.extended ? extended : []), ...commons]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonAudioFileExtensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonAudioFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonAudioFileExtensions.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,EACX,QAAQ,EAAE,KAAK,IACZ,QAAQ,CACZ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,MAAM;QACN,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,OAAO;QACP,IAAI;QACJ,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,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;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;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,MAAM;KACP,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,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/commonCompressedFileExtensions.d.ts

@@ -0,0 +1,29 @@
+import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
+/**
+ * @name            commonCompressedFileExtensions
+ * @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: zip, rar, 7z, tar, gz, 'targz, tgz, bz2, 'tarbz2, tbz2, xz, 'tarxz, txz, iso, dmg, cab, deb, rpm, pkg, jar, war, apk
+ * Extended formats includes: ace, alz, arc, arj, bz, cpio, egg, lha, lz, lzh, lzma, lzo, pak, sit, sitx, 'tar.lz', 'tar.Z', tbz, tlz, tz, tZ, wim, xar, z, zipx
+ *
+ * @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         commonCompressedFileExtensions()
+ *
+ * @example         js
+ * import { commonCompressedFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonCompressedFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonCompressedFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonCompressedFileExtensions.js

@@ -0,0 +1,85 @@
+/**
+ * @name            commonCompressedFileExtensions
+ * @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: zip, rar, 7z, tar, gz, 'targz, tgz, bz2, 'tarbz2, tbz2, xz, 'tarxz, txz, iso, dmg, cab, deb, rpm, pkg, jar, war, apk
+ * Extended formats includes: ace, alz, arc, arj, bz, cpio, egg, lha, lz, lzh, lzma, lzo, pak, sit, sitx, 'tar.lz', 'tar.Z', tbz, tlz, tz, tZ, wim, xar, z, zipx
+ *
+ * @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         commonCompressedFileExtensions()
+ *
+ * @example         js
+ * import { commonCompressedFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonCompressedFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonCompressedFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'zip',
+        'rar',
+        '7z',
+        'tar',
+        'gz',
+        'tar.gz',
+        'tgz',
+        'bz2',
+        'tar.bz2',
+        'tbz2',
+        'xz',
+        'tar.xz',
+        'txz',
+        'iso',
+        'dmg',
+        'cab',
+        'deb',
+        'rpm',
+        'pkg',
+        'jar',
+        'war',
+        'apk',
+    ];
+    const extended = [
+        'ace',
+        'alz',
+        'arc',
+        'arj',
+        'bz',
+        'cpio',
+        'egg',
+        'lha',
+        'lz',
+        'lzh',
+        'lzma',
+        'lzo',
+        'pak',
+        'sit',
+        'sitx',
+        'tar.lz',
+        'tar.Z',
+        'tbz',
+        'tlz',
+        'tz',
+        'tZ',
+        'wim',
+        'xar',
+        'z',
+        'zipx',
+    ];
+    return ['7z', 'arj', 'deb', 'pkg', 'rar', 'rpm', 'tar.gz', 'z', 'zip']
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonCompressedFileExtensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonCompressedFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonCompressedFileExtensions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;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,IAAI;QACJ,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,KAAK;QACL,SAAS;QACT,MAAM;QACN,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,MAAM;QACN,KAAK;QACL,KAAK;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,QAAQ;QACR,OAAO;QACP,KAAK;QACL,KAAK;QACL,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,GAAG;QACH,MAAM;KACP,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC;SACnE,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/commonDataFileExtensions.d.ts

@@ -0,0 +1,30 @@
+import { type TCommonFileExtensionsSettings } from './commonFileExtensions.js';
+/**
+ * @name            commonDataFileExtensions
+ * @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: json, xml, csv, sql, db, sqlite, log, txt, yaml, yml, ini, cfg, conf, properties, env, tsv, dat, dbf, mdb, accdb, xlsx, xls, ods, parquet, avro, jsonl, ndjson.
+ * Extended formats includes: sav, dta, por, sas7bdat, xpt, rdata, rds, feather, hdf5, h5, nc, cdf, mat, pickle, pkl, msgpack, bson, cbor, protobuf, pb, arff, weka, libsvm, svmlight, tfrecord, lmdb, leveldb, rocksdb, bdb, gdbm, dbm, ndbm, qdbm, tc, tch, fdb, realm, sqlite3, db3, s3db, sl3, dump, backup, bak
+ *
+ * @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         commonDataFileExtensions()
+ *
+ * @example         js
+ * import { commonDataFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonDataFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonDataFileExtensions(settings?: Partial<TCommonFileExtensionsSettings>): string[];

package/dist/shared/extension/commonDataFileExtensions.js

@@ -0,0 +1,110 @@
+/**
+ * @name            commonDataFileExtensions
+ * @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: json, xml, csv, sql, db, sqlite, log, txt, yaml, yml, ini, cfg, conf, properties, env, tsv, dat, dbf, mdb, accdb, xlsx, xls, ods, parquet, avro, jsonl, ndjson.
+ * Extended formats includes: sav, dta, por, sas7bdat, xpt, rdata, rds, feather, hdf5, h5, nc, cdf, mat, pickle, pkl, msgpack, bson, cbor, protobuf, pb, arff, weka, libsvm, svmlight, tfrecord, lmdb, leveldb, rocksdb, bdb, gdbm, dbm, ndbm, qdbm, tc, tch, fdb, realm, sqlite3, db3, s3db, sl3, dump, backup, bak
+ *
+ * @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         commonDataFileExtensions()
+ *
+ * @example         js
+ * import { commonDataFileExtensions } from '@blackbyte/sugar/extension';
+ * const extensions = commonDataFileExtensions();
+ *
+ * @since       1.0.0
+ * @author    Olivier Bossel <olivier.bossel@gmail.com> (https://blackbyte.space)
+ */
+export default function commonDataFileExtensions(settings = {}) {
+    const finalSettings = Object.assign({ dot: false, exclude: [], extended: false }, settings);
+    const commons = [
+        'json',
+        'xml',
+        'csv',
+        'sql',
+        'db',
+        'sqlite',
+        'log',
+        'txt',
+        'yaml',
+        'yml',
+        'ini',
+        'cfg',
+        'conf',
+        'properties',
+        'env',
+        'tsv',
+        'dat',
+        'dbf',
+        'mdb',
+        'accdb',
+        'xlsx',
+        'xls',
+        'ods',
+        'parquet',
+        'avro',
+        'jsonl',
+        'ndjson',
+    ];
+    const extended = [
+        'sav',
+        'dta',
+        'por',
+        'sas7bdat',
+        'xpt',
+        'rdata',
+        'rds',
+        'feather',
+        'hdf5',
+        'h5',
+        'nc',
+        'cdf',
+        'mat',
+        'pickle',
+        'pkl',
+        'msgpack',
+        'bson',
+        'cbor',
+        'protobuf',
+        'pb',
+        'arff',
+        'weka',
+        'libsvm',
+        'svmlight',
+        'tfrecord',
+        'lmdb',
+        'leveldb',
+        'rocksdb',
+        'bdb',
+        'gdbm',
+        'dbm',
+        'ndbm',
+        'qdbm',
+        'tc',
+        'tch',
+        'fdb',
+        'realm',
+        'sqlite3',
+        'db3',
+        's3db',
+        'sl3',
+        'dump',
+        'backup',
+        'bak',
+    ];
+    return [...commons, ...(finalSettings.extended ? extended : [])]
+        .filter((ext) => !finalSettings.exclude.includes(ext))
+        .map((ext) => (finalSettings.dot ? `.${ext}` : ext));
+}
+//# sourceMappingURL=commonDataFileExtensions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commonDataFileExtensions.js","sourceRoot":"","sources":["../../../src/shared/extension/commonDataFileExtensions.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,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,YAAY;QACZ,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,MAAM;QACN,KAAK;QACL,KAAK;QACL,SAAS;QACT,MAAM;QACN,OAAO;QACP,QAAQ;KACT,CAAC;IAEF,MAAM,QAAQ,GAAG;QACf,KAAK;QACL,KAAK;QACL,KAAK;QACL,UAAU;QACV,KAAK;QACL,OAAO;QACP,KAAK;QACL,SAAS;QACT,MAAM;QACN,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,QAAQ;QACR,KAAK;QACL,SAAS;QACT,MAAM;QACN,MAAM;QACN,UAAU;QACV,IAAI;QACJ,MAAM;QACN,MAAM;QACN,QAAQ;QACR,UAAU;QACV,UAAU;QACV,MAAM;QACN,SAAS;QACT,SAAS;QACT,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,IAAI;QACJ,KAAK;QACL,KAAK;QACL,OAAO;QACP,SAAS;QACT,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,QAAQ;QACR,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/commonDiscFileExtensions.d.ts

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

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

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

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