@djangocfg/nextjs 2.1.514 → 2.1.516

package/dist/pwa/index.d.mts

@@ -1,195 +1,3 @@
-import { MetadataRoute, Metadata, Viewport } from 'next';
+export { IconPaths, ManifestConfig, ProtocolHandler, ScreenshotConfig, SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest } from './manifest.mjs';
 export { P as PWAPluginOptions, c as createApiCacheRule, a as createCdnCacheRule, b as createStaticAssetRule, d as defaultRuntimeCaching, g as getServiceWorkerTemplate, w as withPWA } from '../plugin-DdmK3zAE.mjs';
-
-/**
- * PWA Manifest Metadata Utilities
- *
- * Helper functions for creating Next.js metadata for PWA manifest
- */
-
-interface ManifestConfig {
-    name: string;
-    shortName?: string;
-    description?: string;
-    themeColor?: string;
-    backgroundColor?: string;
-    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
-    orientation?: 'portrait' | 'landscape' | 'any';
-    startUrl?: string;
-    scope?: string;
-    lang?: string;
-    dir?: 'ltr' | 'rtl' | 'auto';
-    icons?: {
-        src: string;
-        sizes: string;
-        type?: string;
-        purpose?: string;
-    }[];
-}
-/**
- * Icon paths configuration
- */
-interface IconPaths {
-    logo192?: string;
-    logo384?: string;
-    logo512?: string;
-}
-/**
- * Protocol handler configuration
- * Allows your PWA to register as a handler for custom protocols
- *
- * @example
- * ```typescript
- * {
- *   protocol: "web+music",
- *   url: "/play?track=%s"
- * }
- * ```
- */
-interface ProtocolHandler {
-    /** Protocol scheme (e.g., "web+music", "mailto", "magnet") */
-    protocol: string;
-    /** URL template with %s placeholder for the protocol parameter */
-    url: string;
-}
-/**
- * Create viewport configuration for Next.js app
- *
- * @example
- * ```typescript
- * export const viewport: Viewport = createViewport({
- *   themeColor: '#ffffff',
- * });
- * ```
- */
-declare function createViewport(config: {
-    themeColor?: string;
-}): Viewport;
-/**
- * Create manifest metadata for Next.js app
- *
- * Note: themeColor and viewport should be exported separately using createViewport()
- *
- * @example
- * ```typescript
- * export const metadata: Metadata = {
- *   ...createManifestMetadata({
- *     name: 'My App',
- *     shortName: 'App',
- *     description: 'My awesome app',
- *   }),
- * };
- *
- * export const viewport: Viewport = createViewport({
- *   themeColor: '#ffffff',
- * });
- * ```
- */
-declare function createManifestMetadata(config: ManifestConfig): Metadata;
-/**
- * Create Next.js manifest function
- *
- * Use this in your app/manifest.ts file
- *
- * @example
- * ```typescript
- * // app/manifest.ts
- * import { createManifest } from '@djangocfg/nextjs/config';
- * import { settings } from '@core/settings';
- *
- * export default createManifest({
- *   name: settings.app.name,
- *   description: settings.app.description,
- *   icons: {
- *     logo192: settings.app.icons.logo192,
- *     logo384: settings.app.icons.logo384,
- *     logo512: settings.app.icons.logo512,
- *   },
- * });
- * ```
- */
-interface ScreenshotConfig {
-    src: string;
-    sizes: string;
-    type?: string;
-    form_factor?: 'narrow' | 'wide';
-    label?: string;
-}
-/**
- * Smart screenshot configuration
- * Automatically detects everything from path or uses defaults
- */
-interface SmartScreenshotInput {
-    src: string;
-    /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */
-    form_factor?: 'narrow' | 'wide';
-    /** Optional label (auto-generated from form_factor) */
-    label?: string;
-    /** Optional width (defaults based on form_factor) */
-    width?: number;
-    /** Optional height (defaults based on form_factor) */
-    height?: number;
-}
-/**
- * Create screenshot config with smart defaults
- * Automatically detects type, sizes, form_factor from path or uses sensible defaults
- *
- * @example
- * ```typescript
- * // Minimal - everything auto-detected
- * createScreenshot({ src: '/screenshots/desktop-view.png' })
- * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'
- *
- * createScreenshot({ src: '/screenshots/mobile.png' })
- * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'
- *
- * // With custom dimensions
- * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })
- * ```
- */
-declare function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig;
-/**
- * Create multiple screenshots from array
- * Supports string shorthand or full config objects
- *
- * @example
- * ```typescript
- * // Minimal - just paths
- * createScreenshots([
- *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080
- *   '/screenshots/mobile.png',   // Auto: narrow, 390x844
- * ])
- *
- * // Mixed
- * createScreenshots([
- *   '/screenshots/desktop.png',
- *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },
- * ])
- * ```
- */
-declare function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[];
-declare function createManifest(config: {
-    name: string;
-    shortName?: string;
-    description?: string;
-    themeColor?: string;
-    backgroundColor?: string;
-    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
-    orientation?: 'portrait' | 'landscape' | 'any';
-    id?: string;
-    startUrl?: string;
-    scope?: string;
-    lang?: string;
-    dir?: 'ltr' | 'rtl' | 'auto';
-    icons?: IconPaths | ManifestConfig['icons'];
-    screenshots?: ScreenshotConfig[];
-    protocol_handlers?: ProtocolHandler[];
-}): () => MetadataRoute.Manifest;
-/**
- * Generate manifest.json content (legacy)
- *
- * @deprecated Use createManifest() instead
- */
-declare function generateManifest(config: ManifestConfig): Record<string, any>;
-
-export { type IconPaths, type ManifestConfig, type ProtocolHandler, type ScreenshotConfig, type SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest };
+import 'next';

package/dist/pwa/index.mjs

@@ -1,10 +1,3 @@
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/pwa/manifest.ts
 function createViewport(config) {
   return {
@@ -135,6 +128,8 @@ function generateManifest(config) {
 
 // src/pwa/plugin.ts
 import { consola } from "consola";
+import { createRequire } from "module";
+var requirePeer = createRequire(import.meta.url);
 function withPWA(nextConfig, options = {}) {
   const isDev = process.env.NODE_ENV === "development";
   const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === "true";
@@ -151,7 +146,7 @@ function withPWA(nextConfig, options = {}) {
     if (!process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING) {
       process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING = "1";
     }
-    const withSerwistInit = __require("@serwist/next").default;
+    const withSerwistInit = requirePeer("@serwist/next").default;
     const withSerwist = withSerwistInit({
       swSrc: defaultOptions.swSrc,
       swDest: defaultOptions.swDest,

package/dist/pwa/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pwa/manifest.ts","../../src/pwa/plugin.ts"],"sourcesContent":["/**\n * PWA Manifest Metadata Utilities\n *\n * Helper functions for creating Next.js metadata for PWA manifest\n */\n\nimport type { Metadata, MetadataRoute, Viewport } from 'next';\n\nexport interface ManifestConfig {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: {\n    src: string;\n    sizes: string;\n    type?: string;\n    purpose?: string;\n  }[];\n}\n\n/**\n * Icon paths configuration\n */\nexport interface IconPaths {\n  logo192?: string;\n  logo384?: string;\n  logo512?: string;\n}\n\n/**\n * Protocol handler configuration\n * Allows your PWA to register as a handler for custom protocols\n *\n * @example\n * ```typescript\n * {\n *   protocol: \"web+music\",\n *   url: \"/play?track=%s\"\n * }\n * ```\n */\nexport interface ProtocolHandler {\n  /** Protocol scheme (e.g., \"web+music\", \"mailto\", \"magnet\") */\n  protocol: string;\n  /** URL template with %s placeholder for the protocol parameter */\n  url: string;\n}\n\n/**\n * Create viewport configuration for Next.js app\n *\n * @example\n * ```typescript\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createViewport(config: { themeColor?: string }): Viewport {\n  return {\n    width: 'device-width',\n    initialScale: 1,\n    maximumScale: 1,\n    themeColor: config.themeColor || '#000000',\n  };\n}\n\n/**\n * Create manifest metadata for Next.js app\n *\n * Note: themeColor and viewport should be exported separately using createViewport()\n *\n * @example\n * ```typescript\n * export const metadata: Metadata = {\n *   ...createManifestMetadata({\n *     name: 'My App',\n *     shortName: 'App',\n *     description: 'My awesome app',\n *   }),\n * };\n *\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createManifestMetadata(config: ManifestConfig): Metadata {\n  return {\n    manifest: '/manifest.json',\n    appleWebApp: {\n      capable: true,\n      statusBarStyle: 'default',\n      title: config.shortName || config.name,\n    },\n    applicationName: config.name,\n    formatDetection: {\n      telephone: false,\n    },\n  };\n}\n\n/**\n * Create Next.js manifest function\n *\n * Use this in your app/manifest.ts file\n *\n * @example\n * ```typescript\n * // app/manifest.ts\n * import { createManifest } from '@djangocfg/nextjs/config';\n * import { settings } from '@core/settings';\n *\n * export default createManifest({\n *   name: settings.app.name,\n *   description: settings.app.description,\n *   icons: {\n *     logo192: settings.app.icons.logo192,\n *     logo384: settings.app.icons.logo384,\n *     logo512: settings.app.icons.logo512,\n *   },\n * });\n * ```\n */\nexport interface ScreenshotConfig {\n  src: string;\n  sizes: string;\n  type?: string;\n  form_factor?: 'narrow' | 'wide';\n  label?: string;\n}\n\n/**\n * Smart screenshot configuration\n * Automatically detects everything from path or uses defaults\n */\nexport interface SmartScreenshotInput {\n  src: string;\n  /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */\n  form_factor?: 'narrow' | 'wide';\n  /** Optional label (auto-generated from form_factor) */\n  label?: string;\n  /** Optional width (defaults based on form_factor) */\n  width?: number;\n  /** Optional height (defaults based on form_factor) */\n  height?: number;\n}\n\n/**\n * Create screenshot config with smart defaults\n * Automatically detects type, sizes, form_factor from path or uses sensible defaults\n *\n * @example\n * ```typescript\n * // Minimal - everything auto-detected\n * createScreenshot({ src: '/screenshots/desktop-view.png' })\n * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'\n *\n * createScreenshot({ src: '/screenshots/mobile.png' })\n * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'\n *\n * // With custom dimensions\n * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })\n * ```\n */\nexport function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig {\n  // Allow string shorthand\n  const config = typeof input === 'string' ? { src: input } : input;\n  let { src, width, height, label, form_factor } = config;\n\n  // Auto-detect image type from extension\n  const ext = src.split('.').pop()?.toLowerCase();\n  const typeMap: Record<string, string> = {\n    png: 'image/png',\n    jpg: 'image/jpeg',\n    jpeg: 'image/jpeg',\n    webp: 'image/webp',\n    svg: 'image/svg+xml',\n  };\n  const type = ext ? typeMap[ext] || 'image/png' : 'image/png';\n\n  // Try to parse dimensions from filename (e.g., \"1920x1080.png\" or \"screenshot-390x844.png\")\n  const filename = src.toLowerCase();\n  const dimensionMatch = filename.match(/(\\d{3,4})x(\\d{3,4})/);\n  if (dimensionMatch && !width && !height) {\n    width = parseInt(dimensionMatch[1], 10);\n    height = parseInt(dimensionMatch[2], 10);\n  }\n\n  // Auto-detect form_factor from filename if not provided\n  let autoFormFactor: 'narrow' | 'wide' = 'wide'; // Default to wide\n  if (filename.includes('mobile') || filename.includes('phone') || filename.includes('narrow')) {\n    autoFormFactor = 'narrow';\n  } else if (filename.includes('desktop') || filename.includes('laptop') || filename.includes('wide')) {\n    autoFormFactor = 'wide';\n  } else if (width && height) {\n    // Calculate from dimensions if provided or parsed\n    const aspectRatio = width / height;\n    autoFormFactor = aspectRatio > 1.2 ? 'wide' : 'narrow';\n  }\n\n  const finalFormFactor = form_factor || autoFormFactor;\n\n  // Default dimensions based on form_factor (only if not parsed from filename)\n  const defaultDimensions = finalFormFactor === 'wide'\n    ? { width: 1920, height: 1080 } // Desktop default\n    : { width: 390, height: 844 };  // Mobile default (iPhone 14)\n\n  const finalWidth = width || defaultDimensions.width;\n  const finalHeight = height || defaultDimensions.height;\n\n  // Auto-generate label\n  const autoLabel = finalFormFactor === 'wide'\n    ? 'Desktop screenshot'\n    : 'Mobile screenshot';\n\n  return {\n    src,\n    sizes: `${finalWidth}x${finalHeight}`,\n    type,\n    form_factor: finalFormFactor,\n    label: label || autoLabel,\n  };\n}\n\n/**\n * Create multiple screenshots from array\n * Supports string shorthand or full config objects\n *\n * @example\n * ```typescript\n * // Minimal - just paths\n * createScreenshots([\n *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080\n *   '/screenshots/mobile.png',   // Auto: narrow, 390x844\n * ])\n *\n * // Mixed\n * createScreenshots([\n *   '/screenshots/desktop.png',\n *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },\n * ])\n * ```\n */\nexport function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[] {\n  return inputs.map(createScreenshot);\n}\n\nexport function createManifest(config: {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  id?: string;\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: IconPaths | ManifestConfig['icons'];\n  screenshots?: ScreenshotConfig[];\n  protocol_handlers?: ProtocolHandler[];\n}): () => MetadataRoute.Manifest {\n  return () => {\n    // Convert IconPaths to manifest icons format\n    let manifestIcons: MetadataRoute.Manifest['icons'];\n\n    if (Array.isArray(config.icons)) {\n      // Already in manifest format\n      manifestIcons = config.icons as MetadataRoute.Manifest['icons'];\n    } else if (config.icons) {\n      // Convert IconPaths to manifest icons\n      const { logo192, logo384, logo512 } = config.icons as IconPaths;\n      manifestIcons = [\n        ...(logo192\n          ? [\n              {\n                src: logo192,\n                sizes: '192x192',\n                type: 'image/png',\n                purpose: 'maskable' as const,\n              },\n            ]\n          : []),\n        ...(logo384\n          ? [\n              {\n                src: logo384,\n                sizes: '384x384',\n                type: 'image/png',\n              },\n            ]\n          : []),\n        ...(logo512\n          ? [\n              {\n                src: logo512,\n                sizes: '512x512',\n                type: 'image/png',\n              },\n            ]\n          : []),\n      ];\n    }\n\n    const manifest: MetadataRoute.Manifest = {\n      name: config.name,\n      short_name: config.shortName || config.name,\n      description: config.description || config.name,\n      id: config.id || config.startUrl || '/',\n      start_url: config.startUrl || '/',\n      scope: config.scope || '/',\n      display: config.display || 'standalone',\n      orientation: config.orientation || 'portrait',\n      background_color: config.backgroundColor || '#000000',\n      theme_color: config.themeColor || '#ffffff',\n      lang: config.lang || 'en',\n      dir: config.dir || 'ltr',\n      icons: manifestIcons,\n      // Removed forced gcm_sender_id to avoid potential conflicts with VAPID\n      // gcm_sender_id: '103953800507',\n    };\n\n    // Add screenshots if provided (for Richer PWA Install UI)\n    if (config.screenshots && config.screenshots.length > 0) {\n      (manifest as any).screenshots = config.screenshots;\n    }\n\n    // Add protocol handlers if provided\n    if (config.protocol_handlers && config.protocol_handlers.length > 0) {\n      (manifest as any).protocol_handlers = config.protocol_handlers;\n    }\n\n    return manifest;\n  };\n}\n\n/**\n * Generate manifest.json content (legacy)\n *\n * @deprecated Use createManifest() instead\n */\nexport function generateManifest(config: ManifestConfig): Record<string, any> {\n  return createManifest(config)();\n}\n","/**\n * PWA (Progressive Web App) Plugin\n *\n * Configures Serwist for service worker and offline support\n * Modern PWA solution for Next.js 15+ with App Router\n *\n * @see https://serwist.pages.dev/\n */\n\nimport type { NextConfig } from 'next';\nimport { consola } from 'consola';\n\nexport interface PWAPluginOptions {\n  /**\n   * Destination directory for service worker files\n   * @default 'public'\n   * @deprecated Use swDest instead\n   */\n  dest?: string;\n\n  /**\n   * Path to service worker source file (relative to project root)\n   * @default 'app/sw.ts'\n   */\n  swSrc?: string;\n\n  /**\n   * Destination for compiled service worker\n   * @default 'public/sw.js'\n   */\n  swDest?: string;\n\n  /**\n   * Disable PWA completely\n   * @default false in production, true in development\n   * @example disable: process.env.NODE_ENV === 'development'\n   */\n  disable?: boolean;\n\n  /**\n   * Cache on navigation - cache pages when navigating\n   * @default true\n   */\n  cacheOnNavigation?: boolean;\n\n  /**\n   * Reload app when device goes back online\n   * @default true\n   */\n  reloadOnOnline?: boolean;\n\n  /**\n   * Additional Serwist options\n   * @see https://serwist.pages.dev/docs/next/configuring\n   */\n  serwistOptions?: Record<string, any>;\n}\n\n/**\n * Add PWA configuration to Next.js config using Serwist\n *\n * @example Basic usage\n * ```ts\n * import { createBaseNextConfig, withPWA } from '@djangocfg/nextjs/config';\n *\n * const nextConfig = createBaseNextConfig({...});\n *\n * export default withPWA(nextConfig, {\n *   swSrc: 'app/sw.ts',\n *   disable: process.env.NODE_ENV === 'development',\n * });\n * ```\n *\n * @example Integrated with createBaseNextConfig\n * ```ts\n * import { createBaseNextConfig } from '@djangocfg/nextjs/config';\n *\n * const config = createBaseNextConfig({\n *   pwa: {\n *     swSrc: 'app/sw.ts',\n *     disable: false,\n *   },\n * });\n *\n * export default config;\n * ```\n */\nexport function withPWA(\n  nextConfig: NextConfig,\n  options: PWAPluginOptions = {}\n): NextConfig {\n  const isDev = process.env.NODE_ENV === 'development';\n  const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';\n\n  // Determine if PWA should be disabled:\n  // - Explicitly disabled via options\n  // - In development mode (default)\n  // - Static build (output: 'export' doesn't support service workers)\n  const shouldDisable = options.disable !== undefined\n    ? options.disable\n    : (isDev || isStaticBuild);\n\n  const defaultOptions: PWAPluginOptions = {\n    swSrc: 'app/sw.ts',\n    swDest: 'public/sw.js',\n    disable: shouldDisable,\n    cacheOnNavigation: true,\n    reloadOnOnline: true,\n    ...options,\n  };\n\n  try {\n    // Suppress Turbopack warning - it only applies to dev mode, not production builds\n    // The warning is misleading when running `next build` with Turbopack\n    // See: https://github.com/serwist/serwist/issues/54\n    if (!process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING) {\n      process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING = '1';\n    }\n\n    const withSerwistInit = require('@serwist/next').default;\n\n    const withSerwist = withSerwistInit({\n      swSrc: defaultOptions.swSrc,\n      swDest: defaultOptions.swDest,\n      disable: defaultOptions.disable,\n      cacheOnNavigation: defaultOptions.cacheOnNavigation,\n      reloadOnOnline: defaultOptions.reloadOnOnline,\n      ...defaultOptions.serwistOptions,\n    });\n\n    return withSerwist(nextConfig);\n  } catch (error) {\n    consola.error('Failed to configure Serwist:', error);\n    return nextConfig;\n  }\n}\n\n/**\n * Get service worker template content\n *\n * Returns ready-to-use service worker code for app/sw.ts\n *\n * @example\n * ```ts\n * import { getServiceWorkerTemplate } from '@djangocfg/nextjs/config';\n *\n * // Copy this to your app/sw.ts file\n * console.log(getServiceWorkerTemplate());\n * ```\n */\nexport function getServiceWorkerTemplate(): string {\n  return `/**\n * Service Worker (Serwist)\n *\n * Modern PWA service worker using Serwist\n */\n\nimport { defaultCache } from '@serwist/next/worker';\nimport { Serwist } from 'serwist';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ndeclare const self: any;\n\nconst serwist = new Serwist({\n  // Precache entries injected by Serwist build plugin\n  precacheEntries: self.__SW_MANIFEST,\n\n  // Skip waiting - activate new SW immediately\n  skipWaiting: true,\n\n  // Take control of all clients immediately\n  clientsClaim: true,\n\n  // Enable navigation preload for faster loads\n  navigationPreload: true,\n\n  // Use default Next.js runtime caching strategies\n  runtimeCaching: defaultCache,\n\n  // Fallback pages for offline\n  fallbacks: {\n    entries: [\n      {\n        url: '/_offline',\n        matcher({ request }) {\n          return request.destination === 'document';\n        },\n      },\n    ],\n  },\n});\n\nserwist.addEventListeners();\n`;\n}\n\n// Backward compatibility exports (deprecated)\nexport const defaultRuntimeCaching = [];\nexport function createApiCacheRule() {\n  consola.warn('createApiCacheRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\nexport function createStaticAssetRule() {\n  consola.warn('createStaticAssetRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\nexport function createCdnCacheRule() {\n  consola.warn('createCdnCacheRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pwa/manifest.ts","../../src/pwa/plugin.ts"],"sourcesContent":["/**\n * PWA Manifest Metadata Utilities\n *\n * Helper functions for creating Next.js metadata for PWA manifest\n */\n\nimport type { Metadata, MetadataRoute, Viewport } from 'next';\n\nexport interface ManifestConfig {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: {\n    src: string;\n    sizes: string;\n    type?: string;\n    purpose?: string;\n  }[];\n}\n\n/**\n * Icon paths configuration\n */\nexport interface IconPaths {\n  logo192?: string;\n  logo384?: string;\n  logo512?: string;\n}\n\n/**\n * Protocol handler configuration\n * Allows your PWA to register as a handler for custom protocols\n *\n * @example\n * ```typescript\n * {\n *   protocol: \"web+music\",\n *   url: \"/play?track=%s\"\n * }\n * ```\n */\nexport interface ProtocolHandler {\n  /** Protocol scheme (e.g., \"web+music\", \"mailto\", \"magnet\") */\n  protocol: string;\n  /** URL template with %s placeholder for the protocol parameter */\n  url: string;\n}\n\n/**\n * Create viewport configuration for Next.js app\n *\n * @example\n * ```typescript\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createViewport(config: { themeColor?: string }): Viewport {\n  return {\n    width: 'device-width',\n    initialScale: 1,\n    maximumScale: 1,\n    themeColor: config.themeColor || '#000000',\n  };\n}\n\n/**\n * Create manifest metadata for Next.js app\n *\n * Note: themeColor and viewport should be exported separately using createViewport()\n *\n * @example\n * ```typescript\n * export const metadata: Metadata = {\n *   ...createManifestMetadata({\n *     name: 'My App',\n *     shortName: 'App',\n *     description: 'My awesome app',\n *   }),\n * };\n *\n * export const viewport: Viewport = createViewport({\n *   themeColor: '#ffffff',\n * });\n * ```\n */\nexport function createManifestMetadata(config: ManifestConfig): Metadata {\n  return {\n    manifest: '/manifest.json',\n    appleWebApp: {\n      capable: true,\n      statusBarStyle: 'default',\n      title: config.shortName || config.name,\n    },\n    applicationName: config.name,\n    formatDetection: {\n      telephone: false,\n    },\n  };\n}\n\n/**\n * Create Next.js manifest function\n *\n * Use this in your app/manifest.ts file\n *\n * @example\n * ```typescript\n * // app/manifest.ts\n * import { createManifest } from '@djangocfg/nextjs/config';\n * import { settings } from '@core/settings';\n *\n * export default createManifest({\n *   name: settings.app.name,\n *   description: settings.app.description,\n *   icons: {\n *     logo192: settings.app.icons.logo192,\n *     logo384: settings.app.icons.logo384,\n *     logo512: settings.app.icons.logo512,\n *   },\n * });\n * ```\n */\nexport interface ScreenshotConfig {\n  src: string;\n  sizes: string;\n  type?: string;\n  form_factor?: 'narrow' | 'wide';\n  label?: string;\n}\n\n/**\n * Smart screenshot configuration\n * Automatically detects everything from path or uses defaults\n */\nexport interface SmartScreenshotInput {\n  src: string;\n  /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */\n  form_factor?: 'narrow' | 'wide';\n  /** Optional label (auto-generated from form_factor) */\n  label?: string;\n  /** Optional width (defaults based on form_factor) */\n  width?: number;\n  /** Optional height (defaults based on form_factor) */\n  height?: number;\n}\n\n/**\n * Create screenshot config with smart defaults\n * Automatically detects type, sizes, form_factor from path or uses sensible defaults\n *\n * @example\n * ```typescript\n * // Minimal - everything auto-detected\n * createScreenshot({ src: '/screenshots/desktop-view.png' })\n * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'\n *\n * createScreenshot({ src: '/screenshots/mobile.png' })\n * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'\n *\n * // With custom dimensions\n * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })\n * ```\n */\nexport function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig {\n  // Allow string shorthand\n  const config = typeof input === 'string' ? { src: input } : input;\n  let { src, width, height, label, form_factor } = config;\n\n  // Auto-detect image type from extension\n  const ext = src.split('.').pop()?.toLowerCase();\n  const typeMap: Record<string, string> = {\n    png: 'image/png',\n    jpg: 'image/jpeg',\n    jpeg: 'image/jpeg',\n    webp: 'image/webp',\n    svg: 'image/svg+xml',\n  };\n  const type = ext ? typeMap[ext] || 'image/png' : 'image/png';\n\n  // Try to parse dimensions from filename (e.g., \"1920x1080.png\" or \"screenshot-390x844.png\")\n  const filename = src.toLowerCase();\n  const dimensionMatch = filename.match(/(\\d{3,4})x(\\d{3,4})/);\n  if (dimensionMatch && !width && !height) {\n    width = parseInt(dimensionMatch[1], 10);\n    height = parseInt(dimensionMatch[2], 10);\n  }\n\n  // Auto-detect form_factor from filename if not provided\n  let autoFormFactor: 'narrow' | 'wide' = 'wide'; // Default to wide\n  if (filename.includes('mobile') || filename.includes('phone') || filename.includes('narrow')) {\n    autoFormFactor = 'narrow';\n  } else if (filename.includes('desktop') || filename.includes('laptop') || filename.includes('wide')) {\n    autoFormFactor = 'wide';\n  } else if (width && height) {\n    // Calculate from dimensions if provided or parsed\n    const aspectRatio = width / height;\n    autoFormFactor = aspectRatio > 1.2 ? 'wide' : 'narrow';\n  }\n\n  const finalFormFactor = form_factor || autoFormFactor;\n\n  // Default dimensions based on form_factor (only if not parsed from filename)\n  const defaultDimensions = finalFormFactor === 'wide'\n    ? { width: 1920, height: 1080 } // Desktop default\n    : { width: 390, height: 844 };  // Mobile default (iPhone 14)\n\n  const finalWidth = width || defaultDimensions.width;\n  const finalHeight = height || defaultDimensions.height;\n\n  // Auto-generate label\n  const autoLabel = finalFormFactor === 'wide'\n    ? 'Desktop screenshot'\n    : 'Mobile screenshot';\n\n  return {\n    src,\n    sizes: `${finalWidth}x${finalHeight}`,\n    type,\n    form_factor: finalFormFactor,\n    label: label || autoLabel,\n  };\n}\n\n/**\n * Create multiple screenshots from array\n * Supports string shorthand or full config objects\n *\n * @example\n * ```typescript\n * // Minimal - just paths\n * createScreenshots([\n *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080\n *   '/screenshots/mobile.png',   // Auto: narrow, 390x844\n * ])\n *\n * // Mixed\n * createScreenshots([\n *   '/screenshots/desktop.png',\n *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },\n * ])\n * ```\n */\nexport function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[] {\n  return inputs.map(createScreenshot);\n}\n\nexport function createManifest(config: {\n  name: string;\n  shortName?: string;\n  description?: string;\n  themeColor?: string;\n  backgroundColor?: string;\n  display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';\n  orientation?: 'portrait' | 'landscape' | 'any';\n  id?: string;\n  startUrl?: string;\n  scope?: string;\n  lang?: string;\n  dir?: 'ltr' | 'rtl' | 'auto';\n  icons?: IconPaths | ManifestConfig['icons'];\n  screenshots?: ScreenshotConfig[];\n  protocol_handlers?: ProtocolHandler[];\n}): () => MetadataRoute.Manifest {\n  return () => {\n    // Convert IconPaths to manifest icons format\n    let manifestIcons: MetadataRoute.Manifest['icons'];\n\n    if (Array.isArray(config.icons)) {\n      // Already in manifest format\n      manifestIcons = config.icons as MetadataRoute.Manifest['icons'];\n    } else if (config.icons) {\n      // Convert IconPaths to manifest icons\n      const { logo192, logo384, logo512 } = config.icons as IconPaths;\n      manifestIcons = [\n        ...(logo192\n          ? [\n              {\n                src: logo192,\n                sizes: '192x192',\n                type: 'image/png',\n                purpose: 'maskable' as const,\n              },\n            ]\n          : []),\n        ...(logo384\n          ? [\n              {\n                src: logo384,\n                sizes: '384x384',\n                type: 'image/png',\n              },\n            ]\n          : []),\n        ...(logo512\n          ? [\n              {\n                src: logo512,\n                sizes: '512x512',\n                type: 'image/png',\n              },\n            ]\n          : []),\n      ];\n    }\n\n    const manifest: MetadataRoute.Manifest = {\n      name: config.name,\n      short_name: config.shortName || config.name,\n      description: config.description || config.name,\n      id: config.id || config.startUrl || '/',\n      start_url: config.startUrl || '/',\n      scope: config.scope || '/',\n      display: config.display || 'standalone',\n      orientation: config.orientation || 'portrait',\n      background_color: config.backgroundColor || '#000000',\n      theme_color: config.themeColor || '#ffffff',\n      lang: config.lang || 'en',\n      dir: config.dir || 'ltr',\n      icons: manifestIcons,\n      // Removed forced gcm_sender_id to avoid potential conflicts with VAPID\n      // gcm_sender_id: '103953800507',\n    };\n\n    // Add screenshots if provided (for Richer PWA Install UI)\n    if (config.screenshots && config.screenshots.length > 0) {\n      (manifest as any).screenshots = config.screenshots;\n    }\n\n    // Add protocol handlers if provided\n    if (config.protocol_handlers && config.protocol_handlers.length > 0) {\n      (manifest as any).protocol_handlers = config.protocol_handlers;\n    }\n\n    return manifest;\n  };\n}\n\n/**\n * Generate manifest.json content (legacy)\n *\n * @deprecated Use createManifest() instead\n */\nexport function generateManifest(config: ManifestConfig): Record<string, any> {\n  return createManifest(config)();\n}\n","/**\n * PWA (Progressive Web App) Plugin\n *\n * Configures Serwist for service worker and offline support\n * Modern PWA solution for Next.js 15+ with App Router\n *\n * @see https://serwist.pages.dev/\n */\n\nimport type { NextConfig } from 'next';\nimport { consola } from 'consola';\nimport { createRequire } from 'module';\n\n// Serwist is an optional peer loaded synchronously at config time, which\n// `import()` cannot do. `createRequire` is the ESM-safe equivalent of `require`.\nconst requirePeer = createRequire(import.meta.url);\n\nexport interface PWAPluginOptions {\n  /**\n   * Destination directory for service worker files\n   * @default 'public'\n   * @deprecated Use swDest instead\n   */\n  dest?: string;\n\n  /**\n   * Path to service worker source file (relative to project root)\n   * @default 'app/sw.ts'\n   */\n  swSrc?: string;\n\n  /**\n   * Destination for compiled service worker\n   * @default 'public/sw.js'\n   */\n  swDest?: string;\n\n  /**\n   * Disable PWA completely\n   * @default false in production, true in development\n   * @example disable: process.env.NODE_ENV === 'development'\n   */\n  disable?: boolean;\n\n  /**\n   * Cache on navigation - cache pages when navigating\n   * @default true\n   */\n  cacheOnNavigation?: boolean;\n\n  /**\n   * Reload app when device goes back online\n   * @default true\n   */\n  reloadOnOnline?: boolean;\n\n  /**\n   * Additional Serwist options\n   * @see https://serwist.pages.dev/docs/next/configuring\n   */\n  serwistOptions?: Record<string, any>;\n}\n\n/**\n * Add PWA configuration to Next.js config using Serwist\n *\n * @example Basic usage\n * ```ts\n * import { createBaseNextConfig, withPWA } from '@djangocfg/nextjs/config';\n *\n * const nextConfig = createBaseNextConfig({...});\n *\n * export default withPWA(nextConfig, {\n *   swSrc: 'app/sw.ts',\n *   disable: process.env.NODE_ENV === 'development',\n * });\n * ```\n *\n * @example Integrated with createBaseNextConfig\n * ```ts\n * import { createBaseNextConfig } from '@djangocfg/nextjs/config';\n *\n * const config = createBaseNextConfig({\n *   pwa: {\n *     swSrc: 'app/sw.ts',\n *     disable: false,\n *   },\n * });\n *\n * export default config;\n * ```\n */\nexport function withPWA(\n  nextConfig: NextConfig,\n  options: PWAPluginOptions = {}\n): NextConfig {\n  const isDev = process.env.NODE_ENV === 'development';\n  const isStaticBuild = process.env.NEXT_PUBLIC_STATIC_BUILD === 'true';\n\n  // Determine if PWA should be disabled:\n  // - Explicitly disabled via options\n  // - In development mode (default)\n  // - Static build (output: 'export' doesn't support service workers)\n  const shouldDisable = options.disable !== undefined\n    ? options.disable\n    : (isDev || isStaticBuild);\n\n  const defaultOptions: PWAPluginOptions = {\n    swSrc: 'app/sw.ts',\n    swDest: 'public/sw.js',\n    disable: shouldDisable,\n    cacheOnNavigation: true,\n    reloadOnOnline: true,\n    ...options,\n  };\n\n  try {\n    // Suppress Turbopack warning - it only applies to dev mode, not production builds\n    // The warning is misleading when running `next build` with Turbopack\n    // See: https://github.com/serwist/serwist/issues/54\n    if (!process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING) {\n      process.env.SERWIST_SUPPRESS_TURBOPACK_WARNING = '1';\n    }\n\n    const withSerwistInit = requirePeer('@serwist/next').default;\n\n    const withSerwist = withSerwistInit({\n      swSrc: defaultOptions.swSrc,\n      swDest: defaultOptions.swDest,\n      disable: defaultOptions.disable,\n      cacheOnNavigation: defaultOptions.cacheOnNavigation,\n      reloadOnOnline: defaultOptions.reloadOnOnline,\n      ...defaultOptions.serwistOptions,\n    });\n\n    return withSerwist(nextConfig);\n  } catch (error) {\n    consola.error('Failed to configure Serwist:', error);\n    return nextConfig;\n  }\n}\n\n/**\n * Get service worker template content\n *\n * Returns ready-to-use service worker code for app/sw.ts\n *\n * @example\n * ```ts\n * import { getServiceWorkerTemplate } from '@djangocfg/nextjs/config';\n *\n * // Copy this to your app/sw.ts file\n * console.log(getServiceWorkerTemplate());\n * ```\n */\nexport function getServiceWorkerTemplate(): string {\n  return `/**\n * Service Worker (Serwist)\n *\n * Modern PWA service worker using Serwist\n */\n\nimport { defaultCache } from '@serwist/next/worker';\nimport { Serwist } from 'serwist';\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ndeclare const self: any;\n\nconst serwist = new Serwist({\n  // Precache entries injected by Serwist build plugin\n  precacheEntries: self.__SW_MANIFEST,\n\n  // Skip waiting - activate new SW immediately\n  skipWaiting: true,\n\n  // Take control of all clients immediately\n  clientsClaim: true,\n\n  // Enable navigation preload for faster loads\n  navigationPreload: true,\n\n  // Use default Next.js runtime caching strategies\n  runtimeCaching: defaultCache,\n\n  // Fallback pages for offline\n  fallbacks: {\n    entries: [\n      {\n        url: '/_offline',\n        matcher({ request }) {\n          return request.destination === 'document';\n        },\n      },\n    ],\n  },\n});\n\nserwist.addEventListeners();\n`;\n}\n\n// Backward compatibility exports (deprecated)\nexport const defaultRuntimeCaching = [];\nexport function createApiCacheRule() {\n  consola.warn('createApiCacheRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\nexport function createStaticAssetRule() {\n  consola.warn('createStaticAssetRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\nexport function createCdnCacheRule() {\n  consola.warn('createCdnCacheRule is deprecated with Serwist. Use defaultCache from @serwist/next/worker');\n  return {};\n}\n"],"mappings":"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","names":[]}

package/dist/pwa/manifest.d.mts

@@ -0,0 +1,194 @@
+import { MetadataRoute, Metadata, Viewport } from 'next';
+
+/**
+ * PWA Manifest Metadata Utilities
+ *
+ * Helper functions for creating Next.js metadata for PWA manifest
+ */
+
+interface ManifestConfig {
+    name: string;
+    shortName?: string;
+    description?: string;
+    themeColor?: string;
+    backgroundColor?: string;
+    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    orientation?: 'portrait' | 'landscape' | 'any';
+    startUrl?: string;
+    scope?: string;
+    lang?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    icons?: {
+        src: string;
+        sizes: string;
+        type?: string;
+        purpose?: string;
+    }[];
+}
+/**
+ * Icon paths configuration
+ */
+interface IconPaths {
+    logo192?: string;
+    logo384?: string;
+    logo512?: string;
+}
+/**
+ * Protocol handler configuration
+ * Allows your PWA to register as a handler for custom protocols
+ *
+ * @example
+ * ```typescript
+ * {
+ *   protocol: "web+music",
+ *   url: "/play?track=%s"
+ * }
+ * ```
+ */
+interface ProtocolHandler {
+    /** Protocol scheme (e.g., "web+music", "mailto", "magnet") */
+    protocol: string;
+    /** URL template with %s placeholder for the protocol parameter */
+    url: string;
+}
+/**
+ * Create viewport configuration for Next.js app
+ *
+ * @example
+ * ```typescript
+ * export const viewport: Viewport = createViewport({
+ *   themeColor: '#ffffff',
+ * });
+ * ```
+ */
+declare function createViewport(config: {
+    themeColor?: string;
+}): Viewport;
+/**
+ * Create manifest metadata for Next.js app
+ *
+ * Note: themeColor and viewport should be exported separately using createViewport()
+ *
+ * @example
+ * ```typescript
+ * export const metadata: Metadata = {
+ *   ...createManifestMetadata({
+ *     name: 'My App',
+ *     shortName: 'App',
+ *     description: 'My awesome app',
+ *   }),
+ * };
+ *
+ * export const viewport: Viewport = createViewport({
+ *   themeColor: '#ffffff',
+ * });
+ * ```
+ */
+declare function createManifestMetadata(config: ManifestConfig): Metadata;
+/**
+ * Create Next.js manifest function
+ *
+ * Use this in your app/manifest.ts file
+ *
+ * @example
+ * ```typescript
+ * // app/manifest.ts
+ * import { createManifest } from '@djangocfg/nextjs/config';
+ * import { settings } from '@core/settings';
+ *
+ * export default createManifest({
+ *   name: settings.app.name,
+ *   description: settings.app.description,
+ *   icons: {
+ *     logo192: settings.app.icons.logo192,
+ *     logo384: settings.app.icons.logo384,
+ *     logo512: settings.app.icons.logo512,
+ *   },
+ * });
+ * ```
+ */
+interface ScreenshotConfig {
+    src: string;
+    sizes: string;
+    type?: string;
+    form_factor?: 'narrow' | 'wide';
+    label?: string;
+}
+/**
+ * Smart screenshot configuration
+ * Automatically detects everything from path or uses defaults
+ */
+interface SmartScreenshotInput {
+    src: string;
+    /** Form factor (auto-detected from filename if contains 'desktop'/'mobile', or use default) */
+    form_factor?: 'narrow' | 'wide';
+    /** Optional label (auto-generated from form_factor) */
+    label?: string;
+    /** Optional width (defaults based on form_factor) */
+    width?: number;
+    /** Optional height (defaults based on form_factor) */
+    height?: number;
+}
+/**
+ * Create screenshot config with smart defaults
+ * Automatically detects type, sizes, form_factor from path or uses sensible defaults
+ *
+ * @example
+ * ```typescript
+ * // Minimal - everything auto-detected
+ * createScreenshot({ src: '/screenshots/desktop-view.png' })
+ * // → form_factor: 'wide', sizes: '1920x1080', type: 'image/png', label: 'Desktop screenshot'
+ *
+ * createScreenshot({ src: '/screenshots/mobile.png' })
+ * // → form_factor: 'narrow', sizes: '390x844', type: 'image/png', label: 'Mobile screenshot'
+ *
+ * // With custom dimensions
+ * createScreenshot({ src: '/screenshots/tablet.png', width: 1024, height: 768 })
+ * ```
+ */
+declare function createScreenshot(input: SmartScreenshotInput | string): ScreenshotConfig;
+/**
+ * Create multiple screenshots from array
+ * Supports string shorthand or full config objects
+ *
+ * @example
+ * ```typescript
+ * // Minimal - just paths
+ * createScreenshots([
+ *   '/screenshots/desktop.png',  // Auto: wide, 1920x1080
+ *   '/screenshots/mobile.png',   // Auto: narrow, 390x844
+ * ])
+ *
+ * // Mixed
+ * createScreenshots([
+ *   '/screenshots/desktop.png',
+ *   { src: '/screenshots/tablet.png', width: 1024, height: 768 },
+ * ])
+ * ```
+ */
+declare function createScreenshots(inputs: Array<SmartScreenshotInput | string>): ScreenshotConfig[];
+declare function createManifest(config: {
+    name: string;
+    shortName?: string;
+    description?: string;
+    themeColor?: string;
+    backgroundColor?: string;
+    display?: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    orientation?: 'portrait' | 'landscape' | 'any';
+    id?: string;
+    startUrl?: string;
+    scope?: string;
+    lang?: string;
+    dir?: 'ltr' | 'rtl' | 'auto';
+    icons?: IconPaths | ManifestConfig['icons'];
+    screenshots?: ScreenshotConfig[];
+    protocol_handlers?: ProtocolHandler[];
+}): () => MetadataRoute.Manifest;
+/**
+ * Generate manifest.json content (legacy)
+ *
+ * @deprecated Use createManifest() instead
+ */
+declare function generateManifest(config: ManifestConfig): Record<string, any>;
+
+export { type IconPaths, type ManifestConfig, type ProtocolHandler, type ScreenshotConfig, type SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest };

package/dist/pwa/manifest.mjs

@@ -0,0 +1,136 @@
+// src/pwa/manifest.ts
+function createViewport(config) {
+  return {
+    width: "device-width",
+    initialScale: 1,
+    maximumScale: 1,
+    themeColor: config.themeColor || "#000000"
+  };
+}
+function createManifestMetadata(config) {
+  return {
+    manifest: "/manifest.json",
+    appleWebApp: {
+      capable: true,
+      statusBarStyle: "default",
+      title: config.shortName || config.name
+    },
+    applicationName: config.name,
+    formatDetection: {
+      telephone: false
+    }
+  };
+}
+function createScreenshot(input) {
+  const config = typeof input === "string" ? { src: input } : input;
+  let { src, width, height, label, form_factor } = config;
+  const ext = src.split(".").pop()?.toLowerCase();
+  const typeMap = {
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    svg: "image/svg+xml"
+  };
+  const type = ext ? typeMap[ext] || "image/png" : "image/png";
+  const filename = src.toLowerCase();
+  const dimensionMatch = filename.match(/(\d{3,4})x(\d{3,4})/);
+  if (dimensionMatch && !width && !height) {
+    width = parseInt(dimensionMatch[1], 10);
+    height = parseInt(dimensionMatch[2], 10);
+  }
+  let autoFormFactor = "wide";
+  if (filename.includes("mobile") || filename.includes("phone") || filename.includes("narrow")) {
+    autoFormFactor = "narrow";
+  } else if (filename.includes("desktop") || filename.includes("laptop") || filename.includes("wide")) {
+    autoFormFactor = "wide";
+  } else if (width && height) {
+    const aspectRatio = width / height;
+    autoFormFactor = aspectRatio > 1.2 ? "wide" : "narrow";
+  }
+  const finalFormFactor = form_factor || autoFormFactor;
+  const defaultDimensions = finalFormFactor === "wide" ? { width: 1920, height: 1080 } : { width: 390, height: 844 };
+  const finalWidth = width || defaultDimensions.width;
+  const finalHeight = height || defaultDimensions.height;
+  const autoLabel = finalFormFactor === "wide" ? "Desktop screenshot" : "Mobile screenshot";
+  return {
+    src,
+    sizes: `${finalWidth}x${finalHeight}`,
+    type,
+    form_factor: finalFormFactor,
+    label: label || autoLabel
+  };
+}
+function createScreenshots(inputs) {
+  return inputs.map(createScreenshot);
+}
+function createManifest(config) {
+  return () => {
+    let manifestIcons;
+    if (Array.isArray(config.icons)) {
+      manifestIcons = config.icons;
+    } else if (config.icons) {
+      const { logo192, logo384, logo512 } = config.icons;
+      manifestIcons = [
+        ...logo192 ? [
+          {
+            src: logo192,
+            sizes: "192x192",
+            type: "image/png",
+            purpose: "maskable"
+          }
+        ] : [],
+        ...logo384 ? [
+          {
+            src: logo384,
+            sizes: "384x384",
+            type: "image/png"
+          }
+        ] : [],
+        ...logo512 ? [
+          {
+            src: logo512,
+            sizes: "512x512",
+            type: "image/png"
+          }
+        ] : []
+      ];
+    }
+    const manifest = {
+      name: config.name,
+      short_name: config.shortName || config.name,
+      description: config.description || config.name,
+      id: config.id || config.startUrl || "/",
+      start_url: config.startUrl || "/",
+      scope: config.scope || "/",
+      display: config.display || "standalone",
+      orientation: config.orientation || "portrait",
+      background_color: config.backgroundColor || "#000000",
+      theme_color: config.themeColor || "#ffffff",
+      lang: config.lang || "en",
+      dir: config.dir || "ltr",
+      icons: manifestIcons
+      // Removed forced gcm_sender_id to avoid potential conflicts with VAPID
+      // gcm_sender_id: '103953800507',
+    };
+    if (config.screenshots && config.screenshots.length > 0) {
+      manifest.screenshots = config.screenshots;
+    }
+    if (config.protocol_handlers && config.protocol_handlers.length > 0) {
+      manifest.protocol_handlers = config.protocol_handlers;
+    }
+    return manifest;
+  };
+}
+function generateManifest(config) {
+  return createManifest(config)();
+}
+export {
+  createManifest,
+  createManifestMetadata,
+  createScreenshot,
+  createScreenshots,
+  createViewport,
+  generateManifest
+};
+//# sourceMappingURL=manifest.mjs.map