feat: Add support for tabular/csv data input.

crates/pikl-core/src/runtime/csv_input.rs

@@ -0,0 +1,208 @@
+//! CSV/TSV input parser. Reads delimited data into [`Item`]s
+//! with structured JSON values. First row is always headers.
+
+use std::io::Read;
+
+use serde_json::{Map, Value};
+
+use crate::error::PiklError;
+use crate::item::Item;
+
+/// Input format for stdin parsing.
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum InputFormat {
+    /// Auto-detect: try JSON lines first, fall back to plain text.
+    Auto,
+    /// Comma-separated values.
+    Csv,
+    /// Tab-separated values.
+    Tsv,
+}
+
+impl InputFormat {
+    /// Parse from a CLI string. Returns None for unknown formats.
+    pub fn from_str_opt(s: &str) -> Option<Self> {
+        match s {
+            "auto" => Some(Self::Auto),
+            "csv" => Some(Self::Csv),
+            "tsv" => Some(Self::Tsv),
+            _ => None,
+        }
+    }
+
+    fn delimiter(self) -> u8 {
+        match self {
+            Self::Tsv => b'\t',
+            _ => b',',
+        }
+    }
+}
+
+/// Result of parsing CSV/TSV input.
+pub struct CsvParseResult {
+    pub items: Vec<Item>,
+    pub headers: Vec<String>,
+}
+
+/// Known top-level fields that get promoted out of meta.
+const KNOWN_FIELDS: &[&str] = &["label", "sublabel", "icon", "group"];
+
+/// Read CSV or TSV from a reader, producing structured Items.
+///
+/// Each row becomes a JSON object. The `label_key` controls
+/// which column becomes the display label. If no column matches
+/// `label_key`, the first column is used as `label`.
+///
+/// Known fields (label, sublabel, icon, group) are promoted to
+/// the top level. Everything else goes into a `meta` object.
+pub fn read_csv_items_sync(
+    reader: impl Read,
+    format: InputFormat,
+    label_key: &str,
+) -> Result<CsvParseResult, PiklError> {
+    let mut csv_reader = csv::ReaderBuilder::new()
+        .delimiter(format.delimiter())
+        .has_headers(true)
+        .from_reader(reader);
+
+    let raw_headers = csv_reader
+        .headers()
+        .map_err(|e| PiklError::CsvParse(e.to_string()))?
+        .clone();
+
+    if raw_headers.is_empty() {
+        return Err(PiklError::CsvParse("no headers found".to_string()));
+    }
+
+    let headers: Vec<String> = raw_headers.iter().map(|h| h.to_string()).collect();
+
+    // Figure out which column is the label. If label_key matches
+    // a header, use that. Otherwise first column becomes "label".
+    let has_label_column = headers.iter().any(|h| h == label_key);
+
+    let mut items = Vec::new();
+    for result in csv_reader.records() {
+        let record = result.map_err(|e| PiklError::CsvParse(e.to_string()))?;
+        let mut top = Map::new();
+        let mut meta = Map::new();
+
+        for (i, field_value) in record.iter().enumerate() {
+            let Some(header) = headers.get(i) else {
+                continue;
+            };
+
+            if !has_label_column && i == 0 {
+                // First column becomes label when no explicit label column exists
+                top.insert("label".to_string(), Value::String(field_value.to_string()));
+                // Also keep it in meta under its original header name
+                meta.insert(header.clone(), Value::String(field_value.to_string()));
+            } else if KNOWN_FIELDS.contains(&header.as_str()) {
+                top.insert(header.clone(), Value::String(field_value.to_string()));
+            } else {
+                meta.insert(header.clone(), Value::String(field_value.to_string()));
+            }
+        }
+
+        if !meta.is_empty() {
+            top.insert("meta".to_string(), Value::Object(meta));
+        }
+
+        let value = Value::Object(top);
+        items.push(Item::new(value, label_key));
+    }
+
+    Ok(CsvParseResult { items, headers })
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use serde_json::json;
+    use std::io::Cursor;
+
+    #[test]
+    fn basic_csv() {
+        let data = "name,age,city\nalice,30,toronto\nbob,25,vancouver\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        assert_eq!(result.items.len(), 2);
+        assert_eq!(result.headers, vec!["name", "age", "city"]);
+        // First column becomes label when no "label" header
+        assert_eq!(result.items[0].label(), "alice");
+        assert_eq!(result.items[1].label(), "bob");
+    }
+
+    #[test]
+    fn csv_with_label_header() {
+        let data = "label,age\nalice,30\nbob,25\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        assert_eq!(result.items[0].label(), "alice");
+        // "age" should be in meta
+        assert_eq!(result.items[0].field_value("meta.age"), Some(&json!("30")));
+    }
+
+    #[test]
+    fn tsv_input() {
+        let data = "name\tage\nalice\t30\nbob\t25\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Tsv, "label").unwrap();
+        assert_eq!(result.items.len(), 2);
+        assert_eq!(result.items[0].label(), "alice");
+    }
+
+    #[test]
+    fn known_fields_promoted() {
+        let data = "label,sublabel,icon,group,extra\nfoo,bar,ic.png,grp,val\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        let item = &result.items[0];
+        assert_eq!(item.label(), "foo");
+        assert_eq!(item.sublabel(), Some("bar"));
+        assert_eq!(item.icon(), Some("ic.png"));
+        assert_eq!(item.group(), Some("grp"));
+        assert_eq!(item.field_value("meta.extra"), Some(&json!("val")));
+    }
+
+    #[test]
+    fn first_column_label_also_in_meta() {
+        let data = "name,age\nalice,30\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        // First column promoted to label
+        assert_eq!(result.items[0].label(), "alice");
+        // Original header name also in meta
+        assert_eq!(
+            result.items[0].field_value("meta.name"),
+            Some(&json!("alice"))
+        );
+    }
+
+    #[test]
+    fn quoted_fields() {
+        let data = "name,bio\nalice,\"likes, commas\"\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        assert_eq!(
+            result.items[0].field_value("meta.bio"),
+            Some(&json!("likes, commas"))
+        );
+    }
+
+    #[test]
+    fn empty_input_errors() {
+        let data = "";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label");
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn headers_only_no_rows() {
+        let data = "name,age\n";
+        let result = read_csv_items_sync(Cursor::new(data), InputFormat::Csv, "label").unwrap();
+        assert!(result.items.is_empty());
+        assert_eq!(result.headers, vec!["name", "age"]);
+    }
+
+    #[test]
+    fn input_format_from_str() {
+        assert_eq!(InputFormat::from_str_opt("csv"), Some(InputFormat::Csv));
+        assert_eq!(InputFormat::from_str_opt("tsv"), Some(InputFormat::Tsv));
+        assert_eq!(InputFormat::from_str_opt("auto"), Some(InputFormat::Auto));
+        assert_eq!(InputFormat::from_str_opt("xml"), None);
+    }
+}

crates/pikl-core/src/runtime/debounce.rs

@@ -36,10 +36,7 @@ pub struct DebouncedDispatcher {
 }
 
 impl DebouncedDispatcher {
-    pub fn new(
-        handler: Arc<dyn HookHandler>,
-        action_tx: mpsc::Sender<Action>,
-    ) -> Self {
+    pub fn new(handler: Arc<dyn HookHandler>, action_tx: mpsc::Sender<Action>) -> Self {
         Self {
             handler,
             _action_tx: action_tx,
@@ -71,11 +68,7 @@ impl DebouncedDispatcher {
     /// Dispatch a hook event through the debounce system.
     pub fn dispatch(&mut self, event: HookEvent) {
         let kind = event.kind();
-        let mode = self
-            .modes
-            .get(&kind)
-            .cloned()
-            .unwrap_or(DebounceMode::None);
+        let mode = self.modes.get(&kind).cloned().unwrap_or(DebounceMode::None);
 
         tracing::debug!(event_kind = ?kind, mode = ?mode, "dispatching hook event");
 

crates/pikl-core/src/runtime/hook.rs

@@ -188,9 +188,8 @@ mod tests {
     #[test]
     fn response_add_items() {
         let json = r#"{"action": "add_items", "items": [{"label": "new"}]}"#;
-        let resp: HookResponse = serde_json::from_str(json).unwrap_or_else(|e| {
-            std::unreachable!("parse failed: {e}")
-        });
+        let resp: HookResponse =
+            serde_json::from_str(json).unwrap_or_else(|e| std::unreachable!("parse failed: {e}"));
         assert_eq!(
             resp,
             HookResponse::AddItems {
@@ -202,9 +201,8 @@ mod tests {
     #[test]
     fn response_replace_items() {
         let json = r#"{"action": "replace_items", "items": ["a", "b"]}"#;
-        let resp: HookResponse = serde_json::from_str(json).unwrap_or_else(|e| {
-            std::unreachable!("parse failed: {e}")
-        });
+        let resp: HookResponse =
+            serde_json::from_str(json).unwrap_or_else(|e| std::unreachable!("parse failed: {e}"));
         assert_eq!(
             resp,
             HookResponse::ReplaceItems {
@@ -216,9 +214,8 @@ mod tests {
     #[test]
     fn response_remove_items() {
         let json = r#"{"action": "remove_items", "indices": [0, 3, 5]}"#;
-        let resp: HookResponse = serde_json::from_str(json).unwrap_or_else(|e| {
-            std::unreachable!("parse failed: {e}")
-        });
+        let resp: HookResponse =
+            serde_json::from_str(json).unwrap_or_else(|e| std::unreachable!("parse failed: {e}"));
         assert_eq!(
             resp,
             HookResponse::RemoveItems {
@@ -230,9 +227,8 @@ mod tests {
     #[test]
     fn response_set_filter() {
         let json = r#"{"action": "set_filter", "text": "hello"}"#;
-        let resp: HookResponse = serde_json::from_str(json).unwrap_or_else(|e| {
-            std::unreachable!("parse failed: {e}")
-        });
+        let resp: HookResponse =
+            serde_json::from_str(json).unwrap_or_else(|e| std::unreachable!("parse failed: {e}"));
         assert_eq!(
             resp,
             HookResponse::SetFilter {
@@ -244,9 +240,8 @@ mod tests {
     #[test]
     fn response_close() {
         let json = r#"{"action": "close"}"#;
-        let resp: HookResponse = serde_json::from_str(json).unwrap_or_else(|e| {
-            std::unreachable!("parse failed: {e}")
-        });
+        let resp: HookResponse =
+            serde_json::from_str(json).unwrap_or_else(|e| std::unreachable!("parse failed: {e}"));
         assert_eq!(resp, HookResponse::Close);
     }
 

crates/pikl-core/src/runtime/json_menu.rs

@@ -5,6 +5,7 @@
 use crate::filter::Filter;
 use crate::format::FormatTemplate;
 use crate::item::Item;
+use crate::model::column::ColumnConfig;
 use crate::model::traits::{Menu, MutableMenu};
 use crate::pipeline::FilterPipeline;
 
@@ -19,6 +20,7 @@ pub struct JsonMenu {
     filter: FilterPipeline,
     filter_fields: Vec<String>,
     format_template: Option<FormatTemplate>,
+    column_config: Option<ColumnConfig>,
 }
 
 impl JsonMenu {
@@ -36,6 +38,7 @@ impl JsonMenu {
             filter,
             filter_fields: vec!["label".to_string()],
             format_template: None,
+            column_config: None,
         }
     }
 
@@ -52,6 +55,11 @@ impl JsonMenu {
         self.format_template = Some(template);
     }
 
+    /// Set the column config for table mode rendering.
+    pub fn set_column_config(&mut self, config: ColumnConfig) {
+        self.column_config = Some(config);
+    }
+
     /// Rebuild the filter pipeline from scratch. Called after
     /// filter_fields change or item mutations.
     fn rebuild_pipeline(&mut self) {
@@ -141,6 +149,16 @@ impl Menu for JsonMenu {
         let orig_idx = self.filter.matched_index(filtered_index)?;
         Some(template.render(&self.items[orig_idx].value))
     }
+
+    fn column_values(&self, filtered_index: usize) -> Option<Vec<String>> {
+        let config = self.column_config.as_ref()?;
+        let orig_idx = self.filter.matched_index(filtered_index)?;
+        Some(config.resolve_values(&self.items[orig_idx].value))
+    }
+
+    fn column_config(&self) -> Option<&ColumnConfig> {
+        self.column_config.as_ref()
+    }
 }
 
 impl MutableMenu for JsonMenu {
@@ -177,7 +195,11 @@ impl MutableMenu for JsonMenu {
                 self.items.remove(idx);
             }
         }
-        tracing::debug!(count, remaining = self.items.len(), "items removed from menu");
+        tracing::debug!(
+            count,
+            remaining = self.items.len(),
+            "items removed from menu"
+        );
         self.rebuild_pipeline();
     }
 }

crates/pikl-core/src/runtime/menu.rs

@@ -9,9 +9,9 @@ use indexmap::IndexSet;
 use tokio::sync::{broadcast, mpsc};
 use tracing::{debug, info, trace};
 
-use crate::debounce::{hook_response_to_action, DebouncedDispatcher};
+use crate::debounce::{DebouncedDispatcher, hook_response_to_action};
 use crate::error::PiklError;
-use crate::event::{Action, MenuEvent, MenuResult, Mode, ViewState, VisibleItem};
+use crate::event::{Action, ColumnHeader, MenuEvent, MenuResult, Mode, ViewState, VisibleItem};
 use crate::hook::{HookEvent, HookHandler};
 use crate::model::traits::MutableMenu;
 use crate::navigation::Viewport;
@@ -97,14 +97,16 @@ impl SelectionState {
     /// Undo the last selection change.
     pub fn undo(&mut self) {
         if let Some(prev) = self.undo_stack.pop() {
-            self.redo_stack.push(std::mem::replace(&mut self.selected, prev));
+            self.redo_stack
+                .push(std::mem::replace(&mut self.selected, prev));
         }
     }
 
     /// Redo a previously undone selection change.
     pub fn redo(&mut self) {
         if let Some(next) = self.redo_stack.pop() {
-            self.undo_stack.push(std::mem::replace(&mut self.selected, next));
+            self.undo_stack
+                .push(std::mem::replace(&mut self.selected, next));
         }
     }
 
@@ -232,22 +234,56 @@ impl<M: MutableMenu> MenuRunner<M> {
     fn build_view_state(&mut self) -> ViewState {
         self.generation += 1;
         let range = self.viewport.visible_range();
+        let has_columns = self.menu.column_config().is_some();
         let visible_items: Vec<VisibleItem> = range
             .clone()
             .filter_map(|i| {
                 self.menu.filtered_label(i).map(|label| {
                     let formatted_text = self.menu.formatted_label(i);
                     let orig_idx = self.menu.original_index(i).unwrap_or(0);
+                    let column_values = if has_columns {
+                        self.menu.column_values(i)
+                    } else {
+                        None
+                    };
                     VisibleItem {
                         label: label.to_string(),
                         formatted_text,
                         index: i,
                         selected: self.selection.is_selected(orig_idx),
+                        column_values,
                     }
                 })
             })
             .collect();
 
+        // Compute column headers with widths if table mode is active
+        let columns = self.menu.column_config().map(|config| {
+            config
+                .columns
+                .iter()
+                .enumerate()
+                .map(|(col_idx, col_def)| {
+                    let header_len = col_def.display_name.len();
+                    let max_cell = visible_items
+                        .iter()
+                        .filter_map(|vi| {
+                            vi.column_values
+                                .as_ref()
+                                .and_then(|cv| cv.get(col_idx))
+                                .map(|s| s.len())
+                        })
+                        .max()
+                        .unwrap_or(0);
+                    let width = header_len.max(max_cell).min(60) as u16;
+                    ColumnHeader {
+                        display_name: col_def.display_name.clone(),
+                        width,
+                    }
+                })
+                .collect()
+        });
+
         let cursor = if self.menu.filtered_count() == 0 {
             0
         } else {
@@ -263,6 +299,7 @@ impl<M: MutableMenu> MenuRunner<M> {
             mode: self.mode,
             selection_count: self.selection.count(),
             multi_enabled: self.selection.multi_enabled,
+            columns,
             generation: self.generation,
         }
     }
@@ -404,7 +441,9 @@ impl<M: MutableMenu> MenuRunner<M> {
                     let items: Vec<(Value, usize)> = indices
                         .into_iter()
                         .filter_map(|orig_idx| {
-                            self.menu.serialize_original(orig_idx).map(|v| (v.clone(), orig_idx))
+                            self.menu
+                                .serialize_original(orig_idx)
+                                .map(|v| (v.clone(), orig_idx))
                         })
                         .collect();
                     if items.is_empty() {
@@ -572,8 +611,7 @@ impl<M: MutableMenu> MenuRunner<M> {
                     return Ok(MenuResult::Selected { items });
                 }
                 ActionOutcome::Quicklist { items } => {
-                    let values: Vec<Value> =
-                        items.iter().map(|(v, _)| v.clone()).collect();
+                    let values: Vec<Value> = items.iter().map(|(v, _)| v.clone()).collect();
                     let count = values.len();
                     info!(count, "quicklist returned");
                     self.emit_hook(HookEvent::Quicklist {
@@ -582,9 +620,7 @@ impl<M: MutableMenu> MenuRunner<M> {
                     });
                     self.emit_hook(HookEvent::Close);
 
-                    let _ = self
-                        .event_tx
-                        .send(MenuEvent::Quicklist(values));
+                    let _ = self.event_tx.send(MenuEvent::Quicklist(values));
                     return Ok(MenuResult::Quicklist { items });
                 }
                 ActionOutcome::Cancelled => {
@@ -673,7 +709,9 @@ mod tests {
         let mut m = ready_menu();
         m.apply_action(Action::MoveDown(1));
         let outcome = m.apply_action(Action::Confirm);
-        assert!(matches!(&outcome, ActionOutcome::Selected { items } if items[0].0.as_str() == Some("beta")));
+        assert!(
+            matches!(&outcome, ActionOutcome::Selected { items } if items[0].0.as_str() == Some("beta"))
+        );
     }
 
     #[test]
@@ -859,10 +897,14 @@ mod tests {
         let _ = tx.send(Action::Confirm).await;
 
         let event = rx.recv().await;
-        assert!(matches!(&event, Ok(MenuEvent::Selected(items)) if items[0].0.as_str() == Some("alpha")));
+        assert!(
+            matches!(&event, Ok(MenuEvent::Selected(items)) if items[0].0.as_str() == Some("alpha"))
+        );
 
         let result = handle.await.unwrap_or(Ok(MenuResult::Cancelled));
-        assert!(matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("alpha")));
+        assert!(
+            matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("alpha"))
+        );
     }
 
     #[tokio::test]
@@ -884,7 +926,9 @@ mod tests {
         let _ = tx.send(Action::Confirm).await;
 
         let result = handle.await.unwrap_or(Ok(MenuResult::Cancelled));
-        assert!(matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("gamma")));
+        assert!(
+            matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("gamma"))
+        );
     }
 
     #[tokio::test]
@@ -909,7 +953,9 @@ mod tests {
         let _ = tx.send(Action::Confirm).await;
 
         let result = handle.await.unwrap_or(Ok(MenuResult::Cancelled));
-        assert!(matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("delta")));
+        assert!(
+            matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("delta"))
+        );
     }
 
     #[tokio::test]
@@ -944,7 +990,9 @@ mod tests {
         let _ = tx.send(Action::Confirm).await;
 
         let result = handle.await.unwrap_or(Ok(MenuResult::Cancelled));
-        assert!(matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("epsilon")));
+        assert!(
+            matches!(result, Ok(MenuResult::Selected { ref items, .. }) if items[0].0.as_str() == Some("epsilon"))
+        );
     }
 
     #[tokio::test]
@@ -1211,10 +1259,7 @@ mod tests {
         match outcome {
             ActionOutcome::Quicklist { items } => {
                 assert_eq!(items.len(), 4);
-                let labels: Vec<&str> = items
-                    .iter()
-                    .filter_map(|(v, _)| v.as_str())
-                    .collect();
+                let labels: Vec<&str> = items.iter().filter_map(|(v, _)| v.as_str()).collect();
                 assert_eq!(labels, vec!["alpha", "beta", "gamma", "delta"]);
             }
             other => panic!("expected Quicklist, got {other:?}"),
@@ -1661,4 +1706,103 @@ mod tests {
         assert!(vs.visible_items[0].selected);
         assert!(!vs.visible_items[1].selected);
     }
+
+    // -- Column / table mode tests --
+
+    use crate::model::column::ColumnConfig;
+
+    fn table_menu() -> MenuRunner<JsonMenu> {
+        let items = vec![
+            Item::new(
+                serde_json::json!({"label": "alice", "meta": {"age": "30", "city": "toronto"}}),
+                "label",
+            ),
+            Item::new(
+                serde_json::json!({"label": "bob", "meta": {"age": "25", "city": "vancouver"}}),
+                "label",
+            ),
+            Item::new(
+                serde_json::json!({"label": "charlie", "meta": {"age": "35", "city": "montreal"}}),
+                "label",
+            ),
+        ];
+        let mut json_menu = JsonMenu::new(items, "label".to_string());
+        json_menu.set_column_config(ColumnConfig::parse("label,meta.age:Age,meta.city:City"));
+        let (runner, _tx) = MenuRunner::new(json_menu);
+        runner
+    }
+
+    fn ready_table_menu() -> MenuRunner<JsonMenu> {
+        let mut m = table_menu();
+        m.run_filter();
+        m.apply_action(Action::Resize { height: 10 });
+        m
+    }
+
+    #[test]
+    fn view_state_has_columns_when_config_set() {
+        let mut m = ready_table_menu();
+        let vs = m.build_view_state();
+        assert!(vs.columns.is_some(), "columns should be Some");
+        let cols = vs.columns.as_ref().unwrap();
+        assert_eq!(cols.len(), 3);
+        assert_eq!(cols[0].display_name, "label");
+        assert_eq!(cols[1].display_name, "Age");
+        assert_eq!(cols[2].display_name, "City");
+    }
+
+    #[test]
+    fn view_state_column_widths_computed() {
+        let mut m = ready_table_menu();
+        let vs = m.build_view_state();
+        let cols = vs.columns.as_ref().unwrap();
+        // "label" header is 5 chars, "charlie" is 7 chars: width should be 7
+        assert_eq!(cols[0].width, 7);
+        // "Age" header is 3 chars, max cell "35" is 2 chars: width should be 3
+        assert_eq!(cols[1].width, 3);
+        // "City" header is 4 chars, "vancouver" is 9 chars: width should be 9
+        assert_eq!(cols[2].width, 9);
+    }
+
+    #[test]
+    fn view_state_items_have_column_values() {
+        let mut m = ready_table_menu();
+        let vs = m.build_view_state();
+        let item = &vs.visible_items[0];
+        assert!(item.column_values.is_some());
+        let vals = item.column_values.as_ref().unwrap();
+        assert_eq!(vals, &["alice", "30", "toronto"]);
+    }
+
+    #[test]
+    fn view_state_no_columns_without_config() {
+        let mut m = ready_menu();
+        let vs = m.build_view_state();
+        assert!(vs.columns.is_none());
+        assert!(vs.visible_items[0].column_values.is_none());
+    }
+
+    #[test]
+    fn table_mode_filter_still_works() {
+        let mut m = ready_table_menu();
+        m.apply_action(Action::UpdateFilter("bob".to_string()));
+        let vs = m.build_view_state();
+        assert_eq!(vs.total_filtered, 1);
+        assert_eq!(vs.visible_items[0].label, "bob");
+        // Column values should still be present
+        let vals = vs.visible_items[0].column_values.as_ref().unwrap();
+        assert_eq!(vals, &["bob", "25", "vancouver"]);
+    }
+
+    #[test]
+    fn table_mode_column_widths_change_with_filter() {
+        let mut m = ready_table_menu();
+        m.apply_action(Action::UpdateFilter("alice".to_string()));
+        let vs = m.build_view_state();
+        let cols = vs.columns.as_ref().unwrap();
+        // Only "alice" visible now, so label width = max(5, 5) = 5
+        assert_eq!(cols[0].width, 5);
+        // City "toronto" (7) vs header "City" (4): width = 7
+        assert_eq!(cols[2].width, 7);
+    }
 }

crates/pikl-core/src/runtime/mod.rs

@@ -1,3 +1,4 @@
+pub mod csv_input;
 pub mod debounce;
 pub mod hook;
 pub mod input;