@rm-graph/core 0.1.9 → 0.1.11

package/dist/index.d.mts

@@ -245,14 +245,6 @@ interface Column3DChartConfig extends ChartConfig {
     maxCameraRadius?: number;
     /** Minimum camera radius */
     minCameraRadius?: number;
-    /** Minimum yaw angle in degrees (horizontal). Default -179. */
-    minYaw?: number;
-    /** Maximum yaw angle in degrees (horizontal). Default 179. */
-    maxYaw?: number;
-    /** Minimum pitch angle in degrees (vertical). Default 0. */
-    minPitch?: number;
-    /** Maximum pitch angle in degrees (vertical). Default 88. */
-    maxPitch?: number;
     /** Camera preset positions */
     cameraPresets?: CameraPreset[];
     /** Use cylinder point markers instead of columns */
@@ -295,9 +287,8 @@ declare class Column3DChart {
      */
     private createSurface;
     /**
-     * Setup camera clamping to restrict camera movement.
-     * Yaw snaps to boundaries: >100 → -180, >=0 → 0 (keeps view in -180..0 range).
-     * Pitch clamped to [0, 89]. Radius clamped to [495, 805].
+     * Setup camera clamping to restrict camera movement
+     * Matches the original ThreeDGraph.jsx behavior
      */
     private setupCameraClamping;
     /**
@@ -360,11 +351,6 @@ declare class Column3DChart {
      * Get the SciChart surface for advanced operations
      */
     getSurface(): SciChart3DSurface | null;
-    /**
-     * Notify SciChart that the container has resized so the WebGL canvas
-     * adjusts to the new dimensions. Call after maximize / minimize.
-     */
-    resize(): void;
     /**
      * Destroy and clean up
      */
@@ -542,12 +528,217 @@ declare function lerp(start: number, end: number, t: number): number;
  */
 declare function hexToRgba(hex: string, alpha?: number): string;
 
+/**
+ * Generic encryption/decryption utilities using Web Crypto API
+ * Provides obfuscation for license keys stored in localStorage
+ *
+ * Note: This provides obfuscation, not true security.
+ * The decryption key is in client code, so determined attackers can still decrypt.
+ * For production, combine with SciChart's domain-locking for real protection.
+ */
+/**
+ * Encrypt a license key string
+ * @param licenseKey - The plain text license key
+ * @param passphrase - The passphrase to derive encryption key from
+ * @returns Base64 encoded encrypted data
+ */
+declare function encryptLicense(licenseKey: string, passphrase: string): Promise<string>;
+/**
+ * Decrypt an encrypted license key
+ * @param encryptedData - Base64 encoded encrypted data
+ * @param passphrase - The passphrase to derive decryption key from
+ * @returns The decrypted license key or null if decryption fails
+ */
+declare function decryptLicense(encryptedData: string, passphrase: string): Promise<string | null>;
+/**
+ * Save encrypted license to localStorage
+ * @param licenseKey - The plain text license key
+ * @param passphrase - The passphrase for encryption
+ */
+declare function saveEncryptedLicense(licenseKey: string, passphrase: string): Promise<void>;
+/**
+ * Load and decrypt license from localStorage
+ * @param passphrase - The passphrase for decryption
+ * @returns The decrypted license key or null if not found/decryption fails
+ */
+declare function loadEncryptedLicense(passphrase: string): Promise<string | null>;
+/**
+ * Check if an encrypted license exists in localStorage
+ */
+declare function hasEncryptedLicense(): boolean;
+/**
+ * Clear stored license from localStorage
+ */
+declare function clearStoredLicense(): void;
+/**
+ * Get the storage key used for license data
+ */
+declare function getLicenseStorageKey(): string;
+
+/**
+ * License management module for @rm-graph packages
+ *
+ * Provides encrypted storage and retrieval of SciChart license keys.
+ * License keys are encrypted using AES-256-GCM before storing in localStorage.
+ *
+ * @example
+ * ```typescript
+ * import { setLicense, loadLicense, configureLicenseEncryption } from '@rm-graph/core';
+ *
+ * // Optional: Configure custom passphrase
+ * configureLicenseEncryption({ passphrase: 'your-app-secret' });
+ *
+ * // Save a license (encrypts and stores in localStorage)
+ * await setLicense('your-scichart-license-key');
+ *
+ * // Load license on app startup
+ * await loadLicense();
+ * ```
+ */
+
+/**
+ * Configuration options for license encryption
+ */
+interface LicenseConfig {
+    /** Custom passphrase for encryption/decryption (optional) */
+    passphrase?: string;
+}
+/**
+ * License status information
+ */
+interface LicenseStatus {
+    /** Whether a license is stored */
+    hasLicense: boolean;
+    /** Whether the license was successfully loaded and applied */
+    isApplied: boolean;
+    /** Error message if any */
+    error?: string;
+}
+/**
+ * Configure the license encryption passphrase
+ * Call this before saving or loading licenses if you want to use a custom passphrase
+ *
+ * @param config - Configuration options
+ *
+ * @example
+ * ```typescript
+ * configureLicenseEncryption({ passphrase: 'my-app-secret-key' });
+ * ```
+ */
+declare function configureLicenseEncryption(config: LicenseConfig): void;
+/**
+ * Get the current passphrase (for internal use)
+ */
+declare function getCurrentPassphrase(): string;
+/**
+ * Reset passphrase to default
+ */
+declare function resetPassphrase(): void;
+/**
+ * Save and apply a SciChart license key
+ * Encrypts the key and stores it in localStorage, then applies it to SciChart
+ *
+ * @param licenseKey - The SciChart license key to save
+ * @returns Promise resolving to true if successful, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const success = await setLicense('your-scichart-license-key');
+ * if (success) {
+ *   console.log('License saved and applied!');
+ * }
+ * ```
+ */
+declare function setLicense(licenseKey: string): Promise<boolean>;
+/**
+ * Load license from localStorage and apply to SciChart
+ *
+ * @returns Promise resolving to true if license was found and applied, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Call on app startup
+ * const loaded = await loadLicense();
+ * if (loaded) {
+ *   console.log('License loaded from storage');
+ * } else {
+ *   console.log('No license found - charts will show watermark');
+ * }
+ * ```
+ */
+declare function loadLicense(): Promise<boolean>;
+/**
+ * Check if a license is stored in localStorage
+ *
+ * @returns true if a license exists in storage
+ */
+declare function hasStoredLicense(): boolean;
+/**
+ * Check if a license has been applied to SciChart in this session
+ *
+ * @returns true if a license has been applied
+ */
+declare function isLicenseApplied(): boolean;
+/**
+ * Remove stored license from localStorage
+ * Note: This doesn't remove the license from SciChart (requires page reload)
+ */
+declare function removeLicense(): void;
+/**
+ * Apply a license key directly without storing it
+ * Useful for temporary/session-only license application
+ *
+ * @param licenseKey - The SciChart license key
+ */
+declare function applyLicenseKey(licenseKey: string): void;
+/**
+ * Get current license status
+ *
+ * @returns License status information
+ */
+declare function getLicenseStatus(): LicenseStatus;
+/**
+ * Validate a license key format (basic validation)
+ * Note: This doesn't validate if the license is actually valid with SciChart
+ *
+ * @param licenseKey - The license key to validate
+ * @returns true if the format appears valid
+ */
+declare function validateLicenseFormat(licenseKey: string): boolean;
+
 /**
  * SciChart UI - A customizable charting library built on SciChart
  *
  * @packageDocumentation
  */
 
+/**
+ * Setup SciChart license from multiple sources (legacy API - kept for backward compatibility)
+ * Tries sources in order: env variable → localStorage → direct key
+ *
+ * @deprecated Use loadLicense() or setLicense() instead
+ *
+ * @example
+ * ```ts
+ * import { setupSciChartLicense } from '@rm-graph/core';
+ *
+ * setupSciChartLicense({
+ *   fromEnv: true,
+ *   fromLocalStorage: true,
+ *   licenseKey: 'fallback-key'
+ * });
+ * ```
+ */
+declare function setupSciChartLicense(options: {
+    fromEnv?: boolean;
+    fromLocalStorage?: boolean;
+    licenseKey?: string;
+}): Promise<boolean>;
+/**
+ * Configure SciChart license key directly (legacy API)
+ * @deprecated Use setLicense() for encrypted storage or applyLicenseKey() for direct application
+ */
+declare function configureSciChartLicense(licenseKey: string): void;
 declare const VERSION = "0.1.1";
 
 /**
@@ -569,4 +760,4 @@ declare function configureSciChart(options: {
     wasmUrl?: string;
 }): void;
 
-export { BaseChart, type CameraPreset, ChartConfig, ChartEventMap, ChartInstance, Column3DChart, type Column3DChartConfig, type Column3DChartStats, type Column3DDataPoint, DEFAULT_CAMERA_PRESETS, DataPoint, PRPDChart, PRPDChartConfig, PRPDChartStats, PRPDDataPoint, PRPDResolutionLabel, PRPDWindowingRegion, SeriesData, Surface3DChart, Surface3DChartConfig, ThemeConfig, UOM_LABELS, type UnitOfMeasurement, VERSION, calculateDataRange, clamp, configureSciChart, createColumn3DChart, createPRPDChart, createSurface3DChart, debounce, deepMerge, extractXValues, extractYValues, formatNumber, generateId, hexToRgba, lerp, mVpToDb, mVrmsToDbm, normalizeDataPoints, parseSize, throttle };
+export { BaseChart, type CameraPreset, ChartConfig, ChartEventMap, ChartInstance, Column3DChart, type Column3DChartConfig, type Column3DChartStats, type Column3DDataPoint, DEFAULT_CAMERA_PRESETS, DataPoint, type LicenseConfig, type LicenseStatus, PRPDChart, PRPDChartConfig, PRPDChartStats, PRPDDataPoint, PRPDResolutionLabel, PRPDWindowingRegion, SeriesData, Surface3DChart, Surface3DChartConfig, ThemeConfig, UOM_LABELS, type UnitOfMeasurement, VERSION, applyLicenseKey, calculateDataRange, clamp, clearStoredLicense, configureLicenseEncryption, configureSciChart, configureSciChartLicense, createColumn3DChart, createPRPDChart, createSurface3DChart, debounce, decryptLicense, deepMerge, encryptLicense, extractXValues, extractYValues, formatNumber, generateId, getCurrentPassphrase, getLicenseStatus, getLicenseStorageKey, hasEncryptedLicense, hasStoredLicense, hexToRgba, isLicenseApplied, lerp, loadEncryptedLicense, loadLicense, mVpToDb, mVrmsToDbm, normalizeDataPoints, parseSize, removeLicense, resetPassphrase, saveEncryptedLicense, setLicense, setupSciChartLicense, throttle, validateLicenseFormat };

package/dist/index.d.ts

@@ -245,14 +245,6 @@ interface Column3DChartConfig extends ChartConfig {
     maxCameraRadius?: number;
     /** Minimum camera radius */
     minCameraRadius?: number;
-    /** Minimum yaw angle in degrees (horizontal). Default -179. */
-    minYaw?: number;
-    /** Maximum yaw angle in degrees (horizontal). Default 179. */
-    maxYaw?: number;
-    /** Minimum pitch angle in degrees (vertical). Default 0. */
-    minPitch?: number;
-    /** Maximum pitch angle in degrees (vertical). Default 88. */
-    maxPitch?: number;
     /** Camera preset positions */
     cameraPresets?: CameraPreset[];
     /** Use cylinder point markers instead of columns */
@@ -295,9 +287,8 @@ declare class Column3DChart {
      */
     private createSurface;
     /**
-     * Setup camera clamping to restrict camera movement.
-     * Yaw snaps to boundaries: >100 → -180, >=0 → 0 (keeps view in -180..0 range).
-     * Pitch clamped to [0, 89]. Radius clamped to [495, 805].
+     * Setup camera clamping to restrict camera movement
+     * Matches the original ThreeDGraph.jsx behavior
      */
     private setupCameraClamping;
     /**
@@ -360,11 +351,6 @@ declare class Column3DChart {
      * Get the SciChart surface for advanced operations
      */
     getSurface(): SciChart3DSurface | null;
-    /**
-     * Notify SciChart that the container has resized so the WebGL canvas
-     * adjusts to the new dimensions. Call after maximize / minimize.
-     */
-    resize(): void;
     /**
      * Destroy and clean up
      */
@@ -542,12 +528,217 @@ declare function lerp(start: number, end: number, t: number): number;
  */
 declare function hexToRgba(hex: string, alpha?: number): string;
 
+/**
+ * Generic encryption/decryption utilities using Web Crypto API
+ * Provides obfuscation for license keys stored in localStorage
+ *
+ * Note: This provides obfuscation, not true security.
+ * The decryption key is in client code, so determined attackers can still decrypt.
+ * For production, combine with SciChart's domain-locking for real protection.
+ */
+/**
+ * Encrypt a license key string
+ * @param licenseKey - The plain text license key
+ * @param passphrase - The passphrase to derive encryption key from
+ * @returns Base64 encoded encrypted data
+ */
+declare function encryptLicense(licenseKey: string, passphrase: string): Promise<string>;
+/**
+ * Decrypt an encrypted license key
+ * @param encryptedData - Base64 encoded encrypted data
+ * @param passphrase - The passphrase to derive decryption key from
+ * @returns The decrypted license key or null if decryption fails
+ */
+declare function decryptLicense(encryptedData: string, passphrase: string): Promise<string | null>;
+/**
+ * Save encrypted license to localStorage
+ * @param licenseKey - The plain text license key
+ * @param passphrase - The passphrase for encryption
+ */
+declare function saveEncryptedLicense(licenseKey: string, passphrase: string): Promise<void>;
+/**
+ * Load and decrypt license from localStorage
+ * @param passphrase - The passphrase for decryption
+ * @returns The decrypted license key or null if not found/decryption fails
+ */
+declare function loadEncryptedLicense(passphrase: string): Promise<string | null>;
+/**
+ * Check if an encrypted license exists in localStorage
+ */
+declare function hasEncryptedLicense(): boolean;
+/**
+ * Clear stored license from localStorage
+ */
+declare function clearStoredLicense(): void;
+/**
+ * Get the storage key used for license data
+ */
+declare function getLicenseStorageKey(): string;
+
+/**
+ * License management module for @rm-graph packages
+ *
+ * Provides encrypted storage and retrieval of SciChart license keys.
+ * License keys are encrypted using AES-256-GCM before storing in localStorage.
+ *
+ * @example
+ * ```typescript
+ * import { setLicense, loadLicense, configureLicenseEncryption } from '@rm-graph/core';
+ *
+ * // Optional: Configure custom passphrase
+ * configureLicenseEncryption({ passphrase: 'your-app-secret' });
+ *
+ * // Save a license (encrypts and stores in localStorage)
+ * await setLicense('your-scichart-license-key');
+ *
+ * // Load license on app startup
+ * await loadLicense();
+ * ```
+ */
+
+/**
+ * Configuration options for license encryption
+ */
+interface LicenseConfig {
+    /** Custom passphrase for encryption/decryption (optional) */
+    passphrase?: string;
+}
+/**
+ * License status information
+ */
+interface LicenseStatus {
+    /** Whether a license is stored */
+    hasLicense: boolean;
+    /** Whether the license was successfully loaded and applied */
+    isApplied: boolean;
+    /** Error message if any */
+    error?: string;
+}
+/**
+ * Configure the license encryption passphrase
+ * Call this before saving or loading licenses if you want to use a custom passphrase
+ *
+ * @param config - Configuration options
+ *
+ * @example
+ * ```typescript
+ * configureLicenseEncryption({ passphrase: 'my-app-secret-key' });
+ * ```
+ */
+declare function configureLicenseEncryption(config: LicenseConfig): void;
+/**
+ * Get the current passphrase (for internal use)
+ */
+declare function getCurrentPassphrase(): string;
+/**
+ * Reset passphrase to default
+ */
+declare function resetPassphrase(): void;
+/**
+ * Save and apply a SciChart license key
+ * Encrypts the key and stores it in localStorage, then applies it to SciChart
+ *
+ * @param licenseKey - The SciChart license key to save
+ * @returns Promise resolving to true if successful, false otherwise
+ *
+ * @example
+ * ```typescript
+ * const success = await setLicense('your-scichart-license-key');
+ * if (success) {
+ *   console.log('License saved and applied!');
+ * }
+ * ```
+ */
+declare function setLicense(licenseKey: string): Promise<boolean>;
+/**
+ * Load license from localStorage and apply to SciChart
+ *
+ * @returns Promise resolving to true if license was found and applied, false otherwise
+ *
+ * @example
+ * ```typescript
+ * // Call on app startup
+ * const loaded = await loadLicense();
+ * if (loaded) {
+ *   console.log('License loaded from storage');
+ * } else {
+ *   console.log('No license found - charts will show watermark');
+ * }
+ * ```
+ */
+declare function loadLicense(): Promise<boolean>;
+/**
+ * Check if a license is stored in localStorage
+ *
+ * @returns true if a license exists in storage
+ */
+declare function hasStoredLicense(): boolean;
+/**
+ * Check if a license has been applied to SciChart in this session
+ *
+ * @returns true if a license has been applied
+ */
+declare function isLicenseApplied(): boolean;
+/**
+ * Remove stored license from localStorage
+ * Note: This doesn't remove the license from SciChart (requires page reload)
+ */
+declare function removeLicense(): void;
+/**
+ * Apply a license key directly without storing it
+ * Useful for temporary/session-only license application
+ *
+ * @param licenseKey - The SciChart license key
+ */
+declare function applyLicenseKey(licenseKey: string): void;
+/**
+ * Get current license status
+ *
+ * @returns License status information
+ */
+declare function getLicenseStatus(): LicenseStatus;
+/**
+ * Validate a license key format (basic validation)
+ * Note: This doesn't validate if the license is actually valid with SciChart
+ *
+ * @param licenseKey - The license key to validate
+ * @returns true if the format appears valid
+ */
+declare function validateLicenseFormat(licenseKey: string): boolean;
+
 /**
  * SciChart UI - A customizable charting library built on SciChart
  *
  * @packageDocumentation
  */
 
+/**
+ * Setup SciChart license from multiple sources (legacy API - kept for backward compatibility)
+ * Tries sources in order: env variable → localStorage → direct key
+ *
+ * @deprecated Use loadLicense() or setLicense() instead
+ *
+ * @example
+ * ```ts
+ * import { setupSciChartLicense } from '@rm-graph/core';
+ *
+ * setupSciChartLicense({
+ *   fromEnv: true,
+ *   fromLocalStorage: true,
+ *   licenseKey: 'fallback-key'
+ * });
+ * ```
+ */
+declare function setupSciChartLicense(options: {
+    fromEnv?: boolean;
+    fromLocalStorage?: boolean;
+    licenseKey?: string;
+}): Promise<boolean>;
+/**
+ * Configure SciChart license key directly (legacy API)
+ * @deprecated Use setLicense() for encrypted storage or applyLicenseKey() for direct application
+ */
+declare function configureSciChartLicense(licenseKey: string): void;
 declare const VERSION = "0.1.1";
 
 /**
@@ -569,4 +760,4 @@ declare function configureSciChart(options: {
     wasmUrl?: string;
 }): void;
 
-export { BaseChart, type CameraPreset, ChartConfig, ChartEventMap, ChartInstance, Column3DChart, type Column3DChartConfig, type Column3DChartStats, type Column3DDataPoint, DEFAULT_CAMERA_PRESETS, DataPoint, PRPDChart, PRPDChartConfig, PRPDChartStats, PRPDDataPoint, PRPDResolutionLabel, PRPDWindowingRegion, SeriesData, Surface3DChart, Surface3DChartConfig, ThemeConfig, UOM_LABELS, type UnitOfMeasurement, VERSION, calculateDataRange, clamp, configureSciChart, createColumn3DChart, createPRPDChart, createSurface3DChart, debounce, deepMerge, extractXValues, extractYValues, formatNumber, generateId, hexToRgba, lerp, mVpToDb, mVrmsToDbm, normalizeDataPoints, parseSize, throttle };
+export { BaseChart, type CameraPreset, ChartConfig, ChartEventMap, ChartInstance, Column3DChart, type Column3DChartConfig, type Column3DChartStats, type Column3DDataPoint, DEFAULT_CAMERA_PRESETS, DataPoint, type LicenseConfig, type LicenseStatus, PRPDChart, PRPDChartConfig, PRPDChartStats, PRPDDataPoint, PRPDResolutionLabel, PRPDWindowingRegion, SeriesData, Surface3DChart, Surface3DChartConfig, ThemeConfig, UOM_LABELS, type UnitOfMeasurement, VERSION, applyLicenseKey, calculateDataRange, clamp, clearStoredLicense, configureLicenseEncryption, configureSciChart, configureSciChartLicense, createColumn3DChart, createPRPDChart, createSurface3DChart, debounce, decryptLicense, deepMerge, encryptLicense, extractXValues, extractYValues, formatNumber, generateId, getCurrentPassphrase, getLicenseStatus, getLicenseStorageKey, hasEncryptedLicense, hasStoredLicense, hexToRgba, isLicenseApplied, lerp, loadEncryptedLicense, loadLicense, mVpToDb, mVrmsToDbm, normalizeDataPoints, parseSize, removeLicense, resetPassphrase, saveEncryptedLicense, setLicense, setupSciChartLicense, throttle, validateLicenseFormat };