@contractspec/lib.utils-typescript 0.0.0-canary-20260113162409

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# @contractspec/lib.utils-typescript
+
+Website: https://contractspec.io/
+
+
+A collection of essential TypeScript utility types and helper functions.
+
+## Purpose
+
+To provide a shared library of generic TypeScript types (e.g., `DeepPartial`, `Maybe`, `AwaitedResult`) to avoid redeclaring them in every package.
+
+## Installation
+
+```bash
+npm install @contractspec/lib.utils-typescript
+# or
+bun add @contractspec/lib.utils-typescript
+```
+
+## Key Concepts
+
+- **Utility Types**: Enhancements to standard TS library types.
+- **Zero Dependencies**: Pure TS/JS helpers.
+
+## Exports
+
+- `DeepPartial`, `DeepRequired`
+- `Maybe`, `Nullable`
+- `AwaitedResult`
+- `Json`, `JsonObject`
+
+## Usage
+
+```ts
+import type { DeepPartial } from '@contractspec/lib.utils-typescript';
+
+type User = {
+  profile: {
+    name: string;
+  };
+};
+
+const update: DeepPartial<User> = {
+  profile: { name: 'Alice' }, // Valid
+};
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

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/index.js

@@ -0,0 +1,3 @@
+import { staticShouldNotHappen } from "./staticShouldNotHappen.js";
+
+export { staticShouldNotHappen };

package/dist/lib/AwaitedResult.d.ts

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

package/dist/lib/AwaitedResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwaitedResult.d.ts","names":[],"sources":["../../src/lib/AwaitedResult.ts"],"sourcesContent":[],"mappings":";KACY,iDAAiD,QAC3D,WAAW"}

package/dist/lib/BrowserNativeObject.d.ts

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

package/dist/lib/BrowserNativeObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserNativeObject.d.ts","names":[],"sources":["../../src/lib/BrowserNativeObject.ts"],"sourcesContent":[],"mappings":";aAAoB,mBAAA,GAAsB,OAAO,WAAW"}

package/dist/lib/DeepInfiniteArray.d.ts

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

package/dist/lib/DeepInfiniteArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepInfiniteArray.d.ts","names":[],"sources":["../../src/lib/DeepInfiniteArray.ts"],"sourcesContent":[],"mappings":";aAAoB,wBAAwB,IAAI,kBAAkB"}

package/dist/lib/DeepKeepOnly.d.ts

@@ -0,0 +1,7 @@
+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 };
+//# sourceMappingURL=DeepKeepOnly.d.ts.map

package/dist/lib/DeepKeepOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepKeepOnly.d.ts","names":[],"sources":["../../src/lib/DeepKeepOnly.ts"],"sourcesContent":[],"mappings":";;;KAEY,4BACR,KACC,wBACG,SAAS,GAAG,cACZ,UAAU,wBACR,IAAI,SAAS,GAAG,WAAW,SAAS,GAAG,aACvC,UAAU,eACR,IAAI,SAAS,GAAG,aAChB,SAAS,GAAG"}

package/dist/lib/DeepKey.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=DeepKey.d.ts.map

package/dist/lib/DeepKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepKey.d.ts","names":[],"sources":["../../src/lib/DeepKey.ts"],"sourcesContent":[],"mappings":";KAAY,2BAA2B,UAAU,KAAK,4BAClD,EAAE,wBAEO,iBACQ,6BAA6B,KAAK,QAAQ"}

package/dist/lib/DeepMap.d.ts

@@ -0,0 +1,10 @@
+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 };
+//# sourceMappingURL=DeepMap.d.ts.map

package/dist/lib/DeepMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepMap.d.ts","names":[],"sources":["../../src/lib/DeepMap.ts"],"sourcesContent":[],"mappings":";;;;;;aAKoB,qBAClB,MAAM,wBAGF,UAAU,sBAAsB,cAC9B,SACA,iCAEgB,IAAI,QAAQ,aAAa,EAAE,KAAK,SARxD,GAUU,MAVU"}

package/dist/lib/DeepNullable.d.ts

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

package/dist/lib/DeepNullable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepNullable.d.ts","names":[],"sources":["../../src/lib/DeepNullable.ts"],"sourcesContent":[],"mappings":";;;KAEY,kBAAkB,OAAO"}

package/dist/lib/DeepOr.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=DeepOr.d.ts.map

package/dist/lib/DeepOr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepOr.d.ts","names":[],"sources":["../../src/lib/DeepOr.ts"],"sourcesContent":[],"mappings":";KAAY,qBACR,KACC,wBACG,OAAO,GAAG,aACV,UAAU,wBACR,IAAI,OAAO,GAAG,UAAU,OAAO,GAAG,YAClC,UAAU,eACR,IAAI,OAAO,GAAG,YACd,2BARA,MAUgB,CAVV,GAUc,MAVd,CAUqB,CAVrB,CAUuB,CAVvB,CAAA,EAU2B,OAV3B,CAAA,GAUsC,OAVtC,EACd,GAWU,CAXV,CAAA"}

package/dist/lib/DeepPartial.d.ts

@@ -0,0 +1,8 @@
+//#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 };
+//# sourceMappingURL=DeepPartial.d.ts.map

package/dist/lib/DeepPartial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepPartial.d.ts","names":[],"sources":["../../src/lib/DeepPartial.ts"],"sourcesContent":[],"mappings":";;AAiBA;;AACmB,KADP,WACO,CAAA,CAAA,CAAA,GAAA,QAAE,MAAP,CAAO,IAAF,CAAE,CAAA,CAAA,CAAA,SAAA,MAAA,GAAoB,WAApB,CAAgC,CAAhC,CAAkC,CAAlC,CAAA,CAAA,GAAwC,CAAxC,CAA0C,CAA1C,CAAA,EAAgC"}

package/dist/lib/DeepReplace.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=DeepReplace.d.ts.map

package/dist/lib/DeepReplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepReplace.d.ts","names":[],"sources":["../../src/lib/DeepReplace.ts"],"sourcesContent":[],"mappings":";KAAY,kCAAkC,iCAC1C,YAAY,YAAY,QAAQ,aAChC,UAAU,gCACR,IACE,YAAY,QAAQ,QAAQ,UAC5B,YAAY,MAAM,QAAQ,YAE5B,UAAU,kBACR,IAAI,YAAY,MAAM,QAAQ,YAC9B,gCATI,MAWiB,CAXN,GAWU,WAXV,CAWsB,CAXtB,CAWwB,MAXxB,CAAA,EAWiC,MAXjC,EAWyC,OAXzC,CAAA,EAAuB,GAapC,CAboC,SAa1B,MAb0B,GAclC,OAdkC,GAelC,CAfkC"}

package/dist/lib/DeepReplaceNullByUndefined.d.ts

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

package/dist/lib/DeepReplaceNullByUndefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepReplaceNullByUndefined.d.ts","names":[],"sources":["../../src/lib/DeepReplaceNullByUndefined.ts"],"sourcesContent":[],"mappings":";;;KAEY,gCAAgC,YAAY"}

package/dist/lib/DeepValue.d.ts

@@ -0,0 +1,7 @@
+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 };
+//# sourceMappingURL=DeepValue.d.ts.map

package/dist/lib/DeepValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeepValue.d.ts","names":[],"sources":["../../src/lib/DeepValue.ts"],"sourcesContent":[],"mappings":";;;KAEY,uBAEA,QAAQ,MAChB,uCACA,0DAA0D,4DAGzC,QAAQ,KACnB,UAAU,GAAG,wBAGnB,GAAG,4CAA4C,WAAW"}

package/dist/lib/DictionaryFromEnum.d.ts

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

package/dist/lib/DictionaryFromEnum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictionaryFromEnum.d.ts","names":[],"sources":["../../src/lib/DictionaryFromEnum.ts"],"sourcesContent":[],"mappings":";KAAY,uCAAuC,aAC3C,MACN"}

package/dist/lib/DictionaryFromEnumMapping.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=DictionaryFromEnumMapping.d.ts.map

package/dist/lib/DictionaryFromEnumMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DictionaryFromEnumMapping.d.ts","names":[],"sources":["../../src/lib/DictionaryFromEnumMapping.ts"],"sourcesContent":[],"mappings":";KAAY,wDAGM,aAAa,MAAM,mBAHzB,MAKE,IALF,GAKS,OALT,CAKiB,CALQ,CAAA,EAGN"}

package/dist/lib/EmptyRecord.d.ts

@@ -0,0 +1,7 @@
+//#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 };
+//# sourceMappingURL=EmptyRecord.d.ts.map

package/dist/lib/EmptyRecord.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmptyRecord.d.ts","names":[],"sources":["../../src/lib/EmptyRecord.ts"],"sourcesContent":[],"mappings":";KAAY,WAAA,GAAc;AAAd,KACA,aAAA,GAAgB,MADF,CAAA,MAAM,EAAA,OAAA,CAAA;AACpB,KAEA,SAAA,GAAY,MAFC,CAAA,MAAG,EAAM,GAAA,CAAA"}

package/dist/lib/Identified.d.ts

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

package/dist/lib/Identified.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Identified.d.ts","names":[],"sources":["../../src/lib/Identified.ts"],"sourcesContent":[],"mappings":";UAAiB,UAAA;EAAA,EAAA,EAAA,MAAA"}

package/dist/lib/IdentifiedLabel.d.ts

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

package/dist/lib/IdentifiedLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentifiedLabel.d.ts","names":[],"sources":["../../src/lib/IdentifiedLabel.ts"],"sourcesContent":[],"mappings":";;;KAEY,eAAA,GAAkB;;AAA9B,CAAA"}

package/dist/lib/IsAny.d.ts

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

package/dist/lib/IsAny.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsAny.d.ts","names":[],"sources":["../../src/lib/IsAny.ts"],"sourcesContent":[],"mappings":";aAAoB,yBAAyB"}

package/dist/lib/Json.d.ts

@@ -0,0 +1,16 @@
+//#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 };
+//# sourceMappingURL=Json.d.ts.map

package/dist/lib/Json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Json.d.ts","names":[],"sources":["../../src/lib/Json.ts"],"sourcesContent":[],"mappings":";aAAoB,kBAAA;AAAA,aAMA,SAAA,GAAY,kBANM,GAMe,SANf,GAM2B,UAN3B;AAMlB,UAGH,SAAA,SAAkB,KAHN,CAGY,SAHZ,CAAA,CAAA;AAAwB,UAKpC,UAAA,CALoC;EAAY,CAAA,GAAA,EAAA,MAAA,CAAA,EAMhD,SANgD;;AAGhD,aAMG,YANqB,CAAA,UAAN,CAAA,GAO/B,kBAPoC,GAQpC,YARoC,CAQvB,UARuB,CAAA,GASpC,aAToC,CAStB,UATsB,CAAA,GAUpC,UAVoC;AAEvB,UAWA,YAVA,CAAA,UAAS,CAAA,SAUwB,KAVxB,CAWxB,YAXwB,CAWX,UAXW,CAAA,CAAA,CAAA,CAG1B;AACI,UAUa,aAVb,CAAA,UAAA,CAAA,CAAA;EACa,CAAA,GAAA,EAAA,MAAA,CAAA,EAUA,YAVA,CAUa,UAVb,CAAA;;AACC,KAYN,kBAAA,GAAqB,aAZf,CAAA,MAAA,GAYsC,IAZtC,CAAA"}

package/dist/lib/KeepOnly.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=KeepOnly.d.ts.map

package/dist/lib/KeepOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeepOnly.d.ts","names":[],"sources":["../../src/lib/KeepOnly.ts"],"sourcesContent":[],"mappings":";KAAY,wBAAwB,2BAAxB,MAEM,CAFE,GAEE,QAFF,CAEW,CAFX,CAEa,CAFb,CAAA,EAEiB,QAFjB,CAAA,EAAgB,GAIhC,CAJgC,SAItB,QAJsB,GAK9B,CAL8B,GAAA,KAAA"}

package/dist/lib/Maybe.d.ts

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

package/dist/lib/Maybe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Maybe.d.ts","names":[],"sources":["../../src/lib/Maybe.ts"],"sourcesContent":[],"mappings":";KAAY,WAAW"}

package/dist/lib/MaybeArray.d.ts

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

package/dist/lib/MaybeArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaybeArray.d.ts","names":[],"sources":["../../src/lib/MaybeArray.ts"],"sourcesContent":[],"mappings":";KAAY,gBAAgB,IAAI"}

package/dist/lib/NestedValue.d.ts

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

package/dist/lib/NestedValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NestedValue.d.ts","names":[],"sources":["../../src/lib/NestedValue.ts"],"sourcesContent":[],"mappings":";cAAc;AAAA,aAEM,WAFqB,CAAA,eAAA,MAAA,GAAA,MAAA,CAAA,GAAA;EAErB,CACjB,YAAA,CAD4B,EAAA,KAAA;IAE3B"}

package/dist/lib/NonUndefined.d.ts

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

package/dist/lib/NonUndefined.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NonUndefined.d.ts","names":[],"sources":["../../src/lib/NonUndefined.ts"],"sourcesContent":[],"mappings":";aAAoB,kBAAkB,8BAA8B"}

package/dist/lib/Primitive.d.ts

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

package/dist/lib/Primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Primitive.d.ts","names":[],"sources":["../../src/lib/Primitive.ts"],"sourcesContent":[],"mappings":";;;aAEoB,SAAA,GAAY"}

package/dist/lib/Replaced.d.ts

@@ -0,0 +1,7 @@
+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 };
+//# sourceMappingURL=Replaced.d.ts.map

package/dist/lib/Replaced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Replaced.d.ts","names":[],"sources":["../../src/lib/Replaced.ts"],"sourcesContent":[],"mappings":";;;KAGY,qCAAqC,aAAa,UAC1D,WACA,QACA,UAAU,WACR,QAAQ,QAAQ,GAAG,YACnB,kBAEY,IAAI,SAAS,EAAE,IAAI,UAAU,OAAO,QAPtD"}

package/dist/lib/ReverseMap.d.ts

@@ -0,0 +1,5 @@
+//#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 };
+//# sourceMappingURL=ReverseMap.d.ts.map

package/dist/lib/ReverseMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReverseMap.d.ts","names":[],"sources":["../../src/lib/ReverseMap.ts"],"sourcesContent":[],"mappings":";KACY,qBAAqB,aAAa,yBAAlC,MACE,CADQ,IACH,CADG,CACD,CADC,CAAA,GACI,CADJ,EAAwB"}

package/dist/lib/Satisfies.d.ts

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

package/dist/lib/Satisfies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Satisfies.d.ts","names":[],"sources":["../../src/lib/Satisfies.ts"],"sourcesContent":[],"mappings":";aAAoB,yCAClB,wBAAwB,kBAAkB"}

package/dist/lib/StringKey.d.ts

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

package/dist/lib/StringKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringKey.d.ts","names":[],"sources":["../../src/lib/StringKey.ts"],"sourcesContent":[],"mappings":";KAAY,uBAAA,MACE,CADO,GACH,CADG,CACD,CADC,CAAA,SAAA,MAAA,GACmB,CADnB,GAAA,KAAA,EACP,CAAA,MACN,CADM,CAAA"}

package/dist/lib/StringKeysOnly.d.ts

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

package/dist/lib/StringKeysOnly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringKeysOnly.d.ts","names":[],"sources":["../../src/lib/StringKeysOnly.ts"],"sourcesContent":[],"mappings":";;;KAEY,oBAAoB,KAAK,GAAG,UAAU"}

package/dist/staticShouldNotHappen.d.ts

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

package/dist/staticShouldNotHappen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticShouldNotHappen.d.ts","names":[],"sources":["../src/staticShouldNotHappen.ts"],"sourcesContent":[],"mappings":";iBAAgB,qBAAA"}

package/dist/staticShouldNotHappen.js

@@ -0,0 +1,8 @@
+//#region src/staticShouldNotHappen.ts
+function staticShouldNotHappen(value) {
+	throw new Error(`Missing switch value ${value?.toString?.()}`);
+}
+
+//#endregion
+export { staticShouldNotHappen };
+//# sourceMappingURL=staticShouldNotHappen.js.map

package/dist/staticShouldNotHappen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticShouldNotHappen.js","names":[],"sources":["../src/staticShouldNotHappen.ts"],"sourcesContent":["export function staticShouldNotHappen(value: never): asserts value {\n  throw new Error(\n    `Missing switch value ${(value as null | { toString?: () => string })?.toString?.()}`\n  );\n}\n"],"mappings":";AAAA,SAAgB,sBAAsB,OAA6B;AACjE,OAAM,IAAI,MACR,wBAAyB,OAA8C,YAAY,GACpF"}

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@contractspec/lib.utils-typescript",
+  "version": "0.0.0-canary-20260113162409",
+  "description": "TypeScript utility types and helpers",
+  "keywords": [
+    "contractspec",
+    "typescript",
+    "utilities",
+    "types",
+    "helpers"
+  ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "lint": "bun run lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113162409",
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113162409",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./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": {
+    "exports": {
+      ".": "./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",
+      "./*": "./*"
+    },
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/libs/utils-typescript"
+  },
+  "homepage": "https://contractspec.io"
+}