template-common 1.1.8 → 1.2.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 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`).
@@ -654,7 +654,10 @@ export { BuscarClient as BuscarClientComponent }
654
654
  export declare type BuscarClientConfig = {
655
655
  /** Kill switch. `false` apaga la feature aunque el objeto este presente. */
656
656
  enabled?: boolean;
657
- /** Tamano del lote de `/news-list-search` (submit y cada "Ver mas"). Default 20. */
657
+ /**
658
+ * Tamano del lote de `/news-list-search` (submit y cada "Ver mas"). Default 21:
659
+ * multiplo de 3, completa 7 filas exactas de la grilla de 3 columnas por tanda.
660
+ */
658
661
  size?: number;
659
662
  /**
660
663
  * Tamano de "Ultimas Noticias" (sin resultados o con error). Default 21: la
@@ -665,7 +668,7 @@ export declare type BuscarClientConfig = {
665
668
  loadMore?: boolean;
666
669
  /**
667
670
  * Ultima pagina que alcanza "Ver mas", contando la 1 del submit: 5 => 4
668
- * clicks (100 resultados con `size` 20). Default 5, igual que `CONFIG_listLoadMore`.
671
+ * clicks (105 resultados con `size` 21). Default 5, igual que `CONFIG_listLoadMore`.
669
672
  */
670
673
  maxPages?: number;
671
674
  /**
@@ -2244,13 +2247,13 @@ data: Array<ItemList>;
2244
2247
  }, any, {}>>;
2245
2248
 
2246
2249
  export declare const getScriptReplaces: {
2247
- [key in MetadataDefaultsKeys]: (props: Props_7) => replaces | undefined;
2250
+ [key in MetadataRouteKeys]: (props: Props_7) => replaces | undefined;
2248
2251
  };
2249
2252
 
2250
2253
  export declare function getServicePrefix(cfg?: PrefixConfig): string;
2251
2254
 
2252
2255
  export declare const getSlugs: {
2253
- [key in MetadataDefaultsKeys]: any;
2256
+ [key in MetadataRouteKeys]: any;
2254
2257
  };
2255
2258
 
2256
2259
  /** String (o undefined) para una clave dinámica; nunca devuelve el objeto `comentarios`. */
@@ -2786,7 +2789,7 @@ declare interface ItemListSchemaProps {
2786
2789
  config: Config;
2787
2790
  pathname: string;
2788
2791
  axiosApi: AxiosInstance;
2789
- ROUTE: MetadataDefaultsKeys;
2792
+ ROUTE: MetadataRouteKeys;
2790
2793
  }
2791
2794
 
2792
2795
  /**
@@ -3080,8 +3083,8 @@ export declare type LibraryConfig = {
3080
3083
  * completo: `[]`. Aditivo/retro-compatible: solo afecta buscar-sin-query, que
3081
3084
  * en esta familia de templates nunca renderiza banners (el render del
3082
3085
  * `LandingTemplate` ya está gateado por `amount > 0`). Se tipa como `string[]`
3083
- * (no `MetadataDefaultsKeys[]`) para evitar el import circular config ↔
3084
- * metadata_defaults; las claves válidas son las de `MetadataDefaultsKeys`.
3086
+ * (no `MetadataRouteKeys[]`) para evitar el import circular config ↔
3087
+ * metadata_defaults; las claves válidas son las de `MetadataRouteKeys`.
3085
3088
  */
3086
3089
  CONFIG_bannersRequireQuery?: string[];
3087
3090
  /**
@@ -3491,10 +3494,26 @@ export declare type Metadata = {
3491
3494
  };
3492
3495
  };
3493
3496
 
3494
- export declare const metadata_defaults: { [key in MetadataDefaultsKeys]: any; };
3497
+ export declare const metadata_defaults: { [key in MetadataRouteKeys]: any; };
3495
3498
 
3496
3499
  export declare type MetadataDefaultsKeys = '404' | 'home' | 'slug' | 'news' | 'anuncia' | 'autor' | 'buscar' | 'contacto' | 'pages' | 'seccion' | 'tema' | 'ultimas-noticias' | 'video' | 'videos' | 'auth';
3497
3500
 
3501
+ /**
3502
+ * Keys OPT-IN: la librería las soporta, pero NO entran en `MetadataDefaultsKeys`
3503
+ * para no romper a los sitios que tipan sus mapas como
3504
+ * `{ [key in MetadataDefaultsKeys]: ... }` (exhaustivos). Un sitio que las use
3505
+ * tipa sus mapas con `MetadataRouteKeys`.
3506
+ *
3507
+ * `custom`: ruta propia del sitio (ej. podcast, en vivo). Calcada de `buscar`
3508
+ * pero sin el gate de query: banners siempre prendidos, sin schemas por default
3509
+ * (ver `ROUTE_HEAD_DEFAULTS` en Head.tsx). La ruta mete su propia
3510
+ * `custom_metadata`; el handler es solo el fallback.
3511
+ */
3512
+ export declare type MetadataOptionalKeys = 'custom';
3513
+
3514
+ /** Todo lo que acepta la librería como ruta: las de siempre + las opt-in. */
3515
+ export declare type MetadataRouteKeys = MetadataDefaultsKeys | MetadataOptionalKeys;
3516
+
3498
3517
  export declare const metadataToJSX: (metadata: any) => JSX_2.Element[];
3499
3518
 
3500
3519
  export declare const MiddleSection: FC<Props_27>;
@@ -4756,7 +4775,7 @@ declare type Props_5 = {
4756
4775
  banners: BannerResponse[];
4757
4776
  config: Config;
4758
4777
  socials: Socials;
4759
- defaultMetadataName: MetadataDefaultsKeys;
4778
+ defaultMetadataName: MetadataRouteKeys;
4760
4779
  meta: any;
4761
4780
  imgSizes?: any;
4762
4781
  texts?: textsType;
@@ -4928,7 +4947,7 @@ declare type Props_59 = {
4928
4947
 
4929
4948
  declare type Props_6 = {
4930
4949
  children: ReactNode;
4931
- defaultRouteName: MetadataDefaultsKeys;
4950
+ defaultRouteName: MetadataRouteKeys;
4932
4951
  banners: BannerResponse[];
4933
4952
  pathname: string;
4934
4953
  config: Config;