@press2ai/theme-specialist-glossy 3.0.2 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@press2ai/theme-specialist-glossy",
-  "version": "3.0.2",
+  "version": "3.1.0",
   "description": "Classless, AI-first glossy theme. Framework-agnostic templates (Hono, Astro, raw HTML). Semantic HTML, Schema.org microdata, JSON-LD — built for LLM crawlers.",
   "type": "module",
   "license": "MIT",

package/src/ai.ts

@@ -59,7 +59,7 @@ export function getAiManifest(opts: {
 
     powered_by: {
       name: '@press2ai/theme-specialist-glossy',
-      version: '3.0.2',
+      version: '3.1.0',
       homepage: 'https://www.npmjs.com/package/@press2ai/theme-specialist-glossy',
     },
 

package/src/templates/catalog-grid.ts

@@ -1,16 +1,15 @@
 import { esc } from './helpers.ts';
 
-// Selector matches `<section>` whose direct child is the article cards rendered
-// by `profileCard()`. Cards themselves are styled by profile-card.ts using the
-// same selector head — the two files share this invariant.
-const R = 'main > section:has(> article[itemscope])';
+// Section identified by schema.org ItemList. profile-card.ts targets nested
+// Person articles via the same ItemList head — keep both in sync.
+const R = 'main > section[itemtype$="ItemList"]';
 
 export const css = `${R} { display: grid; grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)); gap: var(--g3); }
 ${R} > h2 { grid-column: 1 / -1; }
 @media (max-width: 640px) { ${R} { grid-template-columns: 1fr; } }`;
 
-export function catalogGrid(p: { title: string; filters?: string; cards: string }): string {
-  return `<section>
+export function catalogGrid(p: { title: string; filters?: string; cards: string; ariaLabel?: string }): string {
+  return `<section itemscope itemtype="https://schema.org/ItemList" aria-label="${esc(p.ariaLabel ?? p.title)}">
 <h2>${esc(p.title)}</h2>
 ${p.filters ?? ''}
 ${p.cards}

package/src/templates/category-nav.ts

@@ -1,9 +1,7 @@
 import { esc } from './helpers.ts';
 
-// Selector matches `<nav>` direct child of `main` that contains `<a>` — i.e.
-// the bare list-of-anchors nav rendered below. Hero's CTA <nav> sits inside
-// <hgroup>, not <main>, so it is not affected.
-const R = 'main > nav:has(> a)';
+// Identified by schema.org SiteNavigationElement.
+const R = 'main > nav[itemtype$="SiteNavigationElement"]';
 
 export const css = `${R} { display: flex; flex-wrap: wrap; gap: var(--g1); }
 ${R} > a {
@@ -16,5 +14,5 @@ ${R} > a:hover { border-color: var(--accent); color: var(--accent); background:
 export function categoryNav(items: { href: string; label: string }[], ariaLabel = 'Kategorie'): string {
   if (!items.length) return '';
   const links = items.map(i => `<a href="${esc(i.href)}">${esc(i.label)}</a>`).join('');
-  return `<nav aria-label="${esc(ariaLabel)}">${links}</nav>`;
+  return `<nav itemscope itemtype="https://schema.org/SiteNavigationElement" aria-label="${esc(ariaLabel)}">${links}</nav>`;
 }

package/src/templates/layout.ts

@@ -50,7 +50,7 @@ export interface LayoutProps {
   footerContent?: string;
 }
 
-const THEME_VERSION = '3.0.2';
+const THEME_VERSION = '3.1.0';
 
 export function layout(props: LayoutProps, body: string): string {
   const {

package/src/templates/pagination.ts

@@ -1,8 +1,7 @@
 import { esc } from './helpers.ts';
 
-// Selector matches `<nav>` containing `<p>` — the shape of `pagination()`.
-// category-nav uses `<nav>` containing `<a>` directly, not `<p>`, so they don't collide.
-const R = 'main > nav:has(> p)';
+// Identified by data-section="pagination" — schema.org has no pagination type.
+const R = 'main > nav[data-section="pagination"]';
 
 export const css = `${R} > p { display: flex; align-items: center; justify-content: center; gap: var(--g3); font-size: 1rem; color: var(--fg-faint); }
 ${R} a {
@@ -27,5 +26,5 @@ export function pagination(p: PaginationProps): string {
   const extra = p.extraParams ?? '';
   const prev = p.current > 1 ? `<a href="${esc(base)}?p=${p.current - 1}${extra}">${esc(p.prevLabel ?? '\u2190 Poprzednia')}</a>` : '';
   const next = p.current < p.total ? `<a href="${esc(base)}?p=${p.current + 1}${extra}">${esc(p.nextLabel ?? 'Następna \u2192')}</a>` : '';
-  return `<nav><p>${prev} Strona ${p.current} z ${p.total} ${next}</p></nav>`;
+  return `<nav data-section="pagination" aria-label="Paginacja"><p>${prev} Strona ${p.current} z ${p.total} ${next}</p></nav>`;
 }

package/src/templates/profile-article.ts

@@ -1,9 +1,8 @@
 import type { Profile } from '../schema.ts';
 import { esc, fullName } from './helpers.ts';
 
-// Selector root MUST match the outer element below (`<article itemscope>` inside <main>).
-// If you change the HTML root, change R — and vice versa. Keep them in this file together.
-const R = 'main > article[itemscope]';
+// Selector is the schema.org Person fingerprint — must match the outer element below.
+const R = 'main > article[itemtype$="Person"]';
 
 export const css = `${R} { max-width: 667px; }
 ${R} > header { padding-bottom: var(--g4); margin-bottom: var(--g4); border-bottom: 2px solid var(--fg); }

package/src/templates/profile-card.ts

@@ -1,10 +1,8 @@
 import type { Profile } from '../schema.ts';
 import { esc, fullName } from './helpers.ts';
 
-// Card sits inside catalog grid: `<section><h2>...</h2><article>...</article>...</section>`.
-// Selector targets the article only when wrapped by such a section — keep that
-// shape in sync with `catalogGrid()` in catalog-grid.ts.
-const R = 'main > section:has(> article[itemscope]) > article[itemscope]';
+// Card = Person inside ItemList rendered by catalogGrid(). Keep in sync.
+const R = 'main > section[itemtype$="ItemList"] > article[itemtype$="Person"]';
 
 export const css = `${R} {
   background: var(--card); border: 1px solid var(--border); border-radius: var(--r-lg);
@@ -40,7 +38,7 @@ export function profileCard(p: Profile, href: string): string {
     ? `<ul>${p.specialties.slice(0, 3).map(s => `<li>${esc(s)}</li>`).join('')}</ul>`
     : '';
 
-  return `<article itemscope itemtype="https://schema.org/Person">
+  return `<article itemprop="itemListElement" itemscope itemtype="https://schema.org/Person">
 <div aria-hidden="true">${initials}</div>
 <header>
 <h2><a href="${esc(href)}" itemprop="url"><span itemprop="name">${esc(name)}</span></a></h2>

package/src/templates/stat-bar.ts

@@ -1,8 +1,7 @@
 import { esc } from './helpers.ts';
 
-// Selector matches `<section>` whose direct child is `<dl>` — that's how
-// `statBar()` below renders. If you change the wrapper, update the selector.
-const R = 'main > section:has(> dl)';
+// Identified by data-section="stats" — no good schema.org type for stats.
+const R = 'main > section[data-section="stats"]';
 
 export const css = `${R} > dl { display: flex; justify-content: center; gap: var(--g5); }
 ${R} > dl div { text-align: center; }
@@ -27,5 +26,5 @@ export function statBar(items: { value: string; label: string; icon?: string }[]
     return `<div>${icon}<dt>${esc(i.value)}</dt><dd>${esc(i.label)}</dd></div>`;
   }).join('\n');
   const summaryP = summary ? `<p>${esc(summary)}</p>` : '';
-  return `<section aria-label="Statystyki">${summaryP}<dl aria-hidden="true">\n${divs}\n</dl></section>`;
+  return `<section data-section="stats" role="region" aria-label="Statystyki">${summaryP}<dl aria-hidden="true">\n${divs}\n</dl></section>`;
 }

package/src/templates/steps.ts

@@ -1,7 +1,7 @@
 import { esc, BREAKOUT } from './helpers.ts';
 
-// Selector matches `<section>` containing `<ol>` — that's the shape of `steps()` below.
-const R = 'main > section:has(> ol)';
+// Identified by schema.org HowTo.
+const R = 'main > section[itemtype$="HowTo"]';
 
 export const css = `${R} {
   ${BREAKOUT} background: var(--surface); padding-block: var(--g5);
@@ -27,6 +27,6 @@ ${R} > ol > li span { font-size: .8rem; line-height: 1.5; color: var(--fg-faint)
 @media (max-width: 640px) { ${R} > ol { grid-template-columns: 1fr; } }`;
 
 export function steps(title: string, items: { title: string; description: string }[]): string {
-  const lis = items.map(i => `<li><strong>${esc(i.title)}</strong><span>${esc(i.description)}</span></li>`).join('\n');
-  return `<section>\n<h2>${esc(title)}</h2>\n<ol>\n${lis}\n</ol>\n</section>`;
+  const lis = items.map(i => `<li itemprop="step" itemscope itemtype="https://schema.org/HowToStep"><strong itemprop="name">${esc(i.title)}</strong><span itemprop="text">${esc(i.description)}</span></li>`).join('\n');
+  return `<section itemscope itemtype="https://schema.org/HowTo">\n<h2 itemprop="name">${esc(title)}</h2>\n<ol>\n${lis}\n</ol>\n</section>`;
 }