ledger-live: Skill for Claude Code

Barrels and internals

An index.* file is a barrel: a pure regrouping point, nothing else.

// ✅
export * from "./schema";
export type * from "./types";
export { default } from "./useEnv"; // the one tolerated exception

// ❌  sorting in the export proves ./slice mixes public and private
export { accountNamesSlice, bulkSetAccountNames as setAccountNames } from "./slice";

// ❌  an index that contains code is not an index
export const CurrencySchema = z.discriminatedUnion("type", [...]);

Why the sorting matters. If you need to pick which names leave a file, that file holds both public and private code. The fix is never a longer export list — it is moving the private part to an internals location. export * then becomes honest: everything in that file is public.

Enforced by nx run <project>:lint:structure (the plugin), on every index.* under src/, at any depth.

The rule follows a file's role, not its name. It follows every relative export * from a barrel, through any number of files, resolved as the web and native bundlers do, and it reads every source file named in package.json#exports, under any condition. Test support entries (a subpath segment starting with test or mock) are left out. Such a module may declare anything, but it re-exports like a barrel: export * from a relative file and an optional default re-export only. So export * from "./exports" in the index with the sorting or the proxy in exports.ts fails the same way (hidden-barrel, cross-package-reexport, …).

Where a barrel may sit

Under src/, an index.* (platform variants included) is allowed in three places:

1. An entry: src/index.*, or the target of a package.json#exports entry. Test support entries count.
2. Below an entry, through export *. One level below an entry is always fine. Deeper, the barrel is a nested barrel and nested-barrel reports it, unless the chain is pure: every barrel on the way holds only export * from "./x" inside its own folder (plain modules on the way do not count). The wording is BARREL_LOCATION and CHAIN_BREAKS in rules.js. An entry reached from another entry counts from itself, so jest.native.ts re-exporting index.native.ts adds no level, and the entry may hold whatever the barrel rules allow it.
3. An internals location: internals/, as defined below.