ngx-xtroedge-cms 1.3.17 → 1.4.1

package/LICENSE

@@ -0,0 +1,46 @@
+XtroEdge CMS - Proprietary Software License
+
+Copyright (c) 2024-2026 XtroEdge. All rights reserved.
+
+IMPORTANT: READ THIS LICENSE AGREEMENT CAREFULLY BEFORE USING THIS SOFTWARE.
+
+1. GRANT OF LICENSE
+   This software is licensed, not sold. XtroEdge grants you a non-exclusive,
+   non-transferable, revocable license to use this software subject to a valid
+   subscription or active free trial period.
+
+2. FREE TRIAL
+   New users are granted a 30-day free trial starting from the date of
+   registration. During the trial period, all features are available. After
+   the trial period expires, a paid subscription ($10/month) is required.
+
+3. RESTRICTIONS
+   You may NOT:
+   - Copy, modify, merge, or create derivative works of this software
+   - Distribute, sublicense, sell, or transfer this software to any third party
+   - Reverse engineer, decompile, or disassemble this software
+   - Remove or alter any proprietary notices, labels, or marks
+   - Use this software after your license or trial has expired
+   - Share your license key with unauthorized parties
+
+4. SUBSCRIPTION
+   After the free trial, continued use requires an active subscription at the
+   current rate ($10/month). Failure to maintain an active subscription will
+   result in suspension of the software functionality.
+
+5. TERMINATION
+   This license is effective until terminated. XtroEdge may terminate this
+   license at any time if you fail to comply with any term of this agreement.
+   Upon termination, you must destroy all copies of the software.
+
+6. DISCLAIMER OF WARRANTIES
+   THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS
+   OR IMPLIED. XTROEDGE DOES NOT WARRANT THAT THE SOFTWARE WILL BE
+   UNINTERRUPTED OR ERROR-FREE.
+
+7. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL XTROEDGE BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+   OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF THIS SOFTWARE.
+
+For licensing inquiries: support@xtroedge.com
+Website: https://xtroedge.com

package/README.md

@@ -0,0 +1 @@
+# xtro-edge-page-editor

package/dist/index.d.mts

@@ -1,8 +1,12 @@
 /** Configuration for the CMS */
 interface XtroedgeCmsConfig {
-    /** API base URL for save/publish/load endpoints (optional - only needed when backend is ready) */
+    /** Our XtroEdge server URL — login, license, save, publish (required) */
     apiBase?: string;
-    /** Base URL prepended to uploaded image paths (defaults to apiBase origin) */
+    /** Client's API server URL — GET pages, image upload (falls back to apiBase if not set) */
+    clientApi?: string;
+    /** Headers to send with client API GET requests (e.g. {"x-data-source": "dev"}) */
+    clientHeaders?: Record<string, string>;
+    /** Base URL prepended to uploaded image paths (defaults to clientApi or apiBase origin) */
     imageBaseUrl?: string;
     /** CSS selector for the content container to scan (default: 'body') */
     containerSelector?: string;
@@ -20,6 +24,12 @@ interface XtroedgeCmsConfig {
     highlightColor?: string;
     /** Login API URL — if builder_token not found in localStorage, show login modal (default: apiBase + '/auth/login') */
     loginUrl?: string;
+    /** License key for subscription validation */
+    licenseKey?: string;
+    /** License validation API URL (default: apiBase + '/license/validate') */
+    licenseValidateUrl?: string;
+    /** Enable rich text toolbar for inline editing (default: true) */
+    richText?: boolean;
     onSaved?: () => void;
     onPublished?: () => void;
     onError?: (action: string, error: any) => void;
@@ -60,8 +70,25 @@ interface EditHistoryEntry {
     lang: string;
     snapshot: string;
 }
+/** License validation response */
+interface LicenseStatus {
+    valid: boolean;
+    plan: 'trial' | 'paid' | 'expired' | 'invalid';
+    daysLeft?: number;
+    message?: string;
+}
 
 declare class XtroedgeCMS {
+    private static readonly _SK;
+    private static readonly _VAULT_KEY;
+    private static _enc;
+    private static _dec;
+    private static _readVault;
+    private static _writeVault;
+    private static secureSet;
+    private static secureGet;
+    private static secureRemove;
+    private static secureClear;
     private config;
     private containerSelector;
     private editableTags;
@@ -98,6 +125,7 @@ declare class XtroedgeCMS {
     private dirtyKeys;
     private dirtyImageKeys;
     private registeredKeys;
+    private domOriginals;
     private managedElements;
     private managedImages;
     private autoDetectedElements;
@@ -105,6 +133,11 @@ declare class XtroedgeCMS {
     private scanTimeout;
     private activeImageEl;
     private imageCtxMenu;
+    private floatingEditDialog;
+    private richToolbarEl;
+    private activeEditableEl;
+    private toolbarHideTimeout;
+    private selectionChangeHandler;
     private currentSlug;
     private currentTitle;
     private initialized;
@@ -132,6 +165,9 @@ declare class XtroedgeCMS {
     private editModeContent;
     private fileInput;
     private imgOverlay;
+    private editScrollHandler;
+    private editScrollRAF;
+    private editClickCaptureHandler;
     private posX;
     private posY;
     private isDragging;
@@ -141,6 +177,10 @@ declare class XtroedgeCMS {
     private startPosY;
     private hasMoved;
     private toastTimer;
+    private licenseValid;
+    private licenseStatus;
+    private licenseOverlayEl;
+    private trialBannerDismissed;
     private db;
     private boundMouseMove;
     private boundMouseUp;
@@ -150,8 +190,17 @@ declare class XtroedgeCMS {
     private boundHashChange;
     private translationCache;
     constructor(config?: XtroedgeCmsConfig);
-    init(): void;
+    init(): Promise<void>;
     destroy(): void;
+    private static readonly LICENSE_CACHE_KEY;
+    private static readonly LICENSE_CACHE_TTL;
+    private validateLicense;
+    private getLicenseCache;
+    private setLicenseCache;
+    /** Shows toast when user tries to edit with expired/invalid license */
+    private showLicenseExpiredToast;
+    /** Returns trial/expired banner HTML if applicable, or empty string */
+    private getTrialBannerHTML;
     private injectStyles;
     private interceptNavigation;
     private handleNavigation;
@@ -166,12 +215,38 @@ declare class XtroedgeCMS {
     private scanImages;
     private getDirectTextContent;
     private hasEditableChildren;
+    private getElementContent;
+    private setElementContent;
     private setDirectTextContent;
     private attachElement;
     private detachElement;
+    /** Stop propagation so parent carousels (Swiper, Owl, etc.) don't hijack the event */
+    private static stopProp;
+    private focusEditableEnd;
     private enableElementEdit;
     private disableElementEdit;
     private applyEditMode;
+    /** Set of positioned ancestors we added pointer-events:none to (for cleanup) */
+    private modifiedAncestors;
+    /**
+     * For each managed element, find the nearest position:absolute/fixed ancestor.
+     * If that ancestor is invisible (opacity ≈ 0), set pointer-events:none on it
+     * so clicks pass through to the visible element behind it.
+     */
+    private syncEditablePointerEvents;
+    /** Walk up from el to find the nearest position:absolute or position:fixed ancestor */
+    private findPositionedAncestor;
+    private killAnimations;
+    /** Remove GSAP ScrollTrigger pin-spacer wrapper divs and restore original elements */
+    private removePinSpacers;
+    /** Clear only animation-related inline styles (set by GSAP/ScrollTrigger) without breaking layout */
+    private clearAnimationInlineStyles;
+    /** Capture each element's current DOM text before CMS applies saved edits */
+    private captureDomOriginals;
+    /** Ensure every entry in pageTexts has _orig for current language (from domOriginals) */
+    private ensureOriginals;
+    /** Find a managed element whose current text matches the given original text */
+    private findElementByOriginal;
     private updateElementTexts;
     private cleanupManagedElements;
     private attachImage;
@@ -182,6 +257,8 @@ declare class XtroedgeCMS {
     private disableImageEdit;
     private showImageContextMenu;
     private dismissImageCtxMenu;
+    private showFloatingEditDialog;
+    private dismissFloatingEditDialog;
     private onImageFileSelected;
     private uploadImageToApi;
     private applyPageImages;
@@ -190,6 +267,18 @@ declare class XtroedgeCMS {
     private onImageChanged;
     private createSnapshot;
     private applySnapshot;
+    private get richTextEnabled();
+    private static readonly SINGLE_LINE_TAGS;
+    private static readonly ALLOWED_TAGS;
+    private static readonly ALLOWED_ATTRS;
+    private sanitizeHTML;
+    private createRichToolbar;
+    private destroyRichToolbar;
+    private execToolbarCommand;
+    private showRichToolbar;
+    private positionToolbar;
+    private hideRichToolbar;
+    private updateToolbarState;
     private onUndo;
     private onRedo;
     private recalcDirtyKeys;
@@ -200,6 +289,10 @@ declare class XtroedgeCMS {
     private loadTranslationsAndInit;
     private flattenTranslations;
     private getPageSection;
+    /** Resolve a stored URL against our server (apiBase) */
+    private resolveServerUrl;
+    /** Resolve a stored URL against client's server (clientApi, falls back to apiBase) */
+    private resolveClientUrl;
     private apiFetch;
     private fetchSection;
     private hasSection;
@@ -239,9 +332,9 @@ declare class XtroedgeCMS {
     private getDarkerColor;
     private applyThemeColor;
     /** Quick init - create and start CMS in one call */
-    static create(config?: XtroedgeCmsConfig): XtroedgeCMS;
+    static create(config?: XtroedgeCmsConfig): Promise<XtroedgeCMS>;
     /** Auto-init: called automatically when package is loaded. No user code needed. */
-    static autoInit(): void;
+    static autoInit(): Promise<void>;
 }
 
-export { type EditHistoryEntry, type PageTextEntry, type WebPageContent, XtroedgeCMS, type XtroedgeCmsConfig };
+export { type EditHistoryEntry, type LicenseStatus, type PageTextEntry, type WebPageContent, XtroedgeCMS, type XtroedgeCmsConfig };

package/dist/index.d.ts

@@ -1,8 +1,12 @@
 /** Configuration for the CMS */
 interface XtroedgeCmsConfig {
-    /** API base URL for save/publish/load endpoints (optional - only needed when backend is ready) */
+    /** Our XtroEdge server URL — login, license, save, publish (required) */
     apiBase?: string;
-    /** Base URL prepended to uploaded image paths (defaults to apiBase origin) */
+    /** Client's API server URL — GET pages, image upload (falls back to apiBase if not set) */
+    clientApi?: string;
+    /** Headers to send with client API GET requests (e.g. {"x-data-source": "dev"}) */
+    clientHeaders?: Record<string, string>;
+    /** Base URL prepended to uploaded image paths (defaults to clientApi or apiBase origin) */
     imageBaseUrl?: string;
     /** CSS selector for the content container to scan (default: 'body') */
     containerSelector?: string;
@@ -20,6 +24,12 @@ interface XtroedgeCmsConfig {
     highlightColor?: string;
     /** Login API URL — if builder_token not found in localStorage, show login modal (default: apiBase + '/auth/login') */
     loginUrl?: string;
+    /** License key for subscription validation */
+    licenseKey?: string;
+    /** License validation API URL (default: apiBase + '/license/validate') */
+    licenseValidateUrl?: string;
+    /** Enable rich text toolbar for inline editing (default: true) */
+    richText?: boolean;
     onSaved?: () => void;
     onPublished?: () => void;
     onError?: (action: string, error: any) => void;
@@ -60,8 +70,25 @@ interface EditHistoryEntry {
     lang: string;
     snapshot: string;
 }
+/** License validation response */
+interface LicenseStatus {
+    valid: boolean;
+    plan: 'trial' | 'paid' | 'expired' | 'invalid';
+    daysLeft?: number;
+    message?: string;
+}
 
 declare class XtroedgeCMS {
+    private static readonly _SK;
+    private static readonly _VAULT_KEY;
+    private static _enc;
+    private static _dec;
+    private static _readVault;
+    private static _writeVault;
+    private static secureSet;
+    private static secureGet;
+    private static secureRemove;
+    private static secureClear;
     private config;
     private containerSelector;
     private editableTags;
@@ -98,6 +125,7 @@ declare class XtroedgeCMS {
     private dirtyKeys;
     private dirtyImageKeys;
     private registeredKeys;
+    private domOriginals;
     private managedElements;
     private managedImages;
     private autoDetectedElements;
@@ -105,6 +133,11 @@ declare class XtroedgeCMS {
     private scanTimeout;
     private activeImageEl;
     private imageCtxMenu;
+    private floatingEditDialog;
+    private richToolbarEl;
+    private activeEditableEl;
+    private toolbarHideTimeout;
+    private selectionChangeHandler;
     private currentSlug;
     private currentTitle;
     private initialized;
@@ -132,6 +165,9 @@ declare class XtroedgeCMS {
     private editModeContent;
     private fileInput;
     private imgOverlay;
+    private editScrollHandler;
+    private editScrollRAF;
+    private editClickCaptureHandler;
     private posX;
     private posY;
     private isDragging;
@@ -141,6 +177,10 @@ declare class XtroedgeCMS {
     private startPosY;
     private hasMoved;
     private toastTimer;
+    private licenseValid;
+    private licenseStatus;
+    private licenseOverlayEl;
+    private trialBannerDismissed;
     private db;
     private boundMouseMove;
     private boundMouseUp;
@@ -150,8 +190,17 @@ declare class XtroedgeCMS {
     private boundHashChange;
     private translationCache;
     constructor(config?: XtroedgeCmsConfig);
-    init(): void;
+    init(): Promise<void>;
     destroy(): void;
+    private static readonly LICENSE_CACHE_KEY;
+    private static readonly LICENSE_CACHE_TTL;
+    private validateLicense;
+    private getLicenseCache;
+    private setLicenseCache;
+    /** Shows toast when user tries to edit with expired/invalid license */
+    private showLicenseExpiredToast;
+    /** Returns trial/expired banner HTML if applicable, or empty string */
+    private getTrialBannerHTML;
     private injectStyles;
     private interceptNavigation;
     private handleNavigation;
@@ -166,12 +215,38 @@ declare class XtroedgeCMS {
     private scanImages;
     private getDirectTextContent;
     private hasEditableChildren;
+    private getElementContent;
+    private setElementContent;
     private setDirectTextContent;
     private attachElement;
     private detachElement;
+    /** Stop propagation so parent carousels (Swiper, Owl, etc.) don't hijack the event */
+    private static stopProp;
+    private focusEditableEnd;
     private enableElementEdit;
     private disableElementEdit;
     private applyEditMode;
+    /** Set of positioned ancestors we added pointer-events:none to (for cleanup) */
+    private modifiedAncestors;
+    /**
+     * For each managed element, find the nearest position:absolute/fixed ancestor.
+     * If that ancestor is invisible (opacity ≈ 0), set pointer-events:none on it
+     * so clicks pass through to the visible element behind it.
+     */
+    private syncEditablePointerEvents;
+    /** Walk up from el to find the nearest position:absolute or position:fixed ancestor */
+    private findPositionedAncestor;
+    private killAnimations;
+    /** Remove GSAP ScrollTrigger pin-spacer wrapper divs and restore original elements */
+    private removePinSpacers;
+    /** Clear only animation-related inline styles (set by GSAP/ScrollTrigger) without breaking layout */
+    private clearAnimationInlineStyles;
+    /** Capture each element's current DOM text before CMS applies saved edits */
+    private captureDomOriginals;
+    /** Ensure every entry in pageTexts has _orig for current language (from domOriginals) */
+    private ensureOriginals;
+    /** Find a managed element whose current text matches the given original text */
+    private findElementByOriginal;
     private updateElementTexts;
     private cleanupManagedElements;
     private attachImage;
@@ -182,6 +257,8 @@ declare class XtroedgeCMS {
     private disableImageEdit;
     private showImageContextMenu;
     private dismissImageCtxMenu;
+    private showFloatingEditDialog;
+    private dismissFloatingEditDialog;
     private onImageFileSelected;
     private uploadImageToApi;
     private applyPageImages;
@@ -190,6 +267,18 @@ declare class XtroedgeCMS {
     private onImageChanged;
     private createSnapshot;
     private applySnapshot;
+    private get richTextEnabled();
+    private static readonly SINGLE_LINE_TAGS;
+    private static readonly ALLOWED_TAGS;
+    private static readonly ALLOWED_ATTRS;
+    private sanitizeHTML;
+    private createRichToolbar;
+    private destroyRichToolbar;
+    private execToolbarCommand;
+    private showRichToolbar;
+    private positionToolbar;
+    private hideRichToolbar;
+    private updateToolbarState;
     private onUndo;
     private onRedo;
     private recalcDirtyKeys;
@@ -200,6 +289,10 @@ declare class XtroedgeCMS {
     private loadTranslationsAndInit;
     private flattenTranslations;
     private getPageSection;
+    /** Resolve a stored URL against our server (apiBase) */
+    private resolveServerUrl;
+    /** Resolve a stored URL against client's server (clientApi, falls back to apiBase) */
+    private resolveClientUrl;
     private apiFetch;
     private fetchSection;
     private hasSection;
@@ -239,9 +332,9 @@ declare class XtroedgeCMS {
     private getDarkerColor;
     private applyThemeColor;
     /** Quick init - create and start CMS in one call */
-    static create(config?: XtroedgeCmsConfig): XtroedgeCMS;
+    static create(config?: XtroedgeCmsConfig): Promise<XtroedgeCMS>;
     /** Auto-init: called automatically when package is loaded. No user code needed. */
-    static autoInit(): void;
+    static autoInit(): Promise<void>;
 }
 
-export { type EditHistoryEntry, type PageTextEntry, type WebPageContent, XtroedgeCMS, type XtroedgeCmsConfig };
+export { type EditHistoryEntry, type LicenseStatus, type PageTextEntry, type WebPageContent, XtroedgeCMS, type XtroedgeCmsConfig };