#Entradas basadas en configuración

Al usar entry y manifest en addfox.config.ts para la configuración basada en control, puedes:

• Personalizar rutas de entrada
• Sobrescribir resultados de descubrimiento automático
• Agregar entradas personalizadas (como capture, my-page, etc.)

Las entradas no listadas en entry aún se descubrirán automáticamente a través de las reglas basadas en archivos.

#Principios fundamentales

Consistente con las entradas basadas en archivos:

• La entrada debe ser JS/TS: La construcción se basa en Rsbuild, la entrada real solo puede ser archivos de script
• Manejo de HTML: Las entradas HTML integradas (popup/options, etc.) se generan automáticamente; cuando se usa plantilla HTML personalizada, el script de entrada debe marcarse mediante data-addfox-entry
• Al generar HTML automáticamente (sin plantilla personalizada): La página contiene <div id="root"></div>; El <title> usa manifest.name; El favicon se inyecta a través de <link rel="icon"> usando las rutas en manifest.icons. Al personalizar index.html, estos dos elementos no se inyectan automáticamente, necesitas escribirlos tú mismo.

#Formas de escritura de configuración

#1) Configurar entradas a través de entry

entry es un objeto: clave = nombre de entrada, valor = ruta o objeto de configuración.

#2) Configurar campos relacionados con entradas a través de manifest

En manifest puedes declarar campos de capacidad relacionados con entradas (como background, action.default_popup, content_scripts):

export default defineConfig({
  manifest: {
    manifest_version: 3,
    background: { service_worker: "background/index.js" },
    action: { default_popup: "popup/index.html" },
    content_scripts: [
      { matches: ["<all_urls>"], js: ["content/index.js"] },
    ],
  },
});

#3) Prioridad entre entry y manifest

Cuando ambos participan en la resolución de entradas, la prioridad es:

1. Configuración explícita en entry
2. Campos relacionados con entradas en manifest
3. Descubrimiento automático (basado en archivos)

Es decir: entry sobrescribe entradas del mismo nombre de otras fuentes.

#Ruta de cadena (recomendado)

El valor es la ruta relativa a baseDir (predeterminado app/):

#Forma de objeto: { src, html? }

Control más detallado:

#Entradas integradas y rutas de salida

Al configurar entradas integradas a través de entry, las rutas de salida predeterminadas son:

#Ejemplos de configuración

#Sobrescribir algunas entradas

// addfox.config.ts
import { defineConfig } from "addfox";

export default defineConfig({
  entry: {
    // Solo sobrescribir estas entradas, otras siguen descubriéndose automáticamente
    popup: "popup/main.tsx",
    options: "options/settings.tsx",
  },
});

#Configurar todas las entradas completamente

export default defineConfig({
  appDir: "src",
  entry: {
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    options: "options/index.tsx",
    sidepanel: "sidepanel/index.tsx",
  },
});

#Entrada personalizada + forzar generación de HTML

export default defineConfig({
  entry: {
    // Entrada integrada
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    
    // Entrada de página personalizada (generar HTML automáticamente)
    capture: { src: "pages/capture/index.tsx", html: true },
    
    // Entrada de página personalizada (usar plantilla)
    welcome: { src: "pages/welcome/index.tsx", html: "pages/welcome/template.html" },
    
    // Entrada solo script (sin HTML)
    worker: { src: "worker/index.ts", html: false },
  },
});

#Deshabilitar descubrimiento automático de entradas

Si necesitas controlar completamente todas las entradas manualmente:

export default defineConfig({
  entry: {
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    // ... Listar todas las entradas necesarias
  },
  // Mantener las opciones de configuración no deseadas sin definir, el framework solo procesará las entradas listadas en entry
});

#Reglas de resolución de rutas

#Relativo a baseDir

Todas las rutas en entry son relativas a baseDir, baseDir está determinado por appDir (predeterminado app):

export default defineConfig({
  appDir: "src",                    // baseDir = src/
  entry: {
    popup: "popup/index.ts",        // Apunta a src/popup/index.ts
  },
});

#Tabla rápida de rutas

#Siguientes pasos

• Entradas basadas en archivos — Conocer las reglas de descubrimiento automático
• Configuración de appDir — Modificar el directorio de código fuente
• Configuración de manifest — Configurar el manifiesto de extensión