{
  "code": "S94",
  "name": "Index columns",
  "shape": "index",
  "family": "Lists and comparisons",
  "fits": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
  "use_when": "A reading guide, a contents page by theme, or a map of what a long piece or a series covers, when every entry is a few words.",
  "slots": [
    {
      "name": "title",
      "holds": "what the index covers, centred",
      "budget": "under 8 words"
    },
    {
      "name": "subline",
      "holds": "one centred line under the title",
      "budget": "under 14 words"
    },
    {
      "name": "columns",
      "holds": "three or four ruled columns, each a coloured heading over a list; a bold group label (li.grp) may split a list",
      "budget": "heading under 5 words, 6-10 entries of under 5 words each"
    }
  ],
  "columns": 4,
  "density": "dense",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "WebSlides",
  "dir": "S94-index-columns",
  "semantic": {
    "audience_question": "Where does each entry belong within this reference index?",
    "intent": "Locate short entries inside explicit named groups.",
    "reasoning_relation": "classified reference index",
    "message_pattern": "Under [group], find [entries].",
    "required_content": [
      "Names the full reference set.",
      "Explains the grouping logic or intended retrieval task.",
      "Three or four named groups, each with six to ten parallel short entries."
    ],
    "narrative_positions": [
      "appendix",
      "navigation"
    ],
    "requires_before": [
      "Establish the topic and intended user."
    ],
    "enables_after": [
      "Open a relevant item or section."
    ],
    "slot_roles": {
      "title": "Names the full reference set.",
      "subline": "Explains the grouping logic or intended retrieval task.",
      "columns": "Three or four named groups, each with six to ten parallel short entries."
    },
    "avoid_when": [
      "A comparison where columns are competing options.",
      "Overlapping categories with no classification rule."
    ],
    "layout_specific_contract": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
    "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.",
    "reader_outcome": "Locate short entries inside explicit named groups.",
    "matching": {
      "audience_question": "Where does each entry belong within this reference index?",
      "reader_outcome": "Locate short entries inside explicit named groups.",
      "reasoning_relation": "classified reference index",
      "content_shape": {
        "composition": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
        "selected_state": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
        "density": "dense",
        "columns": 4,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "title",
          "reader_question": "Where does each entry belong within this reference index?",
          "semantic_role": "Names the full reference set.",
          "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 · title · what the index covers, centred]",
          "layout_budget": {
            "authored": "under 8 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "title",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              5
            ]
          }
        },
        {
          "name": "subline",
          "reader_question": "What does the subline contribute to this page’s reader outcome?",
          "semantic_role": "Explains the grouping logic or intended retrieval task.",
          "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 · subline · one centred line under the title]",
          "layout_budget": {
            "authored": "under 14 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "subline",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              10
            ]
          }
        },
        {
          "name": "columns",
          "reader_question": "What does the columns contribute to this page’s reader outcome?",
          "semantic_role": "Three or four named groups, each with six to ten parallel short entries.",
          "content_unit_count": {
            "min": 3,
            "max": 4,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · columns · three or four ruled columns, each a coloured heading over a list; a bold group label (li.grp) may split a list]",
          "layout_budget": {
            "authored": "heading under 5 words, 6-10 entries of under 5 words each",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "columns",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              108
            ]
          }
        }
      ],
      "rejection_constraints": [
        "Nonparallel group definitions, arbitrary column assignments or menus built from entity names.",
        "An index mistaken for a strategic recommendation or arbitrary grouping."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S94 default when the supplied material answers “Where does each entry belong within this reference index?” through classified reference index. Respect this state: A reference index: three or four named groups, each with a list of short entries, under one centred title."
      },
      "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": 1,
        "source_visual_sha256": [
          "7f3f4954f100654ec44170cd84e8068b9e30becd2284bfee1a4d5206f98bba11"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "68f1efddf6abb9e7392ecde27457b70343e69d4666eb48ca0fbc2eaf4541035b",
        "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": [
      "Nonparallel group definitions, arbitrary column assignments or menus built from entity names.",
      "An index mistaken for a strategic recommendation or arbitrary grouping."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "68f1efddf6abb9e7392ecde27457b70343e69d4666eb48ca0fbc2eaf4541035b",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "title": 1,
        "subline": 1,
        "columns": 1
      },
      "slot_evidence": {
        "title": [
          {
            "tag": "h2",
            "classes": "ix-title",
            "sample_word_count": 5,
            "repeated_children": 0
          }
        ],
        "subline": [
          {
            "tag": "p",
            "classes": "sub ix-sub",
            "sample_word_count": 10,
            "repeated_children": 0
          }
        ],
        "columns": [
          {
            "tag": "div",
            "classes": "ix",
            "sample_word_count": 108,
            "repeated_children": 4
          }
        ]
      },
      "option_selectors": [
        "three"
      ],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {
      "three": {
        "audience_question": "Where does each entry belong within this reference index?",
        "intent": "Locate short entries inside explicit named groups.",
        "reader_outcome": "Locate short entries inside explicit named groups.",
        "reasoning_relation": "classified reference index",
        "slot_roles": {
          "title": "Names the full reference set.",
          "subline": "Explains the grouping logic or intended retrieval task.",
          "columns": "Three or four named groups, each with six to ten parallel short entries."
        },
        "matching": {
          "audience_question": "Where does each entry belong within this reference index?",
          "reader_outcome": "Locate short entries inside explicit named groups.",
          "reasoning_relation": "classified reference index",
          "content_shape": {
            "composition": "A reference index: three or four named groups, each with a list of short entries, under one centred title.",
            "selected_state": "Three columns, with a bold group label inside a column",
            "density": "dense",
            "columns": 4,
            "column_note": "Base metadata only; selected option can replace the base geometry."
          },
          "required_slots": [
            {
              "name": "title",
              "reader_question": "Where does each entry belong within this reference index?",
              "semantic_role": "Names the full reference set.",
              "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 · title · what the index covers, centred]",
              "layout_budget": {
                "authored": "under 8 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "title",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  5
                ]
              }
            },
            {
              "name": "subline",
              "reader_question": "What does the subline contribute to this page’s reader outcome?",
              "semantic_role": "Explains the grouping logic or intended retrieval task.",
              "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 · subline · one centred line under the title]",
              "layout_budget": {
                "authored": "under 14 words",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "subline",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  10
                ]
              }
            },
            {
              "name": "columns",
              "reader_question": "What does the columns contribute to this page’s reader outcome?",
              "semantic_role": "Three or four named groups, each with six to ten parallel short entries.",
              "content_unit_count": {
                "min": 3,
                "max": 3,
                "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
              },
              "placeholder": "[REAL CONTENT · columns · three or four ruled columns, each a coloured heading over a list; a bold group label (li.grp) may split a list]",
              "layout_budget": {
                "authored": "heading under 5 words, 6-10 entries of under 5 words each",
                "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
              },
              "markup": {
                "slot": "columns",
                "occurrences": 1,
                "annotation_status": "present",
                "visibility_status": "not asserted from static parsing",
                "sample_word_counts": [
                  108
                ]
              }
            }
          ],
          "rejection_constraints": [
            "Nonparallel group definitions, arbitrary column assignments or menus built from entity names.",
            "An index mistaken for a strategic recommendation or arbitrary grouping."
          ],
          "option_guidance": {
            "option": "three",
            "composition_delta": "Three columns, with a bold group label inside a column",
            "semantic_change": "retains base content relationship; changes presentation or disclosure",
            "matching_instruction": "Select S94 three when the supplied material answers “Where does each entry belong within this reference index?” through classified reference index. Respect this state: Three columns, with a bold group label inside a column"
          },
          "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": 1,
            "source_visual_sha256": [
              "7f3f4954f100654ec44170cd84e8068b9e30becd2284bfee1a4d5206f98bba11"
            ],
            "source_export": "private source images remain outside this draft site",
            "markup_sha256": "68f1efddf6abb9e7392ecde27457b70343e69d4666eb48ca0fbc2eaf4541035b",
            "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 reference set becomes easier to navigate when entries are grouped by a meaningful classification.",
          "communication_job": "Keep the classified index in three groups; a subgroup label may split one group without creating a fourth column.",
          "audience_value": "Offers orientation and retrieval. It answers “Which group contains what I need?” without asserting a sequence or score just from column position.",
          "reading_path": [
            "Read title and subline for the classification rule.",
            "Choose the relevant group heading.",
            "Scan the short entries within that group."
          ],
          "adaptation": {
            "required_inputs": [
              "Names the full reference set.",
              "Explains the grouping logic or intended retrieval task.",
              "Three or four named groups, each with six to ten parallel short entries."
            ],
            "slot_guidance": {
              "title": "Names the full reference set.",
              "subline": "Explains the grouping logic or intended retrieval task.",
              "columns": "Three or four named groups, each with six to ten parallel short entries."
            },
            "can_change": [
              "Replace the fictional subject and its supported content while retaining the roles and relationship described here."
            ],
            "must_survive": [
              "Keep group boundaries clear and entry granularity comparable.",
              "Do not imply equal importance from equal width."
            ]
          },
          "worked_example": {
            "fictional": true,
            "scenario": "Fictional Cedar groups workshop topics by stage of use.",
            "slot_fills": {
              "title": "Workshop operating index",
              "subline": "Find the topic by when the volunteer needs it.",
              "columns": [
                "Prepare: Venue; Access; Volunteers; Training; Tools; Parts.",
                "Run: Arrival; Item history; Safety scope; Triage; Guidance; Referrals.",
                "Review: Records; Cleaning; Stock count; Follow-up; Guide edits; Next date."
              ]
            },
            "reasoning": "The classification is temporal use-context; each entry has a clear home rather than appearing in arbitrary equal-sized columns.",
            "qualification": "Fictional teaching example. Replace invented details with authorised content and keep any source, scope, status or uncertainty that affects interpretation."
          },
          "narrative_fit": {
            "before": "Establish the topic and intended user.",
            "after": "Open a relevant item or section.",
            "good_uses": [
              "A reference index.",
              "A topic map with clear group boundaries."
            ],
            "poor_fits": [
              "A comparison where columns are competing options.",
              "Overlapping categories with no classification rule."
            ]
          },
          "evidence": {
            "observations": [
              "Viewed source: four named categories contain lists of components under a centred title.",
              "Current three option hides the fourth column and exposes an internal subgroup label.",
              "Current option markup/CSS: Keep the classified index in three groups; a subgroup label may split one group without creating a fourth column."
            ],
            "interpretations": [
              "A reference set becomes easier to navigate when entries are grouped by a meaningful classification. This is an interpretation of the inspected composition, not a verified claim of author intent."
            ],
            "not_verified": [
              "Original author intent, historical claims, persuasion and archive-wide frequency have not been independently verified."
            ],
            "references": [
              "02_product/spreads/S94-index-columns/source.webp",
              "02_product/spreads-semantics-2026-10-13/dist/S94-index-columns/spread.html",
              "02_product/spreads-semantics-2026-10-13/dist/S94-index-columns/spread.json",
              "https://webslides.tv/demos/components#slide=2"
            ]
          },
          "review": {
            "status": "reviewed",
            "basis": "Viewed base source capture; inspected this option’s current markup, CSS and matching contract. No distinct option-source capture reviewed unless explicitly stated in observations."
          },
          "variation_relationship": "same-job"
        },
        "required_content": [
          "Names the full reference set.",
          "Explains the grouping logic or intended retrieval task.",
          "Three or four named groups, each with six to ten parallel short entries."
        ],
        "requires_before": [
          "Establish the topic and intended user."
        ],
        "enables_after": [
          "Open a relevant item or section."
        ],
        "avoid_when": [
          "A comparison where columns are competing options.",
          "Overlapping categories with no classification rule."
        ]
      }
    },
    "narrative_profile": {
      "central_point": "A reference set becomes easier to navigate when entries are grouped by a meaningful classification.",
      "communication_job": "Help the reader find where a short entry belongs within the larger subject.",
      "audience_value": "Offers orientation and retrieval. It answers “Which group contains what I need?” without asserting a sequence or score just from column position.",
      "reading_path": [
        "Read title and subline for the classification rule.",
        "Choose the relevant group heading.",
        "Scan the short entries within that group."
      ],
      "adaptation": {
        "required_inputs": [
          "Names the full reference set.",
          "Explains the grouping logic or intended retrieval task.",
          "Three or four named groups, each with six to ten parallel short entries."
        ],
        "slot_guidance": {
          "title": "Names the full reference set.",
          "subline": "Explains the grouping logic or intended retrieval task.",
          "columns": "Three or four named groups, each with six to ten parallel short entries."
        },
        "can_change": [
          "Replace the fictional subject and its supported content while retaining the roles and relationship described here."
        ],
        "must_survive": [
          "Keep group boundaries clear and entry granularity comparable.",
          "Do not imply equal importance from equal width."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "Fictional Cedar groups workshop topics by stage of use.",
        "slot_fills": {
          "title": "Workshop operating index",
          "subline": "Find the topic by when the volunteer needs it.",
          "columns": [
            "Before the session: Venue; Access; Volunteers; Training; Tools; Parts.",
            "During intake: Arrival; Item history; Safety scope; Fault notes; Consent; Triage.",
            "During repair: Diagnosis; Guidance; Stop rules; Referrals; Parts use; Record.",
            "After the session: Review; Cleaning; Stock count; Follow-up; Guide edits; Next date."
          ]
        },
        "reasoning": "The classification is temporal use-context; each entry has a clear home rather than appearing in arbitrary equal-sized columns.",
        "qualification": "Fictional teaching example. Replace invented details with authorised content and keep any source, scope, status or uncertainty that affects interpretation."
      },
      "narrative_fit": {
        "before": "Establish the topic and intended user.",
        "after": "Open a relevant item or section.",
        "good_uses": [
          "A reference index.",
          "A topic map with clear group boundaries."
        ],
        "poor_fits": [
          "A comparison where columns are competing options.",
          "Overlapping categories with no classification rule."
        ]
      },
      "evidence": {
        "observations": [
          "Viewed source: four named categories contain lists of components under a centred title.",
          "Current three option hides the fourth column and exposes an internal subgroup label."
        ],
        "interpretations": [
          "A reference set becomes easier to navigate when entries are grouped by a meaningful classification. This is an interpretation of the inspected composition, not a verified claim of author intent."
        ],
        "not_verified": [
          "Original author intent, historical claims, persuasion and archive-wide frequency have not been independently verified."
        ],
        "references": [
          "02_product/spreads/S94-index-columns/source.webp",
          "02_product/spreads-semantics-2026-10-13/dist/S94-index-columns/spread.html",
          "02_product/spreads-semantics-2026-10-13/dist/S94-index-columns/spread.json",
          "https://webslides.tv/demos/components#slide=2"
        ]
      },
      "review": {
        "status": "reviewed",
        "basis": "Viewed the retained base source capture and inspected current HTML and matching slots; reviewed the fictional adaptation at layout-contract level."
      },
      "variation_relationship": "base"
    }
  },
  "options": [
    {
      "id": "three",
      "what": "Three columns, with a bold group label inside a column"
    }
  ],
  "also_seen_in": [],
  "source": {
    "ref": "WebSlides components 2",
    "url": "https://webslides.tv/demos/components#slide=2"
  }
}