NEWS

---

projoint 1.1.4 (2026-08-28)

Compatibility

• Updated predict_tau() for compatibility with estimatr 2.0.0 by excluding groups with fewer than two respondent clusters before estimating a cluster-robust variance. These groups were already discarded after fitting, so predicted IRR values are unchanged.
• Added regression coverage for the complete predicted-IRR sequence returned for the bundled out1_arranged data.

projoint 1.1.3 (2026-07-31)

Choice-mapping safeguards

• Added .choice_map to reshape_projoint() so analysts can record an explicit, auditable mapping from exported choice labels or codes to profiles 1 and 2.
• Choice parsing now supports full multi-character suffixes and stops on unrecognized, ambiguous, case-mismatched, or whitespace-altered labels.
• Missing choices now stop by default. They may be retained as NA only with .allow_missing_choices = TRUE.
• Added validation for duplicate or missing respondent IDs, malformed outcome and covariate specifications, choice mappings, and logical arguments.
• Added post-reshape integrity checks requiring exactly one selected profile for each observed respondent-task choice.
• Added regression tests confirming that declared task mapping is unchanged when Qualtrics response columns are physically reordered.

Qualtrics import

• Updated read_Qualtrics() to detect both current exports with an ImportId metadata row and legacy exports with only question-text metadata.
• Preserved the exact CSV variable names and physical column order, added an explicit .metadata_rows override, and added regression tests for current, legacy, and metadata-free files.

projoint 1.1.2 (2026-07-15)

Citation and website

• Updated the recommended software citation to use the canonical CRAN record and DOI, the current package title, and stable BibTeX keys.
• Added CITATION.cff for GitHub's “Cite this repository” panel and citation guidance to the package website.
• Corrected ORCID metadata so pkgdown renders valid author links.
• Added regression coverage to keep the package citation aligned with the released version.

projoint 1.1.1 (2026-02-22)

Bug fixes

• Fixed issue in organize_data() where profile-varying columns (e.g., selected_repeated) were incorrectly included in pivot_wider(id_cols), which could drop respondent-level covariates (e.g., weights) and cause .weights_2 to fail in choice_level estimation.
• Improved cross-attribute pairing logic in choice-level QOI filtering.
• Added regression tests for .weights_1 and .weights_2.

projoint 1.1.0 (2026-02-16)

Bug fixes

• Fixed reshape_projoint()'' to handle repeated-task reshaping more robustly when tasks/outcomes are not in a simple 1..T order. The function now standardizes the mapping between the last outcome (the repeated measure) and the inferred base task, reducing misalignment in the task'' variable for some inputs.

Improvements

• Added stricter input/design validation in ``reshape_projoint()'':
  • Checks that each base task contains exactly the two expected profiles (1 and 2) in the K-code design and aborts with an informative message otherwise.
  • When ``.repeated = TRUE'', checks that each respondent provides the expected number of outcomes and aborts if repeated outcomes are missing.

Internal changes

• Refactored the implementation of reshape_projoint()'' into a dedicated source file (R/reshape_projoint.R'') with no changes to the exported function name or arguments.

projoint 1.0.6 (2025-10-29)

CRAN maintenance update

This release addresses all issues raised in the CRAN review and includes several small improvements and documentation updates.

Changes and fixes

• DESCRIPTION: References now follow the required format authors (year) <https://...>.
• Examples: Removed commented-out code and replaced examples of unexported functions (projoint_data()) with runnable toy examples.
• Internal helpers: Suppressed documentation for unexported internal functions (projoint_tau(), plot_projoint_profile_level()) using @noRd.
• Cross-references: Fixed a missing link warning in plot.projoint_results.Rd.
• make_projoint_data(): Fixed a minor error affecting input validation.
• Vignettes and website: Revised and expanded for clarity, examples, and reproducibility.

Notes

• R CMD check --as-cran runs cleanly with 0 errors, 0 warnings, and 2 expected NOTES (package size and timestamps).

projoint 1.0.5

Improvements

• Revised pj_estimate() to automatically set the appropriate standard-error option (se_type) depending on clustering and estimation method.
• Expanded documentation across functions:
  • All exported methods now include \value{} sections describing return values.
  • Clearer examples for choice-level analysis; removed commented-out code.
  • Improved description in DESCRIPTION to highlight both profile-level and choice-level estimators, IRR correction, and visualization.
• Updated README and pkgdown site to emphasize choice-level analysis as the default and recommended framework.

Bug fixes

• Fixed reshape_projoint() docs (\textrightarrow macro removed).
• Standardized return values for summary(), plot(), and print() methods to match CRAN policies.

projoint 1.0.4

• Fixed DESCRIPTION metadata mismatch between Author and Authors@R fields, as requested by CRAN.

projoint 1.0.3

• DESCRIPTION: aligned Author: exactly with CRAN’s derived Authors@R format (names and ORCID link formatting) to remove NOTE.

projoint 1.0.2

• CRAN resubmission: fix CITATION (use bibentry(), avoid install-time lookups).
• README: replace relative URLs; fix broken BibTeX link (use GitHub raw URL).
• DESCRIPTION: add aligned Author: alongside Authors@R.
• Bug fix: correct error message when .irr is user-specified.
• Robustness: skip IRR estimation (sim/boot) when .irr is fixed.
• Docs: new vignette “Explore” and corresponding README/pkgdown links.

projoint 1.0.1

• Fix CITATION: switched from citEntry() to bibentry().
• Fixed README links (absolute URLs).
• Added Depends: R (>= 4.1.0).
• Removed duplicate Author field.
• Added cran-comments.md to .Rbuildignore.

projoint 1.0.0

• Initial CRAN release

projoint 0.3.1

• Bug fix for minor issue.
• Vignettes extended to illustrate additional choice-level analyses.

projoint 0.3.0

• Robust SEs & clustering: fixes to variance options; users can now pass arguments supported by estimatr::lm_robust() for clustering and standard errors.
• reshape_projoint() overhaul: now robust to arbitrary base-task orders, infers the repeated base task from the first base outcome, and requires the repeated outcome to be the last element of .outcomes.

projoint 0.2.0

• Minor bug fixes and documentation improvements.
• Major redesign of the website, including improved vignettes and a clearer step-by-step tutorial structure.
• Fixed input validation for specifying inter-rater reliability (IRR), ensuring that IRR values must be between 0.5 and 1.

projoint 0.1.0

• Initial release.