# types/taxonomy.types.ts

> 140 lines of code and 22 definitions.

Tree: Governance tree
Language: typescript
Layer: infrastructure
Canonical: https://banes-lab.com/anatomy/governance#file-governance-types-taxonomy-types-ts
Source text: https://banes-lab.com/source/governance/types/taxonomy.types.ts.txt

Listed in [types](https://banes-lab.com/api/source/governance/types.md), after [types/syntax.types.ts](https://banes-lab.com/source/governance/types/syntax.types.ts.md) and before [types/writing.types.ts](https://banes-lab.com/source/governance/types/writing.types.ts.md).

## Definitions

- `Concern` (interface_declaration, line 1, exported)
- `ParsedName` (interface_declaration, line 8, exported)
- `ExemptName` (interface_declaration, line 15, exported)
- `ParseFailure` (interface_declaration, line 20, exported)
- `ParseResult` (type_alias_declaration, line 25, exported)
- `ContainerKind` (type_alias_declaration, line 27, exported)
- `LetterCase` (type_alias_declaration, line 29, exported)
- `Splitter` (interface_declaration, line 31, exported)
- `Dialect` (interface_declaration, line 37, exported)
- `Placement` (interface_declaration, line 42, exported)
- `PlacementFinding` (interface_declaration, line 50, exported)
- `TaxonomyFinding` (interface_declaration, line 55, exported)
- `TaxonomyReport` (interface_declaration, line 59, exported)
- `GeneratedFolderForm` (interface_declaration, line 64, exported)
- `ExcludedTrees` (interface_declaration, line 69, exported)
- `TaxonomyView` (interface_declaration, line 73, exported)
- `GrammarRoles` (interface_declaration, line 92, exported)
- `IgnoreDeclaration` (interface_declaration, line 98, exported)
- `TaxonomySource` (type_alias_declaration, line 102, exported)
- `TaxonomyShape` (interface_declaration, line 104, exported)
- `Vocabulary` (interface_declaration, line 130, exported)
- `Jurisdiction` (interface_declaration, line 153, exported)

## Source

```typescript
export interface Concern {
    folder: string;
    tag: string;
    layer: string;
    collection?: string;
}

export interface ParsedName {
    subject: string;
    variant: string | null;
    concern: string;
    ext: string;
}

export interface ExemptName {
    exempt: true;
    marker: string;
}

export interface ParseFailure {
    reason: string;
    word: string;
}

export type ParseResult = ExemptName | ParsedName | ParseFailure;

export type ContainerKind = "container" | "special";

export type LetterCase = "lower" | "upper";

export interface Splitter {
    readonly name: string;
    readonly joiner: string | null;
    readonly letters: LetterCase;
}

export interface Dialect {
    readonly splitter: string;
    readonly extensions: readonly string[];
}

export interface Placement {
    root: string;
    container: string;
    kind: ContainerKind;
    firstBelow: string;
    depth: number;
}

export interface PlacementFinding {
    messageId: string;
    data: Record<string, string>;
}

export interface TaxonomyFinding extends PlacementFinding {
    path: string;
}

export interface TaxonomyReport {
    readonly assessed: number;
    readonly findings: readonly TaxonomyFinding[];
}

export interface GeneratedFolderForm {
    readonly marker: string;
    readonly prefix: string;
}

export interface ExcludedTrees {
    readonly trees: readonly string[];
}

export interface TaxonomyView {
    readonly byFolder: ReadonlyMap<string, Concern>;
    readonly byTag: ReadonlyMap<string, Concern>;
    readonly compoundMarkers: readonly string[];
    readonly containers: ReadonlyMap<string, ReadonlySet<string>>;
    readonly declaredContainers: Readonly<Record<string, readonly string[]>>;
    readonly declaredSpecial: Readonly<Record<string, readonly string[]>>;
    readonly dialects: readonly Dialect[];
    readonly generatedFolder: GeneratedFolderForm | null;
    readonly ignoredNames: readonly string[];
    readonly markerFolders: ReadonlyMap<string, string>;
    readonly maxDepth: number;
    readonly special: ReadonlyMap<string, ReadonlySet<string>>;
    readonly splitters: readonly Splitter[];
    readonly subjects: ReadonlySet<string>;
    readonly fixtureMarkers: readonly string[];
    readonly testMarkers: readonly string[];
}

export interface GrammarRoles {
    readonly rolesAtDepth: readonly (readonly string[])[];
    readonly roleOrder: readonly string[];
    readonly terminalRole: string;
}

export interface IgnoreDeclaration {
    readonly foldersFiles: readonly string[];
}

export type TaxonomySource = Readonly<Record<"Ignored", IgnoreDeclaration>> & TaxonomyShape;

export interface TaxonomyShape {
    readonly Excluded?: ExcludedTrees;
    readonly boundaryDocuments?: readonly string[];
    readonly concerns: readonly Concern[];
    readonly containers: Readonly<Record<string, readonly string[]>>;
    readonly foreignContainers?: Readonly<Record<string, readonly string[]>>;
    readonly grammar: {
        readonly case: string;
        readonly compoundMarkers: readonly string[];
        readonly dialects?: readonly Dialect[];
        readonly file: readonly string[];
        readonly folder: Readonly<Record<string, readonly string[]>>;
        readonly generatedFolder?: GeneratedFolderForm;
        readonly markerFolders?: Readonly<Record<string, string>>;
        readonly maxDepthFromRoot: number;
        readonly separator: string;
        readonly fixtureMarkers?: readonly string[];
        readonly splitters?: readonly Splitter[];
        readonly testMarkers?: readonly string[];
    };
    readonly specialContainers: Readonly<Record<string, readonly string[]>>;
    readonly subjects: readonly string[];
    readonly testMirrors?: Readonly<Record<string, string>>;
    readonly variants: readonly string[];
}

export interface Vocabulary {
    readonly boundaryDocuments: ReadonlySet<string>;
    readonly byFolder: ReadonlyMap<string, Concern>;
    readonly byTag: ReadonlyMap<string, Concern>;
    readonly case: string;
    readonly compoundMarkers: readonly string[];
    readonly dialects: readonly Dialect[];
    readonly excludedTrees: readonly string[];
    readonly fileShapes: readonly string[];
    readonly generatedFolder: GeneratedFolderForm | null;
    readonly ignoredNames: readonly string[];
    readonly legalSubjects: ReadonlySet<string>;
    readonly markerFolders: ReadonlyMap<string, string>;
    readonly maxDepth: number;
    readonly roles: GrammarRoles;
    readonly separator: string;
    readonly splitters: ReadonlyMap<string, Splitter>;
    readonly subjects: ReadonlySet<string>;
    readonly fixtureMarkers: readonly string[];
    readonly testMarkers: readonly string[];
    readonly variants: ReadonlySet<string>;
}

export interface Jurisdiction {
    readonly containers: ReadonlyMap<string, ReadonlySet<string>>;
    readonly foreign: ReadonlyMap<string, ReadonlySet<string>>;
    readonly host: Vocabulary;
    readonly mirrors: ReadonlyMap<string, string>;
    readonly roots: readonly string[];
    readonly special: ReadonlyMap<string, ReadonlySet<string>>;
    readonly vocabularies: ReadonlyMap<string, Vocabulary>;
}
```