@selwise/widget 0.0.1

package/dist/npm/esm/modules/recommendation/tracking.js

@@ -0,0 +1,237 @@
+/**
+ * Recommendation Tracking Utilities
+ * Handles event tracking for recommendations
+ */
+import { getOrCreateSessionId, getOrCreateVisitorId, getStoredSiteUserId, generateEventId } from '../../utils/index.js';
+import { STORAGE_KEYS } from '../../constants.js';
+let sessionFallbackWarned = false;
+function generateFallbackSessionId() {
+    const random = Math.random().toString(36).slice(2, 12);
+    return `sid_fallback_${Date.now()}_${random}`;
+}
+export function getSessionId() {
+    try {
+        if (typeof getOrCreateSessionId === 'function') {
+            const sessionId = getOrCreateSessionId();
+            if (sessionId && typeof sessionId === 'string') {
+                return sessionId;
+            }
+        }
+    }
+    catch (error) {
+        if (!sessionFallbackWarned) {
+            sessionFallbackWarned = true;
+            console.warn('[Recommendation] Failed to resolve session ID, using fallback:', error);
+        }
+    }
+    return generateFallbackSessionId();
+}
+export async function trackEvent(type, widgetId, productItemCode, config) {
+    try {
+        const normalizedItemCode = typeof productItemCode === 'string' && productItemCode.trim().length > 0
+            ? productItemCode.trim()
+            : null;
+        if (type === 'click') {
+            try {
+                sessionStorage.setItem(STORAGE_KEYS.LAST_TOUCH_RECO, JSON.stringify({
+                    ts: Date.now(),
+                    recommendationWidgetId: widgetId,
+                    productItemCode: normalizedItemCode,
+                }));
+            }
+            catch {
+                // ignore
+            }
+        }
+        await fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/recommendations/track/event`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                widgetId,
+                eventType: type,
+                productItemCode: normalizedItemCode || undefined,
+                sessionId: getSessionId(),
+                visitorId: getOrCreateVisitorId(),
+                userId: getStoredSiteUserId(),
+                pageUrl: window.location.href,
+                eventId: generateEventId(),
+                metadata: {
+                    referrer: document.referrer || undefined,
+                },
+            }),
+        });
+    }
+    catch (error) {
+        console.error('[Recommendation] Error tracking event:', error);
+    }
+}
+/**
+ * Track user behavior for AI personalization
+ * This populates the UserBehavior table used for user profile embeddings
+ */
+export async function trackBehavior(behaviorType, product, config) {
+    try {
+        await fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/recommendations/track/behavior`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                behaviorType,
+                productItemCode: product.itemCode,
+                productCategory: product.category,
+                productPrice: product.price,
+                sessionId: getSessionId(),
+                visitorId: getOrCreateVisitorId(),
+                siteUserId: getStoredSiteUserId(),
+                pageUrl: window.location.href,
+                referrer: document.referrer || undefined,
+                eventId: generateEventId(),
+            }),
+        });
+    }
+    catch (error) {
+        console.error('[Recommendation] Error tracking behavior:', error);
+    }
+}
+export async function trackSliderNavigation(widgetId, direction, fromSlide, toSlide, config) {
+    try {
+        await fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/events/batch`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                sessionId: getSessionId(),
+                visitorId: getOrCreateVisitorId(),
+                siteUserId: getStoredSiteUserId(),
+                pageUrl: window.location.href,
+                referrer: document.referrer || undefined,
+                events: [{
+                        eventId: generateEventId(),
+                        name: 'slider_navigate',
+                        entityType: 'recommendation',
+                        entityId: widgetId,
+                        metadata: { direction, fromSlide, toSlide },
+                    }],
+            }),
+        });
+    }
+    catch { /* ignore */ }
+}
+export async function trackSliderSwipe(widgetId, direction, config) {
+    try {
+        await fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/events/batch`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                sessionId: getSessionId(),
+                visitorId: getOrCreateVisitorId(),
+                siteUserId: getStoredSiteUserId(),
+                pageUrl: window.location.href,
+                referrer: document.referrer || undefined,
+                events: [{
+                        eventId: generateEventId(),
+                        name: 'slider_swipe',
+                        entityType: 'recommendation',
+                        entityId: widgetId,
+                        metadata: { direction },
+                    }],
+            }),
+        });
+    }
+    catch { /* ignore */ }
+}
+// Use WeakMap to store observers per widget element - allows GC when element is removed
+const widgetObservers = new WeakMap();
+// Regular Set for impression tracking (cleared on cleanup)
+const trackedProductImpressions = new Set();
+export function setupProductImpressionTracking(widgetElement, widgetId, config) {
+    // Cleanup existing observer if any
+    const existingObserver = widgetObservers.get(widgetElement);
+    if (existingObserver) {
+        existingObserver.disconnect();
+    }
+    const productCards = widgetElement.querySelectorAll('.recommendation-card');
+    const observer = new IntersectionObserver((entries) => {
+        entries.forEach(entry => {
+            if (entry.isIntersecting && entry.intersectionRatio >= 0.5) {
+                const card = entry.target;
+                // data-product-id attribute stores canonical productItemCode.
+                const productItemCode = card.dataset.productId;
+                const key = `${widgetId}_${productItemCode}`;
+                if (productItemCode && !trackedProductImpressions.has(key)) {
+                    trackedProductImpressions.add(key);
+                    const position = Array.from(productCards).indexOf(card);
+                    // Track product impression with productItemCode as primary identifier
+                    fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/events/batch`, {
+                        method: 'POST',
+                        headers: { 'Content-Type': 'application/json' },
+                        body: JSON.stringify({
+                            sessionId: getSessionId(),
+                            visitorId: getOrCreateVisitorId(),
+                            siteUserId: getStoredSiteUserId(),
+                            pageUrl: window.location.href,
+                            referrer: document.referrer || undefined,
+                            events: [{
+                                    eventId: generateEventId(),
+                                    name: 'product_impression',
+                                    entityType: 'recommendation',
+                                    entityId: widgetId,
+                                    productItemCode: productItemCode,
+                                    metadata: {
+                                        productItemCode,
+                                        position,
+                                    },
+                                }],
+                        }),
+                    }).catch(() => { });
+                }
+            }
+        });
+    }, { threshold: 0.5 });
+    // Store observer in WeakMap for potential cleanup
+    widgetObservers.set(widgetElement, observer);
+    productCards.forEach(card => observer.observe(card));
+}
+/**
+ * Cleanup tracking state - call on SPA navigation
+ */
+export function cleanupTracking() {
+    trackedProductImpressions.clear();
+    // Note: WeakMap entries auto-cleanup when elements are GC'd
+}
+/**
+ * Track widget impression - call when a recommendation widget is first rendered
+ * This counts as the "Widget Impressions" metric in the funnel
+ */
+export async function trackWidgetImpression(widgetId, config) {
+    try {
+        await fetch(`${config.apiEndpoint}/public/sites/${config.siteKey}/events/batch`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                sessionId: getSessionId(),
+                visitorId: getOrCreateVisitorId(),
+                siteUserId: getStoredSiteUserId(),
+                pageUrl: window.location.href,
+                referrer: document.referrer || undefined,
+                events: [{
+                        eventId: generateEventId(),
+                        name: 'widget_impression',
+                        entityType: 'recommendation',
+                        entityId: widgetId,
+                        metadata: {
+                            timestamp: Date.now(),
+                        },
+                    }],
+            }),
+        });
+    }
+    catch (error) {
+        console.error('[Recommendation] Error tracking widget impression:', error);
+    }
+}
+//# sourceMappingURL=tracking.js.map

package/dist/npm/esm/modules/recommendation/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../../../../src/modules/recommendation/tracking.ts"],"names":[],"mappings":"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"}

package/dist/npm/esm/modules/recommendation/utils/dom.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DOM Manipulation Utilities
+ */
+import type { RecommendationWidget } from '../../../types';
+export declare const RECOMMENDATION_ROOT_ATTR = "data-selwise-recommendation";
+export declare const RECOMMENDATION_ROOT_SELECTOR = "[data-selwise-recommendation=\"true\"]";
+export declare function isWidgetInDOM(widgetId: string): boolean;
+export declare function markRecommendationRoot(element: HTMLElement): void;
+export declare function removeRecommendationRootsFromDOM(): void;
+export declare function insertWidget(widgetElement: HTMLElement, widget: RecommendationWidget): void;

package/dist/npm/esm/modules/recommendation/utils/dom.js

@@ -0,0 +1,63 @@
+/**
+ * DOM Manipulation Utilities
+ */
+export const RECOMMENDATION_ROOT_ATTR = 'data-selwise-recommendation';
+export const RECOMMENDATION_ROOT_SELECTOR = `[${RECOMMENDATION_ROOT_ATTR}="true"]`;
+export function isWidgetInDOM(widgetId) {
+    return !!document.getElementById(`rec-widget-${widgetId}`);
+}
+export function markRecommendationRoot(element) {
+    element.setAttribute(RECOMMENDATION_ROOT_ATTR, 'true');
+}
+export function removeRecommendationRootsFromDOM() {
+    document.querySelectorAll(RECOMMENDATION_ROOT_SELECTOR).forEach((element) => {
+        element.remove();
+    });
+}
+export function insertWidget(widgetElement, widget) {
+    // Idempotency guard: if a widget with the same DOM id already exists,
+    // remove it before inserting the new element.
+    const existingWidget = widgetElement.id ? document.getElementById(widgetElement.id) : null;
+    if (existingWidget && existingWidget !== widgetElement) {
+        existingWidget.remove();
+    }
+    let container = null;
+    if (widget.containerSelector) {
+        container = document.querySelector(widget.containerSelector);
+    }
+    if (!container) {
+        // Insert at end of body if no container specified
+        document.body.appendChild(widgetElement);
+        return;
+    }
+    switch (widget.insertPosition) {
+        case 'before':
+            if (container.parentNode) {
+                container.parentNode.insertBefore(widgetElement, container);
+            }
+            else {
+                document.body.appendChild(widgetElement);
+            }
+            break;
+        case 'after':
+            if (container.parentNode) {
+                container.parentNode.insertBefore(widgetElement, container.nextSibling);
+            }
+            else {
+                document.body.appendChild(widgetElement);
+            }
+            break;
+        case 'prepend':
+            container.insertBefore(widgetElement, container.firstChild);
+            break;
+        case 'replace':
+            container.innerHTML = '';
+            container.appendChild(widgetElement);
+            break;
+        case 'append':
+        default:
+            container.appendChild(widgetElement);
+            break;
+    }
+}
+//# sourceMappingURL=dom.js.map

package/dist/npm/esm/modules/recommendation/utils/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../../../../../../src/modules/recommendation/utils/dom.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AACtE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,wBAAwB,UAAU,CAAC;AAEnF,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAoB;IACzD,OAAO,CAAC,YAAY,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,QAAQ,CAAC,gBAAgB,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC1E,OAAO,CAAC,MAAM,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,aAA0B,EAAE,MAA4B;IACnF,sEAAsE;IACtE,8CAA8C;IAC9C,MAAM,cAAc,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,IAAI,cAAc,IAAI,cAAc,KAAK,aAAa,EAAE,CAAC;QACvD,cAAc,CAAC,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,GAAmB,IAAI,CAAC;IAErC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,SAAS,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,kDAAkD;QAClD,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,QAAQ,MAAM,CAAC,cAAc,EAAE,CAAC;QAC9B,KAAK,QAAQ;YACX,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;gBACzB,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM;QACR,KAAK,OAAO;YACV,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;gBACzB,SAAS,CAAC,UAAU,CAAC,YAAY,CAAC,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM;QACR,KAAK,SAAS;YACZ,SAAS,CAAC,YAAY,CAAC,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YAC5D,MAAM;QACR,KAAK,SAAS;YACZ,SAAS,CAAC,SAAS,GAAG,EAAE,CAAC;YACzB,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YACrC,MAAM;QACR,KAAK,QAAQ,CAAC;QACd;YACE,SAAS,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;YACrC,MAAM;IACV,CAAC;AACH,CAAC"}

package/dist/npm/esm/modules/recommendation/utils/format.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Formatting Utilities
+ */
+export declare function formatPrice(price: number): string;

package/dist/npm/esm/modules/recommendation/utils/format.js

@@ -0,0 +1,10 @@
+/**
+ * Formatting Utilities
+ */
+export function formatPrice(price) {
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency: 'USD',
+    }).format(price);
+}
+//# sourceMappingURL=format.js.map

package/dist/npm/esm/modules/recommendation/utils/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../../../src/modules/recommendation/utils/format.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE;QACpC,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/npm/esm/modules/recommendation/utils/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Recommendation Utils Exports
+ */
+export * from './format';
+export * from './dom';

package/dist/npm/esm/modules/recommendation/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Recommendation Utils Exports
+ */
+export * from './format.js';
+export * from './dom.js';
+//# sourceMappingURL=index.js.map

package/dist/npm/esm/modules/recommendation/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/modules/recommendation/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}

package/dist/npm/esm/modules/renderer/helpers.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compatibility helper exports.
+ * Keep this module as a thin bridge to avoid divergent helper logic.
+ */
+export { getFontWeight, setDataAttributes, createCloseButton, escapeHtml, safeHref, wasInteracted as hasInteracted, markInteracted as markAsInteracted, } from './utils/helpers';

package/dist/npm/esm/modules/renderer/helpers.js

@@ -0,0 +1,6 @@
+/**
+ * Compatibility helper exports.
+ * Keep this module as a thin bridge to avoid divergent helper logic.
+ */
+export { getFontWeight, setDataAttributes, createCloseButton, escapeHtml, safeHref, wasInteracted as hasInteracted, markInteracted as markAsInteracted, } from './utils/helpers.js';
+//# sourceMappingURL=helpers.js.map

package/dist/npm/esm/modules/renderer/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../src/modules/renderer/helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,aAAa,IAAI,aAAa,EAC9B,cAAc,IAAI,gBAAgB,GACnC,MAAM,iBAAiB,CAAC"}

package/dist/npm/esm/modules/renderer/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Widget Renderer - Creates DOM elements for all widget types
+ * Refactored version - uses modular components
+ */
+import type { RendererWidget as Widget, RendererCampaign as Campaign } from '../../types';
+export declare class WidgetRenderer {
+    render(widget: Widget, campaign: Campaign): HTMLElement | null;
+}

package/dist/npm/esm/modules/renderer/index.js

@@ -0,0 +1,48 @@
+/**
+ * Widget Renderer - Creates DOM elements for all widget types
+ * Refactored version - uses modular components
+ */
+import { injectBaseStyles } from './styles/index.js';
+import { resolveWidgetStyles } from './style-resolver.js';
+import { renderAnnouncementBar, renderFloatingButton, renderCustom, renderInlineBanner, renderExitIntentPopup, renderSlideIn, renderEmbeddedCard, renderStickyFooter, renderCountdownTimer, renderCookieConsent, renderProductViewCount, renderCartCount, renderNewsletter, } from './widgets/index.js';
+export class WidgetRenderer {
+    render(widget, campaign) {
+        injectBaseStyles();
+        const normalizedCampaign = {
+            ...campaign,
+            stylesJson: resolveWidgetStyles(widget.type, campaign.stylesJson),
+        };
+        switch (widget.type) {
+            case 'announcement_bar':
+                return renderAnnouncementBar(widget, normalizedCampaign);
+            case 'inline_banner':
+                return renderInlineBanner(widget, normalizedCampaign);
+            case 'floating_button':
+                return renderFloatingButton(widget, normalizedCampaign);
+            case 'exit_intent_popup':
+                return renderExitIntentPopup(widget, normalizedCampaign);
+            case 'slide_in':
+                return renderSlideIn(widget, normalizedCampaign);
+            case 'embedded_card':
+                return renderEmbeddedCard(widget, normalizedCampaign);
+            case 'sticky_footer':
+                return renderStickyFooter(widget, normalizedCampaign);
+            case 'countdown_timer':
+                return renderCountdownTimer(widget, normalizedCampaign);
+            case 'cookie_consent':
+                return renderCookieConsent(widget, normalizedCampaign);
+            case 'custom':
+                return renderCustom(widget, normalizedCampaign);
+            case 'product_view_count':
+                return renderProductViewCount(widget, normalizedCampaign);
+            case 'cart_count':
+                return renderCartCount(widget, normalizedCampaign);
+            case 'newsletter':
+                return renderNewsletter(widget, normalizedCampaign);
+            default:
+                console.warn(`[Selwise] Unknown widget type: ${widget.type}`);
+                return null;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/npm/esm/modules/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/modules/renderer/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAEnB,MAAM,OAAO,cAAc;IACzB,MAAM,CAAC,MAAc,EAAE,QAAkB;QACvC,gBAAgB,EAAE,CAAC;QACnB,MAAM,kBAAkB,GAAa;YACnC,GAAG,QAAQ;YACX,UAAU,EAAE,mBAAmB,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC;SAClE,CAAC;QAEF,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,kBAAkB;gBACrB,OAAO,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAC3D,KAAK,eAAe;gBAClB,OAAO,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACxD,KAAK,iBAAiB;gBACpB,OAAO,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAC1D,KAAK,mBAAmB;gBACtB,OAAO,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAC3D,KAAK,UAAU;gBACb,OAAO,aAAa,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACnD,KAAK,eAAe;gBAClB,OAAO,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACxD,KAAK,eAAe;gBAClB,OAAO,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACxD,KAAK,iBAAiB;gBACpB,OAAO,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAC1D,KAAK,gBAAgB;gBACnB,OAAO,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACzD,KAAK,QAAQ;gBACX,OAAO,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAClD,KAAK,oBAAoB;gBACvB,OAAO,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YAC5D,KAAK,YAAY;gBACf,OAAO,eAAe,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACrD,KAAK,YAAY;gBACf,OAAO,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;YACtD;gBACE,OAAO,CAAC,IAAI,CAAC,kCAAkC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC9D,OAAO,IAAI,CAAC;QAChB,CAAC;IACH,CAAC;CACF"}

package/dist/npm/esm/modules/renderer/style-resolver.d.ts

@@ -0,0 +1 @@
+export declare function resolveWidgetStyles(type: string, stylesJson?: Record<string, any>): Record<string, any>;

package/dist/npm/esm/modules/renderer/style-resolver.js

@@ -0,0 +1,8 @@
+import { sanitizeStyles, isWidgetType } from '../contract/widget-contract.js';
+export function resolveWidgetStyles(type, stylesJson) {
+    if (!isWidgetType(type)) {
+        return stylesJson || {};
+    }
+    return sanitizeStyles(type, stylesJson || {});
+}
+//# sourceMappingURL=style-resolver.js.map

package/dist/npm/esm/modules/renderer/style-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-resolver.js","sourceRoot":"","sources":["../../../../../src/modules/renderer/style-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAmB,MAAM,6BAA6B,CAAC;AAE5F,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,UAAgC;IAEhC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,UAAU,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,cAAc,CAAC,IAAkB,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC"}

package/dist/npm/esm/modules/renderer/styles/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Renderer Base Styles
+ * CSS injection for widget renderer
+ */
+/**
+ * Inject base CSS styles for all widget types
+ */
+export declare function injectBaseStyles(): void;
+/**
+ * Reset style injection state (for testing)
+ */
+export declare function resetStyleInjection(): void;