Interface: MimeeqEventMap
Maps Mimeeq event names to their payload types.
This interface provides type-safe event handling by associating each event name string with its corresponding payload type. Use it with helper utilities to get full IntelliSense support when adding event listeners.
Events with undefined payloads are notification signals — listen for them
to trigger actions, but event.detail will not contain structured data.
Example
// Type-safe event listener helper
function onMimeeqEvent<K extends keyof MimeeqEventMap>(
eventName: K,
handler: (payload: MimeeqEventMap[K]) => void,
): void {
document.addEventListener(eventName, ((event: CustomEvent) => {
handler(event.detail);
}) as EventListener);
}
// Usage — payload is fully typed as SelectOptionEventPayload
onMimeeqEvent('mimeeq-select-option', (payload) => {
console.log(payload.variantCode, payload.groupName);
});
// Usage — no payload expected
onMimeeqEvent('mimeeq-app-loaded', () => {
console.log('Configurator library ready');
});
Properties
mimeeq-2d-product-initialized
mimeeq-2d-product-initialized:
undefined
2D product fully loaded and all image layers ready.
mimeeq-3d-after-export-image
mimeeq-3d-after-export-image:
undefined
Image exported and saved.
mimeeq-3d-after-export-scene
mimeeq-3d-after-export-scene:
undefined
3D model exported and saved.
mimeeq-3d-before-export-image
mimeeq-3d-before-export-image:
undefined
Image export started.
mimeeq-3d-before-export-scene
mimeeq-3d-before-export-scene:
undefined
3D model export started.
mimeeq-3d-close-full-screen
mimeeq-3d-close-full-screen:
undefined
Left fullscreen view.
mimeeq-3d-hide-dimensions
mimeeq-3d-hide-dimensions:
undefined
Dimensions overlay hidden on the 3D scene.
mimeeq-3d-open-full-screen
mimeeq-3d-open-full-screen:
undefined
Entered fullscreen view.
mimeeq-3d-product-initialized
mimeeq-3d-product-initialized:
undefined
3D product fully initialized and ready for interaction.
mimeeq-3d-show-dimensions
mimeeq-3d-show-dimensions:
undefined
Dimensions overlay shown on the 3D scene.
mimeeq-3d-zoom-out-scene
mimeeq-3d-zoom-out-scene:
undefined
Zoom Out button clicked.
mimeeq-activate-matching-options
mimeeq-activate-matching-options:
DeactivateMatchingOptionsEventPayload
Match Options toggled (activated). Same payload as deactivate — state reflects the new state.
mimeeq-add-to-cart
mimeeq-add-to-cart:
FinishEventPayload
Add to Cart button clicked (basket mode).
mimeeq-app-loaded
mimeeq-app-loaded:
undefined
Configurator library loaded and ready.
mimeeq-app-template-error
mimeeq-app-template-error:
AppTemplateErrorEventPayload
Error loading embed template (file not found or parse failure).
mimeeq-app-url-change
mimeeq-app-url-change:
FinishEventPayload
URL updated after finish action.
mimeeq-ar-get-back-to-configuration
mimeeq-ar-get-back-to-configuration:
ArGoBackEventPayload
Edit button clicked on AR landing page.
mimeeq-auth-loaded
mimeeq-auth-loaded:
undefined
Authentication library loaded.
mimeeq-basket-created
mimeeq-basket-created:
BasketCreatedEventPayload
New basket created.
mimeeq-basket-item-added
mimeeq-basket-item-added:
BasketItemAddedEventPayload
Item added to basket.
mimeeq-basket-submitted
mimeeq-basket-submitted:
BasketSubmittedEventPayload
Basket submitted as order/RFQ.
mimeeq-basket-updated
mimeeq-basket-updated:
BasketUpdatedEventPayload
Basket contents or totals updated.
mimeeq-change-quantity
mimeeq-change-quantity:
ChangeQuantityEventPayload
Quantity changed in the configurator.
mimeeq-clear-filters
mimeeq-clear-filters:
undefined
Clear Filters button clicked.
mimeeq-click-hotspot
mimeeq-click-hotspot:
ClickHotspotEventPayload
Hotspot clicked in the 3D scene.
mimeeq-close-favourites
mimeeq-close-favourites:
undefined
Favourites panel closed.
mimeeq-configurator-clear-history
mimeeq-configurator-clear-history:
undefined
Close button clicked in modal mode, clearing history.
mimeeq-configurator-closed
mimeeq-configurator-closed:
undefined
Configurator modal closed (legacy embed only).
mimeeq-configurator-go-back
mimeeq-configurator-go-back:
undefined
Back arrow clicked in configurator.
mimeeq-deactivate-matching-options
mimeeq-deactivate-matching-options:
DeactivateMatchingOptionsEventPayload
Match Options toggled.
mimeeq-download-file
mimeeq-download-file:
DownloadFileEventPayload
File downloaded from gallery or files tab.
mimeeq-embed-unmounted
mimeeq-embed-unmounted:
undefined
Embed web component removed from DOM.
mimeeq-enter-forgot-password
mimeeq-enter-forgot-password:
undefined
Forgot Password link clicked.
mimeeq-enter-login
mimeeq-enter-login:
undefined
Login form shown.
mimeeq-enter-product
mimeeq-enter-product:
ProductPrefixEventPayload
Product configurator opened.
mimeeq-enter-profile
mimeeq-enter-profile:
undefined
User profile opened.
mimeeq-enter-sign-up
mimeeq-enter-sign-up:
undefined
Sign Up form shown.
mimeeq-favourites-add-collection
mimeeq-favourites-add-collection:
FavouritesCollectionEventPayload
Favourites collection created.
mimeeq-favourites-add-product
mimeeq-favourites-add-product:
ProductPrefixEventPayload
Product added to favourites.
mimeeq-favourites-copy-to-collection
mimeeq-favourites-copy-to-collection:
FavouritesCollectionItemsEventPayload
Items copied to another favourites collection.
mimeeq-favourites-delete-from-collection
mimeeq-favourites-delete-from-collection:
FavouritesDeleteFromCollectionEventPayload
Items removed from a favourites collection.
mimeeq-favourites-move-to-collection
mimeeq-favourites-move-to-collection:
FavouritesCollectionItemsEventPayload
Items moved to another favourites collection.
mimeeq-favourites-remove-collection
mimeeq-favourites-remove-collection:
undefined
Favourites collection(s) deleted.
mimeeq-favourites-remove-product
mimeeq-favourites-remove-product:
ProductPrefixEventPayload
Product removed from favourites.
mimeeq-favourites-update-collection
mimeeq-favourites-update-collection:
FavouritesCollectionEventPayload
Favourites collection updated.
mimeeq-forgot-password-closed
mimeeq-forgot-password-closed:
undefined
Forgot Password modal dismissed.
mimeeq-generate-ar-short-code
mimeeq-generate-ar-short-code:
GenerateArShortCodeEventPayload
AR short code generated.
mimeeq-history-go-back
mimeeq-history-go-back:
HistoryItem
History undo (back) clicked.
mimeeq-history-go-forward
mimeeq-history-go-forward:
HistoryItem
History redo (forward) clicked.
mimeeq-history-reset
mimeeq-history-reset:
undefined
History reset clicked.
mimeeq-leave-forgot-password
mimeeq-leave-forgot-password:
undefined
Forgot Password form closed.
mimeeq-leave-login
mimeeq-leave-login:
undefined
Login form closed.
mimeeq-leave-product
mimeeq-leave-product:
ProductPrefixEventPayload
Product configurator closed.
mimeeq-leave-profile
mimeeq-leave-profile:
undefined
User profile closed.
mimeeq-leave-sign-up
mimeeq-leave-sign-up:
undefined
Sign Up form closed.
mimeeq-login-closed
mimeeq-login-closed:
undefined
Login modal dismissed.
mimeeq-login-success
mimeeq-login-success:
UserData
Login successful.
mimeeq-logout-success
mimeeq-logout-success:
undefined
Logout completed.
mimeeq-modular-abort-action
mimeeq-modular-abort-action:
undefined
Currently active modular action aborted.
mimeeq-modular-add-product-to-scene
mimeeq-modular-add-product-to-scene:
ModularProductSceneEventPayload
Product added to the modular scene.
mimeeq-modular-clear-scene
mimeeq-modular-clear-scene:
undefined
Scene cleared.
mimeeq-modular-clone-product
mimeeq-modular-clone-product:
undefined
Product cloned on the scene.
mimeeq-modular-close-my-scenes
mimeeq-modular-close-my-scenes:
undefined
My Scenes view closed.
mimeeq-modular-close-select-scene-modal
mimeeq-modular-close-select-scene-modal:
undefined
Load Scene modal closed.
mimeeq-modular-close-summary
mimeeq-modular-close-summary:
undefined
Summary closed in modular.
mimeeq-modular-close-warning
mimeeq-modular-close-warning:
undefined
Warning modal closed in modular.
mimeeq-modular-closed
mimeeq-modular-closed:
undefined
Modular modal closed (legacy embed only).
mimeeq-modular-create-new-scene
mimeeq-modular-create-new-scene:
ModularLoadSceneEventPayload
New short code assigned for scene (after New Scene, Clear Scene, or entering a scene).
mimeeq-modular-enter-product
mimeeq-modular-enter-product:
undefined
Modular product entered.