statuslin.es/.dependency-cruiser.cjs at main · NathanAB/statuslin.es · GitHub

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
88
89
90
91
92
93
94
95
96
97
module.exports = {
  forbidden: [
    {
      name: 'compact-segments-stays-client-safe',
      comment:
        'compactSegments ships in the client bundle; importing the ANSI parser (Anser) from it would pull that library into every page.',
      severity: 'error',
      from: { path: '^src/render/compact-segments\\.ts$' },
      to: { path: '(^src/render/ansi\\.ts$|node_modules/anser)' },
    },
    {
      name: 'routes-no-direct-db',
      comment: 'Routes must go through server functions, not import the DB directly.',
      severity: 'error',
      from: { path: '^src/routes' },
      to: { path: '^src/db' },
    },
    {
      name: 'ui-stays-presentational',
      comment:
        'src/ui may import only src/ui and src/lib. Type-only imports are allowed (erased at build, no runtime coupling) so components can type props against shared data shapes.',
      severity: 'error',
      from: { path: '^src/ui' },
      to: {
        path: '^src/(routes|gallery|submit|review|render|adopt|votes|mods|content|guide|resources|compare)',
        dependencyTypesNot: ['type-only'],
      },
    },
    {
      name: 'gallery-no-cross-feature',
      comment:
        'src/gallery may not import from other feature directories. src/mods builds on the gallery, never the reverse.',
      severity: 'error',
      from: { path: '^src/gallery/' },
      to: { path: '^src/(submit|review|adopt|votes|mods)/' },
    },
    {
      name: 'submit-no-cross-feature',
      comment: 'src/submit may not import from other feature directories.',
      severity: 'error',
      from: { path: '^src/submit/' },
      to: { path: '^src/(gallery|review|adopt|votes|mods)/' },
    },
    {
      name: 'review-no-cross-feature',
      comment:
        'src/review may not import from other feature directories, except the mod code that approving and showing a mod needs: its publish guards, the folder and name a listing takes, queries and GitHub client (ADR 0007).',
      severity: 'error',
      from: { path: '^src/review/' },
      to: {
        path: '^src/(gallery|submit|adopt|votes|mods)/',
        pathNot: '^src/mods/(publish|listing|queries|github)\\.ts$',
      },
    },
    {
      name: 'adopt-no-cross-feature',
      comment: 'src/adopt may not import from other feature directories.',
      severity: 'error',
      from: { path: '^src/adopt/' },
      to: { path: '^src/(gallery|submit|review|votes|mods)/' },
    },
    {
      name: 'votes-no-cross-feature',
      comment: 'src/votes may not import from other feature directories.',
      severity: 'error',
      from: { path: '^src/votes/' },
      to: { path: '^src/(gallery|submit|review|adopt|mods)/' },
    },
    {
      name: 'submissions-no-feature-imports',
      comment:
        'src/submissions records review state for every kind, so status lines and mods can both use it. It may import only src/db and src/lib.',
      severity: 'error',
      from: { path: '^src/submissions/' },
      to: { path: '^src/', pathNot: '^src/(db|lib|submissions)/' },
    },
    {
      name: 'mods-no-cross-feature',
      comment:
        'src/mods may import the shared listing code in src/gallery, but no other feature directory.',
      severity: 'error',
      from: { path: '^src/mods/' },
      to: { path: '^src/(submit|review|adopt|votes)/' },
    },
  ],
  options: {
    doNotFollow: { path: 'node_modules' },
    tsConfig: { fileName: 'tsconfig.json' },
    // TypeScript 7 ships no compiler API, so depcruise can't use it to read .ts/.tsx and silently
    // cruises 0 modules (issue #68). swc parses the TypeScript source directly and
    // still marks `import type` as type-only, which ui-stays-presentational relies on.
    // depcruise still prints a `missing-typescript-transpiler` warning because `tsConfig` is set;
    // it's expected. `tsConfig` only feeds the `@/` alias, which resolves without the TS API, and
    // test/scripts/check-boundaries.test.ts fails if any src module goes uncruised.
    parser: 'swc',
  },
}