wiki-formant 0.62.0 → 0.63.1

package/README.md

@@ -686,7 +686,7 @@ leafBlocks(blocks, BLOCK_SHAPE.containers);
 
 The dispatch over a repo's own block union stays in that repo; the bodies come from here. `coreAtomicText` has a prose body for every core leaf — the stats, link-grid and page-list bodies joined the originals when two of the three wikis turned out to extract nothing from them, so their MCP `get_page` answered a hub page as nearly empty.
 
-The core leaves — `content`, `codeTabs`, `banner`, `references`, `stats`, `linkGrid`, `recentPages`, `pageList` — had the same case bodies in every wiki's text export, markdown twin, validator and new-block record. A repo's switch hands those cases over and keeps its own, so it stays exhaustive over its union:
+The core leaves — `content`, `codeTabs`, `banner`, `references`, `stats`, `linkGrid`, `testimonial`, `recentPages`, `pageList` — had the same case bodies in every wiki's text export, markdown twin, validator and new-block record. A repo's switch hands those cases over and keeps its own, so it stays exhaustive over its union:
 
 ```ts
 import { coreAtomicText, coreAtomicToMarkdown, coreBlockDefaults } from 'wiki-formant/blocks';
@@ -821,9 +821,11 @@ The dispatch stays a `switch` over the wiki's own union, so a new type is a comp
 
 An editor that draws each block in place, with a list of its own (miow's), hosts the same fields in `<BlockFieldsKit kit={KIT}>`, without `<BlockEditor>`. Only the two container fields need the full editor, since they hold a block list.
 
+A `testimonial` is `{ quote, author, role?, avatarUrl? }`, drawn by `TestimonialView` as `figure.testimonial`: the words in a `blockquote`, then a `figcaption` holding the photo and a `span` of `strong` (who) and `small` (their role). radix-wiki and miow each had one under its own field names; a site with sized images passes `photo`, the `<img>` attributes (`src`, `srcSet`, `sizes`) it made from `avatarUrl`. They are data, because a server component renders the view.
+
 A banner with no text of its own shows `BANNER_MESSAGES` from `wiki-formant/text`, a sentence per variant that names no wiki; `BannerView` takes it unless `message` overrides it.
 
-The core blocks are `ContentBlock`, `CodeTabsBlock`, `StatsBlock`, `LinkGridBlock`, `ReferencesBlock`, `BannerBlock`, `ColumnsBlock<A>` and `InfoboxBlock<A>`, `A` being the wiki's atomic union. A wiki builds its union from them beside its own `recentPages` and `pageList`, which hold its own page rows or a section, and its native types.
+The core blocks are `ContentBlock`, `CodeTabsBlock`, `StatsBlock`, `LinkGridBlock`, `ReferencesBlock`, `BannerBlock`, `TestimonialBlock`, `ColumnsBlock<A>` and `InfoboxBlock<A>`, `A` being the wiki's atomic union. A wiki builds its union from them beside its own `recentPages` and `pageList`, which hold its own page rows or a section, and its native types.
 
 ## Analytics
 

package/dist/block-views.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from 'react';
+import { type ImgHTMLAttributes, type ReactNode } from 'react';
 import type { CodeTab, LinkGridGroup, ReferenceItem, ResolvedPageRef, StatItem } from './blocks.js';
 import type { WikiLinkComponent } from './react-server.js';
 export interface CodeTabsViewProps {
@@ -104,6 +104,19 @@ export declare function StatsView({ items, columns, }: {
     })[];
     columns?: number;
 }): import("react").JSX.Element | null;
+export interface TestimonialViewProps {
+    quote: string;
+    author: string;
+    role?: string;
+    avatarUrl?: string;
+    /**
+     * The photo's sized `<img>` attributes, for a site with an image pipeline.
+     * Data, not a function: a server component renders this client view.
+     */
+    photo?: Pick<ImgHTMLAttributes<HTMLImageElement>, 'src' | 'srcSet' | 'sizes'>;
+}
+/** Someone's words over who said them, with their photo when there is one. */
+export declare function TestimonialView({ quote, author, role, avatarUrl, photo }: TestimonialViewProps): import("react").JSX.Element | null;
 /**
  * A maintenance notice.
  *

package/dist/block-views.js

@@ -114,6 +114,13 @@ export function StatsView({ items, columns = 4, }) {
         return null;
     return (_jsx("div", { className: cx('stat-grid', `stat-grid-${columns}`), children: rows.map((item, i) => (_jsxs("div", { className: "stat-card", children: [_jsxs("span", { className: "stat-value", children: [item.value, item.suffix && _jsx("span", { className: "stat-suffix", children: item.suffix })] }), _jsx("span", { className: "stat-label", children: item.label })] }, item.id ?? i))) }));
 }
+/** Someone's words over who said them, with their photo when there is one. */
+export function TestimonialView({ quote, author, role, avatarUrl, photo }) {
+    if (!quote.trim())
+        return null;
+    const src = avatarUrl && safeLinkHref(avatarUrl);
+    return (_jsxs("figure", { className: "testimonial", children: [_jsx("blockquote", { children: quote }), _jsxs("figcaption", { children: [src && _jsx("img", { src: src, ...photo, alt: "", loading: "lazy" }), _jsxs("span", { children: [_jsx("strong", { children: author }), role && _jsx("small", { children: role })] })] })] }));
+}
 // ---- banner -----------------------------------------------------------------
 /**
  * A maintenance notice.

package/dist/blocks.d.ts

@@ -94,6 +94,15 @@ export interface ReferencesBlock {
     title?: string;
     items: EditableReferenceItem[];
 }
+/** Someone's words, as they said them, and who they are. */
+export interface TestimonialBlock {
+    id: string;
+    type: 'testimonial';
+    quote: string;
+    author: string;
+    role?: string;
+    avatarUrl?: string;
+}
 /** A Wikipedia-style notice. `text` replaces the variant's standard message. */
 export interface BannerBlock {
     id: string;
@@ -247,6 +256,11 @@ export type CoreAtomicBlock<P = ResolvedPageRef> = {
     type: 'linkGrid';
     intro?: string | null;
     groups: readonly LinkGridGroup[];
+} | {
+    type: 'testimonial';
+    quote: string;
+    author: string;
+    role?: string | null;
 } | {
     type: 'recentPages' | 'pageList';
     resolvedPages?: readonly P[] | null;
@@ -346,6 +360,11 @@ export interface CoreBlockDefaults {
         type: 'banner';
         variant: 'stub';
     };
+    testimonial: () => {
+        type: 'testimonial';
+        quote: string;
+        author: string;
+    };
 }
 /**
  * The new-block factories for the core types, which all three wikis had typed

package/dist/blocks.js

@@ -12,7 +12,7 @@
 // keeps this file free of any one repo's type union.
 import { htmlToMarkdown, inlineToMarkdown } from './markdown.js';
 import { relativeTime } from './freshness.js';
-import { BANNER_LABELS, bannerToText, codeTabsToText, linkGridToText, pageListToText, referencesToText, statsToText, stripHtml, } from './text.js';
+import { BANNER_LABELS, bannerToText, codeTabsToText, linkGridToText, pageListToText, referencesToText, statsToText, stripHtml, testimonialToText, } from './text.js';
 // ---- the shapes the standard block types carry ------------------------------
 /**
  * The languages a code block or code tab offers, and the one a new one opens
@@ -188,6 +188,10 @@ export function statsToMarkdown(items) {
         return '';
     return items.map(s => `- **${s.value}${s.suffix ?? ''}** — ${s.label}`).join('\n');
 }
+/** A quotation over its attribution. @internal */
+export function testimonialToMarkdown(quote, author, role) {
+    return `> ${quote.trim().replace(/\n+/g, '\n> ')}\n>\n> — ${[author, role].filter(Boolean).join(', ')}`;
+}
 /** Grouped links under their headings, with an optional lead paragraph. @internal */
 export function linkGridToMarkdown(groups, intro) {
     const lead = intro ? `${inlineToMarkdown(intro)}\n\n` : '';
@@ -216,6 +220,7 @@ export function coreAtomicText(block) {
         case 'references': return referencesToText(block.items);
         case 'stats': return statsToText(block.items);
         case 'linkGrid': return linkGridToText(block.groups, block.intro);
+        case 'testimonial': return testimonialToText(block.quote, block.author, block.role);
         case 'recentPages':
         case 'pageList': return pageListToText(block.resolvedPages ?? []);
     }
@@ -229,6 +234,7 @@ export function coreAtomicToMarkdown(block, opts) {
         case 'references': return referencesToMarkdown(block.items, block.title || opts.referencesTitle || 'References');
         case 'stats': return statsToMarkdown(block.items);
         case 'linkGrid': return linkGridToMarkdown(block.groups, block.intro);
+        case 'testimonial': return testimonialToMarkdown(block.quote, block.author, block.role);
         case 'recentPages':
         case 'pageList':
             return linkList((block.resolvedPages ?? []).map(p => ({
@@ -268,5 +274,6 @@ export function coreBlockDefaults(opts = {}) {
         linkGrid: () => ({ type: 'linkGrid', groups: [{ id: newId(), heading: 'Group', links: [] }] }),
         references: () => ({ type: 'references', title: referencesTitle, items: [] }),
         banner: () => ({ type: 'banner', variant: 'stub' }),
+        testimonial: () => ({ type: 'testimonial', quote: '', author: '' }),
     };
 }

package/dist/text.js

@@ -107,6 +107,10 @@ export function bannerToText(label, text) {
 export function codeTabsToText(tabs) {
     return tabs.map(t => `[${t.label}]\n${t.code}`).join('\n');
 }
+/** `“Their words” — Name, role`. @internal */
+export function testimonialToText(quote, author, role) {
+    return `“${quote.trim()}” — ${[author, role].filter(Boolean).join(', ')}`;
+}
 /** Metric cards, one per line: `99% Uptime`. @internal */
 export function statsToText(items) {
     return items.map(s => `${s.value}${s.suffix ?? ''} ${s.label}`).join('\n');

package/dist/validation.js

@@ -118,6 +118,8 @@ export function coreAtomicValidator(opts = {}) {
                 return validateReferenceItems(b.items);
             case 'linkGrid':
                 return validateLinkGroups(b.groups);
+            case 'testimonial':
+                return typeof b.quote === 'string' && typeof b.author === 'string' && optionalString(b.role) && optionalString(b.avatarUrl);
             default:
                 return false;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-formant",
-  "version": "0.62.0",
+  "version": "0.63.1",
   "description": "The portable half of a wiki: derived taxonomy and facet controls, a version-negotiating MCP transport, markdown twins, block rendering, a rich-text editor engine, conditional-GET plumbing, and the headers and CSP every origin sends.",
   "type": "module",
   "license": "MIT",