# tools/core/transformers/board.transformer.ts

> 72 lines of code and 24 definitions.

Tree: Coordination tree
Language: typescript
Canonical: https://banes-lab.com/anatomy/coordination#file-coordination-tools-core-transformers-board-transformer-ts
Source text: https://banes-lab.com/assets/sources/source.6343bfe3296ef48deb056496db1bcf15f07b6d513389e45c819609f51539aead.generated.txt

## Definitions

- `isBlank` (lexical_declaration, line 32)
- `compressBoard` (lexical_declaration, line 59, exported)
- `Compression` (interface_declaration, line 3, exported)
- `Span` (interface_declaration, line 10, exported)
- `blockOf` (lexical_declaration, line 15, exported)
- `markers` (lexical_declaration, line 16, exported)
- `opens` (lexical_declaration, line 17, exported)
- `closes` (lexical_declaration, line 18, exported)
- `open` (lexical_declaration, line 20, exported)
- `close` (lexical_declaration, line 21, exported)
- `character` (lexical_declaration, line 34)
- `EXCERPT` (lexical_declaration, line 42)
- `LABEL_TERMINATORS` (lexical_declaration, line 44)
- `labelOffset` (lexical_declaration, line 46)
- `indent` (lexical_declaration, line 47)
- `rest` (lexical_declaration, line 48)
- `i` (lexical_declaration, line 50)
- `lines` (lexical_declaration, line 64, exported)
- `kept` (lexical_declaration, line 65, exported)
- `excised` (lexical_declaration, line 66, exported)
- `fields` (lexical_declaration, line 67, exported)
- `removed` (lexical_declaration, line 68, exported)
- `at` (lexical_declaration, line 71, exported)
- `head` (lexical_declaration, line 81, exported)

## Source

```typescript
import { delimitersIn } from "../analyzers/board.analyzer.ts";

export interface Compression {
    readonly text: string;
    readonly fields: number;
    readonly removed: number;
    readonly excised: readonly string[];
}

export interface Span {
    readonly from: number;
    readonly to: number;
}

export const blockOf = function blockOf(source: string, agent: string): Span | null {
    const markers = delimitersIn(source);
    const opens = markers.filter((mark) => mark.open && mark.agent === agent);
    const closes = markers.filter((mark) => !mark.open && mark.agent === agent);

    const open = opens[0];
    const close = closes[0];
    if (opens.length !== 1 || closes.length !== 1 || open === undefined || close === undefined) {
        return null;
    }
    if (open.line >= close.line) {
        return null;
    }

    return { from: open.line, to: close.line };
};

const isBlank = function isBlank(text: string): boolean {
    for (let i = 0; i < text.length; i += 1) {
        const character = text.charAt(i);
        if (character !== " " && character !== "\t" && character !== "\r") {
            return false;
        }
    }
    return true;
};

const EXCERPT = 90;

const LABEL_TERMINATORS: ReadonlySet<string> = new Set([":", " ", ""]);

const labelOffset = function labelOffset(line: string, marker: string): number {
    const indent = line.length - line.trimStart().length;
    const rest = line.slice(indent);

    for (let i = 0; i < marker.length; i += 1) {
        if (rest[i] !== marker[i]) {
            return -1;
        }
    }

    return LABEL_TERMINATORS.has(rest.charAt(marker.length)) ? indent : -1;
};

export const compressBoard = function compressBoard(source: string, marker: string): Compression {
    if (marker.length === 0) {
        return { excised: [], fields: 0, removed: 0, text: source };
    }

    const lines = source.split("\n");
    const kept: string[] = [];
    const excised: string[] = [];
    let fields = 0;
    let removed = 0;

    for (const line of lines) {
        const at = labelOffset(line, marker);
        if (at === -1) {
            kept.push(line);
            continue;
        }

        fields += 1;
        removed += line.length - at;
        excised.push(line.slice(at, at + EXCERPT).trim());

        const head = line.slice(0, at);
        if (isBlank(head)) {
            continue;
        }
        kept.push(head);
    }

    return { excised, fields, removed, text: kept.join("\n") };
};
```