figure silently drops every child that is not an imagefigure's transform builds its children from imgs — the nodes passing isMediaNode — plus an optional figcaption (packages/runes/src/tags/figure.ts:82-87):
ba227dd{% figure caption="My file" %} {% snippet path="a.ts" /%} {% /figure %}
Either the fence appears inside the figure, or the rune says it cannot hold one.
{ "name": "figure", "attributes": { "data-rune": "figure", "typeof": "ImageObject" }, "children": [ { "name": "figcaption", "attributes": { "data-name": "caption" }, "children": ["My file"] } ] }
The <pre> is gone. No error, no warning, no build diagnostic. The page renders a caption floating under nothing.
{% snippet %} because that is the case that surfaced it, but the cause has nothing to do with snippet — any non-media child is dropped the same way. A fenced code block written directly in the body behaves identically.typeof="ImageObject" is emitted unconditionally, so a figure holding anything other than an image also publishes a wrong schema.org type. That part is SPEC-130's channel, but the trigger is the same assumption.{% codegroup title="…" %} precisely because figure cannot serve — but nothing says so at the point of use, and the content model implies it can.major rather than minor because the failure mode is silent content loss. A rune that refused the child would be a smaller problem.imgs as the media slot. Makes {% figure %} a general captioned-container and unblocks figure-wrapped snippets, tables and diagrams.ImageObject type, and makes the limit visible. The choice is a product decision about what figure is, so it belongs in a spec rather than being settled in the fix.Fix 1: figure is a general captioned container. Decided when scheduling v0.39.0. Non-media children are emitted in body order, and imgs stays the media slot. Together with WORK-615, which removes snippet's own figure wrapper, this makes {% figure %} the documented way to give a snippet, table or diagram a caption.
What the fix still has to settle, and record in its resolution:
typeof="ImageObject" cannot stay unconditional once a figure may hold a code fence. One option: keep ImageObject when the media slot is the figure's only content, and emit no type otherwise. That choice belongs in the schema table (SPEC-130), and the baseline diff is reviewed, not regenerated silently.src scheme sugar; where isMediaNode's admitted set comes fromCompleted: 2026-10-07
Branch: claude/v039-bug-028-figure PR: refrakt-md/refrakt#665
packages/runes/src/tags/figure.ts: every body child is kept, in body order. Media standing alone, or alone in a paragraph, is the media slot and is unwrapped as before. Anything else is emitted as written. The caption comes from caption= or the first paragraph with no media in it, and renders last. The transform records body: 'mixed' (pure data, field bag only) when the body holds more than media.SchemaTable gains byField, which selects a row from the rune's field bag (lib/schema-table.ts; exclusive with by, validated). Figure's table is byField: 'body', rows: { mixed: {} }, with fallback ImageObject {image→contentUrl, caption→caption}. A mixed figure publishes no type and no properties. The properties go with the type, because a caption stamped with no typeof would attach to the page's typed ancestor. schema-row.ts, reference.ts and inspect surface byField.runes/figure.md (what it accepts, a code/table example, structured data), runes/snippet.md (caption with figure or title with codegroup; codegroup kept as an option), and the plugin-authoring table reference (byField). Catalog description and VS Code snippet updated.byField unit tests in runes and cli.figure.code and figure.mixed were recorded pre-fix in edc0608 (both ImageObject, children dropped). After the fix both are jsonLd: [] with no rendered annotations. That is the intended change: a captioned code block is not an image. The canonical figure fixture and every other fixture are unchanged. SILENT_FIXTURES in scripts/generate-seo-baseline.mjs records these two as deliberately silent rows of an emitting rune.schemaOrg gains "byField": "body". Nothing else moved.packages/lumina/styles/runes/snippet.css's header comment and SPEC-062 §"Post-transform wrap" still say labelled chrome is delegated to codegroup. I left them alone because the snippet CSS belongs to WORK-615 (claude/v039-tree-order-preprocess), which removes snippet's figure wrapper. Until WORK-615 lands, a snippet in a figure renders figure > figure.rf-snippet > pre.ImageObject {caption}. It could map to the empty row too; that is left as a separate decision.