{ "code": "S83", "name": "Captioned figure", "shape": "figure", "family": "Evidence and pictures", "fits": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "use_when": "When a single figure proves the point and needs a caption and a source. If the picture should carry a line of type on top of it, use S24 Full bleed; for a picture inside running prose, use S02 Reading.", "slots": [ { "name": "headline", "holds": "the point the figure makes, top left", "budget": "under 9 words" }, { "name": "illustration", "holds": "one framed scene, chart or document crop, about 55-60% of the width, centred; never a cut-out", "budget": "16:10" }, { "name": "caption", "holds": "what the figure shows, one line centred under it, with a note number", "budget": "under 12 words" }, { "name": "source-note", "holds": "the numbered source, bottom right under a hairline", "budget": "under 12 words" }, { "name": "description", "holds": "wide option: one line under the headline", "budget": "under 14 words" }, { "name": "artifact-headline", "holds": "opt-artifact: Name the purpose of the artifact.", "budget": "one bounded example; preserve readable static content" }, { "name": "artifact-title", "holds": "opt-artifact: Identify the displayed document.", "budget": "one bounded example; preserve readable static content" }, { "name": "artifact-content", "holds": "opt-artifact: Show the exact content being copied or downloaded.", "budget": "one bounded example; preserve readable static content" }, { "name": "artifact-caption", "holds": "opt-artifact: Explain what is real, illustrative or incomplete.", "budget": "one bounded example; preserve readable static content" }, { "name": "artifact-source", "holds": "opt-artifact: Credit the evidence or arrangement as appropriate.", "budget": "one bounded example; preserve readable static content" } ], "columns": 1, "density": "balanced", "surface": "paper", "works_on": [ "deck", "page" ], "library": "Slidev", "reference_libraries": [ "AI Elements" ], "dir": "S83-captioned-figure", "semantic": { "audience_question": "What observable detail does this figure contribute to the claim?", "intent": "Inspect one unobscured figure and distinguish its observation from interpretation.", "reasoning_relation": "figure, observation and provenance", "message_pattern": "[Evidence] shows [observation], supporting [specific claim].", "required_content": [ "One legible, cleared figure relevant to a bounded claim.", "A short observation headline and identifying caption.", "A traceable source with the qualifications needed to interpret the figure." ], "narrative_positions": [ "context", "explanation", "evidence: choose only when the page supports the surrounding argument" ], "requires_before": [ "State why locating the safety step matters." ], "enables_after": [ "Explain the design implication and the additional testing needed." ], "slot_roles": { "headline": "States the bounded point visible in the figure, not an unsupported general conclusion.", "illustration": "The chart, document crop or labelled illustration the audience inspects. Generated art can explain a scene but cannot prove an event.", "caption": "Identifies what the figure shows and links it to the source note.", "source-note": "Identifies the source, date or reference needed to inspect the underlying evidence." }, "avoid_when": [ "A decorative mood image presented as evidence.", "A cropped figure that hides contradictory results." ], "layout_specific_contract": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "provenance": { "basis": "interpretation of the existing layout and slot contracts", "review": "Tessel model-authored guidance; implementation approved by Nic, 2026-10-10", "corpus_evidence_status": "not yet established", "guide": "../SEMANTICS.md" }, "variation_rule": "Read the selected option’s actual markup, slot count and source record. Preserve this reasoning relationship only if the option still expresses it; flag a mismatch before adapting.", "variations": { "artifact": { "audience_question": "What does this bounded document contain, and how can I reuse it?", "intent": "Inspect actual document text and take a truthful local copy.", "reasoning_relation": "artifact content and explanatory provenance", "message_pattern": "[Purpose]. [Supplied content in its original order]. [Source, limit or next action].", "required_content": [ "One complete, bounded document or template.", "A clear title, status caption and applicable source/arrangement credit.", "A downloadable file and copy action that match the displayed text." ], "slot_roles": { "artifact-headline": "Names the practical job the document helps the reader perform.", "artifact-title": "Identifies the specific document and version or status.", "artifact-content": "Exact content to inspect and reuse; not an image of inaccessible text.", "artifact-caption": "States what is illustrative, verified, incomplete or awaiting input.", "artifact-source": "Credits the actual content source and the arrangement separately." }, "avoid_when": [ "A picture-only evidence moment.", "A document that cannot be safely copied or whose download differs from its preview." ], "narrative_positions": [ "explanation", "reference" ], "requires_before": [ "Explain why disciplined source or test notes are needed." ], "enables_after": [ "Use the document in the next research or review step." ], "layout_specific_contract": "Framed document with title, compact copy/download actions and caption.", "variation_rule": "Read ../ai-elements-options.js, ../ai-elements-options.css and ../ai-elements-options.json. The option-artifact.html entry point selects this option without JavaScript. Export with ?render=1 for complete content.", "provenance": { "basis": "Live AI Elements example and pinned upstream implementation; native adaptation by Inlay.", "review": "Nic approved the three selected patterns, 2026-10-11.", "corpus_evidence_status": "not established", "guide": "../SEMANTICS.md" }, "reader_outcome": "Inspect actual document text and take a truthful local copy.", "matching": { "audience_question": "What does this bounded document contain, and how can I reuse it?", "reader_outcome": "Inspect actual document text and take a truthful local copy.", "reasoning_relation": "artifact content and explanatory provenance", "content_shape": { "composition": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "selected_state": "Framed document with title, compact copy/download actions and caption.", "density": "balanced", "columns": 1, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "artifact-headline", "reader_question": "What does the artifact headline contribute to this page’s reader outcome?", "semantic_role": "Names the practical job the document helps the reader perform.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · artifact-headline · opt-artifact: Name the purpose of the artifact.]", "layout_budget": { "authored": "one bounded example; preserve readable static content", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "artifact-headline", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } }, { "name": "artifact-title", "reader_question": "What does the artifact title contribute to this page’s reader outcome?", "semantic_role": "Identifies the specific document and version or status.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · artifact-title · opt-artifact: Identify the displayed document.]", "layout_budget": { "authored": "one bounded example; preserve readable static content", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "artifact-title", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } }, { "name": "artifact-content", "reader_question": "What does the artifact content contribute to this page’s reader outcome?", "semantic_role": "Exact content to inspect and reuse; not an image of inaccessible text.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · artifact-content · opt-artifact: Show the exact content being copied or downloaded.]", "layout_budget": { "authored": "one bounded example; preserve readable static content", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "artifact-content", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 41 ] } }, { "name": "artifact-caption", "reader_question": "What does the artifact caption contribute to this page’s reader outcome?", "semantic_role": "States what is illustrative, verified, incomplete or awaiting input.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · artifact-caption · opt-artifact: Explain what is real, illustrative or incomplete.]", "layout_budget": { "authored": "one bounded example; preserve readable static content", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "artifact-caption", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 11 ] } }, { "name": "artifact-source", "reader_question": "Who is accountable for this material, and where can I verify it?", "semantic_role": "Credits the actual content source and the arrangement separately.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · artifact-source · opt-artifact: Credit the evidence or arrangement as appropriate.]", "layout_budget": { "authored": "one bounded example; preserve readable static content", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "artifact-source", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } } ], "rejection_constraints": [ "Template presented as a generated result or controls implying execution or remote storage.", "Claiming an example is a generated or saved result.", "Controls that imply server execution, sharing or regeneration without an implementation.", "Cropping out qualifications or using a decorative image as evidence." ], "option_guidance": { "option": "artifact", "composition_delta": "Framed document with title, compact copy/download actions and caption.", "semantic_change": "changes content relationship", "matching_instruction": "Select S83 artifact when the supplied material answers “What does this bounded document contain, and how can I reuse it?” through artifact content and explanatory provenance. Respect this state: Framed document with title, compact copy/download actions and caption." }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 2, "source_visual_sha256": [ "f2615eb9eaf10ccb3787d8d51aba14caa45f88c6fa3e2916e3e5956946418cea", "dd39c51c66cdffb63d0b5c7beefd7c320963c1a3309bb7ceae000b162a1daeca" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "e56a71134e821b1b1b12f3482675200fb04ec61d7f2e3b4c007f0a8ff72d1878", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them." ] }, "narrative_profile": { "central_point": "A bounded working document can be inspected and then taken away as the same reusable content.", "communication_job": "Show an actual deliverable, explain its status and enable faithful copying or downloading.", "audience_value": "Provides a usable object and reassurance about what the recipient will receive. It addresses “What exactly is in this deliverable?” and “Can I use it after the presentation?” without implying that a displayed template has been validated.", "reading_path": [ "Read the headline and document title to identify purpose and scope.", "Inspect the complete bounded document content inside the frame.", "Read the caption for evidence status and limits.", "Copy or download the same content, retaining its source/arrangement credit." ], "adaptation": { "required_inputs": [ "One complete, bounded document or template.", "A clear title, status caption and applicable source/arrangement credit.", "A downloadable file and copy action that match the displayed text." ], "slot_guidance": { "artifact-headline": "Names the practical job the document helps the reader perform.", "artifact-title": "Identifies the specific document and version or status.", "artifact-content": "Exact content to inspect and reuse; not an image of inaccessible text.", "artifact-caption": "States what is illustrative, verified, incomplete or awaiting input.", "artifact-source": "Credits the actual content source and the arrangement separately." }, "can_change": [ "Document content, title, filename and format where the action still returns the displayed document." ], "must_survive": [ "Displayed, copied and downloaded content must match.", "Keep status/limitations with the reusable text.", "Retain applicable AI Elements arrangement licence/credit; its code example is not evidence for the new document." ] }, "worked_example": { "fictional": true, "scenario": "Fictional Cedar needs a reusable observation note for evaluating its workshop checklist.", "slot_fills": { "artifact-headline": "Record the observation before drawing the conclusion", "artifact-title": "Cedar checklist test note — fictional example", "artifact-content": "# Checklist test note\nStatus: fictional example, not a finding\nQuestion: Can a first-time volunteer find the safety step?\nObservation: Six of eight found it unaided; two needed a prompt.\nScope: Eight fictional first-use attempts.\nInterpretation: The safety step may need a clearer label.\nLimit: This example establishes no real usability result.\nNext check: Test a revised label with new volunteers.", "artifact-caption": "Fictional completed note; replace observations and scope with verified material.", "artifact-source": "Example content: invented for this library. Arrangement: AI Elements Artifact, Apache-2.0." }, "reasoning": "The artifact preserves the chain from question to observation, interpretation, limit and next check, so reuse does not detach the proposed action from its evidence status.", "qualification": "The file is a teaching example. Update the downloadable asset and Copy payload when adapting the visible content." }, "narrative_fit": { "before": "Explain why disciplined source or test notes are needed.", "after": "Use the document in the next research or review step.", "good_uses": [ "A reusable source note, brief, checklist or code example.", "A deliverable handoff." ], "poor_fits": [ "A picture-only evidence moment.", "A document that cannot be safely copied or whose download differs from its preview." ] }, "evidence": { "observations": [ "Viewed source-opt-artifact.webp: a titled code document sits inside a bounded panel with action icons.", "Current opt-artifact HTML replaces the default figure group with a titled Markdown document, Copy/Download actions, caption and arrangement credit." ], "interpretations": [ "The communicative job changes from inspecting a figure as evidence to inspecting and reusing a deliverable." ], "not_verified": [ "The source author’s intent, effectiveness with an audience and historical claims have not been independently verified.", "No proposal archive or corpus validation was performed." ], "references": [ "02_product/spreads/S83-captioned-figure/source.webp", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.html", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.json", "https://github.com/alexanderdavide/slidev-theme-academic/blob/master/layouts/figure.vue", "02_product/spreads/S83-captioned-figure/source-opt-artifact.webp", "https://elements.ai-sdk.dev/components/artifact" ] }, "review": { "status": "reviewed", "basis": "Viewed base and artifact source captures; inspected artifact HTML, slots and copy/download contract; no source-author or effectiveness verification." }, "variation_relationship": "different-job" } }, "wide": { "audience_question": "What point does this wide unobscured figure support?", "intent": "Inspect the figure before reading its short explanatory line.", "reader_outcome": "Inspect the figure before reading its short explanatory line.", "reasoning_relation": "wide figure and interpretation", "slot_roles": { "illustration": "A wide inspectable figure carrying any indispensable provenance and qualifications.", "headline": "States the supported observation after the reader sees the figure.", "description": "Explains the relevant pattern or limitation in one line." }, "matching": { "audience_question": "What point does this wide unobscured figure support?", "reader_outcome": "Inspect the figure before reading its short explanatory line.", "reasoning_relation": "wide figure and interpretation", "content_shape": { "composition": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "selected_state": "A wide figure across the top, with the headline and one description line left-aligned beneath it", "density": "balanced", "columns": 1, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "headline", "reader_question": "What point does this wide unobscured figure support?", "semantic_role": "States the supported observation after the reader sees the figure.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · headline · the point the figure makes, top left]", "layout_budget": { "authored": "under 9 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "headline", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } }, { "name": "illustration", "reader_question": "What subject, example or view must I inspect, and is it evidence or illustration?", "semantic_role": "A wide inspectable figure carrying any indispensable provenance and qualifications.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[CLEARED IMAGE OR LABELLED ILLUSTRATION · illustration · one framed scene, chart or document crop, about 55-60% of the width, centred; never a cut-out]", "layout_budget": { "authored": "16:10", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "illustration", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 0 ] }, "integrity": "Clear rights and provenance, retain meaningful alt text; generated scenes illustrate and cannot prove a historical event." }, { "name": "description", "reader_question": "What does the description contribute to this page’s reader outcome?", "semantic_role": "Explains the relevant pattern or limitation in one line.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · description · wide option: one line under the headline]", "layout_budget": { "authored": "under 14 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "description", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } } ], "rejection_constraints": [ "No visible caption or footnote assumed to mean provenance is unnecessary; carry provenance in the figure or adjacent context.", "Cropping out qualifications or using a decorative image as evidence." ], "option_guidance": { "option": "wide", "composition_delta": "A wide figure across the top, with the headline and one description line left-aligned beneath it", "semantic_change": "changes content relationship", "matching_instruction": "Select S83 wide when the supplied material answers “What point does this wide unobscured figure support?” through wide figure and interpretation. Respect this state: A wide figure across the top, with the headline and one description line left-aligned beneath it" }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 2, "source_visual_sha256": [ "f2615eb9eaf10ccb3787d8d51aba14caa45f88c6fa3e2916e3e5956946418cea", "dd39c51c66cdffb63d0b5c7beefd7c320963c1a3309bb7ceae000b162a1daeca" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "e56a71134e821b1b1b12f3482675200fb04ec61d7f2e3b4c007f0a8ff72d1878", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them.", "This state omits the default source-note. Carry real provenance in the supplied figure/caption or immediately adjacent source context." ] }, "narrative_profile": { "central_point": "A wide figure leads, and a short interpretation below tells the audience which visible pattern matters.", "communication_job": "Let the reader inspect a broad scene or chart before naming its implication.", "audience_value": "Offers explanation with visual context. It addresses “What should I notice in this large view?”; provenance must travel in the figure or adjacent context because this state hides the default source note.", "reading_path": [ "Inspect the full-width figure first.", "Read the headline below as the bounded conclusion.", "Use the description to state the observation or qualification that makes the conclusion defensible." ], "adaptation": { "required_inputs": [ "A legible wide figure with its source embedded or supplied immediately adjacent.", "A short conclusion and one line of supporting interpretation." ], "slot_guidance": { "illustration": "A wide inspectable figure carrying any indispensable provenance and qualifications.", "headline": "States the supported observation after the reader sees the figure.", "description": "Explains the relevant pattern or limitation in one line." }, "can_change": [ "The figure and claim; placement remains figure before interpretation." ], "must_survive": [ "Do not rely on hidden caption/source-note slots.", "Keep source, sample and other decisive limits in the figure or immediately adjacent text." ] }, "worked_example": { "fictional": true, "scenario": "Fictional Cedar tests a workshop checklist with eight volunteers. A clearly labelled fictional chart shows six first-time users locating the safety step without help and two needing a prompt.", "slot_fills": { "illustration": "Labelled fictional 16:10 chart: eight volunteer observations, six “found unaided” and two “needed a prompt”; show n=8 and the test condition in the figure.", "headline": "Six volunteers found the safety step unaided", "description": "Two needed a prompt; this fictional first-use test involved eight volunteers." }, "reasoning": "The wide chart invites inspection before interpretation; the qualification names the exception rather than concealing it.", "qualification": "Fictional data. Source and n=8 must remain inside the image or adjacent context because this variation omits the footnote." }, "narrative_fit": { "before": "Establish the test question and source context.", "after": "Discuss why the two prompted attempts matter.", "good_uses": [ "Wide charts, annotated maps or context-rich scenes." ], "poor_fits": [ "A claim needing a long methods note on this same page." ] }, "evidence": { "observations": [ "Current opt-wide CSS places the figure first, shows description and hides both caption and source note.", "The retained default source shows a figure-centred arrangement; no separate wide source capture is present in the inspected folder." ], "interpretations": [ "This keeps the broad figure-and-interpretation job while moving provenance responsibility into the supplied material." ], "not_verified": [ "The source author’s intent, effectiveness with an audience and historical claims have not been independently verified.", "No proposal archive or corpus validation was performed." ], "references": [ "02_product/spreads/S83-captioned-figure/source.webp", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.html", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.json", "https://github.com/alexanderdavide/slidev-theme-academic/blob/master/layouts/figure.vue" ] }, "review": { "status": "reviewed", "basis": "Viewed base source capture; inspected this variation’s actual HTML/CSS and matching slots. No separate source capture for this variation was available in the inspected folder." }, "variation_relationship": "same-job" }, "required_content": [ "A legible wide figure with its source embedded or supplied immediately adjacent.", "A short conclusion and one line of supporting interpretation." ], "requires_before": [ "Establish the test question and source context." ], "enables_after": [ "Discuss why the two prompted attempts matter." ], "avoid_when": [ "A claim needing a long methods note on this same page." ] }, "bare": { "audience_question": "What should I inspect in this figure and its small caption?", "intent": "Inspect a standalone figure already framed by the surrounding argument.", "reader_outcome": "Inspect a standalone figure already framed by the surrounding argument.", "reasoning_relation": "figure and identifying caption", "slot_roles": { "illustration": "The standalone figure to inspect; retain internal qualifications.", "caption": "Identifies this view and its illustrative or evidentiary status." }, "matching": { "audience_question": "What should I inspect in this figure and its small caption?", "reader_outcome": "Inspect a standalone figure already framed by the surrounding argument.", "reasoning_relation": "figure and identifying caption", "content_shape": { "composition": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "selected_state": "No headline or source note: the figure alone, centred, with a small caption under it", "density": "balanced", "columns": 1, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "illustration", "reader_question": "What subject, example or view must I inspect, and is it evidence or illustration?", "semantic_role": "The standalone figure to inspect; retain internal qualifications.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[CLEARED IMAGE OR LABELLED ILLUSTRATION · illustration · one framed scene, chart or document crop, about 55-60% of the width, centred; never a cut-out]", "layout_budget": { "authored": "16:10", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "illustration", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 0 ] }, "integrity": "Clear rights and provenance, retain meaningful alt text; generated scenes illustrate and cannot prove a historical event." }, { "name": "caption", "reader_question": "What does the caption contribute to this page’s reader outcome?", "semantic_role": "Identifies this view and its illustrative or evidentiary status.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · caption · what the figure shows, one line centred under it, with a note number]", "layout_budget": { "authored": "under 12 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "caption", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 9 ] } } ], "rejection_constraints": [ "A bare figure used to introduce an unsupported claim or omitting provenance from adjacent context.", "Cropping out qualifications or using a decorative image as evidence." ], "option_guidance": { "option": "bare", "composition_delta": "No headline or source note: the figure alone, centred, with a small caption under it", "semantic_change": "changes content relationship", "matching_instruction": "Select S83 bare when the supplied material answers “What should I inspect in this figure and its small caption?” through figure and identifying caption. Respect this state: No headline or source note: the figure alone, centred, with a small caption under it" }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 2, "source_visual_sha256": [ "f2615eb9eaf10ccb3787d8d51aba14caa45f88c6fa3e2916e3e5956946418cea", "dd39c51c66cdffb63d0b5c7beefd7c320963c1a3309bb7ceae000b162a1daeca" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "e56a71134e821b1b1b12f3482675200fb04ec61d7f2e3b4c007f0a8ff72d1878", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them.", "This state omits the default source-note. Carry real provenance in the supplied figure/caption or immediately adjacent source context." ] }, "narrative_profile": { "central_point": "An already introduced figure is given room for inspection, with only an identifying caption.", "communication_job": "Provide a quiet inspection beat after the surrounding narrative has supplied the question and source.", "audience_value": "Offers observation space and perspective. It reduces competing text, but it does not independently establish a claim or provenance.", "reading_path": [ "Bring the question and source from the immediately preceding context.", "Inspect the figure’s own labels and qualifications.", "Read the short caption to confirm what the figure represents." ], "adaptation": { "required_inputs": [ "A figure already contextualised in the narrative.", "An identifying caption; provenance embedded in the figure or adjacent material." ], "slot_guidance": { "illustration": "The standalone figure to inspect; retain internal qualifications.", "caption": "Identifies this view and its illustrative or evidentiary status." }, "can_change": [ "The figure and caption when the prior narrative still supplies the question." ], "must_survive": [ "The hidden headline and source note cannot carry essential meaning.", "Keep provenance available in the supplied figure or immediately adjoining context." ] }, "worked_example": { "fictional": true, "scenario": "Fictional Cedar tests a workshop checklist with eight volunteers. A clearly labelled fictional chart shows six first-time users locating the safety step without help and two needing a prompt.", "slot_fills": { "illustration": "Labelled fictional 16:10 chart: eight volunteer observations, six “found unaided” and two “needed a prompt”; show n=8 and the test condition in the figure.", "caption": "Checklist test, eight volunteers; fictional example." }, "reasoning": "Removing the headline makes this an inspection pause, not a self-contained evidentiary claim. The preceding page must explain the question and source.", "qualification": "Fictional data. Bare mode hides the note and its marker; never use it to strip source obligations from a real figure." }, "narrative_fit": { "before": "Pose the test question and provide the source or methodology.", "after": "Draw the bounded conclusion from what was visible.", "good_uses": [ "A close inspection beat inside an established explanation." ], "poor_fits": [ "A standalone slide forwarded without surrounding context.", "An unintroduced evidence claim." ] }, "evidence": { "observations": [ "Current opt-bare CSS hides the headline, source note and superscript markers; only the figure and caption remain." ], "interpretations": [ "The reader’s task shifts from evaluating a stated claim to inspecting a contextualised object." ], "not_verified": [ "The source author’s intent, effectiveness with an audience and historical claims have not been independently verified.", "No proposal archive or corpus validation was performed." ], "references": [ "02_product/spreads/S83-captioned-figure/source.webp", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.html", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.json", "https://github.com/alexanderdavide/slidev-theme-academic/blob/master/layouts/figure.vue" ] }, "review": { "status": "reviewed", "basis": "Viewed base source capture; inspected this variation’s actual HTML/CSS and matching slots. No separate source capture for this variation was available in the inspected folder." }, "variation_relationship": "different-job" }, "required_content": [ "A figure already contextualised in the narrative.", "An identifying caption; provenance embedded in the figure or adjacent material." ], "requires_before": [ "Pose the test question and provide the source or methodology." ], "enables_after": [ "Draw the bounded conclusion from what was visible." ], "avoid_when": [ "A standalone slide forwarded without surrounding context.", "An unintroduced evidence claim." ] } }, "reader_outcome": "Inspect one unobscured figure and distinguish its observation from interpretation.", "matching": { "audience_question": "What observable detail does this figure contribute to the claim?", "reader_outcome": "Inspect one unobscured figure and distinguish its observation from interpretation.", "reasoning_relation": "figure, observation and provenance", "content_shape": { "composition": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "selected_state": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "density": "balanced", "columns": 1, "column_note": "Base metadata only; selected option can replace the base geometry." }, "required_slots": [ { "name": "headline", "reader_question": "What observable detail does this figure contribute to the claim?", "semantic_role": "States the bounded point visible in the figure, not an unsupported general conclusion.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · headline · the point the figure makes, top left]", "layout_budget": { "authored": "under 9 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "headline", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } }, { "name": "illustration", "reader_question": "What subject, example or view must I inspect, and is it evidence or illustration?", "semantic_role": "The chart, document crop or labelled illustration the audience inspects. Generated art can explain a scene but cannot prove an event.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[CLEARED IMAGE OR LABELLED ILLUSTRATION · illustration · one framed scene, chart or document crop, about 55-60% of the width, centred; never a cut-out]", "layout_budget": { "authored": "16:10", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "illustration", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 0 ] }, "integrity": "Clear rights and provenance, retain meaningful alt text; generated scenes illustrate and cannot prove a historical event." }, { "name": "caption", "reader_question": "What does the caption contribute to this page’s reader outcome?", "semantic_role": "Identifies what the figure shows and links it to the source note.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · caption · what the figure shows, one line centred under it, with a note number]", "layout_budget": { "authored": "under 12 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "caption", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 9 ] } }, { "name": "source-note", "reader_question": "Who is accountable for this material, and where can I verify it?", "semantic_role": "Identifies the source, date or reference needed to inspect the underlying evidence.", "content_unit_count": { "min": 1, "max": 1, "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence" }, "placeholder": "[REAL CONTENT · source-note · the numbered source, bottom right under a hairline]", "layout_budget": { "authored": "under 12 words", "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument." }, "markup": { "slot": "source-note", "occurrences": 1, "annotation_status": "present", "visibility_status": "not asserted from static parsing", "sample_word_counts": [ 6 ] } } ], "rejection_constraints": [ "Generated illustration represented as historical evidence or cropping away decisive qualifications.", "Cropping out qualifications or using a decorative image as evidence." ], "option_guidance": { "option": "default", "composition_delta": "One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot.", "semantic_change": "retains base content relationship; changes presentation or disclosure", "matching_instruction": "Select S83 default when the supplied material answers “What observable detail does this figure contribute to the claim?” through figure, observation and provenance. Respect this state: One picture, chart or document crop shown as evidence, with every word kept off the image: a headline above, a one-line caption under it and a numbered source note on the foot." }, "provenance": { "status": "inferred composition evidence", "author_intent": "not independently confirmed", "basis": [ "retained source composition where available", "authored layout and slot contracts", "static implementation inspection" ], "source_visual_count": 2, "source_visual_sha256": [ "f2615eb9eaf10ccb3787d8d51aba14caa45f88c6fa3e2916e3e5956946418cea", "dd39c51c66cdffb63d0b5c7beefd7c320963c1a3309bb7ceae000b162a1daeca" ], "source_export": "private source images remain outside this draft site", "markup_sha256": "e56a71134e821b1b1b12f3482675200fb04ec61d7f2e3b4c007f0a8ff72d1878", "limits": [ "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.", "Budgets are authored layout guidance, not a content-writing limit or proof of fit.", "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent." ] }, "adaptation_rules": [ "Choose by audience question, reasoning relation and required content before aesthetic preference.", "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.", "A number needs source, scope and units; a quotation needs faithful wording and attribution.", "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.", "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them." ] }, "rejection_constraints": [ "Generated illustration represented as historical evidence or cropping away decisive qualifications.", "Cropping out qualifications or using a decorative image as evidence." ], "markup_inventory": { "file": "spread.html", "sha256": "e56a71134e821b1b1b12f3482675200fb04ec61d7f2e3b4c007f0a8ff72d1878", "method": "static lxml markup plus authored option description; no rendered-visibility claim", "all_markup_slot_counts": { "headline": 1, "illustration": 1, "caption": 1, "description": 1, "source-note": 1, "artifact-headline": 1, "artifact-title": 1, "artifact-content": 1, "artifact-caption": 1, "artifact-source": 1 }, "slot_evidence": { "headline": [ { "tag": "h2", "classes": "head", "sample_word_count": 6, "repeated_children": 0 } ], "illustration": [ { "tag": "figure", "classes": "ph r-16x10", "sample_word_count": 0, "repeated_children": 1 } ], "caption": [ { "tag": "p", "classes": "cap", "sample_word_count": 9, "repeated_children": 1 } ], "description": [ { "tag": "p", "classes": "desc", "sample_word_count": 6, "repeated_children": 0 } ], "source-note": [ { "tag": "p", "classes": "note", "sample_word_count": 6, "repeated_children": 1 } ], "artifact-headline": [ { "tag": "h2", "classes": "", "sample_word_count": 6, "repeated_children": 0 } ], "artifact-title": [ { "tag": "h3", "classes": "", "sample_word_count": 6, "repeated_children": 0 } ], "artifact-content": [ { "tag": "pre", "classes": "ai-artifact-content", "sample_word_count": 41, "repeated_children": 1 } ], "artifact-caption": [ { "tag": "figcaption", "classes": "", "sample_word_count": 11, "repeated_children": 0 } ], "artifact-source": [ { "tag": "p", "classes": "ai-credit", "sample_word_count": 6, "repeated_children": 1 } ] }, "option_selectors": [ "bare", "wide" ], "linked_implementation": [ { "file": "../spreads.css", "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba" }, { "file": "../ai-elements-options.css", "sha256": "7446f3d300ddd95cad73e1a5efc45fae4216623812a29ffa84d2714ced7ef2fd" }, { "file": "../spread.js", "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4" }, { "file": "../ai-elements-options.js", "sha256": "c37a6f7099f4b9dd5c994af2f2948e1ca8bc2a01c7eb9241fe6fd6a5110d8493" } ] }, "narrative_profile": { "central_point": "One inspectable figure supports a specific observation, and the source note lets the reader trace that observation.", "communication_job": "Direct attention to what the figure actually shows while keeping the interpretation and provenance outside the image.", "audience_value": "Provides evidence and explanation. It answers “What can I see for myself?” and “Where did this come from?” without making the figure prove a broader conclusion than its scope allows.", "reading_path": [ "Read the headline as the observation being tested.", "Inspect the unobscured figure and its labels, scale or visible details.", "Read the caption to identify what was shown, then follow its marker to the source note." ], "adaptation": { "required_inputs": [ "One legible, cleared figure relevant to a bounded claim.", "A short observation headline and identifying caption.", "A traceable source with the qualifications needed to interpret the figure." ], "slot_guidance": { "headline": "States the bounded point visible in the figure, not an unsupported general conclusion.", "illustration": "The chart, document crop or labelled illustration the audience inspects. Generated art can explain a scene but cannot prove an event.", "caption": "Identifies what the figure shows and links it to the source note.", "source-note": "Identifies the source, date or reference needed to inspect the underlying evidence." }, "can_change": [ "Figure content, supported claim and corresponding source." ], "must_survive": [ "Keep decisive labels, denominators, dates and qualifications visible.", "Caption markers must resolve to the correct source.", "Do not put decorative illustration in the evidentiary role without saying it is illustrative." ] }, "worked_example": { "fictional": true, "scenario": "Fictional Cedar tests a workshop checklist with eight volunteers. A clearly labelled fictional chart shows six first-time users locating the safety step without help and two needing a prompt.", "slot_fills": { "headline": "Six volunteers found the safety step unaided", "illustration": "Labelled fictional 16:10 chart: eight volunteer observations, six “found unaided” and two “needed a prompt”; show n=8 and the test condition in the figure.", "caption": "First-use checklist test, eight volunteers; fictional data¹", "source-note": "¹ Fictional Cedar usability notes, June; demonstration only." }, "reasoning": "The six-versus-two distribution supports a narrow observation about this fictional test, while the sample and condition stop it becoming a claim about all volunteers.", "qualification": "Fictional teaching data, not a measured finding. A real chart must retain its sample, task, source and failed cases." }, "narrative_fit": { "before": "State why locating the safety step matters.", "after": "Explain the design implication and the additional testing needed.", "good_uses": [ "A sourced document excerpt or research figure.", "A bounded observation with a traceable source." ], "poor_fits": [ "A decorative mood image presented as evidence.", "A cropped figure that hides contradictory results." ] }, "evidence": { "observations": [ "Viewed source.webp: a heading sits above a centred figure, followed by a caption marker and a separate source note.", "Current default HTML follows that order; the figure itself carries no overlaid headline." ], "interpretations": [ "Separation makes it possible to distinguish the observed material from the claim about it." ], "not_verified": [ "The source author’s intent, effectiveness with an audience and historical claims have not been independently verified.", "No proposal archive or corpus validation was performed." ], "references": [ "02_product/spreads/S83-captioned-figure/source.webp", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.html", "02_product/spreads-semantics-2026-10-13/dist/S83-captioned-figure/spread.json", "https://github.com/alexanderdavide/slidev-theme-academic/blob/master/layouts/figure.vue" ] }, "review": { "status": "reviewed", "basis": "Inspected retained source capture, current HTML and selected matching contract; reviewed semantic roles and fictional adaptation, not persuasion or source facts." }, "variation_relationship": "base" } }, "options": [ { "id": "wide", "what": "A wide figure across the top, with the headline and one description line left-aligned beneath it" }, { "id": "bare", "what": "No headline or source note: the figure alone, centred, with a small caption under it" }, { "id": "artifact", "what": "Framed document with title, compact copy/download actions and caption.", "sources": [ { "ref": "AI Elements Artifact", "url": "https://elements.ai-sdk.dev/components/artifact" } ] } ], "also_seen_in": [ "AI Elements Artifact — https://elements.ai-sdk.dev/components/artifact" ], "source": { "ref": "Slidev Academic figure", "url": "https://github.com/alexanderdavide/slidev-theme-academic/blob/master/layouts/figure.vue" } }