@nemigo/helpers 0.4.3 → 0.5.0

package/dist/cases.d.ts

@@ -1,11 +1,11 @@
-export type CaseResult<V, T> = (value: V | null, mutate: boolean) => T;
+export type CaseResult<V, T> = (value: V | undefined, mutate: boolean) => T;
 /**
  * Отлов строковых значений
  *
  * - `string` → `string`, `false`
  * - `number` → `string`, `true`
- * - `NaN` → `null`, `false`
- * - `ETC` → `null`, `false`
+ * - `NaN` → `undefined`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export declare const caseString: <T>(value: unknown, call: CaseResult<string, T>) => T;
 /**
@@ -13,8 +13,8 @@ export declare const caseString: <T>(value: unknown, call: CaseResult<string, T>
  *
  * - `number` → `number`, `false`
  * - `string` → `number`, `true`
- * - `NaN` → `null`, `false`
- * - `ETC` → `null`, `false`
+ * - `NaN` → `undefined`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export declare const caseNumber: <T>(value: unknown, call: CaseResult<number, T>) => T;
 /**
@@ -25,6 +25,6 @@ export declare const caseNumber: <T>(value: unknown, call: CaseResult<number, T>
  * - `"true"` -> `boolean`, `true`
  * - `0` -> `boolean`, `true`
  * - `1` -> `boolean`, `true`
- * - `ETC` → `null`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export declare const caseBoolean: <T>(value: unknown, call: CaseResult<boolean, T>) => T;

package/dist/cases.js

@@ -3,8 +3,8 @@
  *
  * - `string` → `string`, `false`
  * - `number` → `string`, `true`
- * - `NaN` → `null`, `false`
- * - `ETC` → `null`, `false`
+ * - `NaN` → `undefined`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export const caseString = (value, call) => {
     switch (typeof value) {
@@ -14,20 +14,20 @@ export const caseString = (value, call) => {
             if (!isNaN(value))
                 return call(String(value), true);
     }
-    return call(null, false);
+    return call(undefined, false);
 };
 /**
  * Отлов числовых значений
  *
  * - `number` → `number`, `false`
  * - `string` → `number`, `true`
- * - `NaN` → `null`, `false`
- * - `ETC` → `null`, `false`
+ * - `NaN` → `undefined`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export const caseNumber = (value, call) => {
     switch (typeof value) {
         case "number":
-            return call(isNaN(value) ? null : value, false);
+            return call(isNaN(value) ? undefined : value, false);
         case "string": {
             const trimmed = value.trim();
             const number = Number(trimmed);
@@ -35,7 +35,7 @@ export const caseNumber = (value, call) => {
                 return call(number, true);
         }
     }
-    return call(null, false);
+    return call(undefined, false);
 };
 /**
  * Отлов булевых значений
@@ -45,7 +45,7 @@ export const caseNumber = (value, call) => {
  * - `"true"` -> `boolean`, `true`
  * - `0` -> `boolean`, `true`
  * - `1` -> `boolean`, `true`
- * - `ETC` → `null`, `false`
+ * - `ETC` → `undefined`, `false`
  */
 export const caseBoolean = (value, call) => {
     switch (typeof value) {
@@ -65,5 +65,5 @@ export const caseBoolean = (value, call) => {
                 return call(true, true);
         }
     }
-    return call(null, false);
+    return call(undefined, false);
 };

package/dist/datetime.d.ts

@@ -29,6 +29,16 @@ export declare const abbs: string[];
  * console.log(formatted); // "09.10.2023 14:30:59"
  */
 export declare const formatDateTime: (datetime?: Date | Timestamp | string, format?: string, timezone?: number) => string;
+/**
+ * Готовый пресет для {@link formatDateTime}
+ *
+ * `DD.DM.DY TH:TM (МСК)` с МСК-флагом
+ *
+ * @example
+ * const mskTime = formatMSK(Date.now());
+ * console.log(mskTime); // "09.10.2023 14:30 (МСК)"
+ */
+export declare const formatMSK: (timestamp?: Timestamp, format?: string) => string;
 /**
  * Конвертирует строковые представления даты и времени в {@link Timestamp}
  *

package/dist/datetime.js

@@ -94,6 +94,16 @@ export const formatDateTime = (datetime = Date.now(), format = "DD.DM.DY TH:TM",
     }
     return result.join("");
 };
+/**
+ * Готовый пресет для {@link formatDateTime}
+ *
+ * `DD.DM.DY TH:TM (МСК)` с МСК-флагом
+ *
+ * @example
+ * const mskTime = formatMSK(Date.now());
+ * console.log(mskTime); // "09.10.2023 14:30 (МСК)"
+ */
+export const formatMSK = (timestamp = Date.now(), format = "DD.DM.DY TH:TM (МСК)") => formatDateTime(timestamp, format, 3);
 //...
 /**
  * Конвертирует строковые представления даты и времени в {@link Timestamp}

package/dist/format.js

@@ -7,7 +7,7 @@ export const FormatNumberRegExp = /\B(?=(\d{3})+(?!\d))/g;
  * @example "1 234" или "1 234,56"
  */
 export const formatNumber = (amount, { fraction = 2, fallback = "---", zero = "value", postfix } = {}) => caseNumber(amount, (v) => {
-    if (v === null)
+    if (v === undefined)
         return zero === "always" ? (postfix ? "0 " + postfix : "0") : fallback;
     if (v === 0)
         return zero === "never" ? fallback : postfix ? "0 " + postfix : "0";

package/dist/xod.js

@@ -27,7 +27,7 @@ export const nullSchema = z.union([
     }),
 ]);
 //...
-export const booleanSchema = z.unknown().transform((value, ctx) => caseBoolean(value, (result) => result === null
+export const booleanSchema = z.unknown().transform((value, ctx) => caseBoolean(value, (result) => result === undefined
     ? invalid(value, ctx, {
         message: "It isn't a boolean",
         expected: "boolean (or string / number like boolean)",
@@ -35,7 +35,7 @@ export const booleanSchema = z.unknown().transform((value, ctx) => caseBoolean(v
     : result));
 export const booleanSchemaOptional = z.union([nullSchema, booleanSchema]);
 //...
-export const numberSchema = z.unknown().transform((value, ctx) => caseNumber(value, (result) => result === null
+export const numberSchema = z.unknown().transform((value, ctx) => caseNumber(value, (result) => result === undefined
     ? invalid(value, ctx, {
         message: "It isn't a number",
         expected: "number (or string like number)",
@@ -44,7 +44,7 @@ export const numberSchema = z.unknown().transform((value, ctx) => caseNumber(val
 export const numberSchemaOptional = z.union([nullSchema, numberSchema]);
 //...
 export const stringSchema = z.unknown().transform((value, ctx) => caseString(value, (result) => {
-    const trimmed = result === null ? "" : result.trim();
+    const trimmed = result === undefined ? "" : result.trim();
     return trimmed === ""
         ? invalid(value, ctx, {
             message: "It isn't a string or empty string",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/helpers",
-	"version": "0.4.3",
+	"version": "0.5.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",