Skip to content
Beskid The Beskid Book

Beskid

Jump to a Beskid service

Beskid

Jump to a Beskid service

19.4 Package public surface

What registry consumers see is what you exported and documented—not your folder tree.

Package public surface

pckg consumers and the docs UI see your package through api.json and resolved exports. If it is not pub (or re-exported), it is not part of your moral public API even if GitHub can read the file.

  • Document public callables with /// (chapter 20).
  • Run beskid doc before upload (chapter 16).
  • Pack locally to catch manifest lies before registry mutation: beskid pckg pack --package <id> --source . --output <id>.bpk.
  • Upload the validated artifact and its embedded version: beskid pckg upload <id> --artifact <id>.bpk.

20. /// comments that are not lies