Implementation of localization packages and manager.

.github/workflows/nodejs.yml

@@ -0,0 +1,42 @@
+# This workflow will do a clean install of node dependencies, build the source code and run tests across different versions of node
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [ master, '[0-9]+.[0-9]+.x' ]
+  pull_request:
+    branches: [ master, '[0-9]+.[0-9]+.x' ]
+
+jobs:
+  run-tests:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x, 22.x]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+            node-version: ${{ matrix.node-version }}
+            cache: 'npm'
+      - name: Install packages
+        run: npm ci
+      - name: Install Playwright
+        run: npx playwright install --with-deps --only-shell chromium
+      - name: Lint
+        run: npm run lint
+      - name: Build Core & Resources
+        run: npm run build
+      - name: Test
+        run: npm run test
+      - name: Publish to coveralls.io
+        if: github.repository == 'IgniteUI/igniteui-i18n' && matrix.node-version == '20.x'
+        uses: coverallsapp/[email protected]
+        with:
+            github-token: ${{ github.token }}

.github/workflows/npm-publish.yml

@@ -27,21 +27,37 @@ jobs:
       - name: Build the package
         run: npm run build
 
-      - name: Version the package
+      - name: Set peer dependency versions for core package
+        shell: pwsh
+        run: |
+          $pattern = '"igniteui-i18n-resources": "\S?(?<version>(\d\S?)+)"'
+          $filePath = "dist/igniteui-i18n-core/package.json"
+          (Get-Content -Path $filePath -Raw) -replace $pattern, "`"igniteui-i18n-resources`": `"$env:VERSION`"" | Set-Content $filePath
+          Write-Output (Get-Content -Path $filePath -Raw)
+
+      - name: Version the core package
         run: npm version ${VERSION} --no-git-tag-version --save --verbose
         working-directory: dist/igniteui-i18n-core
 
-      - name: Publish the package
+      - name: Publish the core package
         run: npm publish --tag ${NPM_TAG}
         working-directory: dist/igniteui-i18n-core
         env:
           NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
 
-      - name: Version the package
+      - name: Set dependency versions for resource package
+        shell: pwsh
+        run: |
+          $pattern = '"igniteui-i18n-core": "\S?(?<version>(\d\S?)+)"'
+          $filePath = "dist/igniteui-i18n-resources/package.json"
+          (Get-Content -Path $filePath -Raw) -replace $pattern, "`"igniteui-i18n-core`": `"$env:VERSION`"" | Set-Content $filePath
+          Write-Output (Get-Content -Path $filePath -Raw)
+
+      - name: Version the resources package
         run: npm version ${VERSION} --no-git-tag-version --save --verbose
         working-directory: dist/igniteui-i18n-resources
 
-      - name: Publish the package
+      - name: Publish the resources package
         run: npm publish --tag ${NPM_TAG}
         working-directory: dist/igniteui-i18n-resources
         env:

.gitignore

@@ -1,3 +1,11 @@
+# IDE - VSCode/VS
+.vscode/*
+.vs/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
 # Logs
 logs
 *.log
@@ -137,3 +145,10 @@ dist
 # Vite logs files
 vite.config.js.timestamp-*
 vite.config.ts.timestamp-*
+
+
+# compiled output
+/dist
+/tmp
+/out-tsc
+/test-results

.prettierignore

@@ -0,0 +1,7 @@
+dist
+coverage
+test-results
+package-lock.json
+*.min.*
+*.yml
+*.md

.prettierrc.json

@@ -0,0 +1,17 @@
+{
+  "tabWidth": 4,
+  "singleQuote": true,
+  "trailingComma": "none",
+  "printWidth": 120,
+  "endOfLine": "auto",
+  "overrides": [
+    {
+      "files": ["*.json", "*.mjs"],
+      "options": {
+        "tabWidth": 2,
+        "singleQuote": false,
+        "trailingComma": "es5"
+      }
+    }
+  ]
+}

LICENSE

@@ -0,0 +1,16 @@
+This is a commercial product, requiring a valid paid-for license for commercial use.
+This product is free to use for non-commercial educational use for students in K through 12 grades
+or University programs, and for educators to use in a classroom setting as examples / tools in their curriculum.
+
+In order for us to verify your eligibility for free usage, please register for trial at
+https://Infragistics.com/Angular and open a support ticket with a request for free license.
+
+To acquire a license for commercial usage, please register for trial at https://Infragistics.com/Angular
+and refer to the purchasing options in the pricing section on the product page.
+
+This repository includes code originally copied from https://github.com/zloirock/core-js
+in the projects/igniteui-angular/src/lib/core/setImmediate.ts file. The original version of the code is MIT licensed. See the file header for details.
+
+© Copyright 2020 INFRAGISTICS. All Rights Reserved.
+The Infragistics Ultimate license & copyright applies to this distribution.
+For information on that license, please go to our website https://www.infragistics.com/legal/license.

README.md

@@ -1,2 +1,103 @@
-# igniteui-i18n-core
-Ignite UI Internationalization packages, containing localization functionality, translation resources and locale formatting.
+<h1 align="center">
+  Ignite UI Localization - from Infragistics 
+</h1>
+
+![Node.js CI](https://github.com/IgniteUI/igniteui-i18n/workflows/Node.js%20CI/badge.svg)
+[![Coverage Status](https://coveralls.io/repos/github/IgniteUI/igniteui-i18n/badge.svg?branch=master)](https://coveralls.io/github/IgniteUI/igniteui-i18n?branch=master)
+[![npm version](https://badge.fury.io/js/igniteui-i18n.svg)](https://badge.fury.io/js/igniteui-i18n)
+
+The Ignite UI i18n repository provides localized strings and locale formatting to all Ignite UI products and components. The core package provides the functionality for locale and resource strings management, while the resources package provides localized resource strings for each currently supported language by Ignite UI. Both combined gives a unified and easy way of setting desired language or locale for the Ignite UI components globally and individually for each component.
+
+## Setup
+
+To setup the repo for local work run:
+
+```
+npm install
+```
+
+## Building
+
+To build all packages run:
+
+```
+npm run build
+```
+
+To build just the core package run:
+
+```
+npm run build:core
+```
+
+To build just the resources package run:
+
+```
+npm run build:resources
+```
+
+## Lint
+
+The repo follows coding guidelines, which are kept in check using lint. To run it locally run:
+
+```
+npm run lint
+```
+
+For any prettier errors make sure to run the `pretty:fix` command, as it should address most of the issues. For easier you can use the [`Prettier plugin`](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) and enable `editor.formatOnSave` setting.
+
+## Tests
+
+The repo uses [Vitest](https://vitest.dev/guide/) for a base testing framework and [Playwright](https://vitest.dev/guide/browser/playwright.html) for in browser testing. Also the ability for out of browser testing is available using [jsdom](https://github.com/jsdom/jsdom). It is highly encouraged to use the native browser one, while the other can be used for easier debugging of tests and core functionality, but keep in might the nature of `jsdom` not being a native browser.
+
+If you are using `VSCode`, I recommend to install the [Vitest extension](https://marketplace.visualstudio.com/items?itemName=vitest.explorer) as well, otherwise debugging using `Javscript Debug Console` does not work for me as expected and the source maps are not correct. Maybe its a config issue, but using the plugin is easier anyway for debugging.
+
+To run the tests run:
+
+```
+npm run test
+```
+
+If you use Playwright for the first time it will throw an error. Just install the necessary dependencies using:
+
+```
+npx playwright install --with-deps --only-shell chromium
+```
+
+By default the tests run in `headless` mode using `Chromium`. If you would like to see it in the browser itself you need to set [headless](https://vitest.dev/guide/browser/config.html#browser-headless) option in the `vitest.browser.config.ts` file for the desired browser:
+
+```
+test: {
+        browser: {
+            headless: false
+        }
+}
+```
+
+To run a specific test, set in the test source `only` option for a test in the following way:
+
+```typescript
+it('should test something', { only: true }, () => {
+    // Test code
+});
+```
+
+The following way should also work (but not for me :s ):
+
+```typescript
+it.only('should test something', () => {
+    // Test code
+});
+```
+
+## License
+
+This is a commercial product, requiring a valid paid-for license for commercial use.
+This product is free to use for non-commercial educational use for students in K through 12 grades or University programs, and for educators to use in a classroom setting as examples / tools in their curriculum.
+In order for us to verify your eligibility for free usage, please [register for trial](https://Infragistics.com/Angular) and open a support ticket with a request for free license.
+
+To acquire a license for commercial usage, please [register for trial](https://Infragistics.com/Angular) and refer to the purchasing options in the pricing section on the product page.
+
+© Copyright 2020 INFRAGISTICS. All Rights Reserved.
+The Infragistics Ultimate license & copyright applies to this distribution.
+For information on that license, please go to our website [https://www.infragistics.com/legal/license](https://www.infragistics.com/legal/license).

biome.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
+  "files": {
+    "includes": ["**/src/**/*.ts", "**/src/**/*.js", "**/stories/**/*.ts"]
+  },
+  "vcs": {
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "assist": {
+    "includes": ["**/src/**/*.ts", "!src/index.ts"],
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  },
+  "formatter": {
+    "enabled": false
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "complexity": {
+        "noForEach": "off",
+        "noStaticOnlyClass": "off"
+      },
+      "correctness": {
+        "noUnusedVariables": "error",
+        "noUnusedFunctionParameters": "error",
+        "noUnusedImports": "error",
+        "noUnusedPrivateClassMembers": "error",
+        "useImportExtensions": {
+          "level": "error",
+          "options": { "forceJsExtensions": true }
+        }
+      },
+      "style": {
+        "noNamespace": "error",
+        "useCollapsedElseIf": "error",
+        "noNonNullAssertion": "off",
+        "noParameterAssign": "off",
+        "useAsConstAssertion": "error",
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
+        "useSelfClosingElements": "error",
+        "useSingleVarDeclarator": "error",
+        "noUnusedTemplateLiteral": "error",
+        "useNumberNamespace": "error",
+        "noInferrableTypes": "error",
+        "noUselessElse": "off",
+        "useTemplate": "off"
+      },
+      "suspicious": {
+        "noConsole": "off",
+        "noDebugger": "error",
+        "noExplicitAny": "off"
+      }
+    }
+  }
+}

gulpfile.js

@@ -0,0 +1,25 @@
+'use strict';
+
+const gulp = require('gulp');
+const path = require('path');
+const del = require('del');
+
+exports.cleanCoreBuild = () => {
+    return del.deleteAsync('dist/igniteui-i18n-core/**', { force: true });
+};
+
+exports.cleanResourcesBuild = () => {
+    return del.deleteAsync('dist/igniteui-i18n-resources/**', { force: true });
+};
+
+exports.copyPackageForCore = () => {
+    return gulp
+        .src([path.join(__dirname, 'projects/igniteui-i18n-core/package.json')])
+        .pipe(gulp.dest(path.join(__dirname, 'dist/igniteui-i18n-core')));
+};
+
+exports.copyPackageForResources = () => {
+    return gulp
+        .src([path.join(__dirname, 'projects/igniteui-i18n-resources/package.json')])
+        .pipe(gulp.dest(path.join(__dirname, 'dist/igniteui-i18n-resources')));
+};

index.html

@@ -0,0 +1,6 @@
+<html>
+    <head>
+        <title>Ignite UI i18n Empty TestBed</title>
+    </head>
+    <body></body>
+</html>