functionName of its entry in napps.config.json; see
How App Extensions work.
Async callbacks share the host’s extension timeout. Keep work bounded and return within the
documented three-second budget. A timed-out or rejected promise is treated as a failed callback and
native behavior continues according to the extension contract.
Product listing formatter
Collection filters
trigger is either "Initial" or "UserFiltersChanged". The callback can change the editor
before the product query runs. Boolean mutators return false when the requested filter or value
does not exist.
Product detail handler
false. There is no preventDefault() method on the event object. onAddedToCart receives
{ product, productVariant, quantity }; its quantity is the increase observed after the native
cart addition, so returning false does not undo that addition. onProductSelected receives
{ product, productVariant }. onBeforeProductAddToCart receives { product, variant, quantity }.
PDP formatting and media tags
Cart operations
CartOperation after returning it.
CartOperations is a runtime global typed CartOperations | undefined, also available as
NAPPS.CartOperations. The package exports the interface as a type only.
Cart line-item formatter
null when the underlying catalog object no longer exists.
Product-card bridge
Product-card modules receive their products throughComponentContext.cards.