@rathnasgala2/template 3.0.0 → 3.0.1

package/README.md

@@ -486,14 +486,14 @@ brief sits on top of the page kinds above:
   collide).
 - **`robots.txt`, `llms.txt`, `llms-full.txt`** (`internal/robots.js`,
   `internal/llms.js`). `robots.txt` allows all crawlers and names the absolute
-  sitemap; `publication.crawlers.ai: "block"` (read defensively, absent means
-  allow) adds `Disallow: /` groups for the 15 known AI crawlers. It is always
-  written at the output root: **only a robots.txt at the host root is honoured
-  by crawlers**, so a site served from a path (for example a GitHub project
-  site) must have the same file at its host root. `llms.txt` follows llmstxt.org
-  (`# title`, `> description`, `## Articles`, `## Series`, `## Optional`);
-  `llms-full.txt` is every published article as plain text. Unlisted content is
-  excluded from both.
+  sitemap; `publication.crawlers.ai: "block"` (validated by the build-input
+  schema, absent means allow) adds `Disallow: /` groups for the 15 known AI
+  crawlers. It is always written at the output root: **only a robots.txt at the
+  host root is honoured by crawlers**, so a site served from a path (for example
+  a GitHub project site) must have the same file at its host root. `llms.txt`
+  follows llmstxt.org (`# title`, `> description`, `## Articles`, `## Series`,
+  `## Optional`); `llms-full.txt` is every published article as plain text.
+  Unlisted content is excluded from both.
 - **`404.html`**: the `error` page kind's pure `renderErrorPageBody`, now
   actually wired into `renderPublication` at the fixed `errorDocumentKey`
   (`internal/route.js#errorDocumentPath`) — `404.html` at the root, or
@@ -584,8 +584,8 @@ compatibility promise in this MVP.
 
 ## Consuming `@rathnasgala2/schemas`
 
-This repository consumes `@rathnasgala2/schemas@2.11.0` from the public npm
-registry, declared as `"@rathnasgala2/schemas": "2.11.0"` (exact pin, no range)
+This repository consumes `@rathnasgala2/schemas@3.0.0` from the public npm
+registry, declared as `"@rathnasgala2/schemas": "3.0.0"` (exact pin, no range)
 so `package-lock.json` records the resolved version and integrity hash. The
 LOCAL-1/LOCAL-39 local-tarball convention
 (`file:../../local-packages/rathnasgala2-schemas-*.tgz`) is retired for this

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala2/template",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Deterministic Eleventy-backed static publication renderer for Galascribe portable repositories.",
   "type": "module",
   "license": "Apache-2.0",
@@ -71,7 +71,7 @@
   "dependencies": {
     "@11ty/eleventy": "3.1.6",
     "@11ty/eleventy-plugin-syntaxhighlight": "5.0.2",
-    "@rathnasgala2/schemas": "2.11.0",
+    "@rathnasgala2/schemas": "3.0.0",
     "jpeg-js": "0.4.4",
     "markdown-it": "14.3.1",
     "sanitize-html": "2.17.7"

package/src/core/internal/appearance/base-layer.js

@@ -49,7 +49,7 @@ export const GALA_BASE_STYLESHEET_MEDIA_TYPE = 'text/css; charset=utf-8';
  *
  * @type {Readonly<Record<string, string | string[]>>}
  */
-const DEFAULT_TOKENS = Object.freeze({
+export const GALA_BASE_DEFAULT_TOKENS = Object.freeze({
   'border-button': 'none',
   'border-card': ['1px solid #e2e6ec', '1px solid #232a34'],
   'border-chip': 'none',
@@ -195,7 +195,7 @@ const DEFAULT_TOKENS = Object.freeze({
 
 /** @type {readonly string[]} every token key this layer defaults, sorted. */
 export const GALA_BASE_DEFAULT_TOKEN_KEYS = Object.freeze(
-  Object.keys(DEFAULT_TOKENS),
+  Object.keys(GALA_BASE_DEFAULT_TOKENS),
 );
 
 /**
@@ -203,7 +203,7 @@ export const GALA_BASE_DEFAULT_TOKEN_KEYS = Object.freeze(
  * @returns {string} the declaration list for one palette
  */
 function defaultDeclarations(index) {
-  return Object.entries(DEFAULT_TOKENS)
+  return Object.entries(GALA_BASE_DEFAULT_TOKENS)
     .map(([key, value]) => {
       const resolved = typeof value === 'string' ? value : (value[index] ?? '');
       return `--gala-${key}:${resolved};`;

package/src/core/internal/appearance/styling-contract.js

@@ -49,7 +49,7 @@
  * or a `background-image`.
  *
  * Contract 2.1.0 (TPL-H2/TPL-H3/TPL-M7 fix): S2.0's empty `pseudoClasses`
- * catalog made every interaction state unstylable while the closed 35-token
+ * catalog made every interaction state unstylable while the closed 116-token
  * catalog already required `color-focus` and `color-link-visited`, tokens
  * only a pseudo-class can ever apply. {@link PSEUDO_CLASSES} publishes a
  * small closed catalog instead of widening indefinitely; the module
@@ -628,7 +628,7 @@ export const TEMPLATE_STYLING_CONTRACT_INVALID =
  * Structural self-validation of a `templateStylingContract` object against
  * its closed shape (the checks this repository can run
  * without a published `urn:gala:schema:template-styling-contract` schema
- * entry — no such schema ID is registered in `@rathnasgala2/schemas@2.11.0`;
+ * entry — no such schema ID is registered in `@rathnasgala2/schemas@3.0.0`;
  * only `urn:gala:schema:theme-contract:2.0.0` is, which this module's sibling
  * theme fixtures are validated against with the schema package's own
  * exported `validateGalaDocument`, see `test/theme-styling-contract.test.js`).

package/src/core/internal/components.js

@@ -81,28 +81,20 @@ export function monogram(name) {
 
 /**
  * Render the optional newsletter panel: a call-to-action link to the
- * sign-up page the author configured in publication settings, never a form.
- * Reads `publication.newsletter` defensively: absent, or without an
- * `https:` `url`, renders nothing.
+ * sign-up page configured in `publication.newsletter` (validated by the
+ * build-input schema: an `https:` URL, a title and a short text), never a
+ * form. Renders nothing when the publication has no newsletter.
  *
  * @param {object} options rendering options
- * @param {unknown} options.newsletter `publication.newsletter` (may be
- *   undefined on a build input that predates the field)
+ * @param {{url: string, title: string, text: string} | undefined} options.newsletter
+ *   `publication.newsletter`
  * @param {Readonly<Record<string, string | ((...args: string[]) => string)>>} options.messages
  *   the resolved message catalog
  * @returns {string} the panel markup, or an empty string
  */
 export function renderNewsletterPanel({ newsletter, messages }) {
-  const value = /** @type {Record<string, unknown> | undefined} */ (
-    newsletter && typeof newsletter === 'object' ? newsletter : undefined
-  );
-  if (!value || typeof value.url !== 'string' || !/^https:\/\//.test(value.url))
-    return '';
-  const title =
-    typeof value.title === 'string' && value.title !== ''
-      ? value.title
-      : /** @type {string} */ (messages.newsletterLabel);
-  const text = typeof value.text === 'string' ? value.text : '';
+  if (!newsletter) return '';
+  const { url, title, text } = newsletter;
   return (
     `<section class="g-wrap g-newsletter" aria-labelledby="newsletter-title">` +
     `<div class="g-panel">` +
@@ -111,7 +103,7 @@ export function renderNewsletterPanel({ newsletter, messages }) {
     `<h2 id="newsletter-title">${escapeHtml(title)}</h2>` +
     (text ? `<p>${escapeHtml(text)}</p>` : '') +
     `</div>` +
-    `<a class="g-btn" href="${escapeHtml(value.url)}" rel="noopener">${escapeHtml(/** @type {string} */ (messages.newsletterActionLabel))}${icon('arrow')}</a>` +
+    `<a class="g-btn" href="${escapeHtml(url)}" rel="noopener">${escapeHtml(/** @type {string} */ (messages.newsletterActionLabel))}${icon('arrow')}</a>` +
     `</div></section>`
   );
 }

package/src/core/internal/page-kinds.js

@@ -611,7 +611,7 @@ export function buildGeneratedPages(validatedInput, options = {}) {
   });
 
   const newsletterHtml = renderNewsletterPanel({
-    newsletter: /** @type {{newsletter?: unknown}} */ (publication).newsletter,
+    newsletter: publication.newsletter,
     messages,
   });
 

package/src/core/internal/robots.js

@@ -3,10 +3,8 @@
  *
  * Every site allows all crawlers and names its sitemap by absolute URL. The
  * publication may additionally opt out of AI training and AI-assistant
- * crawlers through `publication.crawlers.ai` (`"allow"` | `"block"`, absent
- * means allow). The field is read defensively, exactly like
- * `publication.newsletter`: a build input that predates it, or carries any
- * other value, is treated as `"allow"`.
+ * crawlers through the validated `publication.crawlers.ai` (`"allow"` |
+ * `"block"`; absent means allow).
  *
  * Unlisted (`noindex`) pages are deliberately not disallowed here: a
  * crawler can only honour a `noindex` directive on a page it is allowed to
@@ -45,18 +43,12 @@ export const AI_CRAWLER_USER_AGENTS = Object.freeze([
 ]);
 
 /**
- * @param {unknown} publication `publication` (may predate `crawlers`)
+ * @param {{crawlers?: {ai: 'allow' | 'block'}}} publication the validated
+ *   `publication` (`crawlers` is optional; absent means allow)
  * @returns {'allow' | 'block'} the AI crawler policy
  */
 export function readAiCrawlerPolicy(publication) {
-  const crawlers = /** @type {{crawlers?: unknown} | undefined} */ (
-    publication && typeof publication === 'object' ? publication : undefined
-  )?.crawlers;
-  const ai =
-    crawlers && typeof crawlers === 'object'
-      ? /** @type {{ai?: unknown}} */ (crawlers).ai
-      : undefined;
-  return ai === 'block' ? 'block' : 'allow';
+  return publication.crawlers?.ai ?? 'allow';
 }
 
 /**

package/types/index.d.ts

@@ -130,6 +130,8 @@ export interface PublicationNormalized {
   contactAuthorId?: string;
   socialLinks: unknown[];
   defaultImage?: ResolvedFileRef;
+  newsletter?: { url: string; title: string; text: string };
+  crawlers?: { ai: 'allow' | 'block' };
   profile?: { route: string; body: RenderableBody };
   footerCard?: {
     enabled: boolean;