suggest_layout_from_previous: Suggest layout based on previous stage content using...

View source: R/structure_suggest.R

suggest_layout_from_previousR Documentation

Suggest layout based on previous stage content using heuristics

Description

Automatically suggests an appropriate layout type based on content analysis of previous BID stages. Uses deterministic heuristics to match keywords in problem descriptions, evidence, data story, and other contextual information to layout types that best address the identified issues.

Usage

suggest_layout_from_previous(previous_stage)

Arguments

previous_stage

A tibble or list output from an earlier BID stage function containing stage data with potential fields like problem, evidence, central_question, data_story, etc.

Details

The heuristics follow a priority order:

  1. breathable - if content suggests information overload, confusion, or cognitive load issues

  2. dual_process - if content mentions overview vs detail, quick vs deep, or two-mode interactions

  3. grid - if content focuses on grouping, clustering, visual hierarchy, or comparing related metrics

  4. card - if content mentions cards, chunks, tiles, modular blocks, or per-item summaries

  5. tabs - if content suggests sections, categories, progressive disclosure, but avoids tabs if telemetry shows tab drop-off

  6. breathable - fallback for any unmatched cases

Value

Character string indicating the suggested layout type ("breathable", "dual_process", "grid", "card", "tabs", or fallback)


bidux documentation built on Aug. 30, 2025, 1:12 a.m.