sn-date-picker

A Nebula.js date picker visualization for Qlik Sense and embedded apps.

The package publishes the supernova module for host web apps, and the same repo can still generate a Qlik extension bundle for tenant registration.

Install

npm install sn-date-picker @nebula.js/stardust

Use in a host app

Register the visualization type in your Nebula/Stardust configuration, then render it like any other supernova:

import embed from "@nebula.js/stardust";
import snDatePicker from "sn-date-picker";

const n = embed(app, {
  types: [
    {
      name: "sn-date-picker",
      load: () => Promise.resolve(snDatePicker),
    },
  ],
});

If you want to render existing saved objects from a Qlik app, keep the registered name aligned with the object type/load path used by the extension in Qlik Sense.

Package surface

The published package exposes:

• CommonJS: dist/sn-date-picker.js
• ESM: dist/sn-date-picker.esm.js
• TypeScript declarations: dist-types/index.d.ts

The default export is the supernova factory from src/index.tsx.

Local development

Install dependencies:

npm install --legacy-peer-deps

Start the Nebula development server:

npm start

Build the JavaScript bundles:

npm run build

Build the full npm package surface, including declaration files:

npm run build:package

Preview the publish tarball:

npm run pack:check

Publish to npm

1. Log in to npm with npm login.
2. Bump the version with npm version patch, npm version minor, or npm version major.
3. Run npm run pack:check.
4. Publish with npm publish.

If you move to a scoped package name such as @your-org/sn-date-picker, publish with npm publish --access public.

Package for Qlik Sense

Build the Qlik extension bundle:

npm run sense:package

Build and deploy the extension:

npm run sense

Optional environment variables:

QLIK_EXTENSION_BUILD_PATH=../extension_build
QLIK_TENANT=your-tenant.eu.qlikcloud.com
PYTHON_BIN=python3

Testing

Run linting:

npm run lint

Run Playwright end-to-end tests:

npm run test:e2e

Open the Playwright report:

npm run test:e2e:report

Requirements

• Node.js >= 18.10.0
• Qlik Sense, if you also want to deploy the extension bundle

License

MIT