@djangocfg/nextjs 2.1.542 → 2.1.543

package/dist/pwa/index.mjs

@@ -23,7 +23,8 @@ function createManifestMetadata(config) {
 }
 function createScreenshot(input) {
   const config = typeof input === "string" ? { src: input } : input;
-  let { src, width, height, label, form_factor } = config;
+  const { src, label, form_factor } = config;
+  let { width, height } = config;
   const ext = src.split(".").pop()?.toLowerCase();
   const typeMap = {
     png: "image/png",
@@ -34,10 +35,10 @@ function createScreenshot(input) {
   };
   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);
+  const [, matchedWidth, matchedHeight] = filename.match(/(\d{3,4})x(\d{3,4})/) ?? [];
+  if (matchedWidth && matchedHeight && !width && !height) {
+    width = parseInt(matchedWidth, 10);
+    height = parseInt(matchedHeight, 10);
   }
   let autoFormFactor = "wide";
   if (filename.includes("mobile") || filename.includes("phone") || filename.includes("narrow")) {

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 — dependency-free.\n *\n * History: this used to wrap `@serwist/next`. Serwist is a **webpack** plugin,\n * and Next.js 16 defaults to Turbopack, which does not run webpack loaders and\n * chokes on serwist's `fileURLToPath(new URL(\".\", import.meta.url))` during\n * static tracing — failing the whole build even when PWA was never enabled\n * (the mere `require('@serwist/next')` reference was enough). Since no app in\n * this monorepo actually turned PWA on (`withPWA` is opt-in and unused), we\n * dropped serwist entirely.\n *\n * What remains:\n *   - `createManifest` (in `./manifest`) — the web app manifest, which Next.js\n *     supports natively via `app/manifest.ts`; needs no library at all.\n *   - `withPWA` — a thin, Turbopack-safe pass-through kept for API stability.\n *   - `getServiceWorkerTemplate` — a vanilla service worker you can drop into\n *     `app/sw.ts`, no framework runtime required.\n *\n * If you want a full precache/offline story back, wire a real service worker\n * (the template below, or Workbox) yourself — but do it in an app, not here, so\n * one app's PWA choice can't break every consumer's build.\n */\n\nimport type { NextConfig } from 'next';\n\nexport interface PWAPluginOptions {\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 the compiled service worker.\n   * @default 'public/sw.js'\n   */\n  swDest?: string;\n\n  /**\n   * Disable PWA completely.\n   * @default true in development / static export, false otherwise\n   */\n  disable?: boolean;\n\n  /** Cache pages on navigation. Consumed by a custom SW, if any. @default true */\n  cacheOnNavigation?: boolean;\n\n  /** Reload the app when the device comes back online. @default true */\n  reloadOnOnline?: boolean;\n}\n\n/**\n * Turbopack-safe PWA pass-through.\n *\n * This no longer injects a build plugin — Next.js's native manifest support\n * plus a hand-written `app/sw.ts` (see {@link getServiceWorkerTemplate}) cover\n * the PWA surface without a webpack-only dependency. Kept as a named export so\n * existing `withPWA(config)` / `createBaseNextConfig({ pwa })` call sites keep\n * type-checking and behave predictably (they return the config unchanged).\n *\n * @example\n * ```ts\n * import { createBaseNextConfig } from '@djangocfg/nextjs/config';\n * export default createBaseNextConfig({ pwa: { swSrc: 'app/sw.ts' } });\n * ```\n */\nexport function withPWA(\n  nextConfig: NextConfig,\n  _options: PWAPluginOptions = {}\n): NextConfig {\n  return nextConfig;\n}\n\n/**\n * Vanilla service-worker template — no library.\n *\n * Returns ready-to-use, framework-free service worker source. Copy it into\n * `app/sw.ts` (or generate it) if you want offline support. It uses only the\n * standard Service Worker + Cache APIs, so it builds under Turbopack with no\n * extra dependency.\n *\n * @example\n * ```ts\n * import { getServiceWorkerTemplate } from '@djangocfg/nextjs/config';\n * console.log(getServiceWorkerTemplate()); // → paste into app/sw.ts\n * ```\n */\nexport function getServiceWorkerTemplate(): string {\n  return `/**\n * Service Worker (vanilla) — standard Cache + Fetch APIs, no library.\n */\n\n/// <reference lib=\"webworker\" />\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ndeclare const self: any;\n\nconst CACHE = 'app-cache-v1';\nconst OFFLINE_URL = '/_offline';\n\n// Precache the offline fallback on install.\nself.addEventListener('install', (event: any) => {\n  event.waitUntil(\n    caches.open(CACHE).then((cache: Cache) => cache.addAll([OFFLINE_URL]))\n  );\n  self.skipWaiting();\n});\n\n// Drop stale caches on activate and take control immediately.\nself.addEventListener('activate', (event: any) => {\n  event.waitUntil(\n    caches.keys().then((keys: string[]) =>\n      Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k)))\n    )\n  );\n  self.clients.claim();\n});\n\n// Network-first for navigations, with an offline fallback.\nself.addEventListener('fetch', (event: any) => {\n  const { request } = event;\n  if (request.mode !== 'navigate') return;\n  event.respondWith(\n    fetch(request).catch(() =>\n      caches.match(OFFLINE_URL).then((r: Response | undefined) => r ?? Response.error())\n    )\n  );\n});\n`;\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  const { src, label, form_factor } = config;\n  let { width, height } = 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  // Destructured: `\\d{3,4}` cannot match empty, so both groups exist whenever\n  // the match does — but only binding them says so without an assertion.\n  const [, matchedWidth, matchedHeight] = filename.match(/(\\d{3,4})x(\\d{3,4})/) ?? [];\n  if (matchedWidth && matchedHeight && !width && !height) {\n    width = parseInt(matchedWidth, 10);\n    height = parseInt(matchedHeight, 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.screenshots = config.screenshots;\n    }\n\n    // Add protocol handlers if provided\n    if (config.protocol_handlers && config.protocol_handlers.length > 0) {\n      manifest.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): MetadataRoute.Manifest {\n  return createManifest(config)();\n}\n","/**\n * PWA (Progressive Web App) Plugin — dependency-free.\n *\n * History: this used to wrap `@serwist/next`. Serwist is a **webpack** plugin,\n * and Next.js 16 defaults to Turbopack, which does not run webpack loaders and\n * chokes on serwist's `fileURLToPath(new URL(\".\", import.meta.url))` during\n * static tracing — failing the whole build even when PWA was never enabled\n * (the mere `require('@serwist/next')` reference was enough). Since no app in\n * this monorepo actually turned PWA on (`withPWA` is opt-in and unused), we\n * dropped serwist entirely.\n *\n * What remains:\n *   - `createManifest` (in `./manifest`) — the web app manifest, which Next.js\n *     supports natively via `app/manifest.ts`; needs no library at all.\n *   - `withPWA` — a thin, Turbopack-safe pass-through kept for API stability.\n *   - `getServiceWorkerTemplate` — a vanilla service worker you can drop into\n *     `app/sw.ts`, no framework runtime required.\n *\n * If you want a full precache/offline story back, wire a real service worker\n * (the template below, or Workbox) yourself — but do it in an app, not here, so\n * one app's PWA choice can't break every consumer's build.\n */\n\nimport type { NextConfig } from 'next';\n\nexport interface PWAPluginOptions {\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 the compiled service worker.\n   * @default 'public/sw.js'\n   */\n  swDest?: string;\n\n  /**\n   * Disable PWA completely.\n   * @default true in development / static export, false otherwise\n   */\n  disable?: boolean;\n\n  /** Cache pages on navigation. Consumed by a custom SW, if any. @default true */\n  cacheOnNavigation?: boolean;\n\n  /** Reload the app when the device comes back online. @default true */\n  reloadOnOnline?: boolean;\n}\n\n/**\n * Turbopack-safe PWA pass-through.\n *\n * This no longer injects a build plugin — Next.js's native manifest support\n * plus a hand-written `app/sw.ts` (see {@link getServiceWorkerTemplate}) cover\n * the PWA surface without a webpack-only dependency. Kept as a named export so\n * existing `withPWA(config)` / `createBaseNextConfig({ pwa })` call sites keep\n * type-checking and behave predictably (they return the config unchanged).\n *\n * @example\n * ```ts\n * import { createBaseNextConfig } from '@djangocfg/nextjs/config';\n * export default createBaseNextConfig({ pwa: { swSrc: 'app/sw.ts' } });\n * ```\n */\nexport function withPWA(\n  nextConfig: NextConfig,\n  _options: PWAPluginOptions = {}\n): NextConfig {\n  return nextConfig;\n}\n\n/**\n * Vanilla service-worker template — no library.\n *\n * Returns ready-to-use, framework-free service worker source. Copy it into\n * `app/sw.ts` (or generate it) if you want offline support. It uses only the\n * standard Service Worker + Cache APIs, so it builds under Turbopack with no\n * extra dependency.\n *\n * @example\n * ```ts\n * import { getServiceWorkerTemplate } from '@djangocfg/nextjs/config';\n * console.log(getServiceWorkerTemplate()); // → paste into app/sw.ts\n * ```\n */\nexport function getServiceWorkerTemplate(): string {\n  return `/**\n * Service Worker (vanilla) — standard Cache + Fetch APIs, no library.\n */\n\n/// <reference lib=\"webworker\" />\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ndeclare const self: any;\n\nconst CACHE = 'app-cache-v1';\nconst OFFLINE_URL = '/_offline';\n\n// Precache the offline fallback on install.\nself.addEventListener('install', (event: any) => {\n  event.waitUntil(\n    caches.open(CACHE).then((cache: Cache) => cache.addAll([OFFLINE_URL]))\n  );\n  self.skipWaiting();\n});\n\n// Drop stale caches on activate and take control immediately.\nself.addEventListener('activate', (event: any) => {\n  event.waitUntil(\n    caches.keys().then((keys: string[]) =>\n      Promise.all(keys.filter((k) => k !== CACHE).map((k) => caches.delete(k)))\n    )\n  );\n  self.clients.claim();\n});\n\n// Network-first for navigations, with an offline fallback.\nself.addEventListener('fetch', (event: any) => {\n  const { request } = event;\n  if (request.mode !== 'navigate') return;\n  event.respondWith(\n    fetch(request).catch(() =>\n      caches.match(OFFLINE_URL).then((r: Response | undefined) => r ?? Response.error())\n    )\n  );\n});\n`;\n}\n"],"mappings":"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","names":[]}

package/dist/pwa/manifest.d.mts

@@ -189,6 +189,6 @@ declare function createManifest(config: {
  *
  * @deprecated Use createManifest() instead
  */
-declare function generateManifest(config: ManifestConfig): Record<string, any>;
+declare function generateManifest(config: ManifestConfig): MetadataRoute.Manifest;
 
 export { type IconPaths, type ManifestConfig, type ProtocolHandler, type ScreenshotConfig, type SmartScreenshotInput, createManifest, createManifestMetadata, createScreenshot, createScreenshots, createViewport, generateManifest };

package/dist/pwa/manifest.mjs

@@ -23,7 +23,8 @@ function createManifestMetadata(config) {
 }
 function createScreenshot(input) {
   const config = typeof input === "string" ? { src: input } : input;
-  let { src, width, height, label, form_factor } = config;
+  const { src, label, form_factor } = config;
+  let { width, height } = config;
   const ext = src.split(".").pop()?.toLowerCase();
   const typeMap = {
     png: "image/png",
@@ -34,10 +35,10 @@ function createScreenshot(input) {
   };
   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);
+  const [, matchedWidth, matchedHeight] = filename.match(/(\d{3,4})x(\d{3,4})/) ?? [];
+  if (matchedWidth && matchedHeight && !width && !height) {
+    width = parseInt(matchedWidth, 10);
+    height = parseInt(matchedHeight, 10);
   }
   let autoFormFactor = "wide";
   if (filename.includes("mobile") || filename.includes("phone") || filename.includes("narrow")) {

package/dist/pwa/manifest.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/pwa/manifest.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"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/pwa/manifest.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  const { src, label, form_factor } = config;\n  let { width, height } = 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  // Destructured: `\\d{3,4}` cannot match empty, so both groups exist whenever\n  // the match does — but only binding them says so without an assertion.\n  const [, matchedWidth, matchedHeight] = filename.match(/(\\d{3,4})x(\\d{3,4})/) ?? [];\n  if (matchedWidth && matchedHeight && !width && !height) {\n    width = parseInt(matchedWidth, 10);\n    height = parseInt(matchedHeight, 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.screenshots = config.screenshots;\n    }\n\n    // Add protocol handlers if provided\n    if (config.protocol_handlers && config.protocol_handlers.length > 0) {\n      manifest.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): MetadataRoute.Manifest {\n  return createManifest(config)();\n}\n"],"mappings":"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","names":[]}

package/dist/pwa/worker/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/pwa/worker/index.ts"],"sourcesContent":["/**\n * Service Worker Utilities — vanilla, dependency-free.\n *\n * Was a Serwist wrapper; serwist is a webpack-only plugin incompatible with\n * Next.js 16's Turbopack, so this is now a hand-written service worker built on\n * the standard Service Worker + Cache APIs. Same `createServiceWorker(options)`\n * entry point, no library, Turbopack-safe.\n */\n\n/// <reference lib=\"webworker\" />\n\nexport interface ServiceWorkerOptions {\n  /** Offline fallback URL. @default '/_offline' */\n  offlineFallback?: string;\n  /** Activate a new SW immediately instead of waiting. @default true */\n  skipWaiting?: boolean;\n  /** Take control of open clients immediately. @default true */\n  clientsClaim?: boolean;\n  /** Name of the runtime cache bucket. @default 'app-cache-v1' */\n  cacheName?: string;\n}\n\n/**\n * Register a minimal offline-capable service worker.\n *\n * Network-first for navigations with an offline fallback page; stale caches are\n * cleared on activate. No precache manifest (that was a serwist build-time\n * injection) — add your own `cache.addAll([...])` in the install step if you\n * need assets precached.\n *\n * @example\n * ```ts\n * // app/sw.ts\n * import { createServiceWorker } from '@djangocfg/nextjs/worker';\n * createServiceWorker({ offlineFallback: '/_offline' });\n * ```\n */\nexport function createServiceWorker(options: ServiceWorkerOptions = {}): void {\n  const {\n    offlineFallback = '/_offline',\n    skipWaiting = true,\n    clientsClaim = true,\n    cacheName = 'app-cache-v1',\n  } = options;\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const sw = self as any;\n\n  sw.addEventListener('install', (event: any) => {\n    event.waitUntil(\n      caches.open(cacheName).then((cache: Cache) => cache.addAll([offlineFallback]))\n    );\n    if (skipWaiting) sw.skipWaiting();\n  });\n\n  sw.addEventListener('activate', (event: any) => {\n    event.waitUntil(\n      caches\n        .keys()\n        .then((keys: string[]) =>\n          Promise.all(keys.filter((k) => k !== cacheName).map((k) => caches.delete(k)))\n        )\n        .then(() => {\n          if (clientsClaim) return sw.clients.claim();\n        })\n    );\n  });\n\n  sw.addEventListener('fetch', (event: any) => {\n    const { request } = event;\n    if (request.mode !== 'navigate') return;\n    event.respondWith(\n      fetch(request).catch(() =>\n        caches\n          .match(offlineFallback)\n          .then((r: Response | undefined) => r ?? Response.error())\n      )\n    );\n  });\n}\n"],"mappings":";AAqCO,SAAS,oBAAoB,UAAgC,CAAC,GAAS;AAC5E,QAAM;AAAA,IACJ,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,YAAY;AAAA,EACd,IAAI;AAGJ,QAAM,KAAK;AAEX,KAAG,iBAAiB,WAAW,CAAC,UAAe;AAC7C,UAAM;AAAA,MACJ,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,UAAiB,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAAA,IAC/E;AACA,QAAI,YAAa,IAAG,YAAY;AAAA,EAClC,CAAC;AAED,KAAG,iBAAiB,YAAY,CAAC,UAAe;AAC9C,UAAM;AAAA,MACJ,OACG,KAAK,EACL;AAAA,QAAK,CAAC,SACL,QAAQ,IAAI,KAAK,OAAO,CAAC,MAAM,MAAM,SAAS,EAAE,IAAI,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC,CAAC;AAAA,MAC9E,EACC,KAAK,MAAM;AACV,YAAI,aAAc,QAAO,GAAG,QAAQ,MAAM;AAAA,MAC5C,CAAC;AAAA,IACL;AAAA,EACF,CAAC;AAED,KAAG,iBAAiB,SAAS,CAAC,UAAe;AAC3C,UAAM,EAAE,QAAQ,IAAI;AACpB,QAAI,QAAQ,SAAS,WAAY;AACjC,UAAM;AAAA,MACJ,MAAM,OAAO,EAAE;AAAA,QAAM,MACnB,OACG,MAAM,eAAe,EACrB,KAAK,CAAC,MAA4B,KAAK,SAAS,MAAM,CAAC;AAAA,MAC5D;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../../../src/pwa/worker/index.ts"],"sourcesContent":["/**\n * Service Worker Utilities — vanilla, dependency-free.\n *\n * Was a Serwist wrapper; serwist is a webpack-only plugin incompatible with\n * Next.js 16's Turbopack, so this is now a hand-written service worker built on\n * the standard Service Worker + Cache APIs. Same `createServiceWorker(options)`\n * entry point, no library, Turbopack-safe.\n */\n\n/// <reference lib=\"webworker\" />\n\nexport interface ServiceWorkerOptions {\n  /** Offline fallback URL. @default '/_offline' */\n  offlineFallback?: string;\n  /** Activate a new SW immediately instead of waiting. @default true */\n  skipWaiting?: boolean;\n  /** Take control of open clients immediately. @default true */\n  clientsClaim?: boolean;\n  /** Name of the runtime cache bucket. @default 'app-cache-v1' */\n  cacheName?: string;\n}\n\n/**\n * Register a minimal offline-capable service worker.\n *\n * Network-first for navigations with an offline fallback page; stale caches are\n * cleared on activate. No precache manifest (that was a serwist build-time\n * injection) — add your own `cache.addAll([...])` in the install step if you\n * need assets precached.\n *\n * @example\n * ```ts\n * // app/sw.ts\n * import { createServiceWorker } from '@djangocfg/nextjs/worker';\n * createServiceWorker({ offlineFallback: '/_offline' });\n * ```\n */\nexport function createServiceWorker(options: ServiceWorkerOptions = {}): void {\n  const {\n    offlineFallback = '/_offline',\n    skipWaiting = true,\n    clientsClaim = true,\n    cacheName = 'app-cache-v1',\n  } = options;\n\n  // `self` resolves to the DOM lib's `Window` when this file is compiled as part\n  // of an app; inside a service worker it is really a ServiceWorkerGlobalScope.\n  // Casting once here types every event handler below via the standard overloads.\n  const sw = self as unknown as ServiceWorkerGlobalScope;\n\n  sw.addEventListener('install', (event) => {\n    event.waitUntil(\n      caches.open(cacheName).then((cache) => cache.addAll([offlineFallback]))\n    );\n    if (skipWaiting) sw.skipWaiting();\n  });\n\n  sw.addEventListener('activate', (event) => {\n    event.waitUntil(\n      caches\n        .keys()\n        .then((keys) =>\n          Promise.all(keys.filter((k) => k !== cacheName).map((k) => caches.delete(k)))\n        )\n        .then(() => {\n          if (clientsClaim) return sw.clients.claim();\n        })\n    );\n  });\n\n  sw.addEventListener('fetch', (event) => {\n    const { request } = event;\n    if (request.mode !== 'navigate') return;\n    event.respondWith(\n      fetch(request).catch(() =>\n        caches\n          .match(offlineFallback)\n          .then((r: Response | undefined) => r ?? Response.error())\n      )\n    );\n  });\n}\n"],"mappings":";AAqCO,SAAS,oBAAoB,UAAgC,CAAC,GAAS;AAC5E,QAAM;AAAA,IACJ,kBAAkB;AAAA,IAClB,cAAc;AAAA,IACd,eAAe;AAAA,IACf,YAAY;AAAA,EACd,IAAI;AAKJ,QAAM,KAAK;AAEX,KAAG,iBAAiB,WAAW,CAAC,UAAU;AACxC,UAAM;AAAA,MACJ,OAAO,KAAK,SAAS,EAAE,KAAK,CAAC,UAAU,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;AAAA,IACxE;AACA,QAAI,YAAa,IAAG,YAAY;AAAA,EAClC,CAAC;AAED,KAAG,iBAAiB,YAAY,CAAC,UAAU;AACzC,UAAM;AAAA,MACJ,OACG,KAAK,EACL;AAAA,QAAK,CAAC,SACL,QAAQ,IAAI,KAAK,OAAO,CAAC,MAAM,MAAM,SAAS,EAAE,IAAI,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC,CAAC;AAAA,MAC9E,EACC,KAAK,MAAM;AACV,YAAI,aAAc,QAAO,GAAG,QAAQ,MAAM;AAAA,MAC5C,CAAC;AAAA,IACL;AAAA,EACF,CAAC;AAED,KAAG,iBAAiB,SAAS,CAAC,UAAU;AACtC,UAAM,EAAE,QAAQ,IAAI;AACpB,QAAI,QAAQ,SAAS,WAAY;AACjC,UAAM;AAAA,MACJ,MAAM,OAAO,EAAE;AAAA,QAAM,MACnB,OACG,MAAM,eAAe,EACrB,KAAK,CAAC,MAA4B,KAAK,SAAS,MAAM,CAAC;AAAA,MAC5D;AAAA,IACF;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/sitemap/index.d.mts

@@ -1,5 +1,5 @@
 import { MetadataRoute } from 'next';
-import { C as ChangeFreq } from '../types-l9x1Rkmf.mjs';
+import { C as ChangeFreq } from '../types-CMxSgWnS.mjs';
 
 /**
  * Sitemap module — types

package/dist/{types-l9x1Rkmf.d.mts → types-CMxSgWnS.d.mts}

@@ -19,6 +19,8 @@ interface HealthResponse {
     uptime: number;
     version?: string;
     checks?: Record<string, boolean>;
+    /** Wall-clock time spent running the configured checks, in milliseconds. */
+    durationMs?: number;
 }
 interface ErrorPageConfig {
     code?: string | number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.542",
+  "version": "2.1.543",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -149,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.542",
-    "@djangocfg/i18n": "^2.1.542",
-    "@djangocfg/ui-core": "^2.1.542",
+    "@djangocfg/devtools": "^2.1.543",
+    "@djangocfg/i18n": "^2.1.543",
+    "@djangocfg/ui-core": "^2.1.543",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -170,11 +170,11 @@
     "semver": "^7.8.5"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.542",
-    "@djangocfg/i18n": "^2.1.542",
-    "@djangocfg/layouts": "^2.1.542",
-    "@djangocfg/typescript-config": "^2.1.542",
-    "@djangocfg/ui-core": "^2.1.542",
+    "@djangocfg/devtools": "^2.1.543",
+    "@djangocfg/i18n": "^2.1.543",
+    "@djangocfg/layouts": "^2.1.543",
+    "@djangocfg/typescript-config": "^2.1.543",
+    "@djangocfg/ui-core": "^2.1.543",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/config/createNextConfig.ts

@@ -44,7 +44,18 @@ import {
 // Configuration Options
 // ─────────────────────────────────────────────────────────────────────────
 
-export interface BaseNextConfigOptions {
+/**
+ * Second argument Next.js passes to the `webpack` hook. Derived from Next's own
+ * signature rather than re-declared, so it tracks upstream.
+ */
+type WebpackContext = Parameters<NonNullable<NextConfig['webpack']>>[1];
+
+/**
+ * DjangoCFG-specific options. Every other Next.js option passes through via the
+ * `NextConfig` half of `BaseNextConfigOptions`; the keys redeclared here are
+ * omitted from it because this package narrows or re-purposes them.
+ */
+interface DjangoCfgNextOptions {
   /** Static build path (used when NEXT_PUBLIC_STATIC_BUILD=true) */
   isDefaultCfgAdmin?: boolean;
   /** Additional transpile packages (merged with defaults) */
@@ -180,7 +191,7 @@ export interface BaseNextConfigOptions {
   /** Custom webpack configuration function (called after base webpack logic) */
   webpack?: (
     config: WebpackConfig,
-    options: { isServer: boolean; dev: boolean; [key: string]: any }
+    options: WebpackContext
   ) => WebpackConfig | void;
   /** Custom experimental options (merged with defaults) */
   experimental?: NextConfig['experimental'];
@@ -192,10 +203,14 @@ export interface BaseNextConfigOptions {
   headers?: NextConfig['headers'];
   /** Additional rewrites */
   rewrites?: NextConfig['rewrites'];
-  /** Override any Next.js config option */
-  [key: string]: any;
 }
 
+/**
+ * DjangoCFG options plus every remaining Next.js config option.
+ */
+export type BaseNextConfigOptions = DjangoCfgNextOptions &
+  Omit<NextConfig, keyof DjangoCfgNextOptions>;
+
 // ─────────────────────────────────────────────────────────────────────────
 // Base Configuration Factory
 // ─────────────────────────────────────────────────────────────────────────
@@ -442,7 +457,7 @@ export function createBaseNextConfig(
     },
 
     // Webpack configuration
-    webpack: (config: WebpackConfig, webpackOptions: { isServer: boolean; dev: boolean; [key: string]: any }) => {
+    webpack: (config: WebpackConfig, webpackOptions: WebpackContext) => {
       const { isServer, dev } = webpackOptions;
 
       // Add dev startup plugin (client-side only in dev)
@@ -491,28 +506,36 @@ export function createBaseNextConfig(
     },
   };
 
-  // Extract plugin options before merge (to avoid conflicts with Next.js config)
-  // `transpilePackages` MUST be extracted too: baseConfig already merged it with
-  // DEFAULT_TRANSPILE_PACKAGES — leaving it in nextConfigOptions made deepMerge
-  // REPLACE the merged array with the user's bare list (dropping the defaults,
+  const { i18n: i18nOptions, pwa: pwaOptions } = options;
+
+  // Keys already consumed above; they must not reach deepMerge, either because
+  // Next.js does not understand them or because baseConfig already derived the
+  // real value. `transpilePackages` is the load-bearing case: baseConfig merged
+  // it with DEFAULT_TRANSPILE_PACKAGES, and leaving it here made deepMerge
+  // REPLACE that merged array with the user's bare list (dropping the defaults,
   // so every @djangocfg source package stopped transpiling).
-  const {
-    i18n: i18nOptions,
-    pwa: pwaOptions,
-    transpilePackages,
-    optimizePackageImports,
-    isDefaultCfgAdmin,
-    checkUpdates,
-    autoUpdate,
-    forceCheckWorkspace,
-    checkPackages,
-    autoInstall,
-    allowIframeFrom,
-    dpop,
-    stripe,
-    csp,
-    ...nextConfigOptions
-  } = options;
+  const DJANGOCFG_ONLY_KEYS = [
+    'i18n',
+    'pwa',
+    'transpilePackages',
+    'optimizePackageImports',
+    'isDefaultCfgAdmin',
+    'checkUpdates',
+    'autoUpdate',
+    'forceCheckWorkspace',
+    'checkPackages',
+    'autoInstall',
+    'allowIframeFrom',
+    'dpop',
+    'stripe',
+    'csp',
+  ] as const satisfies readonly (keyof BaseNextConfigOptions)[];
+
+  const nextConfigOptions = Object.fromEntries(
+    Object.entries(options).filter(
+      ([key]) => !(DJANGOCFG_ONLY_KEYS as readonly string[]).includes(key)
+    )
+  ) as Partial<NextConfig>;
 
   // Deep merge only valid Next.js options with base config
   let finalConfig = deepMerge(baseConfig, nextConfigOptions);

package/src/config/packages/installer.ts

@@ -22,13 +22,13 @@ type InstallerCacheShape = {
   lastPrompt?: number;
 };
 
-interface CacheLike<T extends Record<string, any>> {
+interface CacheLike<T extends Record<string, unknown>> {
   get<K extends keyof T>(key: K): T[K] | undefined;
   set<K extends keyof T>(key: K, value: T[K]): void;
   clear(): void;
 }
 
-function createMemoryCache<T extends Record<string, any>>(): CacheLike<T> {
+function createMemoryCache<T extends Record<string, unknown>>(): CacheLike<T> {
   const store = new Map<string, unknown>();
   return {
     get<K extends keyof T>(key: K): T[K] | undefined {
@@ -266,7 +266,11 @@ async function installSinglePackage(
   spinner.start();
 
   return new Promise((resolve) => {
-    const [cmd, ...args] = command.split(' ');
+    // `split` returns `string[]`, so `cmd` is `string | undefined` and no
+    // `spawn` overload accepts that — which typed `proc` as `never` and made
+    // every `proc.*` below an error. `buildSingleInstallCommand` never returns
+    // an empty string; the fallback states that rather than asserting it.
+    const [cmd = pm, ...args] = command.split(' ');
     const proc = spawn(cmd, args, {
       shell: true,
       cwd: process.cwd(),
@@ -313,14 +317,14 @@ export async function installPackagesWithProgress(packages: MissingPackage[]): P
   console.log('');
 
   let successCount = 0;
-  let failedPackages: string[] = [];
+  const failedPackages: string[] = [];
 
-  for (let i = 0; i < packages.length; i++) {
-    const success = await installSinglePackage(packages[i], pm, i, total);
+  for (const [i, pkg] of packages.entries()) {
+    const success = await installSinglePackage(pkg, pm, i, total);
     if (success) {
       successCount++;
     } else {
-      failedPackages.push(packages[i].name);
+      failedPackages.push(pkg.name);
     }
   }
 

package/src/config/packages/updater.ts

@@ -24,13 +24,13 @@ type UpdaterCacheShape = {
   skippedVersions?: Record<string, string>;
 };
 
-interface CacheLike<T extends Record<string, any>> {
+interface CacheLike<T extends Record<string, unknown>> {
   get<K extends keyof T>(key: K): T[K] | undefined;
   set<K extends keyof T>(key: K, value: T[K]): void;
   clear(): void;
 }
 
-function createMemoryCache<T extends Record<string, any>>(): CacheLike<T> {
+function createMemoryCache<T extends Record<string, unknown>>(): CacheLike<T> {
   const store = new Map<string, unknown>();
   return {
     get<K extends keyof T>(key: K): T[K] | undefined {
@@ -157,7 +157,7 @@ async function fetchLatestVersion(packageName: string): Promise<string | null> {
       const req = https.get(
         `https://registry.npmjs.org/${packageName}/latest`,
         { timeout: 5000 },
-        (res: any) => {
+        (res) => {
           let data = '';
           res.on('data', (chunk: string) => { data += chunk; });
           res.on('end', () => {
@@ -385,12 +385,12 @@ export async function updatePackagesWithProgress(packages: PackageVersion[]): Pr
   let successCount = 0;
   const failedPackages: string[] = [];
 
-  for (let i = 0; i < packages.length; i++) {
-    const success = await updateSinglePackage(packages[i], pm, i, total);
+  for (const [i, pkg] of packages.entries()) {
+    const success = await updateSinglePackage(pkg, pm, i, total);
     if (success) {
       successCount++;
     } else {
-      failedPackages.push(packages[i].name);
+      failedPackages.push(pkg.name);
     }
   }
 

package/src/config/plugins/compression.ts

@@ -88,7 +88,7 @@ export function addCompressionPlugins(
     }
 
     return true;
-  } catch (error) {
+  } catch {
     // compression-webpack-plugin failed to load
     return false;
   }

package/src/config/utils/deepMerge.ts

@@ -4,29 +4,33 @@
  * Recursively merges objects, replacing arrays instead of merging them.
  */
 
-export function deepMerge<T extends Record<string, any>>(target: T, source: Partial<T>): T {
-  const output = { ...target };
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+/**
+ * `T extends object` rather than `Record<string, unknown>`: call sites pass
+ * Next.js config interfaces, which have declared keys and no index signature —
+ * they are not assignable to `Record<string, unknown>`.
+ */
+export function deepMerge<T extends object>(target: T, source: Partial<T>): T {
+  const output: T = { ...target };
+
+  for (const key of Object.keys(source) as Array<keyof T & string>) {
+    const sourceValue: unknown = source[key];
+    if (sourceValue === undefined) continue;
+
+    const targetValue: unknown = output[key];
 
-  for (const key in source) {
-    if (source[key] === undefined) continue;
+    // Objects: deep merge. Arrays and primitives: replace.
+    // The recursion is instantiated at Record<string, unknown> — all the guards
+    // prove — and the result cast back to the key's declared type.
+    const merged =
+      isPlainObject(sourceValue) && isPlainObject(targetValue)
+        ? deepMerge(targetValue, sourceValue)
+        : sourceValue;
 
-    // Arrays: replace (don't merge arrays)
-    if (Array.isArray(source[key])) {
-      output[key] = source[key] as any;
-    }
-    // Objects: deep merge
-    else if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
-      const targetValue = output[key];
-      if (targetValue && typeof targetValue === 'object' && !Array.isArray(targetValue)) {
-        output[key] = deepMerge(targetValue, source[key] as any);
-      } else {
-        output[key] = source[key] as any;
-      }
-    }
-    // Primitives: replace
-    else {
-      output[key] = source[key] as any;
-    }
+    output[key] = merged as T[typeof key];
   }
 
   return output;

package/src/config/utils/version.ts

@@ -16,13 +16,13 @@ type VersionCacheShape = {
   lastCheck?: number;
 };
 
-interface CacheLike<T extends Record<string, any>> {
+interface CacheLike<T extends Record<string, unknown>> {
   get<K extends keyof T>(key: K): T[K] | undefined;
   set<K extends keyof T>(key: K, value: T[K]): void;
   clear(): void;
 }
 
-function createMemoryCache<T extends Record<string, any>>(): CacheLike<T> {
+function createMemoryCache<T extends Record<string, unknown>>(): CacheLike<T> {
   const store = new Map<string, unknown>();
   return {
     get<K extends keyof T>(key: K): T[K] | undefined {
@@ -88,7 +88,7 @@ export async function fetchLatestVersion(): Promise<string | null> {
       const req = https.get(
         `https://registry.npmjs.org/${PACKAGE_NAME}/latest`,
         { timeout: 5000 },
-        (res: any) => {
+        (res) => {
           let data = '';
           res.on('data', (chunk: string) => { data += chunk; });
           res.on('end', () => {

package/src/health/route.ts

@@ -42,7 +42,7 @@ export function createHealthHandler(config: HealthConfig = {}) {
           if (!result) {
             status = 'error';
           }
-        } catch (error) {
+        } catch {
           checkResults[check.name] = false;
           status = 'error';
         }
@@ -54,7 +54,10 @@ export function createHealthHandler(config: HealthConfig = {}) {
       timestamp: new Date().toISOString(),
       uptime: process.uptime(),
       ...(version && { version }),
-      ...(Object.keys(checkResults).length > 0 && { checks: checkResults }),
+      ...(checks.length > 0 && {
+        checks: checkResults,
+        durationMs: Date.now() - startTime,
+      }),
       ...customData,
     };