@lssm/lib.utils-typescript 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060433

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { AwaitedResult } from "./lib/AwaitedResult.js";
+import { BrowserNativeObject } from "./lib/BrowserNativeObject.js";
+import { DeepInfiniteArray } from "./lib/DeepInfiniteArray.js";
+import { KeepOnly } from "./lib/KeepOnly.js";
+import { DeepKeepOnly } from "./lib/DeepKeepOnly.js";
+import { DeepKey } from "./lib/DeepKey.js";
+import { IsAny } from "./lib/IsAny.js";
+import { NestedValue } from "./lib/NestedValue.js";
+import { NonUndefined } from "./lib/NonUndefined.js";
+import { DeepMap } from "./lib/DeepMap.js";
+import { DeepOr } from "./lib/DeepOr.js";
+import { DeepNullable } from "./lib/DeepNullable.js";
+import { DeepPartial } from "./lib/DeepPartial.js";
+import { DeepReplace } from "./lib/DeepReplace.js";
+import { DeepReplaceNullByUndefined } from "./lib/DeepReplaceNullByUndefined.js";
+import { DeepValue } from "./lib/DeepValue.js";
+import { DictionaryFromEnum } from "./lib/DictionaryFromEnum.js";
+import { DictionaryFromEnumMapping } from "./lib/DictionaryFromEnumMapping.js";
+import { AnyRecord, EmptyRecord, UnknownRecord } from "./lib/EmptyRecord.js";
+import { Identified } from "./lib/Identified.js";
+import { IdentifiedLabel } from "./lib/IdentifiedLabel.js";
+import { ExtendedJsonObject, JSONArray, JSONObject, JSONValue, NonJsonArray, NonJsonObject, NonJsonValue, PrimitiveJSONValue } from "./lib/Json.js";
+import { Maybe } from "./lib/Maybe.js";
+import { MaybeArray } from "./lib/MaybeArray.js";
+import { Primitive } from "./lib/Primitive.js";
+import { Replaced } from "./lib/Replaced.js";
+import { ReverseMap } from "./lib/ReverseMap.js";
+import { Satisfies } from "./lib/Satisfies.js";
+import { StringKey } from "./lib/StringKey.js";
+import { StringKeysOnly } from "./lib/StringKeysOnly.js";
+import { staticShouldNotHappen } from "./staticShouldNotHappen.js";
+export { AnyRecord, AwaitedResult, BrowserNativeObject, DeepInfiniteArray, DeepKeepOnly, DeepKey, DeepMap, DeepNullable, DeepOr, DeepPartial, DeepReplace, DeepReplaceNullByUndefined, DeepValue, DictionaryFromEnum, DictionaryFromEnumMapping, EmptyRecord, ExtendedJsonObject, Identified, IdentifiedLabel, IsAny, JSONArray, JSONObject, JSONValue, KeepOnly, Maybe, MaybeArray, NestedValue, NonJsonArray, NonJsonObject, NonJsonValue, NonUndefined, Primitive, PrimitiveJSONValue, Replaced, ReverseMap, Satisfies, StringKey, StringKeysOnly, UnknownRecord, staticShouldNotHappen };

package/dist/lib/AwaitedResult.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/AwaitedResult.d.ts
+type AwaitedResult<T extends (...args: any) => any> = Awaited<ReturnType<T>>;
+//#endregion
+export { AwaitedResult };

package/dist/lib/BrowserNativeObject.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/BrowserNativeObject.d.ts
+declare type BrowserNativeObject = Date | FileList | File;
+//#endregion
+export { BrowserNativeObject };

package/dist/lib/DeepInfiniteArray.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DeepInfiniteArray.d.ts
+declare type DeepInfiniteArray<T> = (T | DeepInfiniteArray<T>)[];
+//#endregion
+export { DeepInfiniteArray };

package/dist/lib/DeepKeepOnly.d.ts

@@ -0,0 +1,6 @@
+import { KeepOnly } from "./KeepOnly.js";
+
+//#region src/lib/DeepKeepOnly.d.ts
+type DeepKeepOnly<T, KeepType> = T | (T extends (infer U)[] ? KeepOnly<U, KeepType>[] : T extends Map<infer K, infer V> ? Map<KeepOnly<K, KeepType>, KeepOnly<V, KeepType>> : T extends Set<infer M> ? Set<KeepOnly<M, KeepType>> : KeepOnly<T, KeepType>);
+//#endregion
+export { DeepKeepOnly };

package/dist/lib/DeepKey.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DeepKey.d.ts
+type DeepKey<T, K extends keyof T = keyof T> = K extends string | number ? T[K] extends infer R ? `${K}` | (R extends Record<string, unknown> ? `${K}.${DeepKey<R>}` : never) : never : never;
+//#endregion
+export { DeepKey };

package/dist/lib/DeepMap.d.ts

@@ -0,0 +1,9 @@
+import { BrowserNativeObject } from "./BrowserNativeObject.js";
+import { IsAny } from "./IsAny.js";
+import { NestedValue } from "./NestedValue.js";
+import { NonUndefined } from "./NonUndefined.js";
+
+//#region src/lib/DeepMap.d.ts
+declare type DeepMap<T, TValue> = IsAny<T> extends true ? any : T extends BrowserNativeObject | NestedValue ? TValue : T extends object ? { [K in keyof T]: DeepMap<NonUndefined<T[K]>, TValue> } : TValue;
+//#endregion
+export { DeepMap };

package/dist/lib/DeepNullable.d.ts

@@ -0,0 +1,6 @@
+import { DeepOr } from "./DeepOr.js";
+
+//#region src/lib/DeepNullable.d.ts
+type DeepNullable<T> = DeepOr<T, null>;
+//#endregion
+export { DeepNullable };

package/dist/lib/DeepOr.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DeepOr.d.ts
+type DeepOr<T, OrValue> = T | (T extends (infer U)[] ? DeepOr<U, OrValue>[] : T extends Map<infer K, infer V> ? Map<DeepOr<K, OrValue>, DeepOr<V, OrValue>> : T extends Set<infer M> ? Set<DeepOr<M, OrValue>> : T extends object ? { [K in keyof T]: DeepOr<T[K], OrValue> | OrValue } : T);
+//#endregion
+export { DeepOr };

package/dist/lib/DeepPartial.d.ts

@@ -0,0 +1,7 @@
+//#region src/lib/DeepPartial.d.ts
+/**
+ * Same as Partial<T> but goes deeper and makes Partial<T> all its properties and sub-properties.
+ */
+type DeepPartial<T> = { [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P] };
+//#endregion
+export { DeepPartial };

package/dist/lib/DeepReplace.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DeepReplace.d.ts
+type DeepReplace<T, Search, Replace> = T extends (infer ArrayItemT)[] ? DeepReplace<ArrayItemT, Search, Replace>[] : T extends Map<infer MapKey, infer MapT> ? Map<DeepReplace<MapKey, Search, Replace>, DeepReplace<MapT, Search, Replace>> : T extends Set<infer SetT> ? Set<DeepReplace<SetT, Search, Replace>> : T extends object ? { [ObjKey in keyof T]: DeepReplace<T[ObjKey], Search, Replace> } : T extends Search ? Replace : T;
+//#endregion
+export { DeepReplace };

package/dist/lib/DeepReplaceNullByUndefined.d.ts

@@ -0,0 +1,6 @@
+import { DeepReplace } from "./DeepReplace.js";
+
+//#region src/lib/DeepReplaceNullByUndefined.d.ts
+type DeepReplaceNullByUndefined<T> = DeepReplace<T, null, undefined>;
+//#endregion
+export { DeepReplaceNullByUndefined };

package/dist/lib/DeepValue.d.ts

@@ -0,0 +1,6 @@
+import { DeepKey } from "./DeepKey.js";
+
+//#region src/lib/DeepValue.d.ts
+type DeepValue<T, P extends DeepKey<T>> = P extends `${infer K}.${infer Rest}` ? T[(K extends `${infer R extends number}` ? R : K) & keyof T] extends infer S ? S extends never ? never : Rest extends DeepKey<S> ? DeepValue<S, Rest> : never : never : T[(P extends `${infer R extends number}` ? R : P) & keyof T];
+//#endregion
+export { DeepValue };

package/dist/lib/DictionaryFromEnum.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DictionaryFromEnum.d.ts
+type DictionaryFromEnum<Enum, ObjMapping> = Record<keyof Enum, ObjMapping>;
+//#endregion
+export { DictionaryFromEnum };

package/dist/lib/DictionaryFromEnumMapping.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/DictionaryFromEnumMapping.d.ts
+type DictionaryFromEnumMapping<Enum, Mapped, Mapping extends Record<keyof Enum, Mapped>> = { [k in keyof Enum]: Mapping[k] };
+//#endregion
+export { DictionaryFromEnumMapping };

package/dist/lib/EmptyRecord.d.ts

@@ -0,0 +1,6 @@
+//#region src/lib/EmptyRecord.d.ts
+type EmptyRecord = Record<string, never>;
+type UnknownRecord = Record<string, unknown>;
+type AnyRecord = Record<string, any>;
+//#endregion
+export { AnyRecord, EmptyRecord, UnknownRecord };

package/dist/lib/Identified.d.ts

@@ -0,0 +1,6 @@
+//#region src/lib/Identified.d.ts
+interface Identified {
+  id: string;
+}
+//#endregion
+export { Identified };

package/dist/lib/IdentifiedLabel.d.ts

@@ -0,0 +1,8 @@
+import { Identified } from "./Identified.js";
+
+//#region src/lib/IdentifiedLabel.d.ts
+type IdentifiedLabel = Identified & {
+  label: string;
+};
+//#endregion
+export { IdentifiedLabel };

package/dist/lib/IsAny.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/IsAny.d.ts
+declare type IsAny<T> = 0 extends 1 & T ? true : false;
+//#endregion
+export { IsAny };

package/dist/lib/Json.d.ts

@@ -0,0 +1,15 @@
+//#region src/lib/Json.d.ts
+declare type PrimitiveJSONValue = string | number | boolean | undefined | null;
+declare type JSONValue = PrimitiveJSONValue | JSONArray | JSONObject;
+interface JSONArray extends Array<JSONValue> {}
+interface JSONObject {
+  [key: string]: JSONValue;
+}
+declare type NonJsonValue<ExtraTypes> = PrimitiveJSONValue | NonJsonArray<ExtraTypes> | NonJsonObject<ExtraTypes> | ExtraTypes;
+interface NonJsonArray<ExtraTypes> extends Array<NonJsonValue<ExtraTypes>> {}
+interface NonJsonObject<ExtraTypes> {
+  [key: string]: NonJsonValue<ExtraTypes>;
+}
+type ExtendedJsonObject = NonJsonObject<bigint | Date>;
+//#endregion
+export { ExtendedJsonObject, JSONArray, JSONObject, JSONValue, NonJsonArray, NonJsonObject, NonJsonValue, PrimitiveJSONValue };

package/dist/lib/KeepOnly.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/KeepOnly.d.ts
+type KeepOnly<T, KeepType> = T extends object ? { [K in keyof T]: KeepOnly<T[K], KeepType> } : T extends KeepType ? T : never;
+//#endregion
+export { KeepOnly };

package/dist/lib/Maybe.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/Maybe.d.ts
+type Maybe<T> = T | null;
+//#endregion
+export { Maybe };

package/dist/lib/MaybeArray.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/MaybeArray.d.ts
+type MaybeArray<T> = T | T[];
+//#endregion
+export { MaybeArray };

package/dist/lib/NestedValue.d.ts

@@ -0,0 +1,7 @@
+//#region src/lib/NestedValue.d.ts
+declare const $NestedValue: unique symbol;
+declare type NestedValue<TValue extends object = object> = {
+  [$NestedValue]: never;
+} & TValue;
+//#endregion
+export { NestedValue };

package/dist/lib/NonUndefined.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/NonUndefined.d.ts
+declare type NonUndefined<T> = T extends undefined ? never : T;
+//#endregion
+export { NonUndefined };

package/dist/lib/Primitive.d.ts

@@ -0,0 +1,6 @@
+import { PrimitiveJSONValue } from "./Json.js";
+
+//#region src/lib/Primitive.d.ts
+declare type Primitive = PrimitiveJSONValue | symbol | bigint;
+//#endregion
+export { Primitive };

package/dist/lib/Replaced.d.ts

@@ -0,0 +1,6 @@
+import { Primitive } from "./Primitive.js";
+
+//#region src/lib/Replaced.d.ts
+type Replaced<T, TReplace, TWith, TKeep = Primitive> = T extends TReplace | TKeep ? T extends TReplace ? TWith | Exclude<T, TReplace> : T : { [P in keyof T]: Replaced<T[P], TReplace, TWith, TKeep> };
+//#endregion
+export { Replaced };

package/dist/lib/ReverseMap.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/ReverseMap.d.ts
+type ReverseMap<T extends Record<keyof T, keyof any>> = { [K in keyof T as T[K]]: K };
+//#endregion
+export { ReverseMap };

package/dist/lib/Satisfies.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/Satisfies.d.ts
+declare type Satisfies<ConstraintShape, ToValidate> = ConstraintShape extends ConstraintShape ? ToValidate : never;
+//#endregion
+export { Satisfies };

package/dist/lib/StringKey.d.ts

@@ -0,0 +1,4 @@
+//#region src/lib/StringKey.d.ts
+type StringKey<T> = { [K in keyof T]: T[K] extends string ? K : never }[keyof T];
+//#endregion
+export { StringKey };

package/dist/lib/StringKeysOnly.d.ts

@@ -0,0 +1,6 @@
+import { StringKey } from "./StringKey.js";
+
+//#region src/lib/StringKeysOnly.d.ts
+type StringKeysOnly<T> = Pick<T, StringKey<T>>;
+//#endregion
+export { StringKeysOnly };

package/dist/staticShouldNotHappen.d.ts

@@ -0,0 +1,4 @@
+//#region src/staticShouldNotHappen.d.ts
+declare function staticShouldNotHappen(value: never): asserts value;
+//#endregion
+export { staticShouldNotHappen };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/lib.utils-typescript",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060433",
   "scripts": {
     "clean": "rm -rf dist",
     "lint": "bun run lint:fix",
@@ -14,47 +14,47 @@
     "dev": "bun build:bundle --watch"
   },
   "devDependencies": {
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
-  "types": "./dist/index.d.mts",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./lib/AwaitedResult": "./src/lib/AwaitedResult.ts",
-    "./lib/BrowserNativeObject": "./src/lib/BrowserNativeObject.ts",
-    "./lib/DeepInfiniteArray": "./src/lib/DeepInfiniteArray.ts",
-    "./lib/DeepKeepOnly": "./src/lib/DeepKeepOnly.ts",
-    "./lib/DeepKey": "./src/lib/DeepKey.ts",
-    "./lib/DeepMap": "./src/lib/DeepMap.ts",
-    "./lib/DeepNullable": "./src/lib/DeepNullable.ts",
-    "./lib/DeepOr": "./src/lib/DeepOr.ts",
-    "./lib/DeepPartial": "./src/lib/DeepPartial.ts",
-    "./lib/DeepReplace": "./src/lib/DeepReplace.ts",
-    "./lib/DeepReplaceNullByUndefined": "./src/lib/DeepReplaceNullByUndefined.ts",
-    "./lib/DeepValue": "./src/lib/DeepValue.ts",
-    "./lib/DictionaryFromEnum": "./src/lib/DictionaryFromEnum.ts",
-    "./lib/DictionaryFromEnumMapping": "./src/lib/DictionaryFromEnumMapping.ts",
-    "./lib/EmptyRecord": "./src/lib/EmptyRecord.ts",
-    "./lib/Identified": "./src/lib/Identified.ts",
-    "./lib/IdentifiedLabel": "./src/lib/IdentifiedLabel.ts",
-    "./lib/IsAny": "./src/lib/IsAny.ts",
-    "./lib/Json": "./src/lib/Json.ts",
-    "./lib/KeepOnly": "./src/lib/KeepOnly.ts",
-    "./lib/Maybe": "./src/lib/Maybe.ts",
-    "./lib/MaybeArray": "./src/lib/MaybeArray.ts",
-    "./lib/NestedValue": "./src/lib/NestedValue.ts",
-    "./lib/NonUndefined": "./src/lib/NonUndefined.ts",
-    "./lib/Primitive": "./src/lib/Primitive.ts",
-    "./lib/Replaced": "./src/lib/Replaced.ts",
-    "./lib/ReverseMap": "./src/lib/ReverseMap.ts",
-    "./lib/Satisfies": "./src/lib/Satisfies.ts",
-    "./lib/StringKey": "./src/lib/StringKey.ts",
-    "./lib/StringKeysOnly": "./src/lib/StringKeysOnly.ts",
+    ".": "./dist/index.js",
+    "./lib/AwaitedResult": "./dist/lib/AwaitedResult.js",
+    "./lib/BrowserNativeObject": "./dist/lib/BrowserNativeObject.js",
+    "./lib/DeepInfiniteArray": "./dist/lib/DeepInfiniteArray.js",
+    "./lib/DeepKeepOnly": "./dist/lib/DeepKeepOnly.js",
+    "./lib/DeepKey": "./dist/lib/DeepKey.js",
+    "./lib/DeepMap": "./dist/lib/DeepMap.js",
+    "./lib/DeepNullable": "./dist/lib/DeepNullable.js",
+    "./lib/DeepOr": "./dist/lib/DeepOr.js",
+    "./lib/DeepPartial": "./dist/lib/DeepPartial.js",
+    "./lib/DeepReplace": "./dist/lib/DeepReplace.js",
+    "./lib/DeepReplaceNullByUndefined": "./dist/lib/DeepReplaceNullByUndefined.js",
+    "./lib/DeepValue": "./dist/lib/DeepValue.js",
+    "./lib/DictionaryFromEnum": "./dist/lib/DictionaryFromEnum.js",
+    "./lib/DictionaryFromEnumMapping": "./dist/lib/DictionaryFromEnumMapping.js",
+    "./lib/EmptyRecord": "./dist/lib/EmptyRecord.js",
+    "./lib/Identified": "./dist/lib/Identified.js",
+    "./lib/IdentifiedLabel": "./dist/lib/IdentifiedLabel.js",
+    "./lib/IsAny": "./dist/lib/IsAny.js",
+    "./lib/Json": "./dist/lib/Json.js",
+    "./lib/KeepOnly": "./dist/lib/KeepOnly.js",
+    "./lib/Maybe": "./dist/lib/Maybe.js",
+    "./lib/MaybeArray": "./dist/lib/MaybeArray.js",
+    "./lib/NestedValue": "./dist/lib/NestedValue.js",
+    "./lib/NonUndefined": "./dist/lib/NonUndefined.js",
+    "./lib/Primitive": "./dist/lib/Primitive.js",
+    "./lib/Replaced": "./dist/lib/Replaced.js",
+    "./lib/ReverseMap": "./dist/lib/ReverseMap.js",
+    "./lib/Satisfies": "./dist/lib/Satisfies.js",
+    "./lib/StringKey": "./dist/lib/StringKey.js",
+    "./lib/StringKeysOnly": "./dist/lib/StringKeysOnly.js",
     "./*": "./*"
   },
   "publishConfig": {