Restore Rio-free package variants

Author: luccahuguet

.beads/issues.jsonl

@@ -4,6 +4,10 @@ User-visible runtime changes for Yazelix Nova live here.
 
 ## Unreleased
 
+- Four composable `no-rio` package variants restore a terminal-free runtime.
+  They omit Rio and its terminal-only closure, native config, icon, desktop
+  entry, and Ratconfig surface. `yzx enter` remains fully managed in the host
+  terminal; `yzx launch` exits with a direct instruction to use `enter`.
 - Nova uses upstream Zellij `v0.45.0` as the exact fork base and packages Yazi
   26.8.15. Yazi's released Zellij adapter uses native direct Kitty placements,
   so the fork removes its Unicode-placeholder translator while retaining its

CHANGELOG.md

@@ -270,8 +270,11 @@ outside the Nova v1 continuity contract.
 
 ## Packages and platforms
 
-Package names follow `yazelix[-no-helix][-no-yazi]`. Each suffix
+Package names follow `yazelix[-no-rio][-no-helix][-no-yazi]`. Each suffix
 removes that managed package while retaining the integration around it.
+`no-rio` is terminal-free: `yzx enter` uses the current terminal, while
+`yzx launch` explains that Rio is unavailable. It installs no Rio config,
+icon, or desktop entry.
 `no-helix` uses the configured host editor; `no-yazi` requires matching host
 `yazi` and `ya` commands.
 
@@ -285,6 +288,10 @@ as `yazelix` and do not multiply the capability-variant matrix.
 | `yazelix-no-helix` | Yes | No | Yes |
 | `yazelix-no-yazi` | Yes | Yes | No |
 | `yazelix-no-helix-no-yazi` | Yes | No | No |
+| `yazelix-no-rio` | No | Yes | Yes |
+| `yazelix-no-rio-no-helix` | No | No | Yes |
+| `yazelix-no-rio-no-yazi` | No | Yes | No |
+| `yazelix-no-rio-no-helix-no-yazi` | No | No | No |
 
 See [Installation and packages](docs/installation.md) for package variants,
 platform support, SSH use, Home Manager, and updates.
@@ -435,8 +442,9 @@ If Yazelix is useful to you, you can support its development on
 
 ## LOC Scorecard
 
-Yazelix owns **26,177 lines** of tracked text project files. The
+Yazelix owns **26,367 lines** of tracked text project files. The
 [reproducible scorecard](docs/development.md#loc-scorecard) excludes Beads,
 lockfiles, and binary assets.
-This remains 1,328 lines below the pre-Rio fork surface. The current increase
-also records the exact Zellij v0.45.0 fork boundary and Yazi 26.8.15 runtime.
+This remains 1,138 lines below the pre-Rio fork surface. The current increase
+also records the terminal-free package matrix, exact Zellij v0.45.0 fork
+boundary, and Yazi 26.8.15 runtime.

README.md

@@ -55,7 +55,7 @@ pub(crate) fn build_file_actions(paths: &ConfigPaths) -> Vec<ConfigUiFileAction>
         })
         .collect()
 }
-fn file_action_specs(paths: &ConfigPaths) -> impl IntoIterator<Item = FileActionSpec> {
+fn file_action_specs(paths: &ConfigPaths) -> impl Iterator<Item = FileActionSpec> + '_ {
     [
         FileActionSpec {
             source_id: SOURCE_CONFIG,
@@ -202,6 +202,8 @@ fn file_action_specs(paths: &ConfigPaths) -> impl IntoIterator<Item = FileAction
             starter: ZELLIJ_PLUGINS_STARTER,
         },
     ]
+    .into_iter()
+    .filter(|spec| paths.rio_included || spec.source_id != SOURCE_RIO)
 }
 pub(crate) fn write_source_field(
     paths: &ConfigPaths,

crates/yzx-config/src/file_actions.rs

@@ -233,6 +233,7 @@ mod tests {
         )
         .unwrap();
         ConfigPaths {
+            rio_included: true,
             store_root: temp.path.join("store"),
             root: temp.path.join("config.toml"),
             rio: temp.path.join("rio/config.toml"),
@@ -284,6 +285,25 @@ mod tests {
         }
     }
 
+    #[test]
+    fn rio_free_model_has_no_rio_state_or_actions() {
+        let temp = TempHome::new();
+        let mut paths = temp_paths(&temp);
+        paths.rio_included = false;
+        let paths = ensure_config_sources_at(paths).unwrap();
+        let model = build_model(&paths).unwrap();
+
+        assert!(!paths.rio.exists());
+        assert!(!model.tabs.iter().any(|tab| tab == TAB_RIO));
+        assert!(!model.sources.iter().any(|source| source.id == SOURCE_RIO));
+        assert!(
+            !model
+                .file_actions
+                .iter()
+                .any(|action| action.source_id == SOURCE_RIO)
+        );
+    }
+
     #[test]
     fn rio_appearance_projection_owns_only_force_theme() {
         let (_temp, paths) = temp_sources();

crates/yzx-config/src/main.rs

@@ -120,7 +120,7 @@ pub(crate) fn build_model(paths: &ConfigPaths) -> Result<ConfigUiModel> {
     }
     let yazi_dir = paths.yazi_config.parent().expect("Yazi config directory");
     let advanced_dir = paths.nu_config.parent().expect("Nushell config directory");
-    let sources = vec![
+    let mut sources = vec![
         build_config_source(paths, SOURCE_CONFIG, "config.toml", &paths.root),
         build_config_source(paths, SOURCE_RIO, "rio/config.toml", &paths.rio),
         build_config_source(paths, SOURCE_ZELLIJ, "zellij/config.kdl", &paths.zellij),
@@ -161,6 +161,9 @@ pub(crate) fn build_model(paths: &ConfigPaths) -> Result<ConfigUiModel> {
             read_only: true,
         },
     ];
+    if !paths.rio_included {
+        sources.retain(|source| source.id != SOURCE_RIO);
+    }
     fields.extend(yazi);
     if !root_document_valid {
         block_source_fields(
@@ -198,17 +201,21 @@ pub(crate) fn build_model(paths: &ConfigPaths) -> Result<ConfigUiModel> {
 
     Ok(ConfigUiModel {
         sources,
-        tabs: vec![
-            TAB_CONFIG.to_string(),
-            TAB_POPUPS.to_string(),
-            TAB_RIO.to_string(),
-            TAB_ZELLIJ.to_string(),
-            TAB_STARSHIP.to_string(),
-            TAB_HELIX.to_string(),
-            TAB_YAZI.to_string(),
-            TAB_KEYS.to_string(),
-            TAB_ADVANCED.to_string(),
-        ],
+        tabs: [
+            TAB_CONFIG,
+            TAB_POPUPS,
+            TAB_RIO,
+            TAB_ZELLIJ,
+            TAB_STARSHIP,
+            TAB_HELIX,
+            TAB_YAZI,
+            TAB_KEYS,
+            TAB_ADVANCED,
+        ]
+        .into_iter()
+        .filter(|tab| paths.rio_included || *tab != TAB_RIO)
+        .map(str::to_string)
+        .collect(),
         operational_tab: Some(TAB_ADVANCED.to_string()),
         tab_list_tables: BTreeMap::from([
             (TAB_HELIX.to_string(), helix.list_table),

crates/yzx-config/src/model.rs

@@ -1,4 +1,5 @@
 use std::{
+    ffi::OsStr,
     fs,
     path::{Path, PathBuf},
 };
@@ -15,6 +16,7 @@ pub(crate) enum RioAppearanceProjection {
 }
 
 pub(crate) struct ConfigPaths {
+    pub(crate) rio_included: bool,
     pub(crate) store_root: PathBuf,
     pub(crate) root: PathBuf,
     pub(crate) rio: PathBuf,
@@ -87,7 +89,9 @@ pub(crate) fn ensure_config_sources() -> Result<ConfigPaths> {
     ensure_config_sources_at(config_paths()?)
 }
 pub(crate) fn ensure_config_sources_at(paths: ConfigPaths) -> Result<ConfigPaths> {
-    initialize_rio_config(&paths.rio)?;
+    if paths.rio_included {
+        initialize_rio_config(&paths.rio)?;
+    }
     Ok(paths)
 }
 pub(crate) fn initialize_rio_config(path: &Path) -> Result<()> {
@@ -117,6 +121,9 @@ pub(crate) fn project_rio_appearance(
     if !matches!(mode, "dark" | "light") {
         return Err(error(format!("unsupported appearance mode: {mode}")));
     }
+    if !paths.rio_included {
+        return Ok(RioAppearanceProjection::NextLaunch);
+    }
     initialize_rio_config(&paths.rio)?;
     if paths.reject_mutation(&paths.rio, SOURCE_RIO).is_err() {
         return Ok(RioAppearanceProjection::NextLaunch);
@@ -133,6 +140,7 @@ pub(crate) fn project_rio_appearance(
 pub(crate) fn config_paths() -> Result<ConfigPaths> {
     let home = config_home()?;
     Ok(ConfigPaths {
+        rio_included: nonempty_env("YZX_RIO_INCLUDED").as_deref() != Some(OsStr::new("0")),
         store_root: option_env!("YAZELIX_NIX_STORE_ROOT")
             .map(PathBuf::from)
             .ok_or_else(|| error("yzx-config is missing its packaged Nix store root"))?,

crates/yzx-config/src/paths.rs

@@ -10,6 +10,9 @@ fine tuning and configured custom-popup fields. Normal-mode `a` switches between
 Overview and All only when Overview hides at least three fields and one quarter
 of the tab. Search spans All without changing the saved view
 
+Packages with the `no-rio` suffix omit the Rio source, tab, native-file action,
+and initialization. Their remaining configuration surfaces are unchanged
+
 On a free-form setting, `Enter` starts single-line inline editing and `e` opens
 the same staged value in `editor.command`. Inline editing supports Left/Right,
 Home/End, Backspace/Delete, Unicode text, and single-line paste; `Ctrl+e` opens

docs/configuration.md

@@ -108,15 +108,15 @@ git ls-files | grep -Ev '^\.beads/|\.lock$|^assets/' | xargs wc -l
 | --- | ---: |
 | Ignore (`.gitignore`) | 19 |
 | License | 201 |
-| Markdown | 3571 |
+| Markdown | 3605 |
 | JSON | 117 |
-| Nix | 1728 |
+| Nix | 1828 |
 | Shell | 111 |
 | YAML | 431 |
 | TOML | 512 |
 | KDL | 252 |
 | Nu | 11 |
 | Lua | 245 |
-| Rust | 18909 |
+| Rust | 18964 |
 | Text | 71 |
-| Total | 26177 |
+| Total | 26367 |

docs/development.md

@@ -34,23 +34,30 @@ their exact immutable packages. Their running top bars identify that package as
 
 ## Package variants
 
-Package names follow `yazelix[-no-helix][-no-yazi]`:
+Package names follow `yazelix[-no-rio][-no-helix][-no-yazi]`:
 
 | Package | Rio | Managed Helix | Managed Yazi | Linux desktop channel |
 | --- | --- | --- | --- | --- |
 | `yazelix` | Yes | Yes | Yes | Stable |
 | `yazelix-no-helix` | Yes | No | Yes | Stable |
 | `yazelix-no-yazi` | Yes | Yes | No | Stable |
 | `yazelix-no-helix-no-yazi` | Yes | No | No | Stable |
-
+| `yazelix-no-rio` | No | Yes | Yes | None |
+| `yazelix-no-rio-no-helix` | No | No | Yes | None |
+| `yazelix-no-rio-no-yazi` | No | Yes | No | None |
+| `yazelix-no-rio-no-helix-no-yazi` | No | No | No | None |
+
+Rio-free packages omit Rio and its terminal-only closure, native config,
+icon, desktop entry, and Ratconfig tab. Use `yzx enter` from the host terminal;
+`yzx launch` exits with that instruction.
 Helix-free packages replace `yzx-hx` with a clear unavailable command, so set
 `editor.command` to an installed editor such as `nvim`. They neither evaluate
 managed Helix nor retain Helix, Steel, or the packaged grammar closure. Yazi-free
 packages retain the managed launcher, configuration, sidebar, popup, opener,
 and reveal integration but require host-provided `yazi` and `ya` commands with
 matching versions. A pair that differs from Nova's tested version warns and
-continues. The host installation owns optional Yazi preview dependencies. All
-four capability variants exist for `x86_64-linux`, `aarch64-linux`,
+continues. The host installation owns optional Yazi preview dependencies.
+All eight capability variants exist for `x86_64-linux`, `aarch64-linux`,
 `x86_64-darwin`, and `aarch64-darwin`. The full `yazelix-main` and
 `yazelix-edge` channel outputs exist on the same systems and differ only in
 their channel-qualified desktop and runtime identities
@@ -74,16 +81,24 @@ The modifiers compose mechanically:
 nix profile add --refresh github:Yazelix/nova/stable#yazelix-no-helix-no-yazi
 ```
 
+Install the terminal-free full-TUI variant with:
+
+```sh
+nix profile add --refresh github:Yazelix/nova/stable#yazelix-no-rio
+```
+
+Add `-no-helix`, `-no-yazi`, or both to compose the reduced variants.
+
 ## Capability matrix
 
 | Surface | Linux | `aarch64-darwin` |
 | --- | --- | --- |
-| All four package variants | Build- and profile-tested on `x86_64-linux`, with flake outputs also covering `aarch64-linux` | Build-tested on a real GitHub macOS runner |
+| All eight package variants | Build- and profile-tested on `x86_64-linux`, with flake outputs also covering `aarch64-linux` | Exposed; Rio packages are build-tested on a real GitHub macOS runner, while Rio-free variants await hosted evidence |
 | Home Manager module | Activation closure build-tested on `x86_64-linux` | Activation closure build-tested on a real GitHub macOS runner |
 | `enter` with managed Zellij and Yazi plus the selected editor | Contract-tested and used interactively with managed Helix; host-editor delegation is contract-tested | Packaged, with interactive workflow unverified |
 | Full-package `launch` through Rio | Contract-tested and used interactively | Package build-tested, with Rio GUI unverified |
 | Host editor delegation | Contract-tested with the selected host editor remaining host-owned | Packaged, with interactive delegation unverified |
-| Desktop entry | Every package | None, as asserted by the macOS package and Home Manager builds |
+| Desktop entry | Packages that include Rio | None, as asserted by the macOS package and Home Manager builds |
 
 `x86_64-darwin` remains an exposed, evaluated flake output rather than a
 build-tested target. The current label is **build-tested on macOS, with