minimize breaking changes

Author: ealmloff

Cargo.toml

@@ -47,6 +47,9 @@ macro = ["dep:dioxus-code-macro", "dioxus-code-macro/lang-rust"]
 runtime = [
     "arborium/lang-rust",
     "dep:arborium-tree-sitter",
+]
+detection = [
+    "runtime",
     "dep:betlang",
 ]
 all-languages = [

README.md

@@ -55,25 +55,27 @@ For editor-style use cases where the source isn't known at compile time:
 
 ```toml
 [dependencies]
-dioxus-code = { version = "0.1", features = ["runtime"] }
+dioxus-code = { version = "0.1", features = ["runtime", "detection"] }
 ```
 
 ```rust
+# #[cfg(feature = "detection")]
+# {
 # use dioxus::prelude::*;
-use dioxus_code::{Code, CodeOptions, Language, SourceCode, Theme};
+use dioxus_code::{Code, Language, SourceCode, Theme};
 # let user_input = String::new();
 # let _ =
 rsx! {
     Code {
-        src: SourceCode::new(user_input)
-            .with_options(CodeOptions::builder().with_language(Language::Rust)),
+        src: SourceCode::builder(user_input).with_language(Language::Auto),
         theme: Theme::GITHUB_LIGHT,
     }
 }
 # ;
+# }
 ```
 
-Language can be set explicitly with the same [`CodeOptions`] builder used by [`code!`], or auto-detected from the source. The default `runtime` feature includes Rust; pass `lang-python`, `lang-toml`, or `all-languages` for the rest.
+`Language::Auto` is available only with the `detection` feature. Without detection, pass a concrete language such as `Language::Rust`. The default `runtime` feature includes Rust; pass `lang-python`, `lang-toml`, or `all-languages` for the rest.
 
 ## Editor
 

build.rs

@@ -104,6 +104,25 @@ fn main() {
         ));
     }
 
+    generated.push_str(
+        r#"    /// Every syntax theme, in declaration order.
+    ///
+    /// ```rust
+    /// use dioxus_code::Theme;
+    /// assert!(Theme::ALL.contains(&Theme::TOKYO_NIGHT));
+    /// ```
+    pub const ALL: &'static [Theme] = &[
+"#,
+    );
+    for theme in &themes {
+        generated.push_str(&format!("        Self::{},\n", theme.const_name));
+    }
+    generated.push_str(
+        r#"    ];
+
+"#,
+    );
+
     generated.push_str(
         r#"}
 "#,

code-editor/Cargo.toml

@@ -17,7 +17,7 @@ targets = ["x86_64-unknown-linux-gnu", "wasm32-unknown-unknown"]
 
 [dependencies]
 dioxus = { version = "0.7.0", default-features = false, features = ["lib"] }
-dioxus-code = { workspace = true, features = ["lang-toml", "lang-python"] }
+dioxus-code = { workspace = true, features = ["detection", "lang-toml", "lang-python"] }
 
 [target.'cfg(target_arch = "wasm32")'.dependencies]
 wasm-bindgen = "0.2"

code-editor/src/lib.rs

@@ -128,7 +128,7 @@ pub fn CodeEditor(props: CodeEditorProps) -> Element {
                 }
                 buffer.highlighted()
             }
-            None => SourceCode::new(props.value.clone())
+            None => SourceCode::builder(props.value.clone())
                 .with_language(props.language)
                 .into(),
         }

docsite/Cargo.toml

@@ -11,7 +11,7 @@ publish = false
 
 [dependencies]
 dioxus = { version = "0.7.0", features = ["router"] }
-dioxus-code = { workspace = true, features = ["all-languages"] }
+dioxus-code = { workspace = true, features = ["all-languages", "detection"] }
 dioxus-code-editor = { workspace = true }
 dioxus-primitives = { git = "https://github.com/DioxusLabs/components", version = "0.0.1", default-features = false, features = ["router"] }
 

docsite/snippets/runtime.rs

@@ -11,7 +11,7 @@ fn App() -> Element {
 
     rsx! {
         Code {
-            src: SourceCode::new(source()).with_language(Language::Rust),
+            src: SourceCode::builder(source()).with_language(Language::Rust),
             theme: CodeTheme::system(Theme::GITHUB_LIGHT, Theme::GITHUB_DARK),
         }
     }

docsite/src/main.rs

@@ -544,7 +544,7 @@ fn Hero(theme: CodeTheme, theme_label: String) -> Element {
                         "."
                     }
                     p { class: "hero-lede",
-                        "A drop-in component with two source modes — compile-time macro and runtime detection. No JS, no flash of unstyled code."
+                        "A drop-in component with two source modes: compile-time macro and runtime highlighting with explicit language selection."
                     }
                     div { class: "hero-terminal-block",
                         div { class: "hero-terminal-bar",
@@ -577,7 +577,7 @@ fn Hero(theme: CodeTheme, theme_label: String) -> Element {
                         span { "{theme_label}" }
                     }
                     div { class: "card-code-body",
-                        Code { src: SourceCode::new(HERO_COUNTER).with_language(Language::Rust), theme }
+                        Code { src: SourceCode::builder(HERO_COUNTER).with_language(Language::Rust), theme }
                     }
                 }
             }
@@ -663,7 +663,7 @@ fn FeatureRowReceipt() -> Element {
                         span { class: "receipt-aside-num", "02" }
                         div {
                             h3 { class: "receipt-aside-title", "SourceCode" }
-                            p { class: "receipt-aside-text", "Pull it in when input is dynamic. Tree-sitter grammars detect language automatically." }
+                            p { class: "receipt-aside-text", "Pull it in when input is dynamic. Pass the language you want to highlight." }
                         }
                     }
                     div { class: "receipt-aside-row",
@@ -785,7 +785,7 @@ fn Docs(scheme: Scheme) -> Element {
                                 }
                                 div { class: "card-code-body",
                                     Code {
-                                        src: SourceCode::new(step.code).with_language(step.language),
+                                        src: SourceCode::builder(step.code).with_language(step.language),
                                         theme,
                                     }
                                 }

examples/basic/src/main.rs

@@ -15,7 +15,7 @@ fn App() -> Element {
                 theme: Theme::RUSTDOC_AYU,
             }
             Code {
-                src: SourceCode::new("fn main() {\n    println!(\"runtime\");\n}")
+                src: SourceCode::builder("fn main() {\n    println!(\"runtime\");\n}")
                     .with_language(Language::Rust),
                 theme: Theme::GITHUB_LIGHT,
             }

examples/editor/Cargo.toml

@@ -11,7 +11,7 @@ publish = false
 
 [dependencies]
 dioxus = { version = "0.7.0" }
-dioxus-code = { workspace = true, features = ["all-languages"] }
+dioxus-code = { workspace = true, features = ["all-languages", "detection"] }
 dioxus-code-editor = { workspace = true }
 
 [features]