libreria-astro-lefebvre 0.1.38 → 0.1.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libreria-astro-lefebvre",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "Librería de componentes Astro, React y Vue para Lefebvre",
   "author": "Equipo web desarrollo Lefebvre",
   "type": "module",

package/src/carbins/SEO_Schema_Page.ts

@@ -165,6 +165,14 @@ export const metadata: ComponentMetadata = {
       mandatory: false,
       example_value: ''
     },
+    {
+      name: 'mainEntityId',
+      type: 'text',
+      help: '@id del nodo principal de la página (la "entidad principal"), p. ej. el ItemList de un listado (#itemlist). Si se proporciona, el WebPage/CollectionPage añade mainEntity: { "@id": ... }. Solo aplica a tipos NO artículo/FAQ/ProfilePage (esos ya fijan su propio mainEntity). Usar @id relativo para que funcione también vía render API.',
+      label: '@id de la entidad principal (mainEntity)',
+      mandatory: false,
+      example_value: '#itemlist'
+    },
     {
       name: 'keywords',
       type: 'text',

package/src/components/Astro/Card_2025_Malta.astro

@@ -12,14 +12,15 @@ const {
 }: { items?: MaltaItem[] } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
 
 const structuredData = `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: MaltaItem, i: number) => `{

package/src/components/Astro/Contenido_2026_Cabra.astro

@@ -9,7 +9,8 @@ const {
 } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+// itemListId opcional: @id del ItemList (para ser mainEntity de la CollectionPage).
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 type TabPoint = { title: string; description: string; icon: string; showIco: boolean };
 type Tab = { name: string; buttonUrl: string; image: string; points: TabPoint[] };
@@ -41,7 +42,8 @@ const structuredData = `<script type="application/ld+json">
     "@type": "WebPageElement",
     "name": "${escapeJson(tabs.map((t: Tab) => t.name).filter(Boolean).join(' · '))}",
     "mainEntity": {
-        "@type": "ItemList",${pageId ? `
+        "@type": "ItemList",${itemListId ? `
+        "@id": "${itemListId}",` : ''}${pageId ? `
         "isPartOf": { "@id": "${pageId}" },` : ''}
         "numberOfItems": ${tabs.length},
         "itemListElement": [${tabs.map((tab: Tab, index: number) => `{

package/src/components/Astro/Contenido_2026_Estocolmo.astro

@@ -24,14 +24,16 @@ const {
     }: { items?: MontevideoItem[]; etiquetaVisible?: "fecha" | "keywords"; showAutor?: boolean } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+// itemListId opcional: si se pasa, el ItemList lleva ese @id (para ser mainEntity de la CollectionPage).
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
 
 const structuredData = `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: MontevideoItem, i: number) => `{

package/src/components/Astro/Contenido_2026_Michigan.astro

@@ -13,14 +13,15 @@ const {
     } = Astro.props;
 
     // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-    const { pageId = PAGE_ENTITY_ID } = Astro.props;
+    const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
     const randomId = Math.floor(Math.random() * 1000);
 
     const structuredData = `<script type="application/ld+json">
     {
         "@context": "https://schema.org",
-        "@type": "ItemList",${pageId ? `
+        "@type": "ItemList",${itemListId ? `
+        "@id": "${itemListId}",` : ''}${pageId ? `
         "isPartOf": { "@id": "${pageId}" },` : ''}
         "numberOfItems": ${items.length},
         "itemListElement": [

package/src/components/Astro/Contenido_2026_Orcasitas.astro

@@ -22,7 +22,7 @@ const {
 }: { loadScript?: boolean; items?: OrcasitasItem[]; slidesToShow?: number; slidesToScroll?: number } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const carouselId = "glider-carousel-"+Math.floor(Math.random()*1000);
 const buttonsId = "glider-carousel-buttons-"+Math.floor(Math.random()*1000);
@@ -59,7 +59,8 @@ const buildImageItem = (item: OrcasitasItem) => {
 const structuredData = items.length > 0 ? `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: OrcasitasItem, index: number) => `{

package/src/components/Astro/Contenido_2026_Oslo.astro

@@ -6,13 +6,15 @@ const {
 } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+// itemListId opcional: @id del ItemList (para ser mainEntity de la CollectionPage).
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const randomId = Math.floor(Math.random() * 1000);
 
 const structuredData = JSON.stringify({
     "@context": "https://schema.org",
     "@type": "ItemList",
+    ...(itemListId ? { "@id": itemListId } : {}),
     ...(pageId ? { isPartOf: { "@id": pageId } } : {}),
     "numberOfItems": items.length,
     "itemListElement": items.map((item, index) => ({

package/src/components/Astro/Contenido_2026_Ubeda.astro

@@ -6,12 +6,13 @@ const {
     } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
     const structuredData = `<script type="application/ld+json">
     {
         "@context": "https://schema.org",
-        "@type": "ItemList",${pageId ? `
+        "@type": "ItemList",${itemListId ? `
+        "@id": "${itemListId}",` : ''}${pageId ? `
         "isPartOf": { "@id": "${pageId}" },` : ''}
         "numberOfItems": ${items.length},
         "itemListElement": [

package/src/components/Astro/Contenido_2026_Yakarta.astro

@@ -18,7 +18,7 @@ const {
 }: { items?: VideoItem[] } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const idAccordion = 'js-acordeon-' + Math.random().toString(36).substring(2, 15);
 
@@ -27,7 +27,8 @@ const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g,
 const structuredData = items.length > 0 ? `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: VideoItem, index: number) => `{

package/src/components/Astro/Galeria_2026_Segorbe.astro

@@ -12,7 +12,7 @@ const {
 }: { columns?: string; items?: GaleriaItem[] } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const lgColsClass = {
     '2': 'lg:columns-2',
@@ -27,7 +27,8 @@ const escapeJson = (s = '') => String(s).replace(/<[^>]*>/g, '').replace(/\\/g,
 const structuredData = `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${visibleItems.length},
     "itemListElement": [${visibleItems.map((item: GaleriaItem, i: number) => `{

package/src/components/Astro/Indice_2025_Taiwan.astro

@@ -9,7 +9,7 @@ const {
 } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 interface IndiceItem {
     enlace: string;
@@ -31,7 +31,8 @@ const baseUrl = new URL(subdirectory + Astro.url.pathname, origin).href.split('#
 const structuredData = `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "name": "${escapeJson(titulo)}",
     "numberOfItems": ${indiceItems.length},

package/src/components/Astro/SEO_Schema_Page.astro

@@ -35,6 +35,7 @@ interface Props {
     publisherId?: string;
     websiteId?: string;
     breadcrumbId?: string;
+    mainEntityId?: string;
     keywords?: string;
     inLanguage?: string;
     articleSection?: string;
@@ -64,6 +65,7 @@ const {
     publisherId,
     websiteId,
     breadcrumbId,
+    mainEntityId,
     keywords,
     inLanguage = 'es',
     articleSection,
@@ -181,7 +183,11 @@ if (pageType === 'ProfilePage' && (authorName || authorId)) {
     // (p. ej. la Organization global #organization del Layout) → no se redeclara aquí.
 }
 
-// --- CollectionPage: el mainEntity (→ ItemList) se difiere a una fase posterior ---
+// --- mainEntity explícito (p. ej. CollectionPage → ItemList): se aplica solo si el tipo no la fija
+// ya (artículo/FAQ/Profile). El consumidor pasa el @id del nodo principal (relativo, p. ej. "#itemlist").
+if (mainEntityId && !webPage.mainEntity) {
+    webPage.mainEntity = { '@id': mainEntityId };
+}
 
 const schema: Record<string, unknown> = {
     '@context': 'https://schema.org',

package/src/components/Astro/Tabla_2026_Cadiz.astro

@@ -11,7 +11,9 @@ const {
 } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+// itemListId opcional: se aplica SOLO a la lista izquierda/principal (la derecha nunca lleva @id,
+// para no duplicar el mismo @id en la página).
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const hasLeft = leftTitle || leftItems.length > 0;
 const hasRight = rightTitle || rightItems.length > 0;
@@ -21,10 +23,11 @@ type Item = { text: string; link?: string; target?: string };
 
 const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
 
-const buildItemListScript = (listName: string, listItems: Item[]) => `<script type="application/ld+json">
+const buildItemListScript = (listName: string, listItems: Item[], listId = '') => `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${listId ? `
+    "@id": "${listId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "name": "${escapeJson(listName)}",
     "numberOfItems": ${listItems.length},
@@ -38,7 +41,7 @@ const buildItemListScript = (listName: string, listItems: Item[]) => `<script ty
 </script>`;
 
 const structuredData = [
-    hasLeft ? buildItemListScript(leftTitle, leftItems) : '',
+    hasLeft ? buildItemListScript(leftTitle, leftItems, itemListId) : '',
     hasRight ? buildItemListScript(rightTitle, rightItems) : '',
 ].filter(Boolean).join('\n');
 ---

package/src/components/Astro/Video_2025_Valencia.astro

@@ -18,7 +18,7 @@ const {
 }: { items?: VideoItem[]; iframeSrc?: string } = Astro.props;
 
 // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
-const { pageId = PAGE_ENTITY_ID } = Astro.props;
+const { pageId = PAGE_ENTITY_ID, itemListId = '' } = Astro.props;
 
 const idAccordion = 'js-acordeon-' + Math.random().toString(36).substring(2, 15);
 
@@ -27,7 +27,8 @@ const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g,
 const structuredData = items.length > 0 ? `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",${pageId ? `
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
     "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: VideoItem, index: number) => `{

package/src/lib/functions.js

@@ -9,6 +9,11 @@ import { components } from '../generated/componentRegistry.ts';
 // isPartOf: { "@id": PAGE_ENTITY_ID } sin necesidad de conocer la URL/canonical.
 export const PAGE_ENTITY_ID = '#webpage';
 
+// @id RELATIVO del ItemList principal de una página. Convención: el listado principal lleva este @id
+// y la CollectionPage (vía SEO_Schema_Page mainEntityId) lo referencia como mainEntity. Relativo →
+// resuelve contra la página, así que vale tanto para el front como para el render API del CMS.
+export const MAIN_ITEMLIST_ID = '#itemlist';
+
 // ============================================================================
 // 🎯 Utilidades de Imagen para Limbo
 // ============================================================================