{
  "category": "math",
  "version": "2.0.0-alpha.11",
  "functions": [
    {
      "name": "uuid7",
      "kind": "function",
      "description": "Generates a UUID v7 string (RFC 9562).\nUUID v7 embeds a Unix timestamp in milliseconds, making it\nchronologically sortable while retaining randomness.",
      "since": "2.0.0",
      "signatures": [
        {
          "signature": "uuid7(): string",
          "description": "Generates a UUID v7 string (RFC 9562).\nUUID v7 embeds a Unix timestamp in milliseconds, making it\nchronologically sortable while retaining randomness.",
          "params": [],
          "returns": {
            "type": "string",
            "description": "A UUID v7 string in the format `xxxxxxxx-xxxx-7xxx-yxxx-xxxxxxxxxxxx`"
          }
        }
      ],
      "examples": [
        {
          "title": "Generate a UUID v7",
          "description": "Produces a RFC 9562 UUID v7 string with an embedded millisecond timestamp.",
          "code": "uuid7()\n// => \"019077e0-5c70-7b3a-8a1f-3e4d5b6c7d8e\""
        },
        {
          "title": "UUIDs are chronologically sortable",
          "description": "UUID v7 values generated later are lexicographically greater, making them ideal for database primary keys.",
          "code": "const id1 = uuid7();\n// ... later ...\nconst id2 = uuid7();\nid1 < id2 // => true"
        },
        {
          "title": "Each UUID is unique",
          "description": "No two calls produce the same value.",
          "code": "uuid7() !== uuid7() // => true"
        }
      ],
      "sourceFile": "uuid7.ts"
    }
  ]
}