@ngrdt/utils 0.0.4 → 0.0.6

package/.swcrc

@@ -0,0 +1,29 @@
+{
+  "jsc": {
+    "target": "es2017",
+    "parser": {
+      "syntax": "typescript",
+      "decorators": true,
+      "dynamicImport": true
+    },
+    "transform": {
+      "decoratorMetadata": true,
+      "legacyDecorator": true
+    },
+    "keepClassNames": true,
+    "externalHelpers": true,
+    "loose": true
+  },
+  "module": {
+    "type": "es6"
+  },
+  "sourceMaps": true,
+  "exclude": [
+    "jest.config.ts",
+    ".*\\.spec.tsx?$",
+    ".*\\.test.tsx?$",
+    "./src/jest-setup.ts$",
+    "./**/jest-setup.ts$",
+    ".*.js$"
+  ]
+}

package/eslint.config.js

@@ -0,0 +1,22 @@
+const baseConfig = require('../../eslint.config.js');
+
+module.exports = [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs}',
+            '{projectRoot}/rollup.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: require('jsonc-eslint-parser'),
+    },
+  },
+];

package/jest.config.ts

@@ -0,0 +1,30 @@
+/* eslint-disable */
+import { readFileSync } from 'fs';
+
+// Reading the SWC compilation config and remove the "exclude"
+// for the test files to be compiled by SWC
+const { exclude: _, ...swcJestConfig } = JSON.parse(
+  readFileSync(`${__dirname}/.swcrc`, 'utf-8')
+);
+
+// disable .swcrc look-up by SWC core because we're passing in swcJestConfig ourselves.
+// If we do not disable this, SWC Core will read .swcrc and won't transform our test files due to "exclude"
+if (swcJestConfig.swcrc === undefined) {
+  swcJestConfig.swcrc = false;
+}
+
+// Uncomment if using global setup/teardown files being transformed via swc
+// https://nx.dev/nx-api/jest/documents/overview#global-setupteardown-with-nx-libraries
+// jest needs EsModule Interop to find the default exported setup/teardown functions
+// swcJestConfig.module.noInterop = false;
+
+export default {
+  displayName: '@ngrdt/utils',
+  preset: '../../jest.preset.js',
+  transform: {
+    '^.+\\.[tj]s$': ['@swc/jest', swcJestConfig],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  testEnvironment: 'node',
+  coverageDirectory: '../../coverage/@ngrdt/utils',
+};

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@ngrdt/utils",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "peerDependencies": {
-    "rxjs": ">=7.0.0"
+    "rxjs": ">=7.0.0",
+    "@angular/common": "~18.2.0",
+    "@angular/router": "~18.2.0"
   },
-  "main": "./index.cjs.js",
-  "module": "./index.esm.js",
+  "main": "./index.cjs",
+  "module": "./index.js",
   "types": "src/index.d.ts"
-}
+}

package/project.json

@@ -0,0 +1,29 @@
+{
+  "name": "@ngrdt/utils",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "@ngrdt/utils/src",
+  "projectType": "library",
+  "release": {
+    "version": {
+      "generatorOptions": {
+        "packageRoot": "dist/{projectRoot}",
+        "currentVersionResolver": "git-tag"
+      }
+    }
+  },
+  "tags": [],
+  "targets": {
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist/{projectRoot}"
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "@ngrdt/utils/jest.config.ts"
+      }
+    }
+  }
+}

package/rollup.config.js

@@ -0,0 +1,20 @@
+const { withNx } = require('@nx/rollup/with-nx');
+const { terser } = require('rollup-plugin-terser');
+
+
+module.exports = withNx(
+  {
+    main: './src/index.ts',
+    outputPath: '../../dist/@ngrdt/utils',
+    tsConfig: './tsconfig.lib.json',
+    compiler: 'swc',
+    format: ['cjs', 'esm'],
+    assets: [{ input: './@ngrdt/utils', output: '.', glob: '*.md' }],
+  },
+  {
+    plugins: [terser()]
+    // Provide additional rollup configuration here. See: https://rollupjs.org/configuration-options
+    // e.g.
+    // output: { sourcemap: true },
+  }
+);

package/src/index.ts

@@ -0,0 +1,17 @@
+export * from './lib/utils/model';
+export * from './lib/utils/array';
+export * from './lib/utils/object';
+export * from './lib/utils/random';
+export * from './lib/utils/rxjs';
+export * from './lib/types/type';
+export * from './lib/utils/string';
+export * from './lib/types/keyboard';
+export * from './lib/utils/html';
+export * from './lib/utils/date';
+export * from './lib/utils/file';
+export * from './lib/types/mime-types';
+export * from './lib/utils/css';
+export * from './lib/utils/date-format';
+export * from './lib/types/encodings';
+export * from './lib/types/router';
+export * from './lib/types/aria';

package/src/lib/__test__/array.utils.spec.ts

@@ -0,0 +1,13 @@
+import { ArrayUtils } from '../array';
+
+describe('ArrayUtils', () => {
+  it('Should remove third element.', () => {
+    const input = [0, 1, 2, 3, 4];
+    const removed = ArrayUtils.removeAt(input, 2);
+
+    expect(removed.length).toEqual(4);
+    expect(removed[1]).toEqual(1);
+    expect(removed[2]).toEqual(3);
+    expect(removed[3]).toEqual(4);
+  });
+});

package/src/lib/__test__/css.utils.spec.ts

@@ -0,0 +1,27 @@
+import { CssUtils } from '../css';
+
+describe('CssUtils', () => {
+  it('Should normalize colors.', () => {
+    expect(CssUtils.normalizeColor('#fff')).toEqual('#fff');
+    expect(CssUtils.normalizeColor('fff')).toEqual('#fff');
+    expect(CssUtils.normalizeColor('fffff')).toBeNull();
+    expect(CssUtils.normalizeColor('232,241, 32')).toEqual('rgb(232,241,32)');
+    expect(CssUtils.normalizeColor('rgb(232, 241, 32)')).toEqual(
+      'rgb(232,241,32)'
+    );
+    expect(CssUtils.normalizeColor('rgb(632, 241, 32)')).toBeNull();
+    expect(CssUtils.normalizeColor(' 232 - 241, 32')).toEqual(
+      'rgb(232,241,32)'
+    );
+    expect(CssUtils.normalizeColor('rgba(232, 241, 32, 0.5)')).toEqual(
+      'rgba(232,241,32,0.5)'
+    );
+    expect(CssUtils.normalizeColor('rgba(232, 241, 32, 1.2)')).toBeNull();
+    expect(CssUtils.normalizeColor('rgba(232, 241, 32, 1.0)')).toEqual(
+      'rgba(232,241,32,1.0)'
+    );
+    expect(CssUtils.normalizeColor('232, 241, 32 1.0)')).toEqual(
+      'rgba(232,241,32,1.0)'
+    );
+  });
+});

package/src/lib/__test__/date-format.spec.ts

@@ -0,0 +1,71 @@
+import {
+  DateInputConfig,
+  DateParser,
+  InsertMode,
+  LeadingZeroInputMode,
+  PRIMENG_DATE_FORMAT_META,
+  YearInputMode,
+} from '../date-format';
+
+describe('DateFormat', () => {
+  it('parse date.', () => {
+    const cfg: DateInputConfig = {
+      format: 'd.m.yy',
+      symbolMeta: PRIMENG_DATE_FORMAT_META,
+      leadingZeroMode: LeadingZeroInputMode.Both,
+      twoDigitYearInputStrategy: 'past',
+      yearInputMode: YearInputMode.Both,
+      insertMode: InsertMode.Overwrite,
+    };
+
+    const parser = new DateParser(cfg);
+
+    const res1 = parser.parse('01.01.21');
+
+    expect(res1).toBeTruthy();
+    expect(res1?.date).toBeTruthy();
+    expect(res1?.date?.getFullYear()).toEqual(2021);
+    expect(res1?.date?.getMonth()).toEqual(0);
+    expect(res1?.date?.getDate()).toEqual(1);
+
+    const res2 = parser.parse('01 01 ');
+
+    expect(res2).toBeTruthy();
+    expect(res2?.date).toBeNull();
+    expect(res2?.complete).toBeFalsy();
+    expect(res2?.prettyInput).toEqual('01.01.');
+
+    const res3 = parser.parse('01.01');
+
+    expect(res3).toBeTruthy();
+    expect(res3?.date).toBeNull();
+    expect(res3?.complete).toBeFalsy();
+    expect(res3?.prettyInput).toEqual('01.01.');
+
+    const res4 = parser.parse('01.1ab');
+    expect(res4).toBeTruthy();
+    expect(res4?.date).toBeNull();
+    expect(res4?.complete).toBeFalsy();
+    expect(res4?.prettyInput).toEqual('01.1.');
+
+    const res5 = parser.parse('01.1');
+    expect(res5).toBeTruthy();
+    expect(res5?.date).toBeNull();
+    expect(res5?.complete).toBeFalsy();
+    expect(res5?.prettyInput).toEqual('01.1');
+
+    const res6 = parser.parse('41.2.21');
+    expect(res6).toBeTruthy();
+    expect(res6?.prettyInput).toEqual('4.2.21');
+    expect(res6?.date?.getFullYear()).toEqual(2021);
+    expect(res6?.date?.getMonth()).toEqual(1);
+    expect(res6?.complete).toBeTruthy();
+
+    const res7 = parser.parse('411.34.21');
+    expect(res7).toBeTruthy();
+    expect(res7?.prettyInput).toEqual('4.3.21');
+    expect(res7?.date?.getFullYear()).toEqual(2021);
+    expect(res7?.date?.getMonth()).toEqual(2);
+    expect(res7?.complete).toBeTruthy();
+  });
+});

package/src/lib/__test__/date.utils.spec.ts

@@ -0,0 +1,72 @@
+import { DateUtils } from '../date';
+
+describe('DateUtils', () => {
+  it('Parse time to Date and detect invalid values.', () => {
+    const hhmmValid = '12:34';
+    const hhmmssValid = '12:34:56';
+    const hhmmssmsValid = '12: 34:56  .   789';
+
+    const hhmmParsed = DateUtils.timeToDate(hhmmValid);
+    const hhmmssParsed = DateUtils.timeToDate(hhmmssValid);
+    const hhmmssmsParsed = DateUtils.timeToDate(hhmmssmsValid);
+
+    const invalids = [
+      'null',
+      ' ',
+      ' 3',
+      '25:43',
+      '03:60',
+      '03:59:60',
+      '03:59:59:f',
+      '03:59:59:1111',
+    ];
+
+    expect(hhmmParsed).toBeTruthy();
+    expect(hhmmParsed?.getHours()).toEqual(12);
+    expect(hhmmParsed?.getMinutes()).toEqual(34);
+    expect(hhmmParsed?.getSeconds()).toEqual(0);
+
+    expect(hhmmssParsed).toBeTruthy();
+    expect(hhmmssParsed?.getHours()).toEqual(12);
+    expect(hhmmssParsed?.getMinutes()).toEqual(34);
+    expect(hhmmssParsed?.getSeconds()).toEqual(56);
+
+    expect(hhmmssmsParsed).toBeTruthy();
+    expect(hhmmssmsParsed?.getHours()).toEqual(12);
+    expect(hhmmssmsParsed?.getMinutes()).toEqual(34);
+    expect(hhmmssmsParsed?.getSeconds()).toEqual(56);
+    expect(hhmmssmsParsed?.getMilliseconds()).toEqual(789);
+
+    invalids.forEach((invalid) => {
+      expect(DateUtils.timeToDate(invalid)).toBeNull();
+    });
+  });
+
+  it('works with medieval dates.', () => {
+    const dateStrs = [
+      '2019-11-11T00:00:00',
+      '1111-11-11T00:00:00',
+      '1532-11-11T01:40:54',
+      '1402-12-31T23:59:59',
+    ];
+
+    const dates = [
+      new Date(2019, 10, 11, 0, 0, 0),
+      new Date(1111, 10, 11, 0, 0, 0),
+      new Date(1532, 10, 11, 1, 40, 54),
+      new Date(1402, 11, 31, 23, 59, 59),
+    ];
+
+    dateStrs.forEach((dateStr) => {
+      const date = new Date(dateStr);
+      const str2 = DateUtils.toISOLocal(date);
+      expect(str2).toEqual(dateStr);
+    });
+
+    dates.forEach((date) => {
+      const str = DateUtils.toISOLocal(date);
+      const date2 = new Date(str);
+      expect(date2).toEqual(date);
+    });
+  });
+});

package/src/lib/__test__/file-zip.utils.spec.ts

@@ -0,0 +1,14 @@
+import { FileZipUtils } from '../file-zip';
+
+const file =
+  'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAIAAACQkWg2AAADG0lEQVR4nAEQA+/8AawKf+AlKzhoy+J/Qhq2ahh3knZXSAQI4HHUosjxAFpxjL+cYy9qNcw3sLqQoX3BcAEktwVMoDW79QwR/56ccqA2mxaknvIb1rltbeQoiBnmuaQ1NOSqnCCoDb6WMAZjWMwBWF5rOfMg/BMaWY9HM08dvQtiWcXdaU0Ocbz4DXlJ2BHcGoiSyOZAjuBNyOIz+DMwBKbpyskInCe/qC/G8qfHtQhJ/VfoqMhEFs+MHPQK5RocgHr2A03wyGigMHI0zjzD6AKQ9BJXWFqNlXHAGMUBNkG2txIsKlbqUxCnK0AlbyYs9SxYdA+tv96WYYZXowTUcswEFa9yJRTAODGrUAX7RXenSgyeCr3Yjt4bSlL7EmAkaWBhjq1/PBj2N0Fiy2nuN+etACZOspzoDeo49GLvnRHx8GJPeZnxhLEQ52nGi64q7C9zurUIXB+68Zx4U+FvAVEA5wQbp+UW8mKA4bWNe3LX/qiW1PS5uS1+JMBIJiP94c+RuPTh09kzAb6/of1lxn/2LNkAjum/UGPKmps1JhxdjEs2U3lq+JGqP9YJVDBIcMvIX6JEEQb9BrN99cSbHxovRB2nAX/yeLYCv16uTAGppjioojJxUDRDmfJN4MTDQ1iXONQcgBD26HBmDuUdJxlbDslg5QKYSTrz23P0tAr39vOpnvGu8RzTAXz+QL1JPojj95ctXRoU87sPUJJ63RnSIKUB/QoBxZwsDcJCp6WSKNgY0PxaLtsc5CSWcp6IrXPtdknKucj6bgGcRFDYXRm1GRWkxf9YAc0DDS1tREmeluTJs25U5d6e4c30H6lghhcZAwpU7wnne/b11iLMfs+IbctkTMjm3QRK1cI04wfYC5vVjZyJ7i49mQz077/1SdyjvSzHVIOnDQnvgMjLdbs9mKcOk9Ty/xEEzPI9rtlQLGJ1oBPBuWb/CdE9jOp5aCkJzhb/71yCv7HFQgYY6jWz8WPa0Zv7qivxAkjygcDU1+4lOtjrZ9DxWFWY7MqcQtn/u/e8VZ98GJXsv0qltwJ/fy4JRv9BWAS/HiDjhywl59k8AAAAAElFTkSuQmCC';
+
+describe('file-zip utils', () => {
+  it('compressPepaWay should be equal to decompressPepaWay', async () => {
+    const arrayBuffer = await fetch(file).then((f) => f.arrayBuffer());
+    const zippedResult = FileZipUtils.compressPepaWay(arrayBuffer);
+
+    const result = FileZipUtils.decompressPepaWay(zippedResult);
+    expect(result).toEqual(file.split(',')[1]);
+  });
+});

package/src/lib/__test__/object.utils.spec.ts

@@ -0,0 +1,23 @@
+import { ObjectUtils } from '../object';
+
+const testObj = {
+  a1: {
+    a2: {
+      a3: 'aaa',
+    },
+    a21: 'aaaaa',
+  },
+  b: null,
+};
+
+describe('object utils', () => {
+  it('should pluck dot notation path', () => {
+    expect(ObjectUtils.pluck(testObj, 'a1.a2')).toBe(testObj.a1.a2);
+    expect(ObjectUtils.pluck(testObj, 'a1.a21')).toBe('aaaaa');
+    expect(ObjectUtils.pluck(testObj, 'b')).toBeNull();
+  });
+
+  it('should not crash when path does not exist on object', () => {
+    expect(ObjectUtils.pluck(testObj, 'c1.c2' as any)).toBe(undefined);
+  });
+});

package/src/lib/__test__/random.utils.spec.ts

@@ -0,0 +1,7 @@
+import { RandomUtils } from '../random';
+
+describe('random utils', () => {
+  it('randomId should generate something', () => {
+    expect(RandomUtils.randomId()).toBeDefined();
+  });
+});

package/src/lib/__test__/string.utils.spec.ts

@@ -0,0 +1,17 @@
+import { StringUtils } from '../string';
+
+describe('String utils', () => {
+  it('Sentence "Matfyz students are the best" should have 5 tokens.', () => {
+    const sentence = 'Matfyz students are the best.';
+    const tokens = StringUtils.tokenize(sentence);
+
+    expect(tokens.length).toEqual(5);
+  });
+
+  it('The method must be resistant to undefined value.', () => {
+    const result = StringUtils.tokenize(undefined);
+
+    expect(Array.isArray(result)).toBeTruthy();
+    expect(result.length).toEqual(0);
+  });
+});