@terreno/blocks 57.12.0 → 57.13.0

package/dist/plainText.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockPlainText = void 0;
+const withUnit = (value, unit) => unit === undefined ? value : `${value} ${unit}`;
+/** Matches the renderer: each amount is fixed to the item's `decimals`, so 2 at 1 is "2.0". */
+const stepperText = (block) => [
+    `${block.label}: ${withUnit(String(block.value), block.unit)}`,
+    ...(block.items ?? []).map((item) => `${item.label}: ${withUnit(item.amount.toFixed(item.decimals ?? 0), item.unit)}`),
+].join("\n");
+const checklistText = (block, checked) => block.items
+    .map((item) => `${(checked?.[item.id] ?? item.checked) === true ? "[x]" : "[ ]"} ${item.text}`)
+    .join("\n");
+const listText = (block) => block.items
+    .map((item) => (item.text === undefined ? `- ${item.title}` : `- ${item.title}: ${item.text}`))
+    .join("\n");
+const cellText = (value) => {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    return String(value);
+};
+const tableText = (block, datasets) => {
+    const dataset = datasets?.[block.data];
+    if (dataset === undefined || dataset.source === "ref") {
+        return "";
+    }
+    const names = block.columns ?? dataset.columns.map((column) => column.name);
+    const indexes = names.map((name) => dataset.columns.findIndex((column) => column.name === name));
+    const rows = dataset.rows.map((row) => indexes.map((index) => (index < 0 ? "" : cellText(row[index]))).join("\t"));
+    // The header matches the table on screen, which shows underscores in column names as spaces.
+    const header = names.map((name) => name.replaceAll("_", " ")).join("\t");
+    return [header, ...rows].join("\n");
+};
+/**
+ * The text a copy action writes to the clipboard for its target block. Pass the block as it is
+ * shown now (a host override applied) and the current checklist ticks in `checked`. Blocks a
+ * copy action cannot target return an empty string, as does a table whose dataset is missing or
+ * an unresolved ref.
+ */
+const blockPlainText = (block, options = {}) => {
+    switch (block.type) {
+        case "stepper":
+            return stepperText(block);
+        case "checklist":
+            return checklistText(block, options.checked);
+        case "list":
+            return listText(block);
+        case "table":
+            return tableText(block, options.datasets);
+        case "text":
+            return block.markdown;
+        default:
+            return "";
+    }
+};
+exports.blockPlainText = blockPlainText;

package/dist/prompt.d.ts

@@ -1,9 +1,18 @@
 /**
  * The system-prompt section a host prepends when a reply must be one block document.
  * Every cap is read from `BLOCK_LIMITS` so the prompt, the schema, and the reference stay aligned.
+ * `richBlocks: false` keeps the prompt as it was before rich blocks, for clients that cannot
+ * render them yet. The stepper is offered only with a `stepperActions` entry, and the checklist
+ * names its callback only with a `checklistActions` entry.
  */
-export declare const blocksPromptSection: ({ allowHtml, hostActions, imageHosts, }?: {
+export declare const blocksPromptSection: ({ allowHtml, checklistActions, hostActions, imageHosts, richBlocks, stepperActions, }?: {
     allowHtml?: boolean;
+    /** Host actions a checklist callback may name. Empty or omitted means ticks stay local. */
+    checklistActions?: readonly string[];
     hostActions?: readonly string[];
     imageHosts?: readonly string[];
+    /** Default `true`. `false` leaves every rich block out of the prompt. */
+    richBlocks?: boolean;
+    /** Host actions that handle a stepper. Without one, the prompt never mentions stepper. */
+    stepperActions?: readonly string[];
 }) => string;

package/dist/prompt.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.blocksPromptSection = void 0;
 const limits_1 = require("./limits");
+const schema_1 = require("./schema");
 const DATA_EXAMPLE = `v: 1
 datasets:
   signups:
@@ -34,11 +35,74 @@ const PROSE_EXAMPLE = `v: 1
 blocks:
   - type: text
     markdown: I could not find any signups for that range. Try a wider date window.`;
+/**
+ * Stepper instructions, offered only when the host registers an action that handles steppers,
+ * so the model never writes a stepper whose buttons would do nothing.
+ */
+const stepperPromptLines = (stepperActions) => [
+    "stepper requires id, label, value, min, max, and callback (name and optional payload). It may set step (above 0, default 1), unit, itemsTitle, items, and note. min is below max, and value is between them.",
+    "Its decrease and increase buttons send the callback with payload.value set to the next value. The host returns the updated stepper, so write item amounts for the starting value.",
+    `A stepper callback name must be one of: ${stepperActions.join(", ")}.`,
+    "A stepper item requires label and amount. It may set unit, decimals, and round (nearest or up).",
+    `A stepper id is at most ${limits_1.BLOCK_LIMITS.stepperIdMaxLength} characters. No other id may be <id>_decrease or <id>_increase.`,
+    `A stepper label and itemsTitle are at most ${limits_1.BLOCK_LIMITS.stepperLabelMaxLength} characters, its unit ${limits_1.BLOCK_LIMITS.stepperUnitMaxLength}, and its note ${limits_1.BLOCK_LIMITS.stepperNoteMaxLength}.`,
+    `A stepper has at most ${limits_1.BLOCK_LIMITS.stepperItemsMax} items. An item label is at most ${limits_1.BLOCK_LIMITS.stepperLabelMaxLength} characters, its unit ${limits_1.BLOCK_LIMITS.stepperItemUnitMaxLength}, and decimals is 0 to ${limits_1.BLOCK_LIMITS.stepperDecimalsMax}.`,
+];
+/**
+ * Checklist instructions, offered with rich blocks. A tick only reaches the host through a
+ * checklist action, so without one the model is told to leave callback out and ticks stay local.
+ */
+const checklistPromptLines = (checklistActions) => [
+    "checklist requires id and items, and may set title. It shows a done count such as 2 of 8.",
+    "A checklist item requires id and text. It may set meta (a short label such as a time, shown under the text), detail (a muted line under that), and checked (true or false).",
+    checklistActions.length === 0
+        ? "Leave callback out of a checklist. Ticks stay on the device."
+        : `Set a checklist callback name to one of: ${checklistActions.join(", ")}. Its payload is optional. Each tick sends the callback with payload.itemId, payload.checked, and payload.state, and the host returns the updated checklist.`,
+    `A checklist id is at most ${limits_1.BLOCK_LIMITS.checklistIdMaxLength} characters and an item id ${limits_1.BLOCK_LIMITS.checklistItemIdMaxLength}. Item ids are unique in the checklist, and no other id may be <id>_<item id>.`,
+    `A checklist has ${limits_1.BLOCK_LIMITS.checklistItemsMin} to ${limits_1.BLOCK_LIMITS.checklistItemsMax} items. Its title is at most ${limits_1.BLOCK_LIMITS.checklistTitleMaxLength} characters, an item text ${limits_1.BLOCK_LIMITS.checklistItemTextMaxLength}, an item meta ${limits_1.BLOCK_LIMITS.checklistItemMetaMaxLength}, and an item detail ${limits_1.BLOCK_LIMITS.checklistItemDetailMaxLength}.`,
+];
+/**
+ * Gallery instructions, offered with rich blocks. Tile srcs defer to the image src rules so the
+ * https guidance stays in the one line that knows the host's imageHosts.
+ */
+const galleryPromptLines = () => [
+    `gallery requires images: ${limits_1.BLOCK_LIMITS.galleryImagesMin} to ${limits_1.BLOCK_LIMITS.galleryImagesMax} photos shown together. Each image requires src and alt, and may set caption. Each src follows the image src rules above.`,
+    `A gallery image alt is at most ${limits_1.BLOCK_LIMITS.galleryAltMaxLength} characters and its caption ${limits_1.BLOCK_LIMITS.galleryCaptionMaxLength}.`,
+];
+/** Card eyebrow instruction, offered with rich blocks. */
+const cardEyebrowPromptLines = () => [
+    `A card may set eyebrow, a short label shown small above its title. An eyebrow is at most ${limits_1.BLOCK_LIMITS.cardEyebrowMaxLength} characters.`,
+];
+/**
+ * List instructions, offered with rich blocks. The word "list" names only this block in the
+ * prompt, so the model never reads it as a generic instruction. Item image srcs defer to the
+ * image src rules, and the alt cap is the image block's.
+ */
+const listPromptLines = () => [
+    `list requires items: ${limits_1.BLOCK_LIMITS.listItemsMin} to ${limits_1.BLOCK_LIMITS.listItemsMax} entries stacked one under another. Each item requires title, and may set text (plain text, not markdown), meta (a short label such as a time or a price), and image (src and alt, a thumbnail). Each image src follows the image src rules above.`,
+    `A list item title is at most ${limits_1.BLOCK_LIMITS.listItemTitleMaxLength} characters, its text ${limits_1.BLOCK_LIMITS.listItemTextMaxLength}, its meta ${limits_1.BLOCK_LIMITS.listItemMetaMaxLength}, and its image alt ${limits_1.BLOCK_LIMITS.headingTextMaxLength}.`,
+];
+/**
+ * Copy action instruction, offered with rich blocks. The stepper is named as a target only when
+ * the prompt offers it, so the prompt never mentions a stepper without a stepper action.
+ */
+const copyPromptLine = (offersStepper) => {
+    const targets = schema_1.COPY_TARGET_TYPES.filter((type) => offersStepper || type !== "stepper");
+    const named = `${targets.slice(0, -1).join(", ")}, or ${targets.at(-1)}`;
+    return `action.kind may also be copy: it copies to the clipboard on the device and never reaches the host. A copy action sets exactly one of text (at most ${limits_1.BLOCK_LIMITS.copyTextMaxLength} characters, copied as written) or target (the id of a ${named} block in this document, whose current contents are copied).`;
+};
 /**
  * The system-prompt section a host prepends when a reply must be one block document.
  * Every cap is read from `BLOCK_LIMITS` so the prompt, the schema, and the reference stay aligned.
+ * `richBlocks: false` keeps the prompt as it was before rich blocks, for clients that cannot
+ * render them yet. The stepper is offered only with a `stepperActions` entry, and the checklist
+ * names its callback only with a `checklistActions` entry.
  */
-const blocksPromptSection = ({ allowHtml = false, hostActions = [], imageHosts = [], } = {}) => {
+const blocksPromptSection = ({ allowHtml = false, checklistActions = [], hostActions = [], imageHosts = [], richBlocks = true, stepperActions = [], } = {}) => {
+    const offersStepper = richBlocks && stepperActions.length > 0;
+    const richTypes = richBlocks
+        ? `${offersStepper ? ", stepper" : ""}, checklist, gallery, list`
+        : "";
     const callbacks = hostActions.length === 0
         ? "No callback names are registered. Do not emit kind callback."
         : `A callback name must be one of: ${hostActions.join(", ")}.`;
@@ -50,8 +114,8 @@ const blocksPromptSection = ({ allowHtml = false, hostActions = [], imageHosts =
         "The document is YAML or JSON. Keys, when present, are in this order: v, datasets, blocks.",
         "v is 1.",
         allowHtml
-            ? "Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, html, callout, image, details."
-            : "Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details. Do not emit type html.",
+            ? `Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, html, callout, image, details${richTypes}.`
+            : `Block types: heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details${richTypes}. Do not emit type html.`,
         `An html field is at most ${limits_1.BLOCK_LIMITS.htmlMaxBytes} bytes.`,
         ...(allowHtml
             ? [
@@ -62,11 +126,17 @@ const blocksPromptSection = ({ allowHtml = false, hostActions = [], imageHosts =
         "image requires alt and src. src is a data:image URL, a file: ref, or an https URL on an allowed host.",
         imageHostsLine,
         "details requires title and text.",
+        ...(offersStepper ? stepperPromptLines(stepperActions) : []),
+        ...(richBlocks ? checklistPromptLines(checklistActions) : []),
+        ...(richBlocks ? galleryPromptLines() : []),
+        ...(richBlocks ? listPromptLines() : []),
+        ...(richBlocks ? cardEyebrowPromptLines() : []),
         "heading requires text. text requires markdown. metric requires label and value. badge requires text. context requires text.",
         "chart kind is line, bar, area, or donut. Bind it with data, x, and y, or with points of label and value.",
         "table requires data, the name of a dataset. actions requires id and elements.",
         "An element is a button (id, text, action) or a segmented control (id, target, options of label and data).",
         "action.kind is reply (text), open (url or route, exactly one), select (target and data), or callback (name and optional payload).",
+        ...(richBlocks ? [copyPromptLine(offersStepper)] : []),
         "columns has 2 to 4 children. card has children and an optional title. Do not nest columns or card inside columns or card.",
         `At most ${limits_1.BLOCK_LIMITS.maxBlocks} blocks, including nested blocks.`,
         `Depth is at most ${limits_1.BLOCK_LIMITS.maxDepth}.`,

package/dist/schema.d.ts

@@ -5,6 +5,9 @@ export declare const CALLOUT_STATUSES: readonly ["info", "warning", "alert"];
 export declare const BADGE_STATUSES: readonly ["info", "error", "warning", "success", "neutral", "active"];
 export declare const METRIC_TRENDS: readonly ["up", "down", "flat"];
 export declare const LAYOUT_BLOCK_TYPES: readonly ["columns", "card"];
+export declare const STEPPER_ROUNDING: readonly ["nearest", "up"];
+/** The block types a copy action's `target` may name. */
+export declare const COPY_TARGET_TYPES: readonly ["stepper", "checklist", "list", "table", "text"];
 export interface HeadingBlock {
     id?: string;
     size?: (typeof HEADING_SIZES)[number];
@@ -103,7 +106,18 @@ export interface CallbackAction {
     name: string;
     payload?: Record<string, unknown>;
 }
-export type BlockAction = ReplyAction | OpenAction | SelectAction | CallbackAction;
+/**
+ * Copies text to the device clipboard. Sets exactly one of `text` (copied as written) or
+ * `target` (the id of a block whose current contents `blockPlainText` turns into text).
+ * It never reaches the host.
+ */
+export interface CopyAction {
+    kind: "copy";
+    /** The id of a `stepper`, `checklist`, `list`, `table`, or `text` block in this document. */
+    target?: string;
+    text?: string;
+}
+export type BlockAction = ReplyAction | OpenAction | SelectAction | CallbackAction | CopyAction;
 export interface ButtonElement {
     action: BlockAction;
     iconName?: string;
@@ -151,6 +165,101 @@ export interface DetailsBlock {
     title: string;
     type: "details";
 }
+export interface StepperItem {
+    amount: number;
+    /** Digits after the decimal point, 0 to 3. Default 0. */
+    decimals?: number;
+    label: string;
+    /** How a scaled amount is rounded to `decimals`. Default `nearest`. */
+    round?: (typeof STEPPER_ROUNDING)[number];
+    unit?: string;
+}
+/** The host callback that − and + call with `{...payload, value}`. */
+export interface StepperCallback {
+    name: string;
+    payload?: Record<string, unknown>;
+}
+/**
+ * A − value + control whose buttons call a host callback. The renderer reserves the element ids
+ * `<id>_decrease` and `<id>_increase`.
+ */
+export interface StepperBlock {
+    callback: StepperCallback;
+    id: string;
+    items?: StepperItem[];
+    itemsTitle?: string;
+    label: string;
+    max: number;
+    min: number;
+    note?: string;
+    /** Default 1. */
+    step?: number;
+    type: "stepper";
+    unit?: string;
+    value: number;
+}
+export interface ChecklistItem {
+    checked?: boolean;
+    /** Muted line under the text and meta. */
+    detail?: string;
+    /** Unique within the checklist. The tick's element id is `<checklist id>_<item id>`. */
+    id: string;
+    /** A short label, such as a time, shown small and muted under the bold text. */
+    meta?: string;
+    text: string;
+}
+/**
+ * The host callback a tick sends with `{...payload, itemId, checked, state}`. Without one, or
+ * when its name is not a registered host action, ticks stay on the device.
+ */
+export interface ChecklistCallback {
+    name: string;
+    payload?: Record<string, unknown>;
+}
+/**
+ * A list of tickable items with an "n of m" counter. The renderer reserves the element id
+ * `<id>_<item id>` for each item's tick.
+ */
+export interface ChecklistBlock {
+    callback?: ChecklistCallback;
+    id: string;
+    items: ChecklistItem[];
+    title?: string;
+    type: "checklist";
+}
+export interface GalleryImage {
+    alt: string;
+    caption?: string;
+    /** Follows the `image` src rules, including `IMAGE_HOST_NOT_ALLOWED`. */
+    src: string;
+}
+/** A row of 2 to 6 photos with optional captions. */
+export interface GalleryBlock {
+    id?: string;
+    images: GalleryImage[];
+    type: "gallery";
+}
+/** An optional thumbnail on a list item. Follows the `image` src and alt rules. */
+export interface ListItemImage {
+    /** At most `headingTextMaxLength` characters, the same cap as an `image` block's alt. */
+    alt: string;
+    /** Follows the `image` src rules, including `IMAGE_HOST_NOT_ALLOWED`. */
+    src: string;
+}
+export interface ListItem {
+    image?: ListItemImage;
+    /** A short label, such as a time or a price. */
+    meta?: string;
+    /** Plain text, not markdown. */
+    text?: string;
+    title: string;
+}
+/** A stack of 1 to 12 rows, each with a title and optional text, meta, and thumbnail. */
+export interface ListBlock {
+    id?: string;
+    items: ListItem[];
+    type: "list";
+}
 export interface ColumnsBlock {
     children: Block[];
     id?: string;
@@ -158,11 +267,13 @@ export interface ColumnsBlock {
 }
 export interface CardBlock {
     children: Block[];
+    /** A short label shown small and muted above the title. */
+    eyebrow?: string;
     id?: string;
     title?: string;
     type: "card";
 }
-export type LeafBlock = HeadingBlock | TextBlock | MetricBlock | BadgeBlock | DividerBlock | ContextBlock | ChartBlock | TableBlock | ActionsBlock | HtmlBlock | CalloutBlock | ImageBlock | DetailsBlock;
+export type LeafBlock = HeadingBlock | TextBlock | MetricBlock | BadgeBlock | DividerBlock | ContextBlock | ChartBlock | TableBlock | ActionsBlock | HtmlBlock | CalloutBlock | ImageBlock | DetailsBlock | StepperBlock | ChecklistBlock | GalleryBlock | ListBlock;
 export type Block = LeafBlock | ColumnsBlock | CardBlock;
 export interface BlocksDocument {
     blocks: Block[];

package/dist/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wrapAsTextDocument = exports.blocksSchema = exports.BUTTON_VARIANTS = exports.DATASET_GRAINS = exports.DATASET_COLUMN_TYPES = exports.CHART_HEIGHTS = exports.CHART_KINDS = exports.LAYOUT_BLOCK_TYPES = exports.METRIC_TRENDS = exports.BADGE_STATUSES = exports.CALLOUT_STATUSES = exports.HTML_HEIGHTS = exports.HEADING_SIZES = void 0;
+exports.wrapAsTextDocument = exports.blocksSchema = exports.BUTTON_VARIANTS = exports.DATASET_GRAINS = exports.DATASET_COLUMN_TYPES = exports.CHART_HEIGHTS = exports.CHART_KINDS = exports.COPY_TARGET_TYPES = exports.STEPPER_ROUNDING = exports.LAYOUT_BLOCK_TYPES = exports.METRIC_TRENDS = exports.BADGE_STATUSES = exports.CALLOUT_STATUSES = exports.HTML_HEIGHTS = exports.HEADING_SIZES = void 0;
 const zod_1 = require("zod");
 const limits_1 = require("./limits");
 exports.HEADING_SIZES = ["sm", "md", "lg", "xl", "2xl"];
@@ -9,6 +9,9 @@ exports.CALLOUT_STATUSES = ["info", "warning", "alert"];
 exports.BADGE_STATUSES = ["info", "error", "warning", "success", "neutral", "active"];
 exports.METRIC_TRENDS = ["up", "down", "flat"];
 exports.LAYOUT_BLOCK_TYPES = ["columns", "card"];
+exports.STEPPER_ROUNDING = ["nearest", "up"];
+/** The block types a copy action's `target` may name. */
+exports.COPY_TARGET_TYPES = ["stepper", "checklist", "list", "table", "text"];
 const visibleText = (maxLength) => zod_1.z
     .string()
     .min(1)
@@ -128,11 +131,20 @@ const selectActionSchema = zod_1.z
     target: zod_1.z.string().min(1).max(64),
 })
     .strict();
+const callbackNameSchema = zod_1.z.string().regex(/^[a-z][A-Za-z0-9_]{0,63}$/);
+const callbackPayloadSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.unknown());
 const callbackActionSchema = zod_1.z
     .object({
     kind: zod_1.z.literal("callback"),
-    name: zod_1.z.string().regex(/^[a-z][A-Za-z0-9_]{0,63}$/),
-    payload: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    name: callbackNameSchema,
+    payload: callbackPayloadSchema.optional(),
+})
+    .strict();
+const copyActionSchema = zod_1.z
+    .object({
+    kind: zod_1.z.literal("copy"),
+    target: zod_1.z.string().min(1).max(64).optional(),
+    text: visibleText(limits_1.BLOCK_LIMITS.copyTextMaxLength).optional(),
 })
     .strict();
 const actionSchema = zod_1.z.discriminatedUnion("kind", [
@@ -140,6 +152,7 @@ const actionSchema = zod_1.z.discriminatedUnion("kind", [
     openActionSchema,
     selectActionSchema,
     callbackActionSchema,
+    copyActionSchema,
 ]);
 const buttonElementSchema = zod_1.z
     .object({
@@ -184,14 +197,55 @@ const calloutSchema = zod_1.z
     type: zod_1.z.literal("callout"),
 })
     .strict();
+const imageSrcSchema = zod_1.z.string().min(1).max(limits_1.BLOCK_LIMITS.htmlMaxBytes);
+/** The image block's alt cap, shared by list item thumbnails. */
+const imageAltSchema = visibleText(limits_1.BLOCK_LIMITS.headingTextMaxLength);
 const imageSchema = zod_1.z
     .object({
     ...sharedBlockFields,
-    alt: visibleText(limits_1.BLOCK_LIMITS.headingTextMaxLength),
-    src: zod_1.z.string().min(1).max(limits_1.BLOCK_LIMITS.htmlMaxBytes),
+    alt: imageAltSchema,
+    src: imageSrcSchema,
     type: zod_1.z.literal("image"),
 })
     .strict();
+const galleryImageSchema = zod_1.z
+    .object({
+    alt: visibleText(limits_1.BLOCK_LIMITS.galleryAltMaxLength),
+    caption: visibleText(limits_1.BLOCK_LIMITS.galleryCaptionMaxLength).optional(),
+    src: imageSrcSchema,
+})
+    .strict();
+const gallerySchema = zod_1.z
+    .object({
+    ...sharedBlockFields,
+    images: zod_1.z
+        .array(galleryImageSchema)
+        .min(limits_1.BLOCK_LIMITS.galleryImagesMin)
+        .max(limits_1.BLOCK_LIMITS.galleryImagesMax),
+    type: zod_1.z.literal("gallery"),
+})
+    .strict();
+const listItemSchema = zod_1.z
+    .object({
+    image: zod_1.z
+        .object({
+        alt: imageAltSchema,
+        src: imageSrcSchema,
+    })
+        .strict()
+        .optional(),
+    meta: visibleText(limits_1.BLOCK_LIMITS.listItemMetaMaxLength).optional(),
+    text: visibleText(limits_1.BLOCK_LIMITS.listItemTextMaxLength).optional(),
+    title: visibleText(limits_1.BLOCK_LIMITS.listItemTitleMaxLength),
+})
+    .strict();
+const listSchema = zod_1.z
+    .object({
+    ...sharedBlockFields,
+    items: zod_1.z.array(listItemSchema).min(limits_1.BLOCK_LIMITS.listItemsMin).max(limits_1.BLOCK_LIMITS.listItemsMax),
+    type: zod_1.z.literal("list"),
+})
+    .strict();
 const detailsSchema = zod_1.z
     .object({
     ...sharedBlockFields,
@@ -200,6 +254,63 @@ const detailsSchema = zod_1.z
     type: zod_1.z.literal("details"),
 })
     .strict();
+const stepperItemSchema = zod_1.z
+    .object({
+    amount: zod_1.z.number().finite(),
+    decimals: zod_1.z.number().int().min(0).max(limits_1.BLOCK_LIMITS.stepperDecimalsMax).optional(),
+    label: visibleText(limits_1.BLOCK_LIMITS.stepperLabelMaxLength),
+    round: zod_1.z.enum(exports.STEPPER_ROUNDING).optional(),
+    unit: visibleText(limits_1.BLOCK_LIMITS.stepperItemUnitMaxLength).optional(),
+})
+    .strict();
+const stepperSchema = zod_1.z
+    .object({
+    callback: zod_1.z
+        .object({
+        name: callbackNameSchema,
+        payload: callbackPayloadSchema.optional(),
+    })
+        .strict(),
+    id: blockIdSchema.max(limits_1.BLOCK_LIMITS.stepperIdMaxLength),
+    items: zod_1.z.array(stepperItemSchema).max(limits_1.BLOCK_LIMITS.stepperItemsMax).optional(),
+    itemsTitle: visibleText(limits_1.BLOCK_LIMITS.stepperLabelMaxLength).optional(),
+    label: visibleText(limits_1.BLOCK_LIMITS.stepperLabelMaxLength),
+    max: zod_1.z.number().finite(),
+    min: zod_1.z.number().finite(),
+    note: visibleText(limits_1.BLOCK_LIMITS.stepperNoteMaxLength).optional(),
+    step: zod_1.z.number().finite().optional(),
+    type: zod_1.z.literal("stepper"),
+    unit: visibleText(limits_1.BLOCK_LIMITS.stepperUnitMaxLength).optional(),
+    value: zod_1.z.number().finite(),
+})
+    .strict();
+const checklistItemSchema = zod_1.z
+    .object({
+    checked: zod_1.z.boolean().optional(),
+    detail: visibleText(limits_1.BLOCK_LIMITS.checklistItemDetailMaxLength).optional(),
+    id: blockIdSchema.max(limits_1.BLOCK_LIMITS.checklistItemIdMaxLength),
+    meta: visibleText(limits_1.BLOCK_LIMITS.checklistItemMetaMaxLength).optional(),
+    text: visibleText(limits_1.BLOCK_LIMITS.checklistItemTextMaxLength),
+})
+    .strict();
+const checklistSchema = zod_1.z
+    .object({
+    callback: zod_1.z
+        .object({
+        name: callbackNameSchema,
+        payload: callbackPayloadSchema.optional(),
+    })
+        .strict()
+        .optional(),
+    id: blockIdSchema.max(limits_1.BLOCK_LIMITS.checklistIdMaxLength),
+    items: zod_1.z
+        .array(checklistItemSchema)
+        .min(limits_1.BLOCK_LIMITS.checklistItemsMin)
+        .max(limits_1.BLOCK_LIMITS.checklistItemsMax),
+    title: visibleText(limits_1.BLOCK_LIMITS.checklistTitleMaxLength).optional(),
+    type: zod_1.z.literal("checklist"),
+})
+    .strict();
 const actionsSchema = zod_1.z
     .object({
     elements: zod_1.z
@@ -224,6 +335,10 @@ const blockSchema = zod_1.z.lazy(() => zod_1.z.discriminatedUnion("type", [
     calloutSchema,
     imageSchema,
     detailsSchema,
+    stepperSchema,
+    checklistSchema,
+    gallerySchema,
+    listSchema,
     zod_1.z
         .object({
         ...sharedBlockFields,
@@ -235,6 +350,7 @@ const blockSchema = zod_1.z.lazy(() => zod_1.z.discriminatedUnion("type", [
         .object({
         ...sharedBlockFields,
         children: zod_1.z.array(blockSchema).min(1).max(limits_1.BLOCK_LIMITS.maxBlocks),
+        eyebrow: visibleText(limits_1.BLOCK_LIMITS.cardEyebrowMaxLength).optional(),
         title: visibleText(limits_1.BLOCK_LIMITS.cardTitleMaxLength).optional(),
         type: zod_1.z.literal("card"),
     })

package/dist/validate.js

@@ -182,6 +182,16 @@ const mapIssue = (issue, root) => {
                 }),
             ];
         }
+        if (issue.origin === "number" || issue.origin === "int") {
+            return [
+                error({
+                    code: "OUT_OF_RANGE",
+                    fix: `Set ${subject(path)} to ${maximum} or less.`,
+                    message: `${subject(path)} is above ${maximum}.`,
+                    path,
+                }),
+            ];
+        }
         if (issue.origin === "array") {
             return [
                 error({
@@ -202,7 +212,21 @@ const mapIssue = (issue, root) => {
         ];
     }
     if (issue.code === "too_small") {
-        if (issue.origin === "number" || issue.origin === "int") {
+        const isNumber = issue.origin === "number" || issue.origin === "int";
+        // A ref `limit` below 1 has always been INVALID_TYPE; every other numeric floor matches the
+        // OUT_OF_RANGE code its ceiling uses.
+        if (isNumber && !/^datasets\.[^.]+\.limit$/.test(path)) {
+            const minimum = String(issue.minimum);
+            return [
+                error({
+                    code: "OUT_OF_RANGE",
+                    fix: `Set ${subject(path)} to ${minimum} or more.`,
+                    message: `${subject(path)} is below ${minimum}.`,
+                    path,
+                }),
+            ];
+        }
+        if (isNumber) {
             return [
                 error({
                     code: "INVALID_TYPE",
@@ -262,7 +286,7 @@ const mapIssue = (issue, root) => {
         return [
             error({
                 code: "INVALID_ENUM",
-                fix: "Set type to heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details, or html.",
+                fix: "Set type to heading, text, metric, badge, divider, context, chart, table, actions, columns, card, callout, image, details, stepper, checklist, gallery, list, or html.",
                 message: `${subject(path)} is not a supported block.`,
                 path: path === "" ? "type" : `${path}.type`,
             }),

package/package.json

@@ -56,5 +56,5 @@
     "test:coverage": "bun run ../scripts/check-coverage.ts"
   },
   "types": "dist/index.d.ts",
-  "version": "57.12.0"
+  "version": "57.13.0"
 }