Improve documention

.eslintignore

@@ -0,0 +1,4 @@
+# Build
+*.js
+*.map
+*.d.ts

.eslintrc.json

@@ -37,6 +37,7 @@
     "space-infix-ops": "error",
     "new-cap": ["error", {"capIsNewExceptionPattern": "Mixin$"}],
     "brace-style": ["error", "stroustrup", {"allowSingleLine": true}],
+    "operator-linebreak": ["error", "after", {"overrides": {"?": "before", ":": "before"}}],
     "@typescript-eslint/explicit-function-return-type": "error",
     "import/order": [
       "error",

.github/ISSUE_TEMPLATE/2-feature-request.yaml

@@ -1,5 +1,5 @@
 name: 'Feature Request'
-description: Suggest a feature for Angular Framework
+description: Suggest a feature for Alwatr packages
 
 body:
   - type: dropdown
@@ -12,6 +12,12 @@ body:
         - logger
         - router
         - signal
+        - token
+        - nano-server
+        - element
+        - i18n
+        - math
+        - font
         - Don't known / other
       multiple: true
     validations:

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Telegram group of Alwatr developers
+    url: 'https://t.me/AlwatrWG'
+    about: Communication with developers

packages/core/logger/README.md

@@ -16,7 +16,7 @@ function sayHello(name: string) {
 
 ### Debug Mode
 
-Many of the methods in the logger are no-ops when the debug mode is off.
+Many of the methods in the logger are no-ops when the debug mode is off in the browser.
 Please remember to **reload** the window after changing the debug mode.
 
 - Debugging all scopes
@@ -37,6 +37,8 @@ Please remember to **reload** the window after changing the debug mode.
   window.localStorage?.setItem('ALWATR_DEBUG', '*alwatr*');
   ```
 
+> Make sure the [log level](https://developer.chrome.com/docs/devtools/console/log/#browser) in set correctly.
+
 ## API
 
 ### `createLogger(scope: string, color: string, force = boolean)`

packages/core/logger/src/logger.ts

@@ -18,8 +18,8 @@ alwatrRegisteredList.push({
  * Color list storage for logger.
  */
 let colorIndex = 0;
-const colorList = isBrowser ?
-  [
+const colorList = isBrowser
+  ? [
     '#35b997',
     '#f05561',
     '#ee224a',
@@ -35,8 +35,8 @@ const colorList = isBrowser ?
     '#1da2dc',
     '#f05123',
     '#ee2524',
-  ] :
-  ['0;36', '0;35', '0;34', '0;33', '0;32']; // red and white omitted
+  ]
+  : ['0;36', '0;35', '0;34', '0;33', '0;32']; // red and white omitted
 
 const getNextColor = (): string => {
   const color = colorList[colorIndex];
@@ -47,9 +47,9 @@ const getNextColor = (): string => {
   return color;
 };
 
-const debugString = isBrowser ?
-  globalThis.localStorage?.getItem('ALWATR_DEBUG')?.trim() :
-  globalThis.process?.env?.ALWATR_DEBUG?.trim();
+const debugString = isBrowser
+  ? globalThis.localStorage?.getItem('ALWATR_DEBUG')?.trim()
+  : globalThis.process?.env?.ALWATR_DEBUG?.trim();
 
 const getDebugState = (scope: string): boolean => {
   if (debugString == null && isBrowser === false && globalThis.process.env.NODE_ENV !== 'production') {
@@ -128,13 +128,13 @@ export const createLogger = (
     color,
     scope,
 
-    accident: isBrowser ?
-      console.warn.bind(console, '%c%s%c.%s "%s" => Accident: "%s" (%s)!', styleScope, scope, style.reset) :
-      console.warn.bind(console, `${styleScope}⚠️  %s\x1b[33m.%s "%s" =>${style.reset}`, scope),
+    accident: isBrowser
+      ? console.warn.bind(console, '%c%s%c.%s "%s" => Accident: "%s" (%s)!', styleScope, scope, style.reset)
+      : console.warn.bind(console, `${styleScope}⚠️  %s\x1b[33m.%s "%s" =>${style.reset}`, scope),
 
-    error: isBrowser ?
-      console.error.bind(console, '%c%s%c.%s "%s" =>', styleScope, scope, style.reset) :
-      console.error.bind(console, `${styleScope}❌ %s\x1b[31m.%s "%s" =>\x1b[0;2m`, scope),
+    error: isBrowser
+      ? console.error.bind(console, '%c%s%c.%s "%s" =>', styleScope, scope, style.reset)
+      : console.error.bind(console, `${styleScope}❌ %s\x1b[31m.%s "%s" =>\x1b[0;2m`, scope),
   };
 
   if (!debug) {
@@ -161,9 +161,9 @@ export const createLogger = (
 
     logMethodFull: console.debug.bind(console, keySection + '.%s(%o); // %o', styleScope, scope, style.reset),
 
-    incident: isBrowser ?
-      console.trace.bind(console, '%c%s%c.%s() => Incident: "%s" (%s)!', styleScope, scope, style.reset) :
-      console.log.bind(console, `${styleScope}🔸 %s${style.reset}.%s() => Incident: "%s" (%s)!\x1b[0;2m`, scope),
+    incident: isBrowser
+      ? console.trace.bind(console, '%c%s%c.%s() => Incident: "%s" (%s)!', styleScope, scope, style.reset)
+      : console.log.bind(console, `${styleScope}🔸 %s${style.reset}.%s() => Incident: "%s" (%s)!\x1b[0;2m`, scope),
 
     logOther: console.debug.bind(console, keySection, styleScope, scope, style.reset),
   };

packages/core/nano-server/src/nano-server.ts

@@ -282,13 +282,13 @@ export class AlwatrConnection {
     catch {
       this._logger.accident('responseData', 'data_stringify_failed', 'JSON.stringify(data) failed!');
       return this.reply(
-        content.ok === false ?
-          {
+        content.ok === false
+          ? {
             ok: false,
             statusCode: content.statusCode,
             errorCode: content.errorCode,
-          } :
-          {
+          }
+          : {
             ok: false,
             statusCode: 500,
             errorCode: 'data_stringify_failed',

packages/core/signal/src/signal.ts

@@ -133,6 +133,7 @@ export class SignalInterface<SignalName extends keyof AlwatrSignals> {
   ): ListenerInterface<SignalName> {
     this._logger.logMethodArgs('setProvider', {options});
     const listener = _setSignalProvider(this._signal, this._requestSignal, signalProvider, options);
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
     return new ListenerInterface(this._requestSignal, listener);
   }
 
@@ -235,6 +236,7 @@ export class SignalInterface<SignalName extends keyof AlwatrSignals> {
   ): ListenerInterface<SignalName> {
     this._logger.logMethodArgs('addListener', {options});
     const listener = _addSignalListener(this._signal, listenerCallback, options);
+    // eslint-disable-next-line @typescript-eslint/no-use-before-define
     return new ListenerInterface(this._signal, listener);
   }
 }

packages/core/storage/src/storage.ts

@@ -5,7 +5,7 @@ import exitHook from 'exit-hook';
 
 import {readJsonFile, writeJsonFile} from './util.js';
 
-import type {DocumentObject, DocumentListStorage, AlwatrStorageConfig} from './type';
+import type {DocumentObject, DocumentListStorage, AlwatrStorageConfig} from './type.js';
 
 export {DocumentObject, DocumentListStorage, AlwatrStorageConfig as Config};