@djangocfg/nextjs 2.1.514 → 2.1.516

package/dist/pwa/manifest.mjs.map

@@ -0,0 +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":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/nextjs",
-  "version": "2.1.514",
+  "version": "2.1.516",
   "description": "Next.js server utilities: sitemap, health, OG images, contact forms, navigation, config",
   "keywords": [
     "nextjs",
@@ -64,6 +64,11 @@
       "import": "./dist/pwa/index.mjs",
       "default": "./dist/pwa/index.mjs"
     },
+    "./pwa/manifest": {
+      "types": "./dist/pwa/manifest.d.mts",
+      "import": "./dist/pwa/manifest.mjs",
+      "default": "./dist/pwa/manifest.mjs"
+    },
     "./pwa/worker": {
       "types": "./dist/pwa/worker/index.d.mts",
       "import": "./dist/pwa/worker/index.mjs",
@@ -144,9 +149,9 @@
     "ai-docs": "tsx src/ai/cli.ts"
   },
   "peerDependencies": {
-    "@djangocfg/devtools": "^2.1.514",
-    "@djangocfg/i18n": "^2.1.514",
-    "@djangocfg/ui-core": "^2.1.514",
+    "@djangocfg/devtools": "^2.1.516",
+    "@djangocfg/i18n": "^2.1.516",
+    "@djangocfg/ui-core": "^2.1.516",
     "next": "^16.2.2"
   },
   "peerDependenciesMeta": {
@@ -168,11 +173,11 @@
     "serwist": "^9.5.11"
   },
   "devDependencies": {
-    "@djangocfg/devtools": "^2.1.514",
-    "@djangocfg/i18n": "^2.1.514",
-    "@djangocfg/layouts": "^2.1.514",
-    "@djangocfg/typescript-config": "^2.1.514",
-    "@djangocfg/ui-core": "^2.1.514",
+    "@djangocfg/devtools": "^2.1.516",
+    "@djangocfg/i18n": "^2.1.516",
+    "@djangocfg/layouts": "^2.1.516",
+    "@djangocfg/typescript-config": "^2.1.516",
+    "@djangocfg/ui-core": "^2.1.516",
     "@types/node": "^25.9.5",
     "@types/react": "19.2.15",
     "@types/react-dom": "19.2.3",

package/src/config/packages/installer.ts

@@ -8,6 +8,8 @@ import chalk from 'chalk';
 import { execSync, spawn } from 'child_process';
 import Conf from 'conf';
 import consola from 'consola';
+import { existsSync } from 'fs';
+import { join } from 'path';
 import { createInterface } from 'readline';
 
 import { isCI } from '../utils/env';
@@ -84,13 +86,11 @@ export interface InstallProgress {
 export function detectPackageManager(): 'pnpm' | 'yarn' | 'npm' {
   try {
     // Check for lockfiles
-    const fs = require('fs');
-    const path = require('path');
     const cwd = process.cwd();
 
-    if (fs.existsSync(path.join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
-    if (fs.existsSync(path.join(cwd, 'yarn.lock'))) return 'yarn';
-    if (fs.existsSync(path.join(cwd, 'package-lock.json'))) return 'npm';
+    if (existsSync(join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
+    if (existsSync(join(cwd, 'yarn.lock'))) return 'yarn';
+    if (existsSync(join(cwd, 'package-lock.json'))) return 'npm';
 
     // Check for global package manager
     try {

package/src/config/packages/updater.ts

@@ -8,6 +8,7 @@ import chalk from 'chalk';
 import { spawn } from 'child_process';
 import Conf from 'conf';
 import consola from 'consola';
+import { existsSync, readFileSync } from 'fs';
 import { createRequire } from 'module';
 import { join } from 'path';
 import { createInterface } from 'readline';
@@ -86,9 +87,8 @@ export interface UpdateOptions {
  */
 function isWorkspacePackage(packageName: string): boolean {
   try {
-    const fs = require('fs');
     const pkgJsonPath = join(process.cwd(), 'package.json');
-    const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8'));
+    const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
 
     const deps = { ...pkgJson.dependencies, ...pkgJson.devDependencies };
     const version = deps[packageName];
@@ -104,35 +104,36 @@ function isWorkspacePackage(packageName: string): boolean {
  * Uses multiple fallback strategies for monorepo compatibility
  */
 export function getInstalledVersion(packageName: string): string | null {
-  const fs = require('fs');
   const cwd = process.cwd();
 
   // Strategy 1: Direct read from node_modules (works with symlinks)
   try {
     const directPath = join(cwd, 'node_modules', packageName, 'package.json');
-    if (fs.existsSync(directPath)) {
-      const pkg = JSON.parse(fs.readFileSync(directPath, 'utf-8'));
+    if (existsSync(directPath)) {
+      const pkg = JSON.parse(readFileSync(directPath, 'utf-8'));
       return pkg.version || null;
     }
   } catch {
     // Continue to next strategy
   }
 
-  // Strategy 2: Use createRequire from cwd
+  // Strategy 2: Resolve from the consumer's project root. `createRequire` is the
+  // ESM-safe way to do this — a bare `require()` here does not exist once tsup
+  // emits an .mjs bundle, and its shim throws rather than falling through to the
+  // next strategy.
   try {
     const consumerRequire = createRequire(join(cwd, 'package.json'));
     const pkgPath = consumerRequire.resolve(`${packageName}/package.json`);
-    const pkg = require(pkgPath);
-    return pkg.version || null;
+    return JSON.parse(readFileSync(pkgPath, 'utf-8')).version || null;
   } catch {
     // Continue to next strategy
   }
 
-  // Strategy 3: Try global require
+  // Strategy 3: Resolve relative to THIS module, for the hoisted/global case.
   try {
-    const pkgPath = require.resolve(`${packageName}/package.json`);
-    const pkg = require(pkgPath);
-    return pkg.version || null;
+    const localRequire = createRequire(import.meta.url);
+    const pkgPath = localRequire.resolve(`${packageName}/package.json`);
+    return JSON.parse(readFileSync(pkgPath, 'utf-8')).version || null;
   } catch {
     return null;
   }

package/src/config/plugins/compression.ts

@@ -5,8 +5,14 @@
  */
 
 import type { Configuration as WebpackConfig } from 'webpack';
+import { createRequire } from 'module';
+
 import { isPackageInstalled } from '../packages/checker';
 
+// Optional peer dependencies are loaded synchronously at config time, which
+// `import()` cannot do. `createRequire` is the ESM-safe equivalent of `require`.
+const requirePeer = createRequire(import.meta.url);
+
 export interface CompressionPluginOptions {
   /** Enable gzip compression */
   gzip?: boolean;
@@ -45,9 +51,8 @@ export function addCompressionPlugins(
   const opts = { ...DEFAULT_OPTIONS, ...options };
 
   try {
-    // Dynamic import to avoid bundling if not installed
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const CompressionPlugin = require('compression-webpack-plugin');
+    // Resolved at call time to avoid bundling it when it is not installed.
+    const CompressionPlugin = requirePeer('compression-webpack-plugin');
 
     if (!config.plugins) {
       config.plugins = [];

package/src/config/plugins/devStartup.ts

@@ -6,6 +6,8 @@
 
 import type { Compiler } from 'webpack';
 import chalk from 'chalk';
+import { existsSync } from 'fs';
+import { join } from 'path';
 
 import { AI_DOCS_HINT } from '../../ai/constants';
 import { DJANGO_CFG_BANNER } from '../constants';
@@ -88,15 +90,12 @@ export class DevStartupPlugin {
   }
 
   private checkPWASetup(): void {
-    const fs = require('fs');
-    const path = require('path');
-
     const cwd = process.cwd();
-    const swPath = path.join(cwd, 'app', 'sw.ts');
-    const manifestPath = path.join(cwd, 'app', 'manifest.ts');
+    const swPath = join(cwd, 'app', 'sw.ts');
+    const manifestPath = join(cwd, 'app', 'manifest.ts');
 
-    const hasSW = fs.existsSync(swPath);
-    const hasManifest = fs.existsSync(manifestPath);
+    const hasSW = existsSync(swPath);
+    const hasManifest = existsSync(manifestPath);
 
     if (hasSW || hasManifest) {
       console.log(chalk.cyan('  📱 PWA Configuration:'));

package/src/config/utils/version.ts

@@ -5,6 +5,8 @@
 import chalk from 'chalk';
 import Conf from 'conf';
 import consola from 'consola';
+import { readFileSync } from 'fs';
+import { createRequire } from 'module';
 import semver from 'semver';
 
 import { DJANGOCFG_PACKAGES, PACKAGE_NAME, VERSION_CACHE_TTL_MS } from '../constants';
@@ -55,9 +57,13 @@ const versionCache = createVersionCache();
  */
 export function getCurrentVersion(): string | null {
   try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const packageJson = require('../../../package.json');
-    return packageJson.version || null;
+    // `createRequire(import.meta.url).resolve` rather than a bare `require`: the
+    // published bundle is ESM, where `require` does not exist. Resolving is only
+    // used to locate the file — the read itself goes through `fs`, so this does
+    // not depend on JSON-module import support.
+    const localRequire = createRequire(import.meta.url);
+    const pkgPath = localRequire.resolve('../../../package.json');
+    return JSON.parse(readFileSync(pkgPath, 'utf-8')).version || null;
   } catch {
     return null;
   }

package/src/pwa/plugin.ts

@@ -9,6 +9,11 @@
 
 import type { NextConfig } from 'next';
 import { consola } from 'consola';
+import { createRequire } from 'module';
+
+// Serwist is an optional peer loaded synchronously at config time, which
+// `import()` cannot do. `createRequire` is the ESM-safe equivalent of `require`.
+const requirePeer = createRequire(import.meta.url);
 
 export interface PWAPluginOptions {
   /**
@@ -117,7 +122,7 @@ export function withPWA(
       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,