npm - @cloudhal/cli - Versions diffs - 0.0.0-stage → 0.1.1 - Mend

@cloudhal/cli 0.0.0-stage → 0.1.1

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.

Files changed (796) hide show

package/dist/assets/starters/blog/src/components/Article.astro ADDED Viewed

@@ -0,0 +1,105 @@
+---
+/**
+ * An article (RFC-0018 §3, the article view): kicker (the primary category), title, dek, byline
+ * (author, published, updated, reading time), cover, an "On this page" table of contents for
+ * longer pieces (headings carry ids; no JavaScript), then the body with the theme's own blocks and
+ * the corrections, newest first (RFC-0019 §2; the latest one is the "Updated" date).
+ */
+import { Body } from "@cloudhal/astro-renderer/components";
+import { articleCorrections, articleOutline } from "@cloudhal/astro-renderer/kit";
+import { entryArticleParts } from "@cloudhal/astro-renderer/markdown";
+import type { MediaContext } from "@cloudhal/astro-renderer/media";
+import type { EntryTaxonomy } from "@cloudhal/astro-renderer/taxonomy";
+import type { ContentEntry } from "@cloudhal/core-contracts";
+import type { BlockType } from "@cloudhal/core-ts/blocks";
+import type { ThemeStrings } from "../theme.ts";
+interface Props {
+  entry: ContentEntry;
+  terms: EntryTaxonomy;
+  locale: string;
+  t: ThemeStrings;
+  media?: MediaContext;
+  blocks?: Record<string, unknown>;
+  blockTypes?: readonly BlockType[];
+}
+const { entry, terms, locale, t, media, blocks, blockTypes } = Astro.props;
+const parts = entryArticleParts(entry, locale, media);
+const outline = articleOutline(entry);
+const date = (iso: string) =>
+  new Date(iso).toLocaleDateString(locale, { year: "numeric", month: "long", day: "numeric" });
+const published = entry.publishedAt ?? undefined;
+const corrections = articleCorrections(entry);
+const newest = corrections.items[0];
+// "Updated": the latest correction; without one, only a real later edit, not the publish itself.
+const updated =
+  corrections.latest ??
+  (published && Date.parse(entry.updatedAt) - Date.parse(published) > 24 * 3600 * 1000
+    ? entry.updatedAt
+    : undefined);
+// RFC-0019 §1: the byline's authors link to their pages; without one, a person who wrote it.
+const authors = terms.authors;
+const author =
+  authors.length === 0 && entry.author.kind === "human" ? entry.author.name : undefined;
+---
+<article class="ch-article" data-entry-id={entry.id}>
+  <header class="ch-article-head">
+    {terms.section && (
+      terms.section.href ? (
+        <a class="ch-kicker" href={terms.section.href}>{terms.section.name}</a>
+      ) : (
+        <span class="ch-kicker">{terms.section.name}</span>
+      )
+    )}
+    <h1>{entry.title}</h1>
+    {entry.summary && <p class="ch-dek">{entry.summary}</p>}
+    <p class="ch-byline">
+      {authors.length > 0 && (
+        <span class="ch-byline__author">
+          {t.byPrefix}
+          {authors.map((a, i) => (
+            <Fragment>
+              {i > 0 && (i === authors.length - 1 ? t.and : ", ")}
+              {a.href ? <a href={a.href} rel="author">{a.name}</a> : a.name}
+            </Fragment>
+          ))}
+        </span>
+      )}
+      {author && <span class="ch-byline__author">{t.by(author)}</span>}
+      {published && <time datetime={published}>{date(published)}</time>}
+      {updated && <span>{t.updated(date(updated))}</span>}
+      {newest && <a href="#ch-corrections">{t.appended(t.correctionKind[newest.kind])}</a>}
+      <span>{t.minRead(outline.readingMinutes)}</span>
+    </p>
+  </header>
+  <Fragment set:html={parts.cover} />
+  {outline.toc.length >= 3 && (
+    <details class="ch-toc" open>
+      <summary>{t.onThisPage}</summary>
+      <ol>
+        {outline.toc.map((item) => (
+          <li data-depth={item.depth}><a href={`#${item.id}`}>{item.text}</a></li>
+        ))}
+      </ol>
+    </details>
+  )}
+  <div class="ch-richtext">
+    <Body body={parts.body} media={parts.media} blocks={blocks} blockTypes={blockTypes} />
+  </div>
+  {newest && (
+    <section id="ch-corrections" class="ch-corrections" aria-labelledby="ch-corrections-title">
+      <h2 id="ch-corrections-title">{t.corrections}</h2>
+      <ol>
+        {corrections.items.map((c) => (
+          <li data-kind={c.kind}>
+            <p class="ch-correction__meta">
+              <strong>{t.correctionKind[c.kind]}</strong>
+              <time datetime={c.at}>{date(c.at)}</time>
+            </p>
+            <p class="ch-correction__note" set:html={c.html} />
+          </li>
+        ))}
+      </ol>
+    </section>
+  )}
+</article>

package/dist/assets/starters/blog/src/components/Breadcrumbs.astro ADDED Viewed

@@ -0,0 +1,25 @@
+---
+/** `Home › … › current`: the visible twin of the `BreadcrumbList` JSON-LD in `<head>`. */
+interface Props {
+  label: string;
+  items: Array<{ name: string; href?: string | undefined }>;
+}
+const { label, items } = Astro.props;
+---
+{items.length > 1 && (
+  <nav aria-label={label} class="ch-breadcrumbs">
+    <ol>
+      {items.map((item, i) => (
+        <li>
+          {i === items.length - 1 ? (
+            <span aria-current="page">{item.name}</span>
+          ) : item.href ? (
+            <a href={item.href}>{item.name}</a>
+          ) : (
+            <span>{item.name}</span>
+          )}
+        </li>
+      ))}
+    </ol>
+  </nav>
+)}

package/dist/assets/starters/blog/src/components/EntryList.astro ADDED Viewed

@@ -0,0 +1,54 @@
+---
+/**
+ * A list of articles as cards: cover thumbnail (when the article has one), title, summary,
+ * publication date and reading time.
+ */
+import { readingMinutes } from "@cloudhal/astro-renderer/kit";
+import { renderBody } from "@cloudhal/astro-renderer/markdown";
+import { imageAttributes, type MediaContext } from "@cloudhal/astro-renderer/media";
+import { entryPath } from "@cloudhal/astro-renderer/routing";
+import type { ContentEntry } from "@cloudhal/core-contracts";
+import { strings } from "../theme.ts";
+interface Props {
+  entries: ContentEntry[];
+  locale: string;
+  media?: MediaContext | undefined;
+}
+const { entries, locale, media } = Astro.props;
+const t = strings(locale);
+const date = (iso: string) =>
+  new Date(iso).toLocaleDateString(locale, { year: "numeric", month: "long", day: "numeric" });
+const cover = (e: ContentEntry) => {
+  const asset = e.coverImage?.assetId ? media?.assets?.get(e.coverImage.assetId) : undefined;
+  if (!asset || !e.coverImage) return undefined;
+  return imageAttributes(asset, e.coverImage, {
+    locale,
+    defaultLocale: media?.defaultLocale ?? locale,
+    transform: media?.transform ?? "none",
+    ...(media?.budget ? { budget: media.budget } : {}),
+    sizes: "12rem",
+    ...(media?.preview ? { preview: true } : {}),
+  });
+};
+---
+<ul class="ch-entrylist">
+  {entries.map((e) => {
+    const img = cover(e);
+    return (
+      <li class="ch-card-entry" data-has-cover={img ? "yes" : undefined}>
+        {img && (
+          <img class="ch-card-entry__cover" src={img.src} srcset={img.srcset} sizes={img.sizes} alt="" width={img.width || undefined} height={img.height || undefined} loading="lazy" decoding="async" />
+        )}
+        <div class="ch-card-entry__body">
+          <a href={entryPath(e)}>{e.title}</a>
+          {e.summary && <p>{e.summary}</p>}
+          <span class="ch-card-entry__meta">
+            {e.publishedAt && <time datetime={e.publishedAt}>{date(e.publishedAt)}</time>}
+            <span>{t.minRead(readingMinutes(renderBody(e.body)))}</span>
+          </span>
+        </div>
+      </li>
+    );
+  })}
+</ul>

package/dist/assets/starters/blog/src/components/LatestPosts.astro ADDED Viewed

@@ -0,0 +1,30 @@
+---
+/**
+ * The theme's content list section (`components.contentList` in theme.ts): the section's entries
+ * sorted and trimmed as it asks, drawn as cards.
+ */
+import type { MediaContext } from "@cloudhal/astro-renderer/media";
+import type { ContentEntry, ContentListSection } from "@cloudhal/core-contracts";
+import EntryList from "./EntryList.astro";
+interface Props {
+  section: ContentListSection;
+  entries: ContentEntry[];
+  media?: MediaContext;
+}
+const { section, entries, media } = Astro.props;
+const at = (e: ContentEntry) => e.publishedAt ?? e.createdAt;
+const sorted = [...entries]
+  .sort((a, b) =>
+    section.sort === "title"
+      ? a.title.localeCompare(b.title)
+      : section.sort === "oldest"
+        ? at(a).localeCompare(at(b))
+        : at(b).localeCompare(at(a)),
+  )
+  .slice(0, section.limit);
+const locale = media?.locale ?? sorted[0]?.locale ?? "en";
+---
+<section class="ch-contentlist" data-section-id={section.id} data-kind="contentList" data-collection={section.collection}>
+  <EntryList entries={sorted} locale={locale} media={media} />
+</section>

package/dist/assets/starters/blog/src/components/MenuPanel.astro ADDED Viewed

@@ -0,0 +1,46 @@
+---
+/**
+ * The phone menu's content (RFC-0025 §2), in the header's disclosure, its drawer or full-screen
+ * dialog, and the `/menu` page: the header's menu with its groups as disclosures, the second menu,
+ * and the search form where the deployment answers searches.
+ */
+import type { ActiveNavItem } from "@cloudhal/astro-renderer/navigation";
+import NavLink from "./NavLink.astro";
+import NavMenu from "./NavMenu.astro";
+interface Props {
+  nav: ActiveNavItem[];
+  utility: ActiveNavItem[];
+  search?: { label: string; placeholder: string; button: string; query?: string } | undefined;
+  words: { main: string; secondary: string };
+  /** Keeps ids unique when the panel shows twice on a page. */
+  idSuffix: string;
+  /** RFC-0026 26c: the site's icon weight. */
+  iconWeight?: string | undefined;
+}
+const { nav, utility, search, words, idSuffix, iconWeight } = Astro.props;
+const link = { on: "ch-menu__current", off: "" };
+---
+<div class="ch-menu__panel">
+  {search && (
+    <form class="ch-menu__search" method="get" action="/search" role="search">
+      <label for={`ch-q-${idSuffix}`} class="sr-only">{search.label}</label>
+      <input id={`ch-q-${idSuffix}`} type="search" name="q" value={search.query ?? ""} maxlength="200" placeholder={search.placeholder} />
+      <button type="submit" class="sr-only">{search.button}</button>
+    </form>
+  )}
+  {nav.length > 0 && (
+    <nav aria-label={words.main} class="ch-menu__nav">
+      <ul>
+        {nav.map((item) => <li>{item.children.length > 0 ? <NavMenu item={item} {...link} iconWeight={iconWeight} /> : <NavLink item={item} {...link} />}</li>)}
+      </ul>
+    </nav>
+  )}
+  {utility.length > 0 && (
+    <nav aria-label={words.secondary} class="ch-menu__nav ch-menu__nav--small">
+      <ul>
+        {utility.map((item) => <li><NavLink item={item} {...link} /></li>)}
+      </ul>
+    </nav>
+  )}
+</div>

package/dist/assets/starters/blog/src/components/NavLink.astro ADDED Viewed

@@ -0,0 +1,27 @@
+---
+/**
+ * One navigation link (RFC-0003 §7.3). `aria-current` is `page` on the exact match and `true` on a
+ * prefix or context match. External links never pass referrer or opener; only `newTab` opens one.
+ * A group shown without its children (past the theme's depth) is plain text.
+ */
+import type { ActiveNavItem } from "@cloudhal/astro-renderer/navigation";
+interface Props {
+  item: ActiveNavItem;
+  /** Classes for the current (or in-trail) link and for the others. */
+  on: string;
+  off: string;
+}
+const { item, on, off } = Astro.props;
+---
+{item.href === undefined ? (
+  <span>{item.label}</span>
+) : (
+  <a
+    href={item.href}
+    aria-current={item.current}
+    class={(item.current || item.inTrail ? on : off) || undefined}
+    rel={item.external ? "noopener noreferrer" : undefined}
+    target={item.newTab ? "_blank" : undefined}
+  >{item.label}</a>
+)}

package/dist/assets/starters/blog/src/components/NavMenu.astro ADDED Viewed

@@ -0,0 +1,95 @@
+---
+/**
+ * An item with children as a disclosure (`<details>`, no JavaScript): the item's link (or a group's
+ * label) as the summary, its children below. Renders up to three levels; deeper items are left out
+ * (the menu's `maxDepth` is data, the theme decides what it shows). The active trail starts open.
+ * In the header's bar (`popover`, RFC-0025 §2) a group opens as a popover under its button instead,
+ * so it never pushes the bar: the browser opens and closes it (Escape, a click elsewhere) with no
+ * script, and a disclosure button never becomes `role=menu`. A top-level item with `display: mega`
+ * (RFC-0025 25d) opens one wide panel under the header instead: each child group is a column of its
+ * links (a child with no children of its own joins a first column of links).
+ */
+import type { ActiveNavItem } from "@cloudhal/astro-renderer/navigation";
+import { renderIcon } from "@cloudhal/core-ts/icons";
+import { iconSet } from "../icons.ts";
+import NavLink from "./NavLink.astro";
+interface Props {
+  item: ActiveNavItem;
+  on: string;
+  off: string;
+  /** 1 for a top-level item. */
+  level?: number;
+  /** A popover under a button (the header's bar), with this id. */
+  popover?: string | undefined;
+  /** RFC-0026 26c: the site's icon weight. */
+  iconWeight?: string | undefined;
+}
+const { item, on, off, level = 1, popover, iconWeight } = Astro.props;
+const icon = (name: string, className?: string) =>
+  renderIcon(name, { className, weight: iconWeight, set: iconSet });
+const MAX_LEVEL = 3;
+const mega = popover !== undefined && level === 1 && item.display === "mega";
+const columns = mega ? item.children.filter((c) => c.children.length > 0) : [];
+const loose = mega ? item.children.filter((c) => c.children.length === 0) : [];
+---
+{popover ? (
+  <div class="ch-nav-menu" data-popover="">
+    {item.href && <NavLink item={item} on={on} off={off} />}
+    <button
+      type="button"
+      class:list={["ch-nav-menu__btn", item.current || item.inTrail ? on : off]}
+      popovertarget={popover}
+      aria-label={item.href ? item.label : undefined}
+    >{!item.href && item.label}<Fragment set:html={icon("chevron-down")} /></button>
+    <div popover="auto" id={popover} class:list={["ch-nav-menu__pop", mega && "ch-nav-menu__pop--mega"]}>
+      {mega ? (
+        <div class="ch-mega">
+          {loose.length > 0 && (
+            <ul class="ch-mega__col">
+              {loose.map((c) => <li><NavLink item={c} on={on} off={off} /></li>)}
+            </ul>
+          )}
+          {columns.map((col) => (
+            <div class="ch-mega__col">
+              <p class="ch-mega__heading">{col.href ? <NavLink item={col} on={on} off={off} /> : col.label}</p>
+              <ul>
+                {col.children.map((c) => <li><NavLink item={c} on={on} off={off} /></li>)}
+              </ul>
+            </div>
+          ))}
+        </div>
+      ) : (
+      <ul>
+        {item.children.map((child) => (
+          <li>
+            {child.children.length > 0 && level + 1 < MAX_LEVEL ? (
+              <Astro.self item={child} on={on} off={off} level={level + 1} iconWeight={iconWeight} />
+            ) : (
+              <NavLink item={child} on={on} off={off} />
+            )}
+          </li>
+        ))}
+      </ul>
+      )}
+    </div>
+  </div>
+) : (
+<details class="ch-nav-menu" open={item.inTrail && level > 1 ? true : undefined}>
+  <summary class={(item.current || item.inTrail ? on : off) || undefined}>
+    {item.href ? <NavLink item={item} on={on} off={off} /> : <span>{item.label}</span>}
+    <Fragment set:html={icon("chevron-down", "ch-nav-menu__caret")} />
+  </summary>
+  <ul>
+    {item.children.map((child) => (
+      <li>
+        {child.children.length > 0 && level + 1 < MAX_LEVEL ? (
+          <Astro.self item={child} on={on} off={off} level={level + 1} iconWeight={iconWeight} />
+        ) : (
+          <NavLink item={child} on={on} off={off} />
+        )}
+      </li>
+    ))}
+  </ul>
+</details>
+)}

package/dist/assets/starters/blog/src/components/NotFound.astro ADDED Viewed

@@ -0,0 +1,27 @@
+---
+/**
+ * The built-in not-found page (404), in the reader's language: drawn when the site has no page at
+ * `/404` in that language (`@cloudhal/astro-renderer/not-found`). A link home, and the search form
+ * where the deployment answers searches; the middleware keeps both in the page's locale.
+ */
+import type { ThemeStrings } from "../theme.ts";
+interface Props {
+  t: ThemeStrings;
+  /** Show the search form (the deployment answers `/search`). */
+  search: boolean;
+}
+const { t, search } = Astro.props;
+---
+<section class="ch-not-found ch-search" aria-labelledby="ch-not-found-title">
+  <h1 id="ch-not-found-title">{t.notFoundTitle}</h1>
+  <p class="ch-not-found-text">{t.notFoundText}</p>
+  {search && (
+    <form class="ch-search-form" method="get" action="/search" role="search">
+      <label for="ch-not-found-q" class="ch-not-found-prompt">{t.notFoundSearch}</label>
+      <input id="ch-not-found-q" type="search" name="q" maxlength="200" placeholder={t.searchPlaceholder} autocomplete="off" />
+      <button type="submit">{t.search}</button>
+    </form>
+  )}
+  <p class="ch-not-found-home"><a href="/">{t.notFoundHome}</a></p>
+</section>

package/dist/assets/starters/blog/src/components/PostTerms.astro ADDED Viewed

@@ -0,0 +1,33 @@
+---
+/** An article's public categories and tags as chips linking to their archives. */
+import type { EntryTaxonomy } from "@cloudhal/astro-renderer/taxonomy";
+interface Props {
+  taxonomy: EntryTaxonomy;
+  locale: string;
+}
+const { taxonomy, locale } = Astro.props;
+// Authors are the byline (RFC-0019 §1), not chips.
+const groups = taxonomy.groups.filter((g) => g.taxonomy.key !== "author");
+---
+{groups.length > 0 && (
+  <div class="ch-terms">
+    {groups.map((group) => (
+      <ul
+        class="ch-terms__group"
+        data-taxonomy={group.taxonomy.key}
+        aria-label={group.taxonomy.labels[locale]?.plural ?? group.taxonomy.key}
+      >
+        {group.terms.map((term) => (
+          <li>
+            {term.href ? (
+              <a class="ch-chip" href={term.href} rel="tag">{term.name}</a>
+            ) : (
+              <span class="ch-chip">{term.name}</span>
+            )}
+          </li>
+        ))}
+      </ul>
+    ))}
+  </div>
+)}

package/dist/assets/starters/blog/src/components/RelatedPosts.astro ADDED Viewed

@@ -0,0 +1,20 @@
+---
+/** "Related posts" under an article (`relatedEntries`: shared primary category or tags). */
+import type { MediaContext } from "@cloudhal/astro-renderer/media";
+import type { ContentEntry } from "@cloudhal/core-contracts";
+import EntryList from "./EntryList.astro";
+interface Props {
+  title: string;
+  entries: ContentEntry[];
+  locale: string;
+  media?: MediaContext | undefined;
+}
+const { title, entries, locale, media } = Astro.props;
+---
+{entries.length > 0 && (
+  <aside class="ch-related" aria-labelledby="ch-related-title">
+    <h2 id="ch-related-title">{title}</h2>
+    <EntryList entries={entries} locale={locale} media={media} />
+  </aside>
+)}

package/dist/assets/starters/blog/src/components/Search.astro ADDED Viewed

@@ -0,0 +1,57 @@
+---
+/**
+ * The search page (RFC-0019 §3, RFC-0029 §2): an ordinary `<form method="get">` (no JavaScript),
+ * the results with their snippets (escaped text, matches in `<mark>`), and real links between
+ * result pages.
+ * Pages, topics and authors are found too; a topic or author shows its taxonomy ("Category").
+ * Rendered only by deployments that answer searches; the page is never cached and never indexed.
+ */
+import { type SearchView, searchPageHref, snippetHtml } from "@cloudhal/astro-renderer/search";
+import type { ThemeStrings } from "../theme.ts";
+interface Props {
+  search: SearchView;
+  locale: string;
+  t: ThemeStrings;
+}
+const { search, locale, t } = Astro.props;
+const date = (iso: string) =>
+  new Date(iso).toLocaleDateString(locale, { year: "numeric", month: "long", day: "numeric" });
+---
+<section class="ch-search" aria-labelledby="ch-search-title">
+  <h1 id="ch-search-title">{t.search}</h1>
+  <form class="ch-search-form" method="get" action="/search" role="search">
+    <label for="ch-search-q" class="sr-only">{t.searchLabel}</label>
+    <input id="ch-search-q" type="search" name="q" value={search.query} maxlength="200" placeholder={t.searchPlaceholder} autocomplete="off" />
+    <button type="submit">{t.search}</button>
+  </form>
+  {search.stale && <p class="ch-search-note" role="status">{t.searchUpdating}</p>}
+  {search.query && (
+    <p class="ch-search-summary" role="status">
+      {search.total > 0 ? t.searchResults(search.total, search.query) : t.searchNone(search.query)}
+    </p>
+  )}
+  {search.hits.length > 0 && (
+    <ol class="ch-search-results">
+      {search.hits.map((hit) => (
+        <li data-entry-id={hit.nodeId} data-kind={hit.kind ?? "article"}>
+          {hit.context && <p class="ch-search-context">{hit.context}</p>}
+          <h2><a href={hit.href}>{hit.title}</a></h2>
+          {hit.snippet && <p class="ch-search-snippet" set:html={snippetHtml(hit.snippet)} />}
+          {hit.publishedAt && <time datetime={hit.publishedAt}>{date(hit.publishedAt)}</time>}
+        </li>
+      ))}
+    </ol>
+  )}
+  {search.pages > 1 && (
+    <nav aria-label={t.pagination} class="ch-pagination">
+      {search.page > 1 ? (
+        <a href={searchPageHref(search.query, search.page - 1)} rel="prev">{t.previous}</a>
+      ) : <span />}
+      <span>{t.pageOf(search.page, search.pages)}</span>
+      {search.page < search.pages ? (
+        <a href={searchPageHref(search.query, search.page + 1)} rel="next">{t.next}</a>
+      ) : <span />}
+    </nav>
+  )}
+</section>

package/dist/assets/starters/blog/src/components/SearchDialog.astro ADDED Viewed

@@ -0,0 +1,46 @@
+---
+/**
+ * The search modal (RFC-0029 §6): markup and words only; `/_cloudhal/search.1.js` wires it. Without
+ * the script the dialog never opens and the header form goes to `/search`. Inside, a form still
+ * goes to `/search` on Enter when no result is chosen.
+ */
+import { SEARCH_JSON_PATH, SEARCH_PATH } from "@cloudhal/astro-renderer/search";
+import type { ThemeStrings } from "../theme.ts";
+interface Props {
+  label: string;
+  placeholder: string;
+  words: ThemeStrings["searchModal"];
+}
+const { label, placeholder, words } = Astro.props;
+const data = {
+  kinds: words.kinds,
+  all: words.all,
+  none: words.none,
+  recent: words.recent,
+  clear: words.clear,
+  limited: words.limited,
+  error: words.error,
+  updating: words.updating,
+  count: words.count,
+};
+---
+<dialog id="ch-search" class="ch-search-dialog" aria-label={label} data-ch-search data-endpoint={SEARCH_JSON_PATH} data-page={SEARCH_PATH} data-words={JSON.stringify(data)}>
+  <div class="ch-search-dialog__panel">
+    <form class="ch-search-dialog__bar" method="get" action={SEARCH_PATH} role="search">
+      <label for="ch-search-dialog-q" class="sr-only">{label}</label>
+      <input id="ch-search-dialog-q" type="search" name="q" maxlength="200" autocomplete="off" spellcheck="false" placeholder={placeholder} data-ch-search-input />
+      <button type="button" class="ch-search-dialog__close" data-ch-search-close>{words.close}</button>
+    </form>
+    <div class="ch-search-dialog__body">
+      <div id="ch-search-list" class="ch-search-dialog__list" role="listbox" aria-label={label} data-ch-search-list></div>
+      <p class="ch-search-dialog__note" data-ch-search-note hidden></p>
+    </div>
+    <p class="ch-search-dialog__keys" aria-hidden="true">
+      <span><kbd>↑</kbd><kbd>↓</kbd> {words.keys.move}</span>
+      <span><kbd>↵</kbd> {words.keys.open}</span>
+      <span><kbd>esc</kbd> {words.keys.close}</span>
+    </p>
+    <p class="sr-only" role="status" aria-live="polite" data-ch-search-status></p>
+  </div>
+</dialog>

package/dist/assets/starters/blog/src/components/blocks/Testimonial.astro ADDED Viewed

@@ -0,0 +1,18 @@
+---
+/**
+ * The `testimonial` block (src/blocks.ts), in sections and inside bodies. `contentHtml` is the
+ * quote, already rendered by Cloudhal's safe markdown renderer; props were checked first.
+ */
+interface Props {
+  props: { author?: string; role?: string };
+  contentHtml?: string;
+}
+const { props, contentHtml = "" } = Astro.props;
+---
+<figure class="testimonial">
+  <blockquote set:html={contentHtml} />
+  <figcaption>
+    <span class="testimonial__author">{props.author}</span>
+    {props.role && <span class="testimonial__role">{props.role}</span>}
+  </figcaption>
+</figure>

package/dist/assets/starters/blog/src/env.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+/// <reference types="astro/client" />
+declare module "virtual:cloudhal/config" {
+  const config: import("@cloudhal/astro-renderer").CloudhalRendererConfig;
+  export default config;
+}

package/dist/assets/starters/blog/src/fonts.ts ADDED Viewed

@@ -0,0 +1,15 @@
+/**
+ * The font files each pairing (RFC-0023 §2, `typePairing` in settings.ts) needs first: its latin
+ * subsets, preloaded by layouts/Base.astro so headings do not swap late. The latin-ext files
+ * (Turkish and other accented letters) load on demand through fonts.css's unicode ranges.
+ */
+export const PAIRING_PRELOADS: Readonly<Record<string, readonly string[]>> = {
+  editorial: ["/fonts/fraunces-latin-wght-normal.woff2", "/fonts/inter-latin-wght-normal.woff2"],
+  modern: ["/fonts/space-grotesk-latin-wght-normal.woff2", "/fonts/inter-latin-wght-normal.woff2"],
+  humanist: ["/fonts/source-sans-3-latin-wght-normal.woff2"],
+  technical: [
+    "/fonts/jetbrains-mono-latin-wght-normal.woff2",
+    "/fonts/inter-latin-wght-normal.woff2",
+  ],
+  classic: ["/fonts/source-serif-4-latin-wght-normal.woff2"],
+};

package/dist/assets/starters/blog/src/icons.ts ADDED Viewed

@@ -0,0 +1,12 @@
+/**
+ * The theme's own icon drawings (RFC-0026 26d): names of the curated set this theme draws itself.
+ * Empty: every icon is Phosphor's, in the site's weight. `defineIconSet` checks each drawing
+ * (shapes only, `currentColor`), so an icon can never carry markup, links or scripts into pages.
+ *
+ *   export const iconSet = defineIconSet({
+ *     star: { viewBox: "0 0 24 24", body: '<path d="M12 2l3 7h7l-6 4 2 7-6-4-6 4 2-7-6-4h7z"/>' },
+ *   });
+ */
+import { defineIconSet } from "@cloudhal/core-ts/icons";
+export const iconSet = defineIconSet({});