style(*): format all

MM25Zamanian · MM25Zamanian · commit b8a5f9ea2e3d · 2024-06-11T13:10:25.000+03:30
diff --git a/.prettierignore b/.prettierignore
@@ -0,0 +1,37 @@
+# Specifies intentionally untracked files to ignore when using Git
+# http://git-scm.com/docs/gitignore
+
+# OSX
+.DS_STORE
+.DS_Store
+._*
+
+# Windows
+Thumbs.db
+Desktop.ini
+
+# Logs
+*.log*
+
+# package managers
+.yarn/*
+#!.yarn/cache
+.pnp.*
+node_modules
+package-lock.json
+
+# Build
+dist
+build
+.tsbuildinfo
+*.map
+*.d.ts
+*.js
+!*.config.js
+!**/res/*.js
+
+# Output of 'npm pack'
+*.tgz
+
+# dotenv environment variables file
+.env
diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -20,24 +20,13 @@
     "*.njk": "html",
     "ssh-config": "ssh_config"
   },
-  "markdownlint.ignore": [
-    "**/CHANGELOG.md"
-  ],
+  "markdownlint.ignore": ["**/CHANGELOG.md"],
   "cSpell.language": "en,fa,fa-IR",
-  "cSpell.words": [
-    "Alwatr",
-    "Gecut"
-  ],
+  "cSpell.words": ["Alwatr", "Gecut"],
   "typescript.tsdk": ".yarn/sdks/typescript/lib",
   "git.autoStash": true,
-  "git.branchProtection": [
-    "main",
-    "next"
-  ],
-  "githubPullRequests.ignoredPullRequestBranches": [
-    "main",
-    "next"
-  ],
+  "git.branchProtection": ["main", "next"],
+  "githubPullRequests.ignoredPullRequestBranches": ["main", "next"],
   "search.exclude": {
     "**/.yarn": true,
     "**/.pnp.*": true
diff --git a/package.json b/package.json
@@ -44,7 +44,7 @@
     "build:r": "lerna run build",
     "format": "run-s format:prettier format:eslint",
     "format:eslint": "yarn run lint:ts --fix",
-    "format:prettier": "prettier . --ignore-path .gitignore --write",
+    "format:prettier": "prettier . --ignore-path .prettierignore --write",
     "clean": "git clean -d -x -f --exclude=node_modules --exclude='*.env' --exclude=_data --exclude='.pnp*' --exclude=.yarn",
     "serve": "wds",
     "watch": "run-p 'watch:*' serve",
diff --git a/packages/logger/CHANGELOG.md b/packages/logger/CHANGELOG.md
@@ -15,7 +15,7 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Bug Fixes
 
-* **logger:** dev mode ([2be55ca](https://github.com/gecut/hybrid-core/commit/2be55ca11d35009eb7a1c7e4cd11bc64428639a2)) by @MM25Zamanian
+- **logger:** dev mode ([2be55ca](https://github.com/gecut/hybrid-core/commit/2be55ca11d35009eb7a1c7e4cd11bc64428639a2)) by @MM25Zamanian
 
 ## [1.3.1-alpha.0](https://github.com/gecut/hybrid-core/compare/@gecut/logger@1.3.0...@gecut/logger@1.3.1-alpha.0) (2024-03-06)
 
@@ -25,4 +25,4 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Features
 
-* **logger:** new package ([04010de](https://github.com/gecut/hybrid-core/commit/04010de36f5e144d10d3f08b7c43a385c283087d)) by @MM25Zamanian
+- **logger:** new package ([04010de](https://github.com/gecut/hybrid-core/commit/04010de36f5e144d10d3f08b7c43a385c283087d)) by @MM25Zamanian
diff --git a/packages/logger/README.md b/packages/logger/README.md
@@ -24,15 +24,15 @@ npm install @gecut/logger
 Getting started with Gecut Logger is straightforward:
 
 ```ts
-import { GecutLogger } from '@gecut/logger';
+import {GecutLogger} from '@gecut/logger';
 
 const logger = new GecutLogger('MyApp');
 
 // Log an error with a method and description
 logger.error('init', 'INIT_FAIL', 'Initialization failed due to an unknown error');
 
 // Warn with additional arguments
-logger.warning('loadData', 'INVALID_RESPONSE', 'Data response is invalid', { userId: 1 });
+logger.warning('loadData', 'INVALID_RESPONSE', 'Data response is invalid', {userId: 1});
 
 // Begin a timed operation (development mode only)
 logger.time?.('fetchData');
@@ -47,7 +47,7 @@ logger.timeEnd?.('fetchData');
 const logger = new GecutLogger('UIComponent');
 
 // Trace a method call and its arguments
-logger.methodArgs?.('render', { items: 5 });
+logger.methodArgs?.('render', {items: 5});
 
 // Log a property change
 logger.property?.('isVisible', true);
diff --git a/packages/signal/CHANGELOG.md b/packages/signal/CHANGELOG.md
@@ -19,10 +19,10 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Bug Fixes
 
-* **signal:** exports path ([55dc9c0](https://github.com/gecut/hybrid-core/commit/55dc9c081cd266958c5e60aed84278c8024064ed)) by @MM25Zamanian
+- **signal:** exports path ([55dc9c0](https://github.com/gecut/hybrid-core/commit/55dc9c081cd266958c5e60aed84278c8024064ed)) by @MM25Zamanian
 
 # 2.0.0 (2024-03-04)
 
 ### Features
 
-* **signal:** new package ([e985df1](https://github.com/gecut/hybrid-core/commit/e985df19c9736b7a9f404ba63c88ba941df7c01b)) by @MM25Zamanian
+- **signal:** new package ([e985df1](https://github.com/gecut/hybrid-core/commit/e985df19c9736b7a9f404ba63c88ba941df7c01b)) by @MM25Zamanian
diff --git a/packages/signal/src/libraries/context.ts b/packages/signal/src/libraries/context.ts
@@ -1,4 +1,4 @@
-import { Signal } from './_signal.js';
+import {Signal} from './_signal.js';
 
 export class ContextSignal<T> extends Signal<T> {
   constructor(name: string) {
@@ -16,14 +16,22 @@ export class ContextSignal<T> extends Signal<T> {
     return this.value;
   }
 
+  async requireValue(): Promise<T> {
+    const value = this.value ?? (await this.__$untilNewNotify());
+
+    this.log.methodFull?.('requireValue', {}, value);
+
+    return value;
+  }
+
   /**
    * The function sets a value and notifies any subscribers.
    * @param {T} value - The parameter "value" is of type T, which means it can be any type.
    */
   setValue(value: T): void {
-    this.log.methodArgs?.('setValue', { value });
+    this.log.methodArgs?.('setValue', {value});
 
-    super.__$notify(value);
+    this.__$notify(value);
   }
 
   /**
@@ -43,7 +51,7 @@ export class ContextSignal<T> extends Signal<T> {
   untilChange(): Promise<T> {
     this.log.method?.('untilChange');
 
-    return super.__$untilNewNotify();
+    return this.__$untilNewNotify();
   }
 
   renotify() {
diff --git a/packages/signal/src/libraries/simple-signal.ts b/packages/signal/src/libraries/simple-signal.ts
@@ -1,4 +1,4 @@
-import { Signal } from './_signal.js';
+import {Signal} from './_signal.js';
 
 export class SimpleSignal<T> extends Signal<T> {
   constructor(name: string) {
@@ -10,7 +10,7 @@ export class SimpleSignal<T> extends Signal<T> {
    * @param {T} newValue - The new value to notify the subscribers with.
    */
   notify(newValue: T): void {
-    this.log.methodArgs?.('notify', { newValue });
+    this.log.methodArgs?.('notify', {newValue});
 
     this.__$notify(newValue);
   }
diff --git a/packages/types/CHANGELOG.md b/packages/types/CHANGELOG.md
@@ -11,26 +11,26 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Bug Fixes
 
-* **types:** exports path ([4c10dc8](https://github.com/gecut/hybrid-core/commit/4c10dc82b8336b2663c604e55ca90b497ebef6be)) by @MM25Zamanian
+- **types:** exports path ([4c10dc8](https://github.com/gecut/hybrid-core/commit/4c10dc82b8336b2663c604e55ca90b497ebef6be)) by @MM25Zamanian
 
 # [2.1.0](https://github.com/gecut/hybrid-core/compare/@gecut/types@2.0.0...@gecut/types@2.1.0) (2024-03-03)
 
 ### Bug Fixes
 
-* **types:** exports path ([b39395c](https://github.com/gecut/hybrid-core/commit/b39395c135988054d4a3559081605ea391a283d1)) by @MM25Zamanian
+- **types:** exports path ([b39395c](https://github.com/gecut/hybrid-core/commit/b39395c135988054d4a3559081605ea391a283d1)) by @MM25Zamanian
 
 # [2.0.0](https://github.com/gecut/hybrid-core/compare/@gecut/types@1.1.0...@gecut/types@2.0.0) (2024-03-03)
 
 ### Features
 
-* **types/lit:** `RenderResult` ([4351151](https://github.com/gecut/hybrid-core/commit/435115162b3b3f2707a1e4d4bb66a1bfd3f3042c)) by @MM25Zamanian
+- **types/lit:** `RenderResult` ([4351151](https://github.com/gecut/hybrid-core/commit/435115162b3b3f2707a1e4d4bb66a1bfd3f3042c)) by @MM25Zamanian
 
 # 1.1.0 (2024-03-03)
 
 ### Bug Fixes
 
-* **types:** eslint issues ([94b5425](https://github.com/gecut/hybrid-core/commit/94b5425854a19570b18205689305accb947bdd1d)) by @MM25Zamanian
+- **types:** eslint issues ([94b5425](https://github.com/gecut/hybrid-core/commit/94b5425854a19570b18205689305accb947bdd1d)) by @MM25Zamanian
 
 ### Features
 
-* **types:** create new package ([2a410f0](https://github.com/gecut/hybrid-core/commit/2a410f00280e75c4a4eb530d0424d3278f9d024b)) by @MM25Zamanian
+- **types:** create new package ([2a410f0](https://github.com/gecut/hybrid-core/commit/2a410f00280e75c4a4eb530d0424d3278f9d024b)) by @MM25Zamanian
diff --git a/packages/types/src/lit.ts b/packages/types/src/lit.ts
@@ -1,4 +1,4 @@
-import type { SingleOrArray } from './type-helper.js';
-import type { TemplateResult, noChange, nothing } from 'lit';
+import type {SingleOrArray} from './type-helper.js';
+import type {TemplateResult, noChange, nothing} from 'lit';
 
 export type RenderResult = SingleOrArray<TemplateResult> | typeof nothing | typeof noChange | unknown;
diff --git a/packages/types/src/type-helper.ts b/packages/types/src/type-helper.ts
@@ -7,9 +7,7 @@ export type Constructor<T> = new (...args: any[]) => T;
 export type MaybePromise<T> = T | Promise<T>;
 export type SingleOrArray<T> = T | T[];
 
-export type OmitFirstParam<F> = F extends (x: any, ...args: infer A) => infer R
-  ? (...args: A) => R
-  : never;
+export type OmitFirstParam<F> = F extends (x: any, ...args: infer A) => infer R ? (...args: A) => R : never;
 
 export type ArrowFunction<T = unknown> = () => T;
 
@@ -37,7 +35,7 @@ export type Stringifyable =
   | boolean
   | null
   | undefined
-  | { [P: string]: Stringifyable }
+  | {[P: string]: Stringifyable}
   | Stringifyable[];
 
 export type StringifyableRecord = Record<string, Stringifyable>;
diff --git a/packages/utilities/CHANGELOG.md b/packages/utilities/CHANGELOG.md
@@ -11,8 +11,8 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Features
 
-* **utilities/queue:** new utility ([b6dac24](https://github.com/gecut/hybrid-core/commit/b6dac24351eb021ea8e69565019621059bde9041)) by @MM25Zamanian
-* **utilities:** queue utility ([9d1ebcf](https://github.com/gecut/hybrid-core/commit/9d1ebcfa63c8e6e2eb51fd93587045ac17a4a68f)) by @MM25Zamanian
+- **utilities/queue:** new utility ([b6dac24](https://github.com/gecut/hybrid-core/commit/b6dac24351eb021ea8e69565019621059bde9041)) by @MM25Zamanian
+- **utilities:** queue utility ([9d1ebcf](https://github.com/gecut/hybrid-core/commit/9d1ebcfa63c8e6e2eb51fd93587045ac17a4a68f)) by @MM25Zamanian
 
 ## [5.1.1-alpha.0](https://github.com/gecut/hybrid-core/compare/@gecut/utilities@5.1.0...@gecut/utilities@5.1.1-alpha.0) (2024-03-06)
 
@@ -22,8 +22,8 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 ### Bug Fixes
 
-* **utilities:** eslint issues ([e0c2e7e](https://github.com/gecut/hybrid-core/commit/e0c2e7e1993b581f3242bef3dd1b8c47592b4ce5)) by @MM25Zamanian
+- **utilities:** eslint issues ([e0c2e7e](https://github.com/gecut/hybrid-core/commit/e0c2e7e1993b581f3242bef3dd1b8c47592b4ce5)) by @MM25Zamanian
 
 ### Features
 
-* **utilities:** new package ([ea36ee4](https://github.com/gecut/hybrid-core/commit/ea36ee40f2dc4f1d3bad1c04c5ea5ad3534441e9)) by @MM25Zamanian
+- **utilities:** new package ([ea36ee4](https://github.com/gecut/hybrid-core/commit/ea36ee40f2dc4f1d3bad1c04c5ea5ad3534441e9)) by @MM25Zamanian
diff --git a/packages/utilities/src/android-or-ios.ts b/packages/utilities/src/android-or-ios.ts
@@ -1,4 +1,4 @@
-import { detectOperatingSystem } from './detect-os';
+import {detectOperatingSystem} from './detect-os';
 
 export function isAndroid(): boolean {
   return detectOperatingSystem() === 'android';
diff --git a/packages/utilities/src/clipboard.ts b/packages/utilities/src/clipboard.ts
@@ -47,4 +47,4 @@ function write(text: string) {
   });
 }
 
-export default { write: 'clipboard' in navigator ? write : writeiOS };
+export default {write: 'clipboard' in navigator ? write : writeiOS};
diff --git a/packages/utilities/src/data-types/string.ts b/packages/utilities/src/data-types/string.ts
@@ -1,4 +1,4 @@
-import type { Nullable } from "@gecut/types";
+import type {Nullable} from '@gecut/types';
 
 export const stringUtils = {
   sanitizer<T extends Nullable<string>>(data: T): NonNullable<T> {
diff --git a/packages/utilities/src/debounce.ts b/packages/utilities/src/debounce.ts
@@ -28,8 +28,10 @@
  * // Only the last input will be logged after a delay of 500ms
  * ```
  */
-export default function debounce<Args extends unknown[], Return>(func: (...args: Args) => Return,
-  delay: number): (() => void) {
+export default function debounce<Args extends unknown[], Return>(
+  func: (...args: Args) => Return,
+  delay: number,
+): () => void {
   let timerId: NodeJS.Timeout;
 
   return (...args: Args) => {
diff --git a/packages/utilities/src/detect-os.ts b/packages/utilities/src/detect-os.ts
@@ -15,8 +15,7 @@ export function detectOperatingSystem() {
   else if (userAgent.indexOf('Android') != -1) {
     operatingSystem = 'android';
   }
-  else if (userAgent.indexOf('Mac') != -1 ||
-    userAgent.indexOf('iPhone') != -1) {
+  else if (userAgent.indexOf('Mac') != -1 || userAgent.indexOf('iPhone') != -1) {
     operatingSystem = 'ios';
   }
 
diff --git a/packages/utilities/src/env.ts b/packages/utilities/src/env.ts
@@ -1,8 +1,6 @@
-import { isBrowser } from './browser-or-node';
+import {isBrowser} from './browser-or-node';
 
-type EnvReturn<T extends 'string' | 'number'> = T extends 'number'
-  ? number
-  : string;
+type EnvReturn<T extends 'string' | 'number'> = T extends 'number' ? number : string;
 
 export function env<T extends 'string' | 'number', K extends EnvReturn<T>>(
   name: keyof typeof process.env,
diff --git a/packages/utilities/src/local-storage-json.ts b/packages/utilities/src/local-storage-json.ts
@@ -1,5 +1,5 @@
-import { isNode } from './browser-or-node';
-import { parseJson } from './parse-json';
+import {isNode} from './browser-or-node';
+import {parseJson} from './parse-json';
 
 function get<T>(name: string, defaultValue: T): T {
   if (isNode()) return defaultValue;
diff --git a/packages/utilities/src/object-partial.ts b/packages/utilities/src/object-partial.ts
@@ -1,15 +1,11 @@
-import type { ObjectBooleanize, ObjectPartial } from '@gecut/types';
+import type {ObjectBooleanize, ObjectPartial} from '@gecut/types';
 
-export default function objectPartial<
-  T extends Record<string, unknown>,
-  K extends ObjectBooleanize<T, true>,
->(_object: T, options: K): ObjectPartial<T, K> {
+export default function objectPartial<T extends Record<string, unknown>, K extends ObjectBooleanize<T, true>>(
+  _object: T,
+  options: K,
+): ObjectPartial<T, K> {
   for (const key of Object.keys(_object)) {
-    if (
-      typeof _object[key] === 'object' &&
-      _object[key] != null &&
-      options[key] != null
-    ) {
+    if (typeof _object[key] === 'object' && _object[key] != null && options[key] != null) {
       _object[key as unknown as keyof T] = objectPartial(
         _object[key as unknown as keyof T] as never,
         options[key] as never,
diff --git a/packages/utilities/src/share-sms.ts b/packages/utilities/src/share-sms.ts
@@ -1,12 +1,10 @@
-import { isiOS } from './android-or-ios';
-import { requiredBrowser } from './browser-or-node';
+import {isiOS} from './android-or-ios';
+import {requiredBrowser} from './browser-or-node';
 
 export default function shareSMS(phoneNumber: string, message: string) {
   requiredBrowser();
 
   const separator = isiOS() ? '&' : '?';
 
-  window.open(
-    `sms:${phoneNumber}${separator}body=${encodeURIComponent(message)}`,
-  );
+  window.open(`sms:${phoneNumber}${separator}body=${encodeURIComponent(message)}`);
 }
diff --git a/packages/utilities/src/state-manager.ts b/packages/utilities/src/state-manager.ts
@@ -1,11 +1,10 @@
-import type { ArrowFunction } from '@gecut/types';
+import type {ArrowFunction} from '@gecut/types';
 
-export type StateManager<
-  STATE_KEYS extends string = string,
-  STATE_FUNC_RETURN = unknown,
-> = Record<STATE_KEYS, ArrowFunction<STATE_FUNC_RETURN>>;
+export type StateManager<STATE_KEYS extends string = string, STATE_FUNC_RETURN = unknown> = Record<
+  STATE_KEYS,
+  ArrowFunction<STATE_FUNC_RETURN>
+>;
 
-export function stateManager<T extends StateManager, S extends keyof T>(states: T,
-  state: S): ReturnType<T[S]> {
+export function stateManager<T extends StateManager, S extends keyof T>(states: T, state: S): ReturnType<T[S]> {
   return states[state]() as ReturnType<T[S]>;
 }
diff --git a/packages/utilities/src/uid.ts b/packages/utilities/src/uid.ts
@@ -1,6 +1,3 @@
 export function uid() {
-  return (Date.now().toString(36) + Math.random().toString(36)).replaceAll(
-    '.',
-    '-',
-  );
+  return (Date.now().toString(36) + Math.random().toString(36)).replaceAll('.', '-');
 }
diff --git a/packages/utilities/src/wait/polyfill.ts b/packages/utilities/src/wait/polyfill.ts
diff --git a/packages/utilities/src/wait/wait.ts b/packages/utilities/src/wait/wait.ts
