This is a patch release. It fixes the static-survey to Google Sheets to R collection loop, repairs a serialisation defect, and improves the first-time user experience. There are no new exported functions, no new statistical methods, and no new bundled datasets.
export_static_survey() now renders the header logo and
institution name from render$header, so exported surveys
match the Shiny renderer and the builder preview.export_static_survey() now falls back to the
instrument’s render$google_sheets_endpoint when
endpoint_url is not supplied, so a Google Sheets endpoint
set in the builder is honoured on export.respondent_id, matching the Google Apps Script
collector and read_responses(). The collection round-trip
now preserves the identifier.export_google_sheet() now includes matrix sub-item
columns (item_id__sub) in the Apps Script header row, so
matrix answers are stored in the Sheet.read_sheet_responses() now declares
started_at as a meta column and no longer raises a warning
on every read.image/png, image/jpeg,
image/gif), so JPEG and GIF logos display correctly in the
builder, the Shiny renderer, and the static export.write_sframe() now strips list-level names from the
item, choice, scale, branching, check, and model collections before
serialisation. Instruments built with Map() or other
helpers that attach element names (for example, using item IDs as names)
previously serialised those collections as keyed JSON objects rather
than arrays. This produced a hash mismatch and an integrity error on
read_sframe(). Saved instruments now round-trip correctly
regardless of how the component lists were constructed.sframe object. The message points the user to
sf_instrument() and read_sframe() instead of
showing a raw inherits() assertion failure.reliability_report() no longer prints
psych internal warnings to the console. McDonald’s omega is
skipped silently for scales with fewer than three items, where the
statistic is not meaningful.run_analysis_plan() when no
analysis plan is present now describes both the programmatic route
(instrument$analysis_plan) and the visual SurveyBuilder
route.surveyframe.Rmd) as an
end-to-end worked example: design the questionnaire, export it as a
hosted survey with a Google Sheets backend, collect responses, score
them, run the analysis plan, and render a report. The results section
uses simulated responses so the vignette builds offline; a single
read_sheet_responses() call connects the same workflow to
live responses. The questionnaire and concept are adopted from
Sharafuddin, Madhavan, and Wangtueai (2024, Administrative
Sciences, 14(11), 273, doi:10.3390/admsci14110273), with generic destination
wording so the example transfers to any tourism services context.sf_instrument() examples now include a complete
analysis_plan block.install.packages("surveyframe"), adds a short path for
users who already have a response CSV, and points to
browseVignettes("surveyframe").variables/test analysis blocks. New plans can
store family, method, roles,
options, hypotheses,
decision_rule, reporting_references,
status, and requires_data.descriptives_report(), missing_data_report(),
assumption_report(), posthoc_report(),
validity_report(), and
sample_size_plan().run_analysis_plan() to dispatch the v0.3
method registry, including descriptives, missing data, sparse-table
tests, related-sample tests, Kendall and partial correlations, two-way
ANOVA, ANCOVA, repeated ANOVA, ordinal and multinomial logistic
regression, mediation, moderation, and model-syntax output.sf_construct(),
sf_path(), sf_covariance(),
sf_indirect(), sf_model(),
validate_model(), model_json(),
add_model(), efa_solution(),
efa_syntax(), cfa_lavaan_syntax(),
sem_lavaan_syntax(), seminr_syntax(), and
model_report_template(). Syntax generation does not require
lavaan or seminr.cfa_syntax() remains available as a backward-compatible
wrapper around cfa_lavaan_syntax().Added export_static_survey(). This produces a
single, self-contained HTML file that runs the survey in any modern
browser without a Shiny server or an internet connection. All thirteen
item types are fully rendered (Likert, single choice, multiple choice,
matrix, numeric, text, long text, date, slider, rating, ranking, section
break, text block). Branching logic, required-field validation, a
progress bar, welcome and thank-you pages are all handled in client-side
JavaScript. On submission the browser downloads a per-respondent CSV
file. An optional endpoint_url argument adds a parallel
JSON POST to any serverless endpoint (Google Apps Script, Netlify
function, etc.).
The exported file is suitable for hosting on GitHub Pages, Netlify, or any static file server, and can also be shared directly as an e-mail attachment and opened from disk.
The SHA-256 hash written into .sframe files by
write_sframe() and by the SurveyBuilder HTML is computed
using the same canonicalisation algorithm, so instruments round-trip
correctly between the browser and R.
Added launch_dashboard(). Opens a five-panel Shiny
dashboard for exploring collected response data alongside the instrument
definition, without modifying either. The panels are:
| Panel | Content |
|---|---|
| Overview | Response count, date range, instrument metadata |
| Items | Per-item bar charts, histograms, and frequency tables |
| Scales | Scale score distributions with mean overlay |
| Quality | Attention-check pass rates |
| Raw data | Scrollable response table with CSV download |
When called without arguments the dashboard loads the bundled tourism
services demo. When called with a user-supplied instrument and no
responses argument, it opens in metadata-only mode showing
instrument structure.
Added sframe_demo_data(),
sframe_input_types_demo_data(),
launch_builder_demo(), launch_studio_demo(),
and launch_dashboard_demo() for CRAN-safe examples,
training, and local GUI testing.
Added a bundled input-types demo instrument and simulated response dataset for testing SurveyBuilder, SurveyStudio, the dashboard, and all supported item controls.
launch_studio() now accepts preloaded instruments,
response data frames, CSV response paths, initial screen selection,
host, port, and browser control. SurveyStudio reads these preloaded
values during startup.
Added survey_module_ui() and
survey_module_server(). These allow a survey to be embedded
inside a larger Shiny application as a first-class module.
survey_module_server() returns a reactive that
holds NULL until the form is submitted, then returns the
response as a named list keyed by item ID.
ui <- fluidPage(survey_module_ui("s1"))
server <- function(input, output, session) {
resp <- survey_module_server("s1", instrument = instr)
observeEvent(resp(), { saveRDS(resp(), "response.rds") })
}An optional on_submit callback fires immediately on
submission, before any observeEvent() elsewhere in the
app.
run_analysis_plan() now implements four additional tests
used by the SurveyBuilder’s test dropdown:
anova_one: One-way ANOVA with eta-squared effect size.
When the result is significant and there are more than two groups, Tukey
HSD post-hoc output is included in the result object.t_test_pair: Paired-samples t-test with Cohen’s
d_z.wilcoxon_pair: Wilcoxon signed-rank test with r effect
size.regression_logistic_binary: Binary logistic regression
with McFadden R-squared and an overall model chi-square test. The full
coefficient table is returned for interpretation.All four runners produce an APA-formatted summary string and an
interpretation prompt field to guide write-up.
write_sframe() validates the instrument and writes
the validated object, preserving meta$validated = TRUE in
the saved .sframe file.
.sframe serialisation now includes a
models field and continues to read older
.sframe files where models is absent.
read_responses() no longer requires display-only
items such as section_break and text_block to
appear as response columns.
validate_sframe() now checks model references,
analysis-plan roles, invalid model IDs, duplicate model IDs, and model
indicator/path integrity.
The package title and description were tightened for CRAN submission and avoid overclaiming.
launch_builder(open = TRUE) opens the SurveyBuilder
HTML in the system’s default browser via
utils::browseURL().
R/studio_builder.R contains three fully implemented
internal functions (sframe_builder_empty_state,
sframe_builder_state_from_instrument,
sframe_builder_validate_draft) used by SurveyStudio startup
and draft validation.
SHA-256 hashing in the SurveyBuilder HTML includes a
pure-JavaScript fallback for environments where
crypto.subtle is unavailable on file://
origins, including common Firefox file:// configurations.
Saving a .sframe file from the builder now always
succeeds.
The SurveyBuilder’s rqSuggest box now appears with
an icon and a plain-language recommendation when two or more variables
are selected in the RQ modal.
The undo and redo buttons in the SurveyBuilder topbar are now correctly disabled when their respective history stacks are empty.
export_google_sheet() now writes Google Apps Script
using JSON-encoded JavaScript literals instead of interpolating
instrument metadata directly into executable code. The generated
endpoint also rejects missing, over-large, and non-object JSON POST
bodies..sframe and .csv files by extension, size, and
text-content checks before passing them to import functions.read_sframe() now validates the top-level
.sframe payload structure before hash verification and
object reconstruction.on.exit() even when rendering fails.validate_sframe(), score_scales(),
codebook_report(), cfa_syntax(), and
launch_builder(open = FALSE) have fully runnable
examples.
Reworked the vignette set into a coherent workflow covering instrument building, response analysis, reliability and validity, EFA/CFA/SEM/PLS syntax generation, and GUI usage.
Added cran-comments.md with platform list,
dependency justification, bundled-asset description, and a
\dontrun{} use justification table.
launch_builder_demo() now injects the demo
instrument JSON directly into a temporary copy of
survey_builder.html. The demo questions, scales, and
analysis plan are visible immediately on launch — no manual Load .sframe
step is needed.
launch_studio_demo() and
launch_dashboard_demo() now pass
launch.browser = TRUE so the browser always opens
automatically.
inst/shiny/dashboard/app.R: replaced
library(shiny) with a requireNamespace check
and explicit shiny:: namespace prefixes for CRAN policy
compliance.
db_quality_ui(): class = flag_class
added to tags$tr() so quality rows are colour-coded by flag
status.
db_data_ui(): download-button background colour now
uses sprintf("...%s...", THEME) instead of
background:var(--cp,#2563eb) so the button respects the
active dashboard theme.
db_overview_ui(): date parsing is now delegated to
dashboard_parse_date() for robust, error-free date
display.
render_report() and render_results():
HTML report tables now use APA formatting — horizontal rules only, no
vertical borders, no row shading. A significance footnote is appended
automatically when a p-value column is detected.
demo/survey.R: complete UX rewrite with section
headers, contextual pause prompts, “In the browser: ->” guidance,
ask_yn() yes/no prompts, and a conversational mode for
static survey export. All output is ASCII-safe.
dashboard_parse_date() completely rewritten. No
longer throws
Error in as.POSIXlt.character: character string is not in a standard unambiguous format.
Now tries six explicit format templates in priority order (ISO 8601
Z-suffix, ISO 8601 no-tz, space datetime, date-only, UK dd/mm/yyyy, US
mm/dd/yyyy) with tryCatch on each, plus a wrapped fallback.
Non-matching strings return NA instead of an
error.
Dashboard Items and Scales tabs:
outputOptions(output, "item_chart", suspendWhenHidden = FALSE)
and
outputOptions(output, "scale_chart", suspendWhenHidden = FALSE)
added. Response distribution and Scale score distribution charts now
render as soon as the user switches to those tabs instead of appearing
blank.
sf_instrument(),
sf_item(), sf_choices(),
sf_scale().write_sframe(),
read_sframe() with SHA-256 integrity checking.render_survey().launch_builder().read_responses().