@qwickapps/react-framework 1.3.5 → 1.4.0

package/dist/config.js

@@ -0,0 +1,455 @@
+'use strict';
+
+/**
+ * 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;
+
+exports.AppConfig = AppConfig;
+exports.AppConfigBuilder = AppConfigBuilder;
+exports.createAppConfig = createAppConfig;

package/dist/contexts/PrintModeContext.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PrintModeContext - App-level print state management
+ *
+ * Handles print mode state transitions at the application level,
+ * allowing pages to simply consume and react to print state changes.
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import React from 'react';
+import { PrintConfigSchema } from '../schemas/PrintConfigSchema';
+export type PrintModeStateType = 'normal' | 'applying_print_config' | 'entering_print_mode' | 'view_loading' | 'config_applied' | 'print_mode' | 'exiting_print_mode' | 'restoring_config';
+interface PrintModeContextValue {
+    printModeState: PrintModeStateType;
+    isPrintMode: boolean;
+    printConfig: PrintConfigSchema;
+    triggerPrint: (config?: Partial<PrintConfigSchema>) => void;
+    exitPrintMode: () => void;
+    onViewLoading: () => void;
+    onViewReady: () => void;
+}
+export declare const usePrintMode: () => PrintModeContextValue;
+interface PrintModeProviderProps {
+    children: React.ReactNode;
+}
+export declare const PrintModeProvider: React.FC<PrintModeProviderProps>;
+export {};
+//# sourceMappingURL=PrintModeContext.d.ts.map

package/dist/contexts/PrintModeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PrintModeContext.d.ts","sourceRoot":"","sources":["../../src/contexts/PrintModeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAwE,MAAM,OAAO,CAAC;AAI7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,uBAAuB,GACvB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,CAAC;AAkGvB,UAAU,qBAAqB;IAE7B,cAAc,EAAE,kBAAkB,CAAC;IACnC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAG/B,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC5D,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAID,eAAO,MAAM,YAAY,QAAO,qBAM/B,CAAC;AAEF,UAAU,sBAAsB;IAC9B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAuL9D,CAAC"}

package/dist/contexts/QwickAppContext.d.ts

@@ -10,8 +10,8 @@ import React from 'react';
 import type { MenuItem } from '../components/menu';
 import type { ScaffoldProps } from '../components/Scaffold';
 export interface QwickAppProps {
-    /** Application name displayed in header/title */
-    appName: string;
+    /** Application name displayed in header/title (optional when config is provided) */
+    appName?: string;
     /** Custom logo component - overrides the default logo */
     logo?: React.ReactNode;
     /** App identifier used for storage keys */

package/dist/contexts/QwickAppContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QwickAppContext.d.ts","sourceRoot":"","sources":["../../src/contexts/QwickAppContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9B,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC,CAAC,KAAK,IAAI,CAAC;CAE1M;AAED,QAAA,MAAM,eAAe,qCAYnB,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAM,WAAW,QAAO,oBAM9B,CAAC"}
+{"version":3,"file":"QwickAppContext.d.ts","sourceRoot":"","sources":["../../src/contexts/QwickAppContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9B,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC3C,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,QAAQ,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9B,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,eAAe,EAAE,QAAQ,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,8BAA8B;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,yEAAyE;IACzE,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC,CAAC,KAAK,IAAI,CAAC;CAE1M;AAED,QAAA,MAAM,eAAe,qCAYnB,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,eAAO,MAAM,WAAW,QAAO,oBAM9B,CAAC"}

package/dist/contexts/index.d.ts

@@ -6,4 +6,6 @@ export { PaletteProvider, usePalette } from './PaletteContext';
 export type { PaletteConfig, PaletteContextValue } from './PaletteContext';
 export { ThemeProvider, useTheme } from './ThemeContext';
 export type { ActualThemeMode, ThemeContextValue, ThemeMode } from './ThemeContext';
+export { PrintModeProvider, usePrintMode } from './PrintModeContext';
+export type { PrintModeStateType } from './PrintModeContext';
 //# sourceMappingURL=index.d.ts.map

package/dist/contexts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9H,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.d.ts

@@ -7,4 +7,6 @@ export { useBaseProps } from './useBaseProps';
 export type { BaseComponentProps, WithBaseProps } from './useBaseProps';
 export { useDataBinding } from './useDataBinding';
 export { QWICKAPP_COMPONENT } from './useBaseProps';
+export { usePrintMode as usePrintModeHook } from './usePrintMode';
+export type { PrintModeState } from './usePrintMode';
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGpD,OAAO,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/hooks/usePrintMode.d.ts

@@ -0,0 +1,39 @@
+/**
+ * usePrintMode hook - Simple wrapper around PrintModeContext
+ *
+ * @deprecated Use usePrintMode from PrintModeContext directly
+ * This file maintained for backward compatibility during migration
+ *
+ * Copyright (c) 2025 QwickApps.com. All rights reserved.
+ */
+import { PrintConfigSchema } from '../schemas/PrintConfigSchema';
+export type PrintModeStateType = 'normal' | 'applying_print_config' | 'entering_print_mode' | 'view_loading' | 'config_applied' | 'print_mode' | 'exiting_print_mode' | 'restoring_config';
+export interface PrintModeState {
+    /** Whether the app is currently in print mode */
+    isPrintMode: boolean;
+    /** Print configuration to apply */
+    printConfig: PrintConfigSchema;
+    /** Current state of the print mode state machine */
+    printModeState: PrintModeStateType;
+    /** Manually enter print mode */
+    enterPrintMode: (config?: Partial<PrintConfigSchema>) => void;
+    /** Exit print mode */
+    exitPrintMode: () => void;
+    /** Toggle print mode */
+    togglePrintMode: (config?: Partial<PrintConfigSchema>) => void;
+    /** Enter print mode and trigger print dialog */
+    triggerPrint: (config?: Partial<PrintConfigSchema>) => void;
+    /** Callback to signal current view is loading */
+    onViewLoading: () => void;
+    /** Callback to signal current view is ready */
+    onViewReady: () => void;
+}
+/**
+ * Hook to access print mode state from app-level context
+ *
+ * @param initialConfig - Initial print configuration (ignored, use context provider config)
+ * @returns Print mode state and controls
+ */
+export declare function usePrintMode(initialConfig?: Partial<PrintConfigSchema>): PrintModeState;
+export default usePrintMode;
+//# sourceMappingURL=usePrintMode.d.ts.map

package/dist/hooks/usePrintMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePrintMode.d.ts","sourceRoot":"","sources":["../../src/hooks/usePrintMode.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,uBAAuB,GACvB,qBAAqB,GACrB,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IACrB,mCAAmC;IACnC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,oDAAoD;IACpD,cAAc,EAAE,kBAAkB,CAAC;IACnC,gCAAgC;IAChC,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC9D,sBAAsB;IACtB,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,wBAAwB;IACxB,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC/D,gDAAgD;IAChD,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IAC5D,iDAAiD;IACjD,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,cAAc,CAqBvF;AAED,eAAe,YAAY,CAAC"}