libreria-astro-lefebvre 0.1.37 → 0.1.39

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libreria-astro-lefebvre",
-  "version": "0.1.37",
+  "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/Author_2025_Algarve.ts

@@ -4,7 +4,7 @@ export const metadata: ComponentMetadata = {
   component_name: 'Author_2025_Algarve',
   category: 'Contenido de Imagen',
   name: 'Ficha de autor con imagen y tiempo de lectura 2025',
-  description: 'Ficha compacta de autor para cabeceras de artículo: imagen a la izquierda (con border-radius configurable), nombre subrayado y profesión a la derecha, y bloque opcional de "tiempo de lectura" al final. Incluye structured data schema.org. Para la corporativa de Lefebvre',
+  description: 'Ficha compacta de autor para cabeceras de artículo: imagen a la izquierda (con border-radius configurable), nombre subrayado y profesión a la derecha, y bloque opcional de "tiempo de lectura" al final. Para la corporativa de Lefebvre',
   framework: 'Astro',
   priority: 1,
   tags: ['autor', 'imagen', 'blog', 'cabecera', 'tiempo'],
@@ -12,7 +12,7 @@ export const metadata: ComponentMetadata = {
     {
       name: 'nameAuthor',
       type: 'text',
-      help: 'Nombre del autor. Se renderiza como párrafo subrayado (Inter 16px color #262626) y admite HTML (set:html). También se usa en el structured data (schema.org) como "name". Conviene que ocupe una sola línea',
+      help: 'Nombre del autor. Se renderiza como párrafo subrayado (Inter 16px color #262626) y admite HTML (set:html). Conviene que ocupe una sola línea',
       label: 'Nombre del autor',
       mandatory: false,
       example_value: 'María García López'
@@ -28,7 +28,7 @@ export const metadata: ComponentMetadata = {
     {
       name: 'descriptionAuthor',
       type: 'text',
-      help: 'Profesión o descripción del autor. Se renderiza como párrafo (Inter 14px color #363942) debajo del nombre y admite HTML (set:html). También se usa en el structured data como "description". Conviene que ocupe una sola línea',
+      help: 'Profesión o descripción del autor. Se renderiza como párrafo (Inter 14px color #363942) debajo del nombre y admite HTML (set:html). Conviene que ocupe una sola línea',
       label: 'Descripción del autor',
       mandatory: false,
       example_value: 'Abogada especialista en Derecho Fiscal con 15 años de experiencia'

package/src/carbins/Cabecera_2025_Barcelona.ts

@@ -50,7 +50,7 @@ export const metadata: ComponentMetadata = {
     {
       name: 'siteUrl',
       type: 'text',
-      help: 'Origen público del sitio (protocolo + host, sin barra final, p. ej. "https://lefebvre.es"). Se usa para las URLs absolutas del BreadcrumbList en el structured data SEO. Necesario en SSR tras un proxy, donde Astro.url resuelve al host interno (localhost). Si se deja vacío, se usa Astro.site o el host de la petición',
+      help: 'Origen público del sitio (protocolo + host, sin barra final, p. ej. "https://lefebvre.es"). Se usa para las URLs absolutas de los niveles intermedios del BreadcrumbList en el structured data SEO. Necesario en SSR tras un proxy, donde Astro.url resuelve al host interno (localhost). Si se deja vacío, se usa Astro.site o el host de la petición',
       label: 'URL del sitio',
       mandatory: false,
       example_value: ''

package/src/carbins/SEO_Schema_Page.ts

@@ -149,6 +149,30 @@ export const metadata: ComponentMetadata = {
       mandatory: false,
       example_value: 'https://www.lefebvre.es/#organization'
     },
+    {
+      name: 'websiteId',
+      type: 'text',
+      help: '@id del nodo WebSite del sitio (el del @graph del Layout). Si se proporciona, el WebPage de la página añade isPartOf: { "@id": ... } enlazando la página con el sitio/organización.',
+      label: '@id del WebSite (isPartOf)',
+      mandatory: false,
+      example_value: 'https://genia-l.lefebvre.es/#website'
+    },
+    {
+      name: 'breadcrumbId',
+      type: 'text',
+      help: '@id de la BreadcrumbList de la página (el que emite Cabecera_2025_Barcelona, = {canonical}#breadcrumb). Si se proporciona, el WebPage añade breadcrumb: { "@id": ... }. No pasarlo si la página no tiene breadcrumb (evita referencia colgante).',
+      label: '@id del breadcrumb',
+      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/carbins/Texto_2026_Alicante.ts

@@ -4,7 +4,7 @@ export const metadata: ComponentMetadata = {
   component_name: 'Texto_2026_Alicante',
   category: 'Contenido de Texto',
   name: 'Bloque centrado con icono circular, título, descripción y botón CTA 2026',
-  description: 'Bloque de contenido centrado con cuatro elementos verticales: (1) icono SVG fijo (campana de notificación azul) dentro de un chip circular con fondo #F2F3F8 y padding de 12px; (2) título h3 en Poppins 20px / 24px en desktop semibold; (3) descripción en Inter 16px; (4) botón CTA primario con fondo azul #2134F1, hover invertido (fondo blanco, texto azul). Todos los elementos (icono, descripción y botón) son ocultables independientemente. El título se renderiza siempre si tiene valor. Genera datos estructurados schema.org WebPageElement con title y description',
+  description: 'Bloque de contenido centrado con cuatro elementos verticales: (1) icono SVG fijo (campana de notificación azul) dentro de un chip circular con fondo #F2F3F8 y padding de 12px; (2) título h3 en Poppins 20px / 24px en desktop semibold; (3) descripción en Inter 16px; (4) botón CTA primario con fondo azul #2134F1, hover invertido (fondo blanco, texto azul). Todos los elementos (icono, descripción y botón) son ocultables independientemente. El título se renderiza siempre si tiene valor',
   framework: 'Astro',
   priority: 1,
   tags: ['texto', 'icono', 'cta', 'boton', 'centrado'],
@@ -12,7 +12,7 @@ export const metadata: ComponentMetadata = {
     {
       name: 'title',
       type: 'text',
-      help: 'Título principal del bloque (se renderiza como h3 en Poppins 20px en móvil / 24px en desktop, semibold). Admite HTML. También se inyecta en los datos estructurados (schema.org) como nombre del WebPageElement. Si está vacío, el h3 se renderiza vacío',
+      help: 'Título principal del bloque (se renderiza como h3 en Poppins 20px en móvil / 24px en desktop, semibold). Admite HTML. Si está vacío, el h3 se renderiza vacío',
       label: 'Texto del título',
       mandatory: false,
       example_value: '¿Quieres saber más sobre GenIA-L?'
@@ -20,7 +20,7 @@ export const metadata: ComponentMetadata = {
     {
       name: 'description',
       type: 'text',
-      help: 'Descripción que aparece debajo del título (Inter 16px, line-height 24px). Admite HTML. Solo se renderiza si "Mostrar descripción" está activado. También se inyecta en los datos estructurados (schema.org) como descripción del WebPageElement (con etiquetas HTML eliminadas automáticamente)',
+      help: 'Descripción que aparece debajo del título (Inter 16px, line-height 24px). Admite HTML. Solo se renderiza si "Mostrar descripción" está activado',
       label: 'Texto de la descripción',
       mandatory: false,
       example_value: 'Solicita una demo personalizada y descubre cómo la IA jurídica puede transformar tu despacho.'

package/src/components/Astro/Author_2025_Algarve.astro

@@ -36,16 +36,6 @@ const sizeClassMap: Record<number, string> = {
 const sizeClass = sizeClassMap[imageSize] ?? "max-w-[240px] max-h-[240px]";
 
 
-const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
-
-const structuredData = (nameAuthor || descriptionAuthor) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(nameAuthor)}"${descriptionAuthor ? `,
-    "description": "${escapeJson(descriptionAuthor)}"` : ''}
-}
-</script>` : '';
 
 ---
 
@@ -91,7 +81,4 @@ const structuredData = (nameAuthor || descriptionAuthor) ? `<script type="applic
         </div>
         {minutes && <Tiempo_2025_Londres minutes={minutes} />}
     </div>
-)}
-
-
-<Fragment set:html={structuredData} />
+)}

package/src/components/Astro/Cabecera_2025_Barcelona.astro

@@ -7,12 +7,10 @@ const {
     siteUrl = "",
     } = Astro.props;
 
-    // Origen absoluto para el JSON-LD de breadcrumbs. En SSR tras un proxy, Astro.url resuelve
-    // al host interno (localhost), así que se prioriza `siteUrl` (prop) y `Astro.site` (config).
+    // Origen absoluto para las URLs de los niveles INTERMEDIOS del breadcrumb (otras páginas).
+    // En SSR tras un proxy, Astro.url resuelve al host interno, así que se prioriza `siteUrl`/`Astro.site`.
     const origin = (siteUrl || Astro.site?.href || Astro.url.origin).replace(/\/+$/, '');
 
-    const currentUrl = new URL(subdirectory + Astro.url.pathname, origin).href;
-
     const homeUrl = new URL(subdirectory + '/', origin).href;
 
     const toAbsoluteUrl = (url: string) => {
@@ -27,12 +25,15 @@ const {
     const allBreadcrumbItems = [
         { name: homeLabel, id: homeUrl },
         ...items.map((item: { text: string; url: string }) => ({ name: item.text, id: toAbsoluteUrl(item.url) })),
-        { name: text, id: currentUrl },
+        // La página actual referencia el nodo WebPage por @id RELATIVO (#webpage), el mismo que
+        // define SEO_Schema_Page → ambos bloques resuelven al MISMO nodo sin conocer la URL.
+        { name: text, id: '#webpage' },
     ];
 
     const breadcrumbStructuredData = {
         "@context": "https://schema.org",
         "@type": "BreadcrumbList",
+        "@id": '#breadcrumb',
         "itemListElement": allBreadcrumbItems.map((item, i) => ({
             "@type": "ListItem",
             "position": i + 1,

package/src/components/Astro/Card_2025_Malta.astro

@@ -5,16 +5,23 @@ interface MaltaItem {
     link?: string;
 }
 
+import { PAGE_ENTITY_ID } from '../../lib/functions.js';
+
 const {
     items = []
 }: { 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, 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",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: MaltaItem, i: number) => `{
         "@type": "ListItem",

package/src/components/Astro/Contenido_2025_Cordoba.astro

@@ -9,17 +9,6 @@ const {
     flexOrientationIcoText = "flex-row",
 } = 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 = (title || description) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(title)}"${description ? `,
-    "description": "${escapeJson(description)}"` : ''}
-}
-</script>` : '';
-
 ---
 
 
@@ -99,6 +88,4 @@ const structuredData = (title || description) ? `<script type="application/ld+js
             }
             <p class="text-[#363942] text-center">{description}</p>
         </div>
-    </div>
-
-    <Fragment set:html={structuredData} />
+    </div>

package/src/components/Astro/Contenido_2025_Granada.astro

@@ -10,17 +10,6 @@ const {
     widthBlock = "lg:w-1/4 md:w-2/4", /* lg:w-1/3 */
 } = 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 = (title || description) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(title)}"${description ? `,
-    "description": "${escapeJson(description)}"` : ''}
-}
-</script>` : '';
-
 ---
 
 
@@ -202,6 +191,4 @@ const structuredData = (title || description) ? `<script type="application/ld+js
             }
             <p class="text-[#363942]" set:html={description}></p>
         </div>
-    </div>
-
-    <Fragment set:html={structuredData} />
+    </div>

package/src/components/Astro/Contenido_2026_Cabra.astro

@@ -2,12 +2,16 @@
 
 import Contenido_2026_Menorca from './Contenido_2026_Menorca.astro';
 import Titulo_2025_Algeciras from './Titulo_2025_Algeciras.astro';
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 const {
     items = [],
 } = Astro.props;
 
+// isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
+// 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[] };
 
@@ -38,7 +42,9 @@ const structuredData = `<script type="application/ld+json">
     "@type": "WebPageElement",
     "name": "${escapeJson(tabs.map((t: Tab) => t.name).filter(Boolean).join(' · '))}",
     "mainEntity": {
-        "@type": "ItemList",
+        "@type": "ItemList",${itemListId ? `
+        "@id": "${itemListId}",` : ''}${pageId ? `
+        "isPartOf": { "@id": "${pageId}" },` : ''}
         "numberOfItems": ${tabs.length},
         "itemListElement": [${tabs.map((tab: Tab, index: number) => `{
             "@type": "ListItem",

package/src/components/Astro/Contenido_2026_Estocolmo.astro

@@ -1,7 +1,7 @@
 ---
 
 import Contenido_2025_Montevideo from "./Contenido_2025_Montevideo.astro";
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 interface MontevideoItem {
     link?: string;
@@ -23,12 +23,18 @@ const {
     showAutor = false,
     }: { 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="".
+// 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",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: MontevideoItem, i: number) => `{
         "@type": "ListItem",

package/src/components/Astro/Contenido_2026_Jaen.astro

@@ -17,16 +17,6 @@ const {
 
 import RRSS_2025_Pisa from "./RRSS_2025_Pisa.astro";
 
-const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
-
-const structuredData = (title || description) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(title)}"${description ? `,
-    "description": "${escapeJson(description)}"` : ''}
-}
-</script>` : '';
 
 ---
 
@@ -84,8 +74,6 @@ const structuredData = (title || description) ? `<script type="application/ld+js
     )}
 </div>
 
-<Fragment set:html={structuredData} />
-
 <style>
     .moreDescription h2 {
         color: #262626;

package/src/components/Astro/Contenido_2026_Michigan.astro

@@ -1,5 +1,6 @@
 ---
 import Formulario_2025_Teruel from './Formulario_2025_Teruel.astro';
+import { PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 const {
     orientation = 'left',
@@ -11,12 +12,17 @@ const {
     items
     } = Astro.props;
 
+    // isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
+    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",
+        "@type": "ItemList",${itemListId ? `
+        "@id": "${itemListId}",` : ''}${pageId ? `
+        "isPartOf": { "@id": "${pageId}" },` : ''}
         "numberOfItems": ${items.length},
         "itemListElement": [
             ${items.map((item, index) => `{

package/src/components/Astro/Contenido_2026_Orcasitas.astro

@@ -1,5 +1,5 @@
 ---
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 interface OrcasitasItem {
     iframeSrc?: string;
@@ -21,6 +21,9 @@ const {
     slidesToScroll = 1,
 }: { 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, itemListId = '' } = Astro.props;
+
 const carouselId = "glider-carousel-"+Math.floor(Math.random()*1000);
 const buttonsId = "glider-carousel-buttons-"+Math.floor(Math.random()*1000);
 const prevId = "glider-carousel-prev-"+Math.floor(Math.random()*1000);
@@ -56,7 +59,9 @@ const buildImageItem = (item: OrcasitasItem) => {
 const structuredData = items.length > 0 ? `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: OrcasitasItem, index: number) => `{
         "@type": "ListItem",

package/src/components/Astro/Contenido_2026_Oslo.astro

@@ -1,13 +1,21 @@
 ---
+import { PAGE_ENTITY_ID } from '../../lib/functions.js';
+
 const {
     items
 } = Astro.props;
 
+// isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
+// 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) => ({
         "@type": "ListItem",

package/src/components/Astro/Contenido_2026_Ubeda.astro

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

package/src/components/Astro/Contenido_2026_Yakarta.astro

@@ -1,5 +1,5 @@
 ---
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 interface VideoItem {
     name?: string;
@@ -17,6 +17,9 @@ const {
     items = [],
 }: { 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, itemListId = '' } = Astro.props;
+
 const idAccordion = 'js-acordeon-' + Math.random().toString(36).substring(2, 15);
 
 const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
@@ -24,7 +27,9 @@ 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",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: VideoItem, index: number) => `{
         "@type": "ListItem",

package/src/components/Astro/Galeria_2026_Segorbe.astro

@@ -1,5 +1,5 @@
 ---
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 interface GaleriaItem {
     image?: string;
@@ -11,6 +11,9 @@ const {
     items = []
 }: { 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, itemListId = '' } = Astro.props;
+
 const lgColsClass = {
     '2': 'lg:columns-2',
     '3': 'lg:columns-3',
@@ -24,7 +27,9 @@ const escapeJson = (s = '') => String(s).replace(/<[^>]*>/g, '').replace(/\\/g,
 const structuredData = `<script type="application/ld+json">
 {
     "@context": "https://schema.org",
-    "@type": "ItemList",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${visibleItems.length},
     "itemListElement": [${visibleItems.map((item: GaleriaItem, i: number) => `{
         "@type": "ListItem",

package/src/components/Astro/Indice_2025_Taiwan.astro

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

package/src/components/Astro/SEO_Schema_Page.astro

@@ -33,6 +33,9 @@ interface Props {
     publisherLogo?: string;
     publisherUrl?: string;
     publisherId?: string;
+    websiteId?: string;
+    breadcrumbId?: string;
+    mainEntityId?: string;
     keywords?: string;
     inLanguage?: string;
     articleSection?: string;
@@ -60,6 +63,9 @@ const {
     publisherLogo = 'https://assets.lefebvre.es/media/logos-2/svg/lefebvre.svg',
     publisherUrl = 'https://lefebvre.es',
     publisherId,
+    websiteId,
+    breadcrumbId,
+    mainEntityId,
     keywords,
     inLanguage = 'es',
     articleSection,
@@ -73,75 +79,121 @@ const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g,
 
 const isArticleType = (['Article', 'BlogPosting', 'NewsArticle'] as PageType[]).includes(pageType);
 
-const schema: Record<string, unknown> = {
-    '@context': 'https://schema.org',
-    '@type': pageType,
-    name,
-    description,
-    url,
-    inLanguage,
-};
+// @id por-página RELATIVOS de fragmento: cualquier bloque del mismo documento (incluido el HTML
+// inyectado por el render API del CMS) puede referenciarlos sin conocer la URL; Google los resuelve
+// contra la página. Los @id de sitio/cross-página (websiteId, publisherId, authorId/#person) siguen
+// absolutos y se reciben por props.
+const webPageNodeId = '#webpage';
+const primaryImageId = '#primaryimage';
+const articleNodeId = '#article';
 
-if (image) schema.image = image;
-if (keywords) schema.keywords = keywords;
+// Nodo ImageObject de la imagen principal (si hay), referenciable por @id.
+const imageNode = image
+    ? { '@type': 'ImageObject', '@id': primaryImageId, url: image }
+    : null;
 
-if (isArticleType) {
-    schema.headline = headline || name;
-    schema.mainEntityOfPage = { '@type': 'WebPage', '@id': url };
-    if (datePublished) schema.datePublished = datePublished;
-    if (dateModified) schema.dateModified = dateModified;
-    if (articleSection) schema.articleSection = articleSection;
-    if (authorId) {
-        schema.author = { '@id': authorId };
-    } else if (authorName) {
-        const author: Record<string, unknown> = { '@type': authorType, name: authorName };
-        if (authorUrl) author.url = authorUrl;
-        if (authorImage && authorType === 'Person') author.image = authorImage;
-        schema.author = author;
+// Autor: nodo inline CON @id (autocontenido y fusionable entre páginas) si llega authorName;
+// referencia pura { @id } si solo llega authorId (caso "Lefebvre" → #organization global).
+const buildAuthor = (): Record<string, unknown> | null => {
+    if (authorName) {
+        const node: Record<string, unknown> = { '@type': authorType, name: authorName };
+        if (authorId) node['@id'] = authorId;
+        if (authorUrl) node.url = authorUrl;
+        if (authorImage && authorType === 'Person') node.image = authorImage;
+        return node;
     }
-    if (publisherId) {
-        schema.publisher = { '@id': publisherId };
-    } else {
-        schema.publisher = {
+    if (authorId) return { '@id': authorId };
+    return null;
+};
+
+const buildPublisher = (): Record<string, unknown> =>
+    publisherId
+        ? { '@id': publisherId }
+        : {
             '@type': 'Organization',
             name: publisherName,
             url: publisherUrl,
             logo: { '@type': 'ImageObject', url: publisherLogo },
         };
-    }
+
+// --- Nodo WebPage (siempre). Para tipos artículo el @type es WebPage; si no, el propio pageType.
+const webPageType = isArticleType ? 'WebPage' : pageType;
+const webPage: Record<string, unknown> = {
+    '@type': webPageType,
+    '@id': webPageNodeId,
+    url,
+    name,
+    inLanguage,
+};
+if (description) webPage.description = description;
+if (websiteId) webPage.isPartOf = { '@id': websiteId };
+if (breadcrumbId) webPage.breadcrumb = { '@id': breadcrumbId };
+if (imageNode) webPage.primaryImageOfPage = { '@id': primaryImageId };
+if (!isArticleType && keywords) webPage.keywords = keywords;
+
+const graph: Array<Record<string, unknown>> = [webPage];
+if (imageNode) graph.push(imageNode);
+
+// --- Tipos artículo: nodo independiente (#article) enlazado al WebPage ---
+if (isArticleType) {
+    webPage.mainEntity = { '@id': articleNodeId };
+    const article: Record<string, unknown> = {
+        '@type': pageType,
+        '@id': articleNodeId,
+        headline: headline || name,
+        isPartOf: { '@id': webPageNodeId },
+        mainEntityOfPage: { '@id': webPageNodeId },
+        inLanguage,
+    };
+    if (description) article.description = description;
+    if (datePublished) article.datePublished = datePublished;
+    if (dateModified) article.dateModified = dateModified;
+    if (articleSection) article.articleSection = articleSection;
+    if (keywords) article.keywords = keywords;
+    if (imageNode) article.image = { '@id': primaryImageId };
+    const author = buildAuthor();
+    if (author) article.author = author;
+    article.publisher = buildPublisher();
+    graph.push(article);
 }
 
+// --- FAQPage: las preguntas son el mainEntity del WebPage ---
 if (pageType === 'FAQPage' && faqItems.length) {
-    schema.mainEntity = faqItems.map((item) => ({
+    webPage.mainEntity = faqItems.map((item) => ({
         '@type': 'Question',
         name: item.question,
-        acceptedAnswer: {
-            '@type': 'Answer',
-            text: item.answer,
-        },
+        acceptedAnswer: { '@type': 'Answer', text: item.answer },
     }));
 }
 
+// --- ProfilePage: el mainEntity es la entidad (Person/Organization) del autor ---
 if (pageType === 'ProfilePage' && (authorName || authorId)) {
-    if (authorId) {
-        schema.mainEntity = { '@id': authorId };
-    } else if (authorType === 'Organization') {
-        const organization: Record<string, unknown> = { '@type': 'Organization', name: authorName };
-        if (authorUrl) organization.url = authorUrl;
-        if (description) organization.description = description;
-        if (sameAs && sameAs.length) organization.sameAs = sameAs;
-        schema.mainEntity = organization;
-    } else {
-        const person: Record<string, unknown> = { '@type': 'Person', name: authorName };
-        if (authorUrl) person.url = authorUrl;
-        if (authorImage) person.image = authorImage;
-        if (jobTitle) person.jobTitle = jobTitle;
-        if (description) person.description = description;
-        if (sameAs && sameAs.length) person.sameAs = sameAs;
-        schema.mainEntity = person;
+    const entityId = authorId || `${url}#person`;
+    webPage.mainEntity = { '@id': entityId };
+    if (authorName) {
+        const entity: Record<string, unknown> = { '@type': authorType, '@id': entityId, name: authorName };
+        if (authorUrl) entity.url = authorUrl;
+        if (authorImage && authorType === 'Person') entity.image = authorImage;
+        if (jobTitle && authorType === 'Person') entity.jobTitle = jobTitle;
+        if (description) entity.description = description;
+        if (sameAs && sameAs.length) entity.sameAs = sameAs;
+        graph.push(entity);
     }
+    // Si solo llega authorId (sin authorName), se referencia un nodo definido en otra parte
+    // (p. ej. la Organization global #organization del Layout) → no se redeclara aquí.
 }
 
+// --- 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',
+    '@graph': graph,
+};
+
 const stringify = (value: unknown): string => {
     if (value === null || value === undefined) return 'null';
     if (typeof value === 'string') return `"${escapeJson(value)}"`;

package/src/components/Astro/Tabla_2026_Cadiz.astro

@@ -1,4 +1,6 @@
 ---
+import { PAGE_ENTITY_ID } from '../../lib/functions.js';
+
 const {
     title = "",
     description = "",
@@ -8,6 +10,11 @@ const {
     rightItems = [],
 } = Astro.props;
 
+// isPartOf hacia el nodo de página (#webpage por defecto). Genérico: opt-out con pageId="".
+// 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;
 const hasBoth = hasLeft && hasRight;
@@ -16,10 +23,12 @@ 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",
+    "@type": "ItemList",${listId ? `
+    "@id": "${listId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "name": "${escapeJson(listName)}",
     "numberOfItems": ${listItems.length},
     "itemListElement": [${listItems.map((item: Item, index: number) => `{
@@ -32,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/Texto_2026_Alicante.astro

@@ -15,16 +15,6 @@ const {
     color = '#262626',
 } = 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 = (title || description) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(title)}"${description ? `,
-    "description": "${escapeJson(description)}"` : ''}
-}
-</script>` : '';
 ---
 
 <section class="w-full flex items-center justify-center p-6 md:p-0">
@@ -34,6 +24,4 @@ const structuredData = (title || description) ? `<script type="application/ld+js
         {showDescription && <div class={`text-[${color}] font-inter text-base font-normal leading-[24px] mb-8`} set:html={description}></div>}
         {showBtn && <a href={linkBtn} class="text-[#ffffff] font-inter font-normal bg-[#2134F1] px-5 py-3 border border-[#2134F1] rounded-xl hover:bg-[#ffffff] hover:border-[#2134F1] shadow-[0_2px_4px_-2px_rgba(0,0,0,0.08),0_4px_8px_-2px_rgba(0,0,0,0.04)] transition-all duration-300 hover:text-[#2134F1]">{txtBtn}</a>}
     </article>
-</section>
-
-<Fragment set:html={structuredData} />
+</section>

package/src/components/Astro/Titulo_2025_Algeciras.astro

@@ -10,17 +10,6 @@ const {
     subdescription = "",
 } = 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 = (title || description) ? `<script type="application/ld+json">
-{
-    "@context": "https://schema.org",
-    "@type": "WebPageElement",
-    "name": "${escapeJson(title)}"${description ? `,
-    "description": "${escapeJson(description)}"` : ''}
-}
-</script>` : '';
-
 ---
 
 <div class={`w-full md:w-3/5 max-w-auto flex ${flexJustify === 'justify-center' ? 'justify-center' : 'justify-start'} flex-col p-4 md:p-0 mx-auto`}>
@@ -55,6 +44,4 @@ const structuredData = (title || description) ? `<script type="application/ld+js
     {subdescription && subdescription.trim() !== "" && (
         <div class={`w-full md:w-${descriptionWidth} text-[#363942] mx-auto max-w-[850px] font-poppins text-xl font-normal leading-7 mb-8 text-center`} set:html={subdescription}></div>
     )}
-</div>
-
-<Fragment set:html={structuredData} />
+</div>

package/src/components/Astro/Video_2025_Valencia.astro

@@ -1,6 +1,6 @@
 ---
 import Video_2025_Polop from './Video_2025_Polop.astro';
-import { extractImageUrl } from '../../lib/functions.js';
+import { extractImageUrl, PAGE_ENTITY_ID } from '../../lib/functions.js';
 
 interface VideoItem {
     title?: string;
@@ -17,6 +17,9 @@ const {
     iframeSrc
 }: { 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, itemListId = '' } = Astro.props;
+
 const idAccordion = 'js-acordeon-' + Math.random().toString(36).substring(2, 15);
 
 const escapeJson = (s = "") => String(s).replace(/<[^>]*>/g, '').replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/[\n\r\t]+/g, ' ');
@@ -24,7 +27,9 @@ 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",
+    "@type": "ItemList",${itemListId ? `
+    "@id": "${itemListId}",` : ''}${pageId ? `
+    "isPartOf": { "@id": "${pageId}" },` : ''}
     "numberOfItems": ${items.length},
     "itemListElement": [${items.map((item: VideoItem, index: number) => `{
         "@type": "ListItem",

package/src/lib/functions.js

@@ -1,5 +1,19 @@
 import { components } from '../generated/componentRegistry.ts';
 
+// ============================================================================
+// 🎯 Grafo JSON-LD
+// ============================================================================
+// @id RELATIVO de fragmento del nodo principal de la página (WebPage/CollectionPage…),
+// que emite SEO_Schema_Page. Es la fuente única de la convención: cualquier bloque del mismo
+// documento (incluido el HTML inyectado por el render API del CMS) puede colgar de la página con
+// 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
 // ============================================================================