angular-switcher 0.1.0

Switch between Angular component files (.ts, .html, styles, .spec.ts) from the Zed editor with a customizable keybinding.
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
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

# Configuration

`angular-switcher` reads TOML configuration with the following precedence (first match wins):

1. `--config <PATH>` on the command line
2. `.angular-switcher.toml` at `$ZED_WORKTREE_ROOT`
3. `$XDG_CONFIG_HOME/angular-switcher/config.toml` (macOS: `~/Library/Application Support/angular-switcher/config.toml`)
4. Built-in defaults

When no config file is found, the built-in defaults are used — they match a standard Angular project out of the box.

## Full schema

See [`templates/angular-switcher.toml`](../templates/angular-switcher.toml) for an annotated example.

### `[cycle]`

| Key            | Type            | Default                              | Notes                                              |
|----------------|-----------------|--------------------------------------|----------------------------------------------------|
| `order`        | `Vec<String>`   | `["ts","html","style","spec"]`       | Must reference targets defined under `[targets.*]` |
| `wrap`         | `bool`          | `true`                               | Cycle wraps past the end                           |
| `skip_missing` | `bool`          | `true`                               | Skip targets whose sibling file doesn't exist      |

### `[targets.<name>]`

Each target identifies a category of files. The default config defines `ts`, `html`, `style`, and `spec`.

| Key                | Type            | Default | Notes                                                    |
|--------------------|-----------------|---------|----------------------------------------------------------|
| `extensions`       | `Vec<String>`   | —       | Required. File extensions (no dot) that belong to this target |
| `exclude_suffixes` | `Vec<String>`   | `[]`    | Filename suffixes that disqualify a match. Useful when one extension is a prefix of another (e.g. `ts` vs `spec.ts`) |
| `preference`       | `Vec<String>`   | `[]`    | When multiple extensions match an existing file, prefer the first listed |

### `[naming]`

| Key                | Type   | Default | Notes                                                |
|--------------------|--------|---------|------------------------------------------------------|
| `fallback_to_stem` | `bool` | `true`  | When the current file matches no target, fall back to the filename stem |

## Recipes

### Skip specs from the cycle

```toml
[cycle]
order = ["ts", "html", "style"]
```

### Prefer Less over Sass

```toml
[targets.style]
extensions = ["less", "scss", "css", "sass"]
preference = ["less", "scss", "css", "sass"]
```

### Use a non-standard spec suffix (e.g. `.test.ts`)

```toml
[targets.ts]
extensions = ["ts"]
exclude_suffixes = ["test.ts"]

[targets.spec]
extensions = ["test.ts"]
```

### Disable wrap (error at the last sibling instead of cycling back)

```toml
[cycle]
wrap = false
```

## Debugging

Pass `--verbose` to see resolution steps on stderr:

```bash
$ angular-switcher --verbose --print foo.component.ts
config: /Users/me/.config/angular-switcher/config.toml
current: target='ts' basename='foo.component' parent='.'
opening: ./foo.component.html
./foo.component.html
```

Strict-schema typos surface as `config error: ...` with exit code `3`.