teksilo-preview 0.9.0

Storybook-style preview registry for Teksilo widgets — catalog trait, typed knobs and variants, with no GUI dependency.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71

// SPDX-License-Identifier: MPL-2.0
// SPDX-FileCopyrightText: 2026 FernTech

//! Captured source location for a registered widget catalog entry.
//!
//! Populated by the `register_widget_catalog!` macro at expansion time
//! via `file!()` / `line!()`. The previewer's `--file=PATH` resolution
//! matches against the captured `file` by suffix to handle platform
//! path canonicalisation.

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct SourceLoc {
    pub file: &'static str,
    pub line: u32,
}

impl SourceLoc {
    pub const fn new(file: &'static str, line: u32) -> Self {
        Self { file, line }
    }

    /// Match this source location against a path supplied on the command
    /// line. The match is a suffix match — the user typically supplies a
    /// workspace-relative path while `file!()` returns a path relative to
    /// the crate the macro expanded in. Matching by suffix accommodates
    /// both without requiring path canonicalisation.
    pub fn matches_path(&self, target: &str) -> bool {
        // Normalise separators so the comparison is consistent across OSes.
        fn norm(s: &str) -> String {
            s.replace('\\', "/")
        }
        // A suffix match, but only on a `/` component boundary — so a short
        // query like "button.rs" does NOT match ".../radio_button.rs".
        fn suffix_on_boundary(hay: &str, needle: &str) -> bool {
            hay == needle || hay.strip_suffix(needle).is_some_and(|p| p.ends_with('/'))
        }
        let a = norm(self.file);
        let b = norm(target);
        suffix_on_boundary(&a, &b) || suffix_on_boundary(&b, &a)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn matches_path_handles_suffix_matches() {
        let loc = SourceLoc::new("crates/teksilo-widgets/src/button.rs", 42);
        assert!(loc.matches_path("crates/teksilo-widgets/src/button.rs"));
        assert!(loc.matches_path("button.rs"));
        assert!(loc.matches_path("src/button.rs"));
        assert!(!loc.matches_path("crates/teksilo-widgets/src/checkbox.rs"));
    }

    #[test]
    fn suffix_match_respects_component_boundaries() {
        // "button.rs" must not match a sibling whose name merely ends in it.
        let radio = SourceLoc::new("crates/teksilo-widgets/src/radio_button.rs", 1);
        assert!(!radio.matches_path("button.rs"));
        assert!(radio.matches_path("radio_button.rs"));
        assert!(radio.matches_path("src/radio_button.rs"));
    }

    #[test]
    fn matches_path_normalises_separators() {
        let loc = SourceLoc::new("crates\\teksilo-widgets\\src\\button.rs", 1);
        assert!(loc.matches_path("button.rs"));
        assert!(loc.matches_path("src/button.rs"));
    }
}