package-public-api

Create an index file at the package root containing only `export *` statements that re-export the intended public modules. Keep all private implementation code in an internals location that is never re-exported from the barrel.

The check fails when an index.* file contains anything other than `export *` statements, such as direct declarations, named re-export lists, or logic. Move that code into the package internals and re-export only through barrels.

Private code belongs in a dedicated internals location inside the package, separate from the modules exposed through the root barrel. This prevents consumers from importing implementation details that are not part of the public API.

Apply them when creating a new package under shared/, domain/, or features/, when editing any index.* barrel file, or when a lint:structure check reports a violation in the Ledger Live monorepo.