@qwickapps/react-framework 1.3.4 → 1.4.0

package/dist/config/types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * QwickApps AppConfig Types
+ *
+ * Defines the configuration contract for QwickApp applications.
+ * Separates static app configuration from runtime settings.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import type { UserConfig as ViteUserConfig } from 'vite';
+/**
+ * Static, immutable application configuration
+ */
+export interface AppConfig {
+    /** Application identity and metadata */
+    readonly app: AppIdentity;
+    /** Build and development settings */
+    readonly build: BuildConfig;
+    /** Progressive Web App configuration */
+    readonly pwa: PWAConfig;
+    /** Default theme and UI settings */
+    readonly ui: UIConfig;
+    /** Copyright and legal information */
+    readonly copyright: CopyrightConfig;
+    /** Computed Vite configuration */
+    readonly viteConfig: ViteUserConfig;
+    /** Computed PWA manifest */
+    readonly pwaManifest: Record<string, any>;
+}
+/**
+ * Application identity and basic metadata
+ */
+export interface AppIdentity {
+    /** Unique application identifier */
+    readonly id: string;
+    /** Full application name */
+    readonly name: string;
+    /** Short name for PWA and limited spaces */
+    readonly shortName: string;
+    /** Application description */
+    readonly description: string;
+    /** Application version */
+    readonly version: string;
+    /** Path to application logo/icon */
+    readonly logo: string;
+    /** Application author/organization */
+    readonly author?: string;
+    /** Application homepage URL */
+    readonly homepage?: string;
+}
+/**
+ * Build and development configuration
+ */
+export interface BuildConfig {
+    /** Development server port */
+    readonly port: number;
+    /** Preview server port */
+    readonly previewPort: number;
+    /** Build output directory */
+    readonly outputDir: string;
+    /** Public path for assets */
+    readonly publicPath: string;
+    /** Base URL for the application */
+    readonly base: string;
+}
+/**
+ * Progressive Web App configuration
+ */
+export interface PWAConfig {
+    /** PWA theme color */
+    readonly themeColor: string;
+    /** PWA background color */
+    readonly backgroundColor: string;
+    /** PWA start URL */
+    readonly startUrl: string;
+    /** PWA scope */
+    readonly scope: string;
+    /** PWA display mode */
+    readonly display: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    /** PWA orientation */
+    readonly orientation?: 'portrait' | 'landscape' | 'any';
+}
+/**
+ * Default UI and theme configuration
+ */
+export interface UIConfig {
+    /** Default theme mode */
+    readonly defaultTheme: 'light' | 'dark' | 'system';
+    /** Default color palette */
+    readonly defaultPalette: string;
+    /** Enable scaffolding (navigation, layout) */
+    readonly enableScaffolding: boolean;
+    /** Show theme switcher */
+    readonly showThemeSwitcher: boolean;
+    /** Show palette switcher */
+    readonly showPaletteSwitcher: boolean;
+}
+/**
+ * Copyright and legal information
+ */
+export interface CopyrightConfig {
+    /** Copyright year ('auto' for current year or specific year) */
+    readonly year: 'auto' | number;
+    /** Copyright holder/owner */
+    readonly author: string;
+    /** Additional legal text */
+    readonly text?: string;
+}
+/**
+ * Configuration builder options
+ */
+export interface AppConfigOptions {
+    /** Base directory for resolving relative paths */
+    baseDir?: string;
+    /** Environment (development, production, test) */
+    env?: string;
+    /** Skip file existence validation */
+    skipValidation?: boolean;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Validation warnings */
+    warnings: string[];
+    /** Validation errors */
+    errors: string[];
+    /** Whether configuration is valid */
+    isValid: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+/**
+ * QwickApps Configuration Module Entry
+ *
+ * Lightweight export for config-only usage at build time.
+ * This file only exports configuration types and builders
+ * without pulling in React or MUI dependencies.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+export { AppConfig } from './config/AppConfig';
+export { AppConfigBuilder } from './config/AppConfigBuilder';
+export type { AppConfig as IAppConfig, AppIdentity, BuildConfig, PWAConfig, UIConfig, AppConfigOptions, ValidationResult, } from './config/types';
+import { AppConfigBuilder } from './config/AppConfigBuilder';
+export declare const createAppConfig: typeof AppConfigBuilder.create;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EACV,SAAS,IAAI,UAAU,EACvB,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,eAAO,MAAM,eAAe,gCAA0B,CAAC"}

package/dist/config.esm.js

@@ -0,0 +1,451 @@
+/**
+ * QwickApps AppConfig Implementation
+ *
+ * Immutable configuration object with computed properties for Vite and PWA.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+/**
+ * Immutable application configuration
+ */
+class AppConfig {
+  constructor(config) {
+    // Create frozen, immutable configuration
+    this.app = Object.freeze({
+      ...config.app
+    });
+    this.build = Object.freeze({
+      ...config.build
+    });
+    this.pwa = Object.freeze({
+      ...config.pwa
+    });
+    this.ui = Object.freeze({
+      ...config.ui
+    });
+    this.copyright = Object.freeze({
+      ...config.copyright
+    });
+    // Freeze the entire object
+    Object.freeze(this);
+  }
+  /**
+   * Generate complete Vite configuration
+   */
+  get viteConfig() {
+    return {
+      server: {
+        port: this.build.port,
+        host: true
+      },
+      preview: {
+        port: this.build.previewPort,
+        host: true
+      },
+      build: {
+        outDir: this.build.outputDir
+      },
+      base: this.build.base,
+      publicDir: 'public',
+      define: {
+        __APP_NAME__: JSON.stringify(this.app.name),
+        __APP_ID__: JSON.stringify(this.app.id),
+        __APP_VERSION__: JSON.stringify(this.app.version)
+      }
+    };
+  }
+  /**
+   * Generate PWA manifest
+   */
+  get pwaManifest() {
+    return {
+      name: this.app.name,
+      short_name: this.app.shortName,
+      description: this.app.description,
+      start_url: this.pwa.startUrl,
+      display: this.pwa.display,
+      orientation: this.pwa.orientation,
+      theme_color: this.pwa.themeColor,
+      background_color: this.pwa.backgroundColor,
+      scope: this.pwa.scope,
+      icons: [{
+        src: 'pwa-192x192.png',
+        sizes: '192x192',
+        type: 'image/png'
+      }, {
+        src: 'pwa-512x512.png',
+        sizes: '512x512',
+        type: 'image/png'
+      }]
+    };
+  }
+  /**
+   * Convert to plain object (for serialization)
+   */
+  toJSON() {
+    return {
+      app: this.app,
+      build: this.build,
+      pwa: this.pwa,
+      ui: this.ui,
+      copyright: this.copyright
+    };
+  }
+  /**
+   * Create a copy with overrides (returns new immutable instance)
+   */
+  with(overrides) {
+    return new AppConfig({
+      app: {
+        ...this.app,
+        ...overrides.app
+      },
+      build: {
+        ...this.build,
+        ...overrides.build
+      },
+      pwa: {
+        ...this.pwa,
+        ...overrides.pwa
+      },
+      ui: {
+        ...this.ui,
+        ...overrides.ui
+      },
+      copyright: {
+        ...this.copyright,
+        ...overrides.copyright
+      }
+    });
+  }
+}
+
+/**
+ * QwickApps AppConfigBuilder
+ *
+ * Builder pattern for creating validated, immutable AppConfig instances.
+ * Supports fluent API and deferred validation.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+// Node.js imports (only available in build/development environment)
+let fs;
+let path;
+try {
+  // Only import if we're in Node.js environment
+  if (typeof window === 'undefined' && typeof process !== 'undefined') {
+    fs = require('fs');
+    path = require('path');
+  }
+} catch (error) {
+  // Browser environment - fs/path not available
+}
+/**
+ * Builder for creating AppConfig instances with validation
+ */
+class AppConfigBuilder {
+  constructor() {
+    this.config = {
+      app: {},
+      build: {},
+      pwa: {},
+      ui: {},
+      copyright: {}
+    };
+    this.options = {};
+  }
+  /**
+   * Create a new AppConfigBuilder instance
+   */
+  static create() {
+    return new AppConfigBuilder();
+  }
+  /**
+   * Load configuration from JSON file (Node.js only)
+   */
+  withConfig(configPath) {
+    if (!fs || !path) {
+      // Only warn in development, not in tests or production browsers
+      if (typeof window === 'undefined') {
+        console.warn('Warning: File system operations not available in browser environment');
+      }
+      return this;
+    }
+    try {
+      const fullPath = path.resolve(configPath);
+      const configData = JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
+      if (configData.app) Object.assign(this.config.app, configData.app);
+      if (configData.build) Object.assign(this.config.build, configData.build);
+      if (configData.pwa) Object.assign(this.config.pwa, configData.pwa);
+      if (configData.ui) Object.assign(this.config.ui, configData.ui);
+      if (configData.copyright) Object.assign(this.config.copyright, configData.copyright);
+    } catch (error) {
+      // Don't throw here - will be handled in build()
+      console.warn(`Warning: Could not load config file: ${configPath}`);
+    }
+    return this;
+  }
+  /**
+   * Set builder options
+   */
+  withOptions(options) {
+    this.options = {
+      ...this.options,
+      ...options
+    };
+    return this;
+  }
+  // App Identity Methods
+  withName(name) {
+    this.config.app.name = name;
+    return this;
+  }
+  withId(id) {
+    this.config.app.id = id;
+    return this;
+  }
+  withShortName(shortName) {
+    this.config.app.shortName = shortName;
+    return this;
+  }
+  withDescription(description) {
+    this.config.app.description = description;
+    return this;
+  }
+  withVersion(version) {
+    this.config.app.version = version;
+    return this;
+  }
+  withLogo(logo) {
+    this.config.app.logo = logo;
+    return this;
+  }
+  withAuthor(author) {
+    this.config.app.author = author;
+    return this;
+  }
+  withHomepage(homepage) {
+    this.config.app.homepage = homepage;
+    return this;
+  }
+  // Build Config Methods
+  withPort(port) {
+    this.config.build.port = port;
+    return this;
+  }
+  withPreviewPort(previewPort) {
+    this.config.build.previewPort = previewPort;
+    return this;
+  }
+  withOutputDir(outputDir) {
+    this.config.build.outputDir = outputDir;
+    return this;
+  }
+  withPublicPath(publicPath) {
+    this.config.build.publicPath = publicPath;
+    return this;
+  }
+  withBase(base) {
+    this.config.build.base = base;
+    return this;
+  }
+  // PWA Config Methods
+  withThemeColor(themeColor) {
+    this.config.pwa.themeColor = themeColor;
+    return this;
+  }
+  withBackgroundColor(backgroundColor) {
+    this.config.pwa.backgroundColor = backgroundColor;
+    return this;
+  }
+  withStartUrl(startUrl) {
+    this.config.pwa.startUrl = startUrl;
+    return this;
+  }
+  withScope(scope) {
+    this.config.pwa.scope = scope;
+    return this;
+  }
+  withDisplay(display) {
+    this.config.pwa.display = display;
+    return this;
+  }
+  withOrientation(orientation) {
+    this.config.pwa.orientation = orientation;
+    return this;
+  }
+  // UI Config Methods
+  withDefaultTheme(defaultTheme) {
+    this.config.ui.defaultTheme = defaultTheme;
+    return this;
+  }
+  withDefaultPalette(defaultPalette) {
+    this.config.ui.defaultPalette = defaultPalette;
+    return this;
+  }
+  withScaffolding(enableScaffolding) {
+    this.config.ui.enableScaffolding = enableScaffolding;
+    return this;
+  }
+  withThemeSwitcher(showThemeSwitcher) {
+    this.config.ui.showThemeSwitcher = showThemeSwitcher;
+    return this;
+  }
+  withPaletteSwitcher(showPaletteSwitcher) {
+    this.config.ui.showPaletteSwitcher = showPaletteSwitcher;
+    return this;
+  }
+  // Copyright Methods
+  withCopyright(year, author, text) {
+    this.config.copyright.year = year;
+    this.config.copyright.author = author;
+    if (text !== undefined) this.config.copyright.text = text;
+    return this;
+  }
+  withCopyrightYear(year) {
+    this.config.copyright.year = year;
+    return this;
+  }
+  withCopyrightAuthor(author) {
+    this.config.copyright.author = author;
+    return this;
+  }
+  withCopyrightText(text) {
+    this.config.copyright.text = text;
+    return this;
+  }
+  /**
+   * Build and validate the configuration
+   */
+  build() {
+    const validation = this.validate();
+    // Print warnings
+    validation.warnings.forEach(warning => {
+      console.warn(`⚠️  AppConfig: ${warning}`);
+    });
+    // Throw on errors
+    if (!validation.isValid) {
+      throw new Error(`AppConfig validation failed:\n${validation.errors.map(e => `  - ${e}`).join('\n')}`);
+    }
+    // Apply defaults and build
+    const completeConfig = this.applyDefaults();
+    return new AppConfig(completeConfig);
+  }
+  /**
+   * Validate the current configuration
+   */
+  validate() {
+    const warnings = [];
+    const errors = [];
+    // Required fields validation
+    if (!this.config.app.name) errors.push('App name is required');
+    if (!this.config.app.id) errors.push('App ID is required');
+    // Copyright validation - author will be defaulted if not provided
+    if (this.config.copyright.year && this.config.copyright.year !== 'auto' && (!Number.isInteger(this.config.copyright.year) || this.config.copyright.year < 1900)) {
+      warnings.push('Copyright year should be "auto" or a valid year >= 1900');
+    }
+    // Logo file validation (warning only) - only in Node.js environment
+    if (this.config.app.logo && !this.options.skipValidation && fs && path) {
+      const logoPath = path.resolve(this.options.baseDir || process.cwd(), this.config.app.logo);
+      if (!fs.existsSync(logoPath)) {
+        warnings.push(`Logo file not found: ${this.config.app.logo} (will use default)`);
+      }
+    }
+    // Port validation
+    if (this.config.build.port !== undefined) {
+      if (!Number.isInteger(this.config.build.port) || this.config.build.port < 1 || this.config.build.port > 65535) {
+        errors.push('Port must be a valid integer between 1 and 65535');
+      }
+    }
+    if (this.config.build.previewPort !== undefined) {
+      if (!Number.isInteger(this.config.build.previewPort) || this.config.build.previewPort < 1 || this.config.build.previewPort > 65535) {
+        errors.push('Preview port must be a valid integer between 1 and 65535');
+      }
+    }
+    // Color validation (warnings only)
+    if (this.config.pwa.themeColor && !this.isValidColor(this.config.pwa.themeColor)) {
+      warnings.push(`Theme color may not be valid: ${this.config.pwa.themeColor}`);
+    }
+    if (this.config.pwa.backgroundColor && !this.isValidColor(this.config.pwa.backgroundColor)) {
+      warnings.push(`Background color may not be valid: ${this.config.pwa.backgroundColor}`);
+    }
+    return {
+      warnings,
+      errors,
+      isValid: errors.length === 0
+    };
+  }
+  /**
+   * Apply default values to configuration
+   */
+  applyDefaults() {
+    const app = {
+      id: this.config.app.id,
+      name: this.config.app.name,
+      shortName: this.config.app.shortName || this.config.app.name,
+      description: this.config.app.description || this.config.app.name,
+      version: this.config.app.version || '1.0.0',
+      logo: this.config.app.logo || '/favicon.ico',
+      author: this.config.app.author,
+      homepage: this.config.app.homepage
+    };
+    const build = {
+      port: this.config.build.port || 3000,
+      previewPort: this.config.build.previewPort || 4173,
+      outputDir: this.config.build.outputDir || 'dist',
+      publicPath: this.config.build.publicPath || '/',
+      base: this.config.build.base || '/'
+    };
+    const pwa = {
+      themeColor: this.config.pwa.themeColor || '#000000',
+      backgroundColor: this.config.pwa.backgroundColor || '#ffffff',
+      startUrl: this.config.pwa.startUrl || '/',
+      scope: this.config.pwa.scope || '/',
+      display: this.config.pwa.display || 'standalone',
+      orientation: this.config.pwa.orientation
+    };
+    const ui = {
+      defaultTheme: this.config.ui.defaultTheme || 'light',
+      defaultPalette: this.config.ui.defaultPalette || 'default',
+      enableScaffolding: this.config.ui.enableScaffolding ?? true,
+      showThemeSwitcher: this.config.ui.showThemeSwitcher ?? false,
+      showPaletteSwitcher: this.config.ui.showPaletteSwitcher ?? false
+    };
+    const copyright = {
+      year: this.config.copyright.year || 'auto',
+      author: this.config.copyright.author || app.author || app.name,
+      text: this.config.copyright.text
+    };
+    return {
+      app,
+      build,
+      pwa,
+      ui,
+      copyright
+    };
+  }
+  /**
+   * Simple color validation
+   */
+  isValidColor(color) {
+    // Basic hex color validation
+    return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color) ||
+    // Named colors (basic check)
+    /^(black|white|red|green|blue|yellow|orange|purple|pink|gray|grey)$/i.test(color) ||
+    // RGB/RGBA
+    /^rgba?\([^)]+\)$/i.test(color);
+  }
+}
+
+/**
+ * QwickApps Configuration Module Entry
+ *
+ * Lightweight export for config-only usage at build time.
+ * This file only exports configuration types and builders
+ * without pulling in React or MUI dependencies.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+const createAppConfig = AppConfigBuilder.create;
+
+export { AppConfig, AppConfigBuilder, createAppConfig };