@hagicode/hagilight-starlight 0.3.2-dev.55.1.1e29eba → 0.3.2-dev.58.1.bee3693

package/not-found.mjs

@@ -1,33 +0,0 @@
-const homeLabels = {
-  de: 'Zur Startseite',
-  en: 'Back to home',
-  es: 'Volver al inicio',
-  fr: 'Retour à l’accueil',
-  ja: 'ホームに戻る',
-  ko: '홈으로 돌아가기',
-  pt: 'Voltar ao início',
-  ru: 'На главную',
-  'zh-cn': '返回首页',
-  'zh-hant': '返回首頁',
-};
-
-export function isNotFoundEntry(entryId) {
-  return entryId === '404' || entryId.endsWith('/404');
-}
-
-export function getNotFoundHomeHref({ basePath = '/', locale, trailingSlash = 'ignore' }) {
-  const base = basePath.replace(/\/+$/u, '');
-  const localePath = locale && locale !== 'root' ? `/${locale}` : '';
-  const path = `${base}${localePath}` || '/';
-
-  if (trailingSlash === 'never') {
-    return path.replace(/\/+$/u, '') || '/';
-  }
-
-  return `${path.replace(/\/+$/u, '')}/`;
-}
-
-export function getNotFoundHomeLabel(lang) {
-  const language = lang?.replaceAll('_', '-').toLowerCase() ?? 'en';
-  return homeLabels[language] ?? homeLabels[language.split('-')[0]] ?? homeLabels.en;
-}

package/rss-renderer.mjs

@@ -1,31 +0,0 @@
-import { generateRssFeed as generateCoreRssFeed } from '@hagicode/hagilight/rss';
-import { selectRssEntries } from './rss-utils.mjs';
-
-export function generateRssFeed({ site, baseUrl, filename, locales, options, entries }) {
-  if (!site) throw new Error('Hagilight RSS requires the Astro site option.');
-  const locale = locales.find((item) => item.filename === filename);
-  if (!locale && filename !== 'en') {
-    throw new Error(`Hagilight RSS has no configured locale for "${filename}".`);
-  }
-
-  const items = selectRssEntries(entries, { filename, locales, options }).map(({ id, data }) => {
-    const slug = id.replace(/(?:^|\/)index$/u, '');
-    return {
-      title: data.title,
-      description: data.description,
-      ...(data.lastUpdated instanceof Date && !Number.isNaN(data.lastUpdated.getTime())
-        ? { date: data.lastUpdated }
-        : {}),
-      link: slug ? `${slug}/` : '/',
-    };
-  });
-
-  return generateCoreRssFeed({
-    site,
-    baseUrl,
-    language: locale?.lang ?? 'en',
-    title: 'Documentation',
-    description: 'Recently updated documentation pages',
-    items,
-  });
-}

package/rss-schema.d.ts

@@ -1,7 +0,0 @@
-import type { ZodBoolean, ZodObject, ZodOptional } from "astro/zod";
-
-export const rssSchema: ZodObject<{
-  rss: ZodOptional<ZodBoolean>;
-}>;
-
-export { rssSchema as default };

package/rss-schema.mjs

@@ -1,8 +0,0 @@
-import { z } from 'astro/zod';
-
-const rssSchema = z.object({
-  rss: z.boolean().optional(),
-});
-
-export { rssSchema };
-export default rssSchema;

package/rss-utils.mjs

@@ -1,62 +0,0 @@
-export { resolveRssLocales } from '@hagicode/hagilight/rss-locales';
-
-export function resolveRssOptions(options = {}) {
-  if (!options || typeof options !== 'object' || Array.isArray(options)) {
-    throw new TypeError('Hagilight rss options must be an object.');
-  }
-  for (const key of ['includeDocs', 'includeBlog']) {
-    if (options[key] !== undefined && typeof options[key] !== 'boolean') {
-      throw new TypeError(`Hagilight rss ${key} option must be a boolean.`);
-    }
-  }
-  return {
-    includeDocs: options.includeDocs ?? true,
-    includeBlog: options.includeBlog ?? true,
-  };
-}
-
-function getLocaleForEntry(id, locales) {
-  const localized = locales
-    .filter(({ route }) => route !== 'root')
-    .sort((a, b) => b.route.length - a.route.length)
-    .find(({ route }) => id === route || id.startsWith(`${route}/`));
-  if (localized) return { locale: localized, relativeId: id.slice(localized.route.length).replace(/^\/+/, '') };
-
-  const root = locales.find(({ route }) => route === 'root');
-  if (root) return { locale: root, relativeId: id };
-  return undefined;
-}
-
-export function isBlogEntry(id) {
-  const segments = id.split('/').filter(Boolean);
-  if (segments.at(-1) === 'index') segments.pop();
-  return segments[0] === 'blog' && segments.length > 1;
-}
-
-export function selectRssEntries(entries, { filename, locales, options }) {
-  const locale = locales.find((item) => item.filename === filename);
-  if (!locale) {
-    if (filename === 'en') return [];
-    throw new Error(`Hagilight RSS has no configured locale for "${filename}".`);
-  }
-
-  return entries
-    .filter(({ id, data }) => {
-      if (data.rss !== undefined && typeof data.rss !== 'boolean') {
-        throw new TypeError(`Hagilight RSS frontmatter field "rss" for "${id}" must be a boolean.`);
-      }
-      if (data.draft || data.rss === false) return false;
-
-      const entryLocale = getLocaleForEntry(id, locales);
-      if (entryLocale?.locale.filename !== filename) return false;
-      const isBlog = isBlogEntry(entryLocale.relativeId);
-      return isBlog ? options.includeBlog : options.includeDocs;
-    })
-    .sort((a, b) => {
-      const aDate = a.data.lastUpdated instanceof Date ? a.data.lastUpdated.getTime() : undefined;
-      const bDate = b.data.lastUpdated instanceof Date ? b.data.lastUpdated.getTime() : undefined;
-      if (aDate === undefined || Number.isNaN(aDate)) return bDate === undefined || Number.isNaN(bDate) ? 0 : 1;
-      if (bDate === undefined || Number.isNaN(bDate)) return -1;
-      return bDate - aDate;
-    });
-}

package/seo-schema.d.ts

@@ -1,5 +0,0 @@
-export {
-  seoSchema,
-  seoSchema as seoFrontmatterSchema,
-  seoSchema as default,
-} from "@hagicode/hagilight/seo-schema";

package/seo-schema.mjs

@@ -1,5 +0,0 @@
-export {
-  seoSchema,
-  seoSchema as seoFrontmatterSchema,
-  seoSchema as default,
-} from '@hagicode/hagilight/seo-schema';

package/seo-utils.mjs

@@ -1,266 +0,0 @@
-import { isBlogEntry } from './rss-utils.mjs';
-import {
-  buildArticleStructuredData,
-  buildBreadcrumbStructuredData,
-  buildOrganizationStructuredData,
-} from '@hagicode/hagilight/seo-utils';
-
-export {
-  composeSeoHead,
-  extractSeoDescription,
-  isValidSeoImageReference,
-  resolveSeoImageUrl,
-  resolveSeoMetadata,
-  serializeJsonLd,
-} from '@hagicode/hagilight/seo-utils';
-
-const normalizeSlug = (slug) => slug
-  .replace(/^\/+|\/+$/gu, '')
-  .replace(/(?:^|\/)index$/u, '');
-const publishedLookupCache = new WeakMap();
-
-export function resolveSeoLocales(locales) {
-  const entries = locales === undefined
-    ? [['root', { lang: 'en' }]]
-    : Object.entries(locales);
-  const usedLanguages = new Map();
-  const resolved = entries.map(([route, config]) => {
-    const lang = typeof config === 'string'
-      ? config
-      : config?.lang ?? (route === 'root' ? undefined : route);
-    if (typeof lang !== 'string' || !lang.trim()) {
-      throw new TypeError(`Hagilight SEO locale "${route}" must have a language tag.`);
-    }
-
-    let normalizedLang;
-    try {
-      [normalizedLang] = Intl.getCanonicalLocales(lang);
-    } catch {
-      throw new TypeError(`Hagilight SEO locale "${route}" has an invalid language tag "${lang}".`);
-    }
-
-    const collisionKey = normalizedLang.toLowerCase();
-    const existingRoute = usedLanguages.get(collisionKey);
-    if (existingRoute) {
-      throw new Error(
-        `Hagilight SEO locales "${existingRoute}" and "${route}" use the same language tag "${normalizedLang}".`,
-      );
-    }
-    usedLanguages.set(collisionKey, route);
-    return { route, lang: normalizedLang };
-  });
-
-  if (resolved.length === 0) {
-    throw new Error('Hagilight SEO requires at least one configured Starlight locale.');
-  }
-  return resolved;
-}
-
-export function resolveSeoPage(entryId, locales) {
-  const id = normalizeSlug(entryId ?? '');
-  const localizedRoutes = locales
-    .filter(({ route }) => route !== 'root')
-    .sort((left, right) => right.route.length - left.route.length);
-  const localized = localizedRoutes.find(({ route }) => id === route || id.startsWith(`${route}/`));
-  if (localized) {
-    return {
-      route: localized.route,
-      slug: normalizeSlug(id.slice(localized.route.length)),
-    };
-  }
-  return { route: 'root', slug: id };
-}
-
-export function createPublishedDocsLookup(entries, locales) {
-  const localeKey = JSON.stringify(locales);
-  let lookups = publishedLookupCache.get(entries);
-  if (lookups?.has(localeKey)) return lookups.get(localeKey);
-
-  const pages = new Map();
-  for (const entry of entries) {
-    if (!entry || entry.data?.draft === true) continue;
-    const page = resolveSeoPage(entry.id, locales);
-    pages.set(`${page.route}\u0000${page.slug}`, entry);
-  }
-  const lookup = {
-    get(route, slug) {
-      return pages.get(`${route}\u0000${normalizeSlug(slug)}`);
-    },
-    has(route, slug) {
-      return pages.has(`${route}\u0000${normalizeSlug(slug)}`);
-    },
-  };
-  if (!lookups) {
-    lookups = new Map();
-    publishedLookupCache.set(entries, lookups);
-  }
-  lookups.set(localeKey, lookup);
-  return lookup;
-}
-
-function parseCandidatePage(href, { locales, basePath }) {
-  let pathname;
-  try {
-    pathname = new URL(href).pathname;
-  } catch {
-    return undefined;
-  }
-
-  const base = `/${(basePath ?? '/').replace(/^\/+|\/+$/gu, '')}`;
-  if (base !== '/' && pathname !== base && !pathname.startsWith(`${base}/`)) return undefined;
-  if (base !== '/') pathname = pathname.slice(base.length) || '/';
-
-  const segments = pathname.split('/').filter(Boolean);
-  if (segments.at(-1) === 'index.html') segments.pop();
-  else if (segments.at(-1)?.endsWith('.html')) {
-    segments[segments.length - 1] = segments.at(-1).slice(0, -5);
-  }
-
-  const routes = locales
-    .filter(({ route }) => route !== 'root')
-    .sort((left, right) => right.route.length - left.route.length);
-  let route = 'root';
-  if (segments[0]?.endsWith('.html')) {
-    const first = segments[0].slice(0, -5);
-    const matched = routes.find((locale) => locale.route === first);
-    if (matched) {
-      route = matched.route;
-      segments.shift();
-    }
-  } else {
-    const matched = routes.find(({ route: localeRoute }) => segments[0] === localeRoute);
-    if (matched) {
-      route = matched.route;
-      segments.shift();
-    }
-  }
-
-  return { route, slug: normalizeSlug(segments.join('/')) };
-}
-
-function isAlternateLink(entry) {
-  return entry?.tag === 'link'
-    && entry.attrs?.rel === 'alternate'
-    && typeof entry.attrs.hreflang === 'string'
-    && typeof entry.attrs.href === 'string';
-}
-
-function explicitAlternateKeys(heads) {
-  return new Set(heads.flatMap((head) => (Array.isArray(head) ? head : [])
-    .filter(isAlternateLink)
-    .map(({ attrs }) => `${attrs.hreflang.toLowerCase()}\u0000${attrs.href}`)));
-}
-
-export function filterPublishedLocaleAlternates(head, {
-  entryId,
-  locales,
-  lookup,
-  basePath = '/',
-  explicitHead = [],
-}) {
-  const page = resolveSeoPage(entryId, locales);
-  const explicit = explicitAlternateKeys(explicitHead);
-  const routesByLanguage = new Map(locales.map(({ route, lang }) => [lang.toLowerCase(), route]));
-
-  return head.filter((entry) => {
-    if (!isAlternateLink(entry)) return true;
-    const { href, hreflang } = entry.attrs;
-    if (explicit.has(`${hreflang.toLowerCase()}\u0000${href}`)) return true;
-
-    const candidate = parseCandidatePage(href, { locales, basePath });
-    if (!candidate || candidate.slug !== page.slug) return true;
-    if (hreflang.toLowerCase() === 'x-default') {
-      return lookup.has(candidate.route, candidate.slug);
-    }
-
-    const configuredRoute = routesByLanguage.get(hreflang.toLowerCase());
-    if (!configuredRoute || configuredRoute !== candidate.route) return true;
-    return lookup.has(configuredRoute, candidate.slug);
-  });
-}
-
-function normalizeBasePath(basePath = '/') {
-  const normalized = `/${basePath.replace(/^\/+|\/+$/gu, '')}`;
-  return normalized === '/' ? '' : normalized;
-}
-
-export function buildDocsPageUrl(route, slug, {
-  site,
-  basePath = '/',
-  format = 'directory',
-  trailingSlash = 'always',
-}) {
-  const id = [route === 'root' ? '' : route, normalizeSlug(slug)].filter(Boolean).join('/');
-  let pagePath;
-  if (format === 'file') {
-    pagePath = `/${id ? `${id}.html` : 'index.html'}`;
-  } else if (!id) {
-    pagePath = '/';
-  } else {
-    pagePath = `/${id}${trailingSlash === 'never' ? '' : '/'}`;
-  }
-
-  const base = normalizeBasePath(basePath);
-  return new URL(`${base}${pagePath}`, site).href;
-}
-
-export function buildStructuredData({
-  entry,
-  entryId,
-  canonicalUrl,
-  site,
-  siteTitle,
-  pageSeo = {},
-  organization,
-  locales,
-  defaultLocale = 'root',
-  lookup,
-  basePath = '/',
-  format = 'directory',
-  trailingSlash = 'always',
-}) {
-  if (!entry || entry.data?.draft === true || !canonicalUrl) return [];
-  const page = resolveSeoPage(entryId, locales);
-  if (!lookup.has(page.route, page.slug)) return [];
-
-  const data = entry.data ?? {};
-  const structuredData = [];
-  if (isBlogEntry(page.slug)) {
-    structuredData.push(buildArticleStructuredData({
-      url: canonicalUrl,
-      title: data.title,
-      description: pageSeo.description ?? data.description,
-      author: pageSeo.author ?? data.author,
-      publishedDate: pageSeo.publishedDate ?? data.publishedDate,
-      modifiedDate: data.lastUpdated,
-    }));
-  }
-
-  const slugParts = page.slug.split('/').filter(Boolean);
-  const crumbs = [];
-  for (let index = 0; index <= slugParts.length; index += 1) {
-    const ancestorSlug = slugParts.slice(0, index).join('/');
-    const ancestor = lookup.get(page.route, ancestorSlug);
-    if (!ancestor) continue;
-    const url = ancestorSlug === page.slug
-      ? canonicalUrl
-      : buildDocsPageUrl(page.route, ancestorSlug, {
-        site,
-        basePath,
-        format,
-        trailingSlash,
-      });
-    crumbs.push({ name: ancestor.data.title, url });
-  }
-  if (crumbs.length > 0) {
-    structuredData.push(buildBreadcrumbStructuredData(crumbs));
-  }
-
-  if (organization && page.route === defaultLocale && page.slug === '') {
-    structuredData.push(buildOrganizationStructuredData({
-      ...organization,
-      alternateName: siteTitle,
-    }));
-  }
-  return structuredData;
-}