feat: add --input to compile (#2328)

## What
- add `--input key=value` to `tinymist compile` and pass values into
`sys.inputs`
- reuse the existing `parse_input_pair` helper

## Why
Align tinymist CLI with Typst's `--input` behavior so `sys.inputs` works
in compile tasks.

## How
- extend `DocNewArgs` to accept inputs and store them in
`ProjectInput.inputs`
- export `parse_input_pair` from `tinymist_world::args` and reuse it

## Testing
- `cargo check -p tinymist-cli`

Author: xiyihan0

crates/tinymist-project/src/args.rs

@@ -1,11 +1,10 @@
 use std::{path::Path, sync::OnceLock};
 
-use clap::ValueHint;
+use clap::{ArgAction, ValueHint, builder::ValueParser};
 use tinymist_std::{bail, error::prelude::Result};
 
-use tinymist_world::args::PdfExportArgs;
-use tinymist_world::args::PngExportArgs;
 pub use tinymist_world::args::{CompileFontArgs, CompilePackageArgs};
+use tinymist_world::args::{PdfExportArgs, PngExportArgs, parse_input_pair};
 
 use crate::PROJECT_ROUTE_USER_ACTION_PRIORITY;
 use crate::model::*;
@@ -31,6 +30,14 @@ pub struct DocNewArgs {
     /// (PWD).
     #[clap(long = "root", env = "TYPST_ROOT", value_name = "DIR")]
     pub root: Option<String>,
+    /// Add a string key-value pair visible through `sys.inputs`.
+    #[clap(
+        long = "input",
+        value_name = "key=value",
+        action = ArgAction::Append,
+        value_parser = ValueParser::new(parse_input_pair),
+    )]
+    pub inputs: Vec<(String, String)>,
     /// Specify the font related arguments.
     #[clap(flatten)]
     pub font: CompileFontArgs,
@@ -74,8 +81,7 @@ impl DocNewArgs {
             lock_dir: Some(ctx.1.to_path_buf()),
             root,
             main,
-            // todo: inputs
-            inputs: vec![],
+            inputs: self.inputs.clone(),
             font_paths,
             system_fonts: !self.font.ignore_system_fonts,
             package_path,

crates/tinymist-world/src/args.rs

@@ -216,7 +216,7 @@ impl CompileOnceArgs {
 ///
 /// This function will return an error if the argument contains no equals sign
 /// or contains the key (before the equals sign) is empty.
-fn parse_input_pair(raw: &str) -> Result<(String, String), String> {
+pub fn parse_input_pair(raw: &str) -> Result<(String, String), String> {
     let (key, val) = raw
         .split_once('=')
         .ok_or("input must be a key and a value separated by an equal sign")?;

tests/e2e/e2e/cli.rs

@@ -96,7 +96,7 @@ fn test_help_lsp() {
 #[test]
 fn test_help_compile_alias() {
     apply_common_filters!();
-    insta_cmd::assert_cmd_snapshot!(cli().arg("c").arg("--help"), @r"
+    insta_cmd::assert_cmd_snapshot!(cli().arg("c").arg("--help"), @"
     success: true
     exit_code: 0
     ----- stdout -----
@@ -127,6 +127,9 @@ fn test_help_compile_alias() {
               
               [env: TYPST_ROOT=REDACTED]
 
+          --input <key=value>
+              Add a string key-value pair visible through `sys.inputs`
+
           --font-path <DIR>
               Add additional directories that are recursively searched for fonts.
               
@@ -231,7 +234,7 @@ fn test_help_compile_alias() {
 #[test]
 fn test_help_compile() {
     apply_common_filters!();
-    insta_cmd::assert_cmd_snapshot!(cli().arg("compile").arg("--help"), @r"
+    insta_cmd::assert_cmd_snapshot!(cli().arg("compile").arg("--help"), @"
     success: true
     exit_code: 0
     ----- stdout -----
@@ -262,6 +265,9 @@ fn test_help_compile() {
               
               [env: TYPST_ROOT=REDACTED]
 
+          --input <key=value>
+              Add a string key-value pair visible through `sys.inputs`
+
           --font-path <DIR>
               Add additional directories that are recursively searched for fonts.