exports

function Source.exports(source: Source | Source[]): Promise<Source[]>

Takes a source or a list of sources, typically file sources coming from Source.file or Source.files and recursively extracts their export declarations.

The goal is to extract identifiers needed to create barrels such as namespace or record barrels.

Source.exports will return any sources that already have a valid identifier as-is, for example named exports or manually defined aliases via Source.setImportAlias - if this behavior is insufficient, you can use SourceModule.exports directly instead.

Example

source.ts

export const foo = true;
export const bar = true;

const source = await Source.file("./source.ts");
const exports = [source];
Barrel.record(exports, { name: "Foo" });

import * from "./source.ts";

export const Foo = {
    // We can't define the fields because we don't know what they are
}

Compared to using Source.exports:

const source = await Source.file("./source.ts");
const exports = [source];
const exports = await Source.exports(source);
Barrel.record(exports, { name: "Foo" });

import {
    foo,
    bar,
} from "./source.ts";

export const Foo = {
    foo,
    bar,
};