@preprio/prepr-nextjs 1.3.2 → 2.0.0-alpha.5

package/dist/utils/index.d.cts

@@ -0,0 +1,138 @@
+import { ClassValue } from 'clsx';
+
+declare const StegaError: {
+    readonly DECODE_FAILED: "STEGA_DECODE_FAILED";
+    readonly INVALID_FORMAT: "STEGA_INVALID_FORMAT";
+    readonly DOM_MANIPULATION_FAILED: "DOM_MANIPULATION_FAILED";
+    readonly CONTEXT_NOT_FOUND: "CONTEXT_NOT_FOUND";
+};
+type StegaErrorType = (typeof StegaError)[keyof typeof StegaError];
+interface ErrorAdditionalData {
+    input?: string;
+    element?: HTMLElement;
+    context?: string;
+    [key: string]: string | HTMLElement | undefined;
+}
+interface ErrorInfo {
+    type: StegaErrorType;
+    context: string;
+    message: string;
+    timestamp: string;
+    stack?: string;
+    additionalData?: ErrorAdditionalData;
+}
+declare function createErrorInfo(type: StegaErrorType, context: string, error: Error, additionalData?: ErrorAdditionalData): ErrorInfo;
+declare function handleStegaError(error: Error, context: string, additionalData?: ErrorAdditionalData): ErrorInfo;
+declare function handleDOMError(error: Error, context: string): ErrorInfo;
+declare function handleContextError(contextName: string): void;
+
+declare class DOMService {
+    /**
+     * Creates an HTML element with specified tag and class name
+     */
+    static createElement(tag: string, className: string): HTMLElement;
+    /**
+     * Appends an element to the document body
+     */
+    static appendToBody(element: HTMLElement): void;
+    /**
+     * Removes an element from the document body
+     */
+    static removeFromBody(element: HTMLElement): void;
+    /**
+     * Sets multiple CSS properties on an element
+     */
+    static setElementStyles(element: HTMLElement, styles: Record<string, string>): void;
+    /**
+     * Gets the bounding rectangle of an element
+     */
+    static getElementRect(element: HTMLElement): DOMRect;
+    /**
+     * Checks if an element is in the viewport
+     */
+    static isElementInViewport(element: HTMLElement): boolean;
+    /**
+     * Calculates distance between two points
+     */
+    static calculateDistance(x1: number, y1: number, x2: number, y2: number): number;
+    /**
+     * Finds the closest element to a point from a list of elements
+     */
+    static findClosestElement(pointX: number, pointY: number, elements: NodeListOf<Element>): HTMLElement | null;
+    /**
+     * Safely adds event listeners
+     */
+    static addEventListener(element: EventTarget, event: string, handler: EventListener, options?: AddEventListenerOptions): void;
+    /**
+     * Safely removes event listeners
+     */
+    static removeEventListener(element: EventTarget, event: string, handler: EventListener, options?: EventListenerOptions): void;
+}
+
+/**
+ * Debug utility for Prepr Next.js package
+ * Provides centralized debug logging with performance optimizations
+ */
+type DebugArg = string | number | boolean | null | undefined | object;
+interface DebugOptions {
+    enabled: boolean;
+    prefix?: string;
+}
+declare class DebugLogger {
+    private options;
+    constructor(options: DebugOptions);
+    /**
+     * Log a debug message if debug is enabled
+     */
+    log(message: string, ...args: DebugArg[]): void;
+    /**
+     * Log a debug warning if debug is enabled
+     */
+    warn(message: string, ...args: DebugArg[]): void;
+    /**
+     * Log a debug error if debug is enabled
+     */
+    error(message: string, ...args: DebugArg[]): void;
+    /**
+     * Create a scoped logger with additional context
+     */
+    scope(scopeName: string): DebugLogger;
+}
+/**
+ * Initialize the debug logger
+ */
+declare function initDebugLogger(enabled?: boolean): void;
+/**
+ * Get the debug logger instance
+ */
+declare function getDebugLogger(): DebugLogger;
+/**
+ * Convenience function for logging
+ */
+declare function debugLog(message: string, ...args: DebugArg[]): void;
+/**
+ * Convenience function for warning
+ */
+declare function debugWarn(message: string, ...args: DebugArg[]): void;
+/**
+ * Convenience function for errors
+ */
+declare function debugError(message: string, ...args: DebugArg[]): void;
+/**
+ * Create a scoped debug logger
+ */
+declare function createScopedLogger(scopeName: string): DebugLogger;
+
+declare function throttle<T extends (...args: any[]) => any>(func: T, delay: number): T;
+declare function createElementCache<T extends Element = Element>(query: string, ttl?: number): () => NodeListOf<T>;
+
+declare function cn(...inputs: ClassValue[]): string;
+interface PreprEventData {
+    segment?: string;
+    variant?: string;
+    editMode?: boolean;
+    [key: string]: string | boolean | number | undefined;
+}
+declare function sendPreprEvent(event: string, data?: PreprEventData): void;
+
+export { DOMService, type DebugArg, type ErrorAdditionalData, type ErrorInfo, type PreprEventData, StegaError, type StegaErrorType, cn, createElementCache, createErrorInfo, createScopedLogger, debugError, debugLog, debugWarn, getDebugLogger, handleContextError, handleDOMError, handleStegaError, initDebugLogger, sendPreprEvent, throttle };

package/dist/utils/index.d.ts

@@ -0,0 +1,138 @@
+import { ClassValue } from 'clsx';
+
+declare const StegaError: {
+    readonly DECODE_FAILED: "STEGA_DECODE_FAILED";
+    readonly INVALID_FORMAT: "STEGA_INVALID_FORMAT";
+    readonly DOM_MANIPULATION_FAILED: "DOM_MANIPULATION_FAILED";
+    readonly CONTEXT_NOT_FOUND: "CONTEXT_NOT_FOUND";
+};
+type StegaErrorType = (typeof StegaError)[keyof typeof StegaError];
+interface ErrorAdditionalData {
+    input?: string;
+    element?: HTMLElement;
+    context?: string;
+    [key: string]: string | HTMLElement | undefined;
+}
+interface ErrorInfo {
+    type: StegaErrorType;
+    context: string;
+    message: string;
+    timestamp: string;
+    stack?: string;
+    additionalData?: ErrorAdditionalData;
+}
+declare function createErrorInfo(type: StegaErrorType, context: string, error: Error, additionalData?: ErrorAdditionalData): ErrorInfo;
+declare function handleStegaError(error: Error, context: string, additionalData?: ErrorAdditionalData): ErrorInfo;
+declare function handleDOMError(error: Error, context: string): ErrorInfo;
+declare function handleContextError(contextName: string): void;
+
+declare class DOMService {
+    /**
+     * Creates an HTML element with specified tag and class name
+     */
+    static createElement(tag: string, className: string): HTMLElement;
+    /**
+     * Appends an element to the document body
+     */
+    static appendToBody(element: HTMLElement): void;
+    /**
+     * Removes an element from the document body
+     */
+    static removeFromBody(element: HTMLElement): void;
+    /**
+     * Sets multiple CSS properties on an element
+     */
+    static setElementStyles(element: HTMLElement, styles: Record<string, string>): void;
+    /**
+     * Gets the bounding rectangle of an element
+     */
+    static getElementRect(element: HTMLElement): DOMRect;
+    /**
+     * Checks if an element is in the viewport
+     */
+    static isElementInViewport(element: HTMLElement): boolean;
+    /**
+     * Calculates distance between two points
+     */
+    static calculateDistance(x1: number, y1: number, x2: number, y2: number): number;
+    /**
+     * Finds the closest element to a point from a list of elements
+     */
+    static findClosestElement(pointX: number, pointY: number, elements: NodeListOf<Element>): HTMLElement | null;
+    /**
+     * Safely adds event listeners
+     */
+    static addEventListener(element: EventTarget, event: string, handler: EventListener, options?: AddEventListenerOptions): void;
+    /**
+     * Safely removes event listeners
+     */
+    static removeEventListener(element: EventTarget, event: string, handler: EventListener, options?: EventListenerOptions): void;
+}
+
+/**
+ * Debug utility for Prepr Next.js package
+ * Provides centralized debug logging with performance optimizations
+ */
+type DebugArg = string | number | boolean | null | undefined | object;
+interface DebugOptions {
+    enabled: boolean;
+    prefix?: string;
+}
+declare class DebugLogger {
+    private options;
+    constructor(options: DebugOptions);
+    /**
+     * Log a debug message if debug is enabled
+     */
+    log(message: string, ...args: DebugArg[]): void;
+    /**
+     * Log a debug warning if debug is enabled
+     */
+    warn(message: string, ...args: DebugArg[]): void;
+    /**
+     * Log a debug error if debug is enabled
+     */
+    error(message: string, ...args: DebugArg[]): void;
+    /**
+     * Create a scoped logger with additional context
+     */
+    scope(scopeName: string): DebugLogger;
+}
+/**
+ * Initialize the debug logger
+ */
+declare function initDebugLogger(enabled?: boolean): void;
+/**
+ * Get the debug logger instance
+ */
+declare function getDebugLogger(): DebugLogger;
+/**
+ * Convenience function for logging
+ */
+declare function debugLog(message: string, ...args: DebugArg[]): void;
+/**
+ * Convenience function for warning
+ */
+declare function debugWarn(message: string, ...args: DebugArg[]): void;
+/**
+ * Convenience function for errors
+ */
+declare function debugError(message: string, ...args: DebugArg[]): void;
+/**
+ * Create a scoped debug logger
+ */
+declare function createScopedLogger(scopeName: string): DebugLogger;
+
+declare function throttle<T extends (...args: any[]) => any>(func: T, delay: number): T;
+declare function createElementCache<T extends Element = Element>(query: string, ttl?: number): () => NodeListOf<T>;
+
+declare function cn(...inputs: ClassValue[]): string;
+interface PreprEventData {
+    segment?: string;
+    variant?: string;
+    editMode?: boolean;
+    [key: string]: string | boolean | number | undefined;
+}
+declare function sendPreprEvent(event: string, data?: PreprEventData): void;
+
+export { DOMService, type DebugArg, type ErrorAdditionalData, type ErrorInfo, type PreprEventData, StegaError, type StegaErrorType, cn, createElementCache, createErrorInfo, createScopedLogger, debugError, debugLog, debugWarn, getDebugLogger, handleContextError, handleDOMError, handleStegaError, initDebugLogger, sendPreprEvent, throttle };

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+import {a,b as b$1}from'../chunk-E7ATRJ2F.js';import {clsx}from'clsx';import {twMerge}from'tailwind-merge';var u={DECODE_FAILED:"STEGA_DECODE_FAILED",INVALID_FORMAT:"STEGA_INVALID_FORMAT",DOM_MANIPULATION_FAILED:"DOM_MANIPULATION_FAILED",CONTEXT_NOT_FOUND:"CONTEXT_NOT_FOUND"};function p(n,e,t,r){return {type:n,context:e,message:t.message,timestamp:new Date().toISOString(),stack:t.stack,additionalData:r}}function b(n,e,t){let r=p(u.DECODE_FAILED,e,n,t);return console.error("Stega Error:",r),process.env.NODE_ENV,r}function s(n,e){let t=p(u.DOM_MANIPULATION_FAILED,e,n);return console.error("DOM Error:",t),t}function L(n){let e=new Error(`${n} must be used within its provider`),t=p(u.CONTEXT_NOT_FOUND,n,e);throw console.error("Context Error:",t),e}var D=class{static createElement(e,t){try{let r=document.createElement(e);return r.className=t,r}catch(r){throw s(r,"createElement"),r}}static appendToBody(e){try{document.body.appendChild(e);}catch(t){throw s(t,"appendToBody"),t}}static removeFromBody(e){try{e.parentNode&&e.parentNode.removeChild(e);}catch(t){throw s(t,"removeFromBody"),t}}static setElementStyles(e,t){try{Object.entries(t).forEach(([r,o])=>{e.style.setProperty(r,o);});}catch(r){throw s(r,"setElementStyles"),r}}static getElementRect(e){try{return e.getBoundingClientRect()}catch(t){throw s(t,"getElementRect"),t}}static isElementInViewport(e){try{let t=this.getElementRect(e);return t.top>=0&&t.left>=0&&t.bottom<=(window.innerHeight||document.documentElement.clientHeight)&&t.right<=(window.innerWidth||document.documentElement.clientWidth)}catch(t){return s(t,"isElementInViewport"),false}}static calculateDistance(e,t,r,o){return Math.sqrt(Math.pow(r-e,2)+Math.pow(o-t,2))}static findClosestElement(e,t,r){try{let o=null,i=1/0;return r.forEach(d=>{let c=this.getElementRect(d),m=this.calculateDistance(e,t,c.left+c.width/2,c.top+c.height/2);m<i&&(i=m,o=d);}),o}catch(o){return s(o,"findClosestElement"),null}}static addEventListener(e,t,r,o){try{e.addEventListener(t,r,o);}catch(i){throw s(i,"addEventListener"),i}}static removeEventListener(e,t,r,o){try{e.removeEventListener(t,r,o);}catch(i){throw s(i,"removeEventListener"),i}}};var g=class n{constructor(e){this.options=a({prefix:"[Prepr]"},e);}log(e,...t){if(!this.options.enabled)return;let r=this.options.prefix;console.log(`${r} ${e}`,...t);}warn(e,...t){if(!this.options.enabled)return;let r=this.options.prefix;console.warn(`${r} ${e}`,...t);}error(e,...t){if(!this.options.enabled)return;let r=this.options.prefix;console.error(`${r} ${e}`,...t);}scope(e){return new n(b$1(a({},this.options),{prefix:`${this.options.prefix}[${e}]`}))}},l=null;function O(n=false){l=new g({enabled:n});}function E(){return l||(l=new g({enabled:false})),l}function y(n,...e){E().log(n,...e);}function A(n,...e){E().warn(n,...e);}function M(n,...e){E().error(n,...e);}function I(n){return E().scope(n)}function C(n,e){let t=null,r=0;return (...o)=>{let i=Date.now();i-r>e?(n(...o),r=i):(t&&clearTimeout(t),t=setTimeout(()=>{n(...o),r=Date.now();},e-(i-r)));}}function S(n,e=1e3){let t=null,r=0;return ()=>{let o=Date.now();return (!t||o-r>e)&&(t=document.querySelectorAll(n),r=o),t}}function $(...n){return twMerge(clsx(n))}function k(n,e){window.parent.postMessage(a({name:"prepr_preview_bar",event:n},e));}export{D as DOMService,u as StegaError,$ as cn,S as createElementCache,p as createErrorInfo,I as createScopedLogger,M as debugError,y as debugLog,A as debugWarn,E as getDebugLogger,L as handleContextError,s as handleDOMError,b as handleStegaError,O as initDebugLogger,k as sendPreprEvent,C as throttle};//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/errors.ts","../../src/utils/dom.ts","../../src/utils/debug.ts","../../src/utils/performance.ts","../../src/utils/index.ts"],"names":["StegaError","createErrorInfo","type","context","error","additionalData","handleStegaError","errorInfo","handleDOMError","handleContextError","contextName","DOMService","tag","className","element","styles","property","value","rect","x1","y1","x2","y2","pointX","pointY","elements","closestElement","minDistance","distance","event","handler","options","DebugLogger","_DebugLogger","__spreadValues","message","args","prefix","scopeName","__spreadProps","globalDebugLogger","initDebugLogger","enabled","getDebugLogger","debugLog","debugWarn","debugError","createScopedLogger","throttle","func","delay","timeoutId","lastExecTime","currentTime","createElementCache","query","ttl","cache","lastCacheTime","now","cn","inputs","twMerge","clsx","sendPreprEvent","data"],"mappings":"2GAAO,IAAMA,CAAAA,CAAa,CACxB,aAAA,CAAe,qBAAA,CACf,eAAgB,sBAAA,CAChB,uBAAA,CAAyB,0BACzB,iBAAA,CAAmB,mBACrB,EAqBO,SAASC,CAAAA,CACdC,EACAC,CAAAA,CACAC,CAAAA,CACAC,EACW,CACX,OAAO,CACL,IAAA,CAAAH,CAAAA,CACA,QAAAC,CAAAA,CACA,OAAA,CAASC,EAAM,OAAA,CACf,SAAA,CAAW,IAAI,IAAA,EAAK,CAAE,aAAY,CAClC,KAAA,CAAOA,EAAM,KAAA,CACb,cAAA,CAAAC,CACF,CACF,CAEO,SAASC,CAAAA,CACdF,EACAD,CAAAA,CACAE,CAAAA,CACA,CACA,IAAME,CAAAA,CAAYN,EAChBD,CAAAA,CAAW,aAAA,CACXG,EACAC,CAAAA,CACAC,CACF,EAEA,OAAA,OAAA,CAAQ,KAAA,CAAM,eAAgBE,CAAS,CAAA,CAGnC,QAAQ,GAAA,CAAI,QAAA,CAITA,CACT,CAEO,SAASC,EAAeJ,CAAAA,CAAcD,CAAAA,CAAiB,CAC5D,IAAMI,CAAAA,CAAYN,EAChBD,CAAAA,CAAW,uBAAA,CACXG,EACAC,CACF,CAAA,CAEA,eAAQ,KAAA,CAAM,YAAA,CAAcG,CAAS,CAAA,CAC9BA,CACT,CAEO,SAASE,EAAmBC,CAAAA,CAAqB,CACtD,IAAMN,CAAAA,CAAQ,IAAI,MAAM,CAAA,EAAGM,CAAW,mCAAmC,CAAA,CACnEH,CAAAA,CAAYN,EAChBD,CAAAA,CAAW,iBAAA,CACXU,EACAN,CACF,CAAA,CAEA,cAAQ,KAAA,CAAM,gBAAA,CAAkBG,CAAS,CAAA,CACnCH,CACR,CCnFO,IAAMO,CAAAA,CAAN,KAAiB,CAItB,OAAO,cAAcC,CAAAA,CAAaC,CAAAA,CAAgC,CAChE,GAAI,CACF,IAAMC,CAAAA,CAAU,QAAA,CAAS,cAAcF,CAAG,CAAA,CAC1C,OAAAE,CAAAA,CAAQ,SAAA,CAAYD,CAAAA,CACbC,CACT,OAASV,CAAAA,CAAO,CACd,MAAAI,CAAAA,CAAeJ,CAAAA,CAAgB,eAAe,CAAA,CACxCA,CACR,CACF,CAKA,OAAO,aAAaU,CAAAA,CAA4B,CAC9C,GAAI,CACF,QAAA,CAAS,KAAK,WAAA,CAAYA,CAAO,EACnC,CAAA,MAASV,CAAAA,CAAO,CACd,MAAAI,CAAAA,CAAeJ,EAAgB,cAAc,CAAA,CACvCA,CACR,CACF,CAKA,OAAO,cAAA,CAAeU,CAAAA,CAA4B,CAChD,GAAI,CACEA,EAAQ,UAAA,EACVA,CAAAA,CAAQ,WAAW,WAAA,CAAYA,CAAO,EAE1C,CAAA,MAASV,EAAO,CACd,MAAAI,EAAeJ,CAAAA,CAAgB,gBAAgB,EACzCA,CACR,CACF,CAKA,OAAO,gBAAA,CACLU,EACAC,CAAAA,CACM,CACN,GAAI,CACF,MAAA,CAAO,QAAQA,CAAM,CAAA,CAAE,QAAQ,CAAC,CAACC,EAAUC,CAAK,CAAA,GAAM,CACpDH,CAAAA,CAAQ,KAAA,CAAM,YAAYE,CAAAA,CAAUC,CAAK,EAC3C,CAAC,EACH,OAASb,CAAAA,CAAO,CACd,MAAAI,CAAAA,CAAeJ,CAAAA,CAAgB,kBAAkB,CAAA,CAC3CA,CACR,CACF,CAKA,OAAO,cAAA,CAAeU,CAAAA,CAA+B,CACnD,GAAI,CACF,OAAOA,CAAAA,CAAQ,qBAAA,EACjB,CAAA,MAASV,CAAAA,CAAO,CACd,MAAAI,CAAAA,CAAeJ,EAAgB,gBAAgB,CAAA,CACzCA,CACR,CACF,CAKA,OAAO,mBAAA,CAAoBU,CAAAA,CAA+B,CACxD,GAAI,CACF,IAAMI,CAAAA,CAAO,IAAA,CAAK,eAAeJ,CAAO,CAAA,CACxC,OACEI,CAAAA,CAAK,GAAA,EAAO,GACZA,CAAAA,CAAK,IAAA,EAAQ,GACbA,CAAAA,CAAK,MAAA,GACF,OAAO,WAAA,EAAe,QAAA,CAAS,eAAA,CAAgB,YAAA,CAAA,EAClDA,EAAK,KAAA,GACF,MAAA,CAAO,YAAc,QAAA,CAAS,eAAA,CAAgB,YAErD,CAAA,MAASd,CAAAA,CAAO,CACd,OAAAI,CAAAA,CAAeJ,EAAgB,qBAAqB,CAAA,CAC7C,KACT,CACF,CAKA,OAAO,iBAAA,CACLe,CAAAA,CACAC,EACAC,CAAAA,CACAC,CAAAA,CACQ,CACR,OAAO,IAAA,CAAK,KAAK,IAAA,CAAK,GAAA,CAAID,EAAKF,CAAAA,CAAI,CAAC,EAAI,IAAA,CAAK,GAAA,CAAIG,EAAKF,CAAAA,CAAI,CAAC,CAAC,CAC9D,CAKA,OAAO,kBAAA,CACLG,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACoB,CACpB,GAAI,CACF,IAAIC,CAAAA,CAAqC,IAAA,CACrCC,EAAc,CAAA,CAAA,CAAA,CAElB,OAAAF,EAAS,OAAA,CAAQX,CAAAA,EAAW,CAC1B,IAAMI,CAAAA,CAAO,KAAK,cAAA,CAAeJ,CAAsB,EACjDc,CAAAA,CAAW,IAAA,CAAK,kBACpBL,CAAAA,CACAC,CAAAA,CACAN,EAAK,IAAA,CAAOA,CAAAA,CAAK,MAAQ,CAAA,CACzBA,CAAAA,CAAK,IAAMA,CAAAA,CAAK,MAAA,CAAS,CAC3B,CAAA,CAEIU,CAAAA,CAAWD,IACbA,CAAAA,CAAcC,CAAAA,CACdF,EAAiBZ,CAAAA,EAErB,CAAC,EAEMY,CACT,CAAA,MAAStB,CAAAA,CAAO,CACd,OAAAI,CAAAA,CAAeJ,CAAAA,CAAgB,oBAAoB,CAAA,CAC5C,IACT,CACF,CAKA,OAAO,iBACLU,CAAAA,CACAe,CAAAA,CACAC,EACAC,CAAAA,CACM,CACN,GAAI,CACFjB,CAAAA,CAAQ,iBAAiBe,CAAAA,CAAOC,CAAAA,CAASC,CAAO,EAClD,CAAA,MAAS3B,EAAO,CACd,MAAAI,EAAeJ,CAAAA,CAAgB,kBAAkB,EAC3CA,CACR,CACF,CAKA,OAAO,mBAAA,CACLU,EACAe,CAAAA,CACAC,CAAAA,CACAC,EACM,CACN,GAAI,CACFjB,CAAAA,CAAQ,mBAAA,CAAoBe,CAAAA,CAAOC,CAAAA,CAASC,CAAO,EACrD,CAAA,MAAS3B,EAAO,CACd,MAAAI,EAAeJ,CAAAA,CAAgB,qBAAqB,EAC9CA,CACR,CACF,CACF,EC9JA,IAAM4B,EAAN,MAAMC,CAAY,CAGhB,WAAA,CAAYF,CAAAA,CAAuB,CACjC,IAAA,CAAK,OAAA,CAAUG,EAAA,CACb,MAAA,CAAQ,WACLH,CAAAA,EAEP,CAKA,IAAII,CAAAA,CAAAA,GAAoBC,CAAAA,CAAwB,CAC9C,GAAI,CAAC,KAAK,OAAA,CAAQ,OAAA,CAAS,OAE3B,IAAMC,CAAAA,CAAS,KAAK,OAAA,CAAQ,MAAA,CAC5B,OAAA,CAAQ,GAAA,CAAI,GAAGA,CAAM,CAAA,CAAA,EAAIF,CAAO,CAAA,CAAA,CAAI,GAAGC,CAAI,EAC7C,CAKA,KAAKD,CAAAA,CAAAA,GAAoBC,CAAAA,CAAwB,CAC/C,GAAI,CAAC,KAAK,OAAA,CAAQ,OAAA,CAAS,OAE3B,IAAMC,CAAAA,CAAS,KAAK,OAAA,CAAQ,MAAA,CAC5B,QAAQ,IAAA,CAAK,CAAA,EAAGA,CAAM,CAAA,CAAA,EAAIF,CAAO,GAAI,GAAGC,CAAI,EAC9C,CAKA,KAAA,CAAMD,KAAoBC,CAAAA,CAAwB,CAChD,GAAI,CAAC,IAAA,CAAK,QAAQ,OAAA,CAAS,OAE3B,IAAMC,CAAAA,CAAS,KAAK,OAAA,CAAQ,MAAA,CAC5B,QAAQ,KAAA,CAAM,CAAA,EAAGA,CAAM,CAAA,CAAA,EAAIF,CAAO,GAAI,GAAGC,CAAI,EAC/C,CAKA,KAAA,CAAME,EAAgC,CACpC,OAAO,IAAIL,CAAAA,CAAYM,GAAAA,CAAAL,EAAA,EAAA,CAClB,IAAA,CAAK,SADa,CAErB,MAAA,CAAQ,GAAG,IAAA,CAAK,OAAA,CAAQ,MAAM,CAAA,CAAA,EAAII,CAAS,GAC7C,CAAA,CAAC,CACH,CACF,CAAA,CAGIE,CAAAA,CAAwC,KAKrC,SAASC,CAAAA,CAAgBC,EAAmB,KAAA,CAAa,CAC9DF,CAAAA,CAAoB,IAAIR,EAAY,CAAE,OAAA,CAAAU,CAAQ,CAAC,EACjD,CAKO,SAASC,CAAAA,EAA8B,CAC5C,OAAKH,CAAAA,GAEHA,EAAoB,IAAIR,CAAAA,CAAY,CAAE,OAAA,CAAS,KAAM,CAAC,CAAA,CAAA,CAEjDQ,CACT,CAKO,SAASI,CAAAA,CAAST,KAAoBC,CAAAA,CAAwB,CACnEO,GAAe,CAAE,GAAA,CAAIR,EAAS,GAAGC,CAAI,EACvC,CAKO,SAASS,EAAUV,CAAAA,CAAAA,GAAoBC,CAAAA,CAAwB,CACpEO,CAAAA,EAAe,CAAE,KAAKR,CAAAA,CAAS,GAAGC,CAAI,EACxC,CAKO,SAASU,CAAAA,CAAWX,KAAoBC,CAAAA,CAAwB,CACrEO,GAAe,CAAE,KAAA,CAAMR,EAAS,GAAGC,CAAI,EACzC,CAKO,SAASW,EAAmBT,CAAAA,CAAgC,CACjE,OAAOK,CAAAA,EAAe,CAAE,MAAML,CAAS,CACzC,CC5GO,SAASU,CAAAA,CACdC,EACAC,CAAAA,CACG,CACH,IAAIC,CAAAA,CAAmC,IAAA,CACnCC,EAAe,CAAA,CAEnB,OAAQ,IAAIhB,CAAAA,GAAoB,CAC9B,IAAMiB,CAAAA,CAAc,IAAA,CAAK,KAAI,CACzBA,CAAAA,CAAcD,CAAAA,CAAeF,CAAAA,EAC/BD,EAAK,GAAIb,CAAsB,EAC/BgB,CAAAA,CAAeC,CAAAA,GAEXF,GAAW,YAAA,CAAaA,CAAS,EACrCA,CAAAA,CAAY,UAAA,CACV,IAAM,CACJF,CAAAA,CAAK,GAAIb,CAAsB,CAAA,CAC/BgB,EAAe,IAAA,CAAK,GAAA,GACtB,CAAA,CACAF,CAAAA,EAASG,EAAcD,CAAAA,CACzB,CAAA,EAEJ,CACF,CAGO,SAASE,EACdC,CAAAA,CACAC,CAAAA,CAAc,IACd,CACA,IAAIC,EAA8B,IAAA,CAC9BC,CAAAA,CAAgB,EACpB,OAAO,IAAM,CACX,IAAMC,CAAAA,CAAM,IAAA,CAAK,GAAA,GACjB,OAAA,CAAI,CAACF,GAASE,CAAAA,CAAMD,CAAAA,CAAgBF,KAClCC,CAAAA,CAAQ,QAAA,CAAS,iBAAoBF,CAAK,CAAA,CAC1CG,EAAgBC,CAAAA,CAAAA,CAEXF,CACT,CACF,CCxCO,SAASG,KAAMC,CAAAA,CAAsB,CAC1C,OAAOC,OAAAA,CAAQC,IAAAA,CAAKF,CAAM,CAAC,CAC7B,CAUO,SAASG,CAAAA,CAAenC,EAAeoC,CAAAA,CAAuB,CACnE,OAAO,MAAA,CAAO,WAAA,CAAY/B,EAAA,CACxB,IAAA,CAAM,oBACN,KAAA,CAAAL,CAAAA,CAAAA,CACGoC,EACJ,EACH","file":"index.js","sourcesContent":["export const StegaError = {\n  DECODE_FAILED: 'STEGA_DECODE_FAILED',\n  INVALID_FORMAT: 'STEGA_INVALID_FORMAT',\n  DOM_MANIPULATION_FAILED: 'DOM_MANIPULATION_FAILED',\n  CONTEXT_NOT_FOUND: 'CONTEXT_NOT_FOUND',\n} as const;\n\nexport type StegaErrorType = (typeof StegaError)[keyof typeof StegaError];\n\n// Define specific types for error additional data\nexport interface ErrorAdditionalData {\n  input?: string;\n  element?: HTMLElement;\n  context?: string;\n  [key: string]: string | HTMLElement | undefined;\n}\n\nexport interface ErrorInfo {\n  type: StegaErrorType;\n  context: string;\n  message: string;\n  timestamp: string;\n  stack?: string;\n  additionalData?: ErrorAdditionalData;\n}\n\nexport function createErrorInfo(\n  type: StegaErrorType,\n  context: string,\n  error: Error,\n  additionalData?: ErrorAdditionalData\n): ErrorInfo {\n  return {\n    type,\n    context,\n    message: error.message,\n    timestamp: new Date().toISOString(),\n    stack: error.stack,\n    additionalData,\n  };\n}\n\nexport function handleStegaError(\n  error: Error,\n  context: string,\n  additionalData?: ErrorAdditionalData\n) {\n  const errorInfo = createErrorInfo(\n    StegaError.DECODE_FAILED,\n    context,\n    error,\n    additionalData\n  );\n\n  console.error('Stega Error:', errorInfo);\n\n  // In production, you might want to send this to an error tracking service\n  if (process.env.NODE_ENV === 'production') {\n    // sendToErrorTrackingService(errorInfo);\n  }\n\n  return errorInfo;\n}\n\nexport function handleDOMError(error: Error, context: string) {\n  const errorInfo = createErrorInfo(\n    StegaError.DOM_MANIPULATION_FAILED,\n    context,\n    error\n  );\n\n  console.error('DOM Error:', errorInfo);\n  return errorInfo;\n}\n\nexport function handleContextError(contextName: string) {\n  const error = new Error(`${contextName} must be used within its provider`);\n  const errorInfo = createErrorInfo(\n    StegaError.CONTEXT_NOT_FOUND,\n    contextName,\n    error\n  );\n\n  console.error('Context Error:', errorInfo);\n  throw error;\n}\n","import { handleDOMError } from './errors';\n\nexport class DOMService {\n  /**\n   * Creates an HTML element with specified tag and class name\n   */\n  static createElement(tag: string, className: string): HTMLElement {\n    try {\n      const element = document.createElement(tag);\n      element.className = className;\n      return element;\n    } catch (error) {\n      handleDOMError(error as Error, 'createElement');\n      throw error;\n    }\n  }\n\n  /**\n   * Appends an element to the document body\n   */\n  static appendToBody(element: HTMLElement): void {\n    try {\n      document.body.appendChild(element);\n    } catch (error) {\n      handleDOMError(error as Error, 'appendToBody');\n      throw error;\n    }\n  }\n\n  /**\n   * Removes an element from the document body\n   */\n  static removeFromBody(element: HTMLElement): void {\n    try {\n      if (element.parentNode) {\n        element.parentNode.removeChild(element);\n      }\n    } catch (error) {\n      handleDOMError(error as Error, 'removeFromBody');\n      throw error;\n    }\n  }\n\n  /**\n   * Sets multiple CSS properties on an element\n   */\n  static setElementStyles(\n    element: HTMLElement,\n    styles: Record<string, string>\n  ): void {\n    try {\n      Object.entries(styles).forEach(([property, value]) => {\n        element.style.setProperty(property, value);\n      });\n    } catch (error) {\n      handleDOMError(error as Error, 'setElementStyles');\n      throw error;\n    }\n  }\n\n  /**\n   * Gets the bounding rectangle of an element\n   */\n  static getElementRect(element: HTMLElement): DOMRect {\n    try {\n      return element.getBoundingClientRect();\n    } catch (error) {\n      handleDOMError(error as Error, 'getElementRect');\n      throw error;\n    }\n  }\n\n  /**\n   * Checks if an element is in the viewport\n   */\n  static isElementInViewport(element: HTMLElement): boolean {\n    try {\n      const rect = this.getElementRect(element);\n      return (\n        rect.top >= 0 &&\n        rect.left >= 0 &&\n        rect.bottom <=\n          (window.innerHeight || document.documentElement.clientHeight) &&\n        rect.right <=\n          (window.innerWidth || document.documentElement.clientWidth)\n      );\n    } catch (error) {\n      handleDOMError(error as Error, 'isElementInViewport');\n      return false;\n    }\n  }\n\n  /**\n   * Calculates distance between two points\n   */\n  static calculateDistance(\n    x1: number,\n    y1: number,\n    x2: number,\n    y2: number\n  ): number {\n    return Math.sqrt(Math.pow(x2 - x1, 2) + Math.pow(y2 - y1, 2));\n  }\n\n  /**\n   * Finds the closest element to a point from a list of elements\n   */\n  static findClosestElement(\n    pointX: number,\n    pointY: number,\n    elements: NodeListOf<Element>\n  ): HTMLElement | null {\n    try {\n      let closestElement: HTMLElement | null = null;\n      let minDistance = Infinity;\n\n      elements.forEach(element => {\n        const rect = this.getElementRect(element as HTMLElement);\n        const distance = this.calculateDistance(\n          pointX,\n          pointY,\n          rect.left + rect.width / 2,\n          rect.top + rect.height / 2\n        );\n\n        if (distance < minDistance) {\n          minDistance = distance;\n          closestElement = element as HTMLElement;\n        }\n      });\n\n      return closestElement;\n    } catch (error) {\n      handleDOMError(error as Error, 'findClosestElement');\n      return null;\n    }\n  }\n\n  /**\n   * Safely adds event listeners\n   */\n  static addEventListener(\n    element: EventTarget,\n    event: string,\n    handler: EventListener,\n    options?: AddEventListenerOptions\n  ): void {\n    try {\n      element.addEventListener(event, handler, options);\n    } catch (error) {\n      handleDOMError(error as Error, 'addEventListener');\n      throw error;\n    }\n  }\n\n  /**\n   * Safely removes event listeners\n   */\n  static removeEventListener(\n    element: EventTarget,\n    event: string,\n    handler: EventListener,\n    options?: EventListenerOptions\n  ): void {\n    try {\n      element.removeEventListener(event, handler, options);\n    } catch (error) {\n      handleDOMError(error as Error, 'removeEventListener');\n      throw error;\n    }\n  }\n}\n","/**\n * Debug utility for Prepr Next.js package\n * Provides centralized debug logging with performance optimizations\n */\n\n// Define specific types for debug arguments\nexport type DebugArg = string | number | boolean | null | undefined | object;\n\ninterface DebugOptions {\n  enabled: boolean;\n  prefix?: string;\n}\n\nclass DebugLogger {\n  private options: DebugOptions;\n\n  constructor(options: DebugOptions) {\n    this.options = {\n      prefix: '[Prepr]',\n      ...options,\n    };\n  }\n\n  /**\n   * Log a debug message if debug is enabled\n   */\n  log(message: string, ...args: DebugArg[]): void {\n    if (!this.options.enabled) return;\n\n    const prefix = this.options.prefix;\n    console.log(`${prefix} ${message}`, ...args);\n  }\n\n  /**\n   * Log a debug warning if debug is enabled\n   */\n  warn(message: string, ...args: DebugArg[]): void {\n    if (!this.options.enabled) return;\n\n    const prefix = this.options.prefix;\n    console.warn(`${prefix} ${message}`, ...args);\n  }\n\n  /**\n   * Log a debug error if debug is enabled\n   */\n  error(message: string, ...args: DebugArg[]): void {\n    if (!this.options.enabled) return;\n\n    const prefix = this.options.prefix;\n    console.error(`${prefix} ${message}`, ...args);\n  }\n\n  /**\n   * Create a scoped logger with additional context\n   */\n  scope(scopeName: string): DebugLogger {\n    return new DebugLogger({\n      ...this.options,\n      prefix: `${this.options.prefix}[${scopeName}]`,\n    });\n  }\n}\n\n// Global debug instance\nlet globalDebugLogger: DebugLogger | null = null;\n\n/**\n * Initialize the debug logger\n */\nexport function initDebugLogger(enabled: boolean = false): void {\n  globalDebugLogger = new DebugLogger({ enabled });\n}\n\n/**\n * Get the debug logger instance\n */\nexport function getDebugLogger(): DebugLogger {\n  if (!globalDebugLogger) {\n    // Fallback to disabled logger if not initialized\n    globalDebugLogger = new DebugLogger({ enabled: false });\n  }\n  return globalDebugLogger;\n}\n\n/**\n * Convenience function for logging\n */\nexport function debugLog(message: string, ...args: DebugArg[]): void {\n  getDebugLogger().log(message, ...args);\n}\n\n/**\n * Convenience function for warning\n */\nexport function debugWarn(message: string, ...args: DebugArg[]): void {\n  getDebugLogger().warn(message, ...args);\n}\n\n/**\n * Convenience function for errors\n */\nexport function debugError(message: string, ...args: DebugArg[]): void {\n  getDebugLogger().error(message, ...args);\n}\n\n/**\n * Create a scoped debug logger\n */\nexport function createScopedLogger(scopeName: string): DebugLogger {\n  return getDebugLogger().scope(scopeName);\n}\n","// Performance utilities\n\n// TODO: Refine the type for args and return value if possible\nexport function throttle<T extends (...args: any[]) => any>(\n  func: T,\n  delay: number\n): T {\n  let timeoutId: NodeJS.Timeout | null = null;\n  let lastExecTime = 0;\n\n  return ((...args: unknown[]) => {\n    const currentTime = Date.now();\n    if (currentTime - lastExecTime > delay) {\n      func(...(args as Parameters<T>));\n      lastExecTime = currentTime;\n    } else {\n      if (timeoutId) clearTimeout(timeoutId);\n      timeoutId = setTimeout(\n        () => {\n          func(...(args as Parameters<T>));\n          lastExecTime = Date.now();\n        },\n        delay - (currentTime - lastExecTime)\n      );\n    }\n  }) as T;\n}\n\n// Simple DOM element cache for querySelectorAll\nexport function createElementCache<T extends Element = Element>(\n  query: string,\n  ttl: number = 1000\n) {\n  let cache: NodeListOf<T> | null = null;\n  let lastCacheTime = 0;\n  return () => {\n    const now = Date.now();\n    if (!cache || now - lastCacheTime > ttl) {\n      cache = document.querySelectorAll<T>(query);\n      lastCacheTime = now;\n    }\n    return cache;\n  };\n}\n","import { ClassValue, clsx } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]) {\n  return twMerge(clsx(inputs));\n}\n\n// Define specific types for Prepr events\nexport interface PreprEventData {\n  segment?: string;\n  variant?: string;\n  editMode?: boolean;\n  [key: string]: string | boolean | number | undefined;\n}\n\nexport function sendPreprEvent(event: string, data?: PreprEventData) {\n  window.parent.postMessage({\n    name: 'prepr_preview_bar',\n    event,\n    ...data,\n  });\n}\n\n// Export error handling utilities\nexport * from './errors';\n\n// Export DOM service\nexport * from './dom';\n\n// Export debug utilities\nexport * from './debug';\n\n// Export performance utilities\nexport * from './performance';\n"]}

package/package.json

@@ -1,72 +1,117 @@
 {
   "name": "@preprio/prepr-nextjs",
-  "version": "1.3.2",
-  "description": "A next.js package containing helper functions and a preview bar to use in combination with Prepr",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.mjs",
-  "files": [
-    "dist",
-    "package.json"
-  ],
+  "version": "2.0.0-alpha.5",
+  "description": "Next.js package for Prepr CMS preview functionality with advanced debugging and visual editing capabilities",
+  "main": "dist/react/index.cjs",
+  "types": "./dist/react/index.d.ts",
+  "module": "./dist/react/index.js",
+  "type": "module",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "dev:css": "postcss ./src/globals.css -o ./src/output.css --watch",
+    "build:css": "NODE_ENV=production postcss ./src/globals.css -o ./dist/index.css",
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "clean": "rm -rf dist",
+    "format": "prettier --write \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,js,jsx,json,md}\"",
+    "release": "node scripts/release.js",
+    "check": "npm run type-check && npm run lint:check && npm run format:check",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx --fix",
+    "lint:check": "eslint src --ext .ts,.tsx",
+    "prepublishOnly": "npm run check && npm run build"
+  },
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
+    "./middleware": {
+      "import": "./dist/middleware/index.js",
+      "types": "./dist/middleware/index.d.ts",
+      "require": "./dist/middleware/index.cjs"
     },
-    "./components": {
-      "types": "./dist/components.d.ts",
-      "import": "./dist/components.js",
-      "require": "./dist/components.js"
+    "./server": {
+      "import": "./dist/server/index.js",
+      "types": "./dist/server/index.d.ts",
+      "require": "./dist/server/index.cjs"
     },
-    "./dist/components.css": {
-      "import": "./dist/components.css",
-      "require": "./dist/components.css"
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts",
+      "require": "./dist/react/index.cjs"
     },
-    "./dist/main.css": {
-      "import": "./dist/main.css",
-      "require": "./dist/main.css"
+    "./contexts": {
+      "import": "./dist/contexts/index.js",
+      "types": "./dist/contexts/index.d.ts",
+      "require": "./dist/contexts/index.cjs"
+    },
+    "./utils": {
+      "import": "./dist/utils/index.js",
+      "types": "./dist/utils/index.d.ts",
+      "require": "./dist/utils/index.cjs"
+    },
+    "./types": {
+      "import": "./dist/types/index.js",
+      "types": "./dist/types/index.d.ts",
+      "require": "./dist/types/index.cjs"
+    },
+    "./index.css": {
+      "import": "./dist/index.css",
+      "require": "./dist/index.css"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
-  "author": "Prepr",
-  "license": "ISC",
-  "devDependencies": {
-    "@types/react": "^18.3.3",
-    "autoprefixer": "^10.4.20",
-    "postcss": "^8.4.47",
-    "prettier": "3.3.3",
-    "tailwindcss": "^3.4.13",
-    "ts-node": "^10.9.2",
-    "tsup": "^8.2.4",
-    "typescript": "^5.5.4"
-  },
-  "dependencies": {
-    "@headlessui/react": "^2.1.8",
-    "@vercel/functions": "^1.6.0",
-    "classnames": "^2.5.1",
-    "clsx": "^2.1.1",
-    "micromatch": "^4.0.8",
-    "next": "^15.2.2",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "react-icons": "^5.3.0",
-    "rollup": "^4.22.4"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/preprio/prepr-nextjs.git"
-  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
   "keywords": [
     "prepr",
-    "nextjs"
+    "cms",
+    "nextjs",
+    "preview",
+    "visual-editing",
+    "headless-cms",
+    "react",
+    "typescript",
+    "debug",
+    "stega"
   ],
-  "bugs": {
-    "url": "https://github.com/preprio/prepr-nextjs/issues"
+  "author": "Preprio",
+  "license": "MIT",
+  "packageManager": "pnpm@10.5.2",
+  "devDependencies": {
+    "@eslint/js": "^9.25.1",
+    "@types/node": "^20.11.5",
+    "@types/react": "19.1.0",
+    "@types/react-dom": "19.1.2",
+    "@typescript-eslint/eslint-plugin": "^8.31.1",
+    "@typescript-eslint/parser": "^8.31.1",
+    "autoprefixer": "^10.4.21",
+    "cssnano": "^7.0.7",
+    "eslint": "^9.25.1",
+    "eslint-config-prettier": "^10.1.2",
+    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-react": "^7.37.2",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "next": "15.3.1",
+    "postcss": "^8",
+    "prettier": "^3.5.3",
+    "prettier-plugin-tailwindcss": "^0.5.12",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tailwindcss": "^3.4.17",
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
   },
-  "homepage": "https://github.com/preprio/prepr-nextjs#readme"
+  "peerDependencies": {
+    "next": "^15.0.0 || ^14.0.0 || ^13.0.0",
+    "react": "^19.0.0 || ^18.0.0 || ^17.0.0 ",
+    "react-dom": "^19.0.0 || ^18.0.0 || ^17.0.0"
+  },
+  "dependencies": {
+    "@headlessui/react": "^2.2.0",
+    "@vercel/functions": "^2.0.0",
+    "@vercel/stega": "^0.1.2",
+    "clsx": "^2.1.1",
+    "postcss-cli": "^11.0.1",
+    "tailwind-merge": "^3.0.1"
+  }
 }

package/dist/chunk-IQXHJV5O.mjs

@@ -1,25 +0,0 @@
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
-
-export {
-  __async
-};
-//# sourceMappingURL=chunk-IQXHJV5O.mjs.map

package/dist/chunk-IQXHJV5O.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}