@bymaksym/loadline 0.1.0 → 1.0.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 +66 -7
- package/dist/cli/cli/args.js +33 -3
- package/dist/cli/cli/declared.js +52 -0
- package/dist/cli/cli/html-report.js +107 -0
- package/dist/cli/cli/locate.js +60 -0
- package/dist/cli/cli/main.js +118 -5
- package/dist/cli/cli/memory.js +78 -0
- package/dist/cli/cli/read-build.js +8 -4
- package/dist/cli/cli/render-json.js +8 -5
- package/dist/cli/cli/render-markdown.js +1 -1
- package/dist/cli/cli/render-pr.js +5 -3
- package/dist/cli/cli/render-sarif.js +3 -3
- package/dist/cli/cli/render-text.js +63 -28
- package/dist/cli/cli/report.js +9 -3
- package/dist/cli/cli/since-last.js +45 -0
- package/dist/cli/cli/text.js +54 -19
- package/dist/cli/src/app/core/analysis/analysis.js +8 -4
- package/dist/cli/src/app/core/analysis/barrels.js +9 -2
- package/dist/cli/src/app/core/analysis/entries.js +41 -6
- package/dist/cli/src/app/core/analysis/metafile.types.js +14 -6
- package/dist/cli/src/app/core/analysis/split-drift.js +12 -6
- package/dist/cli/src/app/core/assets/assets.js +4 -2
- package/dist/cli/src/app/core/caching/caching.js +3 -3
- package/dist/cli/src/app/core/deps/deps.js +37 -7
- package/dist/cli/src/app/core/deps/pins.js +63 -0
- package/dist/cli/src/app/core/export/summary.js +27 -9
- package/dist/cli/src/app/core/findings/actions.js +63 -6
- package/dist/cli/src/app/core/findings/assets.js +30 -5
- package/dist/cli/src/app/core/findings/boot-single.js +76 -0
- package/dist/cli/src/app/core/findings/caching.js +1 -1
- package/dist/cli/src/app/core/findings/dupes.js +65 -0
- package/dist/cli/src/app/core/findings/effort.js +2 -0
- package/dist/cli/src/app/core/findings/finding-html.js +14 -1
- package/dist/cli/src/app/core/findings/finding-text.js +104 -31
- package/dist/cli/src/app/core/findings/finding.types.js +1 -0
- package/dist/cli/src/app/core/findings/findings.js +22 -38
- package/dist/cli/src/app/core/findings/graph.js +4 -4
- package/dist/cli/src/app/core/findings/scan.js +13 -3
- package/dist/cli/src/app/core/findings/shipped.js +3 -5
- package/dist/cli/src/app/core/format/format.utils.js +16 -9
- package/dist/cli/src/app/core/i18n/en.js +108 -48
- package/dist/cli/src/app/core/i18n/es.js +114 -50
- package/dist/cli/src/app/core/intake/bundle-graph.js +6 -5
- package/dist/cli/src/app/core/intake/dist-files.js +5 -2
- package/dist/cli/src/app/core/intake/embedded.js +46 -0
- package/dist/cli/src/app/core/intake/index-html.js +66 -16
- package/dist/cli/src/app/core/project/budget-advice.js +14 -10
- package/dist/cli/src/app/core/project/project-context.js +74 -16
- package/dist/cli/src/app/core/scan/scan.js +59 -21
- package/dist/cli/src/app/core/scan/secrets.js +0 -0
- package/dist/cli/src/app/core/situation/situation.js +3 -4
- package/dist/cli/src/app/state/report-messages.utils.js +1 -4
- package/loadline.html +22 -24
- package/package.json +60 -30
|
@@ -12,9 +12,9 @@ const ui_strings_1 = require("./ui-strings");
|
|
|
12
12
|
*/
|
|
13
13
|
exports.ES = {
|
|
14
14
|
verdictGood: 'Bien',
|
|
15
|
-
verdictOk: '
|
|
15
|
+
verdictOk: 'Regular',
|
|
16
16
|
verdictBad: 'Mal',
|
|
17
|
-
verdictRule: (ok, bad) => `Bien hasta ${ok} ·
|
|
17
|
+
verdictRule: (ok, bad) => `Bien hasta ${ok} · Regular hasta ${bad} · Mal por encima`,
|
|
18
18
|
verdictRuleCoverage: (wide, global) => `Poco compartido por debajo del ${wide} % de las pantallas · Muy compartido hasta el ${global} % · En la práctica bootstrap a partir del ${global} %`,
|
|
19
19
|
tabCriteria: 'Criterios',
|
|
20
20
|
tabCompare: 'Comparar',
|
|
@@ -25,6 +25,8 @@ exports.ES = {
|
|
|
25
25
|
compareAddCurrent: 'Añadir la compilación en pantalla',
|
|
26
26
|
compareClear: 'Vaciar',
|
|
27
27
|
compareRemove: 'Quitar',
|
|
28
|
+
compareState: builds => builds === 0 ? 'ninguna aplicación todavía · hacen falta dos' : `${builds} de 2 aplicaciones · falta una`,
|
|
29
|
+
compareEmptyTitle: 'Mira qué envían dos veces varias aplicaciones',
|
|
28
30
|
compareEmpty: 'Todavía no hay nada que comparar. Añade el stats.json de dos o más aplicaciones.',
|
|
29
31
|
compareNeedsTwo: 'Una aplicación no es una comparación. Añade al menos otra.',
|
|
30
32
|
compareBuild: 'Aplicación',
|
|
@@ -56,10 +58,9 @@ exports.ES = {
|
|
|
56
58
|
if (mode === 'brotli') {
|
|
57
59
|
return 'Estás editando los criterios para cifras en brotli, las reales de los ficheros .br de la carpeta. Son más bajos que los de gzip en la misma proporción en que brotli comprime mejor.';
|
|
58
60
|
}
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
return 'Estás editando los criterios para cifras en crudo. Con la carpeta de build cargada se aplican otros: el bootstrap, por ejemplo, pasa a 170 / 350 kB.';
|
|
61
|
+
return mode === 'gzip'
|
|
62
|
+
? 'Estás editando los criterios para cifras comprimidas en gzip (hay carpeta de build cargada).'
|
|
63
|
+
: 'Estás editando los criterios para cifras en crudo. Con la carpeta de build cargada se aplican otros: el bootstrap, por ejemplo, pasa a 170 / 350 kB.';
|
|
63
64
|
},
|
|
64
65
|
criteriaFigures: 'Cifras',
|
|
65
66
|
criteriaGzipBtn: 'gzip',
|
|
@@ -77,6 +78,7 @@ exports.ES = {
|
|
|
77
78
|
critGroupContext: 'Línea base y contexto del proyecto',
|
|
78
79
|
critOkUpTo: 'bien hasta',
|
|
79
80
|
critBadAbove: 'mal por encima de',
|
|
81
|
+
critColThreshold: 'Umbral · origen',
|
|
80
82
|
blastTitle: 'Si tocas este fichero',
|
|
81
83
|
blastBody: (chunks, screens, everyone) => `Se ${chunks === 1 ? 'invalida 1 chunk' : `invalidan ${chunks} chunks`}, y ${everyone
|
|
82
84
|
? 'los vuelve a descargar todo el que tuviera la versión anterior'
|
|
@@ -90,7 +92,7 @@ exports.ES = {
|
|
|
90
92
|
blastHub: (file, names) => `${file} lleva dentro los nombres de otros ${names} chunks, así que cualquier cosa que mueva uno de ellos mueve también este fichero, y este fichero moviéndose mueve todo lo que lo importa.`,
|
|
91
93
|
historyTitle: 'Mediciones guardadas en este navegador',
|
|
92
94
|
historyNote: 'Una cifra contra una línea base compara dos puntos y no dice nada de la forma que hay entre ellos. 950 → 1.017 es información; 820, 790, 910, 1.200, 970 es una historia, y enseña en qué semana entró el problema. Se guarda solo en ESTE navegador —sin cuenta y sin servidor—, así que la forma de compartirla es exportar el fichero.',
|
|
93
|
-
historyEmpty: '
|
|
95
|
+
historyEmpty: 'nada guardado todavía',
|
|
94
96
|
historyKeep: 'Guardar esta',
|
|
95
97
|
historyExport: 'Exportar la historia',
|
|
96
98
|
historyForget: 'Olvidarlo todo',
|
|
@@ -98,12 +100,16 @@ exports.ES = {
|
|
|
98
100
|
historyScreenPick: 'Y una pantalla:',
|
|
99
101
|
historyScreenNone: 'ninguna — solo el arranque',
|
|
100
102
|
historyScreenAbsent: 'esta pantalla no estaba en esa compilación',
|
|
101
|
-
actionsTitle: 'Qué arreglo primero',
|
|
102
|
-
actionsNote: 'Es un orden sobre las señales de abajo, no una selección: todas siguen estando.',
|
|
103
103
|
effortLabel: { config: 'configuración', import: 'un import', refactor: 'refactor', none: '' },
|
|
104
|
-
actionsTotal: count =>
|
|
104
|
+
actionsTotal: count => {
|
|
105
|
+
if (count === 1) {
|
|
106
|
+
return 'Arreglándola se quitarían';
|
|
107
|
+
}
|
|
108
|
+
return count === 2 ? 'Arreglando las dos se quitarían' : `Arreglando las ${count} se quitarían`;
|
|
109
|
+
},
|
|
105
110
|
actionsTotalAfter: 'de la primera carga y quedaría en unos',
|
|
106
111
|
actionsTotalNote: 'Bytes minificados en crudo dentro del chunk, y no se suman: el grafo se recorre una vez quitando de golpe todos los ficheros nombrados arriba, así que lo que se alcanza por dos caminos se cuenta una vez.',
|
|
112
|
+
actionsTotalNoteEstimated: 'Una estimación en bytes comprimidos: los bytes en crudo que se quitan, a la proporción en que se comprime el bootstrap, porque un módulo suelto no tiene tamaño comprimido propio. No se suman: el grafo se recorre una vez quitando de golpe todos los ficheros nombrados arriba, así que lo que se alcanza por dos caminos se cuenta una vez.',
|
|
107
113
|
thExclusive: 'Exclusivo',
|
|
108
114
|
helpExclusive: 'Lo que perdería la primera carga sin esta fila: la parte de su peso que no entra por ninguna otra vía. Es la cifra que dice si quitarla compensa una tarde —chart.js pesando 310 kB son 70 cuando 240 de ellos son d3, que además meten otras tres cosas—. Bytes minificados en crudo, dentro del chunk.',
|
|
109
115
|
helpExclusiveOf: percent => percent >= 100
|
|
@@ -221,6 +227,31 @@ exports.ES = {
|
|
|
221
227
|
tagline: 'peso por pantalla',
|
|
222
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.',
|
|
223
229
|
themeBtn: 'Cambiar tema',
|
|
230
|
+
themeToDark: 'Oscuro',
|
|
231
|
+
themeToLight: 'Claro',
|
|
232
|
+
searchBtn: 'Buscar',
|
|
233
|
+
searchKeys: 'Ctrl K',
|
|
234
|
+
homeAria: 'Loadline: cambiar lo cargado',
|
|
235
|
+
buildChipHelp: 'Cambiar lo que está cargado',
|
|
236
|
+
intakeRequired: 'obligatorio',
|
|
237
|
+
intakeOptional: 'Opcional · cada uno añade detalle, ahora o más tarde',
|
|
238
|
+
intakeBack: 'Volver al informe',
|
|
239
|
+
contextRawNote: 'Cifras en crudo: bytes en disco, no lo que viaja',
|
|
240
|
+
contextAddDetail: 'Añadir detalle:',
|
|
241
|
+
contextAddDist: 'carpeta browser/ → cifras comprimidas',
|
|
242
|
+
contextAddBaseline: 'línea base → comparar',
|
|
243
|
+
contextAddContext: 'angular.json + pipeline → presupuestos',
|
|
244
|
+
heroCaptionBoot: boot => `${boot} que el bundler marca como inicial`,
|
|
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
|
+
heroCaptionSame: 'Ningún chunk lazy lo cargan suficientes pantallas como para sumarse.',
|
|
247
|
+
kpiWorst: 'el peor',
|
|
248
|
+
provenanceTitle: 'De dónde salen estas cifras',
|
|
249
|
+
dataSourceShort: {
|
|
250
|
+
measured: 'lo informó un navegador',
|
|
251
|
+
derived: 'recorrido en el grafo de importaciones',
|
|
252
|
+
declared: 'una respuesta tuya',
|
|
253
|
+
unknown: 'gris a propósito',
|
|
254
|
+
},
|
|
224
255
|
densityCompact: 'Compacto',
|
|
225
256
|
densityComfortable: 'Cómodo',
|
|
226
257
|
densityHelp: 'Filas más juntas, para leer tablas largas en una pantalla ancha. Cambia el espaciado y nada más: no se va ninguna columna, ninguna cifra ni ningún color.',
|
|
@@ -233,8 +264,8 @@ exports.ES = {
|
|
|
233
264
|
paletteNone: 'Nada con ese nombre.',
|
|
234
265
|
paletteTab: 'pestaña',
|
|
235
266
|
paletteAction: 'acción',
|
|
236
|
-
paletteCount: (shown, total) => total > shown ? `${shown} de ${total} — la pestaña Buscar las nombra todas` :
|
|
237
|
-
paletteKeysHint: '
|
|
267
|
+
paletteCount: (shown, total) => total > shown ? `${shown} de ${total} — la pestaña Buscar las nombra todas` : String(total),
|
|
268
|
+
paletteKeysHint: '↵ abrir · esc cerrar · ? atajos',
|
|
238
269
|
keysTitle: 'Teclado',
|
|
239
270
|
keyJump: 'Ir a una pestaña, una pantalla o un paquete',
|
|
240
271
|
keySearch: 'Lo mismo, desde cualquier sitio que no sea un campo',
|
|
@@ -242,7 +273,7 @@ exports.ES = {
|
|
|
242
273
|
keyClose: 'Cerrar esto, y cerrar una explicación abierta',
|
|
243
274
|
keyHelp: 'Esta lista',
|
|
244
275
|
keyTabs: 'Entre pestañas, con una pestaña enfocada',
|
|
245
|
-
drop1Title: '
|
|
276
|
+
drop1Title: 'Suelta aquí tu stats.json',
|
|
246
277
|
drop1Body: 'Lo genera tu bundler con <code>ng build --stats-json</code> (Angular) o como <code>metafile</code> de esbuild. Se procesa en tu navegador: no sale de tu equipo.',
|
|
247
278
|
drop1Btn: 'Elegir stats.json',
|
|
248
279
|
sampleBtn: 'Ver un ejemplo',
|
|
@@ -251,7 +282,7 @@ exports.ES = {
|
|
|
251
282
|
diagnosticsBtn: 'Copiar diagnóstico',
|
|
252
283
|
diagnosticsCopied: 'Copiado',
|
|
253
284
|
diagnosticsHint: 'Unas treinta líneas con la forma de esta compilación y lo que Loadline decidió sobre ella. Los nombres de paquete van tal cual; cada ruta de tu propio código se sustituye por un hash estable. Pégalo en un issue.',
|
|
254
|
-
drop2Title: '
|
|
285
|
+
drop2Title: 'La carpeta de build',
|
|
255
286
|
drop2Body: 'Añade la carpeta <code>browser/</code> y las cifras pasan a ser <strong>comprimidas</strong>, que es lo que se descarga. Sin ella se muestran bytes en crudo. Si la carpeta trae los <code>.js.map</code>, además se lee de ellos lo que pesa cada fichero dentro de cada chunk, como <strong>segunda medición</strong> de lo que ya dice el metafile.',
|
|
256
287
|
drop2Btn: 'Elegir carpeta',
|
|
257
288
|
statsRemove: 'Quitar stats.json',
|
|
@@ -274,11 +305,10 @@ exports.ES = {
|
|
|
274
305
|
splitApprox: 'reparto del metafile',
|
|
275
306
|
serverIgnored: n => `${n === 1 ? '1 salida de servidor' : `${n} salidas de servidor`} fuera del análisis`,
|
|
276
307
|
serverIgnoredHelp: 'El build trae también el bundle de servidor (renderizado en servidor). Nadie lo descarga y suele ser el más grande de los dos, así que se analiza solo la parte de navegador.',
|
|
277
|
-
|
|
308
|
+
notScreensLabel: 'No cuentan como pantallas:',
|
|
309
|
+
notScreenKind: { block: 'bloque lazy dentro de una pantalla', grouper: 'agrupa rutas', data: 'datos' },
|
|
278
310
|
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.',
|
|
279
|
-
groupersNote: n => `${n === 1 ? '1 entrada lazy que solo agrupa rutas' : `${n} entradas lazy que solo agrupan rutas`}, que tampoco cuentan como pantalla:`,
|
|
280
311
|
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.',
|
|
281
|
-
dataNote: n => `${n === 1 ? '1 entrada lazy que es datos' : `${n} entradas lazy que son datos`}, no código al que se navegue:`,
|
|
282
312
|
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.',
|
|
283
313
|
markScreen: 'Contar como pantalla',
|
|
284
314
|
markScreenHelp: 'Mete esta entrada en la tabla como pantalla propia. Distinguir una pantalla de un trozo 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.',
|
|
@@ -289,21 +319,15 @@ exports.ES = {
|
|
|
289
319
|
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.',
|
|
290
320
|
intakeCompressed: unit => `cifras ${unit}`,
|
|
291
321
|
intakeRaw: 'cifras en crudo (bytes en disco)',
|
|
292
|
-
intakeAddDist: 'Añadir carpeta browser/ para ver cifras comprimidas',
|
|
293
322
|
rereadBtn: 'Releer la carpeta',
|
|
294
323
|
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.',
|
|
295
|
-
|
|
296
|
-
intakeShow: 'Ver zonas de carga',
|
|
297
|
-
intakeHide: 'Ocultar zonas de carga',
|
|
298
|
-
intakeAddBaseline: 'Añadir línea base para comparar',
|
|
299
|
-
intakeAddContext: 'Añadir angular.json y pipeline',
|
|
300
|
-
drop3Title: '3 · Opcional: la medición anterior',
|
|
324
|
+
drop3Title: 'La medición anterior',
|
|
301
325
|
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>) 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.',
|
|
302
326
|
drop3Btn: 'Elegir línea base',
|
|
303
327
|
drop3BtnDist: 'Elegir carpeta anterior',
|
|
304
328
|
baselineNoStats: 'La carpeta no contiene ningún stats.json.',
|
|
305
329
|
baselineWorking: 'Comprimiendo la carpeta anterior…',
|
|
306
|
-
drop4Title: '
|
|
330
|
+
drop4Title: 'El contexto del proyecto',
|
|
307
331
|
drop4Body: '<code>angular.json</code>, <code>package.json</code> y el fichero del pipeline (<code>.gitlab-ci.yml</code> o el workflow de GitHub). Con ellos se comprueba dónde está el budget de tamaño y si la configuración que compila el pipeline lo aplica.',
|
|
308
332
|
drop4Btn: 'Elegir ficheros',
|
|
309
333
|
baselineIdle: 'Sin cargar · sin comparación',
|
|
@@ -336,7 +360,9 @@ exports.ES = {
|
|
|
336
360
|
secProject: 'Contexto del proyecto',
|
|
337
361
|
secProjectSub: 'Dónde están los budgets de tamaño, qué compila el pipeline y si el budget se aplica.',
|
|
338
362
|
howToProject: '<p>Angular solo comprueba los budgets de tamaño (<code>budgets</code>) de la configuración con la que se compila. Si el budget está en <code>production</code> y el pipeline compila <code>preproduction</code>, el budget no se aplica nunca. Esta pestaña cruza las dos cosas: los budgets de cada configuración de <code>angular.json</code> y los comandos de build del pipeline, siguiendo los scripts de <code>package.json</code> (<code>pnpm run build:pre</code> → <code>ng build --configuration=preproduction</code>).</p><p>La comparación con el bootstrap se hace en crudo y solo con JavaScript, que es lo que mide Angular. Un budget de error a más del doble del bootstrap actual no salta nunca.</p>',
|
|
339
|
-
|
|
363
|
+
projectState: 'desconocido · ningún fichero del proyecto cargado',
|
|
364
|
+
projectEmptyTitle: 'Dónde están tus budgets de tamaño, y si se aplican',
|
|
365
|
+
projectEmpty: 'Añade angular.json, package.json y el fichero del pipeline. Loadline comprueba qué configuración compila el pipeline y si su budget la cubre.',
|
|
340
366
|
projectEmptyBtn: 'Elegir ficheros del proyecto',
|
|
341
367
|
projectBudgets: project => `Budgets del bootstrap por configuración · proyecto ${project}`,
|
|
342
368
|
projectPick: 'Aplicación',
|
|
@@ -371,8 +397,6 @@ exports.ES = {
|
|
|
371
397
|
projectBootRaw: size => `Bootstrap actual en crudo (solo JavaScript): ${size}`,
|
|
372
398
|
headLeadGzip: 'Antes de ver nada se descargan (en gzip)',
|
|
373
399
|
headLeadRaw: 'Antes de ver nada se descargan (sin comprimir)',
|
|
374
|
-
headFigure: (size, files) => `${size} · ${files} ficheros`,
|
|
375
|
-
headNote: (s, unit) => `La pantalla más cara es <strong>${s.label}</strong>, con ${s.total} en ${s.files} ficheros — de los cuales ${s.shared} los comparte con otras pantallas y solo ${s.own} son suyos. Cifras ${unit}.`,
|
|
376
400
|
unitGzip: 'comprimidas en gzip',
|
|
377
401
|
unitRaw: 'en crudo',
|
|
378
402
|
unitBrotli: 'comprimidas en brotli',
|
|
@@ -397,15 +421,12 @@ exports.ES = {
|
|
|
397
421
|
'<p><strong>Y comprobarlo.</strong> Guarda este build como línea base, haz el cambio y vuelve a medir. Si no baja donde esperabas, la causa era otra, y saberlo también sirve.</p>',
|
|
398
422
|
adviceBoot: 'Baja sacando del bootstrap lo que solo se usa en algunas pantallas. La pestaña Bootstrap lo lista por peso y marca en rojo los paquetes cuyo único consumidor está en una pantalla lazy: por ahí se empieza.',
|
|
399
423
|
adviceEffective: 'La diferencia con el bootstrap declarado son chunks que el bundler marca como lazy y descarga casi todo el mundo. No se corrige en el bootstrap, sino en esos chunks: pestaña Compartidos.',
|
|
400
|
-
adviceScreens: 'Es bootstrap + compartido + propio. Si la pantalla típica sale cara pero su código propio es pequeño, lo que hay que mirar es el bootstrap: bajarlo baja todas las pantallas a la vez.',
|
|
401
424
|
adviceShared: 'Un chunk que cargan casi todas las pantallas no mejora solo con partirlo. Compensa sacar de él lo que use una sola pantalla; lo que usan todas se seguirá descargando esté donde esté.',
|
|
402
425
|
adviceFindings: 'Cada señal trae qué hacer y qué no, con los ficheros concretos. Las importantes son las que afectan al bootstrap, o sea a lo que se descarga siempre; las de repasar son de una pantalla concreta o de un tamaño que puede estar justificado.',
|
|
403
426
|
tileBoot: 'Bootstrap declarado',
|
|
404
427
|
tileBootCss: (size, files, total) => `+ ${size} de CSS que la página pide${files > 1 ? ` en ${files} hojas` : ''} · ${total} antes de pintar`,
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
tileEffectiveSub: (extra, chunks, ratio) => `+${extra} en ${chunks === 1 ? 'un chunk marcado como lazy' : `${chunks} chunks marcados como lazy`} que cargan al menos el ${(0, ui_strings_1.pct)(ratio)} de las pantallas`,
|
|
408
|
-
tileEffectiveSame: 'igual al declarado: ningún chunk lazy es casi global',
|
|
428
|
+
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.`,
|
|
429
|
+
tileBootSub: files => `lo que el bundler marca como inicial · ${files === 1 ? '1 fichero' : `${files} ficheros`}`,
|
|
409
430
|
tileScreens: 'Pantallas lazy',
|
|
410
431
|
tileScreensTypical: 'la típica cuesta',
|
|
411
432
|
tileScreensTop: (label, size) => `· la más cara es ${label} · ${size}`,
|
|
@@ -414,13 +435,14 @@ exports.ES = {
|
|
|
414
435
|
tileSharedSub: (global, partial) => `${global} casi ${global === 1 ? 'global' : 'globales'} · ${partial} ${partial === 1 ? 'parcial' : 'parciales'}`,
|
|
415
436
|
tileSharedNone: 'ningún chunk lazy lo comparten dos pantallas',
|
|
416
437
|
tileFindings: 'Señales',
|
|
417
|
-
tileFindingsSub: (high, mid) => `${high} ${high === 1 ? 'importante' : 'importantes'} · ${mid} a revisar`,
|
|
438
|
+
tileFindingsSub: (high, mid, context) => `${high} ${high === 1 ? 'importante' : 'importantes'} · ${mid} a revisar · ${context} de contexto`,
|
|
418
439
|
tileFindingsNone: 'no hay ninguna señal en el reparto',
|
|
419
440
|
tabFindings: 'Señales',
|
|
420
441
|
tabScreens: 'Pantallas',
|
|
421
442
|
tabBoot: 'Bootstrap',
|
|
422
443
|
tabShared: 'Compartidos',
|
|
423
444
|
tabTree: 'Árbol',
|
|
445
|
+
tabMap: 'Mapa',
|
|
424
446
|
howTo: 'Cómo leer esta pestaña',
|
|
425
447
|
howToFindings: '<p>Cada señal es un patrón concreto encontrado en <strong>tu</strong> grafo de importaciones, con su umbral y su arreglo. No son reglas genéricas de rendimiento.</p><p><strong>Importante</strong> significa que hay peso que paga todo el mundo sin necesidad. <strong>A revisar</strong> señala algo que merece una mirada pero puede tener explicación. El botón de cada señal lleva a la fila del informe de la que sale.</p>',
|
|
426
448
|
howToScreens: '<p>Cada fila es una pantalla lazy, y la barra es lo que descarga quien entra <strong>directamente</strong> a ella: <strong>bootstrap</strong> (gris, igual en todas), <strong>compartido</strong> (naranja: chunks lazy que también cargan otras pantallas) y <strong>propio</strong> (verde: solo esta). Las barras comparten escala, así que si el tramo naranja mide lo mismo en todas las filas, el problema está en ese chunk común y no en las pantallas.</p><p>Estas cifras se <strong>calculan</strong> recorriendo el grafo de importaciones, no se miden. Suelen quedarse algo cortas: al entrar por la raíz, el router puede cargar chunks de una zona antes de que un guard la rechace. Para la cifra definitiva, sirve la carpeta de build y mira la pestaña de red del navegador.</p>',
|
|
@@ -433,6 +455,37 @@ exports.ES = {
|
|
|
433
455
|
secScreensSub: 'Pulsa una fila para ver qué la compone. Las barras comparten escala.',
|
|
434
456
|
secTree: 'El bundle por dentro',
|
|
435
457
|
secTreeSub: 'Chunk, paquete y fichero. Filtra por zona para ver solo lo que paga todo el mundo.',
|
|
458
|
+
howToMap: '<p>Cada rectángulo es un chunk, y su <strong>área es lo que pesa en la unidad del informe</strong>: comprimido si se leyó la carpeta. Dentro de cada chunk se ve qué lo ocupa, por paquete y por carpeta tuya. El color dice quién lo paga: gris el bootstrap, naranja lo compartido entre pantallas, verde lo de una sola pantalla. Lo rayado es código tuyo; lo liso, paquetes.</p><p><strong>Dentro de un chunk el reparto es en crudo</strong>, porque gzip comprime el fichero entero y el peso comprimido de un paquete dentro de él no existe. Por eso el área de dentro es la parte que ocupa cada uno, no una cifra comprimida inventada.</p><p>Pulsa un rectángulo para entrar en él y las migas de arriba para volver. Con el teclado: Tab recorre los rectángulos de mayor a menor, Intro entra y Escape sube un nivel. Lo que escribas en la búsqueda se ilumina, también dentro de los chunks que lo llevan.</p>',
|
|
459
|
+
secMap: 'Mapa del bundle',
|
|
460
|
+
secMapSub: 'Abre un chunk y mira de un vistazo qué ocupa dentro.',
|
|
461
|
+
mapRoot: 'Todo el build',
|
|
462
|
+
mapSearch: 'Iluminar un paquete, carpeta o fichero…',
|
|
463
|
+
mapMatches: hits => (hits === 1 ? '1 coincide' : `${hits} coinciden`),
|
|
464
|
+
mapUnattributed: 'sin atribuir (código del bundler)',
|
|
465
|
+
mapRest: count => `${count} más pequeños`,
|
|
466
|
+
mapKind: {
|
|
467
|
+
chunk: 'chunk',
|
|
468
|
+
package: 'paquete',
|
|
469
|
+
folder: 'carpeta tuya',
|
|
470
|
+
file: 'fichero',
|
|
471
|
+
rest: 'grupo de pequeños',
|
|
472
|
+
unattributed: 'sin atribuir',
|
|
473
|
+
build: 'todos los chunks',
|
|
474
|
+
},
|
|
475
|
+
mapAreaRoot: unit => `Área: lo que pesa cada chunk, en cifras ${unit}.`,
|
|
476
|
+
mapAreaInside: 'Área: la parte del chunk que ocupa cada uno, en crudo.',
|
|
477
|
+
mapShareOfParent: (percent, parent) => `${percent} de ${parent}`,
|
|
478
|
+
mapShareOfAll: percent => `${percent} de todo el JavaScript`,
|
|
479
|
+
mapRawInside: raw => `${raw} en crudo dentro del chunk`,
|
|
480
|
+
mapContents: 'Lo que más ocupa',
|
|
481
|
+
mapOpen: 'Entrar',
|
|
482
|
+
mapUp: 'Subir',
|
|
483
|
+
mapFindIt: 'Buscar dónde más está',
|
|
484
|
+
mapHint: 'Intro entra · Escape sube',
|
|
485
|
+
mapLegendPackage: 'paquete',
|
|
486
|
+
mapLegendOwn: 'código tuyo',
|
|
487
|
+
mapEmpty: 'Nada que dibujar con este filtro.',
|
|
488
|
+
mapPick: 'Pasa el ratón por un rectángulo o recórrelos con Tab para ver qué es.',
|
|
436
489
|
secBoot: 'Qué hay en el bootstrap',
|
|
437
490
|
secBootSub: 'Lo que se descarga antes de ver nada, agrupado por paquete y por carpeta tuya.',
|
|
438
491
|
secShared: 'Chunks compartidos',
|
|
@@ -448,17 +501,19 @@ exports.ES = {
|
|
|
448
501
|
seeInMeasured: 'Ver la medición',
|
|
449
502
|
seeInSituation: 'Ver las respuestas',
|
|
450
503
|
findingsRest: 'Contexto',
|
|
451
|
-
findingsSee: '
|
|
504
|
+
findingsSee: 'Marcar como vista',
|
|
452
505
|
findingsUnsee: 'Vista ✓',
|
|
453
506
|
findingsSeenHelp: 'Marcar como vista: baja al final de la lista y deja de pedir atención.',
|
|
454
507
|
findingsSeenCount: n => (n === 1 ? '1 vista' : `${n} vistas`),
|
|
455
508
|
findingsSeenReset: 'Ninguna vista',
|
|
456
509
|
findingsNoneHere: 'Ninguna señal de este tipo.',
|
|
510
|
+
findingsColSignal: 'Señal · en el orden en que conviene arreglarla',
|
|
511
|
+
findingsColOff: 'Quita',
|
|
512
|
+
findingsColFix: 'Arreglo',
|
|
457
513
|
fixLabel: 'Qué hacer',
|
|
458
514
|
legBoot: 'Bootstrap · se descarga siempre',
|
|
459
|
-
legShared: 'Compartido · lo pagan varias pantallas',
|
|
460
515
|
legOwn: 'Propio de esta pantalla',
|
|
461
|
-
screensCaveat: '
|
|
516
|
+
screensCaveat: 'Calculado recorriendo el grafo de importaciones, no medido.',
|
|
462
517
|
filterBoot: 'Filtrar paquetes',
|
|
463
518
|
filterShared: 'Filtrar trozos',
|
|
464
519
|
filterScreens: 'Filtrar pantallas por nombre…',
|
|
@@ -508,10 +563,17 @@ exports.ES = {
|
|
|
508
563
|
secMeasured: 'Lo que descarga el navegador',
|
|
509
564
|
secMeasuredSub: 'La única cifra de la herramienta que se mide en vez de calcularse. Pega aquí lo que descargó tu navegador y Loadline dice en qué se diferencia.',
|
|
510
565
|
howToMeasured: '<p>El resto del informe <strong>calcula</strong>: recorre el grafo de importaciones estáticas y suma. Esta pestaña <strong>mide</strong>, y las dos cifras no dan lo mismo.</p><p>Al entrar por la raíz, el router carga el chunk de una zona para poder emparejar la ruta y solo después el guard comprueba la sesión y redirige. Ese chunk ya se descargó, y el cálculo no lo cuenta. Por eso lo calculado se queda corto.</p><p>Lo que se compara aquí es <strong>qué chunks se descargaron</strong>, no cuántos bytes dijo cada lado: el conjunto de chunks no depende de la unidad, así que un informe en gzip y un navegador que informa en bytes de red siguen comparándose bien. La diferencia se valora luego con las cifras de Loadline.</p>',
|
|
566
|
+
measureState: 'sin medir todavía · cada cifra del informe sale del build',
|
|
567
|
+
measureTitle: 'Mide lo que el navegador descarga de verdad',
|
|
511
568
|
measureStep1: 'Sirve el build que cargaste y abre la aplicación por donde entra la gente: la raíz, no la ruta directa. Desactiva la caché en la pestaña de red.',
|
|
512
|
-
measureStep2: 'Con la pantalla ya cargada,
|
|
513
|
-
measureStep3: 'Pega
|
|
514
|
-
measureCopy: 'Copiar',
|
|
569
|
+
measureStep2: 'Con la pantalla ya cargada, ejecuta el fragmento en la consola del navegador.',
|
|
570
|
+
measureStep3: 'Pega abajo lo que te devuelva.',
|
|
571
|
+
measureCopy: 'Copiar el fragmento para la consola',
|
|
572
|
+
measureShowCode: 'Ver el código',
|
|
573
|
+
measureHideCode: 'Ocultar el código',
|
|
574
|
+
measureGain: 'Qué obtienes',
|
|
575
|
+
measureGainCompare: 'La única cifra medida del informe, al lado de la calculada, con cada chunk en el que las dos no coinciden.',
|
|
576
|
+
measureGainServed: 'Lo que se sirve en vez de lo que se compiló: protocolo, ida y vuelta, compresión y qué hizo la caché — desde una máquina, una vez.',
|
|
515
577
|
measureCopied: 'Copiado',
|
|
516
578
|
measurePlaceholder: 'Pega aquí el resultado. También vale una lista de nombres de fichero copiada de la pestaña de red.',
|
|
517
579
|
measureRun: 'Contrastar',
|
|
@@ -643,6 +705,7 @@ exports.ES = {
|
|
|
643
705
|
},
|
|
644
706
|
sitRawUnit: { screensPerSession: 'pantallas', deploysPerWeek: 'por semana', returningPct: '%' },
|
|
645
707
|
sitRawEmpty: '—',
|
|
708
|
+
sitRawOr: 'o exactamente',
|
|
646
709
|
sitOpen: 'sin contestar',
|
|
647
710
|
sitLatency: ms => `El informe convierte bytes en segundos con ${ms} ms de ida y vuelta. Esa es la cifra que contesta esta pregunta de verdad, y se edita en Criterios.`,
|
|
648
711
|
sitLatencyGo: 'Editar la latencia',
|
|
@@ -653,9 +716,11 @@ exports.ES = {
|
|
|
653
716
|
sitWho: 'Quién contesta',
|
|
654
717
|
sitWhoPlaceholder: 'un nombre o un handle',
|
|
655
718
|
sitWhen: 'Fecha',
|
|
719
|
+
sitWhenPlaceholder: 'dd/mm/aaaa',
|
|
720
|
+
sitWhenInvalid: 'Eso no es un día del calendario: tiene que ir como dd/mm/aaaa. Se queda la fecha anterior.',
|
|
656
721
|
sitStale: days => `Estas respuestas tienen más de ${days} días. La cadencia de despliegue es justo lo que cambia cuando un equipo se pasa a entrega continua: repásalas antes de fiarte de la cifra.`,
|
|
657
722
|
sitNoDate: 'Sin fecha no hay forma de saber cuándo dejaron de ser verdad.',
|
|
658
|
-
sitAnswered: (answered, total) =>
|
|
723
|
+
sitAnswered: (answered, total) => `${answered} de ${total} contestadas`,
|
|
659
724
|
sitReset: 'Borrar las respuestas',
|
|
660
725
|
sitExport: 'Descargar loadline.json',
|
|
661
726
|
sitExportHelp: 'El bloque de situación como fichero, para commitearlo junto al código. El comando lo lee, así que la terminal deja de discrepar con esta página.',
|
|
@@ -715,8 +780,8 @@ exports.ES = {
|
|
|
715
780
|
worthCommon: 'Ningún grupo llega a la mitad del chunk, o el que llega lo importa una gran parte de la aplicación: no hay un fichero concreto al que señalar. Las dos salidas que quedan son usar menos esa librería o cambiarla por una más pequeña.',
|
|
716
781
|
worthNoSplit: 'Partirlo no ahorra nada: el bundler agrupa los ficheros por qué pantallas los alcanzan, así que las dos mitades las cargarían exactamente las mismas. Lo único que baja esta cifra es que menos pantallas lo importen, o que pese menos.',
|
|
717
782
|
worthTriage: n => `De los ${n.namedN + n.spreadN + n.smallN} chunks compartidos: ${n.namedN} con un origen concreto (${n.namedCost} de la carga típica) · ${n.spreadN} sin origen dominante (${n.spreadCost}) · ${n.smallN} por debajo de ${n.min}.`,
|
|
718
|
-
sharedSum: (size, chunks, ratio) => `${chunks === 1 ? 'El chunk casi global suma' : `Los ${chunks} chunks casi globales suman`} <strong>${size}</strong>: quien entra a casi cualquier pantalla lo descarga junto al bootstrap.
|
|
719
|
-
sharedSumNone: ratio => `Ningún chunk compartido llega al
|
|
783
|
+
sharedSum: (size, chunks, ratio, wide) => `${chunks === 1 ? 'El chunk casi global suma' : `Los ${chunks} chunks casi globales suman`} <strong>${size}</strong>: quien entra a casi cualquier pantalla lo descarga junto al bootstrap. Cuenta como bootstrap a partir del <strong>${(0, ui_strings_1.pct)(ratio)}</strong> de cobertura; como muy compartido, a partir del <strong>${(0, ui_strings_1.pct)(wide)}</strong>.`,
|
|
784
|
+
sharedSumNone: (ratio, wide) => `Ningún chunk compartido llega al <strong>${(0, ui_strings_1.pct)(ratio)}</strong> de cobertura: lo lazy se descarga solo cuando hace falta. Muy compartido a partir del <strong>${(0, ui_strings_1.pct)(wide)}</strong>.`,
|
|
720
785
|
bootPackages: 'Paquetes de npm',
|
|
721
786
|
bootOwnCode: 'Código tuyo',
|
|
722
787
|
entriesCount: n => `${n} entradas`,
|
|
@@ -756,9 +821,11 @@ exports.ES = {
|
|
|
756
821
|
: `${share} % de lo que carga una sola pantalla`,
|
|
757
822
|
treeShareHelp: 'Cuánto pesa este chunk dentro de su zona. Se marca a partir del 25 %: es donde está el peso, y por tanto lo que hay que mirar antes que las filas de abajo.',
|
|
758
823
|
shapeSplit: eager => `El ${eager} % se descarga en cada carga; el resto solo cuando algo lo pide.`,
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
824
|
+
shapeZone: {
|
|
825
|
+
boot: 'Eager · lo paga todo el mundo',
|
|
826
|
+
shared: 'Lazy, varias pantallas',
|
|
827
|
+
own: 'Lazy, una sola pantalla',
|
|
828
|
+
},
|
|
762
829
|
shapeNote: n => {
|
|
763
830
|
const of = { boot: 'del bootstrap', shared: 'de lo compartido', own: 'de una sola pantalla' }[n.zone];
|
|
764
831
|
// The second half does not repeat the zone when the first one has already named it.
|
|
@@ -783,7 +850,7 @@ exports.ES = {
|
|
|
783
850
|
searchFound: (shown, total) => (shown === total ? `${total} coincidencias` : `${shown} de ${total} coincidencias`),
|
|
784
851
|
searchKindPackage: 'paquete',
|
|
785
852
|
searchKindFile: 'fichero del proyecto',
|
|
786
|
-
searchInBoot: '
|
|
853
|
+
searchInBoot: 'lo paga toda carga de la aplicación',
|
|
787
854
|
searchPartlyBoot: size => `${size} de esto está en el bootstrap, y eso lo paga toda carga`,
|
|
788
855
|
searchScreensCount: n => (n === 1 ? 'lo carga 1 pantalla' : `lo cargan ${n} pantallas`),
|
|
789
856
|
searchMatchedIn: n => (n === 1 ? 'coincide en 1 fichero' : `coincide en ${n} ficheros`),
|
|
@@ -805,9 +872,6 @@ exports.ES = {
|
|
|
805
872
|
dupNobody: 'nadie de tu código directamente',
|
|
806
873
|
noScreens: 'No se han detectado pantallas lazy. Toda la aplicación entra en el bootstrap.',
|
|
807
874
|
noShared: 'Ningún chunk lazy lo comparten dos pantallas.',
|
|
808
|
-
noExclusive: 'Nada exclusivo.',
|
|
809
|
-
noSharedRow: 'Nada compartido.',
|
|
810
|
-
footerSummary: '¿De dónde salen estas cifras?',
|
|
811
875
|
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.',
|
|
812
876
|
errNoEntries: 'El fichero no parece un metafile de esbuild: no hay puntos de entrada.',
|
|
813
877
|
errNoMain: 'No se ha podido identificar el punto de entrada principal.',
|
|
@@ -31,7 +31,7 @@ const JS_FILE = /\.m?js$/i;
|
|
|
31
31
|
* fetch the other file as soon as it has parsed this one, which is the only thing that matters
|
|
32
32
|
* here. The character class stops at `;` so a match cannot run past the end of its statement.
|
|
33
33
|
*/
|
|
34
|
-
const STATIC_IMPORT = /\b(?:import|export)\b(?:[^'"`;()]
|
|
34
|
+
const STATIC_IMPORT = /\b(?:import|export)\b(?:[^'"`;()]+\bfrom\s*)?['"]([^'"]+)['"]/g;
|
|
35
35
|
/** `import("x")` in the three quotes a minifier may leave behind — Rolldown writes backticks. */
|
|
36
36
|
const DYNAMIC_IMPORT = /\bimport\s*\(\s*(['"`])([^'"`]+)\1\s*\)/g;
|
|
37
37
|
/** Vite's table of preloadable files, written once at the top of any chunk that needs one. */
|
|
@@ -145,7 +145,7 @@ const groupsIn = (code, exists) => {
|
|
|
145
145
|
const inTable = !!table && list.index >= table.index && list.index < table.index + table[0].length;
|
|
146
146
|
const group = inTable
|
|
147
147
|
? null
|
|
148
|
-
: groupOf([...
|
|
148
|
+
: groupOf([...list[0].matchAll(QUOTED)].map(m => m[1] ?? ''), exists);
|
|
149
149
|
if (group) {
|
|
150
150
|
groups.push(group);
|
|
151
151
|
}
|
|
@@ -260,10 +260,11 @@ const parallelOf = (read) => {
|
|
|
260
260
|
const lazy = new Set(info.dynamics.map(entry => entry.target));
|
|
261
261
|
for (const group of info.groups) {
|
|
262
262
|
const target = targetOf(group, lazy);
|
|
263
|
-
if (target) {
|
|
264
|
-
|
|
265
|
-
parallel.set(target, [...new Set([...(parallel.get(target) ?? []), ...rest])]);
|
|
263
|
+
if (!target) {
|
|
264
|
+
continue;
|
|
266
265
|
}
|
|
266
|
+
const rest = group.filter(path => path !== target);
|
|
267
|
+
parallel.set(target, [...new Set([...(parallel.get(target) ?? []), ...rest])]);
|
|
267
268
|
}
|
|
268
269
|
}
|
|
269
270
|
return parallel;
|
|
@@ -24,10 +24,13 @@ exports.isSearchable = isSearchable;
|
|
|
24
24
|
* the report says so, rather than reporting "no duplicates" and meaning "nobody looked".
|
|
25
25
|
*/
|
|
26
26
|
const hashOf = async (file) => {
|
|
27
|
-
|
|
27
|
+
// Read as possibly absent: `crypto.subtle` is undefined outside a secure context (a page opened
|
|
28
|
+
// over plain http), whatever lib.dom says.
|
|
29
|
+
const subtle = crypto.subtle;
|
|
30
|
+
if (file.size > 8 * 1024 * 1024 || !subtle) {
|
|
28
31
|
return null;
|
|
29
32
|
}
|
|
30
|
-
const digest = await
|
|
33
|
+
const digest = await subtle.digest('SHA-256', await file.arrayBuffer());
|
|
31
34
|
return [...new Uint8Array(digest)].map(byte => byte.toString(16).padStart(2, '0')).join('');
|
|
32
35
|
};
|
|
33
36
|
exports.hashOf = hashOf;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
/**
|
|
3
|
+
* A build written into the page by `loadline --html`, and the files the page rebuilds out of it.
|
|
4
|
+
*
|
|
5
|
+
* The command and the page share this shape so neither can drift from the other: the command fills
|
|
6
|
+
* it with what it read off the disk, the page turns it back into the `File` objects a drop would
|
|
7
|
+
* have handed over, and from there everything goes through the doors it always went through.
|
|
8
|
+
*/
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.filesOf = exports.isEmbeddedBuild = void 0;
|
|
11
|
+
const json_utils_1 = require("../json/json.utils");
|
|
12
|
+
const isEmbeddedBuild = (value) => {
|
|
13
|
+
const record = (0, json_utils_1.asRecord)(value);
|
|
14
|
+
return record?.['version'] === 1 && Array.isArray(record['extras']);
|
|
15
|
+
};
|
|
16
|
+
exports.isEmbeddedBuild = isEmbeddedBuild;
|
|
17
|
+
const bytesOf = (file) => {
|
|
18
|
+
if (file.b64 !== undefined) {
|
|
19
|
+
const binary = atob(file.b64);
|
|
20
|
+
const bytes = new Uint8Array(binary.length);
|
|
21
|
+
for (let index = 0; index < binary.length; index++) {
|
|
22
|
+
bytes[index] = binary.codePointAt(index) ?? 0;
|
|
23
|
+
}
|
|
24
|
+
return bytes;
|
|
25
|
+
}
|
|
26
|
+
// A stand-in of the right length, filled with the file's own path so that no two of them hash
|
|
27
|
+
// alike: two videos of the same size would otherwise read as the same file twice.
|
|
28
|
+
const size = file.size ?? 0;
|
|
29
|
+
const seed = new TextEncoder().encode(`${file.path}\u{0}`);
|
|
30
|
+
const bytes = new Uint8Array(size);
|
|
31
|
+
for (let index = 0; index < size; index++) {
|
|
32
|
+
bytes[index] = seed[index % seed.length] ?? 0;
|
|
33
|
+
}
|
|
34
|
+
return bytes;
|
|
35
|
+
};
|
|
36
|
+
/**
|
|
37
|
+
* The folder as a folder picker would have handed it over: each `File` carries the path it had
|
|
38
|
+
* under the folder, which is what tells `orders/index.html` from `settings/index.html`.
|
|
39
|
+
*/
|
|
40
|
+
const filesOf = (folder) => folder.files.map(file => {
|
|
41
|
+
const name = file.path.split('/').at(-1) ?? file.path;
|
|
42
|
+
const made = new File([file.text ?? bytesOf(file)], name);
|
|
43
|
+
Object.defineProperty(made, 'webkitRelativePath', { value: `${folder.name}/${file.path}` });
|
|
44
|
+
return made;
|
|
45
|
+
});
|
|
46
|
+
exports.filesOf = filesOf;
|
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
14
14
|
exports.originsIn = exports.stylesIn = exports.assetsIn = exports.announcedIn = exports.scriptsIn = exports.indexHtmlOf = void 0;
|
|
15
15
|
/** Angular writes `index.html`; with server-side rendering the browser one is `index.csr.html`. */
|
|
16
|
-
const INDEX_NAME = /^index(
|
|
16
|
+
const INDEX_NAME = /^index(?:\.[\w-]+)?\.html$/i;
|
|
17
17
|
const TAG = /<(script|link)\b([^>]*)>/gi;
|
|
18
18
|
/** Images written into the page itself: they are asked for as soon as the tag is parsed. */
|
|
19
19
|
const IMG = /<img\b([^>]*)>/gi;
|
|
@@ -25,7 +25,7 @@ const BASE = /<(base)\b([^>]*)>/gi;
|
|
|
25
25
|
* page and calls `start()` with the result. Nothing outside that script names those chunks, so
|
|
26
26
|
* without reading it the build has no entry at all and cannot be read — which is what it did.
|
|
27
27
|
*/
|
|
28
|
-
const INLINE_SCRIPT = /<script\b([^>]*)>([\S
|
|
28
|
+
const INLINE_SCRIPT = /<script\b([^>]*)>([\s\S]*?)<\/script>/gi;
|
|
29
29
|
/** `import("./chunk.js")` as it is written in a page: a literal specifier, never a variable. */
|
|
30
30
|
const IMPORT_CALL = /\bimport\s*\(\s*(["'`])([^"'`]+)\1\s*\)/g;
|
|
31
31
|
const ATTRIBUTE = (name) => new RegExp(String.raw `\b${name}\s*=\s*("([^"]*)"|'([^']*)'|([^\s>]+))`, 'i');
|
|
@@ -89,11 +89,12 @@ const scriptsIn = (html) => {
|
|
|
89
89
|
continue;
|
|
90
90
|
}
|
|
91
91
|
const name = fileNameOf(attribute(rest, isScript ? 'src' : 'href') ?? '');
|
|
92
|
-
if (
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
92
|
+
if (!/\.m?js$/.test(name)) {
|
|
93
|
+
continue;
|
|
94
|
+
}
|
|
95
|
+
names.add(name);
|
|
96
|
+
if (isScript) {
|
|
97
|
+
entries.add(name);
|
|
97
98
|
}
|
|
98
99
|
}
|
|
99
100
|
// After the tags, so the order stays the order the page names things in: the links come first
|
|
@@ -125,8 +126,29 @@ exports.announcedIn = announcedIn;
|
|
|
125
126
|
* counting them all would overstate the first load, which is the mistake this whole group exists
|
|
126
127
|
* to stop making in the other direction.
|
|
127
128
|
*/
|
|
129
|
+
/**
|
|
130
|
+
* Icons a page names that the browser does not all download.
|
|
131
|
+
*
|
|
132
|
+
* `<link rel="icon">` with several sizes or types are **alternatives**: the browser picks the one
|
|
133
|
+
* that fits and fetches that one, the way it picks one candidate of a `srcset`. `apple-touch-icon`
|
|
134
|
+
* and `mask-icon` are fetched only when somebody saves the page to a home screen or pins a tab. A
|
|
135
|
+
* page with a `.ico`, an SVG, three PNG sizes and a touch icon was counted as downloading all six,
|
|
136
|
+
* which inflated the first trip, the "no hash, asked for by the page" list and the "same file twice"
|
|
137
|
+
* one with files that never travel together.
|
|
138
|
+
*/
|
|
139
|
+
const ON_DEMAND_ICON = new Set(['apple-touch-icon', 'apple-touch-icon-precomposed', 'mask-icon']);
|
|
140
|
+
/** Which of a page's `rel="icon"` alternatives a current browser fetches: the SVG when there is one. */
|
|
141
|
+
const chosenIcon = (icons) => {
|
|
142
|
+
const svg = icons.find(icon => icon.type.includes('svg') || /\.svg$/i.test(icon.source));
|
|
143
|
+
const any = icons.find(icon => icon.sizes === '' || icon.sizes === 'any');
|
|
144
|
+
return (svg ?? any ?? icons[0])?.source ?? null;
|
|
145
|
+
};
|
|
128
146
|
const assetsIn = (html) => {
|
|
129
147
|
const referenced = new Set();
|
|
148
|
+
/** Every icon the page names, and of those, the ones the browser will not fetch on this load. */
|
|
149
|
+
const icons = new Set();
|
|
150
|
+
const alternates = new Set();
|
|
151
|
+
const favicons = [];
|
|
130
152
|
const preloaded = new Set();
|
|
131
153
|
/**
|
|
132
154
|
* Kept apart from both, because it is neither. A `prefetch` is not part of the first load — the
|
|
@@ -149,8 +171,22 @@ const assetsIn = (html) => {
|
|
|
149
171
|
if (!source) {
|
|
150
172
|
continue;
|
|
151
173
|
}
|
|
152
|
-
referenced.add(source);
|
|
153
174
|
hrefs.add(url);
|
|
175
|
+
if (lower === 'link' && [...rel].some(value => ON_DEMAND_ICON.has(value))) {
|
|
176
|
+
icons.add(source);
|
|
177
|
+
alternates.add(source);
|
|
178
|
+
continue;
|
|
179
|
+
}
|
|
180
|
+
if (lower === 'link' && rel.has('icon')) {
|
|
181
|
+
icons.add(source);
|
|
182
|
+
favicons.push({
|
|
183
|
+
source,
|
|
184
|
+
type: (attribute(rest, 'type') ?? '').toLowerCase(),
|
|
185
|
+
sizes: (attribute(rest, 'sizes') ?? '').toLowerCase().trim(),
|
|
186
|
+
});
|
|
187
|
+
continue;
|
|
188
|
+
}
|
|
189
|
+
referenced.add(source);
|
|
154
190
|
// `prefetch` is deliberately not a preload: it is what the browser fetches when it is idle,
|
|
155
191
|
// which is the opposite of "before anything appears".
|
|
156
192
|
if (lower === 'link' && preloads && !rel.has('prefetch')) {
|
|
@@ -165,16 +201,33 @@ const assetsIn = (html) => {
|
|
|
165
201
|
for (const [, rest = ''] of html.matchAll(IMG)) {
|
|
166
202
|
const url = attribute(rest, 'src') ?? '';
|
|
167
203
|
const source = fileNameOf(url);
|
|
168
|
-
if (source) {
|
|
169
|
-
|
|
170
|
-
|
|
204
|
+
if (!source) {
|
|
205
|
+
continue;
|
|
206
|
+
}
|
|
207
|
+
referenced.add(source);
|
|
208
|
+
hrefs.add(url);
|
|
209
|
+
}
|
|
210
|
+
// One favicon is fetched; the rest are alternatives. A file that is also named some other way —
|
|
211
|
+
// an `<img>` of the same logo — stays referenced through that other tag.
|
|
212
|
+
const fetched = chosenIcon(favicons);
|
|
213
|
+
for (const icon of favicons) {
|
|
214
|
+
if (icon.source === fetched) {
|
|
215
|
+
referenced.add(icon.source);
|
|
171
216
|
}
|
|
217
|
+
else {
|
|
218
|
+
alternates.add(icon.source);
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
for (const name of referenced) {
|
|
222
|
+
alternates.delete(name);
|
|
172
223
|
}
|
|
173
224
|
return {
|
|
174
225
|
referenced: [...referenced],
|
|
175
226
|
preloaded: [...preloaded],
|
|
176
227
|
prefetched: [...prefetched],
|
|
177
228
|
hrefs: [...hrefs],
|
|
229
|
+
icons: [...icons],
|
|
230
|
+
alternates: [...alternates],
|
|
178
231
|
};
|
|
179
232
|
};
|
|
180
233
|
exports.assetsIn = assetsIn;
|
|
@@ -218,13 +271,10 @@ exports.stylesIn = stylesIn;
|
|
|
218
271
|
* A protocol-relative `//cdn.example.com/main.js` counts: it is a different host, which is the
|
|
219
272
|
* whole of what matters here, and the scheme it inherits changes nothing about the handshake.
|
|
220
273
|
*/
|
|
221
|
-
const ABSOLUTE = /^(
|
|
274
|
+
const ABSOLUTE = /^(https?:)?\/\/([^/?#]+)/i;
|
|
222
275
|
const originOf = (url) => {
|
|
223
276
|
const found = ABSOLUTE.exec(url.trim());
|
|
224
|
-
|
|
225
|
-
return null;
|
|
226
|
-
}
|
|
227
|
-
return `${(found[1] ?? '').toLowerCase()}//${(found[2] ?? '').toLowerCase()}`;
|
|
277
|
+
return found ? `${(found[1] ?? '').toLowerCase()}//${(found[2] ?? '').toLowerCase()}` : null;
|
|
228
278
|
};
|
|
229
279
|
/**
|
|
230
280
|
* Where the page fetches from, when that is not itself.
|