openhab-js has included type definitions which are generated from JSDoc using the typescript npm module.
Type definitions allow supercharged auto-completion in your IDE.
npm run typesThis outputs the type definition files (*.d.ts) to /types.
Pro-tip: Add // @ts-check to the top of your .js files to enable type checking!
To test the generated type definitions for problems, run the test script:
npm run types:testDocs are automatically build on every push to main and deployed to GitHub Pages.
The bundled versions of the library are automatically build and included into the JS Scripting add-on in its build process.
We have a GitHub action which will publish this library automatically when a version tag is pushed. Use the npm version command to bump the version, commit and tag:
npm run build # Perform a local build: Lint, run tests, bundle with webpack, update & test type definitions, build JSDoc
npm version [major | minor | patch] --no-git-tag-version # Select one of the commandsCommit and tag, then push changes and the new tag to the remote.