@bymaksym/loadline 1.0.0 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +211 -43
- package/dist/cli/cli/args.js +79 -128
- package/dist/cli/cli/gates.js +80 -14
- package/dist/cli/cli/main.js +164 -33
- package/dist/cli/cli/memory.js +40 -4
- package/dist/cli/cli/{declared.js → read/declared.js} +1 -1
- package/dist/cli/cli/read/locate.js +214 -0
- package/dist/cli/cli/{read-build.js → read/read-build.js} +149 -84
- package/dist/cli/cli/read/read-config.js +120 -0
- package/dist/cli/cli/{html-report.js → render/html-report.js} +14 -10
- package/dist/cli/cli/render/render-agent.js +114 -0
- package/dist/cli/cli/render/render-asked.js +104 -0
- package/dist/cli/cli/render/render-badge.js +140 -0
- package/dist/cli/cli/{render-json.js → render/render-json.js} +18 -5
- package/dist/cli/cli/{render-markdown.js → render/render-markdown.js} +5 -5
- package/dist/cli/cli/{render-pr.js → render/render-pr.js} +33 -13
- package/dist/cli/cli/{render-sarif.js → render/render-sarif.js} +8 -3
- package/dist/cli/cli/{render-text.js → render/render-text.js} +118 -111
- package/dist/cli/cli/render/terminal.js +55 -0
- package/dist/cli/cli/report.js +68 -27
- package/dist/cli/cli/self-check.js +19 -23
- package/dist/cli/cli/since-last.js +2 -2
- package/dist/cli/cli/text/text-errors.js +124 -0
- package/dist/cli/cli/text/text.js +343 -0
- package/dist/cli/cli/text/usage.js +240 -0
- package/dist/cli/src/app/core/analysis/analysis.js +63 -23
- package/dist/cli/src/app/core/analysis/{barrels.js → graph/barrels.js} +1 -1
- package/dist/cli/src/app/core/analysis/{blast.js → graph/blast.js} +56 -17
- package/dist/cli/src/app/core/analysis/{cycles.js → graph/cycles.js} +1 -1
- package/dist/cli/src/app/core/analysis/{importers.js → graph/importers.js} +1 -1
- package/dist/cli/src/app/core/analysis/{insights.js → graph/insights.js} +10 -4
- package/dist/cli/src/app/core/analysis/invariant.js +1 -1
- package/dist/cli/src/app/core/analysis/metafile.types.js +7 -1
- package/dist/cli/src/app/core/analysis/{delivery.js → screens/delivery.js} +1 -1
- package/dist/cli/src/app/core/analysis/{entries.js → screens/entries.js} +50 -9
- package/dist/cli/src/app/core/analysis/screens/marks.js +32 -0
- package/dist/cli/src/app/core/analysis/screens/route-files.js +116 -0
- package/dist/cli/src/app/core/analysis/{sourcemap.js → sourcemap/sourcemap.js} +106 -7
- package/dist/cli/src/app/core/analysis/{split-drift.js → sourcemap/split-drift.js} +1 -1
- package/dist/cli/src/app/core/analysis/tool.js +83 -0
- package/dist/cli/src/app/core/assets/assets.js +134 -15
- package/dist/cli/src/app/core/baseline/baseline.js +0 -0
- package/dist/cli/src/app/core/{intake → build-text}/index-html.js +168 -13
- package/dist/cli/src/app/core/build-text/route-table.js +178 -0
- package/dist/cli/src/app/core/build-text/tool-marks.js +54 -0
- package/dist/cli/src/app/core/caching/caching.js +121 -43
- package/dist/cli/src/app/core/caching/from-analysis.js +20 -4
- package/dist/cli/src/app/core/config/config-text.js +90 -0
- package/dist/cli/src/app/core/config/config-values.js +358 -0
- package/dist/cli/src/app/core/config/loadline-config.js +81 -16
- package/dist/cli/src/app/core/config/merge-config.js +98 -0
- package/dist/cli/src/app/core/deps/deps.js +104 -16
- package/dist/cli/src/app/core/export/summary.js +29 -5
- package/dist/cli/src/app/core/findings/actions.js +3 -1
- package/dist/cli/src/app/core/findings/{boot-single.js → bundle/boot-single.js} +3 -3
- package/dist/cli/src/app/core/findings/{dupes.js → bundle/dupes.js} +8 -5
- package/dist/cli/src/app/core/findings/{graph.js → bundle/graph.js} +30 -18
- package/dist/cli/src/app/core/findings/{own-in-boot.js → bundle/own-in-boot.js} +9 -5
- package/dist/cli/src/app/core/findings/{requests.js → bundle/requests.js} +3 -3
- package/dist/cli/src/app/core/findings/{shipped.js → bundle/shipped.js} +28 -14
- package/dist/cli/src/app/core/findings/compose.js +6 -1
- package/dist/cli/src/app/core/findings/effort.js +2 -0
- package/dist/cli/src/app/core/findings/finding.types.js +1 -0
- package/dist/cli/src/app/core/findings/findings.js +48 -19
- package/dist/cli/src/app/core/findings/{assets.js → folder/assets.js} +38 -14
- package/dist/cli/src/app/core/findings/{caching.js → folder/caching.js} +16 -9
- package/dist/cli/src/app/core/findings/{page.js → folder/page.js} +6 -2
- package/dist/cli/src/app/core/findings/{scan.js → folder/scan.js} +25 -11
- package/dist/cli/src/app/core/findings/kind-names.js +163 -0
- package/dist/cli/src/app/core/findings/{deps.js → supplied/deps.js} +13 -8
- package/dist/cli/src/app/core/findings/supplied/forbidden.js +71 -0
- package/dist/cli/src/app/core/findings/{situation.js → supplied/situation.js} +2 -2
- package/dist/cli/src/app/core/findings/text/causes.js +39 -0
- package/dist/cli/src/app/core/findings/{finding-html.js → text/finding-html.js} +8 -1
- package/dist/cli/src/app/core/findings/{finding-text.js → text/finding-text.js} +208 -77
- package/dist/cli/src/app/core/findings/text/tool-advice.js +97 -0
- package/dist/cli/src/app/core/format/format.utils.js +158 -11
- package/dist/cli/src/app/core/format/ownership.js +93 -0
- package/dist/cli/src/app/core/i18n/en.js +76 -17
- package/dist/cli/src/app/core/i18n/es.js +82 -22
- package/dist/cli/src/app/core/intake/bundle-graph.js +281 -43
- package/dist/cli/src/app/core/intake/dist-files.js +82 -14
- package/dist/cli/src/app/core/intake/embedded.js +11 -1
- package/dist/cli/src/app/core/intake/unreached.js +139 -0
- package/dist/cli/src/app/core/intake/webpack-modules.js +185 -0
- package/dist/cli/src/app/core/intake/webpack-stats.js +298 -0
- package/dist/cli/src/app/core/project/project-context.js +16 -4
- package/dist/cli/src/app/core/project/project-name.js +36 -0
- package/dist/cli/src/app/core/scan/scan.js +58 -19
- package/dist/cli/src/app/core/scan/secrets.js +23 -3
- package/dist/cli/src/app/core/situation/situation-text.js +23 -0
- package/dist/cli/src/app/core/situation/situation.js +6 -4
- package/dist/cli/src/app/core/timing/timing.js +5 -2
- package/dist/cli/src/app/core/whatif/defer.js +29 -4
- package/dist/cli/src/app/core/whatif/source-importers.js +58 -0
- package/dist/cli/src/app/core/whatif/why.js +102 -0
- package/docs/CONFIG-REFERENCE.md +230 -0
- package/docs/CONFIG.md +511 -0
- package/docs/HOW-IT-WORKS.md +286 -25
- package/loadline.html +24 -20
- package/loadline.schema.json +1209 -0
- package/package.json +35 -29
- package/dist/cli/cli/locate.js +0 -60
- package/dist/cli/cli/text.js +0 -215
- /package/dist/cli/cli/{read-build.types.js → read/read-build.types.js} +0 -0
- /package/dist/cli/cli/{render-json.types.js → render/render-json.types.js} +0 -0
- /package/dist/cli/cli/{text.types.js → text/text.types.js} +0 -0
- /package/dist/cli/src/app/core/analysis/{exclusive.js → graph/exclusive.js} +0 -0
- /package/dist/cli/src/app/core/analysis/{insights.types.js → graph/insights.types.js} +0 -0
- /package/dist/cli/src/app/core/analysis/{module-graph.js → graph/module-graph.js} +0 -0
- /package/dist/cli/src/app/core/analysis/{sourcemap.types.js → sourcemap/sourcemap.types.js} +0 -0
- /package/dist/cli/src/app/core/findings/{finding-plain.js → text/finding-plain.js} +0 -0
|
@@ -50,7 +50,7 @@ exports.ES = {
|
|
|
50
50
|
compareVersionsHelp: 'Se leen de la ruta de instalación, y la versión ahí solo la escribe pnpm. Con npm o yarn la columna sale vacía porque no se ha podido leer nada — que no es lo mismo que decir que las versiones coinciden.',
|
|
51
51
|
compareVersionUnknown: 'no se puede leer',
|
|
52
52
|
compareVersionsNote: 'Ninguna ruta de instalación traía la versión, así que no se han podido leer. Eso es un hueco en lo que dicen estos ficheros, no un hallazgo de que todo coincide: pnpm escribe la versión en la ruta, npm y yarn no.',
|
|
53
|
-
compareRejected: files => `No es una compilación: ${files.join(', ')}. Cada fichero tiene que ser un stats.json (un metafile de esbuild).`,
|
|
53
|
+
compareRejected: files => `No es una compilación: ${files.join(', ')}. Cada fichero tiene que ser un stats.json (un metafile de esbuild o las stats de webpack).`,
|
|
54
54
|
secCriteria: 'Criterios de valoración',
|
|
55
55
|
secCriteriaSub: 'Con qué umbrales se dice «bien», «normal» o «mal», y cuándo salta cada señal. Se pueden cambiar.',
|
|
56
56
|
howToCriteria: '<p>Cada cifra valorada del informe se compara con dos umbrales: hasta el primero es <strong>bien</strong>, hasta el segundo <strong>normal</strong>, por encima <strong>mal</strong>. Los criterios de la segunda y tercera sección son los que disparan las señales.</p><p><strong>De dónde salen los recomendados.</strong> Con cifras comprimidas, 170 kB de JavaScript inicial es el presupuesto habitual para que una página responda en pocos segundos en un móvil medio; 350 kB es el doble. Con cifras en crudo, 500 kB y 1 MB son los valores que Angular CLI escribe por defecto en <code>angular.json</code>. Los de pantalla y de código propio son múltiplos de esos. Los de las señales que son proporciones —cobertura, número de importadores— no dependen de la unidad. Los que son tamaños sí: un mínimo de 50 kB aplicado a cifras comprimidas es tres veces más estricto que el mismo mínimo en crudo, así que bajan con la misma proporción que los demás.</p><p>Lo que cambies se guarda en este navegador, por separado para crudo y comprimido, y se aplica al momento a las valoraciones y a las señales. Un valor igual al recomendado deja de contar como personalizado.</p>',
|
|
@@ -222,7 +222,7 @@ exports.ES = {
|
|
|
222
222
|
unitImporters: 'ficheros',
|
|
223
223
|
unitTrips: 'idas y vueltas',
|
|
224
224
|
unitMs: 'ms',
|
|
225
|
-
treePin: 'Fijar este
|
|
225
|
+
treePin: 'Fijar este chunk arriba, para compararlo con otro',
|
|
226
226
|
treeUnpin: 'Dejar de fijarlo arriba',
|
|
227
227
|
tagline: 'peso por pantalla',
|
|
228
228
|
lede: 'Qué descarga quien abre cada pantalla de tu aplicación, cuánto de eso lo paga también todo el mundo, y qué conviene mover de sitio.',
|
|
@@ -233,14 +233,14 @@ exports.ES = {
|
|
|
233
233
|
searchKeys: 'Ctrl K',
|
|
234
234
|
homeAria: 'Loadline: cambiar lo cargado',
|
|
235
235
|
buildChipHelp: 'Cambiar lo que está cargado',
|
|
236
|
-
intakeRequired: 'obligatorio',
|
|
236
|
+
intakeRequired: 'obligatorio · uno de los dos',
|
|
237
237
|
intakeOptional: 'Opcional · cada uno añade detalle, ahora o más tarde',
|
|
238
238
|
intakeBack: 'Volver al informe',
|
|
239
239
|
contextRawNote: 'Cifras en crudo: bytes en disco, no lo que viaja',
|
|
240
240
|
contextAddDetail: 'Añadir detalle:',
|
|
241
241
|
contextAddDist: 'carpeta browser/ → cifras comprimidas',
|
|
242
242
|
contextAddBaseline: 'línea base → comparar',
|
|
243
|
-
contextAddContext: '
|
|
243
|
+
contextAddContext: 'package.json + angular.json → nombre, presupuestos',
|
|
244
244
|
heroCaptionBoot: boot => `${boot} que el bundler marca como inicial`,
|
|
245
245
|
heroCaptionExtra: (extra, chunks, ratio) => `${extra} en ${chunks === 1 ? 'un chunk marcado' : `${chunks} chunks marcados`} como lazy que cargan igualmente al menos el ${(0, ui_strings_1.pct)(ratio)} de las pantallas.`,
|
|
246
246
|
heroCaptionSame: 'Ningún chunk lazy lo cargan suficientes pantallas como para sumarse.',
|
|
@@ -273,9 +273,10 @@ exports.ES = {
|
|
|
273
273
|
keyClose: 'Cerrar esto, y cerrar una explicación abierta',
|
|
274
274
|
keyHelp: 'Esta lista',
|
|
275
275
|
keyTabs: 'Entre pestañas, con una pestaña enfocada',
|
|
276
|
-
drop1Title: 'Suelta aquí tu stats.json',
|
|
277
|
-
drop1Body: '
|
|
276
|
+
drop1Title: 'Suelta aquí tu carpeta de build o su stats.json',
|
|
277
|
+
drop1Body: 'La carpeta de build basta para cualquier cosa que emita módulos ES —Vite, Rollup, SvelteKit, Nuxt, Astro, esbuild—, porque sus chunks llevan el grafo de importaciones. Angular escribe un <code>stats.json</code> con <code>ng build --stats-json</code>, esbuild un <code>metafile</code> y webpack sus stats con <code>--json</code> —Angular 16 o anterior, Create React App, Vue CLI—, y cualquiera de ellos es más exacto que la carpeta sola. Se procesa en tu navegador: no sale de tu equipo.',
|
|
278
278
|
drop1Btn: 'Elegir stats.json',
|
|
279
|
+
drop1FolderBtn: 'Elegir carpeta de build',
|
|
279
280
|
sampleBtn: 'Ver un ejemplo',
|
|
280
281
|
sampleLoaded: outputs => `Compilación de ejemplo · ${outputs} salidas · no es tu proyecto`,
|
|
281
282
|
sampleRemove: 'Cerrar el ejemplo',
|
|
@@ -291,7 +292,7 @@ exports.ES = {
|
|
|
291
292
|
statsIdle: 'Sin cargar',
|
|
292
293
|
distIdle: 'Sin cargar · cifras en crudo',
|
|
293
294
|
statsLoaded: (name, outputs) => `${name} · ${outputs} salidas`,
|
|
294
|
-
statsFromFolder: (name, outputs) => `${name} · ${outputs}
|
|
295
|
+
statsFromFolder: (name, outputs, opaque) => `${name} · ${outputs} chunks · grafo leído de la carpeta${opaque ? ' · sin source maps: no se puede medir qué hay dentro de cada chunk, ni por tanto ningún ahorro' : ''}`,
|
|
295
296
|
statsError: message => `No se ha podido leer: ${message}`,
|
|
296
297
|
distNoFiles: 'Esa carpeta no tiene ficheros de build',
|
|
297
298
|
distNoApi: 'Tu navegador no puede comprimir aquí; se mantienen las cifras en crudo',
|
|
@@ -300,20 +301,43 @@ exports.ES = {
|
|
|
300
301
|
distLoaded: files => `${files} ficheros · cifras comprimidas`,
|
|
301
302
|
distLoadedMaps: (files, maps) => `${files} ficheros · cifras comprimidas · ${maps} source maps leídos`,
|
|
302
303
|
distLoadedBrotli: 'brotli real de los .br',
|
|
304
|
+
distTextUnread: 'recuperada sin el texto de los chunks: vuelve a soltar la carpeta para buscar en ella secretos y restos',
|
|
303
305
|
distLoadedIndex: 'index.html leído',
|
|
304
306
|
splitExact: 'reparto de los source maps',
|
|
305
307
|
splitApprox: 'reparto del metafile',
|
|
306
308
|
serverIgnored: n => `${n === 1 ? '1 salida de servidor' : `${n} salidas de servidor`} fuera del análisis`,
|
|
307
|
-
serverIgnoredHelp: '
|
|
309
|
+
serverIgnoredHelp: 'Salidas del build que no están en la carpeta del navegador: casi siempre el bundle de servidor (renderizado en servidor), que nadie descarga y suele ser el más grande de los dos, así que se analiza solo la parte de navegador. También puede ser un fichero que se renombró después de compilarlo, como los polyfills es5 de Angular 8, que nadie descarga con ese nombre.',
|
|
310
|
+
offPageIgnored: ({ legacy, serviceWorker, server, ignored }) => `${[
|
|
311
|
+
legacy > 0 && `${legacy === 1 ? '1 fichero' : `${legacy} ficheros`} para navegadores sin módulos ES`,
|
|
312
|
+
serviceWorker > 0 &&
|
|
313
|
+
(serviceWorker === 1 ? 'el service worker' : `${serviceWorker} ficheros del service worker`),
|
|
314
|
+
server > 0 && `${server === 1 ? '1 fichero' : `${server} ficheros`} que solo corre el servidor`,
|
|
315
|
+
ignored > 0 && `${ignored === 1 ? '1 fichero' : `${ignored} ficheros`} que loadline.json ignora`,
|
|
316
|
+
]
|
|
317
|
+
.filter(Boolean)
|
|
318
|
+
.join(' y ')} fuera del análisis`,
|
|
319
|
+
offPageIgnoredHelp: 'Solo un navegador que no ejecuta módulos ES descarga la copia nomodule, un service worker corre al lado de la página y no como parte de una pantalla, los ficheros de FastBoot corren en el servidor, y build.ignore en loadline.json nombra lo que el equipo dice que ninguna pantalla descarga. Nada de eso está en las cifras de aquí, así que todas son lo que descarga un navegador actual.',
|
|
308
320
|
notScreensLabel: 'No cuentan como pantallas:',
|
|
309
|
-
notScreenKind: {
|
|
321
|
+
notScreenKind: {
|
|
322
|
+
block: 'bloque lazy dentro de una pantalla',
|
|
323
|
+
grouper: 'agrupa rutas',
|
|
324
|
+
data: 'datos',
|
|
325
|
+
package: 'paquete bajo demanda',
|
|
326
|
+
worker: 'web worker',
|
|
327
|
+
onDemand: 'no lo abre ninguna ruta',
|
|
328
|
+
},
|
|
310
329
|
blocksHelp: 'Un @defer de Angular, o un lazy() dentro de un componente, produce un chunk lazy igual que una ruta. No es una pantalla: nadie entra en él, se carga cuando se dispara dentro de la pantalla que lo contiene. Contarlo como pantalla subiría el número de pantallas y bajaría la mediana con algo que nadie abre. Lo que el grafo no puede decir es CUÁNDO se dispara: un bloque detrás de un botón son bytes que nadie paga hasta pulsarlo, mientras que uno que se importa al montar la pantalla baja con la primera pintura, y entonces la pantalla pesa más de lo que dice su fila. Aquí los dos son idénticos. La pestaña Medido es la que lo resuelve.',
|
|
311
330
|
groupersHelp: 'Un fichero que no aporta prácticamente nada propio a su chunk y solo tiene importaciones dinámicas está agrupando rutas, se llame como se llame. Lo que carga son las pantallas; él no es una. Eso se mide, no se lee del nombre del fichero, así que vale también en un proyecto que no nombre sus ficheros como Angular.',
|
|
312
331
|
dataHelp: 'Un fichero de idioma, una tabla de países, un diccionario: un import() de un .json produce un chunk lazy igual que una ruta. Nadie navega a uno, y una aplicación que carga cincuenta idiomas bajo demanda saldría con cincuenta pantallas. Lo que hay que decidir con estos no es si son pantalla, sino si esos datos tienen que viajar dentro del bundle.',
|
|
332
|
+
packagesHelp: 'Un paquete con un import() propio: una librería de diagramas, una de fórmulas matemáticas. Nadie navega a él, y cuándo se pide es lo que el grafo no puede decir, así que no entra en el total de ninguna pantalla.',
|
|
333
|
+
workersHelp: 'Código que arranca con new Worker(): se ejecuta fuera de la página, en un chunk propio, cuando la página lo arranca. No es una pantalla ni entra en ningún total.',
|
|
334
|
+
onDemandHelp: 'El código trae una tabla de rutas y ninguna de sus rutas importa este chunk: es un componente, una pestaña o un fichero de idioma que se carga dentro de una página, no un sitio al que se navega. Si aun así es una ruta, cuéntalo como pantalla.',
|
|
335
|
+
noRouteTable: 'No se ha encontrado una tabla de rutas en el código, así que cada chunk que se carga en diferido cuenta como pantalla: alguna puede ser una pestaña o un componente dentro de una página y no un sitio al que se navega.',
|
|
336
|
+
routeCss: (count, list) => `Las pantallas también cargan ${count === 1 ? 'una hoja de estilos propia' : `${count} hojas de estilos propias`} (${list}), que sus totales no cuentan: estas cifras son JavaScript.`,
|
|
313
337
|
markScreen: 'Contar como pantalla',
|
|
314
|
-
markScreenHelp: 'Mete esta entrada en la tabla como pantalla propia. Distinguir una pantalla de un
|
|
338
|
+
markScreenHelp: 'Mete esta entrada en la tabla como pantalla propia. Distinguir una pantalla de un chunk de pantalla se hace en parte leyendo nombres de fichero, y no hay juego de nombres que valga para todos los proyectos: esta es la salida que no obliga a Loadline a aprenderse el tuyo.',
|
|
315
339
|
markBlock: 'No es una pantalla',
|
|
316
|
-
markBlockHelp: 'Saca esta fila de la tabla: es un
|
|
340
|
+
markBlockHelp: 'Saca esta fila de la tabla: es un chunk de otra pantalla, no un sitio al que se navegue. Pasa a la lista de entradas que no son pantallas, arriba.',
|
|
317
341
|
marksNote: n => `${n === 1 ? '1 entrada reclasificada' : `${n} entradas reclasificadas`} a mano.`,
|
|
318
342
|
marksReset: 'Volver a las reglas',
|
|
319
343
|
splitHelp: 'Cuánto pesa cada fichero dentro de un chunk. Normalmente sale del metafile, y con esbuild esa cifra ya está minificada: comparada con los source maps de un build real, las dos coinciden dentro del 1 %. Si la carpeta trae los .js.map se usa la de los mapas, que es la misma cosa medida sobre el fichero generado.',
|
|
@@ -322,13 +346,12 @@ exports.ES = {
|
|
|
322
346
|
rereadBtn: 'Releer la carpeta',
|
|
323
347
|
rereadHelp: 'Vuelve a leer la misma carpeta de compilación, para después de recompilar. Solo sale donde el navegador puede quedarse con una carpeta, que no es desde una página file:// ni en todos los navegadores; en el resto, se vuelve a soltar la carpeta.',
|
|
324
348
|
drop3Title: 'La medición anterior',
|
|
325
|
-
drop3Body: 'El <code>stats.json</code> del build anterior, un análisis exportado desde Loadline, o la carpeta <code>browser/</code> anterior entera
|
|
349
|
+
drop3Body: 'El <code>stats.json</code> del build anterior, un análisis exportado desde Loadline, o la carpeta <code>browser/</code> anterior entera —con su <code>stats.json</code> o sin él, igual que se lee el build en pantalla— para comparar cifras comprimidas. Cada pantalla enseña cuánto ha cambiado y salta una señal si algo ha crecido o ha entrado en el bootstrap.',
|
|
326
350
|
drop3Btn: 'Elegir línea base',
|
|
327
351
|
drop3BtnDist: 'Elegir carpeta anterior',
|
|
328
|
-
baselineNoStats: 'La carpeta no contiene ningún stats.json.',
|
|
329
352
|
baselineWorking: 'Comprimiendo la carpeta anterior…',
|
|
330
353
|
drop4Title: 'El contexto del proyecto',
|
|
331
|
-
drop4Body: '<code>
|
|
354
|
+
drop4Body: '<code>package.json</code> da el nombre del proyecto y lo que pide directamente, que es lo que distingue un paquete que elegiste de uno que vino con otro. En un proyecto Angular, <code>angular.json</code> y el fichero del pipeline (<code>.gitlab-ci.yml</code> o el workflow de GitHub) dicen además dónde está el budget de tamaño y si la configuración que compila el pipeline lo aplica.',
|
|
332
355
|
drop4Btn: 'Elegir ficheros',
|
|
333
356
|
baselineIdle: 'Sin cargar · sin comparación',
|
|
334
357
|
baselineLoaded: (name, mode, screens) => `${name} · ${mode} · ${screens} pantallas`,
|
|
@@ -340,6 +363,8 @@ exports.ES = {
|
|
|
340
363
|
contextLoaded: files => files.join(' · '),
|
|
341
364
|
contextIgnored: files => `No reconocido: ${files.join(', ')}`,
|
|
342
365
|
contextShort: n => (n === 1 ? 'contexto: 1 fichero' : `contexto: ${n} ficheros`),
|
|
366
|
+
configExtends: names => `loadline.json hereda de ${names}, que la página no puede leer`,
|
|
367
|
+
configExtendsHelp: 'La página no tiene un disco en el que seguir "extends", así que aplica solo lo que dice este fichero. Ejecuta npx @bymaksym/loadline --print-config y suelta aquí lo que escribe: es el fichero con todo lo que hereda ya unido.',
|
|
343
368
|
contextRemove: 'Quitar contexto',
|
|
344
369
|
restorePrompt: (name, date) => `Este navegador guarda la última medición: ${name} · ${date}`,
|
|
345
370
|
restoreBtn: 'Restaurar',
|
|
@@ -426,6 +451,7 @@ exports.ES = {
|
|
|
426
451
|
tileBoot: 'Bootstrap declarado',
|
|
427
452
|
tileBootCss: (size, files, total) => `+ ${size} de CSS que la página pide${files > 1 ? ` en ${files} hojas` : ''} · ${total} antes de pintar`,
|
|
428
453
|
bootSplitRaw: total => `Paquetes y código tuyo se reparten en bytes en crudo, ${total} en total: un fichero comprimido no se puede dividir por lo que lleva dentro.`,
|
|
454
|
+
bootSplitUnknown: 'Cuánto es de paquetes y cuánto es código tuyo no se sabe: la carpeta no trae source maps, así que un chunk es un peso sin nada con nombre dentro. Construye con source maps, o añade el stats.json, para ver el reparto.',
|
|
429
455
|
tileBootSub: files => `lo que el bundler marca como inicial · ${files === 1 ? '1 fichero' : `${files} ficheros`}`,
|
|
430
456
|
tileScreens: 'Pantallas lazy',
|
|
431
457
|
tileScreensTypical: 'la típica cuesta',
|
|
@@ -515,7 +541,7 @@ exports.ES = {
|
|
|
515
541
|
legOwn: 'Propio de esta pantalla',
|
|
516
542
|
screensCaveat: 'Calculado recorriendo el grafo de importaciones, no medido.',
|
|
517
543
|
filterBoot: 'Filtrar paquetes',
|
|
518
|
-
filterShared: 'Filtrar
|
|
544
|
+
filterShared: 'Filtrar chunks',
|
|
519
545
|
filterScreens: 'Filtrar pantallas por nombre…',
|
|
520
546
|
sortByColumn: 'Ordenar por esta columna; otra vez, al revés',
|
|
521
547
|
shownCount: (shown, total) => (shown === total ? `${total} pantallas` : `${shown} de ${total} pantallas`),
|
|
@@ -798,6 +824,7 @@ exports.ES = {
|
|
|
798
824
|
helpBootPercent: 'Parte del bootstrap que ocupa esta entrada.',
|
|
799
825
|
helpBootOfBoot: 'del bootstrap',
|
|
800
826
|
helpBootLazyOnly: max => `Lo importan ${max} ficheros tuyos como mucho y al menos uno está en una pantalla lazy, así que se pueden mirar uno a uno. Si al abrirlos resulta que todos son lazy, este paquete se descarga en el bootstrap para gente que quizá no llegue nunca a esa pantalla.`,
|
|
827
|
+
helpImportsUnknown: 'No se sabe: una carpeta de build dice qué lleva cada chunk, no qué archivo importa a cuál. El stats.json lo dice.',
|
|
801
828
|
helpImportersNone: 'Ningún fichero tuyo lo importa directamente: lo importa otro paquete. No se quita desde tu código, sino desde el paquete que lo trae.',
|
|
802
829
|
bootChain: 'Cómo entra en el bootstrap',
|
|
803
830
|
bootChainNone: 'No se ha podido seguir desde el punto de entrada siguiendo imports estáticos.',
|
|
@@ -811,7 +838,7 @@ exports.ES = {
|
|
|
811
838
|
treeOwn: 'De una pantalla',
|
|
812
839
|
treeScreens: n => (n === 1 ? '1 pantalla' : `${n} pantallas`),
|
|
813
840
|
filterTree: 'Filtrar por chunk, paquete o carpeta…',
|
|
814
|
-
treeCrumbs: (n, total, line) => `${n}
|
|
841
|
+
treeCrumbs: (n, total, line) => `${n} chunks por debajo de ${line} · ${total} entre todos`,
|
|
815
842
|
treeNoMatch: 'Nada coincide con el filtro.',
|
|
816
843
|
shapeTitle: 'Cómo está repartido',
|
|
817
844
|
treeShare: (share, zone) => zone === 'boot'
|
|
@@ -873,14 +900,47 @@ exports.ES = {
|
|
|
873
900
|
noScreens: 'No se han detectado pantallas lazy. Toda la aplicación entra en el bootstrap.',
|
|
874
901
|
noShared: 'Ningún chunk lazy lo comparten dos pantallas.',
|
|
875
902
|
footer: 'Todo se calcula en tu navegador a partir del metafile: nada se sube a ningún sitio. Las cifras en crudo son bytes en disco; las comprimidas se calculan con gzip sobre los ficheros reales, que es lo que paga quien usa la aplicación. El navegador no sabe comprimir en brotli, así que esa cifra solo sale si la carpeta trae los .js.br ya comprimidos; si no los trae, cuenta con que en brotli sea entre un 15 % y un 20 % menos que el gzip que ves. Pulsa ? para ver los atajos de teclado.',
|
|
903
|
+
// --- three views drawn from figures the report already has ---
|
|
904
|
+
diffTitle: 'Qué ha cambiado en el bootstrap',
|
|
905
|
+
diffSub: (before, after, diff, baseline) => `${before} → ${after} (${diff}) frente a ${baseline}. Cada área es lo que pesa ahora esa parte; su color, cómo se ha movido.`,
|
|
906
|
+
diffChange: { new: 'nuevo', grew: 'creció', shrank: 'bajó', same: 'sin cambios', gone: 'ya no está' },
|
|
907
|
+
diffOwn: 'tu código',
|
|
908
|
+
diffGone: 'Ya no están en el bootstrap',
|
|
909
|
+
diffEstimated: 'Los cambios son pesos en crudo a la proporción en que se comprime el bootstrap: el tamaño correcto, no el exacto, y por eso el ≈.',
|
|
910
|
+
diffPackagesOnly: 'Solo paquetes: la línea base se exportó antes de que se guardaran las carpetas de tu propio código, así que se dibujan sin cambio.',
|
|
911
|
+
diffTile: (name, size, change) => `${name}, ${size}, ${change}`,
|
|
912
|
+
gridTitle: 'Pantallas × paquetes',
|
|
913
|
+
gridSub: 'Lo que descarga cada pantalla de cada paquete. Una columna llena de arriba abajo es algo que pagan todas las pantallas, lo usen o no.',
|
|
914
|
+
gridBoot: 'En el bootstrap',
|
|
915
|
+
gridLazy: 'Con la pantalla',
|
|
916
|
+
gridOwn: 'tu código',
|
|
917
|
+
gridRest: 'el resto',
|
|
918
|
+
gridTotal: 'Total de la pantalla',
|
|
919
|
+
gridCell: (screen, size, what) => `${screen} lleva ${size} de ${what}, en crudo, dentro de sus chunks`,
|
|
920
|
+
gridScale: { less: 'menos', more: 'más' },
|
|
921
|
+
gridRaw: 'Bytes minificados en crudo dentro de los chunks; el total va en la unidad del informe.',
|
|
922
|
+
tripsTitle: 'Cómo carga, viaje a viaje',
|
|
923
|
+
tripsNote: 'Una estimación, no una medición: las idas y vueltas del informe sobre un eje de tiempo, con un perfil de conexión estándar. Cada hueco es una ida y vuelta esperando antes del primer byte.',
|
|
924
|
+
tripsProfile: { slow4g: '4G lento', fast4g: '4G', cable: 'cable' },
|
|
925
|
+
tripsBoot: 'primera carga',
|
|
926
|
+
tripsScreen: 'esta pantalla',
|
|
927
|
+
tripLabel: index => `viaje ${index}`,
|
|
928
|
+
tripsWait: 'esperando',
|
|
929
|
+
tripsParse: 'parseo',
|
|
930
|
+
tripsTotal: (time, trips) => `≈ ${time} hasta tenerlo todo, en ${trips} ${trips === 1 ? 'viaje' : 'viajes'}`,
|
|
931
|
+
tripsAssumed: 'Sin index.html la primera carga se dibuja como un solo viaje: el grafo por sí solo no sabe cuáles de sus chunks nombra la página.',
|
|
932
|
+
tripBar: (index, wait, transfer, size, files) => `Viaje ${index}: ${wait} esperando, ${transfer} transfiriendo ${size} en ${files} ${files === 1 ? 'fichero' : 'ficheros'}`,
|
|
876
933
|
errNoEntries: 'El fichero no parece un metafile de esbuild: no hay puntos de entrada.',
|
|
877
934
|
errNoMain: 'No se ha podido identificar el punto de entrada principal.',
|
|
878
935
|
errNoOutputs: 'El JSON tiene forma de metafile pero no trae la clave "outputs".',
|
|
879
936
|
errNotMetafile: 'El JSON no es un metafile de ninguno de los formatos que se reconocen.',
|
|
880
|
-
errExpected: 'Se espera el
|
|
881
|
-
errNotEsmGraph: '
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
937
|
+
errExpected: 'Se espera la carpeta de build, la que tiene el index.html —basta para cualquier cosa que emita módulos ES: Vite, Rollup, SvelteKit, Nuxt, Astro—, o un fichero de stats: el metafile que escribe Angular 17 o posterior con `ng build --stats-json` (un objeto con "outputs" e "inputs"), o el stats.json de webpack (`webpack --json`).',
|
|
938
|
+
errNotEsmGraph: 'Los chunks de esta carpeta son salida de webpack o de Turbopack, no módulos ES: sus importaciones son números que resuelve el cargador en tiempo de ejecución, así que no hay grafo dentro de los ficheros que leer. El fichero de stats del build lo tiene, y Loadline lo lee: `ng build --stats-json` en Angular 16 o anterior, `webpack --json > stats.json`, `react-scripts build --stats` en Create React App, `vue-cli-service build --report-json` en Vue CLI. Ponlo en la carpeta, o suéltalo con ella, y las cifras siguen comprimidas. Next.js con Turbopack no escribe ese fichero.',
|
|
939
|
+
entryLabel: 'El script por el que arranca la aplicación, con * para el hash:',
|
|
940
|
+
entryBtn: 'Leer la carpeta con él',
|
|
941
|
+
errNoPage: 'Ningún index.html de la carpeta nombra un script de la carpeta por el que arranque la aplicación —ni <script src>, ni import(), ni un nombre de fichero en un script inline—, y sin él no hay forma de distinguir el chunk de entrada de uno compartido: el compilador escribe el código común dentro del chunk de entrada, así que la entrada acaba importada por sus propios hijos. Añade la página a la carpeta, carga el stats.json del build, o nombra el script por el que arranca: --entry "main.*.js" en el comando, el campo bajo este mensaje en la página, o { "build": { "entries": ["main.*.js"] } } en loadline.json.',
|
|
942
|
+
errFolderUnreadable: 'El navegador no ha dejado a esta página leer la carpeta que se ha soltado en ella. Chrome lo hace con una página abierta desde el disco (file://): la carpeta llega, y lo que falla es ver qué hay dentro. Elige la misma carpeta con «Elegir carpeta de build», que eso sí lo permite, o escribe la página con el build dentro: npx @bymaksym/loadline <carpeta> --html loadline.html --open.',
|
|
943
|
+
errWebpackStats: 'Es un stats.json de webpack sin ningún chunk que escriba un script, así que no hay nada que analizar: se escribió con `chunks` o `assets` desactivados. Vuelve a generarlo con los valores por defecto —`webpack --json > stats.json`, `ng build --stats-json`—, que traen los chunks, los módulos y por qué está cada módulo.',
|
|
944
|
+
errViteManifest: 'No es un metafile de esbuild, sino el manifest.json de Vite. No hace falta: suelta la carpeta compilada y Loadline lee el grafo de los propios chunks, que es donde Vite lo escribe de verdad.',
|
|
945
|
+
errVisualizer: 'No es un metafile de esbuild, sino la salida de rollup-plugin-visualizer. Loadline lee el metafile de esbuild, que es otra cosa.',
|
|
886
946
|
};
|