Skip to content

reference: add the JavaScript SDK API reference - #109

Draft
arrufat wants to merge 1 commit into
mainfrom
javascript-reference
Draft

arrufat wants to merge 1 commit into
mainfrom
javascript-reference

Conversation

@arrufat

@arrufat arrufat commented Sep 22, 2026

Copy link
Copy Markdown
Collaborator

Adds a JavaScript SDK page under Reference (/reference/javascript), the counterpart of the Python SDK page for the lightpanda npm package.

  • scripts/generate-javascript-reference.mjs turns TypeDoc's JSON for lightpanda-js into src/content/reference/javascript.mdx, mirroring generate-python-reference.py: same anchor style (#toolerror, #session-find-element), internal links checked at generation time, deterministic output. Each Session method lists its arguments under it.
  • .github/workflows/javascript-reference.yml regenerates the page daily from lightpanda-js main and opens a PR when it changed, like python-reference.yml. TypeDoc's version and settings are pinned in lightpanda-js (typedoc.json), so no browser binary or TypeDoc pin is needed here.
  • The committed page was generated from lightpanda-js 34cb6d9.

The page matches what the workflow generates from lightpanda-js main, which now includes 34cb6d9.

src/content/reference/javascript.mdx is generated by
scripts/generate-javascript-reference.mjs from the JSON TypeDoc produces
for lightpanda-js, the same way the Python SDK page is generated from
pdoc: one section per public class, method, property, function, option
type and error, with the JSDoc shipped in the package. Session methods
list their arguments under them.

The javascript-reference workflow regenerates it daily from lightpanda-js
main and opens a PR when it changed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant