chore: prepare for CRAN submission; update DESCRIPTION, add LICENSE and NEWS files, and include cran-comments

Author: martinctc

.Rbuildignore

@@ -7,3 +7,5 @@
 ^_pkgdown.yml$
 ^doc$
 ^Meta$
+^cran-comments\.md$
+^LICENSE\.md$

DESCRIPTION

@@ -1,11 +1,19 @@
 Package: surveytoolbox
 Type: Package
 Title: Useful Support Functions for Survey Analysis
-Version: 0.1.0.9000
-Author: Martin Chan
-Maintainer: Martin Chan <martinchan53@gmail.com>
+Version: 0.1.0
+Authors@R: 
+    person("Martin", "Chan", , "martinchan53@gmail.com", role = c("aut", "cre"))
 URL: https://github.com/martinctc/surveytoolbox/
-Description: A collection of tools for analyzing and visualizing survey data in R. It includes functions for manipulating labels, creating data dictionaries, converting variable types, and more. 
+BugReports: https://github.com/martinctc/surveytoolbox/issues
+Description: A collection of tools for analyzing and visualizing survey data 
+    in R. This package provides functions for manipulating variable and value 
+    labels commonly found in SPSS datasets, creating data dictionaries, 
+    converting variable types between labelled and standard R types, performing 
+    rowwise operations with 'dplyr' syntax, creating dummy variables from 
+    categorical data, and computing common survey metrics such as Net Promoter 
+    Score (NPS) and top-box/bottom-box transformations. It integrates seamlessly 
+    with the 'tidyverse' workflow and the 'haven' package for labelled data.
 License: GPL-3
 Encoding: UTF-8
 LazyData: true

LICENSE.md

@@ -0,0 +1,5 @@
+# GNU General Public License v3.0
+
+This package is licensed under the GNU General Public License version 3 (GPL-3).
+
+For the full text of the license, see: https://www.gnu.org/licenses/gpl-3.0.en.html

NEWS.md

@@ -0,0 +1,25 @@
+# surveytoolbox (development version)
+
+# surveytoolbox 0.1.0
+
+## New Features
+
+* Initial CRAN release
+* Core functions for survey data manipulation:
+  - `superspread()`, `superspread_count()`, `superspread_fill()` for creating dummy variables
+  - `data_dict()` for creating data dictionaries from labelled data
+  - `look_up()` for lookup table operations
+  - `apply_row()` for rowwise operations with dplyr syntax
+  - `box_it()` for creating top/bottom box variables
+  - `as_nps()` and `as_nps_cat()` for NPS calculations
+  - `test_chisq()` and `ttest_nps()` for statistical tests
+  - Label manipulation functions: `set_varl()`, `set_vall()`, `recode_vallab()`, `extract_vallab()`
+  - Data conversion functions: `char_to_lab()`, `lab_to_char()`, `chr_to_var()`
+  - Utility functions: `clean_strings()`, `wrap_text()`, `timed_fn()`, `categorise()`
+  - File operations: `sav_to_rds()`, `copy_df()`, `read_df()`
+  - Scale transformations: `likert_convert()`, `likert_reverse()`, `maxmin()`
+
+## Documentation
+
+* Added vignettes: "Getting Started" and "surveytoolbox Walkthrough"
+* Full roxygen2 documentation for all exported functions

README.md

@@ -5,10 +5,6 @@
 
 R package containing tidy support functions for survey analysis.
 
-Currently under development! 
-(First created 29 Dec 2018)
-
-
 <img src="https://raw.githubusercontent.com/martinctc/surveytoolbox/master/icons/surveytoolbox_hex.svg" align="right" height = 150 width = 150/>
 
 ------------------------------------------------------------------------
@@ -44,8 +40,7 @@ There is also a convenience function (`apply_row()`) for performing rowwise oper
 
 ### Installation
 
-surveytoolbox is not released on CRAN (yet). 
-You can install the latest development version from GitHub with:
+You can install surveytoolbox from GitHub with:
 
 ```R
 install.packages("devtools")

cran-comments.md

@@ -0,0 +1,19 @@
+## R CMD check results
+
+0 errors | 0 warnings | 0 notes
+
+## Test environments
+
+* local Windows 11 install, R 4.4.x
+* GitHub Actions (ubuntu-latest, windows-latest, macos-latest)
+* R-hub (linux, windows, macos)
+
+## Downstream dependencies
+
+This is a new package with no downstream dependencies.
+
+## Notes
+
+* This is a first submission to CRAN.
+* The package includes Windows-specific clipboard functions (`copy_df()`, `read_df()`) 
+  that are documented as Windows-only and fail gracefully on other platforms.