wiki-formant 0.87.0 → 0.88.0

package/README.md

@@ -883,7 +883,7 @@ const SCHEMA: BlockSchema<Block> = {
 <BlockEditor blocks={blocks} onChange={setBlocks} schema={SCHEMA} kit={KIT} />
 ```
 
-The dispatch stays a `switch` over the wiki's own union, so a new type is a compile error there. `CodeTabsFields`, `StatsFields`, `EventsFields`, `ReferencesFields`, `LinkGridFields`, `BannerFields`, `PageListFields`, `ListFields`, `ColumnsFields` and `InfoboxFields` take the core blocks `wiki-formant/blocks` declares; the two containers hold the same list, offering `nestedTypes`. `Field`, `Choice` and `LimitField` are exported for a wiki's own editors, so its native types wear the same kit. A card is marked `data-selected` while it is being edited and `data-nested` inside a container; a type the build does not know is shown by its raw type and carried through untouched. Keep the kit and the schema stable — a module constant or a `useMemo` — since both reach every card through context, and a fresh one re-renders every card on every keystroke.
+The dispatch stays a `switch` over the wiki's own union, so a new type is a compile error there. `CodeTabsFields`, `StatsFields`, `TestimonialFields`, `EventsFields`, `ReferencesFields`, `LinkGridFields`, `BannerFields`, `PageListFields`, `ListFields`, `ColumnsFields` and `InfoboxFields` take the core blocks `wiki-formant/blocks` declares; the two containers hold the same list, offering `nestedTypes`. `Field`, `Choice` and `LimitField` are exported for a wiki's own editors, so its native types wear the same kit. A card is marked `data-selected` while it is being edited and `data-nested` inside a container; a type the build does not know is shown by its raw type and carried through untouched. Keep the kit and the schema stable — a module constant or a `useMemo` — since both reach every card through context, and a fresh one re-renders every card on every keystroke.
 
 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.
 
@@ -893,7 +893,7 @@ An `events` block is `{ upcoming?, past?, items: [{ id, date, end?, text }] }`:
 
 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`, `TestimonialBlock`, `EventsBlock`, `ListBlock`, `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`, `EventsBlock`, `ListBlock`, `ColumnsBlock<A>` and `InfoboxBlock<A>`, `A` being the wiki's atomic union. `CoreLeafBlock` is every one of them but the list and the containers, as one union, and `CoreLeafType` its types. A wiki builds its atomic union from it, `CoreLeafBlock | ListBlock | its native types`, with its own `list` holding its own page rows, and derives its `BlockType` from the result. A leaf added here then reaches every wiki with the release, and fails to compile there until its label, its view and its fields are wired: a `Record` keyed by the block types is missing a key, and a switch closed with `block satisfies never` has a case left over. miow, whose union is zod's, asserts that it carries every `CoreLeafType`.
 
 `ListBlock` is one list of the wiki's pages where those two were two: the pages in a section (`source: 'under'`), the newest, in a section or across the wiki (`'newest'`, `count`), or pages picked by hand (`'chosen'`, `pages`, keyed as the wiki keys a page, an id or a path), shown as links with their age or as cards (`show`). A wiki resolves it to `items` as it does a page list. `ListFields` edits it, with `pages` to pick from and `sections` to name; a wiki with a source of its own, a shop's products say, passes it in `sources` and draws its fields as `children`.
 

package/dist/base.css

@@ -155,7 +155,8 @@ html[data-sidebar='closed'] .wiki-sidebar { width: 0; }
    The structure three or four sites had each restated around this markup;
    padding, gaps, radii and colour stay theirs. A stats block is two columns,
    three or four from 40rem; a code-tab strip is a row of buttons; a banner sets
-   its icon beside its text; a long address in an infobox wraps; an events
+   its icon beside its text; a long address in an infobox wraps; a testimonial
+   sets its photo, round, beside who said it; an events
    block sets every row's dates in one column, shared by Upcoming and Past
    through a subgrid, and stacks them over the words wherever it is narrower
    than 30rem: a phone, or a narrow column. */
@@ -174,6 +175,9 @@ html[data-sidebar='closed'] .wiki-sidebar { width: 0; }
    sits outside the article's prose box, and on radix.wiki ran 709px. */
 .link-grid-group-description { max-width: var(--measure); }
 .infobox-series { display: flex; flex-direction: column; }
+.testimonial figcaption { display: flex; align-items: center; gap: 0.75rem; }
+.testimonial figcaption img { width: 2.5rem; height: 2.5rem; border-radius: 50%; object-fit: cover; }
+.testimonial figcaption > span { display: flex; flex-wrap: wrap; align-items: baseline; column-gap: 0.5rem; }
 .events { display: grid; grid-template-columns: auto 1fr; container-type: inline-size; }
 .events > *, .event-list li { grid-column: 1 / -1; }
 .event-list, .event-list li { display: grid; grid-template-columns: subgrid; }
@@ -308,6 +312,10 @@ html[data-sidebar='closed'] .wiki-sidebar { width: 0; }
 
 .facet-summary { margin: 0; font-size: var(--ui-small); color: var(--ui-muted); }
 
+.testimonial { margin: 1.5rem 0; }
+.testimonial > blockquote { margin: 0 0 0.75rem; font-size: 1.125rem; }
+.testimonial figcaption small { color: var(--ui-muted); }
+
 .events { column-gap: 1rem; margin-block: 1rem; }
 .events h2 { margin: 0 0 1rem; }
 .events ol ~ h2 { margin-top: 2.5rem; }

package/dist/block-editor.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentType, type ReactElement, type ReactNode } from 'react';
-import { type BannerBlock, type CodeTabsBlock, type ColumnsBlock, type EventsBlock, type InfoboxBlock, type LinkGridBlock, type ReferencesBlock, type StatsBlock } from './blocks.js';
+import { type BannerBlock, type CodeTabsBlock, type ColumnsBlock, type EventsBlock, type InfoboxBlock, type LinkGridBlock, type ReferencesBlock, type StatsBlock, type TestimonialBlock } from './blocks.js';
 export interface BlockEditorClassNames {
     /** A page's block list. */
     list?: string;
@@ -167,6 +167,11 @@ export declare function StatsFields({ block, onUpdate, hint }: {
     onUpdate: (block: StatsBlock) => void;
     hint?: string;
 }): import("react").JSX.Element;
+/** Someone's words exactly, and who they are: their name, and optionally their role and photo. */
+export declare function TestimonialFields({ block, onUpdate }: {
+    block: TestimonialBlock;
+    onUpdate: (block: TestimonialBlock) => void;
+}): import("react").JSX.Element;
 /**
  * Events in the order they were written, each with how its dates read and
  * where the page sets it today: the page sorts them itself, and moves each on

package/dist/block-editor.js

@@ -163,6 +163,11 @@ export function StatsFields({ block, onUpdate, hint }) {
     const set = (next) => onUpdate({ ...block, items: next });
     return (_jsxs("div", { className: c.stack, children: [_jsx(Choice, { label: "Per row", value: String(block.columns), options: ['2', '3', '4'].map(n => ({ value: n, label: n })), onChange: n => onUpdate({ ...block, columns: Number(n) }) }), items.map((item, i) => (_jsxs("div", { className: c.row, children: [_jsx(TextInput, { label: "Figure", className: c.figure, value: item.value, onChange: value => set(replaceAt(items, i, { ...item, value: value ?? '' })) }), _jsx(TextInput, { label: "What it counts", value: item.label, onChange: label => set(replaceAt(items, i, { ...item, label: label ?? '' })) }), _jsx(Remove, { label: `Remove figure ${i + 1}`, onPress: () => set(removeAt(items, i)) })] }, item.id))), _jsx(Add, { onPress: () => set([...items, { id: newId(), value: '', label: '' }]), children: "Add figure" }), hint && _jsx("small", { className: c.muted, children: hint })] }));
 }
+/** Someone's words exactly, and who they are: their name, and optionally their role and photo. */
+export function TestimonialFields({ block, onUpdate }) {
+    const c = useEditorContext().kit.classNames;
+    return (_jsxs("div", { className: c.stack, children: [_jsx(Field, { label: "Their words", children: _jsx("textarea", { "aria-label": "Their words", placeholder: "Their words, exactly as they said them", rows: 3, className: c.input, value: block.quote, onChange: e => onUpdate({ ...block, quote: e.target.value }) }) }), _jsxs("div", { className: c.row, children: [_jsx(TextInput, { label: "Who said them", value: block.author, onChange: author => onUpdate({ ...block, author: author ?? '' }) }), _jsx(TextInput, { label: "Their role (optional)", optional: true, value: block.role, onChange: role => onUpdate({ ...block, role }) })] }), _jsx(TextInput, { label: "Photo address (optional)", type: "url", placeholder: "https://", optional: true, value: block.avatarUrl, onChange: avatarUrl => onUpdate({ ...block, avatarUrl }) })] }));
+}
 /**
  * Events in the order they were written, each with how its dates read and
  * where the page sets it today: the page sorts them itself, and moves each on

package/dist/blocks.d.ts

@@ -139,6 +139,16 @@ export interface BannerBlock {
     variant: BannerVariant;
     text?: string;
 }
+/**
+ * The leaves every wiki here stores alike, as one union: a repo builds its own
+ * atomic union from it, `CoreLeafBlock | ListBlock | its native types`, so a
+ * leaf added here reaches every repo with the release, and every record keyed
+ * by its block types and every exhaustive switch over them fails to compile
+ * there until it is drawn, edited and labelled. The list is left out because
+ * each repo resolves its `items` to its own rows.
+ */
+export type CoreLeafBlock = ContentBlock | CodeTabsBlock | StatsBlock | LinkGridBlock | ReferencesBlock | BannerBlock | TestimonialBlock | EventsBlock;
+export type CoreLeafType = CoreLeafBlock['type'];
 /** `A` is the wiki's atomic union: a container never holds another container. */
 export interface ColumnsBlock<A> {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-formant",
-  "version": "0.87.0",
+  "version": "0.88.0",
   "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",