@tnid/core 0.0.5 → 0.0.7

package/README.md

@@ -52,6 +52,19 @@ const parsed: UserId = UserId.parse("user.Br2flcNDfF6LYICnT");
 // Convert to/from UUID format
 const uuid: string = UserId.toUuidString(id); // "d6157329-4640-8e30-..."
 const fromUuid: UserId = UserId.parseUuidString(uuid);
+
+// Works great with Zod
+import { z } from "zod";
+const UserSchema = z.object({
+  id: z.string().transform(UserId.parse),
+  name: z.string(),
+});
+interface User extends z.infer<typeof UserSchema> {} // { id: UserId; name: string }
+
+const user: User = UserSchema.parse({
+  id: "user.Br2flcNDfF6LYICnT",
+  name: "Alice",
+});
 ```
 
 ## Features
@@ -87,20 +100,21 @@ id === otherUserId; // true/false
 import {
   Case, // "lower" | "upper"
   DynamicTnid, // Runtime TNID operations (type + namespace)
-  Tnid, // NamedTnid creator function
   NamedTnid, // NamedTnid interface
+  Tnid, // NamedTnid creator function
   TnidType, // Type helper to extract ID type
   // Types only:
   TnidValue, // Branded string type
   TnidVariant, // "v0" | "v1" | "v2" | "v3"
   UuidLike, // UUID string operations (type + namespace)
+  ValidateName, // Compile-time name validation (for library authors)
 } from "@tnid/core";
 ```
 
 ### `Tnid(name)`
 
-Creates a `NamedTnid` for a specific name. The name is validated at
-**compile time**.
+Creates a `NamedTnid` for a specific name. The name is validated at **compile
+time**.
 
 ```typescript
 const UserId = Tnid("user");
@@ -137,27 +151,27 @@ Tnid(""); // empty not allowed
 const UserId = Tnid("user");
 type UserId = TnidType<typeof UserId>;
 
-UserId.new_v0();                        // time-ordered ID
-UserId.new_v1();                        // high-entropy random ID
-UserId.v0_from_parts(1234567890n, 0n);  // V0 with explicit timestamp/random
-UserId.v1_from_parts(0n);               // V1 with explicit random bits
+UserId.new_v0(); // time-ordered ID
+UserId.new_v1(); // high-entropy random ID
+UserId.v0_from_parts(1234567890n, 0n); // V0 with explicit timestamp/random
+UserId.v1_from_parts(0n); // V1 with explicit random bits
 ```
 
 #### Parsing
 
 ```typescript
-UserId.parse("user.Br2flcNDfF6LYICnT");              // parse TNID string
-UserId.parseUuidString("d6157329-4640-8e30-...");    // parse UUID hex string
+UserId.parse("user.Br2flcNDfF6LYICnT"); // parse TNID string
+UserId.parseUuidString("d6157329-4640-8e30-..."); // parse UUID hex string
 ```
 
 #### Inspection and Conversion
 
 ```typescript
-UserId.name;                      // "user" - the TNID name
-UserId.variant(id);               // "v0" or "v1" - get the variant
-UserId.toUuidString(id);          // "d6157329-4640-8e30-..." - convert to UUID
+UserId.name; // "user" - the TNID name
+UserId.variant(id); // "v0" or "v1" - get the variant
+UserId.toUuidString(id); // "d6157329-4640-8e30-..." - convert to UUID
 UserId.toUuidString(id, "upper"); // "D6157329-4640-8E30-..." - uppercase UUID
-UserId.nameHex();                 // "d6157" - name as 5-char hex
+UserId.nameHex(); // "d6157" - name as 5-char hex
 ```
 
 ### `TnidType<T>`
@@ -187,23 +201,27 @@ function logAnyId(id: DynamicTnid) {
 }
 
 // Generation with runtime names
-DynamicTnid.new_v0("user");           // time-ordered (alias: new_time_ordered)
-DynamicTnid.new_v1("user");           // high-entropy (alias: new_high_entropy)
+DynamicTnid.newV0("user"); // time-ordered (alias: newTimeOrdered)
+DynamicTnid.newV1("user"); // high-entropy (alias: newHighEntropy)
 
 // Generation with explicit values (useful for testing/migrations)
-DynamicTnid.new_v0_with_time("user", new Date("2024-01-15"));
-DynamicTnid.new_v0_with_parts("user", 1705312800000n, 123n);
-DynamicTnid.new_v1_with_random("user", 0x123456789abcdef0123456789n);
+DynamicTnid.newV0WithTime("user", new Date("2024-01-15"));
+DynamicTnid.newV0WithParts("user", 1705312800000n, 123n);
+DynamicTnid.newV1WithRandom("user", 0x123456789abcdef0123456789n);
+
+// Parsing (auto-detects format)
+DynamicTnid.parse("post.EUBcUw4T9x3KNOll-"); // TNID string
+DynamicTnid.parse("d6157329-4640-..."); // UUID string
 
-// Parsing any TNID
-DynamicTnid.parse("post.EUBcUw4T9x3KNOll-");
-DynamicTnid.parse_uuid_string("d6157329-4640-...");
+// Or use explicit parse methods
+DynamicTnid.parseTnidString("post.EUBcUw4T9x3KNOll-");
+DynamicTnid.parseUuidString("d6157329-4640-...");
 
 // Inspection
-DynamicTnid.getName(id);              // "user"
-DynamicTnid.getNameHex(id);           // "d6157"
-DynamicTnid.getVariant(id);           // "v0" or "v1"
-DynamicTnid.toUuidString(id);         // UUID hex string
+DynamicTnid.getName(id); // "user"
+DynamicTnid.getNameHex(id); // "d6157"
+DynamicTnid.getVariant(id); // "v0" or "v1"
+DynamicTnid.toUuidString(id); // UUID hex string
 ```
 
 ### `UuidLike`
@@ -211,10 +229,10 @@ DynamicTnid.toUuidString(id);         // UUID hex string
 For working with UUID hex strings that may or may not be valid TNIDs.
 
 ```typescript
-UuidLike.fromTnid(id);        // convert TNID to UUID string
-UuidLike.parse(s);            // parse any UUID (validates format only)
-UuidLike.toTnid(uuid);        // convert UUID to TNID (throws if invalid)
-UuidLike.toUpperCase(uuid);   // convert to uppercase
+UuidLike.fromTnid(id); // convert TNID to UUID string
+UuidLike.parse(s); // parse any UUID (validates format only)
+UuidLike.toTnid(uuid); // convert UUID to TNID (throws if invalid)
+UuidLike.toUpperCase(uuid); // convert to uppercase
 ```
 
 ## Variants

package/esm/dynamic.d.ts

@@ -6,23 +6,25 @@ declare function toUuidStringImpl(id: DynamicTnid, upperCase?: boolean): string;
 /** Interface for DynamicTnid static methods. */
 export interface DynamicTnidNamespace {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    new_v0(name: string): DynamicTnid;
-    /** Alias for new_v0. */
-    new_time_ordered(name: string): DynamicTnid;
+    newV0(name: string): DynamicTnid;
+    /** Alias for newV0. */
+    newTimeOrdered(name: string): DynamicTnid;
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    new_v0_with_time(name: string, time: Date): DynamicTnid;
+    newV0WithTime(name: string, time: Date): DynamicTnid;
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    new_v0_with_parts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
+    newV0WithParts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    new_v1(name: string): DynamicTnid;
-    /** Alias for new_v1. */
-    new_high_entropy(name: string): DynamicTnid;
+    newV1(name: string): DynamicTnid;
+    /** Alias for newV1. */
+    newHighEntropy(name: string): DynamicTnid;
     /** Generate a new high-entropy TNID with explicit random bits. */
-    new_v1_with_random(name: string, randomBits: bigint): DynamicTnid;
-    /** Parse any valid TNID string. */
+    newV1WithRandom(name: string, randomBits: bigint): DynamicTnid;
+    /** Parse a TNID from either TNID string format or UUID hex format (auto-detected). */
     parse(s: string): DynamicTnid;
+    /** Parse a TNID string (e.g., "user.Br2flcNDfF6LYICnT"). */
+    parseTnidString(s: string): DynamicTnid;
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    parse_uuid_string(uuid: string): DynamicTnid;
+    parseUuidString(uuid: string): DynamicTnid;
     /** Get the name from a TNID. */
     getName(id: DynamicTnid): string;
     /** Get the name encoded as a 5-character hex string. */

package/esm/dynamic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACxD,uFAAuF;IACvF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAClF,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,mCAAmC;IACnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA8GzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,uBAAuB;IACvB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,mEAAmE;IACnE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACrD,uFAAuF;IACvF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/E,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,uBAAuB;IACvB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,kEAAkE;IAClE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/D,sFAAsF;IACtF,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACxC,6EAA6E;IAC7E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA4HzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/esm/dynamic.js

@@ -83,7 +83,7 @@ function parseDynamicUuidStringImpl(uuid) {
 /** Static methods for working with any TNID regardless of name. */
 export const DynamicTnid = {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    new_v0(name) {
+    newV0(name) {
         if (!isValidNameRuntime(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -92,12 +92,12 @@ export const DynamicTnid = {
         const dataEncoded = encodeData(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Alias for new_v0. */
-    new_time_ordered(name) {
-        return DynamicTnid.new_v0(name);
+    /** Alias for newV0. */
+    newTimeOrdered(name) {
+        return DynamicTnid.newV0(name);
     },
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    new_v0_with_time(name, time) {
+    newV0WithTime(name, time) {
         if (!isValidNameRuntime(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -108,7 +108,7 @@ export const DynamicTnid = {
         return `${name}.${dataEncoded}`;
     },
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    new_v0_with_parts(name, epochMillis, random) {
+    newV0WithParts(name, epochMillis, random) {
         if (!isValidNameRuntime(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -118,7 +118,7 @@ export const DynamicTnid = {
         return `${name}.${dataEncoded}`;
     },
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    new_v1(name) {
+    newV1(name) {
         if (!isValidNameRuntime(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -127,12 +127,12 @@ export const DynamicTnid = {
         const dataEncoded = encodeData(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Alias for new_v1. */
-    new_high_entropy(name) {
-        return DynamicTnid.new_v1(name);
+    /** Alias for newV1. */
+    newHighEntropy(name) {
+        return DynamicTnid.newV1(name);
     },
     /** Generate a new high-entropy TNID with explicit random bits. */
-    new_v1_with_random(name, randomBits) {
+    newV1WithRandom(name, randomBits) {
         if (!isValidNameRuntime(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -141,12 +141,25 @@ export const DynamicTnid = {
         const dataEncoded = encodeData(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Parse any valid TNID string. */
+    /** Parse a TNID from either TNID string format or UUID hex format (auto-detected). */
     parse(s) {
+        // Detect format by length: TNID strings are 19-22 chars with '.', UUIDs are 36 chars
+        if (s.length >= 19 && s.length <= 22 && s.includes(".")) {
+            return parseDynamicTnidImpl(s);
+        }
+        else if (s.length === 36) {
+            return parseDynamicUuidStringImpl(s);
+        }
+        else {
+            throw new Error(`Invalid TNID: expected TNID string (19-22 chars) or UUID (36 chars), got ${s.length} chars`);
+        }
+    },
+    /** Parse a TNID string (e.g., "user.Br2flcNDfF6LYICnT"). */
+    parseTnidString(s) {
         return parseDynamicTnidImpl(s);
     },
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    parse_uuid_string(uuid) {
+    parseUuidString(uuid) {
         return parseDynamicUuidStringImpl(uuid);
     },
     /** Get the name from a TNID. */

package/esm/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,SAAS,EAGT,YAAY,EACb,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GACvB,SAAS,CAAC,IAAI,CAAC,CAsGjB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,SAAS,EAGT,YAAY,EACb,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GACvB,SAAS,CAAC,IAAI,CAAC,CAmHjB"}

package/esm/factory.js

@@ -1,10 +1,10 @@
 // =============================================================================
 // Tnid Function
 // =============================================================================
-import { encodeName, decodeName, isValidNameRuntime } from "./name_encoding.js";
-import { encodeData, decodeData, dataBitsToBytes } from "./data_encoding.js";
+import { decodeName, encodeName, isValidNameRuntime } from "./name_encoding.js";
+import { dataBitsToBytes, decodeData, encodeData } from "./data_encoding.js";
 import { generateV0, generateV1 } from "./bits.js";
-import { parseUuidStringToValue, validateUuidBits, extractNameBitsFromValue, valueToTnidString, } from "./uuid.js";
+import { extractNameBitsFromValue, parseUuidStringToValue, validateUuidBits, valueToTnidString, } from "./uuid.js";
 import { getTnidVariantImpl, toUuidStringImpl } from "./dynamic.js";
 /**
  * Create a NamedTnid for the given name.
@@ -59,6 +59,18 @@ export function Tnid(name) {
             return `${name}.${dataEncoded}`;
         },
         parse(s) {
+            // Detect format by length: TNID strings are 19-22 chars with '.', UUIDs are 36 chars
+            if (s.length >= 19 && s.length <= 22 && s.includes(".")) {
+                return tnid.parseTnidString(s);
+            }
+            else if (s.length === 36) {
+                return tnid.parseUuidString(s);
+            }
+            else {
+                throw new Error(`Invalid TNID: expected TNID string (19-22 chars) or UUID (36 chars), got ${s.length} chars`);
+            }
+        },
+        parseTnidString(s) {
             const dotIndex = s.indexOf(".");
             if (dotIndex === -1) {
                 throw new Error(`Invalid TNID string: missing '.' separator`);

package/esm/index.d.ts

@@ -1,4 +1,4 @@
-export type { TnidValue, TnidVariant, Case, NamedTnid, TnidType, } from "./types.js";
+export type { TnidValue, TnidVariant, Case, NamedTnid, TnidType, ValidateName, } from "./types.js";
 export { DynamicTnid } from "./dynamic.js";
 export { UuidLike } from "./uuidlike.js";
 export { Tnid } from "./factory.js";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/esm/types.d.ts

@@ -23,14 +23,18 @@ export type ValidateName<S extends string> = ValidateNameChars<S> extends true ?
  * const id: UserId = UserId.new_v0();          // time-sortable
  * const id2: UserId = UserId.new_v1();         // high-entropy random
  *
- * // Parse from strings
- * const parsed = UserId.parse("user.abc...");  // validates name matches
- * const fromUuid = UserId.parseUuidString("d6157329-4640-8e30-...");
+ * // Parse from strings (auto-detects format)
+ * const parsed = UserId.parse("user.abc...");  // TNID string format
+ * const fromUuid = UserId.parse("d6157329-4640-8e30-...");  // UUID format
+ *
+ * // Or use explicit parse methods
+ * UserId.parseTnidString("user.abc...");       // TNID string only
+ * UserId.parseUuidString("d6157329-...");      // UUID string only
  *
  * // DynamicTnid - runtime name validation
- * DynamicTnid.new_v0("item");                  // create with runtime name
- * DynamicTnid.new_v1("item");                  // create with runtime name
- * DynamicTnid.parse("post.xyz...");            // parse any TNID
+ * DynamicTnid.newV0("item");                   // create with runtime name
+ * DynamicTnid.newV1("item");                   // create with runtime name
+ * DynamicTnid.parse("post.xyz...");            // parse any TNID (auto-detects)
  * DynamicTnid.getName(id);                     // "user"
  * DynamicTnid.getVariant(id);                  // "v0" | "v1" | "v2" | "v3"
  *
@@ -70,10 +74,15 @@ export interface NamedTnid<Name extends string> {
     /** Construct a V1 TNID from specific parts (for deterministic testing) */
     v1_from_parts(randomBits: bigint): TnidValue<Name>;
     /**
-     * Parse and validate a TNID string.
+     * Parse a TNID from either TNID string format or UUID hex format (auto-detected).
      * @throws Error if the string is invalid or the name doesn't match
      */
     parse(s: string): TnidValue<Name>;
+    /**
+     * Parse and validate a TNID string (e.g., "user.Br2flcNDfF6LYICnT").
+     * @throws Error if the string is invalid or the name doesn't match
+     */
+    parseTnidString(s: string): TnidValue<Name>;
     /**
      * Parse a UUID hex string into a TNID.
      * Validates that it's a valid UUIDv8 TNID and the name matches.

package/esm/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tnid/core",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Type-safe, named, unique identifiers (TNIDs) - UUID-compatible IDs with embedded type names",
   "keywords": [
     "uuid",
@@ -12,11 +12,11 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tnid/tnid-typescript.git"
+    "url": "git+https://github.com/mkeedlinger/tnid-typescript.git"
   },
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/tnid/tnid-typescript/issues"
+    "url": "https://github.com/mkeedlinger/tnid-typescript/issues"
   },
   "main": "./script/index.js",
   "module": "./esm/index.js",
@@ -38,5 +38,6 @@
     "node": ">=20"
   },
   "dependencies": {},
+  "peerDependencies": {},
   "_generatedBy": "dnt@dev"
 }

package/script/dynamic.d.ts

@@ -6,23 +6,25 @@ declare function toUuidStringImpl(id: DynamicTnid, upperCase?: boolean): string;
 /** Interface for DynamicTnid static methods. */
 export interface DynamicTnidNamespace {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    new_v0(name: string): DynamicTnid;
-    /** Alias for new_v0. */
-    new_time_ordered(name: string): DynamicTnid;
+    newV0(name: string): DynamicTnid;
+    /** Alias for newV0. */
+    newTimeOrdered(name: string): DynamicTnid;
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    new_v0_with_time(name: string, time: Date): DynamicTnid;
+    newV0WithTime(name: string, time: Date): DynamicTnid;
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    new_v0_with_parts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
+    newV0WithParts(name: string, epochMillis: bigint, random: bigint): DynamicTnid;
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    new_v1(name: string): DynamicTnid;
-    /** Alias for new_v1. */
-    new_high_entropy(name: string): DynamicTnid;
+    newV1(name: string): DynamicTnid;
+    /** Alias for newV1. */
+    newHighEntropy(name: string): DynamicTnid;
     /** Generate a new high-entropy TNID with explicit random bits. */
-    new_v1_with_random(name: string, randomBits: bigint): DynamicTnid;
-    /** Parse any valid TNID string. */
+    newV1WithRandom(name: string, randomBits: bigint): DynamicTnid;
+    /** Parse a TNID from either TNID string format or UUID hex format (auto-detected). */
     parse(s: string): DynamicTnid;
+    /** Parse a TNID string (e.g., "user.Br2flcNDfF6LYICnT"). */
+    parseTnidString(s: string): DynamicTnid;
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    parse_uuid_string(uuid: string): DynamicTnid;
+    parseUuidString(uuid: string): DynamicTnid;
     /** Get the name from a TNID. */
     getName(id: DynamicTnid): string;
     /** Get the name encoded as a 5-character hex string. */

package/script/dynamic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,mEAAmE;IACnE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACxD,uFAAuF;IACvF,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAClF,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAClC,wBAAwB;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5C,kEAAkE;IAClE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAClE,mCAAmC;IACnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,6EAA6E;IAC7E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC7C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA8GzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"dynamic.d.ts","sourceRoot":"","sources":["../src/dynamic.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AAgB5C,iBAAS,kBAAkB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CASxD;AAiBD,iBAAS,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,GAAE,OAAe,GAAG,MAAM,CAmB7E;AAmDD,gDAAgD;AAChD,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,uBAAuB;IACvB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,mEAAmE;IACnE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,WAAW,CAAC;IACrD,uFAAuF;IACvF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/E,iFAAiF;IACjF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IACjC,uBAAuB;IACvB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,kEAAkE;IAClE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/D,sFAAsF;IACtF,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,4DAA4D;IAC5D,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACxC,6EAA6E;IAC7E,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3C,gCAAgC;IAChC,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACjC,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,iCAAiC;IACjC,UAAU,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1D;AAED,mEAAmE;AACnE,eAAO,MAAM,WAAW,EAAE,oBA4HzB,CAAC;AAGF,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,CAAC"}

package/script/dynamic.js

@@ -88,7 +88,7 @@ function parseDynamicUuidStringImpl(uuid) {
 /** Static methods for working with any TNID regardless of name. */
 exports.DynamicTnid = {
     /** Generate a new time-sortable TNID (variant 0) with runtime name validation. */
-    new_v0(name) {
+    newV0(name) {
         if (!(0, name_encoding_js_1.isValidNameRuntime)(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -97,12 +97,12 @@ exports.DynamicTnid = {
         const dataEncoded = (0, data_encoding_js_1.encodeData)(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Alias for new_v0. */
-    new_time_ordered(name) {
-        return exports.DynamicTnid.new_v0(name);
+    /** Alias for newV0. */
+    newTimeOrdered(name) {
+        return exports.DynamicTnid.newV0(name);
     },
     /** Generate a new time-sortable TNID with a specific timestamp. */
-    new_v0_with_time(name, time) {
+    newV0WithTime(name, time) {
         if (!(0, name_encoding_js_1.isValidNameRuntime)(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -113,7 +113,7 @@ exports.DynamicTnid = {
         return `${name}.${dataEncoded}`;
     },
     /** Generate a new time-sortable TNID with explicit timestamp and random components. */
-    new_v0_with_parts(name, epochMillis, random) {
+    newV0WithParts(name, epochMillis, random) {
         if (!(0, name_encoding_js_1.isValidNameRuntime)(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -123,7 +123,7 @@ exports.DynamicTnid = {
         return `${name}.${dataEncoded}`;
     },
     /** Generate a new high-entropy TNID (variant 1) with runtime name validation. */
-    new_v1(name) {
+    newV1(name) {
         if (!(0, name_encoding_js_1.isValidNameRuntime)(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -132,12 +132,12 @@ exports.DynamicTnid = {
         const dataEncoded = (0, data_encoding_js_1.encodeData)(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Alias for new_v1. */
-    new_high_entropy(name) {
-        return exports.DynamicTnid.new_v1(name);
+    /** Alias for newV1. */
+    newHighEntropy(name) {
+        return exports.DynamicTnid.newV1(name);
     },
     /** Generate a new high-entropy TNID with explicit random bits. */
-    new_v1_with_random(name, randomBits) {
+    newV1WithRandom(name, randomBits) {
         if (!(0, name_encoding_js_1.isValidNameRuntime)(name)) {
             throw new Error(`Invalid TNID name: "${name}". Must be 1-4 characters of: 0-4, a-z`);
         }
@@ -146,12 +146,25 @@ exports.DynamicTnid = {
         const dataEncoded = (0, data_encoding_js_1.encodeData)(bytes);
         return `${name}.${dataEncoded}`;
     },
-    /** Parse any valid TNID string. */
+    /** Parse a TNID from either TNID string format or UUID hex format (auto-detected). */
     parse(s) {
+        // Detect format by length: TNID strings are 19-22 chars with '.', UUIDs are 36 chars
+        if (s.length >= 19 && s.length <= 22 && s.includes(".")) {
+            return parseDynamicTnidImpl(s);
+        }
+        else if (s.length === 36) {
+            return parseDynamicUuidStringImpl(s);
+        }
+        else {
+            throw new Error(`Invalid TNID: expected TNID string (19-22 chars) or UUID (36 chars), got ${s.length} chars`);
+        }
+    },
+    /** Parse a TNID string (e.g., "user.Br2flcNDfF6LYICnT"). */
+    parseTnidString(s) {
         return parseDynamicTnidImpl(s);
     },
     /** Parse a UUID hex string into a DynamicTnid (validates TNID structure). */
-    parse_uuid_string(uuid) {
+    parseUuidString(uuid) {
         return parseDynamicUuidStringImpl(uuid);
     },
     /** Get the name from a TNID. */

package/script/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,SAAS,EAGT,YAAY,EACb,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GACvB,SAAS,CAAC,IAAI,CAAC,CAsGjB"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,SAAS,EAGT,YAAY,EACb,MAAM,YAAY,CAAC;AAapB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAC5C,IAAI,EAAE,YAAY,CAAC,IAAI,CAAC,GACvB,SAAS,CAAC,IAAI,CAAC,CAmHjB"}

package/script/factory.js

@@ -62,6 +62,18 @@ function Tnid(name) {
             return `${name}.${dataEncoded}`;
         },
         parse(s) {
+            // Detect format by length: TNID strings are 19-22 chars with '.', UUIDs are 36 chars
+            if (s.length >= 19 && s.length <= 22 && s.includes(".")) {
+                return tnid.parseTnidString(s);
+            }
+            else if (s.length === 36) {
+                return tnid.parseUuidString(s);
+            }
+            else {
+                throw new Error(`Invalid TNID: expected TNID string (19-22 chars) or UUID (36 chars), got ${s.length} chars`);
+            }
+        },
+        parseTnidString(s) {
             const dotIndex = s.indexOf(".");
             if (dotIndex === -1) {
                 throw new Error(`Invalid TNID string: missing '.' separator`);

package/script/index.d.ts

@@ -1,4 +1,4 @@
-export type { TnidValue, TnidVariant, Case, NamedTnid, TnidType, } from "./types.js";
+export type { TnidValue, TnidVariant, Case, NamedTnid, TnidType, ValidateName, } from "./types.js";
 export { DynamicTnid } from "./dynamic.js";
 export { UuidLike } from "./uuidlike.js";
 export { Tnid } from "./factory.js";

package/script/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/script/types.d.ts

@@ -23,14 +23,18 @@ export type ValidateName<S extends string> = ValidateNameChars<S> extends true ?
  * const id: UserId = UserId.new_v0();          // time-sortable
  * const id2: UserId = UserId.new_v1();         // high-entropy random
  *
- * // Parse from strings
- * const parsed = UserId.parse("user.abc...");  // validates name matches
- * const fromUuid = UserId.parseUuidString("d6157329-4640-8e30-...");
+ * // Parse from strings (auto-detects format)
+ * const parsed = UserId.parse("user.abc...");  // TNID string format
+ * const fromUuid = UserId.parse("d6157329-4640-8e30-...");  // UUID format
+ *
+ * // Or use explicit parse methods
+ * UserId.parseTnidString("user.abc...");       // TNID string only
+ * UserId.parseUuidString("d6157329-...");      // UUID string only
  *
  * // DynamicTnid - runtime name validation
- * DynamicTnid.new_v0("item");                  // create with runtime name
- * DynamicTnid.new_v1("item");                  // create with runtime name
- * DynamicTnid.parse("post.xyz...");            // parse any TNID
+ * DynamicTnid.newV0("item");                   // create with runtime name
+ * DynamicTnid.newV1("item");                   // create with runtime name
+ * DynamicTnid.parse("post.xyz...");            // parse any TNID (auto-detects)
  * DynamicTnid.getName(id);                     // "user"
  * DynamicTnid.getVariant(id);                  // "v0" | "v1" | "v2" | "v3"
  *
@@ -70,10 +74,15 @@ export interface NamedTnid<Name extends string> {
     /** Construct a V1 TNID from specific parts (for deterministic testing) */
     v1_from_parts(randomBits: bigint): TnidValue<Name>;
     /**
-     * Parse and validate a TNID string.
+     * Parse a TNID from either TNID string format or UUID hex format (auto-detected).
      * @throws Error if the string is invalid or the name doesn't match
      */
     parse(s: string): TnidValue<Name>;
+    /**
+     * Parse and validate a TNID string (e.g., "user.Br2flcNDfF6LYICnT").
+     * @throws Error if the string is invalid or the name doesn't match
+     */
+    parseTnidString(s: string): TnidValue<Name>;
     /**
      * Parse a UUID hex string into a TNID.
      * Validates that it's a valid UUIDv8 TNID and the name matches.

package/script/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAQA,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAChB,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAER,mFAAmF;AACnF,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,GAC1D,CAAC,SAAS,GAAG,MAAM,KAAK,GAAG,MAAM,IAAI,EAAE,GACrC,KAAK,SAAS,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAChD,KAAK,GACP,KAAK,CAAC;AAEV,0DAA0D;AAC1D,KAAK,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,EAAE,GAC1E,GAAG,CAAC,QAAQ,CAAC,GACb,CAAC,SAAS,GAAG,MAAM,CAAC,GAAG,MAAM,IAAI,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,OAAO,CAAC,CAAC,GAC3E,KAAK,CAAC;AAEV,KAAK,WAAW,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,iBAAiB,CAAC,CAAC,CAAC,SAAS,IAAI,GAC1E,YAAY,CAAC,CAAC,CAAC,SAAS,WAAW,GAAG,CAAC,GACvC,KAAK,GACL,KAAK,CAAC;AAMV;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,SAAS,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,CAAC;AAErE,+DAA+D;AAC/D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,2CAA2C;AAC3C,MAAM,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AAMrC,MAAM,WAAW,SAAS,CAAC,IAAI,SAAS,MAAM;IAC5C,oBAAoB;IACpB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAEpB,oDAAoD;IACpD,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAE1B,6CAA6C;IAC7C,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;IAE1B,0EAA0E;IAC1E,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAExE,0EAA0E;IAC1E,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAE/C,wDAAwD;IACxD,OAAO,IAAI,MAAM,CAAC;IAElB,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC;IAE1C,gDAAgD;IAChD,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CAC9D;AAED,qDAAqD;AACrD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}