@svgrid/enterprise 2.5.3 → 2.6.1

package/dist/upgrade-prompt.js

@@ -0,0 +1,141 @@
+// Product-led-growth (PLG) upgrade nudge, shown at the *moment of intent*: the
+// instant a developer actually calls a Pro feature (export / import / print /
+// AI) without a license key set. Unlike the passive corner watermark
+// (watermark.ts), this is a one-click contextual card that names the feature
+// they just used and links straight to a free trial.
+//
+// Rules of the road:
+//   - Soft, never blocking. The feature already ran; this only nudges.
+//   - Shows once per session (SPA lifetime). Once shown - whether the user
+//     acts on it or closes it - it stays quiet for the rest of the session.
+//     Calling setLicenseKey() silences it before it ever appears.
+//   - Storage-free: no cookies, no localStorage, no sessionStorage. State is
+//     a single in-memory flag, so the library keeps its "zero web storage"
+//     promise (see docs/help/security.md). A hard reload may show it once
+//     more - by design; that's still a moment-of-intent nudge.
+//   - SSR-safe: every DOM access is guarded. On the server it's a no-op.
+//   - Zero dependencies, inline styles - no CSS file to import, nothing to
+//     bundle, works in any host app regardless of its styling.
+const CARD_ATTR = 'data-svgrid-enterprise-upgrade';
+const PRICING_URL = 'https://svgrid.com/pricing';
+// ?ref=in-app lets us measure how many trials start from this exact prompt
+// vs. the pricing page itself - the whole point of a moment-of-intent CTA.
+const TRIAL_URL = 'https://svgrid.com/pricing?ref=in-app&utm_source=svgrid-enterprise&utm_medium=upgrade-prompt';
+let shownThisSession = false;
+/**
+ * Show the contextual upgrade prompt for `feature`. No-ops if one has already
+ * been shown this session, a card is already up, or we're on the server. Safe
+ * to call on every Pro feature invocation - it self-throttles.
+ */
+export function showUpgradePrompt(feature, opts) {
+    if (shownThisSession)
+        return;
+    if (typeof document === 'undefined' || typeof window === 'undefined')
+        return;
+    if (document.querySelector(`[${CARD_ATTR}]`))
+        return;
+    shownThisSession = true;
+    const card = buildCard(feature, opts?.expired === true);
+    document.body.appendChild(card);
+    // Animate in on the next frame so the transition actually runs.
+    requestAnimationFrame(() => {
+        card.style.opacity = '1';
+        card.style.transform = 'translateY(0)';
+    });
+}
+/**
+ * Remove the card if present and re-arm the once-per-session flag so a later
+ * `showUpgradePrompt()` can show again. Mainly for hosts that want to control
+ * the nudge themselves (and for tests).
+ */
+export function dismissUpgradePrompt() {
+    shownThisSession = false;
+    if (typeof document === 'undefined')
+        return;
+    document.querySelectorAll(`[${CARD_ATTR}]`).forEach((el) => el.remove());
+}
+// User closed or clicked through the card. Remove it, but leave
+// `shownThisSession` set so it does not reappear for the rest of the session.
+function close(card) {
+    card.style.opacity = '0';
+    card.style.transform = 'translateY(8px)';
+    window.setTimeout(() => card.remove(), 220);
+}
+function buildCard(feature, expired = false) {
+    const card = document.createElement('div');
+    card.setAttribute(CARD_ATTR, '1');
+    card.setAttribute('role', 'dialog');
+    card.setAttribute('aria-label', expired ? 'Your trial has ended' : 'Unlock SvGrid Pro');
+    Object.assign(card.style, {
+        position: 'fixed',
+        bottom: '16px',
+        right: '16px',
+        zIndex: '2147483646', // one below the watermark so they never collide
+        width: '320px',
+        maxWidth: 'calc(100vw - 32px)',
+        boxSizing: 'border-box',
+        padding: '16px 16px 14px',
+        background: '#0f172a',
+        color: '#e2e8f0',
+        borderRadius: '12px',
+        border: '1px solid rgba(99,102,241,0.4)',
+        boxShadow: '0 12px 40px rgba(0,0,0,0.45)',
+        fontFamily: '-apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif',
+        fontSize: '13px',
+        lineHeight: '1.45',
+        opacity: '0',
+        transform: 'translateY(8px)',
+        transition: 'opacity 220ms ease, transform 220ms ease',
+    });
+    const featureName = feature ? String(feature) : 'This';
+    const featurePhrase = feature
+        ? `<strong style="color:#fff">${escapeHtml(featureName)}</strong> is a Pro feature.`
+        : `You just used a <strong style="color:#fff">Pro</strong> feature.`;
+    // An expired trial is a different message from "you never had a licence":
+    // they already evaluated, so the ask is to convert, not to start over.
+    const badge = expired ? 'TRIAL ENDED' : 'PRO';
+    const heading = expired ? 'Your trial has ended' : 'Unlock SvGrid Pro';
+    const body = expired
+        ? `${featurePhrase} Your evaluation period is over - everything still works,
+       but this notice stays until a licence key is set.`
+        : `${featurePhrase} It runs in evaluation with a watermark - start a free trial
+       to remove it and ship to production.`;
+    const cta = expired ? 'Buy a licence' : 'Start free trial';
+    card.innerHTML = `
+    <button type="button" data-act="x" aria-label="Dismiss"
+      style="position:absolute;top:8px;right:8px;width:24px;height:24px;display:flex;
+      align-items:center;justify-content:center;background:transparent;border:0;
+      color:#94a3b8;font-size:18px;line-height:1;cursor:pointer;border-radius:6px;">&times;</button>
+    <div style="display:flex;align-items:center;gap:8px;margin-bottom:8px;">
+      <span style="display:inline-block;background:${expired ? '#b45309' : '#4f46e5'};color:#fff;font-size:10px;
+        font-weight:700;letter-spacing:0.06em;padding:2px 7px;border-radius:999px;">${badge}</span>
+      <span style="font-weight:700;color:#fff;">${heading}</span>
+    </div>
+    <p style="margin:0 0 12px;color:#cbd5e1;">
+      ${body}
+    </p>
+    <div style="display:flex;gap:8px;align-items:center;">
+      <a data-act="trial" href="${TRIAL_URL}" target="_blank" rel="noopener noreferrer"
+        style="flex:1;text-align:center;background:#6366f1;color:#fff;font-weight:600;
+        text-decoration:none;padding:8px 12px;border-radius:8px;">${cta}</a>
+      <a data-act="pricing" href="${PRICING_URL}" target="_blank" rel="noopener noreferrer"
+        style="color:#a5b4fc;text-decoration:none;padding:8px 6px;font-weight:600;">Pricing</a>
+    </div>
+    <p style="margin:10px 0 0;font-size:11px;color:#64748b;">
+      Already licensed? Call <code style="color:#94a3b8;">setLicenseKey()</code> at startup to hide this.
+    </p>
+  `;
+    card.querySelector('[data-act="x"]')?.addEventListener('click', () => close(card));
+    // Clicking through to a trial / pricing also counts as "handled" - close the
+    // card, but let the link open in its new tab first.
+    card.querySelector('[data-act="trial"]')?.addEventListener('click', () => close(card));
+    card.querySelector('[data-act="pricing"]')?.addEventListener('click', () => close(card));
+    return card;
+}
+function escapeHtml(s) {
+    return s
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}

package/dist/version.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The version of this package, as a value the pure (browser-safe) generator can
+ * read - it cannot open `package.json` at runtime.
+ *
+ * Generated apps depend on `^SVGRID_VERSION` rather than `latest`, so an app
+ * always installs a runtime at least as new as the generator that wrote it.
+ * `latest` made that a coin toss: an app scaffolded today and the same app
+ * scaffolded tomorrow could resolve different runtimes, and an unrelated publish
+ * could break an app nobody had touched.
+ *
+ * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
+ */
+export declare const SVGRID_VERSION = "2.6.0";

package/{src/version.ts → dist/version.js}

@@ -10,4 +10,4 @@
  *
  * `version.test.ts` asserts this matches `package.json`, so the two cannot drift.
  */
-export const SVGRID_VERSION = '2.5.3'
+export const SVGRID_VERSION = '2.6.0';

package/dist/watermark.d.ts

@@ -0,0 +1,2 @@
+export declare function emitUnlicensedNudge(): void;
+export declare function dismissUnlicensedNudge(): void;

package/dist/watermark.js

@@ -0,0 +1,146 @@
+// Soft-gate UX for unlicensed @svgrid/enterprise use. Shows a small clickable
+// "www.svgrid.com" watermark in the bottom-right corner of every SvGrid on
+// the page, which fades out after 5 seconds, and emits a one-time console
+// nudge. Hard errors (revoked / bad-prefix keys) still throw via license.ts -
+// this file is only for the "no key set" case where the feature continues to
+// work but the user gets nudged.
+const WATERMARK_ATTR = 'data-svgrid-enterprise-watermark';
+// Marks a grid that has already shown (and faded) its watermark, so the
+// MutationObserver doesn't re-add it once it fades out and is removed.
+const NUDGED_ATTR = 'data-svgrid-enterprise-nudged';
+const HOMEPAGE_URL = 'https://svgrid.com';
+const LICENSE_URL = 'https://svgrid.com/pricing/';
+const WATERMARK_LABEL = 'www.svgrid.com';
+// How long the watermark stays fully visible before it starts fading, and how
+// long the fade itself takes.
+const VISIBLE_MS = 5000;
+const FADE_MS = 700;
+let consoleNudgeShown = false;
+let observer = null;
+export function emitUnlicensedNudge() {
+    showConsoleOnce();
+    if (typeof document === 'undefined' || typeof window === 'undefined')
+        return;
+    // Defer one tick: installEnterprise may run inside onApiReady before the grid's
+    // root element is in the DOM. The microtask gives Svelte time to flush.
+    queueMicrotask(() => attachToAllGrids());
+    // Watch for grids that mount later (route changes, dynamic loads).
+    if (!observer) {
+        observer = new MutationObserver(() => attachToAllGrids());
+        observer.observe(document.body, { childList: true, subtree: true });
+    }
+}
+export function dismissUnlicensedNudge() {
+    if (observer) {
+        observer.disconnect();
+        observer = null;
+    }
+    if (typeof document === 'undefined')
+        return;
+    document.querySelectorAll(`[${WATERMARK_ATTR}]`).forEach((el) => el.remove());
+    document
+        .querySelectorAll(`[${NUDGED_ATTR}]`)
+        .forEach((el) => el.removeAttribute(NUDGED_ATTR));
+    consoleNudgeShown = false;
+}
+function showConsoleOnce() {
+    if (consoleNudgeShown)
+        return;
+    consoleNudgeShown = true;
+    if (typeof console === 'undefined')
+        return;
+    // Per spec we use console.log (not warn/error) - this is a nudge, not an
+    // error condition. Styled with %c so it stands out in the devtools.
+    console.log('%c @svgrid/enterprise %c User is using a Commercial version which requires a license.\n' +
+        'Contact sales@jqwidgets.com for details or visit the license page: ' +
+        LICENSE_URL, 'background:#4f46e5;color:#fff;padding:2px 6px;border-radius:3px;font-weight:600', 'color:inherit');
+}
+function attachToAllGrids() {
+    if (typeof document === 'undefined')
+        return;
+    // Primary selector targets SvGrid's root container class. Fall back to
+    // ARIA grid role for headless renderers that re-style the wrapper.
+    const grids = document.querySelectorAll('.sv-grid-root, [role="grid"]');
+    if (grids.length === 0) {
+        ensureFixedFallback();
+        return;
+    }
+    // A grid root was found - remove any fixed fallback we may have installed
+    // earlier before the grid mounted.
+    document
+        .querySelectorAll(`[${WATERMARK_ATTR}="fixed"]`)
+        .forEach((el) => el.remove());
+    grids.forEach(attachWatermarkTo);
+}
+function attachWatermarkTo(grid) {
+    // Show the watermark once per grid. The marker survives the fade-out so the
+    // MutationObserver doesn't keep re-adding it on every DOM change.
+    if (grid.hasAttribute(NUDGED_ATTR))
+        return;
+    grid.setAttribute(NUDGED_ATTR, '1');
+    const cs = getComputedStyle(grid);
+    if (cs.position === 'static') {
+        // Need a positioning context for absolute positioning. Only override when
+        // 'static' (the browser default) - don't clobber an explicit
+        // relative/absolute the consumer chose.
+        grid.style.position = 'relative';
+    }
+    const a = buildWatermark('grid');
+    applyWatermarkStyles(a, /* fixed */ false);
+    grid.appendChild(a);
+    scheduleFadeOut(a);
+}
+function ensureFixedFallback() {
+    if (typeof document === 'undefined')
+        return;
+    if (document.querySelector(`[${WATERMARK_ATTR}="fixed"]`))
+        return;
+    const a = buildWatermark('fixed');
+    applyWatermarkStyles(a, /* fixed */ true);
+    document.body.appendChild(a);
+    scheduleFadeOut(a);
+}
+function buildWatermark(kind) {
+    const a = document.createElement('a');
+    a.setAttribute(WATERMARK_ATTR, kind);
+    a.href = HOMEPAGE_URL;
+    a.target = '_blank';
+    a.rel = 'noopener noreferrer';
+    a.textContent = WATERMARK_LABEL;
+    a.title =
+        'Unlicensed @svgrid/enterprise. Contact sales@jqwidgets.com or visit www.svgrid.com.';
+    return a;
+}
+/** Keep the watermark visible for VISIBLE_MS, then fade it out and remove it. */
+function scheduleFadeOut(el) {
+    if (typeof window === 'undefined') {
+        el.remove();
+        return;
+    }
+    window.setTimeout(() => {
+        el.style.opacity = '0';
+        window.setTimeout(() => el.remove(), FADE_MS);
+    }, VISIBLE_MS);
+}
+function applyWatermarkStyles(el, fixed) {
+    Object.assign(el.style, {
+        position: fixed ? 'fixed' : 'absolute',
+        bottom: fixed ? '12px' : '6px',
+        right: fixed ? '12px' : '8px',
+        zIndex: '2147483647',
+        background: 'rgba(15,23,42,0.85)',
+        color: '#fff',
+        padding: fixed ? '6px 10px' : '4px 8px',
+        borderRadius: fixed ? '4px' : '3px',
+        fontFamily: '-apple-system, "Segoe UI", Roboto, sans-serif',
+        fontSize: fixed ? '11px' : '10px',
+        lineHeight: '1.2',
+        textDecoration: 'none',
+        boxShadow: fixed ? '0 2px 12px rgba(0,0,0,0.35)' : '0 1px 4px rgba(0,0,0,0.3)',
+        border: '1px solid rgba(255,255,255,0.18)',
+        pointerEvents: 'auto',
+        letterSpacing: '0.02em',
+        opacity: '1',
+        transition: `opacity ${FADE_MS}ms ease`,
+    });
+}

package/package.json

@@ -4,43 +4,46 @@
     "type": "commercial",
     "url": "https://svgrid.com/pricing"
   },
-  "version": "2.5.3",
+  "version": "2.6.1",
   "description": "Enterprise feature pack for SvGrid: Excel (xlsx), PDF, CSV, TSV and HTML export, Excel/CSV/JSON import, pivot tables with a drag-and-drop designer, paginated print, Kanban board and scheduler views. Requires a paid license key.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "jQWidgets <sales@jqwidgets.com>",
   "homepage": "https://svgrid.com/pricing",
   "type": "module",
+  "types": "./dist/index.d.ts",
+  "module": "./dist/index.js",
+  "svelte": "./dist/index.js",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
-      "svelte": "./src/index.ts",
-      "import": "./src/index.ts"
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "import": "./dist/index.js"
     },
     "./export": {
-      "types": "./src/export.ts",
-      "svelte": "./src/export.ts",
-      "import": "./src/export.ts"
+      "types": "./dist/export.d.ts",
+      "svelte": "./dist/export.js",
+      "import": "./dist/export.js"
     },
     "./print": {
-      "types": "./src/print.ts",
-      "svelte": "./src/print.ts",
-      "import": "./src/print.ts"
+      "types": "./dist/print.d.ts",
+      "svelte": "./dist/print.js",
+      "import": "./dist/print.js"
     },
     "./import": {
-      "types": "./src/import.ts",
-      "svelte": "./src/import.ts",
-      "import": "./src/import.ts"
+      "types": "./dist/import.d.ts",
+      "svelte": "./dist/import.js",
+      "import": "./dist/import.js"
     },
     "./pivot": {
-      "types": "./src/pivot.ts",
-      "svelte": "./src/pivot.ts",
-      "import": "./src/pivot.ts"
+      "types": "./dist/pivot.d.ts",
+      "svelte": "./dist/pivot.js",
+      "import": "./dist/pivot.js"
     },
     "./studio": {
-      "types": "./src/studio/index.ts",
+      "types": "./dist/studio/index.d.ts",
       "node": "./dist/node/studio.js",
-      "svelte": "./src/studio/index.ts",
-      "import": "./src/studio/index.ts"
+      "svelte": "./dist/studio/index.js",
+      "import": "./dist/studio/index.js"
     },
     "./cdn/svelte-external": {
       "import": "./dist/cdn/svgrid-enterprise.svelte-external.js",
@@ -51,10 +54,7 @@
   "unpkg": "./dist/cdn/svgrid-enterprise.svelte-external.js",
   "jsdelivr": "./dist/cdn/svgrid-enterprise.svelte-external.js",
   "files": [
-    "src",
-    "dist/node",
-    "dist/cdn",
-    "dist/designer",
+    "dist",
     "README.md",
     "LICENSE"
   ],
@@ -65,7 +65,7 @@
     "jszip": "^3.10.0",
     "pdfmake": "^0.2.0",
     "svelte": "^5.0.0",
-    "@svgrid/grid": "^2.5.0"
+    "@svgrid/grid": "^2.6.1"
   },
   "peerDependenciesMeta": {
     "jszip": {
@@ -76,13 +76,14 @@
     }
   },
   "devDependencies": {
+    "@sveltejs/package": "^2.5.7",
     "@sveltejs/vite-plugin-svelte": "^7.0.0",
     "jszip": "^3.10.1",
     "pdfmake": "^0.2.10",
     "svelte": "^5.55.5",
     "typescript": "6.0.3",
     "vite": "^8.2.1",
-    "@svgrid/grid": "^2.5.0"
+    "@svgrid/grid": "^2.6.1"
   },
   "repository": {
     "type": "git",
@@ -112,7 +113,8 @@
   "scripts": {
     "test": "vitest run",
     "test:types": "tsc -p tsconfig.json --noEmit",
-    "build": "node ./scripts/build-cdn.mjs && node ./scripts/build-node.mjs && node ./scripts/build-designer.mjs",
+    "build": "svelte-package --input ./src --output ./dist && node ../../tools/strip-dist-tests.mjs ./dist && node ./scripts/build-cdn.mjs && node ./scripts/build-node.mjs && node ./scripts/build-designer.mjs",
+    "build:lib": "svelte-package --input ./src --output ./dist && node ../../tools/strip-dist-tests.mjs ./dist",
     "build:cdn": "node ./scripts/build-cdn.mjs",
     "build:node": "node ./scripts/build-node.mjs",
     "build:designer": "node ./scripts/build-designer.mjs",