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

> 73 lines of code and 12 definitions.

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

## Definitions

- `rewriteReferences` (lexical_declaration, line 35, exported)
- `SCAN_ROOTS` (lexical_declaration, line 17)
- `ROOT_DOCUMENTS` (lexical_declaration, line 19)
- `Move` (interface_declaration, line 21, exported)
- `renameMapOf` (lexical_declaration, line 26, exported)
- `map` (lexical_declaration, line 27, exported)
- `files` (lexical_declaration, line 36, exported)
- `count` (lexical_declaration, line 51, exported)
- `source` (lexical_declaration, line 54, exported)
- `document` (lexical_declaration, line 61, exported)
- `edits` (lexical_declaration, line 62, exported)
- `result` (lexical_declaration, line 76, exported)

## Uses

- [tools/core/iterators/file.iterator.ts](https://banes-lab.com/source/coordination/tools/core/iterators/file.iterator.ts.md)
- [tools/core/transformers/segment.transformer.ts](https://banes-lab.com/source/coordination/tools/core/transformers/segment.transformer.ts.md)

## Used by

- [tools/core/entrypoints/corpus.entrypoint.ts](https://banes-lab.com/source/coordination/tools/core/entrypoints/corpus.entrypoint.ts.md)

## Source

```typescript
import { AXIS_DOCUMENTS, NODE_MODULES, SURFACE_ROOT } from "../constants/path.constants.ts";
import {
    type RenameMap,
    applyEdits,
    editsFromFieldPrefixes,
    editsFromFieldValues,
    editsFromInlinePrefixes,
    editsFromInlines,
} from "./segment.transformer.ts";

import { readSource, toPosix, walk } from "../iterators/file.iterator.ts";
import { REFERENCE_FIELDS } from "../matchers/reference.matcher.ts";
import { readDocument } from "../readers/document.reader.ts";
import { resolve } from "node:path";
import { writeFileSync } from "node:fs";

const SCAN_ROOTS = [SURFACE_ROOT];

const ROOT_DOCUMENTS = AXIS_DOCUMENTS;

export interface Move {
    readonly from: string;
    readonly to: string;
}

export const renameMapOf = function renameMapOf(moves: readonly Move[]): Record<string, string> {
    const map: Record<string, string> = {};
    for (const move of moves) {
        map[move.from] = move.to;
        map[`local:${move.from}`] = `local:${move.to}`;
    }
    return map;
};

export const rewriteReferences = function rewriteReferences(repoRoot: string, map: RenameMap): number {
    const files: string[] = [];

    for (const root of SCAN_ROOTS) {
        for (const file of walk({
            extensions: [".md", ".ts"],
            ignored: [NODE_MODULES],
            root: resolve(repoRoot, root),
        })) {
            files.push(file);
        }
    }
    for (const name of ROOT_DOCUMENTS) {
        files.push(resolve(repoRoot, name));
    }

    let count = 0;

    for (const file of files) {
        let source: string;
        try {
            source = readSource(file);
        } catch {
            continue;
        }

        const document = readDocument(toPosix(repoRoot, file), source);
        const edits = [
            ...editsFromInlines(document, map, ["link-target", "inline-code", "import-path"]),
            ...editsFromFieldPrefixes(document, REFERENCE_FIELDS, map),
            ...editsFromInlinePrefixes(document, map, ["link-target", "inline-code"]),
        ];
        for (const key of REFERENCE_FIELDS) {
            for (const edit of editsFromFieldValues(document, key, map)) {
                edits.push(edit);
            }
        }
        if (edits.length === 0) {
            continue;
        }

        const result = applyEdits(source, edits);
        if (result.rejected.length > 0) {
            continue;
        }
        writeFileSync(file, result.text, "utf8");
        count += result.applied.length;
    }

    return count;
};
```