feat: config types (#128)

# Add TypeScript type definitions for task configuration

This PR adds TypeScript type definitions for the task configuration schema used in `vite.config.*` files. The types are generated using the `ts-rs` crate and are included as a static file in the repository.

Key changes:
- Add `ts-rs` dependency with feature flags to make it optional
- Implement `TS` trait for `Str` and `RelativePathBuf` (both map to TypeScript's `string`)
- Add TypeScript type annotations to all user config structs
- Convert `UserConfigTasks` to a newtype pattern for better TS support
- Include generated TypeScript definition file at `crates/vite_task_graph/task-config.ts`
- Add test to verify generated TypeScript matches the committed file

The TypeScript definitions provide better editor support when users are editing their task configurations in TypeScript/JavaScript-based config files.

Author: branchseer

.github/workflows/ci.yml

@@ -100,12 +100,11 @@ jobs:
           tools: dprint,cargo-shear
           components: clippy rust-docs rustfmt
 
-      - run: |
-          dprint check
-          cargo shear
-          cargo fmt --check
-          # cargo clippy --all-targets --all-features -- -D warnings
-          RUSTDOCFLAGS='-D warnings' cargo doc --no-deps --document-private-items
+      - run: dprint check
+      - run: cargo shear
+      - run: cargo fmt --check
+      # - run: cargo clippy --all-targets --all-features -- -D warnings
+      - run: RUSTDOCFLAGS='-D warnings' cargo doc --no-deps --document-private-items
 
       - uses: crate-ci/typos@85f62a8a84f939ae994ab3763f01a0296d61a7ee # v1.36.2
         with:

Cargo.lock

@@ -88,6 +88,7 @@ passfd = { git = "https://github.com/polachok/passfd", rev = "d55881752c16aced1a
 petgraph = "0.8.2"
 phf = { version = "0.11.3", features = ["macros"] }
 portable-pty = "0.9.0"
+pretty_assertions = "1.4.1"
 rand = "0.9.1"
 ratatui = "0.29.0"
 rayon = "1.10.0"
@@ -116,6 +117,7 @@ toml = "0.9.5"
 tracing = "0.1.43"
 tracing-error = "0.2.1"
 tracing-subscriber = { version = "0.3.19", features = ["env-filter", "serde"] }
+ts-rs = { version = "11.1.0" }
 tui-term = "0.2.0"
 twox-hash = "2.1.1"
 uuid = "1.18.1"

Cargo.toml

@@ -12,10 +12,12 @@ diff-struct = { workspace = true }
 ref-cast = { workspace = true }
 serde = { workspace = true, features = ["derive", "rc"] }
 thiserror = { workspace = true }
+ts-rs = { workspace = true, optional = true }
 vite_str = { workspace = true }
 
 [features]
 absolute-redaction = []
+ts-rs = ["dep:ts-rs", "vite_str/ts-rs"]
 
 [lints]
 workspace = true

crates/vite_path/Cargo.toml

@@ -263,6 +263,38 @@ pub enum FromPathError {
     InvalidPathData(#[from] InvalidPathDataError),
 }
 
+#[cfg(feature = "ts-rs")]
+mod ts_impl {
+    use ts_rs::TS;
+
+    use super::RelativePathBuf;
+
+    impl TS for RelativePathBuf {
+        type OptionInnerType = Self;
+        type WithoutGenerics = Self;
+
+        fn name() -> String {
+            "string".to_owned()
+        }
+
+        fn inline() -> String {
+            "string".to_owned()
+        }
+
+        fn inline_flattened() -> String {
+            panic!("RelativePathBuf cannot be flattened")
+        }
+
+        fn decl() -> String {
+            panic!("RelativePathBuf is a primitive type")
+        }
+
+        fn decl_concrete() -> String {
+            panic!("RelativePathBuf is a primitive type")
+        }
+    }
+}
+
 #[cfg(test)]
 mod tests {
 

crates/vite_path/src/relative.rs

@@ -11,6 +11,10 @@ bincode = { workspace = true }
 compact_str = { workspace = true, features = ["serde"] }
 diff-struct = { workspace = true }
 serde = { workspace = true, features = ["derive"] }
+ts-rs = { workspace = true, optional = true }
+
+[features]
+ts-rs = ["dep:ts-rs"]
 
 [lints]
 workspace = true

crates/vite_str/Cargo.toml

@@ -176,6 +176,38 @@ impl PartialEq<str> for Str {
     }
 }
 
+#[cfg(feature = "ts-rs")]
+mod ts_impl {
+    use ts_rs::TS;
+
+    use super::Str;
+
+    impl TS for Str {
+        type OptionInnerType = Self;
+        type WithoutGenerics = Self;
+
+        fn name() -> String {
+            "string".to_owned()
+        }
+
+        fn inline() -> String {
+            "string".to_owned()
+        }
+
+        fn inline_flattened() -> String {
+            panic!("Str cannot be flattened")
+        }
+
+        fn decl() -> String {
+            panic!("Str is a primitive type")
+        }
+
+        fn decl_concrete() -> String {
+            panic!("Str is a primitive type")
+        }
+    }
+}
+
 #[cfg(test)]
 mod tests {
     use bincode::{config::standard, decode_from_slice, encode_to_vec};

crates/vite_str/src/lib.rs

@@ -14,7 +14,6 @@ path = "src/main.rs"
 anyhow = { workspace = true }
 async-trait = { workspace = true }
 clap = { workspace = true, features = ["derive"] }
-monostate = { workspace = true }
 tokio = { workspace = true, features = ["full"] }
 vite_path = { workspace = true }
 vite_str = { workspace = true }

crates/vite_task_bin/Cargo.toml

@@ -8,7 +8,6 @@ use std::{
 };
 
 use clap::Subcommand;
-use monostate::MustBe;
 use vite_path::AbsolutePath;
 use vite_str::Str;
 use vite_task::{
@@ -120,10 +119,10 @@ impl vite_task::TaskSynthesizer<CustomTaskSubcommand> for TaskSynthesizer {
                     args: [name.clone()].into(),
                     task_options: UserTaskOptions {
                         cache_config: UserCacheConfig::Enabled {
-                            cache: MustBe!(true),
+                            cache: None,
                             enabled_cache_config: EnabledCacheConfig {
-                                envs: Box::new([]),
-                                pass_through_envs: vec![name],
+                                envs: None,
+                                pass_through_envs: Some(vec![name]),
                             },
                         },
                         ..Default::default()

crates/vite_task_bin/src/lib.rs

@@ -23,7 +23,12 @@ vite_str = { workspace = true }
 vite_workspace = { workspace = true }
 
 [dev-dependencies]
+pretty_assertions = { workspace = true }
 tokio = { workspace = true, features = ["fs", "rt-multi-thread"] }
+ts-rs = { workspace = true }
+vite_path = { workspace = true, features = ["ts-rs"] }
+vite_str = { workspace = true, features = ["ts-rs"] }
+which = { workspace = true }
 
 [lints]
 workspace = true