ssalbdivad
0 issues, ridiculously fast.
Subexpressions like `\\w` or `[a-Z]` would just be inferred as `${string}`, but that doesn't mean the inference won't be useful. For example:
expression: regex("^\\w+@\\w+\\.\\w+$") type: Regex<`${string}@${string}.${string}`>
ArkType 2.1's new pattern matching API showcases that, both in terms of DX and performance.
Would love to get your take!
ArkType 2.1: Syntactic pattern matching 100x faster than ts-pattern
ArkType 2.0: Validate 100x faster with DX that will blow your mind
It also brings types to runtime in a way they've never been available before. They can be introspected and compared just like `extends` in native TS.
Thanks for your patience, and I couldn't be more hyped to see what you do with it!
GitHub: https://github.com/arktypeio/arktype
Docs: https://arktype.io
Discord: https://arktype.io/discord
It can be used in vanilla JS but usually it is used with TypeScript for all the same reasons people normally use TypeScript.
ArkType 2.0 is a no-setup solution for schema validation with a new style of type-safe API that parallels native type syntax.
It also brings types to runtime in a way they've never been available before. They can be introspected and compared just like `extends` in native TS.
Thanks for your patience, and I couldn't be more hyped to see what you do with it!
GitHub: https://github.com/arktypeio/arktype
Docs: https://arktype.io
Discord: https://arktype.io/discord
Personally, I found all the `npm` integration stuff to be a bit overkill for what we were looking for, and honestly Deno's network requests while installing from npm were constantly flaking out in our CI. We ended up just disabling it via Deno's `--no-npm` flag (https://github.com/denoland/deno/issues/17916) and reverting back to a simple set of import_maps to get the node deps we needed. Works like a charm!
Feel free to reference if it's useful:
I look forward to the day when we support 5.0 as our minimum version and replace all of them with `const` generics for 1:1-inferred definitions like this:
const package = type({ name: "string", "version?": "number" })
Plus we’ll finally be able to remove the crazy hack we had to write to allow ts-morph to make type assertions on our codebase by transforming all of our `.ts` imports to `.js` in a virtual file system, which now that I think of it I’m probably looking forward to deleting even more XD
Great work, and looking forward to what comes next!
ArkType: TypeScript's 1:1 validator, optimized from editor to runtime
To my surprise, after a few months of iteration, it turned out it was possible to parse and provide fluid completions for scopes consisting of hundreds of cyclic types (see https://arktype.io/img/typePerf.mp4).
At this point, I started working on an "isomorphic" parser that would allow definitions that looked like native TypeScript syntax to be parsed and enforced at compile-time via TS and at runtime in JavaScript using parallel static and dynamic implementations (see https://github.com/arktypeio/arktype#how). This includes syntactic and semantic validation that your editor can update in real-time as you write a definition (if you want you can try messing around with a definition and corresponding input data in-browser at https://arktype.io/try).
Though as a full type system the library has lots of potential applications, the most obvious is for type-safe data validation as an alternative to approaches like Zod that rely on chained functions. Honestly I just think the fact that TypeScript can parse itself is cool in its own right, but given the prevalence of questions about how ArkType is different/better than existing libraries, I've taken the liberty of summarizing a few of what I believe are the most compelling points preemptively:
- Having definitions that are inferred 1:1 means you'll be hovering to see types less
- Most definitions are just objects and strings and can be easily serialized and eventually could even be used to validate data across multiple languages. Validators that rely on chaining will never be able to do this.
- On average, definitions are about 50% shorter than traditional chained syntax.
- Zod recently announced they were deprecating discriminated unions (see https://github.com/colinhacks/zod/issues/2106) because it was hard to maintain given their architecture. Not only are they supported in `arktype`, they're supported implicitly- you don't even have to tell us what keys to look at.
- The discriminated unions point is really just a special case of a much more general advantage: `arktype` is not just a validator- it's a type system. If we can deeply intersect arbitrary types, optimize them, and determine assignability, we can use all of that to make discrimination much easier (being able to "discriminate" is equivalent to having some common path that has an intersection of `never`)
- Zod claims it's impossible to infer recursive types due to a limitation of TS (see https://zod.dev/?id=recursive-types) and cannot handle cyclic data. ArkType can directly infer cyclic and recursive types and validate cyclic data.
The point of this is not to say Zod is not a good library. It significantly improved inference capabilities and DX relative to the previous generation of validators like Yup. It also still has some features we haven't yet implemented (primarily stuff like `pick` and `merge` as I'm working on adding support for generics).
Plus, we're still on `1.0.9-alpha`, so if I needed a validator for my critical production software, I'd probably go with `zod`.
That said, I do think `arktype` has some fundamental advantages that mean in the long term, it's a better approach to invest in. My current focus in preparing for a stable release is adding docs, optimizing runtime perf, and publishing benchmarks (using similar techniques to https://github.com/sinclairzx81/typebox, so should land somewhere between 50-100x faster than non-optimized validators like Zod).
Do you think that makes sense as a next priority? Do you think any of this makes sense at all, or have I just been coding in TS's type system long enough that my sanity has begun to erode? Agree or not with any of it, I'd love to hear your thoughts :-)
- David
const info = type({ name: "string>0", email: "email" })
ArkType: TypeScript you can take to runtime
By far the most common question I get is "why use this over existing validators like Zod?" so I'll preemptively address it:
- There's a comparison between Zod and ArkType for defining a simple type under "Concision" on our docs site. The definition is much shorter and the inference is cleaner and more intuitive. This is not a cherry-picked case. The examples are from Zod's documentation and ArkType's syntax and type hints are highly optimized for clarity.
- Zod recently announced they were deprecating discriminated unions because it was hard to maintain given their architecture. Not only are they supported in arktype, they're supported implicitly- you don't even have to tell us what keys to look at.
- The discriminated unions point is really just a special case of a much more general advantage: arktype is not just a validator- it's a type system. If we can deeply intersect arbitrary types, optimize them, and determine assignability, we can use all of that to make discrimination much easier (being able to "discriminate" is equivalent to having some common path that has an intersection of never)
- Most ArkType definitions are just objects and strings and can be easily serialized and eventually could even be used to validate data across multiple languages. Validators that rely on chaining will never be able to do this.
- Zod claims the following in their docs:
"You can define a recursive schema in Zod, but because of a limitation of TypeScript, their type can't be statically inferred. Instead you'll need to define the type definition manually, and provide it to Zod as a 'type hint'."
They go on to mention:
"passing cyclical data into Zod will cause an infinite loop"
ArkType can directly infer cyclic and recursive types and validate cyclic data.
The point of this is not to say Zod is not a good library. It significantly improved inference capabilities and DX relative to the previous generation of validators like Yup. It also still has some features we haven't yet implemented (primarily stuff like pick and merge as I'm working on adding support for generics). Plus, we're still on 1.0.8-alpha, so if I needed a validator for my critical production software, I'd probably go with Zod. That said, I do think arktype has some fundamental advantages that mean in the long term, it's a better approach to invest in.
Each character you type is instantly validated both syntactically and semantically using TypeScript's own type system, so you know exactly what to expect from editor to runtime.
Plus, since most definitions are just objects and strings, they can actually be serialized and eventually even shared across languages.
I would love to hear your thoughts on the concept and syntax decisions as I prepare to freeze the API for our first stable 1.0 release (we're currently at 1.0.5-alpha).