How qlik-oss/nebula.js works
NebulaJS is a collection of libraries and tools for building visualizations and integrating them into applications backed by Qlik’s Associative Engine. The principal workflow is to connect an application to an engine, define or edit visualization data properties, and expose the resulting visualization through Stardust and Nucleus UI components. Supporting branches include selection/listbox behavior, theme resolution, and property conversion. Edges are limited to README claims and relationships visible in the supplied excerpts or SOURCE INDEX; unsampled connections are omitted or dashed.
Main entry points: hypercube-handler.js Visualization property API · index.js Theme API · SelectEngine.jsx Engine connection UI · data-property-handler.js Dimension and measure properties
Components 22
Engine Integration
- Engine connection UI
commands/serve/web/components/Hub/SelectEngine/SelectEngine.jsx - Connection form
commands/serve/web/components/Hub/SelectEngine/FormManager.jsx - Browser connection storage
commands/serve/web/storage.js
Visualization Properties
- Visualization property API
apis/supernova/src/handler/hypercube-handler.js - Dimension and measure properties
apis/supernova/src/handler/data-property-handler.js - Field helpers
apis/supernova/src/handler/utils/field-helper/field-utils.js - Hypercube helpers
apis/supernova/src/handler/utils/hypercube-helper/hypercube-utils.js - Property conversion
apis/conversion/src/array-util.js
Visualization Runtime
- Stardust APIs
apis/stardust/src/index.js - Visualization components
apis/nucleus/src/index.js - On-the-fly list model
apis/nucleus/src/components/listbox/hooks/useOnTheFlyModel.jsx - Session model hook
apis/nucleus/src/hooks/useSessionModel.js - Model store hook
apis/nucleus/src/hooks/useModelStore.js - Instance context
apis/nucleus/src/contexts/InstanceContext.js
UI and Theming
- Listbox rendering
apis/nucleus/src/components/listbox/default-properties.js - Listbox selections
apis/nucleus/src/components/listbox/hooks/selections/listbox-selections.js - Theme API
apis/theme/src/index.js - Palette resolution
apis/theme/src/palette-resolver.js - Style resolution
apis/theme/src/style-resolver.js - Color utilities
apis/theme/src/utils/color/color.js
Other components
- Visualization developer
- Associative Engine
Connections 20
- Visualization developer → Stardust APIs: build or embed
- Associative Engine → Engine connection UI: connect through
- Engine connection UI → Connection form: renders
commands/serve/web/components/Hub/SelectEngine/SelectEngine.jsx - Connection form → Associative Engine: routes connection
commands/serve/web/components/Hub/SelectEngine/FormManager.jsx - Stardust APIs → Visualization property API: configure properties
- Visualization property API → Dimension and measure properties: extends
apis/supernova/src/handler/hypercube-handler.js - Visualization property API → Field helpers: initializes fields
apis/supernova/src/handler/hypercube-handler.js - Visualization property API → Hypercube helpers: manages hypercube
apis/supernova/src/handler/hypercube-handler.js - Visualization property API → Property conversion: uses utilities
apis/supernova/src/handler/hypercube-handler.js - Dimension and measure properties → Field helpers: uses field helpers
apis/supernova/src/handler/data-property-handler.js - Dimension and measure properties → Hypercube helpers: uses cube utilities
apis/supernova/src/handler/data-property-handler.js - Visualization components → Listbox rendering: provides UI
- On-the-fly list model → Session model hook: requests model
apis/nucleus/src/components/listbox/hooks/useOnTheFlyModel.jsx - Session model hook → Model store hook: uses stores
apis/nucleus/src/hooks/useSessionModel.js - Model store hook → Instance context: reads context
apis/nucleus/src/hooks/useModelStore.js - On-the-fly list model → Listbox rendering: uses defaults
apis/nucleus/src/components/listbox/hooks/useOnTheFlyModel.jsx - Theme API → Palette resolution: creates resolver
apis/theme/src/index.js - Theme API → Style resolution: creates resolver
apis/theme/src/index.js - Theme API → Color utilities: uses color utilities
apis/theme/src/index.js - Engine connection UI → Browser connection storage: uses persisted state