template-common 1.2.0 → 1.2.2
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 +46 -46
- package/dist/sass-template-common.d.ts +86 -4
- package/dist/sass-template-common.js +3144 -3071
- package/dist/sass-template-common.umd.cjs +67 -67
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -1,46 +1,46 @@
|
|
|
1
|
-
# template-common
|
|
2
|
-
|
|
3
|
-
Librería web, maqueta de configuración y componentes para proyectos sass.
|
|
4
|
-
|
|
5
|
-
> **Antes se llamaba `sass-template-common`.** Ese paquete quedó deprecado en npm: sigue instalando, pero no recibe versiones nuevas.
|
|
6
|
-
>
|
|
7
|
-
> **Migrar un consumidor sin tocar código** (mantiene `node_modules/sass-template-common`, así que imports, `noExternal` y rutas a `dist/` siguen funcionando):
|
|
8
|
-
> ```json
|
|
9
|
-
> "sass-template-common": "npm:template-common@^1.1.0"
|
|
10
|
-
> ```
|
|
11
|
-
> Después, repo por repo, se puede reemplazar `sass-template-common` por `template-common` en el código y quitar el alias.
|
|
12
|
-
>
|
|
13
|
-
> Los archivos de `dist/` conservan el nombre `sass-template-common.*` hasta la 2.0.0.
|
|
14
|
-
|
|
15
|
-
## Publicar nueva versión
|
|
16
|
-
|
|
17
|
-
Para que los cambios se reflejen al publicar:
|
|
18
|
-
|
|
19
|
-
1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
|
|
20
|
-
```bash
|
|
21
|
-
pnpm version:patch # 0.3.21 → 0.3.22
|
|
22
|
-
# o
|
|
23
|
-
pnpm version:minor # 0.3.21 → 0.4.0
|
|
24
|
-
pnpm version:major # 0.3.21 → 1.0.0
|
|
25
|
-
```
|
|
26
|
-
|
|
27
|
-
2. **Build limpio + publicar**:
|
|
28
|
-
```bash
|
|
29
|
-
pnpm run clean && pnpm run build && pnpm publish
|
|
30
|
-
```
|
|
31
|
-
O en un solo paso (patch):
|
|
32
|
-
```bash
|
|
33
|
-
pnpm release:patch
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo, y después `scripts/changelog.mjs`, que deja la entrada de la versión en `changelog/<major>.<minor>.x.md` (un archivo por minor). Esa entrada es un borrador armado desde los commits; `/changelog` en Claude Code lo cura y completa las versiones que hayan quedado sin entrada. `pnpm changelog:check` muestra qué falta.
|
|
37
|
-
|
|
38
|
-
4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
|
|
39
|
-
```bash
|
|
40
|
-
pnpm update template-common
|
|
41
|
-
# o cambiar la versión en package.json y luego
|
|
42
|
-
pnpm install
|
|
43
|
-
```
|
|
44
|
-
Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
|
|
45
|
-
|
|
46
|
-
**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
|
|
1
|
+
# template-common
|
|
2
|
+
|
|
3
|
+
Librería web, maqueta de configuración y componentes para proyectos sass.
|
|
4
|
+
|
|
5
|
+
> **Antes se llamaba `sass-template-common`.** Ese paquete quedó deprecado en npm: sigue instalando, pero no recibe versiones nuevas.
|
|
6
|
+
>
|
|
7
|
+
> **Migrar un consumidor sin tocar código** (mantiene `node_modules/sass-template-common`, así que imports, `noExternal` y rutas a `dist/` siguen funcionando):
|
|
8
|
+
> ```json
|
|
9
|
+
> "sass-template-common": "npm:template-common@^1.1.0"
|
|
10
|
+
> ```
|
|
11
|
+
> Después, repo por repo, se puede reemplazar `sass-template-common` por `template-common` en el código y quitar el alias.
|
|
12
|
+
>
|
|
13
|
+
> Los archivos de `dist/` conservan el nombre `sass-template-common.*` hasta la 2.0.0.
|
|
14
|
+
|
|
15
|
+
## Publicar nueva versión
|
|
16
|
+
|
|
17
|
+
Para que los cambios se reflejen al publicar:
|
|
18
|
+
|
|
19
|
+
1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
|
|
20
|
+
```bash
|
|
21
|
+
pnpm version:patch # 0.3.21 → 0.3.22
|
|
22
|
+
# o
|
|
23
|
+
pnpm version:minor # 0.3.21 → 0.4.0
|
|
24
|
+
pnpm version:major # 0.3.21 → 1.0.0
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
2. **Build limpio + publicar**:
|
|
28
|
+
```bash
|
|
29
|
+
pnpm run clean && pnpm run build && pnpm publish
|
|
30
|
+
```
|
|
31
|
+
O en un solo paso (patch):
|
|
32
|
+
```bash
|
|
33
|
+
pnpm release:patch
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo, y después `scripts/changelog.mjs`, que deja la entrada de la versión en `changelog/<major>.<minor>.x.md` (un archivo por minor). Esa entrada es un borrador armado desde los commits; `/changelog` en Claude Code lo cura y completa las versiones que hayan quedado sin entrada. `pnpm changelog:check` muestra qué falta.
|
|
37
|
+
|
|
38
|
+
4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
|
|
39
|
+
```bash
|
|
40
|
+
pnpm update template-common
|
|
41
|
+
# o cambiar la versión en package.json y luego
|
|
42
|
+
pnpm install
|
|
43
|
+
```
|
|
44
|
+
Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
|
|
45
|
+
|
|
46
|
+
**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
|
|
@@ -272,6 +272,41 @@ export declare const AssetsPreconnect: () => false | "" | JSX.Element | undefine
|
|
|
272
272
|
|
|
273
273
|
export declare function auditConfigOrigin(entry: ConfigOriginAuditEntry): void;
|
|
274
274
|
|
|
275
|
+
/**
|
|
276
|
+
* `[<prefijo actual><base>, <viejo 1><base>, ...]`. El primero es el único que
|
|
277
|
+
* se escribe; el resto solo se lee.
|
|
278
|
+
*/
|
|
279
|
+
export declare const authCookieNames: (cfg: AuthCookiePrefixConfig, base: string, prefix?: string) => string[];
|
|
280
|
+
|
|
281
|
+
/**
|
|
282
|
+
* Nombres de las cookies del login propio del sitio (`<prefix>IS_AUTH`,
|
|
283
|
+
* `<prefix>userInfo`, ...) y su lectura con prefijos viejos de respaldo.
|
|
284
|
+
*
|
|
285
|
+
* Módulo puro, sin imports: lo cargan `coreAuth.ts`, el LoginForm y los tests
|
|
286
|
+
* de `scripts/test-auth-cookie-names.mjs` desde node.
|
|
287
|
+
*
|
|
288
|
+
* Renombrar el prefijo sin cortar sesiones: el sitio pasa el prefijo nuevo en
|
|
289
|
+
* `COGNITO_AUTH_PREFIX` y los anteriores en `COGNITO_AUTH_LEGACY_PREFIXES`.
|
|
290
|
+
* Se lee primero el nombre nuevo y, si falta o está vacío, cada nombre viejo en
|
|
291
|
+
* orden. Los viejos son SOLO de lectura: la librería no escribe cookies de
|
|
292
|
+
* sesión; renombrarlas (escribir la nueva y borrar la vieja) es trabajo de las
|
|
293
|
+
* rutas `/api/auth/*` del sitio, que son las que conocen sus atributos.
|
|
294
|
+
*
|
|
295
|
+
* Sin `COGNITO_AUTH_LEGACY_PREFIXES` (todos los sitios salvo el que lo active)
|
|
296
|
+
* la lista de nombres tiene un solo elemento y el comportamiento es idéntico al
|
|
297
|
+
* anterior.
|
|
298
|
+
*/
|
|
299
|
+
/** Las claves de config que este módulo necesita. */
|
|
300
|
+
export declare type AuthCookiePrefixConfig = {
|
|
301
|
+
/** `''` o `null` = sin prefijo. `undefined` = `'ASTRO_'` histórico. */
|
|
302
|
+
COGNITO_AUTH_PREFIX?: string | null;
|
|
303
|
+
/**
|
|
304
|
+
* Prefijos anteriores que se aceptan SOLO para leer, en orden de prioridad
|
|
305
|
+
* (`''` = sin prefijo). Opt-in: sin la clave no hay respaldo.
|
|
306
|
+
*/
|
|
307
|
+
COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
|
|
308
|
+
};
|
|
309
|
+
|
|
275
310
|
export declare interface Author {
|
|
276
311
|
firstname: string;
|
|
277
312
|
lastname: string;
|
|
@@ -1397,7 +1432,7 @@ export declare const contractWarn: (component: string, field: string, extra?: un
|
|
|
1397
1432
|
export declare const CORE_AUTH_CHANGED_EVENT = "core-auth:changed";
|
|
1398
1433
|
|
|
1399
1434
|
/** Claves de config que usa el login del header y la página de cuenta. */
|
|
1400
|
-
export declare const CORE_AUTH_CONFIG_KEYS: readonly ["CONFIG_headerAuth", "CONFIG_authUserImage", "CONFIG_accountPath", "CONFIG_authAvatarBase", "CONFIG_authMockUser", "CONFIG_profilePreferences", "CONFIG_profileNewsletters", "COGNITO_AUTH_PREFIX", "PUBLIC_ENV", "PUBLIC_LNG", "PUBLIC_SERVICE_PREFIX", "PUBLIC_IS_SUB_PUBLICATION", "FORCE_SUB_PUBLICATION_PREFIX"];
|
|
1435
|
+
export declare const CORE_AUTH_CONFIG_KEYS: readonly ["CONFIG_headerAuth", "CONFIG_authUserImage", "CONFIG_accountPath", "CONFIG_authAvatarBase", "CONFIG_authMockUser", "CONFIG_profilePreferences", "CONFIG_profileNewsletters", "COGNITO_AUTH_PREFIX", "COGNITO_AUTH_LEGACY_PREFIXES", "PUBLIC_ENV", "PUBLIC_LNG", "PUBLIC_SERVICE_PREFIX", "PUBLIC_IS_SUB_PUBLICATION", "FORCE_SUB_PUBLICATION_PREFIX"];
|
|
1401
1436
|
|
|
1402
1437
|
/** Largo máximo de nombre y apellido (mismo límite que `/api/auth/update-profile`). */
|
|
1403
1438
|
export declare const CORE_AUTH_NAME_MAX_LENGTH = 60;
|
|
@@ -2095,7 +2130,7 @@ export declare interface FreeZoneResponse {
|
|
|
2095
2130
|
};
|
|
2096
2131
|
}
|
|
2097
2132
|
|
|
2098
|
-
export declare const GA4: ({ id, dimensionValues, event_analytics, eventReplaces }: Props_2) => "" | JSX.Element | undefined;
|
|
2133
|
+
export declare const GA4: ({ id, dimensionValues, event_analytics, eventReplaces, }: Props_2) => "" | JSX.Element | undefined;
|
|
2099
2134
|
|
|
2100
2135
|
export declare const GalleryHeader: ({ newsformated, internal, commonServices, }: {
|
|
2101
2136
|
newsformated: NewListResponseData;
|
|
@@ -2317,7 +2352,10 @@ export declare interface Hascontent {
|
|
|
2317
2352
|
hasembeddedbrid: boolean;
|
|
2318
2353
|
}
|
|
2319
2354
|
|
|
2320
|
-
/**
|
|
2355
|
+
/**
|
|
2356
|
+
* `<prefix>IS_AUTH=true`: la setea el login (password o Google) y la borra el logout.
|
|
2357
|
+
* Con `COGNITO_AUTH_LEGACY_PREFIXES` también vale el nombre viejo (gana el nuevo).
|
|
2358
|
+
*/
|
|
2321
2359
|
export declare const hasSessionCookie: (cfg?: CoreAuthConfig) => boolean;
|
|
2322
2360
|
|
|
2323
2361
|
export declare type headConfig = {
|
|
@@ -2613,6 +2651,7 @@ export declare interface ImageSizesResolution {
|
|
|
2613
2651
|
|
|
2614
2652
|
export declare interface Info {
|
|
2615
2653
|
type?: string;
|
|
2654
|
+
creator?: string;
|
|
2616
2655
|
/** Tipo de video cuando `type === 'video'`: flash, youtube o embedded. */
|
|
2617
2656
|
videoOp?: 'vf' | 'vy' | 've';
|
|
2618
2657
|
section?: {
|
|
@@ -3130,6 +3169,13 @@ export declare type LibraryConfig = {
|
|
|
3130
3169
|
ANALYTICS_comscore?: string | undefined;
|
|
3131
3170
|
/** `''` o `null` = cookies de login sin prefijo (ver `authPrefix` en `coreAuth.ts`). */
|
|
3132
3171
|
COGNITO_AUTH_PREFIX?: string | null;
|
|
3172
|
+
/**
|
|
3173
|
+
* Prefijos anteriores de las cookies de login, SOLO para leer mientras dura un
|
|
3174
|
+
* renombre (`''` = sin prefijo). Primero se lee `COGNITO_AUTH_PREFIX` y, si
|
|
3175
|
+
* falta, cada uno de estos en orden. Sin definir: sin respaldo (como antes).
|
|
3176
|
+
* Ver `helpers/auth/authCookieNames.ts`.
|
|
3177
|
+
*/
|
|
3178
|
+
COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
|
|
3133
3179
|
COGNITO_CLIENT_ID?: string;
|
|
3134
3180
|
COGNITO_DOMAIN?: string;
|
|
3135
3181
|
COGNITO_REDIRECT_URI?: string;
|
|
@@ -4394,6 +4440,8 @@ declare type Props_15 = {
|
|
|
4394
4440
|
API_ENV: {
|
|
4395
4441
|
/** `''` o `null` = cookies de login sin prefijo. */
|
|
4396
4442
|
COGNITO_AUTH_PREFIX: string | null;
|
|
4443
|
+
/** Prefijos viejos, solo lectura (ver `COGNITO_AUTH_LEGACY_PREFIXES` en config). */
|
|
4444
|
+
COGNITO_AUTH_LEGACY_PREFIXES?: readonly (string | null)[] | null;
|
|
4397
4445
|
PUBLIC_ENV: string;
|
|
4398
4446
|
CAPTCHA_KEY: string;
|
|
4399
4447
|
/** Kill switch de reCAPTCHA. Sin definir: captcha activo (como hoy). */
|
|
@@ -5020,6 +5068,13 @@ declare type Props_9 = {
|
|
|
5020
5068
|
};
|
|
5021
5069
|
};
|
|
5022
5070
|
|
|
5071
|
+
/**
|
|
5072
|
+
* Valor crudo de la cookie `name` en un string tipo `document.cookie`, por
|
|
5073
|
+
* nombre EXACTO (sin prefijo, `IS_AUTH` no matchea `bs_IS_AUTH`). `null` si no
|
|
5074
|
+
* está. Sin decodificar.
|
|
5075
|
+
*/
|
|
5076
|
+
export declare const readCookieFromString: (cookieString: string | null | undefined, name: string) => string | null;
|
|
5077
|
+
|
|
5023
5078
|
/**
|
|
5024
5079
|
* Lectura SINCRÓNICA, sin red: mock de dev, la cookie `<prefix>userInfo`, o
|
|
5025
5080
|
* el usuario cacheado en esta pestaña. Sin cookie de sesión => deslogueado.
|
|
@@ -5028,6 +5083,15 @@ export declare const readCoreAuthUser: (cfg?: CoreAuthConfig) => CoreAuthUser |
|
|
|
5028
5083
|
|
|
5029
5084
|
export declare const Readest: FC<Props_30>;
|
|
5030
5085
|
|
|
5086
|
+
/**
|
|
5087
|
+
* Primer nombre de `names` con valor no vacío. Si están el nuevo y el viejo,
|
|
5088
|
+
* gana el nuevo (es el primero de la lista). `null` si no hay ninguno con valor.
|
|
5089
|
+
*/
|
|
5090
|
+
export declare const readFirstCookie: (cookieString: string | null | undefined, names: readonly string[]) => {
|
|
5091
|
+
name: string;
|
|
5092
|
+
value: string;
|
|
5093
|
+
} | null;
|
|
5094
|
+
|
|
5031
5095
|
/**
|
|
5032
5096
|
* Token que devuelve `getCaptchaToken` cuando reCAPTCHA está desactivado por
|
|
5033
5097
|
* `CONFIG_blockRecaptcha`. Es un placeholder no vacío a propósito: los call
|
|
@@ -5333,6 +5397,13 @@ export declare interface ResilientFetchOptions {
|
|
|
5333
5397
|
/** Ignora `undefined` del override: un `texts.comentarios` parcial no pisa defaults. */
|
|
5334
5398
|
export declare const resolveAccountProfileTexts: (lng?: string, overrides?: Partial<Record<keyof AccountProfileTexts, unknown>>) => AccountProfileTexts;
|
|
5335
5399
|
|
|
5400
|
+
/**
|
|
5401
|
+
* `''` o `null` son validos y significan "sin prefijo": las cookies ya quedan atadas al
|
|
5402
|
+
* dominio del sitio, el prefijo no las hace mas unicas y solo complica la CDN. Solo
|
|
5403
|
+
* `undefined` (sin configurar) cae al `'ASTRO_'` historico.
|
|
5404
|
+
*/
|
|
5405
|
+
export declare const resolveAuthPrefix: (cfg: AuthCookiePrefixConfig) => string;
|
|
5406
|
+
|
|
5336
5407
|
export declare function resolveBucketMenuSubtype(path?: string): string;
|
|
5337
5408
|
|
|
5338
5409
|
/**
|
|
@@ -5403,6 +5474,13 @@ export declare const resolveHeaderAuthTexts: (lng?: string, overrides?: Partial<
|
|
|
5403
5474
|
*/
|
|
5404
5475
|
export declare function resolveImageSizes(input: ImageSizesContractInput | undefined): ImageSizesResolution;
|
|
5405
5476
|
|
|
5477
|
+
/**
|
|
5478
|
+
* Prefijos viejos válidos, sin repetidos y sin el actual. `null` cuenta como
|
|
5479
|
+
* `''` (sin prefijo), igual que en `COGNITO_AUTH_PREFIX`. Cualquier otra cosa
|
|
5480
|
+
* que no sea string se ignora.
|
|
5481
|
+
*/
|
|
5482
|
+
export declare const resolveLegacyAuthPrefixes: (cfg: AuthCookiePrefixConfig, current?: string) => string[];
|
|
5483
|
+
|
|
5406
5484
|
/**
|
|
5407
5485
|
* El toggle del boton "Ver mas" con los defaults aplicados, o `null` si el
|
|
5408
5486
|
* sitio no lo prendio. Fuente UNICA de la resolucion: la consumen el componente,
|
|
@@ -6038,10 +6116,14 @@ export declare function usePlayIcon(): ComponentType<SVGProps<SVGSVGElement>>;
|
|
|
6038
6116
|
/**
|
|
6039
6117
|
* Cookie NO httpOnly con los datos visibles del usuario (JSON, URL-encoded por
|
|
6040
6118
|
* `cookies.set` de Astro). Forma: {@link CoreAuthUser}. Señal visual, igual que
|
|
6041
|
-
* `IS_AUTH`: no es prueba de sesión.
|
|
6119
|
+
* `IS_AUTH`: no es prueba de sesión. Es el nombre que el sitio ESCRIBE; para
|
|
6120
|
+
* leer con respaldo ver {@link userInfoCookieNames}.
|
|
6042
6121
|
*/
|
|
6043
6122
|
export declare const userInfoCookieName: (cfg: CoreAuthConfig) => string;
|
|
6044
6123
|
|
|
6124
|
+
/** `userInfoCookieName` + los nombres viejos, en orden de lectura. */
|
|
6125
|
+
export declare const userInfoCookieNames: (cfg: CoreAuthConfig) => string[];
|
|
6126
|
+
|
|
6045
6127
|
export declare interface UserType {
|
|
6046
6128
|
username: string;
|
|
6047
6129
|
firstname: string;
|